سامانه مدرسه شهید باهنر ملوران — نسخهٔ PHP مستقل برای هاست اشتراکی
================================================================

نصب در هاست
-----------
۱. فایل ZIP را داخل پوشهٔ دلخواهتان در public_html (مثلاً public_html/shahidbahonar/php-app/) آپلود کنید.
۲. همان‌جا Extract کنید. توجه: index.php باید مستقیم داخل همان پوشه قرار بگیرد، نه در یک پوشهٔ تودرتو.
۳. آدرس پوشه را در مرورگر باز کنید: https://YOUR-DOMAIN/shahidbahonar/php-app/
۴. صفحهٔ نصب شبیه تصویر موردنظر ظاهر می‌شود. پیش‌نیازها را بررسی کنید، «SQLite — پیشنهاد ما» را انتخاب کنید، رمز مدیر را بزنید و «شروع نصب» را کلیک کنید.
۵. پایگاه داده، جدول‌ها، کاربر مدیر و (در صورت انتخاب) داده‌های نمونه به‌صورت خودکار ساخته می‌شوند. سپس وارد پنل مدیر خواهید شد.

پیش‌نیازها
----------
PHP نسخهٔ ۷.۴ یا بالاتر، PDO، افزونهٔ pdo_sqlite برای نصب پیشنهادی، و قابلیت نوشتن در پوشهٔ برنامه/data.
روی اغلب هاست‌های اشتراکی این‌ها به‌صورت پیش‌فرض فعال‌اند.
در صورت انتخاب MySQL، افزونهٔ pdo_mysql و اطلاعات سرور/کاربر/رمز دیتابیس لازم است. اگر هاست اجازهٔ CREATE DATABASE ندهد، ابتدا دیتابیس و کاربر آن را در cPanel بسازید؛ نصب‌کننده جدول‌ها را خودکار ایجاد می‌کند.

اطلاعات ورود
------------
نام کاربری مدیر: admin (یا نامی که در نصب انتخاب کردید)
رمز مدیر: رمزی که خودتان در صفحهٔ نصب وارد کردید.
در صورت انتخاب داده‌های نمونه:
  دبیر: 0020304051 / رمز اولیه: 0020304051
  دانش‌آموز: 0090000001 / رمز اولیه: 0090000001
دبیران و دانش‌آموزان بعد از اولین ورود باید رمز اولیه را تغییر دهند.

مهم — امنیت و پشتیبان‌گیری
-------------------------
پوشهٔ data/ حاوی فایل محرمانه config.php و فایل دیتابیس SQLite است و به‌وسیلهٔ .htaccess از دسترسی وب محافظت شده است. .htaccess را حذف نکنید.
برای تهیهٔ نسخهٔ پشتیبان، پوشهٔ data/ را دانلود و در محل امن نگهداری کنید.
برای نصب مجدد از صفر، ابتدا از داده‌ها بکاپ بگیرید و سپس فایل data/config.php و data/school.sqlite را حذف کنید.
در صورت استفاده از CDN یا کش هاست، برای صفحات PHP کش عمومی را غیرفعال کنید.

نمونهٔ اکسل بانک سؤال: فایل sample-questions.xlsx در همین پوشه قرار دارد؛ از پنل بانک سؤال هم قابل دانلود است.

این نسخه به Node.js، npm و PostgreSQL نیاز ندارد. فقط PHP و SQLite روی هاست اجرا می‌شوند.

به‌روزرسانی رنگ‌ها / نسخهٔ پرکنتراست
---------------------------------
اگر سامانه را قبلاً نصب کرده‌اید، فقط فایل‌های برنامه را جایگزین کنید و پوشهٔ data/ را دست‌نخورده نگه دارید. خصوصاً data/config.php و data/school.sqlite را حذف نکنید.
استایل‌های خوانا در contrast.css قرار دارند و داخل HTML صفحهٔ نصب و پنل‌ها قرار می‌گیرند؛ بنابراین کش قدیمی فایل CSS نباید ظاهر را تغییر دهد. اگر برنامه را به صفحهٔ اصلی گوشی نصب کرده‌اید، یک بار برنامه را کامل ببندید و دوباره باز کنید.
