المصدر: docs-content/ar/04-gaps-and-fixes.mdتعديل هذه الصفحة

نُطقي — تحليل الفجوات والإصلاحات والتوصيات

كل فجوة رُصدت أثناء التنقّل العميق داخل Figma. درجة الخطورة: 🔴 تُعطِّل رحلة أساسية · 🟠 تُضعف رحلة · 🟡 صقل واتساق. وكل بند: الفجوة → الإصلاح (ما ننفّذه) → حالته في البناء.

أ. شاشات ناقصة ومسارات مسدودة#

G01 🔴 شاشة «عمليات الدفع» لدى وليّ الأمر فارغة. القائمة الجانبية تربط بصفحة المدفوعات، والإطار موجود (العقدة 1202-31659) لكن جسمه خالٍ؛ ونظام التصميم لا يحتوي إلا على محفظة الأخصائي («الرئيسية» / «المعاملات»). → الإصلاح: بناء صفحة مدفوعات وليّ الأمر: سجل دفع لكل حجز (التاريخ، الأخصائي، الجلسة، المبلغ، وسيلة الدفع، الحالة، تنزيل الإيصال) بإعادة استخدام نمط صف المعاملات؛ وصف بطاقات إجماليات («إجمالي المدفوع»، «قيد التحصيل»). أما تنفيذ الدفع نفسه فيدوي أو داخل المركز في الإصدار الأول (راجع D-10)؛ والصفحة دفتر أستاذ. → نُفِّذت في apps/web على المسار /(guardian)/payments.

G02 🟠 حقل تسجيل الدخول مُعنون بـ«الاسم» وبأيقونة شخص بينما يستخدم إنشاء الحساب واستعادة كلمة السر البريد الإلكتروني — فمن يكتب اسم العرض سيفشل دائمًا. → الإصلاح: تسميته «البريد الإلكتروني» بأيقونة بريد، مع type=email والتحقق من صيغة البريد؛ ونص الخطأ يذكر البريد الإلكتروني تحديدًا.

G03 🔴 إنشاء حساب المركز لا يجمع سوى بيانات شخصية. لا اسم للمركز ولا ترخيص ولا رقم ضريبي ولا عنوان ولا فروع — فلا يمكن فعليًا تجهيز حساب مركز من النموذج المصمَّم. → الإصلاح: إبقاء الخطوة الأولى كما صُمِّمت (الحساب الشخصي للمالك)، وإضافة خطوة ثانية «بيانات المركز»: اسم المركز (بالعربية والإنجليزية)، ورقم الترخيص مع رفع المستند، ورقم الهاتف، والمحافظة والمدينة، والفرع الأول؛ وتغذّي هذه الخطوة مسار مراجعة التفعيل نفسه الذي يمر به الأخصائيون.

G04 🟠 غموض في نافذة الحجز. شبكة المواعيد تستخدم مربعات اختيار (ما يوحي بالاختيار المتعدد)، ولا تعرض نوع الجلسة ولا مدتها ولا سعرها ولا تأكيد الأخصائي، ولا يملك المسار شاشة نجاح. → الإصلاح: رقاقات مواعيد باختيار واحد؛ وإضافة مُحدِّد لنوع الجلسة (تخاطب / تنمية مهارة / تواصل بصري / استشارة) مع المدة والسعر المسحوبَين من إعدادات جدول الأخصائي؛ وإضافة خطوة ملخّص ثم خطوة نجاح («حجزك معلق لحين التأكيد»).

G05 🟠 لا حالات فشل أو انتهاء صلاحية لرمز التحقق. لا يوجد إلا المسار السعيد والعدّاد التنازلي. → الإصلاح: رسالة خطأ داخل الحقل عند الرمز الخاطئ، وحالة انتهاء صلاحية مع إعادة الإرسال، وتحديد لعدد المحاولات (خمس محاولات → فترة تهدئة)، واختيار قناة إعادة الإرسال (SMS/WhatsApp) متوافقًا مع قنوات الإشعارات.

G06 🟡 لا حالات فارغة في أي مكان (الحجوزات والبرامج والتقييمات والوظائف وقوائم الموظفين كلها مصمَّمة ممتلئة). → الإصلاح: طقم حالات فارغة (رسم توضيحي + سطر إرشادي واحد + زر إجراء رئيسي) لكل قائمة؛ مثلًا الحجوزات الفارغة → زر «احجز أول جلسة» ينقل إلى البحث.

G07 🟡 لا حالات تحميل ولا هياكل مبدئية ولا صفحات خطأ.الإصلاح: مكوّنات هيكلية للجداول والبطاقات والرسوم البيانية؛ وحدّ خطأ عام مع صفحتَي 404 و500 بلغتين.

G08 🟠 الأخصائيون يرون الوظائف التي تقدّموا إليها لكن لا مكان لديهم لاكتشاف الوظائف. المراكز تنشر («نشر فرصة توظيف») لكن لا توجد واجهة تصفُّح أو تقديم من جهة الأخصائي. → الإصلاح: تبويب سوق وظائف داخل «الوظائف»: الشواغر المفتوحة (تصفية بالمحافظة والتخصص والفرع)، وتفاصيل الوظيفة، والتقديم بنسخة من السيرة الذاتية مأخوذة من الملف الشخصي؛ ثم يظهر الطلب في قائمة المتقدَّم إليها بحالة «تم القبول»/«مُعلق»/«تم الرفض».

G09 🟠 أولياء الأمور ذوو الأطفال المتعددين بلا مُبدِّل أطفال. توجد إطارات لـ«معلومات الطفل 2» لكن التنقل بين الأطفال غير مصمَّم. → الإصلاح: صف رقاقات لاختيار الطفل أعلى «الملف الشخصي» مع إجراء «إضافة طفل»؛ وتكتسب الحجوزات والبرامج مُرشِّحًا بالطفل.

G10 🟠 الجلسات عن بُعد بلا سطح يحمل رابط الاجتماع. يمكن أن يكون الحجز من نوع online لكن لا شيء يحمل رابط المكالمة. → الإصلاح: حقل meetingUrl على الحجوزات المؤكَّدة عن بُعد؛ وزر «انضم للجلسة» يظهر قبل الموعد بخمس عشرة دقيقة (لدى وليّ الأمر والأخصائي معًا). ومزوّد الفيديو الفعلي خارج نطاق الإصدار الأول — والحقل يقبل أي رابط (Meet/Zoom).

G11 🟠 جرس الإشعارات موجود في كل شريط علوي لكن لا لوحة إشعارات ولا شاشة لها.الإصلاح: قائمة منسدلة (آخر عشرة) وصفحة كاملة بمُرشِّحات؛ موصولة بالأحداث المذكورة في دليل المستخدم؛ وتحترم إعدادات القنوات.

G12 🟠 شريط بحث عام موجود بلا صفحة نتائج، وأولياء الأمور بلا شاشة لاكتشاف الأخصائيين إطلاقًا (الملفات الشخصية لا تُبلَغ في التصميم إلا برابط مباشر). → الإصلاح: صفحة بحث ودليل: الأخصائيون (والمراكز) مع مُرشِّحات — المحافظة، والتخصص (تخاطب/توحد/تنمية مهارات)، ونوع الجلسة، ونطاق السعر، والتقييم؛ شبكة بطاقات → الملف الشخصي.

G13 🟡 شاشة إعدادات «اللغات» تخلط لغة الواجهة باللغات المحكية (اللغة + المستوى + الإضافة). → الإصلاح: الفصل إلى (أ) «لغة التطبيق»: مُبدِّل بين العربية والإنجليزية (تبديل فوري لاتجاه الكتابة)، و(ب) «اللغات المحكية» (تبقى كما صُمِّمت، وتغذّي مطابقة ملفات الأطفال والأخصائيين).

G14 🟠 لا موافقة على الشروط والخصوصية عند إنشاء الحساب، ولا صفحات قانونية.الإصلاح: مربع موافقة يربط بصفحتَي الشروط والخصوصية بلغتين (تطبيق التوثيق يستضيف المحتوى، وتطبيق الويب يعرضه).

G15 🟡 لا حالة قفل حساب ولا حالة كثرة محاولات عند تسجيل الدخول (كلمة سر خاطئة فقط). → الإصلاح: تحديد معدّل في الخادم (خمس محاولات فاشلة → قفل خمس عشرة دقيقة) مع رسالة قفل مصمَّمة وزر لإعادة تعيين كلمة السر.

G16 🟠 الهوية العامة للمركز مفقودة. أولياء الأمور يستطيعون رؤية ملفات الأخصائيين، أما المراكز (بفروعها وأخصائييها) فلا ملف عام لها رغم أنها كيانات قابلة للحجز. → الإصلاح (موصى به، الإصدار 1.1): صفحة مركز عامة: الفروع، وقائمة الأخصائيين، وملخّص التقييمات. ويبقى الإصدار الأول على الحجز المتمحور حول الأخصائي؛ وهذا موثَّق ضمن خارطة الطريق.

G17 🟡 لا إشراف على التقييمات. التقييمات تُنشر مباشرة، ولا يملك الأخصائي إلا الإعجاب والتعليق. → الإصلاح: إجراء إبلاغ مع طابور مراجعة لدى المشرف (على مستوى API في الإصدار الأول، والواجهة لاحقًا).

G18 🟡 توجد تأكيدات حذف («مسح») لكن بلا تراجع.الإصلاح: حذف ناعم مع إشعار تراجع لعشر ثوانٍ للملاحظات والبرامج (المسودات) وبيانات العمل؛ ويبقى الحذف النهائي خلف نافذة التأكيد الحمراء المصمَّمة.

G19 🟠 مدفوعات الأخصائي موجودة كمحفظة لكن بلا مسار لطلب السحب (سجل عمليات السحب السابقة فقط). → الإصلاح: إجراء «طلب سحب» بالمبلغ ووسيلة الصرف (رقم بنكي أو رقم محفظة)، وحالات للطلب («قيد المراجعة»/«تم التحويل»/«مرفوض»)؛ ويوافق المشرف يدويًا في الإصدار الأول.

G20 🟡 تسجيل الحضور بلا سياق ولا قيود (من يضغط، ومن أين). → الإصلاح: تسجيل دخول وخروج من لوحة الموظف مع ختم زمني ومُحدِّد فرع اختياري؛ وسجل تدقيق ظاهر للمالك والمدير. والتسييج الجغرافي خارج النطاق صراحةً (موثَّق).

ب. الاتساق والثنائية اللغوية واتجاه الكتابة#

G21 🟡 تشتُّت مفردات الحالة — الحجز يستخدم معلق/انتظار/تأجيل/تم؛ والوظائف تستخدم مُعلق/تم القبول/تم الرفض؛ والبرامج تستخدم لم يتم/تم. → الإصلاح: جدول واحد لتعدادات الحالة في التوثيق، ومكوّن مشترك <StatusChip> يربط التعداد باللون والأيقونة والتسمية بالعربية والإنجليزية؛ آمن لعمى الألوان (أيقونة ونص، ولا لون وحده أبدًا).

G22 🟠 النسخة الإنجليزية واتجاه اليسار إلى اليمين غير مصمَّمَين إطلاقًا. كل الإطارات عربية من اليمين إلى اليسار. → الإصلاح: تدويل كامل من اليوم الأول: next-intl مع ar (الافتراضية، من اليمين إلى اليسار) وen (من اليسار إلى اليمين)؛ وخصائص CSS المنطقية (ps/pe، start/end) في كل مكان؛ وأيقونات واعية بالاتجاه (تُقلب الأسهم وعلامات التتابع)؛ والأرقام: أرقام لاتينية في اللغتين للبيانات (التواريخ والأسعار)، والأرقام العربية الهندية خيار لاحق.

G23 🟡 التواريخ معروضة بالشكل 25\12\2025 بشرطات مائلة عكسية، مع خطر اختلاط الاتجاه.الإصلاح: مُنسِّق واعٍ بالمحلّية (Intl.DateTimeFormat بـar-EG/en-GB) ملفوف داخل <bdi>؛ وزوج أدوات واحد formatDate/formatMoney يُستعمل في كل مكان (العملة EGP).

G24 🟡 مزج العامية المصرية بالفصحى (اللي لسة مجاوبش عنها مقابل التسميات الرسمية). → الإصلاح: الإبقاء على النبرة المصرية الدافئة عن قصد (صوت العلامة) مع توحيدها حسب السطح: العامية للإرشاد والإشعارات اللحظية، والفصحى للتسميات والجداول؛ وهذا موثَّق في دليل النصوص؛ والإنجليزية تعكس النبرة محايدةً.

ج. تحسينات تجربة الاستخدام خارج نطاق التصميم (بطلب)#

مُنفَّذة كجزء من البناء:

  • E01 الحفظ التلقائي للاستبيان — البرامج تصل إلى 3,650 بكسل من الأسئلة؛ فتُحفظ الإجابات تلقائيًا (بتأخير مُهدَّأ، ولكل سؤال على حدة) مع مؤشّر «تم الحفظ تلقائياً»؛ والاستئناف من حيث توقفت. (أكبر مكسب في تجربة الاستخدام؛ نماذج طويلة وشبكات محمول.)
  • E02 شريط تقدّم أثناء الإجابة على البرنامج — ترويسة لاصقة بنسبة المُجاب عنه وعدد المتبقي الإلزامي؛ ونقاط صفحات لنموذج التشخيص متعدد الصفحات.
  • E03 نظام إشعارات لحظية — إشعارات نجاح وخطأ وتراجع (واعية باتجاه اليمين إلى اليسار، في الأسفل جهة البداية).
  • E04 واجهة متفائلة — رقاقات حالة الحجز، والإعجاب والتعليق على التقييم، وحالة قراءة الإشعار تتحدّث فورًا مع التراجع عند الفشل.
  • E05 هياكل مبدئية مع وميض للجداول والبطاقات والرسوم البيانية؛ بلا إزاحة في التخطيط.
  • E06 لوحة أوامر (⌘K) داخل اللوحات — قفز إلى مريض أو حجز أو شاشة؛ ببحث تقريبي بالعربية والإنجليزية.
  • E07 ترقيات مُنتقي المواعيد — تعطيل المواعيد الماضية، ورقاقات سريعة «اليوم/غدًا»، وعرض آمن للمنطقة الزمنية.
  • E08 تجربة رفع الملفات — سحب وإفلات، ومعاينة الصورة، وشريط تقدّم، والتحقق من النوع والحجم، وقص الصورة الرمزية.
  • E09 عدّادات إحصائية متحركة وتلميحات على الرسوم البيانية في اللوحات (تحترم prefers-reduced-motion).
  • E10 شريط تذكير بالجلسة — الحجز القادم يظهر في الصفحة الرئيسية لوليّ الأمر والأخصائي مع إجراء الانضمام أو الاتجاهات.
  • E11 تعزيزات الجداول — ترتيب الأعمدة، وترويسة لاصقة، وتصدير CSV/Excel/PDF (كما صُمِّم) على جانب العميل.
  • E12 التحقق من النماذج — داخل الحقل، وعند مغادرته، برسائل بلغتين؛ والتحقق من خانة التدقيق في الرقم القومي المصري (أربع عشرة خانة).
  • E13 شارة الإشعارات لحظيًا — تدفّق SSE يحدّث شارة الجرس بلا إعادة تحميل.
  • E14 لوحة المفاتيح وإتاحة الوصول — حلقات تركيز، وروابط تخطٍّ، وسمات aria على الرقاقات والتبويبات والنوافذ، ولوحة ألوان مفحوصة التباين.
  • E15 بقاء المسودات لإعلانات وظائف المركز («حفظ كمسودة» كما صُمِّم) مع شريط استعادة.

د. مؤشّر إلى سجل القرارات#

كل اختيار اتُّخذ أثناء التنفيذ (إصدارات الأطر، وأشكال المجلدات، والتسمية، وتقليصات النطاق) مسجَّل بأسلوب المحادثة في 05-decisions.md، وذلك بناءً على تعليمات مالك المنتج بقبول الخيارات الموصى بها تلقائيًا وتوثيقها.