تطبيق الجامعة — دليل الفريق الكامل

★ الجديد ٢ — الحضور، حجز الساعات المكتبية، رسالة للسكاشن، الخطط الدراسية

طلبات نادر الخمسة: اتعمل فيها إيه، إنت كموبايل تنادي إيه وتقرا أنهي حقل، وإيه اللي بيتظبط من الأدمن. كله متنزّل على السيرفر (109.123.243.32:9300)، ومعروض في الديمو (:9301) بنفس الريكوستات. الجولة اللي قبلها (ميتنج 30 سبتمبر) لسه تحت في الجديد ١.

5 · الحضور والغياب — نقطة نقطة

5 شكلها في الديمو Setup ← Attendance & office hours

الخانة	بتأثر على	Innovation
A lecturer approves each register	ApprovalRequired وزرار الاعتماد وترتيب الاعتماد	مقفول
New code every (seconds)	refreshSeconds — 0 = كود ثابت للمحاضرة	30
Grace after a code changes	الكود القديم يفضل مقبول قد إيه	15
Show a six-digit session code	sessionCode وstudents/AttendByCode	مفتوح
Also accept the old fixed QR	المسح من غير QR_TOKEN (الأبلكيشن القديم)	مفتوح — اقفله لما كل النسخ تبعت التوكن

3 · حجز الساعات المكتبية

3 في الديمو والأدمن Setup ← Attendance & office hours ← Office-hour booking

الخانة	معناها	Innovation
Students can book…	مقفول ← BookingEnabled: false والحجز بيترفض	مفتوح
Students per slot	Capacity لكل ميعاد في يوم	1
Book up to (days ahead)	المواعيد المعروضة والمسموح حجزها	14
Student can cancel until (minutes before)	بعدها الطالب مايقدرش يلغي (الدكتور يقدر)	60

الحجوزات مش في الـ SIS (مفيش جدول ليها) — متخزّنة في داتا السيرفس، فمش هتظهر في البورتال.

2 · الحجوزات في الجدول

رد academicstaff/GetStaffSchedule (الدكتور) وstudents/schedule (الطالب) زاد فيه officeHourBookings[] — نفس شكل الحجز فوق (Date, DayAr, FromTime, ToTime, StudentNameAr / StaffNameAr, Topic). اعرضها في يومها جنب المحاضرات بلون مختلف. جدول الدكتور بيرجع Ok حتى لو عنده حجوزات بس ومفيش محاضرات.

1 · رسالة لطلبة المقرر / سكاشن مختارة

POST academicstaff/SendMessageToCourse      (أو students/SendMessageToCourse — نفس الشغل)
{ "message": "محاضرة الأحد في المدرج الكبير",
  "EdCourseId": 14,
  "ScScheduleDtlIds": [2136] }        // [] = كل سكاشن الدكتور في المقرر

→ { "result": "Ok", "State": "Done", "Sent": 27, "Sections": 1 }

السكاشن للاختيار من academicstaff/GetMySections بـ EdCourseId: ScScheduleDtlId, GroupDescrAr, Students, وSlots[].TeachingAr (محاضرة/عملي — عشان السكشنين اللي اسمهم «01» يبانوا مختلفين). سكشن مش بتاع الدكتور ← Error. الرسالة بتوصل للطالب في الشات زي أي سؤال.

4 · الخطط الدراسية مع بيانات الجامعة

GET Info/University                  // من غير Authorization
→ Faculties[].Children[] … { "Type": "Program", "Id": 10, "NameAr": "…",
     "Plan": { "ProgramId": 10, "TotalMinHours": 60,
               "Packages": [ { "TitleAr": "مقررات الكلية الأجبارية", "TypeAr": "إجبارى", "MinHours": 30,
                               "Courses": [ { "Code": "BAS101", "NameAr": "…", "CreditHours": 3 } ] } ] } }

GET Info/University?plans=false      // الشجرة بس (≈19KB بدل ≈314KB)
GET Info/AcademicPlan?programId=10   // → { "Plan": {…} } لبرنامج واحد

خد بالك: البرنامج ممكن يبقى تحت الكلية على طول (من غير قسم) أو تحت قسم — اعتمد على Type: "Program" مش على العمق. الخطة = الحالية للبرنامج، ولو مفيش «حالية» ← أحدث سنة.

جرّبها بنفسك

كل الأسامي اللي فوق بالظبط زي الـ JSON اللي بيرجع. الديمو (:9301) بينادي نفس الروابط دي — افتح الـ DevTools وشوف الريكوست.

★ الجديد ١ — مخرجات ميتنج 30 سبتمبر (اتنفّذت 1 أكتوبر)

كل بند اتقال في الميتنج، اتعمل فيه إيه، إنت كموبايل تعمل إيه، واتشرح فين في الدليل. للبيزنس: نفس النقط بكلام من غير كود ومعاها إعدادات الأدمن في شرح البيزنس. كله متنزّل على السيرفر (109.123.243.32:9300) ومتجرّب على داتابيز Innovation.

⚙️ إعدادات الأدمن لكل نقطة — بالصورة

كل اللي تحت في http://109.123.243.32:9300/Admin ← Setup. غيّر الخانة، واضغط Save changes تحت — الحفظ بيحفظ التاب اللي غيّرته بس (عليه ●) ومش بيلمس أي إعداد تاني. النقط 1 و2 و3 مالهاش إعداد: بتشتغل لكل الجامعات من بيانات الـ SIS.

4 التقويم الأكاديمي — Setup ← Academic rules ← «Academic calendar shows»

الاختيار ده بيحدد أنهي أنشطة من أجندة الفصل تظهر للطالب:

الاختيار	بيظهر
Only activities ticked "for students"	المعلّم عليه «للطلاب» بس — القديم، والافتراضي لأي جامعة جديدة
Every activity ticked "show" or "for students"	المعلّم «يظهر» أو «للطلاب» — ده اللي على Innovation
Every activity of the term	كل أنشطة الفصل

لو التقويم فاضي عند جامعة: غالبًا المسجّل بيعلّم «يظهر» بس — اختار التاني.

5 الساعات المكتبية وجدول الدكتور — Setup ← Academic rules ← «A lecturer’s term is the one they teach in»

سيبه مفتوح (الافتراضي، وده اللي على Innovation). مفتوح = الدكتور بيدخل على الترم الحالي، ولو مالوش فيه سكاشن ← آخر ترم بيدرّس فيه، فجدوله مايبقاش فاضي والساعات المكتبية اللي يسجّلها تروح لنفس ترم الطلبة — وتظهر في دليل الأساتذة عندهم.

مقفول = الدكتور بيدخل على اللي «Which semester a student sees» بيقوله بالظبط.

الساعات المكتبية نفسها بيكتبها الدكتور (من التطبيق أو من النظام القديم) — مش من الأدمن.

6 لوحة الإدارة نفسها

Overview = سطر لكل جزء: الجامعة دي متظبطة على إيه، ولو فيه مشكلة تحذير أحمر و«Change →» بيوديك على الخانة. Setup = التابات متجمّعة بالترتيب: الجامعة ← الاتصال والدخول ← الأكاديمي ← التكاملات ← الإدارة.

اللينك http://109.123.243.32:9300/Admin · اليوزر admin · الباسورد عند محمد عطية.

7 بيانات الجامعة قبل الدخول — Setup ← Public info & contact

اكتب مرة واحدة: الاسم المختصر، رابط اللوجو، الألوان، النبذة بالعربي والإنجليزي، الموقع والإيميل والتليفون والعنوان، ورابط سياسة الخصوصية (الستورين بيطلبوه — Overview بيحذّر لحد ما يتكتب).

الكليات والأقسام والبرامج مابتتكتبش هنا — بتتقري من الـ SIS لوحدها. الخانة الوحيدة ليها: «Include the academic tree» (مفتوحة).

على Innovation: الكليات ظاهرة، والباقي لسه محتاج يتكتب.

8 تواصل معنا — Setup ← Public info & contact ← Contact cards

«+ Add a contact card» لكل مكتب: الاسم بالعربي والإنجليزي، التليفون، الإيميل، الواتساب، مواعيد العمل. وتحتها «Social links» لصفحات الجامعة.

كل كارت بيظهر في شاشة «تواصل معنا» بأزرار اتصال / إيميل / واتساب. لو مفيش كروت، الشاشة بتقول إن الجامعة لسه مكتبتش بيانات التواصل.

على Innovation: مفيش كروت لسه.

9 اللوجين بـ 3 طرق — Setup ← Sign-in methods

«Main sign-in method» بيختار الطريقة، والخانات اللي تحته بتتغيّر حسب الاختيار:

① يوزر + باسورد افتراضي — «Password rule»: Any password (أي باسورد — اللي على Innovation دلوقتي عن قصد عشان التيست) أو One shared default password تكتبه في «Default password» (زي 123). بيتخزّن مشفّر، والخانة بتفضل فاضية بعد الحفظ وده طبيعي.

② Active Directory — «Domain controller» (المسار القديم من النظام القديم ينفع زي ما هو) و«Users' domain». لو الدومين رافض الاتصال العادي علّم «Use LDAPS». قبل الحفظ جرّب: اكتب يوزر وباسورد حقيقيين واضغط «Test sign-in» — بيقولك نجح ولا ليه لأ، ومش بيحفظ حاجة.

③ Microsoft — «Sign-in domain» (زي ku.edu.bh)، «Tenant id» (اختياري)، و«Accepted audience(s)» = Client ID بتاع تطبيق الموبايل على Azure. «Also accept user name + password» بيسيب ① أو ② شغالين جنبه.

🚩 فلاج التيست: «Token checking»

ده الفلاج اللي بيتحكّم في الجزء ده بالظبط: «كان بيفك التوكن من غير ما يتأكد منه ← بقى بيتحقق من التوقيع والـ tenant والـ audience والصلاحية».

الاختيار	بيعمل إيه	إمتى تستخدمه
Verify signature, tenant, audience and expiry (الافتراضي)	التوكن بيتراجع مع مايكروسوفت فعلًا. توكن متزوّر أو منتهي أو من تطبيق تاني بيترفض برسالة واضحة.	الإنتاج، وأي تيست بـ App Registration حقيقي أو بتوكن الـ Sandbox.
Decode only (القديم)	التوكن بيتقري من غير تحقق — زي النظام القديم بالظبط. أي توكن عليه إيميل الطالب بيدخل.	تيست بس: لو الموبايل تيم عايز يجرّب بتوكن مايكروسوفت اللي معاه دلوقتي (حتى توكن Graph) قبل ما الجامعة تعمل App Registration. بيظهر أحمر في الأدمن وOverview وReadiness لحد ما يرجع Verify — ماينفعش يتساب كده على جامعة حقيقية.

اتجرّب فعلًا — نفس التوكنات في الوضعين:

التوكن	Verify	Decode only
سليم (للطالب 73)	✔ دخل	✔ دخل
نفس التوكن بعد ما غيّرنا الاسم جوّاه لاسم دكتور	✕ اترفض	✔ دخل كالدكتور 148 — دي الثغرة
منتهي الصلاحية	✕ اترفض	✔ دخل
معمول لتطبيق تاني	✕ اترفض	✔ دخل
توكن Microsoft Graph	✕ اترفض ومعاه «ابعت الـ id_token»	بيتقري — ولو الإيميل جوّاه لطالب موجود بيدخل

دورة التيست الكاملة من غير Azure خالص: ① Sign-in methods ← «3 · Microsoft sign-in» + Token checking = Verify ← Save. ② Sandbox ← علّم «Microsoft sign-in» ← Save. ③ POST /__sandbox/identity/token {"userName":"…"} بيدّيك توكن موقّع ← ابعته لـ students/LoginAZ ← بيدخل. ④ عدّل حرف في التوكن ← بيترفض. ⑤ غيّر Token checking لـ «Decode only» ← التوكن المتعدّل بيدخل — ده بالظبط الثغرة القديمة، وبيوضّح ليه Verify لازم. ⑥ رجّع Verify و«1 · default password» بعد التجربة.

وكمان اتصلّح في السكة

📷 جرّب الحضور بالـ QR النهاردة

الدكتور atef.dahesh بقى عنده محاضرتين يوم الخميس (بيانات تجريبية مضافة جنب جدوله الأصلي — مالمسناش مواعيده):

الدورة: ① الدكتور يدخل ← محاضراته ← يختار المحاضرة ← يعرض الكود (academicstaff/GetLectQRCode). ② الطالب يمسح (students/GetStudentAttend) ← «تم تسجيل الحضور بنجاح»؛ مرة تانية ← «حضورك مسجّل بالفعل»؛ طالب مش في السكشن ← «إنت مش مسجّل في السكشن ده». ②½ جديد كشف الدكتور (Staff/GetAbsenceDetails) بيقول لكل طالب Scanned / ScannedAt وفوقه ScannedCount — والمسح بقى بيسجّل «حاضر» في الكشف على طول، والباقي «لسه» (AttendanceState: NotTaken) — شوف الجديد ٢. ③ اختياري بعد ما المحاضرة تخلص: Staff/CloseLectureAttendance ← كل اللي مامسحش بيتسجّل غياب، والرد بيقول كام حضر وكام اتسجّل غياب. (إخفاء الكود نفسه بقى academicstaff/SetQrSession.) قبل نهاية المحاضرة القفل بيترفض برسالة «it can be closed after 14:00» — اتصلّح (كان بيقول «اتقفلت» ومايكتبش ولا غياب).

حسابات التيست — تجرّب إيه بإيه

الباسورد على Innovation لسه «أي حاجة» — بقصد، عشان شغلكم. لو الجامعة عايزة باسورد موحّد، ده من الأدمن من غير ما حد يغيّر كود.

★ شرح البيزنس — كل نقطة اتعمل فيها إيه، وإعداداتها

للبيزنس والتيست تيم: من غير كود. كل نقطة من ميتنج 30 سبتمبر — المطلوب، اللي بقى بيحصل، الإعداد اللي بيتحكم فيها من لوحة الإدارة (فين، اختياراته، الافتراضي، ومتظبط على إيه دلوقتي)، وإزاي تتأكد بنفسك. لوحة الإدارة: http://109.123.243.32:9300/Admin ← Setup. الديمو: http://109.123.243.32:9301.

1 المقر والسكاشن — أيام وموقع التدريس

المطلوب: كل مقرر/سكشن يبان عليه بيتدرّس أنهي أيام، الساعة كام، وفين (المقر والمبنى والقاعة).

اللي بقى بيحصل: في جدول الطالب وقايمة مقرراته، وفي جدول الدكتور، كل سكشن بيظهر عليه الأيام والوقت والمقر. ولو السكشن ليه أكتر من ميعاد في أماكن مختلفة (محاضرة في مبنى ومعمل في مبنى تاني) كل ميعاد بيظهر لوحده.

⚙️ مفيش إعداد — بيشتغل كده لكل الجامعات، والبيانات من الـ SIS نفسه.

✅ تتأكد إزاي: ادخل الديمو بالطالب ← «المقررات الدراسية»: تحت اسم المقرر هتلاقي مثلًا «الأربعاء · 09:00–12:00 · Main Campus · …». لو المقرر مالوش ميعاد متسجّل في الـ SIS مش هيظهر سطر.

2 المتطلبات الدراسية — الدرجة / «مسجل» / «-----»

المطلوب: في الخطة الدراسية: لو الطالب خلّص المقرر تظهر درجته، لو مسجّله دلوقتي تظهر كلمة «مسجل»، ولو عمره ما سجّله تظهر «-----».

اللي بقى بيحصل: بالظبط كده. كل مقرر في الخطة بقى عليه واحدة من التلاتة، ولو المقرر اتاخد أكتر من مرة بيبان عليه «معاد». والدرجة مابتظهرش غير لما النتيجة تتعتمد في الـ SIS.

⚙️ مفيش إعداد — بيشتغل كده لكل الجامعات، والبيانات من الـ SIS نفسه.

✅ تتأكد إزاي: الديمو ← «خطة الدراسة» ← دوس على أي مسار: قدام كل مقرر A- أو B+… أو «مسجل» أو «-----».

4 التقويم الأكاديمي مش بيرجّع داتا

المطلوب: التقويم يرجّع مواعيد الفصل.

اللي بقى بيحصل: اتصلّح. السبب: القاعدة القديمة بتعرض على الموبايل بس الأنشطة اللي المسجّل علّم عليها «للطلاب»، والمسجّل عندنا بيعلّم «يظهر» بس — فالتقويم كان فاضي رغم إن فيه أنشطة. بقى إعداد، والتقويم دلوقتي فيه مواعيد الربيع كلها (48 نشاط لكل الكليات، و6 لكلية الطالب).

⚙️ إعداد في الأدمن

المكان Setup ← Academic rules ← «Academic calendar shows»

الاختيارات «للطلاب» بس (القديم) · «Shown» = اللي عليه «يظهر» أو «للطلاب» · «All» = كل أنشطة الفصل

الافتراضي «للطلاب» بس — عشان أي جامعة قديمة ماتتغيّرش من غير ما تختار

على Innovation Shown

✅ تتأكد إزاي: الديمو ← الخدمات ← «التقويم الأكاديمي»: العنوان بيقول «من الـ SIS · N نشاط» والأنشطة بتواريخها الحقيقية. ولو حبيت تشوف الفرق: غيّر الإعداد لـ «للطلاب» واحفظ ← التقويم هيفضى.

5 الساعات المكتبية في دليل أعضاء هيئة التدريس

المطلوب: دليل الأساتذة يعرض الساعات المكتبية لكل دكتور.

اللي بقى بيحصل: بقت جوّه الدليل نفسه: كل دكتور (والمرشد الأكاديمي) تحت اسمه أيامه ومواعيده. كانت فاضية لسببين: مفيش مواعيد متسجّلة للربيع أصلًا، والدكتور كان بيدخل على ترم الصيفي فأي ميعاد يسجّله من الموبايل كان بيروح للصيفي والطالب (اللي على الربيع) مش شايفه. اتصلّح ترم الدكتور (نقطة 10)، واتحطّت مواعيد تجريبية لـ 9 دكاترة عشان التيست. ودكتور مالوش مواعيد بيظهر عنده «لا توجد ساعات مكتبية».

⚙️ مفيش إعداد — بيشتغل كده لكل الجامعات، والبيانات من الـ SIS نفسه.

✅ تتأكد إزاي: الديمو ← «دليل أعضاء هيئة التدريس»: كل كارت تحته «الساعات المكتبية» (الإثنين 10:00–12:00…). المواعيد التجريبية مكتوب عليها «بيانات تجريبية 2026-10-01».

6 بيانات صفحة الأدمن

المطلوب: اللينك واليوزر والباسورد، وتنظيم الصفحات عشان تبقى سهلة لكل عميل.

اللي بقى بيحصل: اللينك: http://109.123.243.32:9300/Admin · اليوزر: admin · الباسورد: عند محمد عطية (مابيتكتبش في دليل منشور).
والصفحات اتنظّمت: Overview بتقول في سطر لكل جزء الجامعة دي متظبطة على إيه، ولو فيه مشكلة بتحذّر وتوديك على مكانها. وSetup بقى منيو جانبي بترتيب ما بتظبط عميل جديد (الجامعة ← الاتصال والدخول ← الأكاديمي ← التكاملات ← الإدارة). والحفظ بيحفظ اللي غيّرته بس (عليه علامة ●) — مفيش إعداد تاني بيتلمس بالغلط، وكل حفظ بياخد نسخة احتياطي من القديم.

⚙️ مفيش إعداد — بيشتغل كده لكل الجامعات، والبيانات من الـ SIS نفسه.

✅ تتأكد إزاي: ادخل الأدمن ← Overview: هتلاقي «Sign-in: User name + ANY password» ومعاه تحذير، و«Academic rules: … calendar: Shown».

7 ريكوست من غير Authorization يرجّع بيانات الجامعة (عشان الستور)

المطلوب: مراجع الـ App Store / Google Play بيفتح التطبيق من غير حساب — لازم يلاقي بيانات الجامعة.

اللي بقى بيحصل: في شاشة الدخول فيه زرار «عن الجامعة» بيفتح من غير حساب: اسم الجامعة ولوجو ونبذة وتواصل عام، وكل الكليات بأقسامها وبرامجها. البيانات من مصدرين زي ما اتقال في الميتنج: الكليات والأقسام والبرامج من الـ SIS لايف (الشجرة الأكاديمية)، والباقي (اللوجو، النبذة، الإيميل…) بيتكتب مرة في الأدمن لأن الـ SIS مفيهوش.

⚙️ إعداد في الأدمن

المكان Setup ← Public info & contact

الاختيارات الاسم المختصر · اللوجو · الألوان · النبذة (عربي/إنجليزي) · الموقع · الإيميل · التليفون · العنوان · دبوس الخريطة · لينك سياسة الخصوصية · لينكات السوشيال · «Include the academic tree» (إظهار الكليات)

الافتراضي فاضية — والكليات ظاهرة

على Innovation الكليات ظاهرة (8)، والباقي لسه محتاج يتكتب

✅ تتأكد إزاي: الديمو ← شاشة الدخول ← «عن الجامعة»: 8 كليات، دوس على كلية تشوف أقسامها وبرامجها. قبل الرفع على الستور: لينك سياسة الخصوصية لازم يتكتب — صفحة Overview بتحذّر لحد ما يتكتب.

8 تواصل معنا

المطلوب: بيانات عامة ولا إرسال إيميل للموظفين؟ ومن غير Authorization عشان مراجعة الستور.

اللي بقى بيحصل: القرار: بيانات عامة بس دلوقتي. شاشة «تواصل معنا» (من شاشة الدخول ومن غير حساب) بتعرض كارت لكل مكتب — القبول، شؤون الطلاب، الدعم الفني… — بأزرار اتصال وإيميل وواتساب ومواعيد العمل. الإرسال من التطبيق للموظفين اتأجّل لأنه من غير حساب ومحتاج حماية من الإزعاج.

⚙️ إعداد في الأدمن

المكان Setup ← Public info & contact ← «Contact cards»

الاختيارات كارت لكل مكتب: الاسم (عربي/إنجليزي) · التليفون · الإيميل · الواتساب · مواعيد العمل

الافتراضي مفيش كروت

على Innovation لسه محتاجة تتكتب — الشاشة بتقول «الجامعة لسه مكتبتش بيانات التواصل»

✅ تتأكد إزاي: اكتب كارت واحد في الأدمن واحفظ ← الديمو ← «تواصل معنا» هيظهر فيها الكارت بأزراره.

9 اللوجين بـ 3 طرق

المطلوب: (1) الدخول الافتراضي باليوزر والباسورد الافتراضي، (2) Active Directory، (3) Microsoft Azure — ومراجعة هل شغالين.

اللي بقى بيحصل: قبل: (1) كان بيقبل أي باسورد. (2) كان موجود في الأدمن بس مش متنفّذ — بيرفض أي حد دايمًا. (3) كان بيقبل توكن مايكروسوفت من غير ما يتأكد إنه حقيقي — يعني أي حد يقدر يزوّر دخول باسم أي طالب (ونفس المشكلة في النظام القديم).
دلوقتي الـ 3 شغالين والأدمن بيختار: (1) إما «أي باسورد» للديمو، أو «باسورد موحّد» تكتبه (زي 123). (2) التطبيق بيسأل الـ Active Directory بتاع الجامعة هل الباسورد صح — وفي الأدمن زرار «Test sign-in» تجرّب بحساب حقيقي. (3) التوكن بيتراجع مع مايكروسوفت فعلًا (التوقيع، والجامعة، والتطبيق، والصلاحية)؛ وتقدر تسيب اليوزر والباسورد شغالين جنبه أو تقفلهم.

⚙️ إعداد في الأدمن

المكان Setup ← Sign-in methods

الاختيارات «Main sign-in method»: 1 · 2 · 3 — ولـ 1: «أي باسورد» / «باسورد موحّد». ولـ 2: الـ domain controller والدومين وزرار الاختبار. ولـ 3: دومين الجامعة، الـ Client ID، «Verify» (الصح) أو «Decode only» (القديم — بيظهر أحمر)، و«Also accept user name + password».

الافتراضي 1 · أي باسورد

على Innovation 1 · أي باسورد — عن قصد عشان شغل الموبايل تيم والتيست ما يقفش. Overview وReadiness بيحذّروا منها.

✅ تتأكد إزاي: (1) غيّر لـ «باسورد موحّد» واكتب 123 واحفظ ← الدخول بأي باسورد غير 123 بيترفض «password not correct». (رجّعه بعد التجربة.) (3) من غير Azure: Sandbox ← «Microsoft sign-in» بيدّي توكن تجريبي — التفاصيل في دليل دخول مايكروسوفت. (2) محتاج بيانات الـ AD من الجامعة.

طلبات نادر (الجولة التانية) — للبيزنس

التفاصيل التقنية للموبايل في الجديد ٢.

11 رسالة من الدكتور لطلبة المقرر — أو لسكاشن يختارها

المطلوب: الدكتور يبعت رسالة لكل طلبة المقرر، ولو بيدرّس أكتر من سكشن يختار أنهي.

اللي بقى بيحصل: من «مقرراتي» ← «رسالة للطلبة»: السكاشن بتظهر بعدد طلبتها (كلها متعلّمة افتراضيًا)، يكتب مرة ويبعت. الرسالة بتوصل لكل طالب مرة واحدة حتى لو في سكشنين، وبتروح لطلبة سكاشن الدكتور نفسه بس — مايقدرش يبعت لسكشن مش بتاعه.

⚙️ مفيش إعداد — بيشتغل كده لكل الجامعات، والبيانات من الـ SIS نفسه.

✅ تتأكد إزاي: ادخل بـ atef.dahesh ← مقرراتي ← BAS112 ← رسالة للطلبة ← اختار سكشن ← ابعت ← «اتبعتت لـ N طالب»؛ وادخل بطالب من السكشن تلاقيها في الشات.

12 حجز الساعات المكتبية — ومايتحذفش وهو محجوز

المطلوب: الطالب يحجز ميعاد من الساعات المكتبية؛ لو محجوز الدكتور مايقدرش يحذفه أو يعدّله؛ والحجوزات تظهر مع المواعيد وفي جدول الدكتور.

اللي بقى بيحصل: الطالب بيشوف المواعيد المتاحة لدكاترته ومرشده للأسبوعين الجايين ويحجز (ويكتب الموضوع) أو يلغي. الدكتور بيشوف تحت كل ميعاد مين حاجز وإمتى وعن إيه، والميعاد المحجوز مقفول للتعديل والحذف لحد ما الحجز يتلغي. الدكتور يقدر يلغي حجز بسبب — والطالب بيشوف الإلغاء والسبب. الحجوزات بتظهر في جدول الدكتور وجدول الطالب.

⚙️ إعداد في الأدمن

المكان Setup ← Attendance & office hours ← «Office-hour booking»

الاختيارات الحجز مفتوح/مقفول · عدد الطلبة في الميعاد · الحجز لحد كام يوم قدّام · الطالب يلغي لحد كام دقيقة قبل

الافتراضي مفتوح · 1 · 14 يوم · 60 دقيقة

على Innovation نفس الافتراضي

✅ تتأكد إزاي: طالب basmala.nabih.25010008 حاجز عند atef.dahesh الثلاثاء 6 أكتوبر ← ادخل بالدكتور ← ساعاتي المكتبية ← الميعاد «محجوز» وزرار الحذف مقفول ← «إلغاء» بسبب ← الطالبة تشوف السبب.

13 الخطط الدراسية مع بيانات الجامعة

المطلوب: بيانات الجامعة والكلية والبرنامج ترجع معاها الخطط الدراسية.

اللي بقى بيحصل: شاشة «عن الجامعة» (من غير حساب) بقت تعرض لكل برنامج خطته: المجموعات (متطلبات جامعة، كلية، إجباري، اختياري) بعدد ساعاتها ومقرراتها بالكود والساعات. الخطة = الخطة الحالية للبرنامج في الـ SIS.

⚙️ إعداد في الأدمن

المكان Setup ← University ← «Show study plans»

الاختيارات مفتوح / مقفول

الافتراضي مفتوح

على Innovation مفتوح

✅ تتأكد إزاي: افتح الديمو من غير لوجين ← عن الجامعة ← كلية ← «الخطة الدراسية» جنب البرنامج.

14 الحضور زي صفحة البورتال: مفيش افتراضي، 4 حالات، حضور الكل، والمصدر

المطلوب: مفيش حالة افتراضية؛ زرار «حضور الكل»؛ الحالات حاضر / غياب / متأخر / عذر؛ تسجيل مصدر الحضور؛ كل علامة تتحفظ فورًا لأن الاعتماد هيتلغي.

اللي بقى بيحصل: الكشف بيفتح ومحدش متعلّم — اللي مالوش علامة «لسه» (مش «حاضر»)، عشان محاضرة الدكتور نسي ياخد غيابها ماتطلعش «الكل حضر». الحالات الأربعة زي البورتال بالظبط (المتأخر بعدد دقايقه). «حضور الكل» بيعلّم اللي لسه بس، ومش بيلمس اللي مسح أو اتعلّم غياب/عذر. جنب كل طالب مصدر علامته: يدوي / QR / كود / موقع. وكل علامة بتتسجّل في الـ SIS أول ما تتحفظ — والاعتماد اتقفل من الأدمن على Innovation.

⚙️ إعداد في الأدمن

المكان Setup ← Attendance & office hours ← «Register approval»

الاختيارات مفتوح = الدكتور بيعتمد كل كشف (والكشوف بتتقفل بالترتيب) · مقفول = كل علامة نهائية لما تتحفظ

الافتراضي مفتوح (زي النظام القديم)

على Innovation مقفول — اتقفل 1 أكتوبر حسب قرار إلغاء الاعتماد

✅ تتأكد إزاي: atef.dahesh ← الحضور ← BAS112 ← الكل «لسه» ← دوس «حضور الكل» ← العدّاد يتغيّر، وافتح نفس اليوم في البورتال تلاقيهم حاضرين.

15 QR بيتغيّر كل شوية + كود للي مش عارف يمسح + قفل الحضور

المطلوب: آلية تجديد الـ QR كل فترة بفترة سماح من الأدمن؛ كود للجلسة؛ قفل الحضور = قفل جلسة الـ QR (إظهار/إخفاء).

اللي بقى بيحصل: الكود على شاشة الدكتور بيتغيّر لوحده كل 30 ثانية، فصورة الكود اللي اتبعتت على جروب مابتشتغلش بعد دقيقة. الكود القديم بيفضل مقبول 15 ثانية بعد ما يتغيّر (لكاميرا بطيئة). تحت الـ QR رقم من 6 أرقام ثابت طول المحاضرة للي موبايله مش بيمسح. «اقفل الحضور» بيخفي الكود وبيرفض أي مسح أو كود بعدها — ومش بيسجّل غياب لحد؛ «افتح تاني» بيرجّعه.

⚙️ إعداد في الأدمن

المكان Setup ← Attendance & office hours ← «Lecture QR»

الاختيارات كود جديد كل (ثانية؛ 0 = ثابت) · فترة السماح · إظهار كود الجلسة · قبول الـ QR الثابت القديم

الافتراضي 30 · 15 · مفتوح · مفتوح

على Innovation نفس الافتراضي — «قبول القديم» يتقفل لما كل نسخ الأبلكيشن تبعت الكود المتغيّر

✅ تتأكد إزاي: atef.dahesh ← الحضور بالـ QR ← BAS112 ← اعرض الكود ← العدّاد بيعد ← طالب يكتب الرقم ← «اتسجّل» ← «اقفل الحضور» ← طالب تاني يكتب الرقم ← «الحضور للمحاضرة دي اتقفل».

1 المقدمة — إحنا فين بالظبط؟

اقرا الجزء ده الأول. هيوفر عليك ساعات من الأسئلة.

خلينا نبدأ من الأول. في 3 حاجات منفصلة، ولازم تفرق بينهم:

طب مين اللي جرّب ده؟

كل الأرقام اللي في التيوتوريال ده مش تخمين — إحنا شغّلنا السيرفس على داتابيز Innovation_Demo الحقيقية (984 جدول) وناديّنا كل إندبوينت واحد واحد وسجّلنا رد كل واحد. الطالب اللي بنجرّب بيه:

2 الصورة الكبيرة

إزاي الـ 3 حتت بيتكلموا مع بعض.

┌─────────────────────────────────────────────────────────────────────┐
│  الموبايل / MobileDemo            (React, عربي RTL)                 │
│  ─────────────────────────────────────────────────────────────────  │
│  app/api.js     ← بينادي السيرفس ويفك الـ envelope القديم           │
│  app/data.jsx   ← بيحوّل رد السيرفس لشكل الشاشات بالظبط              │
│  screens-*.jsx  ← الشاشات (نفس كود البروتوتايب)                     │
└────────────────────────────┬────────────────────────────────────────┘
                             │  HTTP  (JWT في هيدر Authorization)
                             ▼
┌─────────────────────────────────────────────────────────────────────┐
│  Informatique.SIS.MobileService                     (.NET 10)       │
│  ─────────────────────────────────────────────────────────────────  │
│  EndPoints/       ← المسارات القديمة زي ما هي (students/login…)      │
│  FeatureGate      ← لو الخدمة مقفولة → يرد رسالة، ما يقعش أبدًا       │
│  Business/        ← الـ handlers + الـ SQL جوّه الكود                 │
│  ClientProfile    ← كل سلوك العميل من ملف JSON واحد                │
└────────────────────────────┬────────────────────────────────────────┘
                             │  Dapper (SQL نصّي، مفيش SP بيتنشر)
                             ▼
┌─────────────────────────────────────────────────────────────────────┐
│  داتابيز العميل (Innovation_Demo)          984 جدول                 │
└─────────────────────────────────────────────────────────────────────┘

3 قواعد لازم تفهمها قبل ما تكتب سطر

{ "result": "Ok",    "details": "NO ERROR", ... }
{ "result": "ERROR", "details": "data not found" }

3 شغّل النظام عندك

من الصفر لحد ما تشوف بيانات طالب حقيقي — 3 خطوات.

1. شغّل السيرفس

   من فولدر Informatique.SIS.MobileService. لازم تحدد مكان ملف البروفايل:

   # Windows CMD
   set ClientProfile__Path=C:\path\to\clientprofile.json
   dotnet run --project Informatique.SIS.MobileService.WebApi ^
              --no-launch-profile --urls http://localhost:5099

   اتأكد إنه شغال: http://localhost:5099/health لازم يرد {"status":"up","setupMode":false}

2. شغّل الديمو

   من فولدر MobileDemo — محتاج Node 18 أو أحدث بس:

   node server.js
   # أو دوس دبل كليك على start.bat

   افتح http://localhost:4173/ — واختار حساب من الكروت اللي في شاشة الدخول.

3. افتح لوحة الإدارة

   http://localhost:5099/Admin — منها تظبط البروفايل وتشغّل فحص الجاهزية.

4. شغّل الـ Sandbox جديد

   من Profile → تاب Sandbox. ده اللي بيخلّي الدفع والإرشاد والمنصة التعليمية والإشعارات تشتغل من غير بيانات اعتماد حقيقية. ظبّط اللينكين دول:

   Browser base URL   http://localhost:5099
   Loopback base URL  http://127.0.0.1:5099

   اتأكد: http://localhost:5099/health لازم يرد "sandbox":["payments","meetings","lms","push"]، وصفحة التحكّم على http://localhost:5099/__sandbox.

الحسابات الجاهزة

الباسورد: أي حاجة. مش بيتشيك عليه — اعرف ليه.

كوليكشن تسجيل المقررات — كل عملية في فولدر

غير الكوليكشنات المقسّمة بالشاشات، فيه كوليكشن مخصوص لتسجيل المقررات مقسّم بالعمليات: كل عملية فولدر لوحدها، وكل فولدر كامل — بيدخل، بيقرا اللي محتاجه، بينفّذ، وبيقرا تاني عشان يتأكد إن اللي اتكتب بان.

1  تسجيل مقرر جديد        دخول → المسموح → المتاح → سجّل ✍️ → 🔎 تأكيد
2  تغيير سكشن             دخول → مقرراتي → السكاشن المرشّحة → انقل ✍️ → 🔎 تأكيد
3  حذف سكشن               دخول → مقرراتي → حذف ✍️ → 🔎 المقرر لسه مسجّل
4  حجز مقعد + الخروج منه   دخول → سكشن مليان → احجز ✍️ → 🔎 → اخرج ✍️ → 🔎
5  إسقاط مقرر               دخول → مقرراتي → احذف ✍️ → 🔎 الحالة بقت 6
6  تراجع عن الإسقاط         دخول → مقرراتي → السكاشن → تراجع ✍️ → 🔎 رجع وفي سكشن
7  قراءات مرجعية          نداءات مابتكتبش حاجة

⬇️ حمّل كوليكشن تسجيل المقررات (٧ فولدرات · ٣٥ ريكوست)

newman run workflow-course-registration.postman_collection.json --folder "5 · إسقاط مقرر"

العناوين — HTTPS

التلات خدمات بقى ليها دومينات بشهادات Let's Encrypt حقيقية، عن طريق sslip.io اللي بيحوّل أي <ip>.sslip.io للـ IP نفسه — يعني من غير ما نشتري دومين ولا نظبط DNS.

البورتات القديمة لسه شغالة زي ما هي — الدومينات إضافة مش بديل. الـ baseUrl في كل كوليكشنات الـ Postman بقى على دومين الـ API، وتقدر ترجّعه http://localhost:5099 لو بتجرّب على جهازك.

حساب واحد بيشغّل كل الشاشات

كل شاشات الطالب في الديمو وفي الدليل ماشية على حساب واحد بس — من تسجيل الدخول لحد آخر شاشة، من غير ما حد يضطر يغيّر المستخدم في نص العرض.

ده مكانش الوضع قبل كده: التسجيل كان محتاج حساب طالب تاني، لأن جدول كلية العلاج الطبيعي للترم ده كان متعمول بالكامل بس ماتعتمدش، وMOB_GET_STD_CRS_REG_PLN_SEC مابيرجّعش سكشن إلا لو عرضها معتمد. بعد اعتماد الجداول وفتح السكاشن للتسجيل الذاتي (ONLINE_FLG = 1 — الطالب مابيشوفش غيرها) بقى عند الطالب ٣٠ مقرر من خطته و١٢٩ سكشن، وقدامه ٨ مقررات متاحة للإضافة بسكاشن مفتوحة — فالعرض يتكرر أكتر من مرة من غير ما الليستة تفضى.

4 مفتاح الرموز

هتشوف الرموز دي في كل الجداول اللي جاية — افهمها مرة واحدة.

حالة الإندبوينت

حالة الخاصية في الباك إند

عمود «الحساب» في جداول الإندبوينتات

كل رقم في الدليل ده جه من نداء حقيقي، والنداء مابيرجّعش داتا غير لما يتعمل بالحساب الصح. عشان كده كل إندبوينت مكتوب جنبه اتنادى بحساب مين:

الردود محفوظة جوّه الكوليكشن

كل ريكويست في الـ Postman جايّ معاه الرد الحقيقي بتاعه محفوظ كـ Example — تقدر تفتحه وتشوف شكل الرد من غير ما تبعت حاجة. الردود دي مش مكتوبة بالإيد: اتسجّلت من تشغيل فعلي لكل إندبوينت على السيرفر المنشور، بالحساب المكتوب جنبه.

5 الشاشات — واحدة واحدة

33 شاشة. لكل واحدة: صورتها، بتشتغل إزاي، جدول الإندبوينتات اللي محتاجاها، وجدول الخصائص بإيه المتعمل وإيه الناقص وإيه المطلوب — وكوليكشن Postman جاهز للتحميل.

6 الـ Client Profile — قلب النظام كله

لو فهمت الجزء ده، فهمت السيرفس كله. الجزء ده هو سبب وجود المشروع أصلاً.

القصة من الأول

قبل كده كان فيه 17 نسخة منفصلة من نفس الباك إند — واحدة لكل جامعة. كل ما جامعة تطلب تعديل، حد يروح ينسخ الكود ويعدّله ويعمل fork جديد. النتيجة: 17 كود بيس، كل واحد بيبعد عن التاني، وأي إصلاح لازم يتعمل 17 مرة.

الملف ده فيه إيه؟

{
  "client":            // اسم وكود الجامعة
  "connectionStrings": // الاتصال بالداتابيز (كتابة + قراءة اختيارية)
  "auth":              // طريقة الدخول + إعدادات الـ JWT
  "academic":          // نظام ساعات ولا سنوي + إزاي نحدد الفصل الحالي
  "features":          // { "اسم الخدمة": true/false } لكل خدمة
  "payments":          // بوابة الدفع وبياناتها  ← جديد
  "wallet":            // المحفظة الجامعية        ← جديد
  "meetings":          // Microsoft Teams          ← جديد
  "lms":               // Moodle                   ← جديد
  "campus":            // حدود حرم الجامعة على الخريطة   ← جديد
  "push":              // إعدادات FCM للإشعارات
  "mail":              // SMTP (لكود نسيت الباسورد)
  "infoPages":         // لينكات اللائحة ورسالة الرئيس
  "backOffice":        // مفتاح API للباك أوفيس
  "admin":             // يوزر وباسورد لوحة الإدارة
  "sandbox":           // تقليد التكاملات وقت التطوير  ← جديد
}

لوحة الإدارة اتنظّمت

روح http://109.123.243.32:9300/Admin (أو http://localhost:5099/Admin عندك). اليوزر admin، والباسورد عند محمد عطية. أول مرة على سيرفر جديد (لو مفيش بروفايل) هتدخل على طول في «وضع الإعداد» وتقدر تبدأ من preset جاهز. فوق فيه 4 صفحات: Overview · Setup · Readiness · Sandbox control (لو شغال) — و«Sign out».

التابات واحد واحد

① Identity — هوية الجامعة

كود الجامعة واسمها بالعربي والإنجليزي والدولة. الكود ده بيظهر في /health وInfo/Capabilities، والاسم في Info/University.

② Public info & contact — اللي بيظهر قبل الدخول جديد

الاسم المختصر، اللوجو، الألوان، النبذة، الموقع والإيميل والتليفون والعنوان ودبوس الخريطة، ولينك سياسة الخصوصية (الستورين بيطلبوه)، وكروت التواصل (مكتب لكل كارت: تليفون، إيميل، واتساب، مواعيد) ولينكات السوشيال. ده اللي بيطلع في Info/University وInfo/ContactUs من غير توكن. الكليات والأقسام مابتتكتبش هنا — بتتقري لايف من الـ SIS.

③ SIS database — الاتصال

سيرفر وداتابيز ويوزر وباسورد. فيه خانة اختيارية لـ read replica — لو حطيتها، كل القراءات هتروح عليها والكتابات بس على الأساسي. لو سيبتها فاضية، الاتنين على نفس الاتصال.

④ Sign-in methods — الدخول بـ 3 طرق اتعمل

كل الطرق بتنتهي بنفس الحاجة: اليوزر لازم يكون موجود في الـ SIS، والتطبيق بياخد نفس التوكن ونفس UserMainData. اللي بيختلف إزاي الباسورد بيتثبت:

⑤ Academic rules — القواعد الأكاديمية

حاجتين:

• النظام: YearBased (سنوي) ولا Modular (ساعات معتمدة). ده بيغيّر استعلام الغياب مثلاً.
• تحديد الفصل الحالي: وده أهم إعداد وأكترهم بيتنسي. 4 أوضاع:

جديد وجنبهم إعدادين من الميتنج:

وتحتيها سياسة الحضور — إعدادين: