راهنمای نصب پورتال لیالین — نسخه ۳ (معماری ماژولار نقش‌محور RBAC)
========================================================================

مرحله ۱ — ساخت دیتابیس
------------------------
۱. در cPanel وارد بخش "MySQL Databases" شوید.
۲. یک دیتابیس بسازید (مثلاً layalin) و یک کاربر دیتابیس با دسترسی کامل (All Privileges) به آن متصل کنید.
۳. نام کامل دیتابیس، نام کاربر و رمز عبور را یادداشت کنید (این پورتال از همین یک دیتابیس مشترک
   برای همهٔ زیرسیستم‌های فعلی و آینده استفاده می‌کند).

مرحله ۲ — Import ساختار جداول (به همین ترتیب)
------------------------------------------------
از phpMyAdmin، در همان دیتابیس، این سه فایل را دقیقاً به این ترتیب Import کنید:
۱. schema.sql — جداول پایه (site_settings، pages)
۲. schema-v2.sql — اخبار، فرم‌ساز، و فرم ثبت‌نام آماده (sabtnam)
۳. core-schema-v3.sql — جداول نقش‌محور (roles، permissions، role_permissions، users،
   user_roles، sms_log)، تعریف نقش‌ها و مجوزهای پایه، افزودن فیلد «موبایل والدین»
   به فرم ثبت‌نام، و انتقال خودکار حساب مدیر قبلی (در صورت وجود) به جدول جدید users.

مرحله ۳ — تنظیم اتصال و آپلود
--------------------------------
۱. در config.php مقادیر DB_NAME، DB_USER، DB_PASS را با اطلاعات مرحله ۱ جایگزین کنید.
۲. تمام پوشه‌ها و فایل‌های این بسته (به‌جز این راهنما و فایل نیازسنجی) را دقیقاً با همین
   ساختار در public_html آپلود کنید.

مرحله ۴ — ساخت حساب مدیر سیستم
----------------------------------
۱. به admin/install.php بروید و حساب «مدیر سیستم» (نقش system_admin، دسترسی کامل) را بسازید.
۲. از admin/login.php وارد شوید.
۳. پس از ساخت حساب، فایل admin/install.php را از روی هاست حذف کنید.
(اگر قبلاً یک‌بار نصب کرده بودید و حساب مدیر دارید، core-schema-v3.sql آن را خودکار به
سیستم جدید منتقل می‌کند؛ فقط یک‌بار logout و دوباره login کنید تا نقش‌ها بارگذاری شوند.)

ساختار پورتال
----------------
- صفحهٔ اصلی پورتال (index.php): همان طراحی قبلی، بدون هدر/فوتر.
- صفحات داخلی (صفحات ثابت، اخبار، فرم ثبت‌نام، پذیرفته‌شدگان): هدر و فوتر مشترک دارند
  (includes/header.php و includes/footer.php) — لینک «ورود»/«پیشخوان» در هدر بسته به
  وضعیت ورود کاربر تغییر می‌کند.
- پیشخوان مدیریت (admin/): منوی بالا ثابت (شامل «مشاهده سایت ↗») + منوی راست قابل
  جمع‌وباز شدن که فقط بخش‌هایی را نشان می‌دهد که کاربرِ واردشده مجوزش را دارد.

نقش‌ها و مجوزها (RBAC)
-------------------------
نقش‌های پایه: مدیر سیستم، مدیر مدرسه، معاونت آموزش، معاونت فرهنگی، معاونت پرورشی/انضباطی،
معاونت اجرایی/مالی، کارکنان دفتری، استاد/مربی، مشاور، دانش‌آموز، والدین.
از منوی «نقش‌ها و کاربران» (فقط برای مدیر سیستم) می‌توانید:
- کاربر جدید بسازید و یک یا چند نقش به او بدهید (مثلاً یک نفر هم استاد و هم والد باشد).
- ماتریس مجوز هر نقش را تیک بزنید/بردارید (مثلاً معاونت فرهنگی فقط «مشاهدهٔ نمرات» را
  داشته باشد نه «ویرایش نمرات»).
جزئیات کامل نقش‌ها، مجوزها و منطق «دید محدود» در فایل نیازسنجی-پورتال-v3.md (بخش‌های ۲ و ۳) توضیح داده شده.

فرم ثبت‌نام و گردش‌کار پذیرش
--------------------------------
- آدرس فرم: https://layalin.ir/form-render.php?slug=sabtnam (دکمهٔ «فرم ثبت‌نام» صفحهٔ اصلی
  به همین‌جا وصل است). شامل نام، نام‌خانوادگی، کد ملی، موبایل دانش‌آموز، موبایل والدین،
  آدرس/استان/شهر و... با ماسک، شرط نمایش و دکمه‌های ذخیره موقت/پاک‌کردن/انصراف/ارسال.
- معاونت آموزش (نقش deputy_education) از «ثبت‌نام‌های دریافتی» فرم‌ها را می‌بیند، تاریخ
  مصاحبه را ثبت می‌کند → پیامک خودکار به موبایل دانش‌آموز و والدین ارسال می‌شود.
- با ثبت نتیجهٔ «قبول»: حساب کاربری دانش‌آموز و والدین به‌صورت خودکار ساخته می‌شود
  (نقش student/parent) و نام‌کاربری + رمز موقت با پیامک اطلاع‌رسانی می‌شود. همین حساب
  بعداً برای ورود به سامانهٔ آموزش (/lms) استفاده خواهد شد.
- پیامک فعلاً به‌صورت شبیه‌سازی‌شده در جدول sms_log ثبت می‌شود. برای اتصال به سرویس واقعی
  (کاوه‌نگار/ملی‌پیامک/...)، فقط includes/sms.php را باز و راهنمای TODO داخل آن را دنبال کنید.

مرحلهٔ بعد — سامانهٔ آموزش (/lms)
-------------------------------------
فایل «نیازسنجی-پورتال-v3.md» (بخش ۶) فهرست پیشنهادی ماژول‌های سامانهٔ آموزش (مشابه سامانهٔ
دانشگاهی: دروس، ترم، انتخاب واحد، اساتید، نمرات/کارنامه، مالی، حضور و غیاب، داشبورد
دانش‌آموز/استاد/والدین و...) را برای تأیید شما آورده است. پس از تأیید یا اصلاح این فهرست،
کدنویسی دایرکتوری /lms آغاز می‌شود.

نکتهٔ فوری ثبت‌نام
---------------------
فرم ثبت‌نام از همین امروز، بعد از Import سه فایل schema.sql / schema-v2.sql / core-schema-v3.sql
و تنظیم config.php، کاملاً فعال و آمادهٔ دریافت متقاضی است.
