[BRD-001] منظومة كوش الأعراس والمناسبات [BRD-002] BRD [BRD-003] وثيقة متطلبات الأعمال [BRD-004] توضح الوثيقة وظائف النظام وطريقة العمل المتفق عليها ومسؤوليات التشغيل والتسليم، ليستخدمها العميل والشركة أثناء التنفيذ والمراجعة. [BRD-005] الإصدار 1.3 | 13 نوفمبر 2026 [BRD-006] المشروع | إدارة حجوزات وعمليات كوش الأعراس والمناسبات لغة الواجهات | العربية ممثلو العميل | عبدالله وأخوه طه المكونات | تطبيق العميل، تطبيق الإدارة، لوحة تحكم ويب وخادم مركزي. [BRD-008] قبول النظام يثبت بعد مراجعة التنفيذ ونتائج الاختبارات، وليس بمجرد إعداد الوثيقة. [BRD-010] دليل الأقسام [BRD-011] 1. ملخص المشروع [BRD-012] 2. الأهداف والقيمة ومقاييس النجاح [BRD-013] 3. أصحاب المصلحة والمسؤوليات [BRD-014] 4. النطاق المشمول وغير المفترض [BRD-015] 5. متطلبات الأعمال [BRD-016] 6. قواعد العمل ورحلة الخدمة [BRD-017] 7. التشغيل والتبعيات والمخاطر [BRD-018] 8. القبول والتغيير والتسليم [BRD-020] 1. ملخص المشروع [BRD-021] تجمع المنظومة إدارة حجوزات كوش الأعراس والمناسبات في مسار واحد، يبدأ باختيار الخدمة والتحقق من توفرها، ويمر بالعقد والتحصيل، ثم تجهيز الأصناف والتنفيذ والتسوية. يستخدم العملاء وأصحاب القاعات تطبيق العميل، ويستخدم الفنيون ومسؤولو الخدمات تطبيق الإدارة، بينما يعمل موظفو الإدارة من لوحة تحكم الويب. وترتبط هذه الواجهات جميعًا بخادم مركزي. [BRD-022] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. [BRD-023] حدود استخدام الوثيقة [BRD-024] تحدد الوثيقة أهداف المشروع وحدود الخدمة ومسؤوليات الأطراف، وليست دراسة سوق أو توقعًا للإيرادات. [BRD-025] مرجع الأعمال والمصطلحات [BRD-026] العميل النهائي صاحب الحجز، ومالك المشروع صاحب اعتماد النطاق. يستخدم صاحب القاعة تطبيق العميل، ويستخدم الفني والخدمات تطبيق الإدارة بصلاحيات مستقلة، ويعمل الموظفون من لوحة التحكم. [BRD-027] 2. الأهداف والقيمة ومقاييس النجاح [BRD-028] الهدف | كيف يظهر في الخدمة | الربط اتساق الخدمة عبر القنوات | تخضع حجوزات العميل والقاعة والإدارة لقواعد التوفر والتسعير والصلاحيات نفسها. | BR-01–BR-04 حماية الأموال والحقوق | يمكن تتبع التحصيل والتعديل والاسترداد وحركات المحفظة، دون تكرار أثرها المالي. | BR-05؛ BR-06؛ BR-10 ضبط التنفيذ والموارد | تُتابع المهام والعهد والإرجاع والنقل والتلف، ويُربط بدء التركيب بالسداد وتوفر الموارد. | BR-07–BR-09 وضوح العلاقة التجارية | تُحسب النقاط والعمولات وفق السياسة المحددة، وتظهر نتائجها في تقارير موثقة. | BR-10–BR-12 استمرارية وتسليم قابلان للتحقق | تُختبر التكاملات والنسخ والاستعادة والتصدير، ويُوثق التسليم والقبول كتابيًا. | BR-13؛ BR-14 [BRD-030] مؤشرات مقترحة لمتابعة النتائج [BRD-031] المؤشر | التعريف / مصدر القياس | خط الأساس والهدف تعارض التخصيص | عدد الحالات التي يتجاوز فيها تخصيص مورد سعته ضمن الفترة. | خط الأساس غير متاح؛ منع التجاوز شرط قبول وظيفي. الأثر المالي المكرر | عدد تحصيلات أو تسويات لنفس الأصل دون مبرر مستقل. | خط الأساس غير متاح؛ منع التكرار شرط قبول. زمن تأكيد الطلب | المدة بين إنشاء الطلب وتحقق شروط التأكيد؛ تفصل مراجعة الإدارة عن انتظار العميل. | يقاس التأكيد الآلي منفصلًا عن مراجعة الحوالة، دون هدف عددي مفترض. الفروق المفتوحة للمطابقة | عدد وقيمة فروق المزود التي لم تعتمد تسويتها بعد. | متابعة الإدارة للفروقات المفتوحة وتسوياتها. اكتمال العهد والتسليم | حالات عهد غير مسواة، ونسبة مخرجات الإصدار المقبولة بدليل. | لا بيانات حالية؛ القبول حسب الاختبارات والمخرجات المعتمدة. [BRD-033] تتابع هذه المؤشرات نتائج العمل دون إضافة تقارير أو أهداف مالية خارج القائمة المحددة. [BRD-034] 3. أصحاب المصلحة والمسؤوليات [BRD-035] الطرف | ما يحتاجه / ما يقدمه | حد المسؤولية مالك المشروع وممثله | العميل ويمثله عبدالله وأخوه طه؛ اعتماد النطاق والسياسات والقبول. | لا يعتمد طلب مستخدم غير مخول تغييرًا في النطاق. المسؤول المالي | يحدد قواعد الحساب والرسوم والعمولات والتسويات والتقارير وأمثلة قبولها، ضمن السياسات المعتمدة. | لا يترك للمبرمج تحديد معادلات غير محسومة. مدير العمليات والمخزن | يحدد فترات إشغال الموارد وسعاتها وقواعد العهد والمطابقة والاستثناءات ونقاط الإنجاز. | الاستثناء لا يخلق مخزونًا ولا يسقط دينًا. الشركة المنفذة | تصمم القواعد المعتمدة وتنفذها وتختبرها وتوثقها، وتوضح التفاصيل التي تحتاج إلى استكمال. | تلتزم Flutter للتطبيقين وPHP/Laravel للوحة، وتختار بقية تفاصيل التنفيذ ضمن النطاق المعتمد، دون أن تعتمد قرارات نيابة عن العميل. العميل النهائي والشريك | ينشئان الحجوزات أو يطلبانها، ويتابعان الموافقة والدفع وحالة الطلب، كلٌّ في حدود صلاحياته. | الحجز نيابة عن عميل لا يمنح كامل بياناته. الفني ومسؤول الخدمات | يستلمان المهام وينفذانها من تطبيق الإدارة، ويسجلان الأدلة والعهد والخدمات بحسب دور كل منهما. | دون تحصيل مالي للفني أو صلاحيات لم تعتمد. المزودون الخارجيون | وثائق وحسابات وموافقات وقدرات دفع أو إرسال مثبتة. | لا تفترض خاصية غير مدعومة أو توفر خارج سيطرة النظام. [BRD-037] توزيع المسؤوليات [BRD-038] القرار / النشاط | المنفذ أو المجهز | جهة الاعتماد إعداد العربون وغياب رسوم التعديل والإلغاء | المسؤول المالي والتشغيلي لدى العميل | العميل أو مفوضه؛ الشركة توثق الأثر وتنفذ. تفاصيل التوفر والعهد | مدير العمليات وأمين المخزن | ممثل العميل التشغيلي المخول. تصميم البرمجيات الداخلي | الشركة المنفذة | الشركة تجهز التصميم ضمن التقنيات المحددة؛ العميل يعتمد ما يمس النطاق والسياسات. الاستثناء المالي والتشغيلي | صاحب الصلاحية المحددة لكل نوع | المخول لكل استثناء؛ الصلاحيتان المالية والتشغيلية مستقلتان. حسابات المزودين وتكاليفهم | المالك والمدير ودافع الرسوم كما في بطاقة المزود | العميل يعتمد الخدمات والتكاليف المتفق عليها. اختبار القبول والتسليم | الشركة تقدم الأدلة؛ العميل يراجعها | عبدالله أو أخوه طه نيابة عن العميل. [BRD-040] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [BRD-041] 4. النطاق المشمول وغير المفترض [BRD-042] المجال | المشمول قنوات الخدمة | تطبيق عميل للعملاء وأصحاب القاعات؛ تطبيق إدارة للفنيين ومسؤولي الخدمات؛ لوحة تحكم ويب وخادم مركزي. الهوية والعقد | صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. الكتالوج والحجز | نماذج ومكونات ووسائط وألوان وسعات وعروض وخدمات وقاعات ومقاسات وتقويم ومفضلة وتقييم. التحصيل والتعديل | تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. التشغيل والمخزون | إسناد وتركيب وصور وصرف وإرجاع وجرد وعهد وتلف ونقل مباشر وعمل فني محدود دون اتصال. المال والشركاء | حسابات وصندوق وبنوك وسندات واستحقاقات وعمولات وولاء، بعملة واحدة هي الريال اليمني YER؛ الدقة والتقريب تستكمل. التكامل والتشغيل | يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. التسليم والحقوق | حزمة استخدام وتشغيل كما تعتمد وبيانات وأدلة ونتائج اختبار ومحاضر قبول؛ حقوق المصدر والبيانات محفوظة. قيد التقنيات | تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. [BRD-044] ما لا يدخل تلقائيًا في الالتزام [BRD-045] لا يشمل النطاق تطبيقًا ثالثًا أو محفظة إضافية دون سعر واتفاق مستقلين، ولا تحويل الأرصدة بين العملاء أو الشحن العام، أو نظام موارد وضريبة شاملًا، أو تعدد الشركات والعملات، أو ترحيلًا تاريخيًا غير محدد. بيانات القاعة ورابطها لا تضيف خدمة لحجز إيجارها. [BRD-046] فصل الوظيفة عن طريقة تنفيذها [BRD-047] تشمل الوظيفة تفاصيلها الداخلية اللازمة لتحقيق النتيجة المذكورة. ولا تعني قابلية التوسع تنفيذ إضافات المستقبل مجانًا؛ ربط الدفع الحالي محفظة واحدة ولكل إضافة سعر خاص. [BRD-048] 5. متطلبات الأعمال [BRD-049] توضح المتطلبات التالية ما يحتاجه العمل من النظام، من الدخول واختيار الخدمة إلى التنفيذ والتسوية والتسليم. [BRD-050] BR-01 | الهوية والوصول المنضبط [BRD-051] يتيح النظام لكل طرف الوصول إلى وظائفه وبياناته فقط، مع توحيد حساب العميل. وعند إدخال الاسم في تطبيق العميل، يختار المستخدم نوع الحساب «عميل» أو «صاحب قاعة»، دون تجاوز التحقق من الهوية أو حدود الصلاحيات. [BRD-052] BR-02 | عرض الخدمات واتخاذ قرار الحجز [BRD-053] يعرض النظام الكوش ومكوناتها وألوانها والقاعات والخدمات والعروض، ليتمكن المستخدم من اختيار ما يناسب حجزه. وعند تسجيل صاحب قاعة، تُحفظ بيانات تواصل القاعة وموقعها ورابط Google Maps وسعر إيجارها بالريال اليمني داخل تطبيق العميل نفسه. [BRD-054] BR-03 | حجز موحد بلا تعارض [BRD-055] يستخدم العميل وصاحب القاعة مسار الحجز في التطبيق، والموظف لوحة التحكم، دون تخصيص مورد واحد لحجزين متعارضين. يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. [BRD-056] BR-04 | موافقة موثقة على الخدمة [BRD-057] يعرض التطبيق الكوشة المختارة ولونها ولون الكرسي والورد، واسم القاعة واسم الشخص، والإجمالي والمدفوع والمتبقي والخدمات الإضافية المختارة. تحفظ هذه البيانات مع نسخة العقد والموافقة، ولا تتغير النسخة السابقة بصمت عند تعديل الحساب أو الحجز. عند تعديل جوهري تطلب موافقة جديدة مع حفظ السابقة. [BRD-058] BR-05 | تحصيل واضح وقابل للتسوية [BRD-059] تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. تتحقق الإدارة من الحوالات، وتحفظ مراجع الدفع لمنع تكراره. [BRD-060] BR-06 | تعديل وإلغاء واسترداد منضبط [BRD-061] لا رسوم تعديل أو إلغاء. عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. [BRD-062] يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. [BRD-063] BR-07 | تنفيذ ميداني مرتبط بالسداد والعهد [BRD-064] يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. [BRD-065] BR-08 | عمل الفني عند ضعف الاتصال [BRD-066] لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. [BRD-067] BR-09 | مخزون وعهد ومسؤولية تلف قابلة للتتبع [BRD-068] يتابع النظام التوريد والصرف والجرد والإرجاع الجزئي والعهد والتوالف، بحيث تعكس الكميات الحركات الفعلية، ولا تُحمّل مسؤولية التلف أو قيمته أكثر من مرة. [BRD-069] BR-10 | محاسبة تشغيلية واستحقاقات صحيحة [BRD-070] تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. [BRD-071] BR-11 | ولاء وعروض ضمن سياسة واضحة [BRD-072] تُمنح نقاط الولاء للحجوزات المكتملة، وتُستخدم خصمًا على حجوزات لاحقة، لا رصيدًا نقديًا. ويُطبق أثر العروض والتعديل والاسترداد وفق السياسة المعتمدة. [BRD-073] BR-12 | تواصل وتقارير وتدقيق [BRD-074] تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. [BRD-075] BR-13 | تكامل وتشغيل مركزي قابل للتحقق [BRD-076] يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. [BRD-077] BR-14 | تسليم وحدود تعاقدية متوازنة [BRD-078] تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [BRD-079] 6. قواعد العمل ورحلة الخدمة [BRD-080] 6.1 قواعد لا تتجاوزها الواجهات أو المستخدمون [BRD-081] RULE-01 | تعمل القنوات من خلال خادم مركزي واحد؛ ولا تكفي رسالة واجهة المستخدم لإثبات نجاح العملية. [BRD-082] RULE-02 | يُسدد العربون كاملًا من وسيلة واحدة، ولا يُسمح للفني بتحصيل الأموال. [BRD-083] RULE-03 | يتأكد الحجز بعد موافقة العميل على النسخة الحالية، والتحقق من سداد العربون كاملًا، وصحة تخصيص الموارد. [BRD-084] RULE-04 | عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. [BRD-085] RULE-05 | مراجعة الحوالة لا تعد تحصيلًا ولا تمدد قفل الإدارة دون تأكيد العربون. [BRD-086] RULE-06 | يُسجل الدفع المتأخر الموثق، لكنه لا يعيد تفعيل حجز منتهٍ تلقائيًا. [BRD-087] RULE-07 | عند تخفيض قيمة الحجز، ينخفض المبلغ غير المدفوع أولًا. ولا يضاف رصيد إلى المحفظة إلا مقابل فائض محصل مستحق، ويُسوّى مرة واحدة. [BRD-088] RULE-08 | تخضع جميع طرق رد المبلغ لسقف الاسترداد نفسه، حتى لا يُرد الاستحقاق الواحد أكثر من مرة. [BRD-089] RULE-09 | يُحسب استحقاق الفني من السعر الأساسي، وعمولة القاعة من صافي المدفوع بعد الخصم، وفق تعريف كل أساس حسابي. [BRD-090] RULE-10 | لا يصبح الرصيد المعلق قابلًا للصرف إلا عند بلوغ نقطة الإنجاز المحددة للطرف المعني. [BRD-091] RULE-11 | تُستخدم نقاط الولاء خصمًا للحجز القادم، ولا تُصرف نقدًا. [BRD-092] RULE-12 | لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. [BRD-093] RULE-13 | ينقل النقل المباشر العهدة بين الحجزين دون إثبات عودة لم تحدث إلى المخزن، مع إبقاء الفروقات ظاهرة. [BRD-094] RULE-14 | يرفع الفني حتى 3 صور ليلة المناسبة. ولا تتجاوز عملية محفوظة على جهازه الحالة الأحدث المعتمدة في الخادم. [BRD-095] RULE-15 | أثر القيود والعهد والموافقات لا يمحى بصمت عند التعديل أو الأرشفة. [BRD-096] RULE-16 | تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. [BRD-097] RULE-17 | إصلاح مخالفة متطلب معتمد ليس إضافة؛ الوظيفة الجديدة لا تدخل باسم «تحسين». [BRD-098] RULE-18 | تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. [BRD-099] RULE-19 | تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. لا رسوم تعديل أو إلغاء. [BRD-100] RULE-20 | يستخدم النظام الريال اليمني YER وحده، دون تعدد عملات أو تحويل تلقائي بينها. [BRD-101] RULE-21 | صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. [BRD-102] RULE-22 | يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [BRD-103] التقارير المطلوبة [BRD-104] التقرير | المحتوى كشف الحساب | الحركات والرصيد بحسب الحساب والفترة. القيود اليومية | القيود وحساباتها ومراجعها ومبالغها. المصروفات اليومية | المصروفات بحسب اليوم والحساب. طرق الدفع | التحصيلات والتسويات بحسب وسيلة الدفع. الإيرادات والربح والخسارة | الإيرادات والمصروفات والنتيجة للفترة. الحجوزات | الحجوزات ومرشحات التاريخ والحالة والعميل والقاعة. قاعات الأفراح وحساباتها | حجوزات القاعات وحساباتها المالية. الفنيون ومسؤولو الخدمات | المهام والحسابات المالية لكل طرف. الكوش ومرات الحجز | الكوش والعملاء والقاعات المرتبطة بالحجوزات وعددها. مبالغ الإلغاء المستردة | الحجز الملغى والعربون والبديل والرصيد المستخدم والمتبقي وأهلية الصرف. [BRD-106] 6.2 رحلة الأعمال المستهدفة [BRD-107] المرحلة | النتيجة المطلوبة | البوابة قبل التالية استكشاف واختيار | نموذج وموعد ومكونات وخدمات وسعر محسوب. | التوفر النهائي لا يثبت بالتصفح فقط. طلب وعقد | طلب مؤقت وموارد ومهلة ونسخة عقد. | موافقة وعربون موثق وتخصيص صالح. تحصيل وتأكيد | مبلغ مثبت وحجز مؤكد أو تسوية/تعليق واضح. | لا تتساوى حالة الدفع مع حالة الحجز. تجهيز وتنفيذ | مهمة وعهد وشروط مالية وتشغيلية وأدلة. | السداد أو الاستثناء والعهد أو البديل الصحيح. إرجاع أو نقل | كميات مطابقة وفحص وتلف وفروقات موثقة. | لا يغلق المتبقي دون تسوية أو مسؤولية. تسوية وإغلاق | استحقاقات وعمولات وولاء وتقارير حسب السياسة. | لا يمحى دين أو استرداد بتغير الحالة التشغيلية. [BRD-109] 7. التشغيل والتبعيات والمخاطر [BRD-110] يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. [BRD-111] المجال | المسؤولية إعدادات العمل | تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، وسعات الألوان اليومية، والمنطقة الزمنية وطريقة التحويل الهجري. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. الحسابات | تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. خدمة الدفع | يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. البيانات | يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. التدريب | يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. [BRD-113] تستكمل معدلات الولاء وحقول التقييم ومدد الدعم والضمان عند إعداد خدماتها، دون افتراض أرقام لم تحدد. [BRD-114] المخاطر المتوقعة والاعتماد على الأطراف الأخرى [BRD-115] الحالة | الأثر | المعالجة دفع متأخر أو مجهول | احتمال تكرار التحصيل أو تعارض الحجز. | حفظ المرجع والتحقق دون إعادة حجز مورد أصبح غير متاح. عمل الفني دون شبكة | قد تتغير المهمة بعد آخر مزامنة. | لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. رصيد الإلغاء | احتمال استخدامه ثم صرفه مجددًا. | لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. البريد البديل | لا يثبت ملكية رقم مسجل. | إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. الاستضافة | تأثر الخدمة والنسخ بالمستضيف. | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. [BRD-117] الانتقال بين مراحل العمل [BRD-118] تجهز بيانات العمل والإعدادات قبل اختبارها، وتجرب دورة الحجز والتحصيل والتنفيذ والإرجاع والتسوية ثم التشغيل. يتبع ذلك التدريب خلال الشهر الأول دون افتراض زيادة مدة أو تكلفة بسبب تبعية خارجية لم تعتمد. [BRD-119] 8. القبول والتغيير والتسليم [BRD-120] قبول الأعمال [BRD-121] تقدم الشركة أدلة المطابقة ويراجعها العميل. يمنع العيب الحرج القبول النهائي والجسيم قبول المسار المتأثر؛ توثق معالجة الملاحظات الأقل أثرًا. تحدد مدد الضمان والدعم بحسب الاتفاق دون خدمة مفتوحة. [BRD-122] الموقف | المعاملة وظيفة معتمدة لا تعمل كما وصفت | يُسجل عيبًا مرتبطًا بمتطلب واختبار، ولا يُعامل تلقائيًا كإضافة جديدة. تفصيل لازم لتحقيق النتيجة نفسها | يُوثق إيضاحًا تنفيذيًا، ولا يصبح طلب تغيير إلا إذا غيّر نطاق الالتزام. منصة أو مزود أو تقرير أو سياسة جديدة | يُسجل طلب تغيير، ويُدرس أثره الفني والمالي والزمني قبل اعتماده وتنفيذه. قيمة لم يحددها الاعتماد العام | تُستكمل قبل تنفيذ الجزء المرتبط بها، دون افتراض قيمتها أو اعتبارها تلقائيًا إضافة مدفوعة. [BRD-124] ما يتسلمه العميل [BRD-125] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. [BRD-126] يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. [BRD-127] ضبط التغيير [BRD-128] تُراجع الملاحظات مقابل الوظائف المكتوبة. تعالج عدم المطابقة، وتوضح الشركة أثر التوسعة الجديدة قبل اعتمادها. لا يعد عرض شاشة أو مرور مدة قبولًا للنظام. [BRD-129] اعتماد الوثيقة [BRD-130] الطرف | الاسم والمسؤولية | التوقيع والتاريخ العميل ومفوضوه | عبدالله وأخوه طه؛ اعتماد النطاق والسياسات والقبول. | ........................ الشركة المبرمجة | التنفيذ والاختبار والتوثيق. | ........................ [BRD-132] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل.