نیت

یادداشت

جواب آوینی همراه با متن و ترجمه آیاتمرور یادداشت و متن

حساب من

تنظیمات

درباره اپ

نیت یک وب‌اپ فارسی برای دریافت جواب استخاره از آوینی و خواندن آیه مربوط به آن است.

خواندن و مرور جواب

با «بگیر»، نتیجه و آیه منتخب را می‌بینی. برای خواندن متن بیشتر، می‌توانی تا سه آیه قبل و ده آیه بعد را در همان سوره باز کنی. پایین صفحه هم با هر بار باز کردن، یک حکمت فارسی از نهج‌البلاغه نمایش داده می‌شود.

ذخیره و استفاده روی دستگاه‌های دیگر

می‌توانی جواب‌ها را همراه یادداشت و تاریخ ذخیره کنی، در آرشیو بگردی و فایل پشتیبان بگیری یا بازیابی کنی. ذخیره‌های مهمان در همان مرورگر می‌مانند. با ورود به حساب، ذخیره‌ها و تنظیمات حساب روی دستگاه‌های دیگر هم در دسترس‌اند.

نصب و حالت مخفی

نیت را می‌توانی به صفحه اصلی گوشی اضافه کنی. پس از آماده شدن نسخه آفلاین، صفحه و داده‌های ذخیره‌شده روی دستگاه بدون اینترنت هم باز می‌شوند. برای دریافت جواب تازه، اتصال به آوینی لازم است. حالت مخفی عنوان‌ها و نحوه نمایش را تغییر می‌دهد و محتوای ذخیره‌شده را رمزگذاری نمی‌کند.

نیت نسخه ۳۲٫۳

توضیحات فنی و راهنمای توسعه

ساختار و فناوری‌ها

رابط راست‌چین در پوشه public/ با HTML، CSS و جاوااسکریپت نوشته شده است. مسیرهای درخواست در public/api/index.php با PHP 8.2 یا بالاتر اجرا می‌شوند. این نسخه برای Apache یا LiteSpeed و پایگاه داده MySQL یا MariaDB آماده شده است.

اتصال‌ها و مسیرهای API

  • POST /api/estekhare یکی از ۳۰۱ صفحه فرد قرآن را به شکل تصادفی انتخاب می‌کند و سرور نتیجه را از HTML آوینی استخراج می‌کند. GET /api/verse-context/:page زمینه همان جواب را برمی‌گرداند و GET /api/connection دسترسی سرور به آوینی را بررسی می‌کند. آوینی
  • متن عربی آیات از فایل داخلی quran.json و ترجمه فارسی آیات از صفحه آوینی می‌آید. Quran JSON
  • GET /api/today-events مناسبت‌های Time.ir را به فهرست اضافه می‌کند. داده رسمی ایران و جشن‌های باستانی از Persian Calendar Events در خود اپ ذخیره شده‌اند. مناسبت‌های تکمیلی شیعه و جدول طول ماه‌های قمری ایران از StarCalendar آمده‌اند. جدول ماه‌ها باید با تقویم سال جدید به‌روز شود. خارج از بازه آن، تاریخ قمری محاسباتی با برچسب «تقریبی» نمایش داده می‌شود. جشن‌های باستانی بر اساس تاریخ‌های شمسی مرجع داده نمایش داده می‌شوند. Time.ir
  • بانک ۴۸۰ حکمت فارسی در فایل برنامه قرار دارد. ترتیب تصادفی هر دور در مرورگر ذخیره می‌شود و نمایش حکمت به درخواست شبکه نیاز ندارد. مخزن داده نهج‌البلاغه

حساب، ذخیره و آفلاین

private/accounts.php مسیرهای /api/account/ را برای ثبت‌نام، ورود، پروفایل، تنظیمات، ذخیره‌ها و آمار مدیریت می‌کند. داده حساب در MySQL یا MariaDB نگهداری می‌شود. طرح اولیه پایگاه داده در private/schema.sql است. رمزها با PBKDF2-SHA256 و ۶۰۰ هزار تکرار هش می‌شوند. نشست به کوکی امن و HttpOnly متکی است.

تنظیمات و ذخیره‌های مهمان، گردش حکمت‌ها و نمای آفلاین حساب از حافظه مرورگر استفاده می‌کنند. فایل پشتیبان آرشیو قالب JSON با نسخه ۱ دارد. manifest.webmanifest نصب روی گوشی و public/sw.js کش صفحه و فایل‌های رابط را مدیریت می‌کنند. درخواست‌های حساب و دریافت جواب در کش آفلاین قرار نمی‌گیرند.

ساخت، ارتقا و انتقال

  1. فایل‌های public/ را از ریشه وب سرو کن و private/ را خارج از ریشه نگه دار. جدول‌ها را با private/schema.sql بساز و اتصال پایگاه داده را در private/config.php تنظیم کن.
  2. هنگام تغییر فایل‌های رابط، نسخه کش public/sw.js و شماره نسخه URL فایل‌های CSS و JS در public/index.html را هماهنگ به‌روز کن.
  3. بعد از هر ارتقا، دریافت جواب، مناسبت‌ها، ورود به حساب، ذخیره و کارکرد آفلاین را بررسی کن. تغییر HTML آوینی یا Time.ir ممکن است به اصلاح پارسر در private/sources.php نیاز داشته باشد.

جواب‌های ذخیره‌شده

پشتیبان‌گیری

فایل حاوی جواب‌ها و یادداشت‌های شخصی توست.