[SCOPE-001] منظومة كوش الأعراس والمناسبات [SCOPE-002] نطاق العمل [SCOPE-003] العرض الفني وتحديد نطاق العمل [SCOPE-004] توضح الوثيقة وظائف النظام وطريقة العمل المتفق عليها ومسؤوليات التشغيل والتسليم، ليستخدمها العميل والشركة أثناء التنفيذ والمراجعة. [SCOPE-005] الإصدار 1.10 | 17 نوفمبر 2026 [SCOPE-314] تحديث: اعتماد حسابات القاعات من الإدارة وإدارة التخفيضات المرتبطة بنوع المستخدم، وإنشاء الكوش من مكونات مشتركة وتوفر ألوان الورد وألبومات القاعات. [SCOPE-006] المشروع | إدارة حجوزات وعمليات كوش الأعراس والمناسبات لغة الواجهات | العربية ممثلو العميل | روزا للكوش المكونات | تطبيق العميل، تطبيق الإدارة، لوحة تحكم ويب وخادم مركزي. [SCOPE-008] قبول النظام يثبت بعد مراجعة التنفيذ ونتائج الاختبارات، وليس بمجرد إعداد الوثيقة. [SCOPE-010] دليل الأقسام [SCOPE-011] ضوابط العمل ومسؤولياته [SCOPE-012] القسم الأول: الهيكل العام وأطراف الاستخدام [SCOPE-013] القسم الثاني: التسجيل والهوية والرسائل [SCOPE-014] القسم الثالث: الكتالوج والكوش والألوان والعروض والتخفيضات [SCOPE-015] القسم الرابع: قنوات الحجز وإنشاء الطلبات [SCOPE-016] القسم الخامس: العربون وتأكيد الحجز والمحفظة [SCOPE-017] القسم السادس: التعديل والإلغاء وإدارة الأرصدة [SCOPE-018] القسم السابع: العمليات الميدانية والإرجاع [SCOPE-019] القسم الثامن: المحاسبة التشغيلية والشراكات [SCOPE-020] القسم التاسع: المخازن والصرف والتوالف [SCOPE-021] القسم العاشر: قواعد النظام وحالاته [SCOPE-022] القسم الحادي عشر: معمارية واجهات الربط API [SCOPE-023] القسم الثاني عشر: تكامل المحافظ وبوابات الدفع [SCOPE-024] القسم الثالث عشر: اختبارات القبول والتسليم الفني [SCOPE-025] القسم الرابع عشر: الملكية والاستضافة والتسليم [SCOPE-026] القسم الخامس عشر: ضبط النطاق والاعتماد [SCOPE-028] ضوابط العمل ومسؤولياته [SCOPE-029] أ. معنى المتطلبات وحدود الإلزام [SCOPE-030] توضح عبارات الالتزام السلوك المطلوب. تُدار الإعدادات بواسطة المخول ولا تمنح لكل مستخدم صلاحية تغيير سياسة العمل. [SCOPE-031] يوضح التفصيل التنفيذي كيف تتحقق النتيجة المتفق عليها، دون إضافة خدمة جديدة. أما تعديل القنوات أو السياسات أو النتائج أو الحقوق، فيُسجل طلب تغيير يوضح أثره الفني والمالي والزمني، ثم يعتمد من ممثل العميل المخول. وتتولى الشركة إعداد الأثر وتوثيقه والتنفيذ، لا الاعتماد نيابة عن العميل. [SCOPE-032] ب. حدود المنظومة والقيم الأساسية [SCOPE-033] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. لا رسوم تعديل أو إلغاء؛ الرمز 60 ثانية وثلاث محاولات، والقفل الإداري عشر دقائق، ولا تحصيل للفني. [SCOPE-034] ج. الفصل بين النطاق والتصميم [SCOPE-035] تختار الشركة تفاصيل التنفيذ الداخلية بما يحقق النتائج المعتمدة ويحافظ على المعمارية وFlutter للتطبيقين وPHP/Laravel للوحة. وقابلية التوسع تتيح التطوير لاحقًا، لكنها لا تضم التوسعات تلقائيًا إلى الالتزام. كما أن إصلاح مخالفة لمتطلب معتمد ليس ميزة إضافية، وعرض الشاشات وحده لا يثبت اكتمال قواعد العمل على الخادم. [SCOPE-036] د. تفسير المتطلبات [SCOPE-037] توضح الشركة أثر أي تغيير أو تعارض ويعتمد العميل تفسيره؛ لا يغير طلب مستخدم غير مخول النطاق. [SCOPE-038] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [SCOPE-039] القسم الأول: الهيكل العام وأطراف الاستخدام [SCOPE-040] 1.1 أطراف الاستخدام وواجهاتهم [SCOPE-041] يستخدم العملاء وأصحاب القاعات تطبيق العميل، ويستخدم الفنيون ومسؤولو الخدمات تطبيق الإدارة، بينما يعمل موظفو الإدارة من لوحة التحكم. وتتصل الواجهات جميعًا بالخادم المركزي نفسه. ولكل طرف وظائف وبيانات تخص دوره؛ فلا يدمج التطبيق المشترك صلاحيات مستخدميه. [SCOPE-042] الطرف | الوظائف المشمولة | حد الوصول الإدارة / لوحة التحكم | المدير العام، المحاسب، منسق الحجوزات، أمين المخزن، مدير العمليات؛ إدارة الحجوزات والمال والمخزون والشركاء والتقارير والاستثناءات. | حسب مصفوفة الصلاحيات المعتمدة، لا بمجرد تسمية المستخدم موظفًا. العميل / تطبيق العميل | الكتالوج والمفضلة والحجز والدفع والمتابعة وطلبات التعديل والإلغاء والعقود والصور والتقييم. | حسابه وحجوزاته ومستنداته فقط. صاحب القاعة / تطبيق العميل | بعد اعتماد حسابه من الإدارة: إنشاء حجوزات للعملاء ومتابعتها وعمولاته ونقاط الولاء وطلبات التعديل والإلغاء، والتخفيضات المؤهلة وفق 3.8. | الحجوزات المرتبطة به وبيانات خدمتها، دون كامل حساب العميل؛ وتفعيل الدور وفق 2.7. الفني / تطبيق الإدارة | استلام المهام والعهد وتحديث التنفيذ والصور والإرجاع والنقل المباشر والعمل دون اتصال. | المهام المسندة إليه وبياناتها الضرورية؛ دون تحصيل مالي. مسؤول الخدمات / تطبيق الإدارة | متابعة الخدمات الإضافية وملاحظات العميل وتنفيذ الخدمات المرتبطة بالحجز. | واجهة داخل تطبيق الإدارة للمهام المسندة فقط، دون صلاحيات مالية عامة. [SCOPE-044] 1.2 نظام الصلاحيات وسجل التدقيق [SCOPE-045] يفحص الخادم دور المستخدم وصلاحية العملية ونطاق السجل قبل السماح بالوصول. ويعتمد العميل قبل التنفيذ جدولًا يحدد صلاحيات العرض والإنشاء والتعديل والاعتماد والإلغاء والتصدير، والاستثناءات المالية والتشغيلية والصرف والاسترداد والدمج. وما لم تُمنح الصلاحية صراحة، يُرفض الطلب. وتشمل الاختبارات مستخدمين مختلفين يحملون الدور نفسه. وتشمل صلاحيات مستقلة لاعتماد حسابات القاعات وتغيير نوع الحساب أو تعليق اعتماده، ولإنشاء التخفيضات وتعديلها وتفعيلها وإيقافها؛ ولا تمنح صلاحية الحجز هذه الصلاحيات تلقائيًا. [SCOPE-046] يسجل النظام منفذ العملية ووقتها ومرجعها وسببها والقيم قبل التغيير وبعده. لا يمحو مستخدم التشغيل أثر عمله، وتضبط إدارة السجل والاحتفاظ به ضمن سياسة التشغيل. [SCOPE-047] 1.3 حدود التطبيقات والمسؤوليات [SCOPE-048] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. [SCOPE-049] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. يقدم العميل بيانات القاعات والأصناف والقياسات، وتطبق الشركة القواعد على الخادم. [SCOPE-050] القسم الثاني: التسجيل والهوية والرسائل [SCOPE-051] 2.1 طرق تسجيل الدخول [SCOPE-052] يدعم النظام الهاتف وOTP أو البريد ورمز تحقق ثم بيانات التواصل. بعد تعذر رمز الهاتف يطلب البريد المدخل في حينه. إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. [SCOPE-053] صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. [SCOPE-054] 2.2 الهوية الرقمية وتوحيد الحسابات [SCOPE-055] يحافظ كل حساب على معرف داخلي ثابت، حتى إذا تغير رقم الهاتف. ويبقى الهاتف وسيلة التعريف الأساسية للتواصل وتوحيد الحسابات، بعد توحيد تنسيقه للمقارنة. وعند ربط بريد برقم مسجل، يُتحقق من ملكية الرقم؛ فلا يكفي تشابه الاسم أو رقم غير موثق لدمج الحسابات. [SCOPE-056] يراعي الدمج ملكية الحساب ويحفظ المحافظ والحجوزات دون نقل غير مصرح أو تكرار. يتوقف تعارض الهوية للمراجعة، ويظل تغيير الهاتف وفقده إجراء تحقق مستقلًا. [SCOPE-057] 2.3 بيانات التواصل [SCOPE-058] يحفظ الحساب اسم التواصل ورقمه المعتمدين، وتظهر هذه البيانات في الطلبات والسندات والعقود وملفات PDF. وتحتفظ المستندات الصادرة ببياناتها وقت الإصدار، ولا تتغير تلقائيًا عند تعديل ملف العميل. ويُجرى أي تصحيح لمستند سابق بإجراء موثق. [SCOPE-059] 2.4 قنوات الرسائل والإشعارات [SCOPE-060] تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. [SCOPE-061] تشمل الرسائل تأكيدات الحجز والسداد وروابط الموافقة والسندات والعقود والتذكيرات والمهام. يسجل مرجع كل إرسال وحالته وأخطاؤه؛ لا يعكس فشله عملية صحيحة أو يسمح بتجاوز التحقق. وتشمل إشعارات حساب القاعة استلام طلب التسجيل وطلب استكمال البيانات وقرار الاعتماد أو الرفض أو التعليق، وفق القنوات المفعلة. [SCOPE-062] 2.5 روابط الموافقة والخصوصية [SCOPE-063] ترتبط الموافقة بالعميل والحجز ونسخة المحتوى والوقت والطريقة، مع ضبط صلاحية الرابط وإبطاله. لا يكفي رقم الحجز للوصول للعقد ولا يعتمد رابط سابق محتوى جديدًا. [SCOPE-064] يهدف هذا البند إلى حفظ سجل تقني يبين ما وافق عليه العميل وفق النص والسياسة المعتمدين، ولا يقرر الحجية القانونية للموافقة الإلكترونية. [SCOPE-065] 2.6 نوع الحساب وبيانات القاعة واعتماده [SCOPE-066] عند إدخال الاسم في تطبيق العميل، يختار المستخدم «عميل» أو «صاحب قاعة». ويظهر لصاحب القاعة ما يلزم لإدخال رقم تواصل القاعة وموقعها ورابط Google Maps وسعر الإيجار بالريال اليمني، ثم تُحفظ البيانات ضمن حسابه. ويظل توثيق الهاتف ونطاق الوصول مطلوبين. ولا يضيف حفظ السعر والرابط خدمة خرائط مدفوعة أو حجزًا لإيجار القاعة. [SCOPE-315] عند التسجيل باختيار «صاحب قاعة»، يحفظ الحساب بعد التحقق بحالة «بانتظار موافقة الإدارة»، ويرسل إلى التبويب المستقل المحدد في 2.7. لا يفعّل اختيار النوع حساب القاعة أو صلاحياته أو تخفيضاته تلقائيًا. أما حساب «عميل» فيستكمل مسار التسجيل والتحقق المعتاد دون موافقة حساب القاعة. [SCOPE-316] 2.7 تبويب اعتماد حسابات القاعات [SCOPE-317] تتضمن لوحة التحكم تبويبًا مستقلًا باسم «طلبات اعتماد حسابات القاعات»، يعرض اسم صاحب الحساب وبيانات التواصل والقاعة وتاريخ التسجيل وحالة الطلب. يتيح البحث والتصفية بحسب الحالة، وعرض البيانات ومراجعتها، والموافقة أو الرفض أو طلب استكمال البيانات من الإدارة المخولة فقط. [SCOPE-318] تظهر الحالات «بانتظار موافقة الإدارة»، و«بانتظار استكمال البيانات»، و«معتمد»، و«مرفوض»، و«معلّق». يوضح طلب الاستكمال البيانات المطلوبة، ويسجل سبب الرفض أو التعليق. تعود البيانات المستكملة إلى المراجعة ولا تعتمد تلقائيًا. تحفظ هوية متخذ القرار ووقته وسببه والحالة السابقة واللاحقة، ويخطر صاحب الحساب بالنتيجة وفق 2.4. [SCOPE-319] قبل الاعتماد، يقتصر وصول الحساب الجديد إلى وظائف متابعة طلبه واستكمال بياناته، ولا يسمح له بإنشاء حجوزات أو عمليات بصفة صاحب قاعة أو الاستفادة من مزايا القاعات. بعد الموافقة يفعّل الحساب ودوره، ويصبح مؤهلًا للتخفيضات المخصصة للقاعات وفق شروط 3.8، دون اعتماد أهلية مالية منفصل أو موافقة إدارية لكل تخفيض أو حجز. وتبقى موافقة العميل على العقد وشروط الدفع والتوفر واجبة. [SCOPE-320] يفحص الخادم حالة اعتماد الحساب عند العمليات، ولا يكفي إخفاء الأزرار في التطبيق. لا يغيّر المستخدم نوع حسابه مباشرة بعد التسجيل؛ يتولى التغيير موظف مخول، وأي تحويل من «عميل» إلى «صاحب قاعة» يمر بالتبويب نفسه. يوقف تعليق الاعتماد أو تغييره العمليات الجديدة بصفة القاعة وأهليتها الجديدة، دون إلغاء الحجوزات المعتمدة أو محو الأرصدة والاستحقاقات السابقة؛ تبقى متابعتها وتسويتها ضمن الصلاحيات ومساراتها المعتمدة. [SCOPE-067] القسم الثالث: الكتالوج والكوش والألوان والعروض والتخفيضات [SCOPE-068] 3.1 إنشاء الكوش ومكوناتها المشتركة [SCOPE-069] تُعرّف الكوشة كتجميعة مستقلة من أصناف مكتبة المكونات المشتركة، ولها اسم ووصف وسعر وأبعاد وتصنيف وغلاف محايد وصور عالية الدقة ومقاطع فيديو. تتضمن المكتبة صور الأصناف وأنواعها ووحدات قياسها، وقد تشمل المداكي والكراسي والخلفيات والستائر والإضاءات والورد. ويحدد لكل مكوّن داخل الكوشة النوع أو الخيار المطلوب وطريقة التركيب والكمية ووحدة القياس. يجوز استخدام الصنف نفسه في عدة كوش دون إنشاء مخزون جديد لكل تجميعة. [SCOPE-321] يُفصل بين النوع الفعلي وطريقة التركيب: إذا كانت الستارة نفسها تقبل التعليق المنسدل أو الملفوف، تسجل الطريقة داخل تجميعة الكوشة دون تكرار الصنف أو رصيده. وإذا كانت الأنواع قطعًا مختلفة فعليًا، ترتبط الأصناف والكميات بما هو موجود في المخزون. مثال: يختار المدير «ستارة مخمل بيج»، ويحدد طريقة تركيبها «منسدلة» والكمية قطعتين، ويستخدم الصنف نفسه في كوشة أخرى بطريقة «ملفوفة» دون مضاعفة المخزون. [SCOPE-322] المسار الأول — إنشاء من الصفر: يختار المدير «إضافة كوشة»، ويدخل بياناتها، ثم يختار المكونات من المكتبة المصورة ويحدد النوع أو طريقة التركيب والكمية لكل مكوّن، ويضيف الغلاف والوصف والسعر والصور المناسبة. [SCOPE-323] المسار الثاني — نسخ كوشة موجودة: ينشئ المدير نسخة كتجميعة مستقلة، ثم يحدّث الاسم والمكونات وخياراتها وكمياتها والسعر والصور. لا تعدل تغييرات النسخة الكوشة الأصلية، وتبقى المكونات مرتبطة بأصناف المكتبة المشتركة دون نسخ أرصدتها. ولا تعرض صور قاعة أو لون تحت بيانات مختلفة عند النسخ. [SCOPE-324] يحفظ المدير الكوشة «مسودة» لاستكمالها، أو «منشورة» لعرضها في تطبيق العميل بعد استكمال بيانات العرض. لا تظهر المسودة في الكتالوج العام. يقتصر بدء الإنشاء على المسارين المذكورين، وتستخدم قائمة مكونات الكوشة لتجهيز الصرف ضمن الصلاحيات. [SCOPE-325] عند اعتماد الحجز، يحفظ النظام نسخة المكونات وخياراتها وطرق تركيبها وكمياتها ووحدات قياسها وأسعار الحجز، فلا يغير تعديل الكوشة أو قالب صرفها حجوزات سابقة تلقائيًا. [SCOPE-070] 3.2 فحص توفر الأصناف المشتركة [SCOPE-071] يفحص النظام توفر الكوشة والأصناف المشتركة وكمياتها، بما فيها الورد المرتبط باللون المختار، خلال فترة الإشغال المعتمدة. تجمع الكميات المطلوبة للصنف أو مجموعة المخزون المشتركة عبر جميع الكوش والحجوزات والأقفال الفعالة المتداخلة؛ فلا تخصص الكمية نفسها لطلبين، ولا تنشأ سعة مستقلة لكل كوشة أو خيار لون يستهلك المخزون الفعلي نفسه. يفحص الخادم كل الموارد ويخصصها في عملية واحدة، أو يرفض الطلب كاملًا دون تخصيص جزئي. وتطبق القاعدة على قنوات الحجز الثلاث، وعند تعديل الموعد أو اللون أو المكونات أو الكميات. [SCOPE-072] تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، والمنطقة الزمنية وطريقة التحويل الهجري. يُحسب توفر اللون من الكمية التي تكفي تجميعة الكوشة خلال الفترة وفق 3.5، وليس من عدد يومي مستقل عن المخزون الفعلي. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. يعاد فحص كمية الورد مع باقي الموارد عند القفل والتأكيد، ويتحول القفل الصحيح إلى تخصيص دون حجز الكمية مرتين، وتتحرر الموارد عند انتهائه وفق 4.2. [SCOPE-073] 3.3 التوزيع المالي [SCOPE-074] لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. [SCOPE-075] 3.4 التصنيفات والواجهة [SCOPE-076] يدعم النظام تصنيفات مرنة، مثل عامة وجديدة وVIP، وتحدد الإدارة التبويب الافتراضي. وعند إخفاء نموذج أو أرشفته، تبقى بيانات حجوزاته محفوظة. ويعتمد تصميم الشاشات ضمن الوظائف المذكورة؛ فالموافقة على شكل الشاشة لا تضيف وظيفة لم تُحدد. [SCOPE-077] 3.5 الألوان والعروض [SCOPE-078] تحدد الإدارة خيارات الألوان المسموح بها لكل كوشة، وتربط كل لون ورد بالصنف أو مجموعة المخزون الفعلية التي يستهلكها والكمية اللازمة للكوشة. قد يكفي المتاح أكثر من كوشة بحسب كميات التجميعات؛ ولا يمنح تكرار اللون في عدة كوش رصيدًا إضافيًا، ولا يثبت إجمالي الورد وحده توفر لون لا تدعمه القطع الفعلية. لكل عرض مدة وشروط أهلية، وتحدد معدلات الولاء وقواعد الجمع قبل تشغيلها دون قيم مفترضة. وتدار التخفيضات المرتبطة بنوع المستخدم وشروط استحقاقها وقواعد جمعها من خلال 3.8، مع اشتراط اعتماد حساب القاعة وفق 2.7. [SCOPE-326] قبل اختيار الموعد يعرض التطبيق غلافًا محايدًا للكوشة، دون إظهار لون على أنه مضمون التوفر. بعد اختيار موعد المناسبة والقاعة، يعرض ألوان الورد المسموح بها لهذه الكوشة والمتوفرة بكمية تكفيها خلال فترة الإشغال فقط. إذا نفدت جميع ألوانها، تظهر الكوشة «غير متاحة» لتلك الفترة، ولا يسمح باختيار لون غير متوفر. [SCOPE-327] يعاد فحص التوفر عند تغيير الموعد أو الكوشة أو اللون أو الكمية، وعند إنشاء القفل أو تأكيد الحجز وفق 3.2 و4.2. لا يحجز التصفح وحده مخزونًا. يرتبط اختيار اللون بكمية الورد المحجوزة له في الفحص نفسه، ولا يعد وجود صورة أو ألبوم إثباتًا للتوفر. [SCOPE-079] 3.6 الخدمات الإضافية [SCOPE-080] يميز النظام المواد المستردة، كالإضاءات والكراسي والورد الصناعي، عن المستهلكات، كالورد الطبيعي واللوحات المطبوعة. ويتيح إدخال اسم العريسين المطلوب طباعته. ولكل خدمة كمياتها وسعرها وطريقة صرفها، ولا تدرج المستهلكات المصروفة ضمن المواد المنتظر إرجاعها. [SCOPE-081] 3.7 مطابقة المقاسات [SCOPE-082] تسجل أبعاد الكوشة ومسرح القاعة بوحدة واحدة، ويظهر تنبيه التجاوز أو نقص القياسات. لا يتحول التنبيه إلى منع إلزامي تلقائيًا. [SCOPE-328] 3.8 إدارة التخفيضات وربطها بنوع المستخدم [SCOPE-329] إدارة التخفيضات: تتضمن لوحة التحكم تبويبًا باسم «إدارة التخفيضات» لإنشاء القواعد وتعديلها وتفعيلها وإيقافها وأرشفتها بواسطة الإدارة المخولة. تعرض القائمة اسم التخفيض ونوعه وقيمته والفئة المستهدفة وفترة السريان والحالة. يحفظ سجل التغييرات، ولا تحذف قاعدة سبق استخدامها بما يمحو مرجعها في الحجوزات. [SCOPE-330] بيانات القاعدة: يحدد لكل تخفيض اسم، وطريقة احتساب «نسبة مئوية» أو «مبلغ ثابت بالريال اليمني»، والقيمة، والفئة المستهدفة «عملاء فقط» أو «أصحاب قاعات فقط» أو «كلا النوعين». يحدد نطاقه على سعر الكوشة أو الخدمات الإضافية أو كليهما، وتاريخ بداية السريان ونهايته، وما إذا كان السريان بحسب تاريخ الحجز أو تاريخ المناسبة، وشروط الأهلية والأولوية وإمكان الجمع. لا تفترض نسب أو مبالغ أو مدد غير معتمدة. [SCOPE-331] تحديد المستحق: يربط التخفيض بنوع الطرف المعتمد لأغراض التسعير في الحجز، مع الفصل بين العميل المستفيد وصاحب القاعة الشريك ومكان المناسبة وموظف الإدخال. لا تعني أهلية الحساب وجود تخفيض دائم؛ يطبق فقط تخفيض فعال مستوفٍ للشروط. وتكون قواعد تحديد النوع كما يأتي: [SCOPE-332] حالة الحجز | قاعدة التخفيض المستحقة العميل يحجز مباشرة لحسابه | تطبق تخفيضات العملاء أو التخفيضات العامة المستوفية للشروط. صاحب قاعة معتمد يحجز لعميل | تطبق تخفيضات أصحاب القاعات أو التخفيضات العامة المستوفية للشروط، مع ربط الحجز بالقاعة بصفة شريك؛ ولا يجمع خصم العميل معها تلقائيًا. موظف الإدارة ينشئ الحجز | تطبق قاعدة العميل المباشر أو صاحب القاعة المعتمد المرتبط بالحجز بصفة شريك، وليس نوع حساب موظف الإدارة. اختيار قاعة كمكان للمناسبة فقط | يبقى الحجز خاضعًا لقواعد العملاء؛ لا يمنح اختيار اسم القاعة تخفيضات القاعات دون ارتباط شراكة صحيح وحساب قاعة معتمد. [SCOPE-333] التحقق والاحتساب: يستمد الخادم نوع الحساب وحالة اعتماده وارتباط الشراكة من البيانات المحفوظة، ويختار القواعد المؤهلة ويحتسب قيمتها في قنوات الحجز الثلاث. لا يعتمد نوعًا أو مبلغ خصم مرسلًا من التطبيق وحده، ولا يقبل تخفيض القاعات لحساب غير معتمد. لا تتجاوز النسبة 100%، ولا تقبل قيمة سالبة، ولا يتجاوز مجموع التخفيضات قيمة البنود المشمولة. يعاد فحص الأهلية والسريان قبل اعتماد الحجز؛ وأي تغيير في السعر الموافق عليه يستدعي عرض النسخة الجديدة وموافقة العميل دون استبدال صامت. [SCOPE-334] الجمع والأولوية: تحدد الإدارة إمكان الجمع بين تخفيض نوع المستخدم والعروض وخصم نقاط الولاء، وترتيب الاحتساب وأساس كل خصم والأولوية عند تعدد القواعد المؤهلة وكيفية حسم تعادلها. لا يجمع النظام التخفيضات تلقائيًا دون قاعدة معتمدة، ولا يجمع خصم العملاء وخصم القاعات لمجرد وجود الطرفين في الحجز. تستكمل قواعد الجمع والأولوية قبل تفعيل الحالات المتداخلة، ولا تخمّن الشركة سياسة مالية بديلة. [SCOPE-335] العرض والحفظ: يعرض النظام السعر قبل التخفيض واسمه وقيمته والسعر بعده قبل موافقة العميل، ويحفظ مع الحجز والعقد مرجع التخفيض ونسخة شروطه ونوع الطرف المستحق وحالة اعتماد القاعة وأساس الاحتساب. لا يغيّر تعديل القاعدة أو إيقافها أو انتهاء مدتها أو تغيير نوع الحساب وحالته أسعار الحجوزات المعتمدة سابقًا. تعالج التغييرات من خلال 6.1 مع حفظ النسخ والتسويات. تظهر تفاصيل التخفيض ونوع الطرف في تقرير الحجوزات وفق الصلاحية. [SCOPE-336] الفصل المالي: التخفيض خفض لسعر الحجز، وليس عمولة القاعة أو نسبة استحقاقها. تبقى عمولة القاعة من صافي المدفوع بعد الخصم وفق 3.3 و8.3، ويظل استحقاق الفني من أساسه المحدد. تعالج آثار التعديل والاسترداد والولاء بالتسويات المرتبطة دون تكرار. لا يغيّر التخفيض قاعدة العربون الثابت في 5.2؛ وتحدد معالجة حالة انخفاض صافي الحجز عن مبلغ العربون قبل تفعيل تخفيض يؤدي إليها، دون افتراض مبلغ عربون جديد. [SCOPE-337] 3.9 ألبومات الكوش حسب القاعة ولون الورد [SCOPE-338] لكل كوشة ألبومات صور مرتبطة بالقاعة ولون الورد الظاهر. يحدد المدير القاعة واللون للألبوم، ويرفع عدة صور دفعة واحدة، وتعرض الصور بترتيب إضافتها، وتكون أول صورة مضافة هي الصورة الرئيسية للألبوم. لا يلزم إنشاء كوشة جديدة لكل قاعة أو لون، ولا تؤدي الصور إلى نسخ أصناف المخزون أو أرصدته. [SCOPE-339] بعد اختيار الموعد والقاعة ولون ورد متوفر، يعرض التطبيق أولًا صور الكوشة المطابقة للقاعة واللون معًا. عند غيابها يعرض صور الكوشة باللون نفسه في قاعة أخرى، مع اسم القاعة المصورة وبيان أنها قاعة أخرى. وعند غياب صور لهذا اللون، يعرض الغلاف المحايد مع صورة أو عينة توضح اللون المختار، دون الإيحاء بأنها صورة تنفيذ مطابق داخل القاعة المحددة. لا يستبدل النظام تلقائيًا صورة بلون مختلف عن اختيار العميل. [SCOPE-340] يظل ترتيب البدائل: القاعة واللون معًا، ثم اللون نفسه في قاعة أخرى، ثم الغلاف المحايد وعينة اللون. لا يغير غياب الصورة أو وجودها نتيجة توفر اللون أو ملاءمة المقاسات؛ يعالج تنبيه المقاسات وفق 3.7 بصورة مستقلة. وتظل الكوشة قابلة للعرض بالبديل المبيّن عندما يكون اللون متوفرًا، دون اشتراط صورة لكل تركيبة قاعة ولون. [SCOPE-083] القسم الرابع: قنوات الحجز وإنشاء الطلبات [SCOPE-084] 4.1 قنوات الحجز [SCOPE-085] ينشئ العميل وصاحب القاعة الحجز من تطبيق العميل نفسه، وينشئه موظف الإدارة من لوحة التحكم. وتعرض اللوحة الكوش المتاحة حسب التاريخ، مع اختيار العميل أو إنشاء حسابه وإدخال المناسبة. وتطبق قواعد التوفر والتسعير والتوثيق والصلاحيات نفسها على المسارات الثلاثة؛ فهي قنوات حجز وليست ثلاثة تطبيقات. ويشترط تفعيل حساب صاحب القاعة من الإدارة وفق 2.7، وتحدد فئة التخفيض بحسب الطرف المرتبط بالحجز وفق 3.8 لا بحسب موظف الإدخال. [SCOPE-086] 4.2 القفل المؤقت Soft Lock [SCOPE-087] عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. [SCOPE-088] القفل ليس تحصيلًا ولا يتجدد بفتح الشاشة. يعاد فحص التوفر بعد انتهائه، ولا يحجز التصفح وحده موارد. [SCOPE-089] 4.3 أدوات التصفح [SCOPE-090] يوفر النظام تقويمًا هجريًا وميلاديًا ومرشحات ومعاينة ألوان ومفضلة ومشاركة عبر واتساب، باستخدام إعدادات الوقت والتحويل، دون كشف حجز خاص عند المشاركة. [SCOPE-091] 4.4 مسار الحجز والعقد [SCOPE-092] يعرض التطبيق الكوشة المختارة ولونها ولون الكرسي والورد، واسم القاعة واسم الشخص، والإجمالي والمدفوع والمتبقي والخدمات الإضافية المختارة. تحفظ هذه البيانات مع نسخة العقد والموافقة، ولا تتغير النسخة السابقة بصمت عند تعديل الحساب أو الحجز. يحتسب الخادم السعر والخصم والعربون الثابت من الإعدادات ولا يعتمد قيم التطبيق وحدها. ويعرض السعر قبل التخفيض واسمه وقيمته والسعر بعده، ويحفظ فئة الاستحقاق ونسخة القاعدة وفق 3.8. [SCOPE-093] يحفظ النظام نسخة العقد ومحتواه وأسعاره ومكوناته والسياسة المرتبطة به. وفي حجوزات الإدارة والقاعة، يرسل للعميل رابط موافقة أو OTP، ويسجل موافقته على النسخة المحددة. ولا يحل تأكيد الشريك أو المنسق محل موافقة العميل. ويظل الطلب غير مؤكد حتى اكتمال الموافقة والتحقق من العربون وتخصيص الموارد. [SCOPE-094] عند تغيير محتوى جوهري، تصدر نسخة ويطلب اعتمادها مع حفظ السابقة. تظهر أسباب الانتظار: موافقة العميل أو الدفع أو مراجعة الحوالة. [SCOPE-095] 4.5 الحجز القريب من الموعد [SCOPE-096] عند إنشاء حجز قبل المناسبة بأقل من يومين، تُحال المراجعة المالية وإسناد المهمة فورًا إلى المسؤولين. وتطبق شروط التأكيد والتركيب نفسها؛ فلا يمنح قرب الموعد استثناءً ماليًا أو تشغيليًا تلقائيًا. [SCOPE-097] حالات الحجز والدفع والعهد مستقلة؛ لا يحيي الدفع المتأخر حجزًا انتهى ولا يغلق التركيب مديونية أو عهدة. [SCOPE-098] 4.6 أوقات استقبال الحجوزات [SCOPE-099] خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة المعتمد حسابه، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. [SCOPE-100] القسم الخامس: العربون وتأكيد الحجز والمحفظة [SCOPE-101] 5.1 مراجعة الحوالة والتأكيد الآلي [SCOPE-102] يتأكد حجز العميل وصاحب القاعة المعتمد حسابه تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. يدعم ذلك الدفع الكامل من الرصيد الداخلي المتاح. موافقة الإدارة على حساب القاعة وفق 2.7 إجراء لتفعيل الحساب، وليست موافقة إضافية على كل حجز أو دفع بالمحفظة. [SCOPE-103] يقدم إشعار الحوالة خلال الدوام ويبدأ تدقيق الإدارة بمهلة مستقلة عن الرفع. تضبط مهلة المراجعة والرفض والاستكمال والتصعيد دون تمديد مفتوح أو إثبات قبض من الصورة وحدها. [SCOPE-104] لا تتجاوز المراجعة قفل طلب الإدارة البالغ 10 دقائق دون تأكيد العربون؛ لا يمدده الحفظ. تظل متابعة المال المجهول أو المتأخر مستقلة عن الموارد المحررة. [SCOPE-105] 5.2 قواعد العربون [SCOPE-106] تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. [SCOPE-107] 5.3 الدفعات اللاحقة [SCOPE-108] يمكن سداد المتبقي أو الدفعات اللاحقة من المحفظة كليًا أو جزئيًا. ويُسجل كل تحصيل بمرجعه وحجزه ومصدره ومبلغه بالريال اليمني YER، ويُحسب المتبقي من الحركات المعتمدة. أما المبلغ الزائد فيحال إلى التسوية، ولا يزيد سعر الخدمة تلقائيًا، ولا يُجرى تحويل عملات ضمني. [SCOPE-109] 5.4 قنوات التحصيل [SCOPE-110] تشمل القنوات الحوالة خلال الدوام والمحفظة الإلكترونية الواحدة الحالية والمحفظة الداخلية والنقد لدى الإدارة بسند قبض. لا تحصيل للفني ولا يتكرر اعتماد الحوالة عند المطابقة. [SCOPE-111] 5.5 إيقاف التركيب عند التعثر المالي [SCOPE-112] تراجع الإدارة السداد قبل المناسبة بيومين أو فور الحجز الأقرب. يشترط السداد أو الاستثناء المالي الخاص بالحجز، دون اشتراط اتصال عند بدء الفني؛ تستخدم المهمة المحفوظة وتراجع التغيرات عند المزامنة. [SCOPE-113] 5.6 الدفع المتأخر بعد إلغاء الطلب [SCOPE-114] يسجل كل دفع موثق ولو بعد انتهاء الطلب في تسوية مرتبطة بالعميل وأصل التحصيل. لا يحيي الحجز تلقائيًا أو يسحب موردًا لغيره، ولا ينشأ دفع جديد قبل التحقق من العملية المجهولة. [SCOPE-115] القسم السادس: التعديل والإلغاء وإدارة الأرصدة [SCOPE-116] 6.1 تعديل الحجز [SCOPE-117] تحتاج تعديلات الحجز إلى موافقة الإدارة، ولا تُفرض عليها رسوم. وقبل الاعتماد، يعرض النظام أثر الطلب على الموعد والموارد وسعر الخدمة والعربون والمتبقي والعقد والاستحقاقات، مع حفظ القيم السابقة وسبب التعديل ومعتمده. ويظل فرق سعر الخدمة منفصلًا عن رسوم التعديل غير المقررة. [SCOPE-118] عند نقل الحجز إلى موعد محدد، يفحص النظام توفر الكوشة ومكوناتها وألوانها. ثم يخصص الموعد الجديد ويحرر القديم في عملية واحدة. وإذا فشل النقل، يبقى الحجز القديم وموارده. ولا يسمح التعديل بتجاوز التوفر أو إنشاء كميات سالبة. [SCOPE-119] عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. [SCOPE-120] إذا زادت قيمة الحجز، يعاد حساب المستحق ويُطلب الفرق وفق المدفوع الفعلي. وإذا انخفضت، يُخفض المبلغ غير المدفوع أولًا. ولا ينشأ رصيد قابل للإنفاق إلا مقابل فائض محصل يستحقه العميل بعد التسوية، دون احتسابه في المحفظة والحجز في الوقت نفسه. [SCOPE-121] مثال توضيحي بالريال اليمني، وليس تسعيرًا للخدمة: إذا كانت قيمة الحجز 100,000 والمدفوع 20,000، ثم انخفضت القيمة إلى 80,000، يصبح المتبقي 60,000 دون رصيد جديد في المحفظة. وإذا كان المدفوع 90,000، يكون الفائض 10,000 ويُسوّى مرة واحدة. ولا تُفرض رسوم تعديل أو إلغاء في المثالين. [SCOPE-122] يعاد حساب الاستحقاقات من تخصيص الحجز أو افتراضي بطاقة الطرف وأساسه. يعالج المصروف سابقًا بتسوية، ويعاد اعتماد العقد عند تغيير جوهري. [SCOPE-123] 6.2 إلغاء الحجز [SCOPE-124] في الإلغاء المباشر، تعتمد الإدارة الإلغاء والمبلغ المستحق للرد دون رسوم إلغاء. ثم تُحرر الموارد ويُرد المبلغ إلى المحفظة أو بسند صرف أو عبر المزود بحسب المسار. ويُفصل سعر الخدمة عن المحصل والقابل للاسترداد، فلا يُمنح رصيد عن مبلغ لم يُحصّل ولا يُضاف خصم بسبب الإلغاء. [SCOPE-125] في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. [SCOPE-126] 6.3 ضابط موحد للاسترداد [SCOPE-127] للاسترداد أصل وسقف مشترك بين المحفظة والصرف والمزود. يميز المتاح للحجز عن المؤهل نقديًا، ولا يصرف المستخدم في حجز مرة أخرى. يبقى الرد الجاري محجوزًا حتى معرفة نتيجته، وتصحيحه بعكس مرتبط لا حذف. [SCOPE-128] القسم السابع: العمليات الميدانية والإرجاع [SCOPE-129] 7.1 تقويم الإدارة [SCOPE-130] تعرض لوحة الإدارة تقويمًا هجريًا وميلاديًا يمكن تصفيته حسب الحجز والمهمة، ويشمل الموعد والأوقات والفني والخدمات والسداد والموارد بحسب الصلاحية. ولا يؤدي تغيير حالة المهمة وحده إلى تعديل موعد الحجز أو قيمته المالية. [SCOPE-131] 7.2 اشتراط الإرجاع [SCOPE-132] يرتبط الإرجاع بالأصناف اللازمة للتنفيذ التالي: إرجاع مطابق أو نقل مباشر أو بديل فعلي من الاحتياطي. انتهاء المناسبة ليس إرجاعًا. عند الانقطاع تستخدم آخر بيانات المهمة وتراجع التعارضات عند المزامنة. [SCOPE-133] 7.3 النقل المباشر Cross-Docking [SCOPE-134] تُطابق الأصناف ميدانيًا بين العهدتين، وتُسجل الكميات السليمة والناقصة والتالفة وهوية المسلم والمستلم واعتماد المطابقة. ثم تُغلق عهدة المنقول في الحجز السابق وتُفتح في التالي، دون زيادة رصيد المخزن بكمية لم تعد إليه أو احتسابها مرتين. [SCOPE-135] تُصرف المستهلكات الجديدة اللازمة للحجز التالي، وتُستبعد القطع التالفة أو المفقودة من الكميات المنقولة بوصفها سليمة. ويُعوض عجز المستردات من الاحتياطي وفق 7.4، أو يُعدل التنفيذ بموافقة. وتبقى العهدة مفتوحة بقدر ما فيها من فروقات لم تُسوَّ أو لم تُحدد مسؤوليتها. [SCOPE-136] 7.4 الاستثناء التشغيلي [SCOPE-137] يمكن لمدير العمليات السماح بتركيب الحجز التالي بعد تعويض القطع من احتياطي متاح فعلًا. ويُسجل السبب والبدائل وكمياتها والحجز والاعتماد. ولا يضيف الاستثناء مخزونًا غير موجود، ولا يغلق عهدة معلقة أو يتجاوز التعثر المالي؛ إذ يحتاج الشرط المالي إلى معالجة مستقلة. [SCOPE-138] 7.5 واجهة الفني في تطبيق الإدارة والعمل دون اتصال [SCOPE-139] يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. تسند المهمة قبل المناسبة بيومين أو فور اعتماد الحجز القريب، ويرفع الفني حتى ثلاث صور ليلة المناسبة. [SCOPE-140] يحفظ التطبيق الصور وقوائم الفحص والملاحظات والعمليات المسموح بها على الجهاز، مع معرف فريد وإصدار المهمة ووقت التسجيل. وعند عودة الاتصال، يفحص الخادم الصلاحية والحالة والتعارض قبل المزامنة دون تكرار. ويظهر للمستخدم ما قُبل أو رُفض أو بقي معلقًا وسبب الرفض. ولا تُحذف الأدلة المحلية قبل تأكيد حفظها وفق سياسة الاحتفاظ. [SCOPE-141] لا تُستخدم نسخة قديمة لإعادة تفعيل مهمة ملغاة أو إعادة إسنادها. ويُحال التعارض إلى المسؤول عن مراجعته، مع حفظ ما سجله الفني دون اعتماده تلقائيًا كحركة صحيحة. [SCOPE-142] لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. [SCOPE-143] القسم الثامن: المحاسبة التشغيلية والشراكات [SCOPE-144] 8.1 النطاق المحاسبي [SCOPE-145] تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. تشمل الحسابات محافظ العملاء والصندوق والبنوك والسندات والاستحقاقات، ويضبط المحاسب الدقة وأمثلة القيود. [SCOPE-146] يرتبط كل سند وحركة بالأصل والمستخدم والتاريخ والاعتماد. ولا تُحذف حركة معتمدة أو يُكتب فوقها؛ بل يُصحح أثرها بعكس أو تسوية موثقة. وإعادة إرسال الحجز أو الدفع لا تعني ترحيله مرتين. ولا يضيف هذا النطاق نظام موارد مؤسسية شاملًا أو تكاملًا ضريبيًا غير مسمى؛ فأي امتداد يحتاج إلى تحديد واعتماد قبل تقديره. [SCOPE-147] 8.2 الأرصدة المعلقة والمستحقة [SCOPE-148] تسجل استحقاقات الفني والخدمات معلقة بعد اكتمال سداد الكوشة، وتتاح عند نقطة الإنجاز المحددة للطرف، لا عند أول حدث للجميع. تؤخذ القيمة المخصصة للحجز وإلا افتراضي بطاقة الطرف. [SCOPE-149] تُحدد جهة إثبات الإنجاز وجهة اعتماد الصرف، وكيف يؤثر تعديل الحجز أو إلغاؤه أو التلف قبل الصرف وبعده. ويعرض النظام المعلق والمستحق والمصروف والتسويات بصورة منفصلة. وإذا زادت مطالبة التلف على الرصيد القابل للخصم، يبقى الفرق مطالبة وفق السياسة، دون إنشاء رصيد غير مستحق أو إسقاط حق أو دين. [SCOPE-150] 8.3 شراكة القاعات [SCOPE-151] عمولة القاعة من صافي المدفوع بعد الخصم، بقيمة الطلب المخصصة إن وجدت وإلا افتراضي الطرف. ترتبط بالحجز والتحصيل والحساب، ويسوى المصروف السابق دون حذف. ولا تعد العمولة تخفيضًا لصاحب القاعة؛ يحدد التخفيض المستحق بصورة مستقلة وفق 3.8، مع اعتماد حساب الشريك وفق 2.7. [SCOPE-152] 8.4 نقاط الولاء [SCOPE-153] تمنح النقاط للحجوزات المكتملة وتستبدل بخصم لا نقد. تحدد معدلاتها ومدتها والجمع مع العروض وأثر التعديل قبل التطبيق؛ لم تذكر قيم عددية. يمنع تكرار منحها بإعادة الحدث. وتشمل قواعد الجمع علاقتها بتخفيض نوع المستخدم وفق 3.8؛ ولا يغيّر اعتماد حساب القاعة معدلات الولاء أو يمنح نقاطًا تلقائيًا. [SCOPE-154] 8.5 الفصل بين المحافظ والأرصدة [SCOPE-155] المحفظة الداخلية تختلف عن وسيلة الدفع الخارجية وحساب المؤسسة لدى المزود. يظهر المتاح للحجز والمؤهل للسحب والمحجوز والمديونية منفصلة. رصيد الإلغاء قبل البديل متاح للحجز فقط. [SCOPE-156] لا يُضاف رصيد داخلي إلا بمصدر مبلغ مثبت وقيد معتمد، ولا يُنفق الرصيد المتاح نفسه مرتين عند التزامن. وتُوثق الإضافات والخصومات والحركات العكسية وروابطها بالحجز أو الاسترداد. ولا يشمل الإصدار تحويل الأرصدة بين العملاء أو شحنًا عامًا دون مصدر وسياسة معتمدين. [SCOPE-157] توضح الأمثلة الحسابية كيفية منع تكرار الأثر المالي، ولا تحل محل قواعد المحاسبة المعتمدة. ويعتمد المسؤول المالي أمثلة قيود لكل مسار قبل اختبار القبول. [SCOPE-158] 8.6 التقارير [SCOPE-159] التقرير | المحتوى كشف الحساب | الحركات والرصيد بحسب الحساب والفترة. القيود اليومية | القيود وحساباتها ومراجعها ومبالغها. المصروفات اليومية | المصروفات بحسب اليوم والحساب. طرق الدفع | التحصيلات والتسويات بحسب وسيلة الدفع. الإيرادات والربح والخسارة | الإيرادات والمصروفات والنتيجة للفترة. الحجوزات | الحجوزات ومرشحات التاريخ والحالة والعميل والقاعة، ونوع الطرف المستحق للتخفيض ومرجعه وقيمته والسعر قبل التخفيض وبعده. قاعات الأفراح وحساباتها | حجوزات القاعات وحساباتها المالية. الفنيون ومسؤولو الخدمات | المهام والحسابات المالية لكل طرف. الكوش ومرات الحجز | الكوش والعملاء والقاعات المرتبطة بالحجوزات وعددها. مبالغ الإلغاء المستردة | الحجز الملغى والعربون والبديل والرصيد المستخدم والمتبقي وأهلية الصرف. [SCOPE-161] القسم التاسع: المخازن والصرف والتوالف [SCOPE-162] 9.1 العمليات المخزنية [SCOPE-163] يدعم المخزون التوريد والصرف والجرد والإرجاع والعهد. تُجلب مكونات القالب ويختار الفني أدوات حجزه المسحوبة ضمن الصلاحية والتوفر، وتربط الحركة بالمهمة والعهدة دون تغيير السعر. يشمل ذلك مخزون الورد الفعلي المشترك وخيارات الألوان المرتبطة به، وتستند الكميات المطلوبة إلى نسخة مكونات الحجز وطريقة تركيبها؛ ولا يضاعف إنشاء كوشة أو نسخها رصيد أي صنف. [SCOPE-164] يعرض النظام الموجود فعليًا والمتاح والمحجوز والمصروف وقيد النقل وتحت الفحص والتالف. وهذه حالات مشتقة من الحركات المخزنية، لا أرصدة مستقلة تُجمع فتضاعف الكمية. ولا يقبل إرجاع ما يزيد على المصروف أو المنقول للعهدة، أو اعتبار المستهلكات مواد مستردة دون تصحيح معتمد. [SCOPE-165] قبل زيادة مكونات الصرف أو استبدالها، يفحص النظام التوفر وصلاحية المستخدم ويسجل السبب. وإذا تغيرت الخدمة أو السعر أو العقد، ينتقل الطلب إلى مسار تعديل الحجز، لا إلى تعديل مخزني غير ظاهر. ولا يُعتمد صرف نهائي لكميات غير موجودة. [SCOPE-166] يؤشر الفني إرجاع الأدوات مع كمياتها وحالتها، وتبقى الفروق ظاهرة رغم علامة إرجاع الجميع. تفحص المرتجعات قبل الإتاحة، ويسجل فرق الجرد بحركة معتمدة لا تعديل مباشر للإجمالي. [SCOPE-167] 9.2 تصنيف التوالف ومسؤوليتها [SCOPE-168] الجهة المحملة | الأثر المطلوب | شرط الاعتماد العميل | إنشاء مطالبة في حساب العميل بقيمة التلف المعتمدة. | ربطها بالحجز والصنف والكمية والدليل؛ لا تعد المطالبة تحصيلًا. الفني | خصم معتمد من رصيد الفني المستحق وفق السياسة التعاقدية. | إثبات المسؤولية والقيمة؛ يبقى ما يزيد على الرصيد مطالبة وفق السياسة. المؤسسة | إثبات القيمة ضمن مصروفات التوالف التشغيلية. | تصنيفها إهلاكًا طبيعيًا واعتمادها من المخول. [SCOPE-170] لكل تلف أدلة وقيمة وجهة تحمل واعتماد. لا يتجاوز مجموع الأنصبة قيمته ولا تعتبر القطعة صالحة تلقائيًا باختلاف جهة التكلفة. [SCOPE-171] 9.3 ضوابط الإغلاق والتتبع [SCOPE-172] لا يُسقط إغلاق الحجز تشغيليًا مطالبة مالية أو عهدة متبقية. ويمكن تتبع الصنف من المخزن إلى الحجز ثم الإرجاع أو النقل المباشر أو التلف، مع بقاء المراجع محفوظة بعد أرشفة القالب أو المستخدم أو الحجز. [SCOPE-173] تُنفذ حالات المخزون اللازمة للقواعد المذكورة. أما إدارة الإصلاحات المتقدمة أو تتبع الأجهزة بأرقام تسلسلية أو المشتريات المتكاملة، فتحتاج إلى تعريف واعتماد مستقلين، ولا تُضاف تلقائيًا إلى النطاق. [SCOPE-174] القسم العاشر: قواعد النظام وحالاته [SCOPE-175] تلخص القواعد التالية ما تشترك فيه الواجهات، وتوضح انتقال الحالات دون خلط المال بالموارد. [SCOPE-176] المحور | القاعدة القنوات | العميل والقاعة والإدارة تستخدم قواعد الخادم نفسها. الهوية | هاتف موثق وربط أو دمج دون نقل غير مصرح أو تكرار للأرصدة. العقد | موافقة على نسخة ثابتة؛ تعديل جوهري يستدعي نسخة وموافقة جديدتين. التوفر | الكوشة والمكونات المشتركة وكمياتها، بما فيها الورد للون المختار، تحجز معًا للفترة في عملية واحدة؛ لا رصيد مستقل لكل كوشة أو لون يستهلك المورد نفسه. العربون | دفعة واحدة من وسيلة واحدة، دون تقسيم. المهل | خارج الدوام لا طلب مراجعة؛ قفل الإدارة عشر دقائق حتى تأكيد العربون. الدفع المتأخر | تسجيل المال الموثق دون إعادة حجز مورد أصبح غير متاح. المحفظة | رصيد الإلغاء متاح للحجز؛ السحب بعد البديل من المتبقي غير المستخدم. الاسترداد | سقف ومرجع موحدان عبر المحفظة والصرف والمزود. التركيب | سداد أو استثناء مالي؛ وإرجاع أو نقل مطابق أو بديل متاح. النقل المباشر | إغلاق وفتح العهد دون تكرار الكمية أو إدخالها وهميًا للمخزن. دون اتصال | يبدأ الفني دون اتصال من المهمة المحفوظة، وتزامن الحالات والصور لاحقًا. الاستحقاقات | معلق ثم مستحق ثم مصروف، مع تسويات لا تمحو الأثر. التوالف | جهة تحمل وأدلة وقيمة واعتماد، دون ازدواج المطالبة. الواجهات | خادم مركزي؛ توثيق لجميع وظائف التطبيقات ولوحة الإدارة. الدفع الخارجي | محفظة واحدة؛ تأكيد موثق آلي للعميل وصاحب القاعة. الملكية | بيانات العميل مستقلة عن شراء الشفرة؛ تسليم المصدر بمقابل حسب الاتفاق. حدود التنفيذ | لا توسع من طرف واحد؛ عدم المطابقة عيب وليس ميزة جديدة. اعتماد القاعات | تبويب مستقل لاعتماد الحساب؛ لا صلاحيات قاعة أو تخفيضاتها قبل الموافقة، ولا مراجعة جديدة لكل حجز بالمحفظة. التخفيضات | حسب نوع الطرف في الحجز: عميل أو صاحب قاعة معتمد أو كلاهما؛ احتساب على الخادم وحفظ القاعدة وفصلها عن العمولة. إنشاء الكوش وعرضها | إنشاء من الصفر أو نسخ تجميعة مستقلة، ثم مسودة أو نشر؛ ألوان متوفرة للفترة وألبومات القاعة واللون وفق ترتيب البدائل في 3.9، دون اشتقاق التوفر من الصور. [SCOPE-178] 10.1 انتقالات الحجز [SCOPE-179] الانتقال التحليلي | شرط التنفيذ | الأثر المحمي مسودة إلى طلب مؤقت | اكتمال البيانات وتخصيص جميع الموارد. | بدء مهلة الطلب؛ لا تأكيد ولا تحصيل مفترض. طلب مؤقت إلى مراجعة حوالة | رفع إشعار مستوفٍ خلال المهلة. | وقف مهلة الرفع وبدء مهلة تدقيق؛ لا قيد قبض للصورة. مراجعة إلى رفض أو استكمال | قرار محاسب بسبب موثق. | تطبق مهلة المراجعة والاستكمال المضبوطة دون تجاوز قفل الإدارة دون سداد. مؤقت / مراجعة إلى مؤكد | موافقة العميل المطلوبة وعربون موثق وتوفر؛ المحافظ تؤكد آليًا للعميل وصاحب القاعة. | تأكيد مرة واحدة؛ لا يكفي نجاح دفع وحده. مؤكد إلى تعديل معتمد | موافقة إدارة وتوفر ومال وعقد مستوفٍ. | تخصيص جديد وتحرير قديم ذريًا؛ عند الفشل يبقى القديم. حجز إلى موعد مفتوح | اعتماد سياسة التاريخ المفتوح. | تحرير الموارد وتحويل المحصل المستحق مرة واحدة. طلب قائم إلى طلب تغيير معلق | تقديم طلب من مخول دون قرار نهائي. | يبقى الأثر السابق حتى اعتماد المسار؛ لا تحرير تلقائي. طلب إلى انتهاء / إلغاء مباشر | شرط انتهاء صحيح أو إلغاء معتمد. | تحرير الموارد مع حفظ الحجز والمال والمطالبات. حجز إلى إلغاء بانتظار بديل | اعتماد المسار وقيمته وشروطه. | الموارد متاحة؛ الرصيد متاح للحجز، والسحب النقدي بعد حجز نفس الكوشة لمستأجر آخر في أي موعد. نسخة عقد معتمدة إلى نسخة جديدة | تعديل جوهري في المحتوى الذي وافق عليه العميل. | حفظ السابقة وطلب موافقة جديدة وإبطال اعتماد الجديدة بالرابط القديم. طلب مراجعة خارج الدوام | اختيار حوالة أو مسار إداري. | لا طلب ولا قفل ولا تخصيص؛ تظهر رسالة الدوام. قفل الإدارة إلى انتهاء | مرور 10 دقائق دون تأكيد العربون. | تحرير الموارد رغم حفظ الطلب. [SCOPE-181] 10.2 الدفع والتحقق [SCOPE-182] الحالة / الحدث | شرط اعتمادها | أثرها Created | طلب صحيح بمبلغ وعملة ووسيلة. | حفظ المرجع؛ لا تحصيل. Pending / Processing | انتظار أو معالجة أو نتيجة غير معلومة. | متابعة المرجع؛ لا افتراض فشل أو نجاح ولا طلب جديد مكرر. Successful | تحقق موثوق من المصدر والمبلغ والعملة والتاجر والبيئة. | قيد وتخصيص مرة واحدة؛ إعادة فحص شروط تأكيد الحجز. Failed / Cancelled / Expired | نتيجة موثوقة للعملية نفسها. | لا تحصيل لهذه النتيجة؛ يبقى أي تعارض متأخر للمطابقة. Refunded / Partially Refunded | إثبات رد كامل أو جزئي مرتبط بالأصل. | تحديث المسوى والمتبقي والسقف المشترك مرة واحدة. Reversed | عكس موثق من المزود. | أثر عكسي مرتبط لا حذف للأصل؛ تسوية الأطراف وفق السياسة. إشعار مكرر أو أقدم | حدث معروف بلا تسوية جديدة موثقة. | لا قيد جديد ولا رجوع خاطئ للحالة. نجاح بعد انتهاء الحجز | أصل صحيح لكن الموارد ليست صالحة للتأكيد. | إثبات المال وتسوية مستقلة دون إعادة حجز مورد غير متاح. [SCOPE-184] 10.3 الاسترداد والتنفيذ والعهد [SCOPE-185] الانتقال | الشرط والنتيجة استحقاق إلى طلب رد جارٍ | أهلية نقدية ومبلغ متبقٍ غير مستخدم وغير محجوز؛ يحجز الرد من الأصل نفسه. رد جارٍ إلى نجاح | إثبات مزود أو صرف أو محفظة؛ يقيد المسوى مرة واحدة. رد جارٍ إلى فشل مثبت | يتحرر المحجوز بعد التحقق؛ المجهول لا يعامل كفشل. مهمة مسندة إلى قيد التركيب | مهمة محفوظة وسداد أو استثناء وعهد أو بديل صحيح بحسب آخر مزامنة، دون اشتراط اتصال لحظة البدء. تركيب إلى مكتمل | إثبات إنجاز معتمد؛ لا إغلاق تلقائي لعهدة أو مديونية. مصروف إلى إرجاع تحت الفحص | كمية لا تتجاوز العهدة؛ يبقى المتبقي؛ السليم يتاح بعد الفحص المعتمد. عهدة أصل إلى عهدة تالية | نقل مباشر مطابق؛ لا إدخال وهمي للمخزن ولا بقاء الكمية بالعهدتين. معلق إلى مستحق إلى مصروف | سداد كامل ثم نقطة إنجاز الطرف ثم اعتماد الصرف؛ التسويات تحفظ أثر الأصل. تحقق البديل | نفس الكوشة لمستأجر آخر بعربون مؤكد في أي موعد؛ إشعار وأهلية نقدية دون رصيد جديد. إنفاق رصيد الإلغاء | يخصم المستخدم في حجز آخر من المتبقي الممكن صرفه لاحقًا. [SCOPE-187] القسم الحادي عشر: معمارية واجهات الربط API [SCOPE-188] 11.1 المعمارية المركزية المعتمدة [SCOPE-189] يحفظ الخادم المركزي البيانات ويطبق منطق التشغيل والمحاسبة، ويتصل به تطبيق العميل وتطبيق الإدارة ولوحة التحكم عبر API. ولا تتصل الواجهات بقاعدة البيانات مباشرة، ولا تعتمد قواعد التوفر والسعر والصلاحية على التحقق داخل الواجهة وحدها. [SCOPE-190] 11.2 نطاق الواجهات [SCOPE-191] تغطي واجهات الربط جميع وظائف التطبيقات ولوحة الإدارة الواردة في الوثيقة. ويتيح التصميم ربط أنظمة أخرى مستقبلًا، لكن تنفيذها أو ربط طرف ثالث غير مسمى لا يدخل تلقائيًا في النطاق. ويوثق كل مسار استخدام بواجهاته وصلاحياته ونتيجته المطلوبة. [SCOPE-192] 11.3 المعايير التقنية [SCOPE-193] تستخدم الواجهات RESTful API وJSON وHTTPS/TLS، مع إصدارات واضحة مثل /api/v1/ وصيغة موحدة للنتائج والأخطاء. وتدعم تقسيم النتائج إلى صفحات والبحث والتصفية والترتيب عند الحاجة. ويفحص الخادم المدخلات ويطبق حدود الطلبات، بينما توضح رسائل الخطأ ما يمكن للمستخدم معالجته دون كشف أسرار أو تفاصيل داخلية حساسة. [SCOPE-194] تُنفذ التغييرات المترابطة على الموارد والأرصدة كوحدة واحدة، وتستخدم العمليات الحساسة مفاتيح لمنع التكرار. فلا تنشئ إعادة الطلب أثرًا جديدًا، ويُرفض استخدام المفتاح نفسه مع بيانات مختلفة. ويحدد التصميم نطاق المفتاح ومدة الاحتفاظ به وربطه بالمستخدم والعملية، ثم يُختبر تحت التزامن. [SCOPE-195] 11.4 المصادقة والصلاحيات [SCOPE-196] صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. يفحص الخادم الجلسة والصلاحية ونطاق السجل، وتفصل الأسرار بين الاختبار والإنتاج. [SCOPE-197] تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. تحفظ المرفقات في موضع غير قابل للتنفيذ وتضبط الحماية والاحتفاظ. [SCOPE-198] 11.5 مجموعات الواجهات المطلوبة [SCOPE-199] المجموعات | الوظائف Authentication / Users | التسجيل والدخول والتحقق والجلسات وإدارة المستخدمين، وطلبات اعتماد حسابات القاعات وحالاتها وضبط تغيير نوع الحساب. Catalog / Availability / Bookings | الكتالوج والتوفر وإنشاء الحجوزات وتعديلها وإلغاؤها، وإدارة التخفيضات وأهليتها بحسب النوع واحتسابها وحفظ نسخها. ويشمل إنشاء الكوش من الصفر ونسخها، ومكتبة المكونات وطرق تركيبها وكمياتها وحالة المسودة والنشر، وألبومات القاعة واللون ورفع صورها وترتيبها، وفحص الورد المشترك وتخصيصه مع الموارد. Payments / Wallet / Contracts | الدفع والمحفظة والعقود والإصدارات والموافقات. Partners / Technicians / Services | الشركاء والعمولات والمهام الميدانية والخدمات الإضافية. Inventory / Notifications | المخزون والعهد والصرف والإرجاع والإشعارات. Reports / Admin / Audit | التقارير والإدارة والتدقيق وفق الصلاحيات، وتوثيق قرارات اعتماد حسابات القاعات وتغييرات التخفيضات. [SCOPE-201] التوثيق والمزامنة والتشغيل [SCOPE-202] 11.6 التوثيق وبيئة الاختبار [SCOPE-203] تسلم الشركة توثيق OpenAPI/Swagger بأسماء الواجهات وعناوينها وطرق HTTP ومدخلاتها ومخرجاتها، والمصادقة والصلاحيات والأخطاء وأمثلة الاستدعاء. ويشمل التوثيق العمليات غير المتزامنة ومفاتيح منع التكرار. وتوفر بيئة Sandbox/Staging مستقلة لا تستخدم أسرار الإنتاج أو تنفذ تحصيلًا حقيقيًا دون تصريح واضح. [SCOPE-204] 11.7 معالجة الأخطاء وإعادة المحاولة [SCOPE-205] يعالج النظام انقطاع الاتصال وإعادة المحاولة والطلبات المؤجلة دون إنشاء حجز أو قيد مالي أو حركة مخزنية مرتين. ويحفظ نتيجة العملية أو مرجع متابعتها قبل إبلاغ التطبيق بالنجاح. وإذا بقيت النتيجة غير معلومة، يظهر أنها «قيد التحقق» بدل افتراض النجاح أو الفشل. [SCOPE-206] يُسجل الخطأ بمرجع يربط الطلب بالعملية المتأثرة، مع تحديد متى تُعاد المحاولة أو تتوقف أو تُحال للمراجعة. ولا تعني إعادة المحاولة بدء عملية مالية جديدة بينما نتيجة السابقة مجهولة. كما أن فشل إرسال إشعار لا يعكس حجزًا أو مبلغًا ثبتت صحته. [SCOPE-207] 11.8 واجهة الفني في تطبيق الإدارة والمزامنة [SCOPE-208] تشمل الواجهات تحميل المهام وقوائم الفحص واستلام الأصناف ورفع الصور والإرجاع والتوالف ومزامنة البيانات المحفوظة دون اتصال. ويحمل كل تغيير معرفًا وإصدار المهمة، ليفحص الخادم حالتها قبل قبوله. وتعيد العملية المكررة نتيجتها السابقة، بينما يُعرض التعارض للمراجعة دون استبدال بيانات أحدث. [SCOPE-209] لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. تضبط حماية البيانات المحلية والخروج وسحب الصلاحية دون افتراض الوصول الفوري لجهاز غير متصل. [SCOPE-210] 11.9 تسليم وتوثيق الواجهات [SCOPE-211] يشمل التسليم وثائق الواجهات وأمثلة استدعائها، ومخططات البيانات اللازمة لفهمها والتكامل معها، وبيئة الاختبار ونتائجه، ضمن حقوق الملكية في القسم الرابع عشر. ويوضح التوثيق ما يجري على الخادم وما يظهر في كل تطبيق. ولا تكفي قائمة أسماء في Swagger لإثبات اكتمال هذا المخرج. [SCOPE-212] 11.10 الأداء والمتابعة وحدود الخدمة [SCOPE-213] يقاس الأداء بعمليات وبيئة وحجم بيانات ومستخدمين معلوم. تثبت حدود القبول قبل القياس، ولا تفترض نسبة توفر أو سعة غير محددة؛ تتبع البنية خدمة المستضيف. [SCOPE-214] تتابع إجراءات التشغيل أخطاء الدفع والمزامنة، وتراكم المراجعات، وفشل النسخ الاحتياطي، مع تحديد جهة الإخطار وخطوات المعالجة في دليل التشغيل. ويُميز عطل النظام عن تعطل مزود خارجي، مع بقاء مسؤولية النظام عن حفظ الحالة وإعادة التحقق والتصعيد. [SCOPE-215] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. تختار الشركة قاعدة البيانات والتقسيم الداخلي دون تغيير الوظائف أو الحقوق. [SCOPE-216] القسم الثاني عشر: تكامل المحافظ وبوابات الدفع [SCOPE-217] 12.1 الهدف ونطاق التكامل [SCOPE-218] يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يحدد اسم المحفظة وحسابها ووثائقها قبل الربط. [SCOPE-219] 12.2 طبقة التكامل Payment Gateway Adapter [SCOPE-220] تُنشأ وحدة ربط مستقلة «موائم» لكل مزود، وتستخدم طبقة مشتركة لإنشاء الطلبات والمراجع والتحقق وتحديث الحالات والتسجيل المحاسبي والاسترداد والمطابقة. وتختلف الوظائف المتاحة بحسب دعم كل مزود، لذلك يعرض النظام الوسائل والقدرات المنفذة فعلًا فقط. [SCOPE-221] 12.3 إعدادات مزودي الدفع [SCOPE-222] توجد صفحة «إدارة طرق الدفع» لإدارة التفعيل والبيئة والتاجر وعناوين API وWebhook والتوقيع والعملة والحدود والأولوية. تحفظ الأسرار على الخادم ولا تظهر كاملة ويسجل من غيّر الإعداد. [SCOPE-223] 12.4 دورة الدفع والتحقق [SCOPE-224] بعد اختيار العميل وسيلة الدفع، يتحقق الخادم من الحجز والمستحق والعملة والصلاحية. ثم ينشئ طلبًا بمرجع داخلي ويرسله إلى المزود ويحفظ المرجع الخارجي. وتصل النتيجة عبر Webhook موثق أو استعلام رسمي موثوق، بحسب ما يدعمه المزود. [SCOPE-225] قبل تسجيل نجاح الدفع، يتحقق النظام من التوقيع أو آلية التوثيق المعتمدة، ويطابق العملية الأصلية والمبلغ والعملة وحساب التاجر والبيئة. ثم يسجل القيد ويحدث المدفوع والمتبقي مرة واحدة ويرسل الإشعار. ولا تكفي شاشة نجاح التطبيق أو رسالة العميل لإثبات التحصيل. [SCOPE-226] 12.5 تعدد المحافظ وحدود الإضافة [SCOPE-227] يوقف المزود عن طلبات جديدة دون محو تاريخه أو مطابقتها. لكل محفظة إضافية تنفيذ واختبار وسعر مستقل، ولا يكفي إدخال إعداداتها لاعتبار الربط منفذًا. [SCOPE-228] 12.6 حالات الدفع [SCOPE-229] الحالات | المعنى Created / Pending / Processing | أنشئ الطلب / بانتظار الدفع / قيد المعالجة أو التحقق؛ لا تعد تحصيلًا. Successful | نجاح موثق للمبلغ المحدد؛ لا يعني وحده أن الحجز قابل لإعادة التفعيل. Failed / Cancelled / Expired | نتيجة رفض أو إلغاء أو انتهاء وفق مرجع موثوق؛ مع إبقاء المتابعة عند وجود نتيجة مالية مجهولة. Refunded / Partially Refunded | استرداد موثق كامل أو جزئي، مرتبط بأصل التحصيل. Reversed | عكس موثق وفق المزود مع أثر مالي مرتبط بالأصل. [SCOPE-231] المطابقة والاسترداد والاختبار [SCOPE-232] 12.7 الفصل بين المحافظ [SCOPE-233] المحفظة الداخلية سجل أرصدة والتزامات، بينما المحافظ الخارجية وسائل مستقلة للدفع. ولا يُضاف رصيد داخلي لمجرد بدء دفع خارجي أو انتظار نتيجته. وإذا خُصص المبلغ لحجز، فلا يُتاح في المحفظة في الوقت نفسه. وعند نقله إليها لاحقًا، تُسوّى تخصيصاته السابقة ضمن العملية نفسها. [SCOPE-234] 12.8 المطابقة المالية Reconciliation [SCOPE-235] يستورد النظام تقارير المزود ويطابق المبالغ والعملات والمراجع والبيئة، ويكشف العمليات الناجحة غير المسجلة والمكررة والفروقات. ولا تنشئ إعادة الاستيراد أثرًا جديدًا. وتُراجع الفروقات بمرجع وحالة وقرار ومعتمد. وتُحدد صيغة التقرير وطريقة جلبه لكل مزود، دون افتراض جلب آلي غير مدعوم. [SCOPE-236] 12.9 الاسترداد المالي Refund API [SCOPE-237] يُنفذ الاسترداد عبر API عند توفره واعتماده للمزود، مع ربطه بالتحصيل والاستحقاق ومنع تكراره. وإذا لم يتوفر، يُستخدم مسار يدوي بإثبات واعتماد محاسبي. ولا يتجاوز مجموع المردود والمبالغ المحجوزة لطلبات جارية سقف الاسترداد، بعد احتساب تسويات المحفظة والصرف اليدوي وفق 6.3. [SCOPE-238] لا تسجل محاولة الاسترداد ناجحة قبل تأكيد نتيجتها. ويظهر المتبقي بعد الاسترداد الجزئي. وعند ثبوت الفشل، يُحرر المبلغ المحجوز دون دفعه مرتين. ويُميز النظام العكس الذي ينفذه المزود عن الاسترداد الطوعي، مع حفظ مرجع كل منهما وأثره. [SCOPE-239] 12.10 ضوابط أمن الدفع [SCOPE-240] تُحمى الاتصالات ويُتحقق من توقيع الإشعارات، وتستخدم مفاتيح منع التكرار دون كشف الأسرار أو تخزين بيانات البطاقات الحساسة. وتُعالج الإشعارات المكررة والمتأخرة وغير المرتبة دون تكرار القيود أو إعادة حالة مؤكدة إلى حالة أقدم. وتُحال أي نتيجة متعارضة للتحقق والمطابقة. [SCOPE-241] 12.11 انقطاع مزود الدفع أو تأخره [SCOPE-242] عند تعذر الاتصال يبقى الدفع قيد التحقق بمرجعه ويُتابع دون طلب جديد. إذا انتهت الموارد، يسجل المال الصحيح للتسوية دون إحياء الحجز. [SCOPE-243] 12.12 اختبارات التكامل [SCOPE-244] تُختبر لكل مزود معتمد حالات النجاح والرفض والانتهاء والانقطاع والتأخير، والإشعارات المكررة وغير الصحيحة، واختلاف المبلغ والعملة والمرجع. ويُختبر الاسترداد الكامل والجزئي حيث يدعمه المزود، والمطابقة مع تقريره. أما الخصائص غير المدعومة فتُوثق كما هي، ولا تُوصف بالمنفذة أو الناجحة. وتفصل الاختبارات T22 إلى T26 معايير القبول. [SCOPE-245] 12.13 مخرجات التسليم [SCOPE-246] تسلم وحدة ربط المحفظة الواحدة ودليلها ونتائج اختبارها ومطابقتها. تسليم وحدة التشغيل لا يسلم مصدرها تلقائيًا؛ يمكن طلب حزمة المصدر بمقابل حسب الاتفاق مستقل عن حق البيانات. [SCOPE-248] القسم الثالث عشر: اختبارات القبول والتسليم الفني [SCOPE-249] 13.1 الاختبارات الوظيفية ومصفوفة التتبع [SCOPE-250] تختبر جميع الوظائف، مع أدلة تبين السلوك والنسخة المختبرة وبيانات العمل التي يراجعها العميل. [SCOPE-251] تغطي الاختبارات قنوات الحجز الثلاث والكتالوج والمرشحات والمفضلة والتقييم والعقود، والهوية والصلاحيات. وتشمل العربون والدفعات والتعديل والإلغاء والمحاسبة والاستحقاقات والولاء، والمخزون والعهد والتوالف والنقل المباشر، والعمل دون اتصال، والتقارير والإشعارات والتكاملات والتسليم. وتشمل اعتماد حسابات القاعات من تبويب مستقل، وإدارة التخفيضات وأهليتها بحسب نوع المستخدم والحجز واختبارات المنع من تجاوزها. وتشمل مساري إنشاء الكوش وثبات التجميعات عند النسخ، ومسودة الكوشة ونشرها، وكميات الورد المشترك والألوان المتوفرة للفترة، وألبومات القاعات وترتيب الصور والبدائل وفق 3.9. [SCOPE-252] 13.2 سيناريوهات الاختبار المشتركة [SCOPE-253] تمثل الجداول التالية الحد الأدنى للاختبار، ولا تختصر الوظائف المطلوبة. ويُسجل لكل اختبار إصدار النظام والبيئة والبيانات والخطوات والنتيجة المتوقعة والفعلية والدليل وحالة النجاح أو الفشل. ويُختبر التزامن بطلبات تتداخل فعلًا، لا بسيناريوهين يُنفذان بالتتابع. [SCOPE-254] 13.3 معايير القبول [SCOPE-255] يتطلب القبول اكتمال الوظائف المعتمدة واجتياز الاختبارات، وسلامة القيود والمبالغ والعهد، ومنع الوصول غير المصرح. ويشمل تسليم التوثيق ودليل التشغيل ونسخة البيانات المتفق عليها. ولا يُعد العرض التجريبي أو مرور الوقت قبولًا نهائيًا؛ بل يصدر محضر مكتوب يحدد الإصدار والملاحظات المتبقية ومسؤوليات إغلاقها. [SCOPE-256] تصنيف العيب المعتمد نطاقًا | أمثلة وحد القبول حرج | فقد أو فساد بيانات، تسرب بيانات غير مصرح، تحصيل أو استرداد مكرر، تخصيص المورد فوق سعته؛ يمنع القبول النهائي حتى الإصلاح وإعادة الاختبار. جسيم | تعطل مسار أساسي متفق عليه دون بديل معتمد؛ يمنع قبول الجزء المتأثر، ولا يؤجل تلقائيًا إلى ما بعد الإطلاق. متوسط أو منخفض | ملاحظة لا تمنع الوظيفة الأساسية أو سلامة المال والبيانات؛ يجوز إدراجها في قائمة إغلاق بموعد ومسؤولية وموافقة مكتوبة. [SCOPE-258] مدد الضمان والدعم والاستجابة بحسب الاتفاق دون افتراض دعم دائم. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. [SCOPE-259] 13.4 التسليم على مراحل [SCOPE-260] يمكن قبول وحدة أو مرحلة ذات نطاق واختبارات ومخرجات محددة، دون إسقاط الالتزام ببقية الوحدات. وقبل الإطلاق، تُنفذ تجربة شاملة للحجز والتحصيل والتنفيذ والإرجاع والتسوية، ويُتحقق من الاستعادة. ويأتي جدول مخرجات التسليم بعد سيناريوهات الاختبار. [SCOPE-261] 13.5 اختبارات الحجز والهوية والتشغيل [SCOPE-262] الاختبار | الحالة والنتيجة المطلوبة T01 | اختبار قبول | يُختبر التسجيل وربط الحسابات ودمجها وتغيير بيانات التواصل. ويُتحقق من ملكية الحساب، وعدم تكرار الأرصدة أو نقل الحجوزات إلى مستخدم غير مخول، ومن احتفاظ المستندات السابقة ببياناتها وقت الإصدار. T02 | اختبار قبول | يُختبر قبول رمز OTP الصحيح قبل مرور 60 ثانية وضمن 3 محاولات، ورفضه عند انتهاء المدة أو استخدامه أو استنفاد المحاولات. وتُختبر الجلسة الملغاة مع التأكد من عدم كشف الأسرار. وتظل سياسة إعادة الإرسال مستقلة عن محاولات إدخال الرمز. T03 | اختبار قبول | يحاول مستخدم الوصول إلى حجز أو عقد أو ملف يخص مستخدمًا آخر، ويحاول موظف تنفيذ عملية خارج صلاحياته. يجب أن يرفض الخادم هذه المحاولات، حتى عندما يكون المستخدمان ضمن الدور نفسه. T04 | اختبار قبول | تُرسل طلبات متزامنة من العميل وصاحب القاعة داخل تطبيق العميل، ومن لوحة التحكم، لحجز آخر كمية مشتركة أو ورد للون متاح خلال فترات متداخلة. تستخدم الطلبات كوشات مختلفة تشترك في الصنف نفسه، وتختبر خيارات لون تستهلك مجموعة المخزون نفسها عند انطباق ذلك. يجب ألا يتجاوز مجموع الأقفال والتخصيصات المخزون الفعلي، وأن يفحص الورد ويحجز مع باقي الموارد في عملية واحدة دون تخصيص جزئي أو خصم مزدوج عند التأكيد. المرجع: 3.2 و3.5 و4.2. T05 | اختبار قبول | عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. يُختبر انتهاء القفل رغم حفظ الطلب وتأكيد صحيح داخله دون تكرار التخصيص. T06 | اختبار قبول | بعد موافقة العميل، يُجرى تعديل جوهري على العقد ثم تُجرب وصلة الموافقة القديمة. يجب حفظ النسخة السابقة وطلب موافقة جديدة، وألا تسمح الوصلة القديمة باعتماد المحتوى المعدل. T07 | اختبار قبول | تراجع الإدارة المخولة إشعار حوالة وتتحقق منه ثم تعتمد الصحيح. وتُختبر حالات الرفض وتأخر المراجعة والدفع قبل موافقة العقد بعد تحديد المهل. ولا تثبت صورة الإشعار وحدها التحصيل، ولا يُسجل المبلغ مرة ثانية عند المطابقة. T08 | اختبار قبول | يصل تأكيد دفع موثق بعد انتهاء الحجز وتخصيص موارده لحجز آخر. يجب تسجيل المبلغ مرة واحدة، دون إعادة تأكيد الحجز المنتهي بما يتعارض مع الحجز الجديد. T09 | اختبار قبول | تُجرّب تجزئة العربون بين أكثر من وسيلة، ثم محاولة دفعه من محفظة غير كافية. يجب رفض التجزئة، مع السماح بسداد الدفعات اللاحقة جزئيًا عندما تجيز القاعدة ذلك. T10 | اختبار قبول | تسجل الإدارة تحصيلًا نقديًا، وتُجرّب محاولة تحصيل من الفني وبدء تركيب لحجز غير مسدد. يجب إصدار سند الإدارة، ومنع تحصيل الفني، ومنع بدء التركيب ما لم يوجد استثناء صحيح. T11 | اختبار قبول | تُخفض قيمة حجز سُدد جزء منه. يجب أن ينخفض المتبقي دون إنشاء رصيد غير مستحق في المحفظة. وإذا تجاوز المحصل القيمة الجديدة، يُسوّى الفائض مرة واحدة. T12 | اختبار قبول | تُجرّب عملية نقل موعد لا تتوافر موارده، ثم تحويل الحجز إلى تاريخ مفتوح. عند فشل النقل يبقى الموعد القديم. وعند اعتماد التاريخ المفتوح، تُحرر الموارد ويبقى المحصل المستحق فقط في المحفظة، دون رسوم تعديل أو قيد مكرر. T13 | اختبار قبول | يستخدم العميل جزءًا من رصيد الإلغاء في حجز آخر قبل البديل، ويُرفض سحبه نقدًا. يؤكد مستأجر آخر الكوشة نفسها بتاريخ سابق أو لاحق للموعد الملغى؛ يظهر إشعار الأهلية ويصرف المتبقي غير المستخدم فقط دون زيادة الرصيد. T14 | اختبار قبول | يُنشأ حجز قريب من المناسبة، وتُختبر عملية إسناد المهمة أو سحبها. يجب إحالة المراجعة والإسناد فورًا، دون تجاوز الشروط المالية أو التشغيلية تلقائيًا. T15 | اختبار قبول | تُرسل المزامنة أكثر من مرة، ثم يصل تغيير محفوظ لمهمة سبق إلغاؤها. يجب منع التكرار وعدم اعتماد التعارض بصمت، مع حفظ الدليل وإظهار نتيجة المزامنة. T16 | اختبار قبول | يحمل الفني مهمة مستوفية ثم يقطع الاتصال ويبدأ التركيب ويسجل اكتماله وصوره. تحفظ محليًا وترفع تلقائيًا عند الاتصال؛ التعارض مع تغيير لاحق يراجع دون إحياء مهمة ملغاة. [SCOPE-264] 13.6 اختبارات المال والمخزون والتكامل [SCOPE-265] الاختبار | الحالة والنتيجة المطلوبة T17 | اختبار قبول | يُختبر الإرجاع الناقص والنقل المباشر والتعويض من الاحتياطي. يجب نقل العهد الصحيحة فقط، وعدم استخدام قطعة تالفة أو رصيد غير موجود، أو احتساب الكمية مرتين. T18 | اختبار قبول | تُعدل قائمة الصرف، ويُسجل إرجاع جزئي وفرق جرد. ويُتحقق من التوفر والاعتماد، ومن رفض إرجاع كمية تتجاوز العهدة أو تغيير سعر الخدمة من خلال حركة مخزنية فقط. T19 | اختبار قبول | يُسجل تلف بعد صرف الاستحقاق، ثم تُختبر مطالبة تتجاوز الرصيد المتاح للخصم. يجب إثبات التسوية والمبلغ المتبقي وفق السياسة، دون حذف الصرف السابق أو تحميل التلف مرتين. T20 | اختبار قبول | يُطبق خصم أو تعديل أو استرداد بعد احتساب عمولة أو نقاط ولاء. يجب أن تطابق الحسابات الأساس المعتمد، وأن ترتبط التسويات بأصلها دون تكرار المنح أو الخصم. T21 | اختبار قبول | تُرسل عمليتا إنفاق متزامنتان من المحفظة، ومحاولتا تسوية للاسترداد نفسه. يجب ألا يتجاوز الإنفاق الرصيد المتاح، ولا مجموع التسويات سقف الاسترداد عبر جميع المسارات. T22 | اختبار قبول | تُختبر نتائج الدفع الناجحة والمرفوضة، والإشعارات غير الموثقة والمكررة وغير المرتبة. يجب التحقق من النتيجة وتسجيل قيد واحد، دون الرجوع إلى حالة أقدم، مع رفض المبلغ أو العملة أو حساب التاجر غير المطابق. T23 | اختبار قبول | يتعطل مزود الدفع أو تنتهي مهلة الاستجابة بعد إرسال الطلب. يجب حفظ المرجع وإظهار الحالة قيد التحقق، ومتابعة النتيجة دون إنشاء دفع جديد قبل حسم العملية السابقة. T24 | اختبار قبول | يُختبر الاسترداد الكامل والجزئي والطلب الذي لم تتضح نتيجته. يجب تطبيق سقف موحد، وحجز مبلغ الطلب الجاري، وعدم تسجيل الاسترداد ناجحًا لمجرد إرسال المحاولة. T25 | اختبار قبول | يُستورد تقرير مزود يتضمن فروقات مرتين. يجب ألا ينتج الاستيراد الثاني أثرًا ماليًا مكررًا، وأن تظهر العمليات الناجحة غير المسجلة وغير المتطابقة للمراجعة الموثقة. T26 | اختبار قبول | تختبر المحفظة الواحدة المشمولة وخصائصها، ويوقف استقبال طلبات جديدة مع بقاء المطابقة والتاريخ. لا يعد ذلك التزامًا بربط محفظة ثانية دون سعر مستقل. T27 | اختبار قبول | يُختبر فشل إرسال إشعار، ورفع ملف مخالف، وتنزيل مستند خاص دون صلاحية. يجب ألا يغير فشل الإشعار التحصيل، وأن تُطبق ضوابط الملفات والوصول. T28 | اختبار قبول | تُستعاد نسخة احتياطية في بيئة مستقلة، وتُصدر بيانات العميل. ويُتحقق من تطابق الحجوزات والقيود والأرصدة والمخزون والملفات ومراجعها. T29 | اختبار قبول | تُختبر التقارير المعتمدة ومرشحاتها وإجمالياتها وتصديرها. يجب أن تتطابق مع القيود وبيانات الاختبار، وأن تشمل جميع الوظائف الواردة في قائمة التقارير المعتمدة. T30 | اختبار قبول | تُراجع الواجهات وتوثيقها في بيئة الاختبار المستقلة. يجب أن تكون جميع الوظائف المطلوبة قابلة للاستدعاء وفق الصلاحيات، مع أمثلة واضحة للطلبات والنتائج والأخطاء. T31 | اختبار قبول | يُجرى اختبار حمل بحجم التشغيل المتفق عليه. وتُقاس النتائج مقابل الأهداف المعتمدة، مع توثيق البيئة والبيانات، بدل الاكتفاء بانطباع عن سرعة النظام. T32 | اختبار قبول | تُراجع حزمة التسليم: تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما Flutter، ولوحة PHP/Laravel والخادم والبيانات وبقية الحزمة. ويُتحقق من الأدوار والمنصات المحددة والحقوق المتفق عليها، دون افتراض نقل ملكية المصدر. T33 | اختبار قبول | يُختبر تصفح النماذج والمكونات والوسائط والتصنيفات والتقويم والمرشحات والألوان والمفضلة والمشاركة وتنبيه المقاسات. يجب أن تطابق النتائج البيانات والسعات والسياسة، وأن تبقى نسخة الحجز ثابتة بعد تعديل القالب. وتطبق تفاصيل إنشاء الكوش وتوفر ألوان الورد والألبومات في T60 إلى T64. T34 | اختبار قبول | يتابع العميل عقده وصوره وتقييمه، ويتابع مسؤول الخدمات مهامه. يجب أن تقتصر الوظائف على صاحبها، وأن تنفصل المواد الاستهلاكية عن المستردة، مع الالتزام بحد 3 صور للفني. وتُختبر تفاصيل التقييم بعد اعتمادها. T35 | اختبار قبول | تُرسل أنواع الرسائل المعتمدة، وتُختبر إعادة المحاولة والفشل. يجب إظهار المرجع وحالة الإرسال، دون اعتبار الإرسال موافقة أو تحصيلًا، أو استخدام فشله لتجاوز التحقق. T36 | اختبار قبول | يُسجل سند وقيد ثم يُصحح، وتُراجع بيانات التدقيق. يجب أن يبقى الأصل والتصحيح والسبب والمعتمد قابلين للتتبع، دون حذف أو أثر مالي مكرر. T37 | التطبيقان والتقنيات والتوزيع | تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. تُختبر واجهات كل دور وحدود بياناته. T38 | تسجيل صاحب القاعة | عند إدخال الاسم، يختار المستخدم «عميل» أو «صاحب قاعة». يجب أن تظهر لصاحب القاعة حقول رقم التواصل والموقع ورابط Google Maps وسعر الإيجار، وأن تُحفظ وتُعرض بالريال اليمني. ولا يمنحه اختيار نوع الحساب بيانات قاعة أخرى أو صلاحيات إدارية عامة. يحفظ الحساب بانتظار موافقة الإدارة ويظهر في تبويب «طلبات اعتماد حسابات القاعات»، دون تفعيل صلاحياته أو تخفيضاته قبل الاعتماد وفق 2.7. T39 | حدود OTP الدقيقة | صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. يُختبر الفصل بين الإرسال ومحاولات الإدخال وعدم استخدام الرمز مرتين. T40 | إعداد العربون | تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. يُختبر رفض تعديل المبلغ من غير المخول وعدم تغيير عقد سابق بصمت. T41 | غياب الرسوم والتاريخ المفتوح | تُنفذ حالات تعديل وإلغاء للتأكد من عدم فرض أي رسوم. وفي مثال اختباري، يُحول حجز قيمته 100,000 والمدفوع منه 20,000، دون تسويات أخرى، إلى تاريخ مفتوح. يجب تحرير الموارد وإبقاء 20,000 في المحفظة مرة واحدة، لا كامل سعر الحجز. ويظل فرق سعر الخدمة المعدلة منفصلًا عن الرسوم. T42 | العملة الوحيدة | تستخدم الأسعار والمحافظ والسندات والعمولات والتقارير YER وحدها. يرفض الطلب بعملة أخرى دون تحويل ضمني، وتطابق الدقة ضبط المحاسب. T43 | الدوام والتأكيد الآلي | النتيجة المطلوبة: خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. يُختبر ذلك لصاحب قاعة معتمد حسابه مسبقًا؛ اعتماد الحساب لا يضيف موافقة إدارية لكل حجز أو دفع بالمحفظة. T44 | رصيد الإلغاء والأهلية النقدية | النتيجة المطلوبة: في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. T45 | إعادة استخدام رصيد التاريخ المفتوح | النتيجة المطلوبة: عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. T46 | البريد البديل وحماية الحساب | النتيجة المطلوبة: صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. T47 | قنوات الرسائل | النتيجة المطلوبة: تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. T48 | حدود الملفات | النتيجة المطلوبة: تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. T49 | استحقاق الطرف | النتيجة المطلوبة: لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. T50 | الحسابات والتقارير | النتيجة المطلوبة: تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. تطابق التقارير المالية وتقارير الحجوزات والقاعات والفنيين والخدمات والكوش والإلغاء بيانات الاختبار. T51 | مراحل عمل الفني | النتيجة المطلوبة: يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. تطابق الكميات المرتجعة بالعهدة ولا تخفي علامة إرجاع الجميع الفروق. T52 | التدريب والتصدير | النتيجة المطلوبة: يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. T53 | بدء التركيب دون اتصال | النتيجة المطلوبة: لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. T54 | مراجعة واعتماد حساب القاعة | يظهر تسجيل القاعة في التبويب المستقل. تختبر الموافقة والرفض وطلب الاستكمال وإعادة المراجعة والتعليق، مع السبب والإشعار وسجل القرار. يمنع الحساب غير المعتمد من الحجز بصفة قاعة والاستفادة من مزاياها. بعد الاعتماد تتاح وظائفه والتخفيضات المؤهلة دون موافقة لكل حجز. يرفض الخادم قرار موظف غير مخول أو محاولة تفعيل الحساب من التطبيق. المرجع: 2.6 و2.7. T55 | إدارة التخفيضات والفئات | ينشئ المخول تخفيضًا كنسبة وآخر كمبلغ ثابت بالريال اليمني، ويعدل ويفعل ويوقف ويؤرشف القواعد مع سجل التغييرات. تختبر فئات العملاء فقط والقاعات فقط وكلا النوعين، ونطاق الكوشة والخدمات. يقبل التخفيض للفئة المؤهلة ويرفض لغيرها، ولا يمنح حساب القاعة غير المعتمد أهلية القاعات. ترفض القيم السالبة والنسب فوق 100% وتجاوز قيمة البنود. المرجع: 3.8. T56 | صاحب القاعة يحجز لعميل | ينشئ صاحب قاعة معتمد حجزًا لعميل، ثم ينشئ موظف الإدارة حجزًا مماثلًا مرتبطًا بالقاعة بصفة شريك؛ تتطابق قاعدة التخفيض المستحقة. يختبر حجز العميل المباشر وحجز الإدارة له واختيار القاعة كمكان للمناسبة فقط؛ تبقى قواعد العملاء مطبقة. لا يجمع خصم العميل وخصم القاعة تلقائيًا. المرجع: 3.8 و4.1. T57 | تغيير النوع ومنع التجاوز | يحاول المستخدم تعديل نوع حسابه أو حالة اعتماده أو قيمة التخفيض في طلب واجهة الربط. يجب أن يعتمد الخادم بياناته الموثقة ويرفض التجاوز. يمر التحويل الإداري من عميل إلى صاحب قاعة بمسار الاعتماد، ويمنع تعليق الاعتماد أهلية القاعة في العمليات الجديدة دون محو الحجوزات والأرصدة السابقة. تحفظ هوية المعتمد والقيم قبل التغيير وبعده. المرجع: 1.2 و2.7 و3.8. T58 | السريان والجمع والأولوية | تختبر بداية السريان ونهايته وفق تاريخ الحجز أو المناسبة المحدد في القاعدة، وتعدد التخفيضات وتداخلها مع العروض والولاء. تطبق سياسة الجمع والترتيب والأولوية وحسم التعادل المعتمدة فقط، دون جمع مكرر أو قيمة تتجاوز البنود المشمولة. يرفض غير المؤهل أو المنتهي عند اعتماد حجز جديد؛ وأي تغير في السعر الموافق عليه يعرض في نسخة جديدة. المرجع: 3.5 و3.8 و8.4. T59 | ثبات السعر وفصل العمولة | بعد اعتماد حجز، يعدل التخفيض أو يوقف أو تتغير حالة حساب القاعة؛ يجب بقاء نسخة الحجز وسعره وخصمه محفوظة دون تغيير صامت. عند تعديل الحجز وفق 6.1 تتطابق تفاصيل الخصم والعقد والتقرير، وتحتسب عمولة القاعة من صافي المدفوع بعد الخصم دون خلطها بالتخفيض أو تغيير أساس الفني. تختبر تسويات الولاء والاسترداد دون تكرار، وحالة الصافي الأقل من العربون وفق معالجة معتمدة قبل تفعيلها. المرجع: 3.3 و3.8 و4.4 و5.2 و8.3. T60 | إنشاء كوشة من الصفر | ينشئ المدير كوشة من مكتبة الأصناف المصورة، ويحدد نوع المكوّن وطريقة تركيبه والكمية ووحدة القياس، والغلاف المحايد والوصف والسعر. تختبر الستارة المنسدلة والملفوفة باستخدام الصنف نفسه عند كونه القطعة نفسها، دون تكرار الرصيد. تحفظ الكوشة مسودة فلا تظهر للعامة، ثم تنشر فتظهر. المرجع: 3.1 و3.4. T61 | نسخ كوشة واستقلال التجميعة | ينسخ المدير كوشة، ويعدل الاسم والمكونات وخياراتها وطرق تركيبها والكميات والسعر والصور. تبقى التجميعة الأصلية دون تغيير، وتشترك النسخة في أصناف المكتبة الفعلية دون نسخ المخزون. لا تتغير نسخة مكونات حجز سابق أو أسعاره تلقائيًا بعد تعديل أي تجميعة. المرجع: 3.1 و9.1. T62 | الورد المشترك والألوان المتوفرة | تجهز كوشات مختلفة تستخدم مخزون ورد مشتركًا يكفي الكميات اللازمة لكوشتين في فترة محددة. تحجز الكميات لاثنتين، فيرفض طلب ثالث متداخل إذا نفد المورد، حتى إن اختلف اسم الكوشة. يختبر اختلاف احتياج التجميعات، وتوفر لون ونفاد آخر، وتغير الفترة والكمية وانتهاء القفل؛ لا يظهر للاختيار لون غير كافٍ، وإذا نفدت جميع الألوان تظهر الكوشة غير متاحة. المرجع: 3.2 و3.5 و4.2 وT04. T63 | ألبومات القاعة واللون وترتيب الصور | يحدد المدير القاعة ولون الورد ويرفع عدة صور في ألبوم واحد؛ تعرض بترتيب إضافتها، وتكون أول صورة مضافة هي الصورة الرئيسية للألبوم. يختبر العرض المطابق للقاعة واللون أولًا، ثم اللون نفسه في قاعة أخرى مع اسمها، ثم الغلاف المحايد مع صورة أو عينة اللون المختار. لا تعرض صورة بلون مختلف باعتبارها مطابقة، ولا ينشئ ألبوم جديد كوشة أو رصيدًا مخزنيًا جديدًا. المرجع: 3.9. T64 | الفصل بين الصورة والتوفر | قبل اختيار الموعد يظهر غلاف محايد دون ضمان لون. بعد اختيار الموعد والقاعة تظهر الألوان المتوفرة فقط. يختبر لون متوفر بلا صورة مطابقة فيعرض البديل المبيّن، ولون نافد له صور كثيرة فلا يسمح باختياره. لا تحجز مشاهدة الصور مخزونًا، ولا يتغير التوفر بحذف صورة أو إضافة ألبوم، ويظل تنبيه المقاسات مستقلًا. المرجع: 3.2 و3.5 و3.7 و3.9. [SCOPE-267] 13.7 مخرجات التسليم [SCOPE-268] يُثبت لكل مخرج رقم الإصدار وتاريخ التسليم والجهة المستلمة ودليل التسليم وحالة القبول. ولا تكفي عبارة «نسخة المشروع» دون بيان مكوناتها وحقوق استخدامها. [SCOPE-269] المخرج | المحتوى المطلوب | ضبط الحدود التطبيقان | تطبيق العميل للعملاء وأصحاب القاعات؛ تطبيق الإدارة للفنيين ومسؤولي الخدمات؛ كلاهما Flutter. | Android وiOS بالعربية؛ نشر من حسابات الشركة. لوحة التحكم / الويب | الحجوزات والمال والمخزون والشركاء والتقارير والصلاحيات والتدقيق وإعداد العربون، وتبويب اعتماد حسابات القاعات وإدارة التخفيضات، وإدارة إنشاء الكوش ومكوناتها المشتركة وألوان الورد وألبومات القاعات؛ باستخدام PHP / Laravel. | واجهة مسؤول الخدمات داخل تطبيق الإدارة وليست مستبدلة بواجهة اللوحة؛ حقوق الأدوار مستقلة. الخادم وقاعدة البيانات | الخادم المركزي وقاعدة البيانات ضمن التشغيل المتفق عليه، وتهيئة البيئات اللازمة. | Ubuntu على VPS سنوي؛ لا نقل تلقائي لملكية الشفرة. واجهات API | توثيق OpenAPI/Swagger وأمثلة الطلبات والأخطاء والصلاحيات ومخططات البيانات اللازمة. | يغطي جميع وظائف النطاق، لا الواجهات الخارجية فقط. وحدة الدفع | محفظة واحدة مع الدليل والاختبارات والمطابقة والاسترداد عند الدعم. | كل محفظة إضافية باتفاق وسعر مستقلين. حزمة البناء والنشر | الملفات اللازمة لتوزيع وتشغيل الإصدار بحسب نموذج التسليم، مع قائمة محتويات وطريقة تشغيل. | المصدر وحزمة المشروع بمقابل حسب الاتفاق، مستقل عن نسخة البيانات. البيانات والملفات | تصدير بيانات العميل وقاعدة بياناته وملفاته التشغيلية والعقود والصور والسندات والمراجع. | نسخة قابلة للاستخدام دون اشتراط شراء الشفرة. أدلة الاستخدام والتشغيل | دليل كل دور، والإعداد والصلاحيات، والنسخ والاستعادة، ومعالجة الدفع والمزامنة والتعارض. | يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. أدلة الاختبار والاعتماد | مصفوفة تتبع المتطلبات ونتائج الاختبارات وقائمة العيوب ومحاضر القبول. | تحدد الإصدار المختبر والقرارات المطبقة والاستثناءات المكتوبة. [SCOPE-271] 13.8 حدود العمل والتهيئة [SCOPE-272] لا يضاف تطبيق أو محفظة أخرى أو تحويل أرصدة بين العملاء أو نظام شركات وعملات وضرائب شامل تلقائيًا. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. [SCOPE-273] تشمل الوظيفة المعتمدة التفاصيل اللازمة لتحقيقها كما وُصفت، حتى إن لم تُسمَّ شاشة داخلية أو جدول قاعدة بيانات. وفي المقابل، لا تصبح نتيجة جديدة جزءًا من النطاق بمجرد تسمية الطلب «تحسينًا» أو «توضيحًا». ويُحسم التصنيف بمقارنة أثر الطلب بالسلوك المتفق عليه. [SCOPE-274] القسم الرابع عشر: الملكية والاستضافة والتسليم [SCOPE-275] 14.1 ملكية الشفرة المصدرية والملكية الفكرية [SCOPE-276] تبقى ملكية الشفرة المصدرية والبنية والمعمارية والأدوات والمكونات التي تطورها الشركة لها، ما لم يوجد اتفاق مكتوب بخلاف ذلك. ولا ينقل تنفيذ المشروع أو تسليم نسخة منه ملكية المصدر إلى العميل. كما تُحفظ حقوق المكونات الخارجية وتراخيصها وفق قائمة التشغيل المعتمدة. [SCOPE-277] 14.2 حقوق العميل وحدود النسخة المسلمة [SCOPE-278] يحصل العميل على حق استخدام المنظومة في أعماله، وحسابات لوحة الإدارة وصلاحياتها، ونسخة النظام المتفق عليها. ويشمل ذلك نسخة من بياناته وقاعدة بياناته التشغيلية عند الطلب، والتوثيق وأدلة الاستخدام والتشغيل، وإمكان تصدير البيانات بالصيغة المعتمدة. [SCOPE-279] لا يجوز للعميل إعادة بيع النظام أو توزيع الشفرة أو منح استخدامها لطرف آخر أو تعديلها لإعادة تسويقها دون موافقة مكتوبة. ولا يحد هذا القيد من حقه المقرر في بياناته أو نسخة الاستخدام المتفق عليها. [SCOPE-280] تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. [SCOPE-281] 14.3 إدارة الاستضافة والتشغيل [SCOPE-282] يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. [SCOPE-283] 14.4 الحسابات والنطاق ومفاتيح التكامل [SCOPE-284] يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. تضبط الحسابات التقنية والأسرار وصلاحياتها، وكيفية إدارتها عند انتهاء العلاقة. [SCOPE-285] توثق حسابات التاجر والرسائل والبريد ومسؤولية رسومها عند الربط، ولا يستخدم مفتاح يخص عميلًا آخر أو تكتب الأسرار في دليل عام. [SCOPE-286] 14.5 بيانات العميل وخصوصيتها [SCOPE-287] بيانات العملاء والحجوزات والمعاملات والملفات التشغيلية ملك للعميل. يقتصر وصول الدعم على الحاجة والصلاحية، ولا يتوقف حق التصدير على شراء الشفرة. [SCOPE-288] الاستعادة واستمرارية الخدمة [SCOPE-289] 14.6 النسخ الاحتياطي واستعادة البيانات [SCOPE-290] تنفذ الشركة المستضيفة النسخ الاحتياطية ضمن الاشتراك، وتوثق الشركة المبرمجة تغطيتها للبيانات والملفات وطريقة طلب الاستعادة. لا تفترض مدد احتفاظ أو استعادة غير محددة. [SCOPE-291] تُختبر الاستعادة في بيئة مستقلة، مع فحص ترابط الحجوزات والقيود والأرصدة والمخزون والعقود والصور. ويُوثق الإصدار والتاريخ والخطوات والنتائج. وتبقى النسخ المخصصة لاستمرارية التشغيل مختلفة عن حق العميل في تصدير بيانات قابلة للاستخدام. [SCOPE-292] 14.7 انتهاء العلاقة أو توقف الخدمة [SCOPE-293] تسلم الشركة نسخة قابلة للاستخدام من بيانات العميل التشغيلية وقاعدة بياناته وملفاته، وفق الصيغ والمدة والآلية المتفق عليها. وتتضمن العلاقات والمراجع ووصف الحقول اللازم لفهم البيانات، دون أسرار الشركة أو بيانات الآخرين. ويُتحقق من اكتمال النسخة وفتحها وتوافق الملفات مع مراجعها. [SCOPE-294] توثق آلية تصدير البيانات والانتقال والمهلة قبل الإيقاف أو الحذف بحسب الاتفاق، دون اشتراط شراء الشفرة. شراء المصدر عند طلبه له مقابل وحقوق حسب الاتفاق. [SCOPE-295] 14.8 التشغيل والدعم [SCOPE-296] المجال | المسؤولية الاستضافة | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. البيانات والحقوق | تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. التدريب | يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. التهيئة | يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. الضمان والدعم | المدد وأوقات الاستجابة والتكاليف بحسب الاتفاق، دون قيم مفترضة. [SCOPE-298] توضح الخدمة حدود التوفر والنسخ الفعلية. معالجة العيب تختلف عن تطوير ميزة جديدة، ولا تفترض أرقام أو تعويضات لم تحدد. [SCOPE-299] القسم الخامس عشر: ضبط النطاق والاعتماد [SCOPE-300] 15.1 اعتماد النطاق [SCOPE-301] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله عبدالله وأخوه طه. تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. [SCOPE-302] يسجل التغيير اللاحق وبنوده وأثره. يستكمل التفصيل الناقص قبل تنفيذ الجزء المتأثر دون تغيير القاعدة التجارية من تلقاء المبرمج. [SCOPE-303] 15.2 التزامات الطرفين وحدود الاجتهاد [SCOPE-304] يعتمد العميل النطاق والسياسات والقرارات المالية والتشغيلية وقبول التسليم، ويمثله روزا للكوش . تتولى الشركة الإعداد والتنفيذ والاختبار والتوثيق وبيان أثر التغييرات، ولا تعتمد نيابة عن العميل. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. [SCOPE-305] إذا تأخر قرار أو مزود خارجي، يُسجل أثر التأخير على الجزء المرتبط به، ولا تُمدد مدة المشروع أو تكلفته بالكامل تلقائيًا. وأي إعادة جدولة أو تكلفة إضافية تخضع لإجراء التغيير. كما أن اعتماد تصميم الشاشة لا يعفي من تنفيذ القواعد المالية والصلاحيات ومعالجة الأخطاء المتفق عليها. [SCOPE-306] 15.3 ما يعد عيبًا وما يعد تغييرًا [SCOPE-307] يُعد عيبًا كل إخفاق في وظيفة أو قاعدة أو معيار قبول معتمد، أو ظهور نتيجة خاطئة ضمن الشروط المتفق عليها. أما التغيير فهو إضافة أو تعديل نتيجة استخدام أو منصة أو تكامل أو سياسة أو مخرج خارج المرجع المعتمد. ويُحدد التصنيف بمقارنة الطلب بالمتطلب وأثره، لا بالاسم الذي يُطلق عليه. [SCOPE-308] تدرس الإضافات ويعتمد أثرها الفني والمالي والزمني قبل التنفيذ. لا يصبح إصلاح العيب إضافة لمجرد حاجته إلى عمل داخلي، ولا تفرض وظيفة جديدة باسم تحسين ضمني. [SCOPE-309] 15.4 توثيق اعتماد العميل ومسؤوليات التنفيذ [SCOPE-310] الطرف | الاسم والمسؤولية | التوقيع والتاريخ العميل ومفوضوه | روزا للكوش اعتماد النطاق والسياسات والقبول. | ........................ الشركة المبرمجة | التنفيذ والاختبار والتوثيق. | ........................ [SCOPE-312] الإصدار 1.10 | 17 نوفمبر 2026 [SCOPE-313] يثبت التسليم بالوظائف وأدلة الاختبار، ويستمر التدريب خلال أول شهر تشغيل. يعتمد العميل القبول وتوثق الشركة التنفيذ والمعالجة.