﻿==========================================================
نظام الجداول الذكي — مدرسة وي للتكنولوجيا التطبيقية
دليل التثبيت على Google Apps Script
==========================================================

الملفات الموجودة في هذا الملف المضغوط:
  Code.gs        ← كود الخادم (Backend)
  Index.html     ← واجهة المستخدم (Frontend)
  README-AR.txt  ← هذا الدليل

----------------------------------------------------------
الخطوة 1: إنشاء ملف البيانات
----------------------------------------------------------
1. افتح https://sheets.new لإنشاء جدول بيانات جديد.
2. أعد تسميته مثلًا: «بيانات الجدول الدراسي».

----------------------------------------------------------
الخطوة 2: فتح محرر الأكواد
----------------------------------------------------------
1. من داخل جدول البيانات: القائمة «Extensions» ثم «Apps Script».
2. سيُفتح محرر الأكواد ومعه ملف اسمه Code.gs.
3. احذف كل المحتوى الموجود داخله (Ctrl+A ثم Delete).
4. افتح ملف Code.gs من هذا الملف المضغوط بأي محرر نصوص
   (Notepad أو Notepad++ أو VS Code)، وانسخ كل المحتوى،
   ثم ألصقه في محرر Apps Script.
5. اضغط Ctrl+S للحفظ.

----------------------------------------------------------
الخطوة 3: إضافة ملف الواجهة
----------------------------------------------------------
1. من محرر Apps Script اضغط على علامة «+» بجوار كلمة Files
   في الشريط الجانبي الأيسر.
2. اختر «HTML».
3. اكتب الاسم بالضبط: Index
   (بدون إضافة .html — المحرر يضيفها تلقائيًا).
4. احذف السطر الافتراضي الموجود داخل الملف.
5. افتح Index.html من هذا الملف المضغوط، وانسخ كل المحتوى،
   ثم ألصقه داخل الملف الجديد.
6. اضغط Ctrl+S للحفظ.

----------------------------------------------------------
الخطوة 4: تهيئة النظام
----------------------------------------------------------
1. من محرر Apps Script، في قائمة الدوال أعلى الشاشة،
   اختر الدالة: setup
2. اضغط «Run» (تشغيل).
3. ستظهر رسالة تطلب الصلاحيات:
   «Review permissions» ثم اختر حسابك،
   ثم «Advanced» ثم «Go to ... (unsafe)» ثم «Allow».
   (هذه رسالة طبيعية لأن السكربت لم يُنشر بعد على نطاق واسع.)
4. انتظر حتى تنتهي، ستجد جدول البيانات قد امتلأ بالأوراق:
   الإعدادات، المعلمون، المهندسون، الفصول، المواد،
   القاعات، المعامل، جدول_الحصص — وكلها ببيانات عينة جاهزة.

----------------------------------------------------------
الخطوة 5: نشر التطبيق كصفحة ويب
----------------------------------------------------------
1. اضغط زر «Deploy» ثم «New deployment».
2. اضغط على أيقونة الترس واختر «Web app».
3. الإعدادات:
   Description   : نسخة 1
   Execute as    : Me (أنت)
   Who has access: Anyone  أو  Anyone within [اسم المؤسسة]
4. اضغط «Deploy» وانسخ الرابط الذي يظهر (ينتهي بـ /exec).

هذا الرابط هو تطبيقك — افتحه من أي متصفح أو موبايل.

----------------------------------------------------------
طريقة الاستخدام
----------------------------------------------------------
• تبويب «لوحة التحكم»: يعرض إحصائيات النظام ونسبة عدالة
  توزيع الأنصبة، ومنه يتم توليد الجدول بزر واحد.
• تبويب «الجدول الرئيسي»: اختر الصف لعرض جدوله الأسبوعي.
• تبويب «جداول المعلمين» / «جداول المهندسين»:
  اختر أي معلم أو مهندس لعرض جدوله الشخصي.
• تبويب «الإعدادات»: اسم المدرسة، العام الدراسي، الفصل،
  عدد الحصص اليومية، أيام الدراسة، الحد الأقصى للحصص
  اليومية، ونظام الأرقام (عربية/هندية).
• زر «طباعة»: يطبع الجدول المعروض بتنسيق A4 أفقي جاهز.

----------------------------------------------------------
تعديل البيانات
----------------------------------------------------------
كل البيانات تُقرأ من أوراق جدول البيانات مباشرة،
فتستطيع تعديل المعلمين أو المواد أو الفصول من Google Sheets
ثم الضغط على «تحديث البيانات» داخل التطبيق.
بعد أي تعديل في المواد أو الأنصبة، أعد توليد الجدول.

----------------------------------------------------------
حل المشكلات الشائعة
----------------------------------------------------------
• «لم يتم العثور على ملف البيانات»:
  شغّل السكربت من داخل جدول البيانات نفسه (Extensions ←
  Apps Script)، أو ضع معرّف الملف في المتغير SPREADSHEET_ID
  أعلى Code.gs.
• الصفحة تظهر فارغة أو لا تُحمّل:
  تأكد أن ملف الواجهة اسمه Index بالضبط (حروف كبيرة I).
• بعد تعديل الكود لا يظهر التغيير:
  Deploy ← Manage deployments ← تعديل (قلم) ←
  Version: New version ← Deploy.
• «تعذّر توزيع عدد من الحصص»:
  السبب عادةً نقص في المعلمين المؤهلين لتخصص معين،
  أو عدد أيام/حصص غير كافٍ. أضف معلمًا للتخصص الناقص
  أو قلّل الحصص الأسبوعية للمادة، ثم أعد التوليد.

==========================================================
