[SAD-001] منظومة كوش الأعراس والمناسبات [SAD-002] SAD [SAD-003] وثيقة تحليل النظام [SAD-004] توضح الوثيقة وظائف النظام وطريقة العمل المتفق عليها ومسؤوليات التشغيل والتسليم، ليستخدمها العميل والشركة أثناء التنفيذ والمراجعة. [SAD-005] الإصدار 1.3 | 13 نوفمبر 2026 [SAD-006] المشروع | إدارة حجوزات وعمليات كوش الأعراس والمناسبات لغة الواجهات | العربية ممثلو العميل | عبدالله وأخوه طه المكونات | تطبيق العميل، تطبيق الإدارة، لوحة تحكم ويب وخادم مركزي. [SAD-008] قبول النظام يثبت بعد مراجعة التنفيذ ونتائج الاختبارات، وليس بمجرد إعداد الوثيقة. [SAD-010] دليل الأقسام [SAD-011] 1. منهج التحليل والسياق [SAD-012] 2. تقسيم النظام والحدود الخارجية [SAD-013] 3. حالات الاستخدام التفصيلية [SAD-014] 4. حالات النظام وانتقالاتها [SAD-015] 5. نموذج البيانات المنطقي [SAD-016] 6. قواعد الاتساق والحساب والتزامن [SAD-017] 7. مصفوفة الوصول والواجهات [SAD-018] 8. الحالات الاستثنائية وضبط التنفيذ [SAD-020] 1. منهج التحليل والسياق [SAD-021] تشرح الوثيقة مسارات المستخدمين والبدائل وحالات النظام والبيانات اللازمة. الكيانات نموذج منطقي، ولا تفرض أسماء جداول أو تقسيمًا برمجيًا داخليًا. [SAD-022] المجال | الوصف القنوات | تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. المال والتشغيل | تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. التنفيذ | لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. مسؤوليات العمل | يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [SAD-024] معنى الحالات المستقلة [SAD-025] قد ينجح الدفع بينما لا يزال العقد ينتظر الموافقة، وقد تتحرر الموارد بينما تبقى التسوية المالية معلقة، أو ينتهي التركيب وتظل عهدة أو مطالبة مفتوحة. لذلك يعالج التحليل هذه الحالات بصورة منفصلة، حتى لا تخفي حالة واحدة وضع بقية العمليات. ويمكن أن تختلف أسماء الحالات في الواجهة، ما دامت شروطها وآثارها محفوظة. [SAD-026] ملخص خريطة الاستخدام [SAD-027] المجموعة | حالات الاستخدام العميل والحجز | UC-01 الهوية؛ UC-02 التصفح؛ UC-03 إنشاء الحجز؛ UC-04 الموافقة والتحصيل. ما بعد الحجز | UC-05 التعديل؛ UC-06 الإلغاء والاسترداد. التشغيل والمخزون | UC-07 الإسناد؛ UC-08 التركيب والمزامنة؛ UC-09 الإرجاع والنقل؛ UC-10 الصرف والجرد والتلف. المال والرقابة والتسليم | UC-11 الاستحقاقات والولاء؛ UC-12 الدفع والمطابقة؛ UC-13 التقارير والرقابة؛ UC-14 الاستعادة والتسليم. [SAD-030] 2. تقسيم النظام والحدود الخارجية [SAD-031] واجهة الاستخدام | المستخدمون تطبيق العميل — Flutter | العملاء وأصحاب القاعات؛ Android وiOS باللغة العربية. تطبيق الإدارة — Flutter | الفنيون ومسؤولو الخدمات؛ مهام محفوظة محليًا عند الانقطاع. لوحة التحكم — PHP / Laravel | الإدارة والمحاسبة والمخزن والإعدادات والتقارير. الخادم — Ubuntu على VPS | منطق الحجز والمال والمخزون والهوية وواجهات الربط. الخدمات الخارجية | محفظة واحدة، واتساب وSMS، البريد، وإشعارات التطبيقات. النشر | GitHub للمشروع وتحديثاته؛ App Store وGoogle Play بحسابات الشركة. [SAD-033] يربط الخادم المركزي التطبيقين ولوحة التحكم بخدمات الدفع والرسائل. يحتفظ تطبيق الإدارة بمهام الفني وصوره عند الانقطاع ثم يزامنها. [SAD-034] نطاق منطقي | المدخل والنتيجة | الحد الفاصل الهوية والوصول | هوية موثقة وجلسة وصلاحية سجل. | لا تتجاوز أي قناة تحقق الخادم. الكتالوج والتوفر والحجز | اختيارات وفترة إلى سعر وموارد وطلب وعقد. | فحص العرض لا يساوي تخصيصًا. التحصيل والمحاسبة | مبلغ موثق إلى قيد وتخصيص ومتـبق أو تسوية. | لا تساوي المحفظة الداخلية المزود الخارجي. التنفيذ والعهد | مهمة وصرف إلى تركيب وأدلة وإرجاع أو نقل. | الاستثناء المالي غير الاستثناء التشغيلي. التكامل والمزامنة | حدث أو طلب مؤجل إلى تحقق ونتيجة أو تعارض. | أحداث خارجية ليست مصدر الحقيقة دون توثيق. التقارير والتدقيق والتشغيل | حركات موثقة إلى عرض ومتابعة وأدلة وتسليم. | لا تتضمن تلقائيًا تقارير أو منصات إضافية. [SAD-036] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. [SAD-038] 3. حالات الاستخدام التفصيلية [SAD-039] لكل حالة استخدام أطراف وشروط بداية وخطوات وبدائل ونتيجة. لا يفرض ترتيبها تسلسلًا لوصول الدفع والموافقة؛ يجب استكمال الشروط وحفظ الموارد والمال دون تكرار. [SAD-040] UC-01 | تسجيل العميل أو صاحب القاعة وربط الهوية [SAD-041] العنصر | التحليل الأطراف | العميل أو صاحب القاعة من تطبيق العميل؛ خدمة OTP؛ موظف المراجعة المخول عند التعارض. البدء والشروط السابقة | طلب دخول أو ربط حساب، مع قناة تحقق مناسبة وحماية ملكية حساب الهاتف. المسار الأساسي | صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. عند إدخال الاسم يختار المستخدم عميلًا أو صاحب قاعة، ويدخل صاحب القاعة تواصلها وموقعها ورابطها وسعرها بالريال اليمني. البدائل والاستثناءات | إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. يرفض الرمز المنتهي والمستهلك والمستنفد للمحاولات؛ إرسال الرمز للقناتين لا يضاعف الحد. النتيجة وما يبقى محفوظًا | جلسة مصرح بها أو نتيجة رفض واضحة؛ لا تكرار حساب مالي ولا تعديل صامت لمستند سابق. [SAD-043] UC-02 | تصفح الخدمات واختيار الكوشة [SAD-044] العنصر | التحليل الأطراف | العميل وصاحب القاعة داخل تطبيق العميل؛ منسق الحجوزات من لوحة التحكم. البدء والشروط السابقة | فتح الكتالوج؛ وجود بيانات نماذج وقاعات وألوان وخدمات أقرها العميل. المسار الأساسي | 1. يعرض النظام التصنيف الافتراضي وصور الكوش ومقاطعها ومكوناتها.2. يحدد المستخدم التاريخ واللون والقاعة والعروض ويستخدم المرشحات المناسبة.3. يعرض النظام التوفر والسعة بحسب البيانات الحالية، وينبه إلى تجاوز المقاسات.4. يعاين العميل الألوان، ويضيف الكوشة إلى المفضلة أو يشارك رابطها.5. تنتقل الاختيارات إلى مسار إنشاء الحجز، مع بقاء التوفر النهائي خاضعًا للتحقق عند التخصيص. البدائل والاستثناءات | يُخفى اللون المستنفد ويعاد فحصه عند تخصيص الموارد. المقاسات تنبيه لا منع إلزامي، والمشاركة لا تكشف حجزًا خاصًا. النتيجة وما يبقى محفوظًا | اختيارات يمكن الحجز بها دون تخصيص عند التصفح. تتابع الصور بعد المزامنة، وتحدد تفاصيل واجهة التقييم عند تصميمها. [SAD-046] UC-03 | إنشاء حجز من ثلاث قنوات أعمال داخل تطبيق العميل واللوحة [SAD-047] العنصر | التحليل الأطراف | العميل وصاحب القاعة من تطبيق العميل نفسه؛ منسق الحجوزات من لوحة التحكم؛ الخادم المركزي. البدء والشروط السابقة | هوية وصلاحية وموعد ومكونات ووسيلة دفع، مع فحص الدوام قبل إنشاء مسار المراجعة. المسار الأساسي | 1. يفحص الخادم طريقة الدفع والدوام قبل الطلب.2. تدخل بيانات المناسبة والخدمات.3. ينشأ قفل الإدارة لعشر دقائق حتى تأكيد العربون.4. يحسب السعر والعربون الثابت ويفحص جميع الموارد.5. يحفظ الطلب والموافقة والتحصيل، ويتحول لتخصيص مؤكد عند استيفاء الشروط. البدائل والاستثناءات | خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. النتيجة وما يبقى محفوظًا | طلب مؤقت له مرجع وموارد ومهلة وأسباب تعليق؛ لا يصبح مؤكدًا حتى استيفاء UC-04. [SAD-049] UC-04 | اعتماد العقد وتحصيل العربون وتأكيد الحجز [SAD-050] العنصر | التحليل الأطراف | العميل؛ الإدارة المخولة بمراجعة واعتماد الحوالات أو النقد؛ مزود الدفع حيث ينطبق. البدء والشروط السابقة | طلب مؤقت قائم، نسخة عقد، عربون محسوب، ووسيلة تحصيل متاحة. المسار الأساسي | يعرض التطبيق الكوشة المختارة ولونها ولون الكرسي والورد، واسم القاعة واسم الشخص، والإجمالي والمدفوع والمتبقي والخدمات الإضافية المختارة. تحفظ هذه البيانات مع نسخة العقد والموافقة، ولا تتغير النسخة السابقة بصمت عند تعديل الحساب أو الحجز. يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. يخصم الرصيد الداخلي المتاح عند اختياره، ويصدر سند لتحصيل الإدارة النقدي. البدائل والاستثناءات | لا يقدم مسار حوالة خارج الدوام. يُتابع الدفع المجهول بمرجعه، والدفع المتأخر بعد انتهاء الطلب يسوى دون إحياء حجز فقد موارده. النتيجة وما يبقى محفوظًا | تكون النتيجة حجزًا مؤكدًا، أو طلبًا ينتظر إجراءً معلومًا، أو طلبًا منتهيًا مع مبلغ محفوظ للتسوية. ولا تُنشئ صورة الحوالة أو رسالة التطبيق تحصيلًا بمفردها. [SAD-052] UC-05 | تعديل الحجز أو تحويله إلى تاريخ مفتوح [SAD-053] العنصر | التحليل الأطراف | العميل أو الشريك مقدم الطلب؛ الإدارة المعتمدة؛ المسؤول المالي. البدء والشروط السابقة | حجز قائم وطلب تعديل من المخول وموافقة الإدارة، دون رسوم. المسار الأساسي | 1. يسجل المستخدم طلب التعديل، مع بقاء الحجز الحالي دون تغيير.2. يحسب النظام أثر الطلب على الموارد والسعر والعقد والاستحقاقات.3. تعتمد الإدارة التعديل. وإذا شمل نقل الموعد، يخصص النظام الموارد الجديدة ويحرر القديمة في عملية واحدة.4. يعيد حساب المستحق أو فائض التحصيل، ويسوي الأثر مرة واحدة.5. عند تغير جوهري، يصدر نسخة عقد جديدة ويطلب الموافقة عليها، مع حفظ أصل التغيير وتسوياته. البدائل والاستثناءات | عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. عند فشل نقل الموعد يبقى القديم، ولا يحذف صرف سابق بل يسوى. النتيجة وما يبقى محفوظًا | تنتج نسخة معدلة من الحجز مع الموافقات والتسويات المرتبطة بها، أو يبقى الحجز القديم إذا فشل التعديل. ولا يترتب على ذلك تخصيص المال أو الموارد مرتين. [SAD-055] UC-06 | إلغاء الحجز وتسوية الاسترداد [SAD-056] العنصر | التحليل الأطراف | العميل أو الشريك؛ الإدارة المخولة؛ المحاسب؛ المزود حسب المسار. البدء والشروط السابقة | طلب إلغاء مخول ومبلغ محصل معلوم، دون رسوم إلغاء. المسار الأساسي | في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. البدائل والاستثناءات | لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. الرد مجهول النتيجة يبقى محجوزًا حتى التحقق. النتيجة وما يبقى محفوظًا | الموارد محررة والرصيد متاح للحجز، وأهلية السحب النقدي مستقلة: انتظار البديل أو مؤهل أو مسوى جزئيًا أو كليًا. [SAD-058] UC-07 | جدولة وإسناد مهام الفني والخدمات [SAD-059] العنصر | التحليل الأطراف | مدير العمليات أو المنسق من لوحة التحكم؛ الفني ومسؤول الخدمات من تطبيق الإدارة. البدء والشروط السابقة | حجز قابل للإسناد وفق حالته، وبيانات تنفيذ ومكونات وخدمات معتمدة. المسار الأساسي | 1. يستعرض المستخدم المخول التقويم وحالة السداد والموارد من لوحة التحكم.2. يسند مهمة الفني قبل المناسبة بيومين، أو فور اعتماد الحجز الأقرب من ذلك.3. تظهر مهمة الفني وخدمات مسؤول الخدمات في واجهتين تناسبان دوريْهما داخل تطبيق الإدارة.4. يرسل النظام التنبيهات ويسجل نتائج إرسالها.5. يُثبت استلام المهمة، وتتاح لكل طرف البيانات الضرورية لعمله، دون إتاحة التحصيل للفني. البدائل والاستثناءات | يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. فشل الإشعار لا يلغي المهمة. عند تغييرها تراجع عمليات النسخة القديمة بعد المزامنة. النتيجة وما يبقى محفوظًا | ترتبط المهمة بحجز وفني وإصدار وحالة استلام، وترتبط الخدمات بمسؤولها. ولا يُعد الإسناد وحده إذنًا ببدء التركيب. [SAD-061] UC-08 | بدء التركيب وجمع الأدلة والمزامنة [SAD-062] العنصر | التحليل الأطراف | الفني من تطبيق الإدارة؛ مدير العمليات؛ المعتمد المالي؛ الخادم. البدء والشروط السابقة | مهمة محملة على جهاز الفني، مع آخر حالة محفوظة للسداد والعهد أو الاستثناءات. لا يشترط اتصال عند البدء. المسار الأساسي | لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. يرفع حتى ثلاث صور ليلة المناسبة، بحد 1 ميجابايت لكل ملف. البدائل والاستثناءات | لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. النتيجة وما يبقى محفوظًا | تُحفظ بيانات التنفيذ وأدلته بوصفها مقبولة أو معلقة للمراجعة، مع بقاء أثر كل عملية. ولا تتكرر العهدة، ولا يسقط الدين بسبب الاستثناء. [SAD-064] UC-09 | الإرجاع أو النقل المباشر بين حجزين [SAD-065] العنصر | التحليل الأطراف | الفني؛ أمين المخزن؛ مدير العمليات أو معتمد المطابقة. البدء والشروط السابقة | عهدة مصروفة وبيانات الأصناف والكميات؛ حجز تالٍ عند النقل المباشر. المسار الأساسي | يسجل الفني سحب الكوشة ثم إرجاع الأدوات وكمياتها وحالتها. تطابق العهدة، ويبقى الناقص أو التالف ظاهرًا حتى مع تأكيد إرجاع الجميع. في النقل المباشر تُغلق عهدة المنقول في السابق وتفتح في التالي دون دخول وهمي للمخزن، وتصرف المستهلكات الجديدة وتعالج الفروق. البدائل والاستثناءات | يرفض النظام كمية إرجاع تتجاوز العهدة، ولا يسمح بنقل قطعة تالفة بوصفها سليمة أو بإتاحة قطعة لم يكتمل فحصها. وتبقى الفروقات المفتوحة ظاهرة بدل إغلاق العهدة كاملة. كما لا يسجل النقل المباشر عودة إلى المخزن لم تحدث، ولا يُعد انتهاء المناسبة إثباتًا للإرجاع. النتيجة وما يبقى محفوظًا | يمكن تتبع الحركات والعهد دون مضاعفة الكميات. وتبقى المطالبات المالية قائمة بصورة مستقلة عن إغلاق التنفيذ. [SAD-067] UC-10 | الصرف والجرد وتسجيل التوالف [SAD-068] العنصر | التحليل الأطراف | أمين المخزن؛ الفني في نطاق الاستلام؛ مدير العمليات؛ المعتمد المالي. البدء والشروط السابقة | أصناف وقوالب معتمدة، حجز ومهمة، صلاحيات صرف وجرد وتلف محددة. المسار الأساسي | 1. يستدعي النظام مكونات القالب ويفحص الكميات المتاحة فعليًا.2. يسجل تعديل قائمة الصرف وسببه، ويحيل أي تغيير في الخدمة أو السعر إلى مسار تعديل الحجز.3. يُعتمد الصرف ويُربط بالعهدة والحجز.4. عند الجرد، يُسجل الفرق بحركة معتمدة.5. يُوثق التلف وقيمته وأدلته ومسؤوليته، وتُسجل مطالبة أو خصم أو مصروف بحسب الجهة التي تتحمله. البدائل والاستثناءات | لا يُعتمد الصرف النهائي إذا كان الرصيد غير كافٍ. ولا يُغير سعر الخدمة من خلال المخزن خارج مسار تعديل الحجز. وعند توزيع مسؤولية التلف، لا يتجاوز مجموع الأنصبة قيمته. وإذا زاد الخصم على المستحق، تبقى مطالبة بالفرق وفق السياسة. ولا يضيف هذا المسار إدارة إصلاحات متقدمة أو تتبعًا بالأرقام التسلسلية. النتيجة وما يبقى محفوظًا | تُسجل حركة مخزنية ومالية موثقة مرتبطة بأصلها، دون تعديل الإجمالي مباشرة أو حذف سجل الصرف أو الجرد. [SAD-070] UC-11 | احتساب الاستحقاقات والعمولات والولاء [SAD-071] العنصر | التحليل الأطراف | المحاسب؛ معتمد الإنجاز؛ الفني والخدمات والشريك لعرض مستحقاتهم وفق الصلاحية. البدء والشروط السابقة | تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. المسار الأساسي | 1. يقرأ النظام تخصيص الحجز إن أدخل وإلا القيمة الافتراضية للطرف.2. يحسب الفني من السعر الأساسي والقاعة من صافي المدفوع بعد الخصم.3. يسجل الاستحقاق معلقًا عند اكتمال السداد ثم متاحًا عند نقطة الإنجاز المحددة للطرف.4. يقيد الصرف والتسويات دون حذف الأصل.5. يمنح الولاء ويستبدله بخصم لا نقد بحسب السياسة التجارية. البدائل والاستثناءات | إذا سبق الصرف اكتشاف تلف أو رد مبلغ، تُسجل تسوية مرتبطة به ولا يُمحى الصرف السابق. وإذا لم تُحدد نقطة الإنجاز، فلا يُختار أول حدث تلقائيًا. ولا يمنح تكرار حدث الاكتمال نقاطًا إضافية، كما لا يُعامل الرصيد المعلق بوصفه قابلًا للصرف. النتيجة وما يبقى محفوظًا | أرصدة معلقة ومستحقة ومصروفة ونقاط موثقة يمكن تفسيرها بالحجز والقيود والسياسة. [SAD-073] UC-12 | استقبال نتائج الدفع والمطابقة [SAD-074] العنصر | التحليل الأطراف | مزود الدفع؛ الخادم؛ المحاسب؛ مدير إعدادات مخول. البدء والشروط السابقة | يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يحدد اسم المحفظة وحساب التاجر ووثائقها قبل الربط. المسار الأساسي | 1. يستقبل الخادم إشعار المزود أو يستعلم رسميًا عن نتيجة العملية.2. يتحقق من المصدر والعملية الأصلية والمبلغ والعملة وحساب التاجر والبيئة.3. يسجل النجاح أو الحالة الموثقة دون تكرار الأثر أو الرجوع خطأً إلى حالة أقدم.4. يستورد تقرير المطابقة، ويكشف العمليات الناجحة غير المسجلة والمكررة والفروقات.5. يسجل قرار معالجة الفرق ومعتمده، ويحدث التقارير حسب المزود والفترة. البدائل والاستثناءات | يُرفض الإشعار غير الصحيح أو يحال للمراجعة دون تسجيل نجاح. وعند الانقطاع بعد إرسال الطلب، تبقى العملية قيد التحقق بمرجعها الأصلي. ولا يكرر استيراد التقرير الأثر المالي، كما أن إيقاف المزود يمنع الطلبات الجديدة دون محو السابقة. ويُعالج العكس الموثق كتسوية جديدة، لا كإشعار انتظار قديم. النتيجة وما يبقى محفوظًا | تظهر حالة مالية موثقة بقيد واحد، أو فرق محفوظ للمراجعة. ويظل تأكيد الحجز مرتبطًا بشروطه، لا بحالة مزود الدفع وحدها. [SAD-076] UC-13 | الرقابة والتقارير والإشعارات [SAD-077] العنصر | التحليل الأطراف | المدير والمحاسب وبقية الأدوار ضمن صلاحياتهم؛ خدمة الإشعارات. البدء والشروط السابقة | قائمة تقارير وقنوات وصلاحيات واحتفاظ معتمدة؛ بيانات تشغيل ذات مراجع. المسار الأساسي | يختار المستخدم التقرير المالي أو تقرير الحجوزات والقاعات والفنيين والخدمات والكوش والإلغاء ويطبق مرشحاته. يعرض النظام التفاصيل والإجماليات بعد فحص الصلاحية. تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. البدائل والاستثناءات | تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. فشل الإشعار لا يعكس تحصيلًا صحيحًا. النتيجة وما يبقى محفوظًا | تتوفر تقارير يمكن مطابقتها مع بياناتها، مع حفظ الصلاحيات وسجل القرارات. ولا يكشف التصدير أو روابط الملفات بيانات خارج النطاق المسموح. [SAD-079] UC-14 | الاستعادة والتصدير والتسليم [SAD-080] العنصر | التحليل الأطراف | الشركة المبرمجة والمستضيفة، والعميل ويمثله عبدالله وأخوه طه، وموظفه المكلف بالإدخال. البدء والشروط السابقة | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. المسار الأساسي | يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. تُختبر استعادة النسخ وتطابق الأرصدة والملفات، ويُراجع التطبيقان على Android وiOS ولوحة Laravel والمحفظة الواحدة والرسائل، ثم يعتمد العميل القبول. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. البدائل والاستثناءات | لا قبول نهائي مع عيب حرج أو استعادة غير مكتملة. تحدد خدمة المستضيف نطاق النسخ والتوفر، ولا يمنع عدم شراء الشفرة الحصول على بيانات العميل. النتيجة وما يبقى محفوظًا | ينتهي المسار بأدلة استعادة وبيانات قابلة للاستخدام وحزمة تسليم ومحضر قبول محدد. وإذا لم تتحقق الشروط، تُوثق العيوب والقرارات التي تمنع القبول بدل إعلان نجاح غير مثبت. [SAD-082] 4. حالات النظام وانتقالاتها [SAD-083] تفصل الجداول الحجز والدفع والعقد والعهد والاسترداد، مع شروط انتقال كل حالة. لا تمنح تسمية الحالة صلاحية تغييرها دون تحقق. [SAD-084] 4.1 أبعاد الحالة المقترحة [SAD-085] البعد | أمثلة منطقية | ما لا يثبته وحده الحجز والموارد | مسودة؛ مؤقت؛ مؤكد؛ موعد مفتوح؛ ملغى؛ انتظار بديل. | لا يثبت التحصيل أو اكتمال الإرجاع. العقد | نسخة تنتظر الموافقة؛ نسخة وافق عليها العميل؛ نسخة سابقة محفوظة. | وصول الرسالة ليس موافقة. التحصيل | إنشاء؛ انتظار؛ تحقق؛ نجاح؛ فشل؛ استرداد؛ عكس. | النجاح لا يحيي حجزًا منتهيًا. التنفيذ والعهد | تم استلام الطلب؛ تنفيذ التركيب؛ تم التركيب؛ تم سحب الكوشة؛ إرجاع أو نقل وفروقات. | اكتمال التركيب ليس إرجاعًا أو إغلاق مال. الاسترداد | متاح للحجز وغير قابل للسحب؛ مؤهل نقديًا بعد البديل؛ رد جارٍ؛ مستخدم أو مسوى جزئيًا أو كليًا. | المحاولة ليست ردًا ناجحًا. استحقاق الطرف | معلق؛ قابل للصرف؛ مصروف؛ تسوية مرتبطة. | السداد الكامل لا يعني إتاحة الصرف فورًا للجميع. [SAD-087] 4.2 انتقالات الحجز والعقد [SAD-088] الانتقال التحليلي | شرط التنفيذ | الأثر المحمي مسودة إلى طلب مؤقت | اكتمال البيانات وتخصيص جميع الموارد. | بدء مهلة الطلب؛ لا تأكيد ولا تحصيل مفترض. طلب مؤقت إلى مراجعة حوالة | رفع إشعار مستوفٍ خلال المهلة. | وقف مهلة الرفع وبدء مهلة تدقيق؛ لا قيد قبض للصورة. مراجعة إلى رفض أو استكمال | قرار محاسب بسبب موثق. | تطبق مهلة المراجعة والاستكمال المضبوطة دون تجاوز قفل الإدارة دون سداد. مؤقت / مراجعة إلى مؤكد | موافقة العميل المطلوبة وعربون موثق وتوفر؛ المحافظ تؤكد آليًا للعميل وصاحب القاعة. | تأكيد مرة واحدة؛ لا يكفي نجاح دفع وحده. مؤكد إلى تعديل معتمد | موافقة إدارة وتوفر ومال وعقد مستوفٍ. | تخصيص جديد وتحرير قديم ذريًا؛ عند الفشل يبقى القديم. حجز إلى موعد مفتوح | اعتماد سياسة التاريخ المفتوح. | تحرير الموارد وتحويل المحصل المستحق مرة واحدة. طلب قائم إلى طلب تغيير معلق | تقديم طلب من مخول دون قرار نهائي. | يبقى الأثر السابق حتى اعتماد المسار؛ لا تحرير تلقائي. طلب إلى انتهاء / إلغاء مباشر | شرط انتهاء صحيح أو إلغاء معتمد. | تحرير الموارد مع حفظ الحجز والمال والمطالبات. حجز إلى إلغاء بانتظار بديل | اعتماد المسار وقيمته وشروطه. | الموارد متاحة؛ الرصيد متاح للحجز، والسحب النقدي بعد حجز نفس الكوشة لمستأجر آخر في أي موعد. نسخة عقد معتمدة إلى نسخة جديدة | تعديل جوهري في المحتوى الذي وافق عليه العميل. | حفظ السابقة وطلب موافقة جديدة وإبطال اعتماد الجديدة بالرابط القديم. طلب مراجعة خارج الدوام | اختيار حوالة أو مسار إداري. | لا طلب ولا قفل ولا تخصيص؛ تظهر رسالة الدوام. قفل الإدارة إلى انتهاء | مرور 10 دقائق دون تأكيد العربون. | تحرير الموارد رغم حفظ الطلب. [SAD-090] المحفظة تؤكد دفعها آليًا، والحوالة تنتظر مراجعة الإدارة. لا يلغي اختلاف المسار موافقة العميل المطلوبة أو فحص توفر الموارد. [SAD-091] 4.3 انتقالات الدفع والتحقق [SAD-092] الحالة / الحدث | شرط اعتمادها | أثرها Created | طلب صحيح بمبلغ وعملة ووسيلة. | حفظ المرجع؛ لا تحصيل. Pending / Processing | انتظار أو معالجة أو نتيجة غير معلومة. | متابعة المرجع؛ لا افتراض فشل أو نجاح ولا طلب جديد مكرر. Successful | تحقق موثوق من المصدر والمبلغ والعملة والتاجر والبيئة. | قيد وتخصيص مرة واحدة؛ إعادة فحص شروط تأكيد الحجز. Failed / Cancelled / Expired | نتيجة موثوقة للعملية نفسها. | لا تحصيل لهذه النتيجة؛ يبقى أي تعارض متأخر للمطابقة. Refunded / Partially Refunded | إثبات رد كامل أو جزئي مرتبط بالأصل. | تحديث المسوى والمتبقي والسقف المشترك مرة واحدة. Reversed | عكس موثق من المزود. | أثر عكسي مرتبط لا حذف للأصل؛ تسوية الأطراف وفق السياسة. إشعار مكرر أو أقدم | حدث معروف بلا تسوية جديدة موثقة. | لا قيد جديد ولا رجوع خاطئ للحالة. نجاح بعد انتهاء الحجز | أصل صحيح لكن الموارد ليست صالحة للتأكيد. | إثبات المال وتسوية مستقلة دون إعادة حجز مورد غير متاح. [SAD-094] 4.4 انتقالات الاسترداد والعهد والتنفيذ [SAD-095] الانتقال | الشرط والنتيجة استحقاق إلى طلب رد جارٍ | أهلية نقدية ومبلغ متبقٍ غير مستخدم وغير محجوز؛ يحجز الرد من الأصل نفسه. رد جارٍ إلى نجاح | إثبات مزود أو صرف أو محفظة؛ يقيد المسوى مرة واحدة. رد جارٍ إلى فشل مثبت | يتحرر المحجوز بعد التحقق؛ المجهول لا يعامل كفشل. مهمة مسندة إلى قيد التركيب | مهمة محفوظة وسداد أو استثناء وعهد أو بديل صحيح بحسب آخر مزامنة، دون اشتراط اتصال لحظة البدء. تركيب إلى مكتمل | إثبات إنجاز معتمد؛ لا إغلاق تلقائي لعهدة أو مديونية. مصروف إلى إرجاع تحت الفحص | كمية لا تتجاوز العهدة؛ يبقى المتبقي؛ السليم يتاح بعد الفحص المعتمد. عهدة أصل إلى عهدة تالية | نقل مباشر مطابق؛ لا إدخال وهمي للمخزن ولا بقاء الكمية بالعهدتين. معلق إلى مستحق إلى مصروف | سداد كامل ثم نقطة إنجاز الطرف ثم اعتماد الصرف؛ التسويات تحفظ أثر الأصل. تحقق البديل | نفس الكوشة لمستأجر آخر بعربون مؤكد في أي موعد؛ إشعار وأهلية نقدية دون رصيد جديد. إنفاق رصيد الإلغاء | يخصم المستخدم في حجز آخر من المتبقي الممكن صرفه لاحقًا. [SAD-098] 5. نموذج البيانات المنطقي [SAD-099] يصف النموذج البيانات والعلاقات اللازمة؛ تبقى أسماء الجداول والتقسيم الداخلي من تفاصيل التنفيذ. [SAD-101] علاقات منطقية بين الحجز والموارد والمال والعهد؛ التعدد المقترح لا يسمح بتجزئة العربون بين وسائل الدفع. [SAD-102] العميل والمستخدم | Customer / User [SAD-103] البيانات اللازمة: معرف ثابت واسم وهاتف وبريد وحالة تحقق كل منهما ونوع الحساب والصلاحيات وعدد الإرسالات ومحاولات كل رمز ووقت انتهائه. [SAD-104] القيد أو العلاقة: يرتبط العميل بحجوزاته ومحفظته؛ الصلاحيات ليست مجرد اسم الدور. [SAD-105] القاعة والشريك | Venue / Partner [SAD-106] البيانات اللازمة: معرف؛ حساب صاحب القاعة؛ رقم تواصل القاعة؛ موقعها؛ رابط Google Maps؛ سعر الإيجار بالريال اليمني؛ الأبعاد ووحدتها وربط الحجوزات. [SAD-107] القيد أو العلاقة: يختار صاحب القاعة نوع حسابه عند إدخال الاسم، وتُحفظ بيانات القاعة ضمن نطاقه. ولا يمنحه الاختيار صلاحيات إدارية عامة أو وصولًا إلى قاعات أخرى. كما أن حفظ السعر ورابط الموقع لا يضيف خدمة لحجز إيجار القاعة أو تكامل خرائط مدفوعًا. [SAD-108] الكوشة والقالب | Koshaa / Template [SAD-109] البيانات اللازمة: معرف؛ نموذج وتصنيف؛ وسائط؛ سعر أساسي؛ مكونات وكميات؛ أبعاد. [SAD-110] القيد أو العلاقة: الحجز يحتفظ بنسخة لا بإشارة متغيرة للقالب وحدها. [SAD-111] الصنف والمكون | StockItem / Component [SAD-112] البيانات اللازمة: معرف؛ وصف؛ وحدة؛ نوع مسترد أو استهلاكي؛ كميات الحركات. [SAD-113] القيد أو العلاقة: الصنف قد يخدم قوالب متعددة؛ لا يفترض تتبع تسلسلي لكل قطعة. [SAD-114] سعة اللون | ColorCapacity [SAD-115] البيانات اللازمة: اللون والسعة اليومية والتخصيص، وإعدادات فترات الموارد والمنطقة الزمنية والتحويل الهجري. [SAD-116] القيد أو العلاقة: قاعدة يومية مستقلة مع فحص نهائي للتزامن. [SAD-117] الحجز | Booking [SAD-118] البيانات اللازمة: معرف؛ عميل؛ قناة أعمال (عميل / صاحب قاعة / لوحة التحكم)؛ شريك إن وجد؛ مناسبة وموقع وأوقات؛ حالات مستقلة؛ نسخة السعر وقاعدة العربون المطبقة؛ العملة YER. [SAD-119] القيد أو العلاقة: مرجع أصلي للتعاقد والتنفيذ والمال؛ لا يحذف عند الإلغاء. [SAD-120] بنود الحجز والخدمات | BookingItem / Service [SAD-121] البيانات اللازمة: مكون أو خدمة؛ كمية ووحدة؛ سعر وخصم؛ نوع مسترد؛ بيانات الطباعة. [SAD-122] القيد أو العلاقة: يحفظ أثر القالب وقت الاعتماد؛ لا يغير المخزن السعر خفية. [SAD-123] التخصيص والقفل | Allocation / SoftLock [SAD-124] البيانات اللازمة: مرجع عملية؛ مورد وكمية؛ فترة؛ حجز أو طلب؛ بداية ونهاية وصلاحية. [SAD-125] القيد: قفل الإدارة عشر دقائق حتى تأكيد العربون؛ لا تمديد بالحفظ ولا تخصيص لمسار مراجعة خارج الدوام. [SAD-126] نسخة العقد والموافقة | ContractVersion / Approval [SAD-127] البيانات اللازمة: نسخة العقد والموافقة؛ الكوشة وألوانها ولون الكرسي والورد والقاعة والشخص والخدمات والإجمالي والمدفوع والمتبقي. [SAD-128] القيد أو العلاقة: الموافقة تخص نسخة بعينها؛ لا ينتقل اعتماد قديم لمحتوى جديد. [SAD-129] الدفع وتخصيص التحصيل | Payment / Allocation [SAD-130] البيانات اللازمة: مبلغ بعملة YER فقط؛ وسيلة؛ حالة؛ مراجع داخلية وخارجية؛ تاجر وبيئة؛ حجز وتخصيص تحصيل. لا يقبل تحويل عملات ضمني. [SAD-131] القيد أو العلاقة: نجاح موثق مرة واحدة؛ مبلغ مخصص للحجز ليس رصيد محفظة حرًا أيضًا. [SAD-132] دليل الحوالة ومراجعتها | TransferEvidence / Review [SAD-133] البيانات اللازمة: صورة أو PDF حتى 1 ميجابايت ووقت الرفع وحالة مراجعة الإدارة وسببها ومعتمدها والمهلة وأصل التحصيل. [SAD-134] القيد أو العلاقة: الدليل ليس تحصيلًا؛ ربطه بالمبلغ يمنع ازدواج المطابقة. [SAD-135] حركة المحفظة | WalletEntry [SAD-136] البيانات اللازمة: أصل الرصيد والحجز السابق، المبلغ بعملة YER والإضافات والخصومات، المتاح للحجز والمؤهل نقديًا والمحجوز للرد، ومراجع الاستخدام في حجز جديد أو الصرف. [SAD-137] القيد: فك ارتباط التخصيص لا يمحو المرجع. رصيد الإلغاء متاح للحجز قبل البديل، وتحـقق البديل يؤهل المتبقي نقديًا ولا يضيف مبلغًا. [SAD-138] استحقاق الاسترداد وتسوياته | RefundEntitlement / Settlement [SAD-139] البيانات اللازمة: أصل المبلغ وسقفه واستخدامه في حجوزات وما صرف وما حجز لرد جارٍ والمتبقي والبديل وحالة الأهلية النقدية. [SAD-140] القيد: لا يصرف ما سبق إنفاقه؛ التأهيل والصرف عمليتان مختلفتان. [SAD-141] ربط الحجز البديل | AlternativeBookingLink [SAD-142] البيانات اللازمة: الحجز الملغى والكوشة وحجز مستأجر آخر لنفس الكوشة وعربونه المؤكد وتاريخ كل مناسبة وحالة الإشعار. [SAD-143] القيد: لا يشترط تطابق التاريخ؛ قد يسبق موعد البديل الموعد الملغى أو يليه. إلغاء البديل لاحقًا يراجع ولا يخصم رصيدًا آليًا. [SAD-144] المهمة والإسناد | Task / Assignment [SAD-145] البيانات اللازمة: الحجز والفني أو الخدمات، إصدار المهمة وآخر مزامنة وحالات الاستلام والتركيب والاكتمال والسحب والملاحظات والصور. [SAD-146] القيد أو العلاقة: تتغير النسخة عند تغير ما يؤثر في صحة العمليات؛ التفاصيل تعتمد في التصميم. [SAD-147] قائمة الفحص والمرفق | Checklist / Attachment [SAD-148] البيانات اللازمة: أدوات المهمة وكمياتها المسحوبة والمرتجعة وحالتها، المرفق ونوعه وحجمه وصلاحيته ووقت حفظه المحلي ورفعه؛ الحد 1 ميجابايت للملف. [SAD-149] القيد أو العلاقة: حد 3 صور ليلة المناسبة؛ لا تحذف الأدلة المحلية قبل تأكيد الحفظ وفق السياسة. [SAD-150] عملية المزامنة | SyncOperation [SAD-151] البيانات اللازمة: معرف فريد؛ مستخدم وجهاز حيث يعتمد؛ إصدار مهمة؛ وقت محلي؛ محتوى؛ نتيجة وسبب. [SAD-152] القيد أو العلاقة: إعادة العملية تعيد نتيجتها؛ وقت الجهاز وحده لا يتغلب على حالة الخادم. [SAD-153] العهدة والحركة المخزنية | Custody / StockMovement [SAD-154] البيانات اللازمة: صنف وكمية؛ حجز ومهمة؛ مصدر ووجهة؛ نوع حركة؛ حالة واعتماد. [SAD-155] القيد أو العلاقة: نقل وإرجاع وتلف وجرد بحركات؛ العروض المشتقة ليست أرصدة تجمع مستقلة. [SAD-156] حادث التلف | DamageIncident [SAD-157] البيانات اللازمة: حجز وعهدة وصنف وكمية؛ دليل؛ قيمة؛ مسؤولية وأنصبة؛ اعتماد ومطالبات. [SAD-158] القيد أو العلاقة: مجموع الأنصبة لا يتجاوز القيمة؛ جهة التكلفة لا تجعل القطعة سليمة. [SAD-159] القيد والسند | Journal / Voucher [SAD-160] البيانات اللازمة: مرجع أصل؛ حسابات ومبالغ بالريال اليمني YER فقط؛ وقت ومستخدم؛ اعتماد؛ مرجع عكس أو تسوية. لا رسوم إلغاء أو تعديل في القيود. [SAD-161] القيد: أربعة حسابات أساسية هي الأصول والمصروفات والإيرادات والالتزامات، والفروع ينشئها محاسب العميل. التصحيح بعكس أو تسوية لا حذف. [SAD-162] استحقاق الطرف | PartyEntitlement [SAD-163] البيانات اللازمة: حساب مالي وبطاقة طرف وقيمة افتراضية بنسبة أو مبلغ وتخصيص اختياري بالحجز ومصدر القيمة المطبقة وحالات التعليق والاستحقاق والصرف. [SAD-164] القيد: تخصيص الحجز إن أدخل، وإلا الافتراضي؛ الصفر ليس فراغًا. الفني من الأساسي والقاعة من صافي المدفوع. [SAD-165] حركة الولاء والعرض | LoyaltyEntry / Offer [SAD-166] البيانات اللازمة: مستفيد وحجز؛ منح أو استبدال أو تسوية؛ نقاط؛ صلاحية؛ أهلية عرض. [SAD-167] القيد: الولاء خصم لا نقد؛ معدلات المنح والاستبدال والصلاحية والجمع مع العروض تحدد قبل تطبيقها دون افتراض أرقام. [SAD-168] المزود والحدث والمطابقة | Provider / Event / Reconciliation [SAD-169] البيانات اللازمة: إعدادات محفظة واحدة في إدارة طرق الدفع والتاجر والبيئة والقدرات والأسرار والأحداث والمراجع والمطابقة. كل إضافة باتفاق مستقل. [SAD-170] القيد أو العلاقة: أسرار منفصلة؛ فشل/مجهول/عكس لا يخلط؛ لا يفترض تقرير آلي. [SAD-171] الإشعار وسجل التدقيق | Notification / Audit [SAD-172] البيانات اللازمة: نوع الرسالة وقالبها وقنواتها وحالة كل إرسال؛ تفعيل واتساب وSMS وإشعارات التطبيق عدا OTP وبريد التحقق؛ سجل التغيير ومنفذه ووقته. [SAD-173] القيد أو العلاقة: الإشعار لا يثبت موافقة أو دفعًا؛ التدقيق غير قابل للمحو من مستخدم التشغيل. [SAD-174] العلاقات والحدود التي لا يجوز استنتاجها ضمنيًا [SAD-175] يوضح PaymentAllocation الفرق بين تحصيل المبلغ وتخصيصه، ولا يضيف إمكانية دفع عدة حجوزات بعملية واحدة. وتبقى YER العملة الوحيدة دون تحويل عملات. ولم يُحدد هنا عدد المهام لكل حجز، أو تعدد الشركات والفروع، أو ترقيم السندات. كما لا يضيف سعر إيجار القاعة ورابط موقعها محركًا لحجز القاعات أو خدمة خرائط مدفوعة؛ فالنموذج يشرح الوظائف ولا يوسعها. [SAD-176] 6. قواعد الاتساق والحساب والتزامن [SAD-177] 6.1 ثوابت المال المشتقة [SAD-178] كل المبالغ بالريال اليمني دون رسوم تعديل أو إلغاء. تفصل الحسابات الرصيد المتاح للحجز عن أهليته للسحب النقدي كي لا ينشئ تغير الحالة مالًا جديدًا. [SAD-179] القاعدة | التمثيل التحليلي والاحتراز المتبقي المستحق | الأكبر بين صفر و(المستحق بعد التعديل − صافي التحصيل المخصص القائم)، بعملة YER؛ رسوم الإلغاء والتعديل صفر، ويظل أثر العكس والتسويات موثقًا. فائض تحصيل قابل للتسوية | الأكبر بين صفر و(صافي التحصيل المخصص − المستحق المعتمد)، بعد التسويات المعتمدة. لا يمنح مرة ثانية في المحفظة والحجز. المتبقي من سقف الرد | أصل المبلغ − المستخدم في حجز آخر − المصروف أو المسترد سابقًا − المحجوز لرد جارٍ؛ لا يصرف المتبقي إلا بعد تحقق أهليته. الرصيد القابل للإنفاق | الرصيد الموثق بعد استبعاد المحجوز والإنفاق السابق وغير المحصل؛ رصيد الإلغاء قبل البديل صالح للحجز لا للسحب. توزيع مسؤولية التلف | مجموع الأنصبة المعتمدة لا يتجاوز قيمة الحادث؛ لا يخلط تحميل الكلفة مع إعادة صلاحية القطعة. [SAD-181] أمثلة لتوضيح الحساب [SAD-182] الحالة | النتيجة المطلوبة قيمة 100,000؛ مدفوع 20,000؛ تخفيض إلى 80,000 دون رسوم | المتبقي 60,000؛ لا رصيد محفظة جديد. قيمة معدلة 80,000؛ مدفوع 90,000 دون رسوم | فائض 10,000 يسوى مرة واحدة وفق السياسة. نقل إلى تاريخ مفتوح | يبقى المحصل المستحق في محفظة العميل دون رسوم تعديل؛ لا يدخل الجزء غير المدفوع ولا يكرر قيد سابق. رصيد إلغاء 20,000؛ استُخدم 8,000 ثم تحقق البديل | المتاح نقدًا 12,000 إذا لم توجد تسوية أخرى؛ لا يضاف الرصيد مرة ثانية. [SAD-184] 6.2 ثوابت الموارد والعهد [SAD-185] لا يتجاوز تخصيص المورد كميته الصالحة خلال الفترة المضبوطة، ولا يصبح المصروف أو تحت الفحص متاحًا بتغير اليوم. لا يتجاوز الإرجاع العهدة المتبقية. تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، وسعات الألوان اليومية، والمنطقة الزمنية وطريقة التحويل الهجري. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. [SAD-186] 6.3 حدود الوحدات الذرية المقترحة [SAD-187] العملية | الآثار التي يجب ألا تتناقض | عند الفشل أو الإعادة إنشاء الحجز | تخصيص الكوشة والمكونات واللون وحفظ الطلب/القفل. | لا تخصيص جزئي ولا حجزان لطلب واحد. نقل الموعد | حجز الجديد وتحرير القديم وحفظ التعديل. | يبقى القديم عند فشل الجديد. تخصيص تحصيل أو نقل لمحفظة | قيد ومبلغ مخصص أو رصيد حر، لا كلاهما للقيمة نفسها. | نتيجة واحدة أو حالة متابعة موثقة. طلب الاسترداد | حجز السقف عبر المحفظة والصرف والمزود. | يبقى مجهول النتيجة محجوزًا حتى التحقق. النقل المباشر | إغلاق عهدة الكمية في الأصل وفتحها في التالي. | لا زيادة وهمية ولا كمية مزدوجة. مزامنة عملية | فحص المعرف والإصدار والصلاحية واعتماد الأثر. | المكرر يعيد النتيجة؛ المتعارض لا يكتب فوق الأحدث. [SAD-189] يحفظ النظام الحالة والمراجع واتساق الأثر المحلي والمطابقة مع المزود؛ لا يشترط معاملة قاعدة بيانات موزعة معه. [SAD-190] 7. مصفوفة الوصول والواجهات [SAD-191] 7.1 حدود بيانات المستخدمين [SAD-192] الدور | حد البيانات | ما لا يمنحه الدور تلقائيًا العميل / تطبيق العميل | حسابه وحجوزاته ومستنداته وصوره. | حجوزات مستخدم آخر أو إعدادات المزود. صاحب القاعة / تطبيق العميل | بيانات قاعته وتواصلها وموقعها ورابطها وسعرها وحجوزاته وعمولاته. | كامل ملف العميل المالي أو جميع حجوزاته. الفني / تطبيق الإدارة | مهامه المسندة وبياناتها الضرورية والعهد. | التحصيل أو تعديل السعر أو المهام غير المسندة. مسؤول الخدمات / تطبيق الإدارة | الخدمات والمهام المسندة وملاحظاتها. | صلاحيات الإدارة المالية أو مهام الفني غير المسندة إليه أو بيانات غيره. موظفو الإدارة / لوحة التحكم | حسب صلاحيات الوظيفة والعملية ونطاق السجل. | صلاحيات عامة لكل من يحمل صفة موظف. الدعم التقني | الحد اللازم وفق سياسة وصول مسجلة. | استخدام البيانات خارج التشغيل أو محو الأثر. [SAD-194] 7.2 صلاحيات العمليات الحساسة [SAD-195] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. يحدد العميل صلاحيات موظفي اللوحة، ولا يمنح اشتراك الفني والخدمات في التطبيق صلاحيات المال أو بقية الحجوزات. [SAD-196] 7.3 عائلات الواجهات وروابطها [SAD-197] عائلة API | حالات الاستخدام | سلوك خطأ أو تحقق لازم Authentication / Users | UC-01؛ UC-13 | اختيار نوع الحساب وحقول القاعة؛ OTP لمدة 60 ثانية و3 محاولات؛ فحص الجلسة ونطاق السجل. Catalog / Availability / Bookings | UC-02؛ UC-03؛ UC-05؛ UC-06 | تعارض التوفر أو قفل منتهٍ أو تعديل غير معتمد. Contracts | UC-04؛ UC-05 | نسخة قديمة أو رابط غير صالح أو موافقة غير صاحبها. Payments / Wallet | UC-04؛ UC-06؛ UC-12 | مبلغ أو عملة أو تاجر مختلف؛ رصيد أو سقف غير كافٍ؛ نتيجة مجهولة. Partners / Technicians / Services | UC-07؛ UC-08؛ UC-11 | مهمة غير مسندة أو إصدار قديم أو إنجاز غير معتمد. Inventory | UC-09؛ UC-10 | صرف غير متاح أو إرجاع زائد أو نقل دون مطابقة. Notifications / Reports / Admin / Audit | UC-13؛ UC-14 | صلاحية إعداد العربون وتدقيق التغيير؛ فشل إشعار مع حفظ الأصل؛ تصدير دون صلاحية؛ تقرير غير محدد. [SAD-199] يوثق OpenAPI الحقول والأمثلة والأخطاء والصلاحيات ومفاتيح منع التكرار والمهل والنتائج غير المتزامنة، وتختبر الواجهات قبل التسليم. [SAD-200] 8. الحالات الاستثنائية وضبط التنفيذ [SAD-201] 8.1 معالجة الحالات الخاصة [SAD-202] الحالة | السلوك خارج الدوام | خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. رصيد الإلغاء | في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. العمل دون شبكة | لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. البريد البديل | إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. الدفع المتأخر | حفظ المال وتسويته دون إحياء حجز منتهٍ. [SAD-204] 8.2 تهيئة التشغيل [SAD-205] المجال | التفصيل الوقت والتوفر | تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، وسعات الألوان اليومية، والمنطقة الزمنية وطريقة التحويل الهجري. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. الحسابات والاستحقاقات | تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. الدفع والرسائل | يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. التشغيل | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. البيانات والتدريب | يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. [SAD-207] 8.3 ما يحتاجه التصميم التفصيلي لاحقًا [SAD-208] تحدد الشركة الجداول وقيودها وعقود الواجهات والمعاملات والمزامنة وحماية الملفات ضمن Flutter وLaravel وUbuntu والمنصات المحددة، وتجهز أمثلة الحساب والاختبار. تستكمل القيم التجارية غير المحددة في إعداداتها دون افتراضها. [SAD-209] 8.4 ضبط التغيير في النموذج [SAD-210] عند تغير قاعدة، تراجع العمليات والبيانات والصلاحيات والواجهات والاختبارات المتأثرة. توضح الشركة الأثر ويعتمده العميل قبل التنفيذ. [SAD-211] اعتماد الوثيقة [SAD-212] الطرف | الاسم والمسؤولية | التوقيع والتاريخ العميل ومفوضوه | عبدالله وأخوه طه؛ اعتماد النطاق والسياسات والقبول. | ........................ الشركة المبرمجة | التنفيذ والاختبار والتوثيق. | ........................ [SAD-214] يثبت القبول بعد مراجعة المخرجات ونتائج الاختبارات، وتبقى بيانات العميل حقًا مستقلًا عن شراء الشفرة.