خطة تصميم واجهات منظومة روزا للكوش — Rosa
أُعدت هذه الخطة بعد مراجعة BRD وSRS وSAD بالإصدار 1.3، والعرض المالي V6، ووثيقة نطاق العمل التي حُدّثت إلى 1.10. اعتمد المستخدم بدء التنفيذ بالوكلاء والمراجعة والرفع إلى GitHub، وحدد فصل كل واجهة في مجلد مستقل يمكن تسليمه لمبرمجها. تحفظ هذه الوثيقة مرجع نطاق التصميم، وتتوفر مخرجات التنفيذ ودليل التسليم في جذر المشروع.
1. حدود مرحلة التصميم
| الواجهة | المستخدمون | طريقة عرض النموذج |
|---|---|---|
| لوحة التحكم | المدير العام، المحاسب، منسق الحجوزات، أمين المخزن، مدير العمليات، كل حسب صلاحياته. | واجهة ويب ملائمة للحاسوب، مع تكيّف المحتوى للشاشات الأصغر. |
| تطبيق العميل | العملاء وأصحاب القاعات، مع مسار وبيانات خاصة بكل نوع حساب داخل التطبيق نفسه. | تجربة هاتف تفاعلية تعرض شاشات التطبيق المستقبلي. |
| تطبيق الإدارة | الفنيون ومسؤولو الخدمات، كل ضمن المهام المسندة إليه. | تجربة هاتف للعمل الميداني وحالات الانقطاع والمزامنة. |
المخرج HTML/CSS/JavaScript قابل للتجربة في المتصفح ببيانات وهمية مشتركة. يتنقل المراجع بين الواجهات ويرى أثر الحجز نفسه عليها. التطبيقان الفعليان في الوثائق Flutter لنظامي Android وiOS، ولوحة التحكم PHP/Laravel وخادم مركزي؛ النموذج مرجع لتلك المرحلة اللاحقة.
تشمل المحاكاة التسجيل وOTP والمدفوعات والإشعارات والعقود والعهد والمزامنة، مع بيان أنها تجريبية. إرسال الرسائل، والتحصيل، وتوثيق الموافقات، والحماية بالخادم، والتزامن الحقيقي، وبناء التطبيقات ونشرها أعمال تنفيذ لاحقة.
يقتصر النطاق المعتمد على تطبيقين ولوحة واحدة ومحفظة خارجية واحدة. ميزات تأجير القاعات، وتعدد الشركات والعملات، والمحافظ الخارجية الإضافية، والخرائط المدفوعة، وERP الشامل ليست ضمن هذه الخطة.
مراجع: SCOPE-033، SCOPE-041–045؛ SRS-028، SRS-032–036، FR-085، FR-105؛ OFFER-011–014.
2. خريطة مجموعات الشاشات
هذه قائمة أولية شاملة بوحدات التصميم. تضم المجموعة صفحات أو تبويبات أو نماذج وحالات متعددة؛ يُثبت العدد التفصيلي في حصر الشاشات، وتُعاد الاستفادة من المكونات المشتركة بدل تكرارها.
أ. لوحة التحكم — 25 مجموعة
| الرمز | المجموعة | المحتوى والأفعال |
|---|---|---|
| A01 | الدخول والجلسة | الدخول والتحقق والخروج وانتهاء الجلسة وحالة عدم السماح. |
| A02 | الرئيسية | ملخص الحجوزات والمهام والمبالغ والمراجعات ضمن صلاحية الموظف؛ روابط تفتح السجلات الفعلية في النموذج. |
| A03 | الحجوزات والتقويم | قائمة وبحث ومرشحات وتقويم ميلادي/هجري وحالات الحجز والدفع والتنفيذ منفصلة. |
| A04 | إنشاء الحجز وتفاصيله | اختيار العميل أو إنشاء حسابه، المناسبة والقاعة، الكوشة والمكونات والألوان والخدمات والتوفر والتسعير والعربون وقفل الإدارة لعشر دقائق. |
| A05 | العقود والموافقات | نسخة العقد، رابط/OTP الموافقة، النسخ السابقة، وإعادة الموافقة عند التغيير الجوهري. |
| A06 | التعديلات والإلغاء | مراجعة الطلب وأثره قبل/بعد، نقل الموعد، التاريخ المفتوح، الإلغاء، البديل والاسترداد والتسوية. |
| A07 | العملاء والهوية | بيانات العميل وحجوزاته ومستنداته، تغيير التواصل واسترجاع الحساب ومراجعة تعارض الهوية أو الدمج حسب الصلاحية. |
| A08 | إدارة القاعات | بيانات القاعات ومقاساتها وموقعها وشركاؤها. تدار طلبات اعتماد الحسابات في A25. |
| A09 | الكتالوج | إنشاء كوشة من مكتبة المكونات أو نسخ تصميم موجود، والمكونات وطريقة تركيبها، والمسودة والنشر، وألوان الورد المرتبطة بالمخزون وألبومات التنفيذ. |
| A10 | إدارة الخدمات | إدخال الخدمات الإضافية وأسعارها ونوعها ومكونات تنفيذها وإتاحتها للحجز. |
| A11 | التشغيل والإسناد | تقويم المهام وإسنادها واستلامها، المتابعة قبل المناسبة بيومين أو فورًا للحجز الأقرب، الاستثناءان المالي والتشغيلي كل على حدة. |
| A12 | المخزون والحركات | الأصناف والوحدات والتوريد والجرد والتوفر والحجز والصرف والفحص والتلف وتتبع الصنف. |
| A13 | العهد والإرجاع والنقل | قوائم الصرف، مطابقة الإرجاع الكامل والجزئي، النقص والتلف والمسؤولية، النقل المباشر واعتماد فروقاته. |
| A14 | التحصيل والسندات | مراجعة الحوالات، النقد لدى الإدارة، سندات القبض، الدفعات والمتبقي، المحفظة الخارجية وحالات قيد التحقق. |
| A15 | المحفظة والاسترداد والمطابقة | المتاح للحجز والمؤهل نقدًا والمحجوز والمديونية، الدفع المتأخر والفائض، تقارير المزود والفروقات والقرارات والاسترداد اليدوي/المدعوم. |
| A16 | المحاسبة والاستحقاقات | شجرة الحسابات، الصندوق والبنوك، القيود والمصروفات والسندات، المعلق والمستحق والمصروف للأطراف، التصحيح بعكس أو تسوية. |
| A17 | التقارير العشرة | قوالب موحدة للتقارير مع مرشحات وإجماليات ومعاينة طباعة/تصدير لبيانات النموذج. |
| A18 | المستخدمون والصلاحيات والتدقيق | مصفوفة الدور والفعل ونطاق السجل، الاعتمادات، وسجل المنفذ والسبب والوقت والقيم قبل/بعد. |
| A19 | إعدادات التشغيل والتكامل | العربون الثابت، الدوام، فترات الموارد والتجهيز والنقل والفحص، المنطقة الزمنية والهجري، المحفظة الواحدة وقدراتها وإعداداتها التجريبية. |
| A20 | الرسائل والمتابعة والبيانات | واتساب وSMS والبريد والإشعارات، القوالب ونتيجة كل قناة وإعادة المحاولة، متابعة أخطاء الدفع والمزامنة والنسخ وفق النطاق، وطلب تصدير البيانات. |
| A21 | إدارة الفنيين | ملف مستقل لكل فني وبيانات التواصل والاستحقاق وحالة الإسناد. |
| A22 | إدارة مسؤولي الخدمات | ملف مستقل لكل مسؤول خدمات وبيانات التواصل والاستحقاق وحالة الإسناد. |
| A23 | إدارة العروض | اختيار كوشة وخدمة واحدة أو أكثر، وتحديد سعر للحزمة ومدة السريان والفئة المؤهلة، ثم التفعيل أو الإيقاف أو الأرشفة. |
| A24 | إدارة التخفيضات | تحديد نسبة أو مبلغ ثابت بالريال اليمني، والفئة المستهدفة، والبنود المشمولة، وأساس السريان وتواريخه، والأهلية والأولوية والجمع، مع سجل التغييرات وفق 3.8. |
| A25 | طلبات اعتماد حسابات القاعات | مراجعة حساب القاعة وبياناتها وتوثيق الموافقة أو طلب الاستكمال أو الرفض أو التعليق وفق 2.7. |
التقارير العشرة: كشف الحساب؛ القيود اليومية؛ المصروفات اليومية؛ طرق الدفع؛ الإيرادات والربح والخسارة؛ الحجوزات؛ القاعات وحساباتها؛ الفنيون ومسؤولو الخدمات وحساباتهم؛ الكوش ومرات حجزها؛ مبالغ الإلغاء المستردة وأهليتها.
مراجع: SRS FR-001–FR-019، FR-021–FR-059، FR-065–FR-106؛ جدول SRS-379؛ SCOPE-159.
ب. تطبيق العميل وأصحاب القاعات — 15 مجموعة
| الرمز | المجموعة | المحتوى والأفعال |
|---|---|---|
| C01 | الدخول والتحقق | الهاتف/البريد، عداد OTP، الإعادة وحدود المحاولات، البريد البديل وتعارض الهوية واسترجاع الحساب. |
| C02 | إكمال الحساب | عميل أو صاحب قاعة؛ تظهر للثاني حقول تواصل القاعة والموقع ورابط Google Maps وسعر الإيجار YER. |
| C03 | الرئيسية والبحث | التصنيفات والعروض والمرشحات بالتاريخ واللون والقاعة، والتقويمين للموعد نفسه. |
| C04 | تفاصيل الكوشة | الغلاف والمكونات والأبعاد والسعر، وتوفر لون الورد حسب الموعد، وصور التنفيذ المطابقة للقاعة واللون، والمفضلة والمشاركة. |
| C05 | المفضلة | الكوش المحفوظة والوصول إلى تفاصيلها ومسار حجزها. |
| C06 | اختيارات الحجز | التاريخ والقاعة ولون الورد المتاح والمكونات والخدمات وأسماء الطباعة وتنبيه المقاسات؛ يعاد فحص اللون عند إنشاء الطلب. |
| C07 | الملخص والعقد | الكوشة والخدمات وسعر العرض إن اختير، والسعر قبل التخفيض واسمه وقيمته والإجمالي بعده، والعربون ونسخة العقد وموافقة العميل. |
| C08 | الدفع ومتابعته | العربون بوسيلة واحدة، رصيد داخلي أو محفظة خارجية واحدة أو حوالة وفق الدوام، رفع الدليل والانتظار والرفض وقيد التحقق والدفعات اللاحقة. |
| C09 | حجوزاتي وتفاصيل الحجز | قائمة الحالات والخط الزمني والعقد والمدفوع والمتبقي والصور التي وصلت للخادم والمستندات. |
| C10 | التعديل ونقل الموعد | طلب التغيير وأثره، انتظار الاعتماد، فشل الموعد الجديد مع بقاء القديم، وإعادة الموافقة على العقد. |
| C11 | الإلغاء والتاريخ المفتوح | شرح أثر كل مسار، الموارد والرصيد وأهلية الاسترداد والبديل، دون رسوم تعديل أو إلغاء. |
| C12 | المحفظة والولاء | حركات الرصيد، المتاح للحجز والمؤهل نقدًا والمحجوز، إعادة استخدام الرصيد، النقاط كخصم لاحق وفق سياسة تجريبية معلّمة. |
| C13 | مساحة صاحب القاعة | إنشاء حجز لعميل والحجوزات المرتبطة بقاعته وعمولاته ونقاطه، مع الاقتصار على بيانات الخدمة اللازمة. |
| C14 | الصور والتقييم | صور التركيب بعد وصولها، وحقول التقييم ووقت إتاحته وفق ما سيُعتمد أثناء التصميم. |
| C15 | الملف والإشعارات | تحديث البيانات وبيانات القاعة، التحقق عند تغيير التواصل، الإشعارات والخروج. |
مراجع: SRS FR-001–FR-008، FR-017–FR-022، FR-026–FR-052، FR-069–FR-072، FR-097–FR-099، FR-105؛ SCOPE-042، SCOPE-066.
ج. تطبيق الإدارة للفنيين ومسؤولي الخدمات — 9 مجموعات
| الرمز | المجموعة | المحتوى والأفعال |
|---|---|---|
| O01 | الدخول والملف | حساب الموظف ودوره والجلسة وآخر اتصال وحالة البيانات المحفوظة. |
| O02 | المهام والتقويم | المهام المسندة فقط، الموعد والقاعة والخدمات والحالة. |
| O03 | تفاصيل المهمة واستلامها | الموقع وملاحظات العميل والمطلوب وآخر نسخة، واستلام المهمة؛ دون صلاحيات تحصيل أو تعديل سعر. |
| O04 | الأدوات والعهدة | المكونات والكميات المختارة للصرف والمستلمة، مع حدود صلاحية المخزن وشروط السداد والعهد اللازمة للبدء. |
| O05 | مراحل التنفيذ | تم استلام الطلب ← تنفيذ التركيب ← تم التركيب ← تم سحب الكوشة؛ حفظ العمليات المسموح بها محليًا عند الانقطاع. |
| O06 | الصور والملاحظات | حتى ثلاث صور ليلة المناسبة، حالة محلي/بانتظار الرفع/مرفوع، رفض الحجم أو النوع المخالف. |
| O07 | الإرجاع والنقل والتلف | مطابقة ما استلمه الفني، إرجاع جزئي، نقص وتلف وأدلة، وتسليم/استلام نقل مباشر واعتماده من المخول. |
| O08 | صندوق المزامنة | المعلّق والمقبول والمرفوض أو المحال للمراجعة وسبب التعارض، وحفظ الدليل مع منع إحياء مهمة ملغاة. |
| O09 | واجهة مسؤول الخدمات | مهامه وخدماته وملاحظات العميل واستلامها وتسجيل تنفيذها؛ مسار منفصل داخل التطبيق نفسه. |
مراجع: SRS FR-010، FR-053–FR-064، FR-076–FR-084، FR-099؛ SAD-061–062، SAD-189.
إنشاء الكوشة وعرضها في التطبيق
- إنشاء كوشة من المكونات. يسمي المدير الكوشة، ويختار أصنافها من مكتبة مصورة ومصنفة. يحدد النوع باختيار الصنف، وطريقة التركيب والكمية لكل استخدام. يرفع غلاف الكوشة، ويضيف الوصف والسعر، ثم يحفظها مسودة أو ينشرها.
- إنشاء كوشة مشابهة. يبدأ المدير من كوشة موجودة؛ تُنسخ التجميعة وكمياتها وطرق تركيبها وألوان الورد المعتمدة. يعدل ما يحتاج إليه ويضيف الاسم والسعر والصور للكوشة الجديدة من محرر الكوش نفسه. تبقى كل تجميعة مستقلة، وتشتركان في أصناف المخزون التي تختارانها.
طريقة تركيب القطعة نفسها تُحفظ ضمن استخدامها في الكوشة. القطع المختلفة فعليًا تُضاف إلى المكتبة كأصناف مستقلة. يمكن تكرار صنف واحد في التجميعة لأكثر من طريقة تركيب، وتُجمع كمياته عند فحص المخزون.
| مكوّن كوشة اللؤلؤ | طريقة الاستخدام | الكمية |
|---|---|---|
| ستارة مخمل بيج | منسدلة خلف الكرسي | ٦ أمتار |
| كرسي ذهبي مزدوج | في المنتصف | قطعة |
| تنسيق ورد أبيض | على الجانبين | قطعتان |
| إضاءة دافئة | خلف الستارة | ٤ وحدات |
إن كان لون الورد قابلًا للاختيار، يُربط كل لون مقبول بصنف مخزون وكميته. إذا توفر طقمان أحمران وكان كل تصميم يحتاج طقمًا، يمكن استخدام اللون لكوشَتين في الفترة نفسها. بعد تخصيص الطقمين يختفي الأحمر من خيارات الكوش التي تشترك فيه. يبدأ حساب فترة التخصيص من التجهيز ويستمر حتى الإرجاع والفحص، ويُفحص التوفر ويُخصص الرصيد عند إنشاء الحجز. يحفظ الحجز المكونات واللون المختارين وقت إنشائه.
تظهر الكوشة المنشورة مرة واحدة في الكتالوج. يضيف المدير ألبوم تنفيذ لها بتحديد القاعة ولون الورد في الصور ورفع الصور دفعة واحدة. يبدأ العميل بغلاف محايد، ثم يختار موعدًا وقاعة فيرى ألوان الورد المتاحة. بعد اختيار اللون يعرض التطبيق الصور المطابقة للقاعة واللون، ثم صورًا للون نفسه من قاعة أخرى باسمها عند الحاجة، ثم الغلاف المحايد وعينة اللون إن لم توجد صور تنفيذ مناسبة. إذا نفدت كل الألوان المعتمدة، تظهر الكوشة غير متاحة في ذلك الموعد.
مراجع: SCOPE-321–327، SCOPE-337–340، ومعايير قبول T60–T64.
العروض والتخفيضات عند الحجز
العرض حزمة اختيارية تتضمن كوشة وخدمات بسعر محدد، وتُحتسب الخدمات الداخلة في الحزمة ضمن سعرها، فيما تُضاف الخدمات المختارة خارجها بالسعر العادي. يُطبّق التخفيض المؤهل وفق سعر البنود المشمولة وفئة الطرف المرتبط بالحجز، ووفق أولوية القاعدة وإذن الجمع مع العرض. يختار العميل موعده ثم يرى العروض المؤهلة ويحصل على تفاصيل السعر قبل موافقة العقد.
يؤهل الحجز المرتبط بصاحب قاعة معتمد لتخفيضات الشركاء بحسب شروطها. يظل اختيار القاعة كمكان للمناسبة خاضعًا لتسعير العميل. تُحفظ تفاصيل العرض والتخفيض مع نسخة الحجز، وتُراجع الموافقة إذا تغير السعر قبل التأكيد.
مراجع: SCOPE-317–320، SCOPE-328–336.
3. خطوات التنفيذ بعد الموافقة
| الخطوة | العمل | مخرج يمكن مراجعته |
|---|---|---|
| 1. تثبيت المتطلبات | تحويل الحصر إلى سجل شاشات، ربط الوظائف FR-001–FR-106 وقيود UX الملائمة، وصياغة مقترح مصفوفة الصلاحيات وسجل القرارات غير المحسومة. | قائمة شاشات ورموز وروابط ومتطلبات وحالات وصلاحيات؛ تمييز متطلبات الخادم والتسليم التي لا تمثل شاشة. |
| 2. هيكل التنقل والرحلات | تحديد قوائم لوحة التحكم وتبويبات التطبيقين، نقاط الدخول والرجوع وعمليات الموافقة وحالات الانتظار والفشل. | خريطة تنقل ومخططات دورة الحجز والدفع والتنفيذ والإرجاع والإلغاء. |
| 3. تخطيط الشاشات | تخطيطات أولية للمجموعات والحالات المهمة، وإبراز الكمية والمال والعقد والمهلة والإجراء التالي قبل الزخرفة البصرية. | تخطيطات قابلة للاستعراض مع حقول وأفعال كل شاشة، تبدأ بالتفاصيل والحجز والمهمة. |
| 4. نظام التصميم | تعريف الألوان والخطوط والمسافات وأشكال الأزرار والحقول والجداول والبطاقات والتقويم والحالات والتنبيهات والنوافذ وتلميحات الأخطاء. | صفحة مكونات موحدة ومتغيرات CSS وقواعد RTL واستجابة الهاتف والحاسوب. |
| 5. تجهيز أساس النموذج | إنشاء بوابة عرض منفصلة للمراجع، مسارات التنقل وبيانات تجريبية مشتركة ومعرفات حجز وعهد وحركات، وأداة إعادة ضبط وتبديل السيناريو. | هيكل HTML يعمل محليًا وثلاث مساحات متصلة بهوية بيانات واحدة. |
| 6. تنفيذ الرحلة الأساسية | تصميم متكامل لعميل يحجز ويوافق ويدفع، ثم تراه الإدارة وتسند المهمة وينفذها الفني وتظهر الصور للعميل بعد الرفع التجريبي. | رحلة واحدة مكتملة أراجعها قبل توسيع بقية الشاشات لضبط الاتساق مبكرًا. |
| 7. التنفيذ المتوازي | يكمل وكلاء أقل تكلفة لوحة التحكم وتطبيق العميل وتطبيق الإدارة في ملفات مستقلة وباستخدام المكونات والحالات المتفق عليها. | جميع مجموعات الشاشات بما فيها صاحب القاعة ومسؤول الخدمات والتقارير والإعدادات. |
| 8. الربط والحالات الاستثنائية | دمج تغييرات الواجهات وتوحيد العقود والأرقام والرصيد والكميات والحالات، وإكمال سيناريوهات المهلة والدفع والإلغاء والانقطاع. | سيناريوهات قابلة للإعادة لا تترك أزرارًا صامتة أو روابط مفقودة. |
| 9. مراجعة الجودة والإصلاح | مراجعة بصرية ووظيفية ومراجعة تغطية المتطلبات والأدوار، تجربة المقاسات واللوحة بالمفاتيح، وفحص المتصفح والروابط والسيناريوهات. | لقطات وملاحظات ونتائج فحص فعلية وإصلاح الملاحظات التي تمنع مراجعة المسارات. |
| 10. التسليم والعرض | تجهيز ملفات النموذج وأصوله وتعليمات تشغيله ودليل المسارات والتغطية والقرارات المفتوحة، ثم عرض النموذج على المستخدم. | حزمة HTML قابلة للتجربة ومحضر مراجعة تصميم؛ اعتماد التصميم يأتي بعد تجربة المخرج. |
أتابع التنفيذ والمراجعة والإصلاح بعد اعتماد الخطة، وأعرض تقدمًا واضحًا ونسخًا قابلة للتجربة. لا تتطلب كل شاشة موافقة مستقلة؛ تُطلب القرارات التي تغير سياسة عمل أو نطاقًا، ويستمر العمل المستقل عنها.
4. معنى «HTML مترابط» والسيناريوهات المطلوبة
تستخدم الواجهات الحجز والعميل والقاعة والمهمة والصنف والحركة نفسها. إنشاء حجز تجريبي في تطبيق العميل يجعله قابلًا للمتابعة في لوحة التحكم؛ إسناده يظهره للفني المعني؛ رفع الصور تجريبيًا يجعلها مرئية للعميل. فتح تفاصيل الحجز أو الرجوع منه يحافظ على السياق. أدوات اختيار الدور وتسريع الزمن وتبديل الاتصال تخص المراجع وتبقى منفصلة عن قوائم المستخدمين.
- الحجز الآلي: اكتشاف الكوشة ← فحص التوفر ← اختيار الخدمات ← العقد والموافقة ← عربون من وسيلة واحدة ← تأكيد عند اكتمال الشروط ← متابعة الحجز.
- صاحب القاعة: استكمال بياناته ← حجز لعميل ← موافقة العميل على عقده ← الدفع والتأكيد ← حجوزات القاعة والعمولة دون كشف بقية حساب العميل.
- الحوالة والدوام: رفع إشعار أثناء الدوام ← بانتظار التحقق ← قبول أو رفض مع السبب. خارج الدوام يظهر أن هذا المسار غير متاح، دون إنشاء طلب أو قفل؛ يبقى مسار المحفظة الآلي متاحًا.
- حجز الإدارة: إنشاء طلب ← عداد عشر دقائق ← تأكيد صحيح أو انتهاء وتحرير الموارد؛ حفظ الطلب أو تحديث الصفحة لا يعيد المهلة.
- حالات الدفع: فشل أو نتيجة مجهولة بمرجع متابعة، دفعة متأخرة بعد انتهاء الطلب، مبلغ زائد للتسوية، وإعادة العملية دون أثر مزدوج في بيانات النموذج.
- تعديل الموعد أو الخدمة: مقارنة قبل/بعد ← مراجعة الإدارة ← توفر جديد أو بقاء القديم عند الفشل ← نسخة عقد وموافقة جديدة عند التغيير الجوهري.
- التاريخ المفتوح: تحرير الموارد وفك تخصيص المدفوع ← رصيد في المحفظة ← حجز جديد ودفع من الرصيد إذا غطى العربون كاملًا، مع حالة عدم الكفاية.
- الإلغاء بانتظار بديل: الرصيد متاح للحجز وغير مؤهل نقدًا ← حجز بديل مؤكد لنفس الكوشة في أي موعد وسداد عربونه ← أهلية المتبقي فقط للمراجعة والصرف دون إنشاء رصيد أو صرف تلقائي.
- التشغيل والعهد: إسناد ← استلام ← صرف من المخزن ← تحقق شروط البدء ← تركيب وصور ← سحب ← إرجاع كامل أو جزئي وفحص وفروقات.
- النقل والتلف: نقل سليم بين حجزين دون تسجيل عودة وهمية أو احتساب مزدوج، مع مسؤولية تلف مستقلة عن صلاحية القطعة للإتاحة.
- العمل دون اتصال: مهمة محفوظة ← تنفيذ وصور محلية ← عودة الاتصال ← قبول أو مراجعة تعارض مع حفظ الدليل؛ صور العميل تنتظر وصولها للخادم التجريبي.
- الخدمات والصلاحيات: مسؤول خدمات يرى مهامه فقط؛ الفني بلا تحصيل؛ المحاسب والمنسق وأمين المخزن يتلقون القوائم والأفعال المسموح بها وفق المصفوفة المقترحة.
التحقق هنا من سلوك النموذج وصحة العرض والانتقالات. اختبارات منع الإنفاق أو الحجز المتزامن والتحقق من الدفع وحماية السجلات تنفذ لاحقًا على خادم فعلي.
5. قواعد تحكم التصميم
- العربية وRTL أساس التصميم، وأسماء الحالات والأفعال موحدة عبر الواجهات. تعرض التواريخ الهجرية والميلادية للموعد نفسه، وفق إعداد تحويل محدد؛ تُعلّم التواريخ المعدّة مسبقًا في النموذج.
- الريال اليمني YER وحده للأسعار والرصيد والتقارير. العربون مبلغ ثابت من إعداد الإدارة، وليس نسبة؛ يسدد كاملًا بوسيلة واحدة. تظهر الدفعات والمتبقي وأهلية السحب بوضوح.
- الحجز والعقد والدفع والتنفيذ والعهدة والاسترداد والاستحقاق حالات مستقلة. نجاح الدفع لا يغني عن العقد والتوفر، وإنهاء التركيب لا يغلق عهدة أو مطالبة معلقة.
- لا رسوم تعديل أو إلغاء. فرق سعر الخدمة منفصل، وتحفظ نسخة الحجز والعقد والأسعار السابقة وتعرض أسباب التسويات.
- يعرض استحقاق الفني على أساس السعر الأساسي للكوشة، وعمولة القاعة على أساس صافي المدفوع بعد الخصم. تستخدم قيمة الحجز المخصصة إن وُجدت وإلا افتراضي بطاقة الطرف؛ الصفر الصريح يختلف عن الحقل الفارغ. تظهر الأرصدة المعلقة والمستحقة والمصروفة منفصلة، وتبقى نسب الأطراف ونقاط إنجازهم غير المحددة قرارات للاعتماد.
- OTP: صلاحية 60 ثانية، ثلاث محاولات لكل رمز وثلاث إرسالات هاتف إجمالًا، ثم مسار البريد؛ لا يكفي توثيق البريد لامتلاك حساب الهاتف. اختيار واتساب وSMS للرمز نفسه يعد إرسالًا واحدًا.
- الفني لا يحصل مالًا ولا يعدل أسعارًا. إسناد المهمة والمراجعة المالية قبل المناسبة بيومين، وللحجز الأقرب مسار فوري بنفس الشروط.
- حد الفني حتى ثلاث صور ليلة المناسبة دون حد أدنى مخترع؛ مرفقات التطبيقين صور/PDF حتى 1 ميجابايت لكل ملف. تميز الوسائط التسويقية للكتالوج عن مرفقات التطبيقين.
- المتاح والمحجوز والمصروف والمنقول وتحت الفحص والتالف حالات موارد واضحة؛ تغير اليوم وحده لا يتيح القطعة.
- لكل شاشة حالات تحميل وفراغ وخطأ ونجاح وعدم السماح عند انطباقها، وحقول معلّمة ورسائل توضح الإجراء الممكن بعد الخطأ. لا يعتمد توضيح الحالة على اللون وحده.
- تراجع الواجهة بالمفاتيح، وترتيب التركيز وتسميات الحقول والتباين وإمكانية قراءة الجداول على الهاتف. تفحص مبدئيًا عند عروض 360 و390 و768 و1440 بكسل، مع معالجة المحتوى الطويل.
مرجع الاسم والهوية الذي حدده المستخدم: الصورة الموجودة في مجلد المشروع تحمل اسم «روزا للكوش» و«Rosa». تُستخدم الصورة الأصلية مرجعًا للشعار، وتُبنى الواجهات على الذهبي والخلفية شديدة القتامة والرمادي والأبيض الظاهرة فيها، مع خط عربي مقروء ومكونات مشتركة. تُستخرج الدرجات العملية وتُراجع قابلية قراءتها عند إعداد نظام التصميم؛ الصورة لا تحدد وحدها وضعًا داكنًا إلزاميًا لكل شاشة. أُلغي الاقتراح الوردي السابق. صور الكوش والأسعار وبيانات العرض ما زالت تجريبية إلى حين توفير محتواها الحقيقي.
6. توزيع العمل على الوكلاء وضبط التكلفة
| المسؤول | المهمة بعد الموافقة | حدود التعديل |
|---|---|---|
| الوكيل الرئيسي | تثبيت المتطلبات والهوية البصرية والمكونات والبيانات المشتركة، مراجعة الرحلة الأساسية، الدمج والمراجعة النهائية. | الملفات المشتركة، إدارة القرارات، قبول عمل الوكلاء وإصلاح التعارضات. |
| وكيل أقل تكلفة 1 | لوحة التحكم، وتبويباتها الإدارية والمالية والمخزنية والتقارير. | مجلد لوحة التحكم فقط؛ يعمل بوحدات صغيرة قابلة للمراجعة. |
| وكيل أقل تكلفة 2 | تطبيق العميل وصاحب القاعة ورحلات الحجز والدفع والمتابعة. | مجلد تطبيق العميل؛ يستخدم واجهة البيانات والمكونات المشتركة. |
| وكيل أقل تكلفة 3 | تطبيق الفني ومسؤول الخدمات وحالات الانقطاع والعهد والمزامنة. | مجلد تطبيق الإدارة؛ يلتزم بحدود الصلاحيات والبيانات المشتركة. |
يكون الخيار الأول للتنفيذ الجزئي نموذجًا اقتصاديًا متاحًا مثل gpt-6-luna، مع بقاء القرارات والدمج والمراجعة لدى الوكيل الرئيسي. يعاد استخدام الوكلاء بعد اكتمال مهامهم لفحص تغطية واجهة أخرى؛ لا يزيد التنفيذ المتوازي على ثلاثة وكلاء إضافة إلى الرئيسي. تختصر التكلفة بإعادة استخدام المكونات، وتجزئة المهام، ومنع تكرار قراءة الملفات، ولا يُحدد مبلغ تشغيل أو وفر مضمون قبل معرفة الاستهلاك.
يوجد على الجهاز مشغّل باسم copilot.exe، لكن تشغيل copilot --help أعاد أن GitHub Copilot CLI غير مثبت. لا يثبت ذلك توافر وكيل داخل جلسة VS Code قابلة للتحكم هنا. استخدامه خيار مساعد إذا أمكن التحقق من جاهزيته لاحقًا؛ تظل خطة التنفيذ قابلة للإنجاز بالوكلاء المتاحين.
7. التسلسل الزمني ونقاط المراجعة
العرض المالي يخصص الأسابيع 1–4 للتحضير والتصميم ضمن خطة مشروع مقترحة مدتها 24 أسبوعًا. يُستخدم ذلك كإطار تنسيقي، ويثبت موعد البدء والتقدير التفصيلي بعد اعتماد حصر الشاشات وتوفر قرارات العميل. ليس زمنًا إلزاميًا لتشغيل الوكلاء أو تاريخ تسليم جديدًا.
| الفترة المقترحة للمشروع | نطاق العمل | المراجعة |
|---|---|---|
| الأسبوع الأول | خطوات 1–3: حصر الشاشات والصلاحيات والحالات، خريطة التنقل والتخطيطات. | تغطية الأدوار والمتطلبات وسجل القرارات. |
| الأسبوع الثاني | نظام التصميم وأساس النموذج والرحلة الأساسية المتكاملة؛ بدء العمل المتوازي. | اتساق الهوية والبيانات ووضوح الحجز والدفع والمهمة. |
| الأسبوع الثالث | اكتمال الوحدات والشاشات المساندة والتقارير والإعدادات والربط. | تغطية خريطة الشاشات وسيناريوهات الاستثناء. |
| الأسبوع الرابع | مراجعة الواجهات والأدوار والمقاسات وإصلاحها وتجهيز العرض والتسليم. | مراجعة المستخدم للنموذج واعتماد التصميم أو تسجيل ملاحظاته. |
مرجع زمني: OFFER-026–027، OFFER-037، OFFER-052. شروط السعر والسداد في الوثائق معلومات تعاقدية؛ لا تعامل كتعليمات للوكيل لطلب دفعة أو إيقاف إعداد التصميم.
8. القرارات والبيانات التي تُستكمل أثناء التصميم
| القرار أو البيانات | التعامل أثناء إعداد النموذج |
|---|---|
| الاسم والشعار والألوان — مرجعها متوفر | اعتماد صورة المستخدم مرجعًا: «روزا للكوش — Rosa»، والذهبي والداكن والرمادي والأبيض. تحدد درجات الاستخدام والتباين في نظام التصميم، مع الحفاظ على أصل الشعار. |
| صور الكوش وبياناتها الحقيقية | استخدام محتوى تجريبي معلّم إلى حين توفير الصور والأسماء والمكونات والأسعار الفعلية؛ صورة الشعار لا تتضمن هذا المحتوى. |
| تفويضات الأدوار والاعتماد والاستثناء والصرف والاسترداد والدمج | إعداد مصفوفة مقترحة متحفظة؛ لا تعامل كتفويض فعلي، ويُطلب اعتماد ما يؤثر على التشغيل قبل تثبيته. |
| قيمة العربون، الدوام، مهلة طلب العميل ومراجعة الحوالة والتصعيد | إظهارها كإعدادات مع بيانات تجربة موضحة؛ تبقى العشر دقائق خاصة بالقفل الإداري ولا تعمم تلقائيًا. |
| مزود المحفظة الواحدة وقدراته والقنوات وقوالبها | استخدام اسم «المحفظة المعتمدة — تجريبي» وحالات عامة؛ تؤجل الحقول الخاصة والتكامل إلى حين توافر الوثائق والحسابات. |
| قواعد العمولة والاستحقاق والولاء والعروض والتقييم | الحفاظ على الأسس المثبتة، ووسم المعدلات ونقاط الإنجاز وحقول التقييم المقترحة بأنها غير معتمدة. |
| فترات الموارد والسعات والفحص والتلف والتقريب والمنطقة الزمنية والهجري | أمثلة إعداد قابلة للتعديل، مع حالات نقص التوفر والقياسات؛ لا تفترض مستويات أداء أو تشغيل غير منصوص عليها. |
| نص العقد، التغيير الجوهري، استرجاع الحساب، إلغاء البديل لاحقًا | مسارات مراجعة واضحة مع حفظ الأصل والدليل؛ لا يخترع أثر مالي تلقائي أو يختزل التحقق. |
| مرشحات وحقول التقارير والتصدير وممثل اعتماد التصميم | بدءًا بالتقارير العشرة المثبتة؛ توثيق التفاصيل وصاحب صلاحية الاعتماد أثناء المراجعة. |
تستخدم الوثائق الخمس معًا: BRD للأهداف والرحلات، SRS للسلوك ومعايير القبول، SAD لقيود المعمارية، النطاق 1.9 لحدود الأعمال، والعرض V6 للإطار التجاري والزمني. عند تعارض مؤثر يُسجل نصا المرجعين وأثرهما ويعرض القرار المطلوب، دون اعتماد أسبقية تلقائية لمجرد اسم الملف أو تاريخه. غياب التفاصيل غير المؤثرة لا يوقف بقية التصميم.
9. معايير قبول النموذج وحزمة التسليم
- تمثيل مجموعات الشاشات الـ44 والأدوار المحددة، وربط كل مجموعة بمتطلباتها؛ يبيّن سجل التغطية الوظائف غير المرئية التي تنتظر تنفيذ الخادم.
- اكتمال رحلات الحجز والدفع والعقد والإسناد والتنفيذ والإرجاع، ومساري صاحب القاعة ومسؤول الخدمات، والسيناريوهات الاستثنائية المذكورة.
- كل زر أساسي ينقل إلى مسار أو ينفذ أثرًا تجريبيًا ظاهرًا أو يوضح سبب تعطيله؛ لا روابط مفقودة أو أرقام متناقضة بين تفاصيل الحجز وواجهاته.
- إظهار صلاحيات ونطاق بيانات كل دور في العرض، وفصل أدوات المراجع عن تجربة المستخدم؛ إثبات الحماية الفعلية مسؤولية الخادم لاحقًا.
- اجتياز فحص التنقل والنماذج وحالات الفراغ والخطأ والمهل والبيانات المشتركة، وفحص المتصفح والروابط والعروض المستهدفة دون أخطاء تعطل المسارات.
- توثيق ما جُرّب بالفعل ونتيجته، وإصلاح العيوب المؤثرة في التصميم قبل تسليمه للمراجعة؛ مراجعة التصميم لا تعادل قبول النظام النهائي.
- تمييز البيانات التجريبية والمحاكاة والقرارات المفتوحة، وعدم إدراج أسرار أو إرسال رسائل أو إجراء تحصيل حقيقي.
حزمة التسليم في مجلدات مستقلة بجذر المشروع، وفق التعديل الذي طلبه المستخدم عند اعتماد التنفيذ:
Desine/ index.html # بوابة استعراض الواجهات وسيناريوهات المراجع لوحة-التحكم/ # ملفات اللوحة وأصولها وتعليماتها المستقلة تطبيق-العميل/ # العميل وصاحب القاعة مع جميع الأصول المحلية تطبيق-الإدارة/ # الفني ومسؤول الخدمات مع جميع الأصول المحلية shared/ # مصدر المكونات ومحرك بيانات العرض؛ تنسخ نسخ مستقلة لكل واجهة design-system/ # مرجع الهوية والمكونات handoff/ # دليل التسليم والتغطية ونتائج الفحص واللقطات tests/ # فحوص محرك العرض والمتصفح planning/ # الخطة والمراجع
تعمل الملفات على خادم محلي خفيف بأصل واحد لضمان اتساق حالة العرض بين الصفحات؛ تُحفظ البيانات الوهمية محليًا وتتوفر إعادة الضبط. تتضمن الحزمة تعليمات تشغيل واضحة ولقطات مرجعية. يمكن حفظ بيانات النموذج في localStorage بنسخة معلومة، دون تقديم ذلك كتخزين آمن أو قاعدة بيانات إنتاجية.
10. الوثائق المرجعية التي تمت مراجعتها
الرموز الواردة أعلاه تشير إلى كتل نصية داخل نسخ القراءة المستخرجة في planning/sources/، ولا تعني أرقام صفحات Word. تبقى الوثائق الأصلية المرجع؛ تذكر أسماؤها أدناه، وتتوفر نسخ القراءة داخل المستودع. ملفات Word الأصلية محفوظة خارج مجلد المشروع المحلي وليست ضمن هذه الحزمة.
- صورة هوية روزا للكوش — Rosa — مرجع الاسم والشعار والألوان، أشار إليه المستخدم بعد مراجعة الخطة الأولى.
BRD_Koush_System_v1.3_AR.docx— أهداف العمل والأدوار والرحلات. نسخة القراءة.SRS_Koush_System_v1.3_AR.docx— 106 متطلبات وظيفية و18 متطلب جودة. نسخة القراءة.SAD_Koush_System_v1.3_AR.docx— المعمارية والحالات والمزامنة والصلاحيات. نسخة القراءة.v1.10_وثيقة_نطاق_العمل_اعتماد_القاعات_والتخفيضات.docx— حدود العمل والقواعد المعتمدة ومسارات إنشاء الكوشة وعرضها. نسخة القراءة.العرض_المالي_لتطبيق_روزا_للكوش_V6.docx— حدود العرض والتقارير والجدول المقترح. نسخة القراءة.