[SRS-001] منظومة كوش الأعراس والمناسبات [SRS-002] SRS [SRS-003] مواصفات متطلبات البرمجيات [SRS-004] توضح الوثيقة وظائف النظام وطريقة العمل المتفق عليها ومسؤوليات التشغيل والتسليم، ليستخدمها العميل والشركة أثناء التنفيذ والمراجعة. [SRS-005] الإصدار 1.3 | 13 نوفمبر 2026 [SRS-006] المشروع | إدارة حجوزات وعمليات كوش الأعراس والمناسبات لغة الواجهات | العربية ممثلو العميل | عبدالله وأخوه طه المكونات | تطبيق العميل، تطبيق الإدارة، لوحة تحكم ويب وخادم مركزي. [SRS-008] قبول النظام يثبت بعد مراجعة التنفيذ ونتائج الاختبارات، وليس بمجرد إعداد الوثيقة. [SRS-010] دليل الأقسام [SRS-011] 1. الهدف وضبط المتطلبات [SRS-012] 2. وصف النظام وحدوده [SRS-013] 3. المتطلبات الوظيفية [SRS-014] 4. الواجهات والبيانات المشتركة [SRS-015] 5. متطلبات الجودة والتشغيل [SRS-016] 6. معايير القبول وسجل الاختبارات [SRS-017] 7. تغطية المتطلبات بالاختبارات [SRS-018] 8. التسليم والتغيير والاعتماد [SRS-020] 1. الهدف وضبط المتطلبات [SRS-021] توضح هذه الوثيقة وظائف النظام وقواعد تشغيله ومعايير قبولها، ليعرف المبرمج ما سينفذه والعميل ما سيراجعه عند التسليم. تبقى معرّفات المتطلبات ثابتة لتسهيل الاختبار والمتابعة. [SRS-022] النوع | الاستخدام FR | المتطلبات الوظيفية من FR-001 إلى FR-106. NFR | الجودة والتشغيل من NFR-01 إلى NFR-18. T | اختبارات القبول ونتائجها المتوقعة. [SRS-024] كيفية قراءة المتطلبات [SRS-025] الأفعال مثل «يتيح» و«يسجل» و«يمنع» تصف وظائف مطلوبة. يعتمد العميل النطاق والسياسات والقبول، وتختار الشركة التفاصيل الداخلية اللازمة لتحقيقها دون توسع ضمني. [SRS-026] لكل بطاقة معرّف ووصف ومعيار قبول. معايير القبول نتائج منتظرة عند الاختبار، وليست إثباتًا بأن البرنامج نُفذ أو اجتاز الاختبارات. [SRS-027] القيم والقيود المثبتة في الإصدار [SRS-028] القيد | القيمة واجهات التسليم | تطبيقان: العميل للعملاء وأصحاب القاعات؛ الإدارة للفنيين ومسؤولي الخدمات؛ لوحة تحكم وخادم مركزي. قفل الطلب الإداري | 10 دقائق حتى تأكيد العربون، دون تمديد بحفظ الطلب. صور الفني | حتى 3 صور ليلة المناسبة؛ لا يضاف حد أدنى غير وارد. المهام والسداد | إسناد ومراجعة قبل المناسبة بيومين؛ مسار فوري للحجز الأقرب. العربون والتحصيل | العربون من وسيلة واحدة كاملة؛ لا تحصيل عبر الفنيين. التقنيات | Flutter على Android وiOS؛ PHP/Laravel؛ Ubuntu؛ العربية. العملة | الريال اليمني (YER) فقط؛ دون تحويل أو تعدد عملات. التعديل والإلغاء | دون رسوم؛ رصيد التاريخ المفتوح يبقى في محفظة العميل. OTP | 60 ثانية؛ ثلاث محاولات لكل رمز؛ ثلاث إرسالات هاتف إجمالًا ثم البريد المدخل. اعتماد القرارات | العميل ويمثله عبدالله وأخوه طه. [SRS-030] 2. وصف النظام وحدوده [SRS-031] ترتبط الواجهات بالخادم المركزي نفسه، وتطبق قواعد مشتركة للتوفر والمال والصلاحيات. أما محفظة العميل الداخلية فهي سجل لأرصدته والتزاماته داخل المنظومة، وليست خدمة دفع خارجية. [SRS-032] الطرف / الواجهة | نطاق الاستخدام الإدارة / لوحة التحكم | المدير العام والمحاسب والمنسق وأمين المخزن ومدير العمليات بصلاحيات مفصلة. العميل / تطبيق العميل | التصفح والحجز والدفع والمتابعة والتعديل والإلغاء والعقود والصور والتقييم. صاحب القاعة / تطبيق العميل | يختار «صاحب قاعة» عند التسجيل ويدخل تواصل القاعة وموقعها ورابط Google Maps وسعر إيجارها؛ يتابع حجوزاته وعمولاته ضمن نطاقه. الفني / تطبيق الإدارة | المهمة والعهد والتنفيذ والصور والإرجاع والمزامنة دون تحصيل. مسؤول الخدمات / تطبيق الإدارة | يتابع الخدمات وملاحظات مهامه من واجهته داخل تطبيق الإدارة، بصلاحيات مستقلة عن الفني والإدارة المالية. الأطراف الخارجية | مزودو الدفع والرسائل المعتمدون؛ السلوك مقيد بقدراتهم المثبتة. [SRS-034] القيود والتبعيات [SRS-035] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. [SRS-036] لا يشمل النطاق تلقائيًا تطبيقًا مستقلًا إضافيًا أو محافظ خارج القائمة المحددة، ولا تحويل الأرصدة بين العملاء أو الشحن العام غير المعتمد. كما لا يشمل تعدد الشركات أو العملات، أو نظام ERP شاملًا، أو تكاملًا ضريبيًا، أو إصلاحات مخزنية متقدمة، أو ترحيلًا تاريخيًا وتقارير مخصصة لم تُحدد. وتبقى التفاصيل اللازمة لتشغيل الوظائف المعتمدة جزءًا من الالتزام. [SRS-037] المصطلحات التشغيلية [SRS-038] المصطلح | المعنى داخل النطاق طلب مؤقت / حجز مؤكد | الطلب المؤقت له موارد مخصصة ومهلة محددة وأسباب انتظار ظاهرة. أما الحجز المؤكد فقد استوفى الموافقة على العقد وسداد العربون وتخصيص الموارد. العهدة / التوفر | العهدة كميات مصروفة مرتبطة بالتنفيذ؛ التوفر كمية صالحة في فترة معتمدة. معلق / مستحق / مصروف | استحقاق محسوب غير جاهز للصرف / مؤهل بعد الإنجاز / تم صرفه فعليًا. تسوية / قيد تحقق | معالجة أثر مالي موثقة / نتيجة لم يثبت نجاحها أو فشلها بعد. النقل المباشر | نقل الأصناف السليمة من عهدة حجز إلى الحجز التالي مباشرة، دون تسجيل عودة لم تحدث إلى المخزن. [SRS-041] 3. المتطلبات الوظيفية [SRS-042] توضح البطاقات السلوك المطلوب. تضبط قيم إعدادات العمل بواسطة المخول، وتطبق قواعد صحة المال والموارد والهوية على الخادم. [SRS-043] 3.1 الهوية والصلاحيات [SRS-044] FR-001 | الدخول والتحقق [SRS-045] يتيح النظام الدخول بالهاتف وOTP، أو البريد ورمز تحقق مع استكمال بيانات التواصل. بعد تعذر وصول رمز الهاتف في ثلاث إرسالات إجمالًا، يطلب بريدًا يدخله المستخدم في حينه. إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. [SRS-046] معيار القبول: يعمل المساران ويظهر طلب البريد بعد استنفاد إرسالات الهاتف، دون منح بريد غير مرتبط ملكية حساب هاتف قائم. [SRS-047] FR-002 | صلاحية رمز التحقق [SRS-048] صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. [SRS-049] معيار القبول: يقبل الرمز الصحيح قبل 60 ثانية وضمن ثلاث محاولات؛ يظهر زر الإعادة بعد الدقيقة، ويتوقف إرسال الهاتف بعد الإرسال الثالث. [SRS-050] FR-003 | هوية ثابتة وتوحيد الهاتف [SRS-051] يخصص النظام لكل عميل معرفًا داخليًا ثابتًا، ويوحد تنسيق أرقام الهاتف قبل مقارنتها. ويظل الهاتف وسيلة التعريف الأساسية للتواصل وتوحيد الحسابات، دون أن يؤدي تغييره إلى تغيير المعرف الداخلي. [SRS-052] معيار القبول: تتعرف المنظومة على الصيغ المتكافئة المعتمدة للرقم، ولا يتغير المعرف الداخلي بتغيير الهاتف المعتمد. [SRS-053] FR-004 | ربط الحسابات ودمجها [SRS-054] يتحقق النظام من ملكية الهاتف قبل ربط الحسابات أو دمجها. وعند وجود تعارض في الهوية أو الأرصدة، يوقف الدمج ويحيل الحالة للمراجعة. وتُحفظ مراجع السجلات بحيث لا تتكرر المحفظة ولا تنتقل حجوزات إلى غير صاحبها. [SRS-055] معيار القبول: لا يكفي تشابه الاسم للدمج؛ يحفظ الرصيد والحجوزات مرة واحدة عند الدمج الصحيح. [SRS-056] FR-005 | تغيير التواصل واسترجاع الحساب [SRS-057] يطبق النظام الإجراء المعتمد عند تغيير رقم الهاتف أو فقدانه أو استرجاع الحساب. وتحافظ المستندات السابقة على بيانات التواصل التي صدرت بها؛ فلا يؤدي تعديل الملف الشخصي إلى تغيير مستند قديم تلقائيًا. [SRS-058] معيار القبول: يبقى سند سابق ببيانات إصداره؛ يتطلب تغيير الهوية إجراء التحقق المعتمد. [SRS-059] FR-006 | إدارة الجلسات [SRS-060] يدعم النظام إصدار رموز الوصول والتجديد، وتجديد الجلسات وإلغاءها، وفق السياسة المعتمدة. ويرفض استخدام أي جلسة ملغاة في العمليات التي تتطلب تسجيل الدخول. [SRS-061] معيار القبول: يقبل رمز صالح ويرفض رمز غير صالح أو جلسة ملغاة وفق الإجراء المحدد. [SRS-062] FR-007 | صلاحية الدور ونطاق السجل [SRS-063] يفحص الخادم دور المستخدم وصلاحية العملية ونطاق البيانات في كل عرض أو إنشاء أو تعديل أو اعتماد أو إلغاء أو تصدير أو تنزيل ملف. ويُرفض الوصول ما لم تكن الصلاحية ممنوحة صراحة. [SRS-064] معيار القبول: يرفض مستخدم الوصول لسجل خارج نطاقه حتى عند امتلاكه الدور نفسه لمستخدم آخر. [SRS-065] FR-008 | حدود وصول الأطراف [SRS-066] يصل العميل إلى حسابه ومستنداته فقط، ويصل الشريك إلى الحجوزات المرتبطة به والبيانات اللازمة لخدمتها. أما الفني ومسؤول الخدمات، فتقتصر بياناتهما على المهام المسندة إليهما وما يلزم لتنفيذها. وإنشاء حجز نيابة عن عميل لا يتيح الاطلاع على كامل حسابه. [SRS-067] معيار القبول: لا يرى الشريك حجوزات العميل الأخرى، ولا يرى الفني مهمة غير مسندة إليه. [SRS-068] FR-009 | سجل العمليات الحساسة [SRS-069] يسجل النظام العمليات الحساسة، بما فيها تغييرات الأموال والأسعار والصلاحيات والحجوزات والعهد. ويشمل السجل المستخدم والوقت ونوع العملية ومرجعها وسببها، والقيم قبل التغيير وبعده حيث ينطبق. ولا يستطيع مستخدم التشغيل محو أثر عملياته. [SRS-070] معيار القبول: يظهر تغيير معتمد في السجل بمرجعه؛ ترفض محاولة المستخدم محو أثره. [SRS-071] FR-010 | إدارة المستخدمين وواجهة الخدمات [SRS-072] يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. [SRS-073] معيار القبول: تظهر لكل دور حجوزاته ووظائفه فقط دون صلاحيات مالية عامة. [SRS-074] 3.2 الكتالوج وتجربة التصفح [SRS-075] FR-011 | نماذج الكوش ومكوناتها [SRS-076] يتيح النظام تعريف كل كوشة ومكوناتها وكمياتها ووحدات قياسها، وإرفاق صور عالية الدقة ومقاطع فيديو لها، وإعداد قوالب قياسية تستخدم عند الصرف. [SRS-077] معيار القبول: ينشأ نموذج بمكونات قابلة للاستعراض وتستدعى كمياته في الصرف. [SRS-078] FR-012 | ثبات نسخة الحجز [SRS-079] يحفظ النظام نسخة من مكونات الحجز وأسعاره عند اعتماده. وأي تعديل لاحق على القالب أو السعر العام لا يغير الحجوزات السابقة تلقائيًا. [SRS-080] معيار القبول: تظل مكونات وأسعار حجز معتمد دون تغيير بعد تعديل القالب الأصلي. [SRS-081] FR-013 | التصنيفات والأرشفة [SRS-082] يتيح النظام إنشاء تصنيفات مرنة وتحديد التبويب الذي يظهر افتراضيًا. وعند إخفاء نموذج أو أرشفته، يحتفظ ببيانات الحجوزات المرتبطة به. [SRS-083] معيار القبول: يتغير التبويب الافتراضي؛ تبقى بيانات الحجز عند أرشفة نموذجه. [SRS-084] FR-014 | ألوان الورد وسعتها [SRS-085] تحدد الإدارة ألوان الورد وسعتها اليومية، ويخفى المستنفد ويعاد التحقق منه عند الحجز. تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، وسعات الألوان اليومية، والمنطقة الزمنية وطريقة التحويل الهجري. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. [SRS-086] معيار القبول: يمنع تجاوز السعة تحت التزامن ويستخدم الفترة المضبوطة. [SRS-087] FR-015 | العروض الترويجية [SRS-088] يُحدد لكل عرض وقت سريانه وشروط الاستفادة منه. ويطبق النظام ترتيب أولوية العروض وإمكان جمعها مع نقاط الولاء وفق السياسة المعتمدة. [SRS-089] معيار القبول: يطبق العرض المؤهل داخل مدته فقط وتطابق نتيجة جمع الخصومات السياسة المعتمدة. [SRS-090] FR-016 | أنواع الخدمات الإضافية [SRS-091] يميز النظام بين الخدمات ذات المواد المستردة والخدمات الاستهلاكية، مع تسجيل الكميات والأسعار وطريقة الصرف. ويتيح إدخال اسم العريسين للطباعة، ولا يدرج المواد الاستهلاكية المصروفة ضمن الأصناف المطلوب إرجاعها. [SRS-092] معيار القبول: يظهر الاسم المعتمد وتنفصل المستهلكات عن قائمة المستردات المنتظرة. [SRS-093] FR-017 | القاعات وتنبيه المقاسات [SRS-094] يحفظ النظام أبعاد الكوشة ومسرح القاعة بوحدة قياس موحدة. وعندما تتجاوز أبعاد الكوشة المساحة المتاحة، يظهر تنبيه للمستخدم، دون تحويل التنبيه تلقائيًا إلى منع للحجز. [SRS-095] معيار القبول: يظهر التنبيه عند التجاوز، وتطبق سياسة نقص القياسات والتجاوز المعتمدة. [SRS-096] FR-018 | التقويم والمرشحات [SRS-097] يعرض النظام التقويم الهجري والميلادي للموعد نفسه ومرشحات التاريخ واللون والقاعة والعروض. تضبط المنطقة الزمنية وطريقة التحويل من إعدادات النظام. [SRS-098] معيار القبول: يتطابق التاريخ المعروض مع الموعد المحفوظ وتستخدم الإعدادات نفسها في المهل والتوفر. [SRS-099] FR-019 | المعاينة والمفضلة والمشاركة [SRS-100] يتيح التطبيق معاينة الألوان، وحفظ الكوشة في المفضلة، ومشاركتها عبر واتساب. ولا تتضمن المشاركة بيانات حجز خاص أو مستندات العميل. [SRS-101] معيار القبول: تحفظ المفضلة للحساب وتفتح المشاركة الكتالوج دون كشف حجز العميل. [SRS-102] FR-020 | متابعة العميل والتقييم [SRS-103] يتابع العميل حجزه وعقده وصور التركيب وتقييم الخدمة. تظهر الصور بعد رفعها للخادم، لا وهي ما زالت محلية. تحدد حقول التقييم ووقت إتاحته أثناء تصميم الواجهة دون افتراض منصة مراجعات عامة. [SRS-104] معيار القبول: تتوفر الوظائف المذكورة للعميل المخول؛ لا يعتمد اختبار تفاصيل التقييم قبل اعتمادها. [SRS-105] 3.3 إنشاء الحجز والعقد والمهل [SRS-106] FR-021 | قنوات إنشاء الحجز [SRS-107] توجد مسارات حجز للعميل وصاحب القاعة في تطبيق العميل، ولموظف الإدارة في لوحة التحكم. خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. [SRS-108] معيار القبول: يرفض الخادم طلب المراجعة خارج الدوام دون إنشاء طلب أو قفل؛ يعمل التأكيد بالمحافظ للعميل وصاحب القاعة. [SRS-109] FR-022 | بيانات وتسعير الطلب [SRS-110] يعرض التطبيق الكوشة المختارة ولونها ولون الكرسي والورد، واسم القاعة واسم الشخص، والإجمالي والمدفوع والمتبقي والخدمات الإضافية المختارة. تحفظ هذه البيانات مع نسخة العقد والموافقة، ولا تتغير النسخة السابقة بصمت عند تعديل الحساب أو الحجز. يعيد الخادم حساب السعر والخصم والعربون الثابت من الإعدادات، ولا يعتمد قيم التطبيق وحدها. [SRS-111] معيار القبول: لا تغير قيم مالية غير موثوقة مرسلة من التطبيق السعر الذي يحتسبه الخادم. [SRS-112] FR-023 | تخصيص ذري لجميع الموارد [SRS-113] يخصص النظام جميع موارد الحجز معًا: الكوشة والأصناف المشتركة وكمياتها واللون، خلال الفترة المعتمدة. وإذا تعذر تخصيص أي جزء، يرفض الطلب كاملًا. وتطبق القاعدة عند إنشاء الحجز أو تعديل موعده أو مكوناته. [SRS-114] معيار القبول: عند تزاحم طلبات على آخر كمية لا يتجاوز الإجمالي السعة ولا يبقى تخصيص جزئي لطلب فاشل. [SRS-115] FR-024 | القفل الإداري لعشر دقائق [SRS-116] عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. [SRS-117] معيار القبول: ينتهي القفل بعد عشر دقائق دون تأكيد العربون، رغم حفظ الطلب، ويتحول عند التأكيد إلى تخصيص واحد. [SRS-118] FR-025 | انتهاء القفل وتحويله [SRS-119] لا يجدد تحديث الشاشة أو حفظ الطلب قفل الإدارة. عند انتهائه يعاد فحص التوفر؛ وعند تأكيد السداد والشروط يتحول لتخصيص مؤكد دون ازدواج. الدفع المتأخر يُسوى مستقلًا. [SRS-120] معيار القبول: لا يتمدد القفل بالحفظ ولا يعود حجز فقد موارده تلقائيًا. [SRS-121] FR-026 | إصدار العقد وحفظ الموافقة [SRS-122] يعرض التطبيق الكوشة المختارة ولونها ولون الكرسي والورد، واسم القاعة واسم الشخص، والإجمالي والمدفوع والمتبقي والخدمات الإضافية المختارة. تحفظ هذه البيانات مع نسخة العقد والموافقة، ولا تتغير النسخة السابقة بصمت عند تعديل الحساب أو الحجز. تحفظ هوية الموافق والوقت والطريقة، وفي الحجز نيابة عن العميل تطلب موافقته بالرابط أو OTP. [SRS-123] معيار القبول: يمكن استرجاع ما وافق عليه العميل بالضبط؛ لا يعتمد تأكيد الشريك بديلًا لموافقته. [SRS-124] FR-027 | تعديل العقد وإبطال الرابط السابق [SRS-125] عند اعتماد تعديل جوهري، يصدر النظام نسخة عقد جديدة ويطلب موافقة العميل عليها. ولا يصلح رابط النسخة السابقة لاعتماد محتوى النسخة الجديدة. [SRS-126] معيار القبول: تحفظ الموافقة القديمة ويمنع الرابط القديم اعتماد النسخة المعدلة. [SRS-127] FR-028 | مهلة الطلب المؤقت [SRS-128] تبدأ مهلة الطلب المقبول بعد تخصيص موارده وتظهر نهايتها من الخادم. عند انتهائها دون سداد أو إشعار قابل للمراجعة تتحرر الموارد. طلب الإدارة يخضع لتأكيد العربون خلال 10 دقائق، ولا ينشأ مسار مراجعة خارج الدوام. [SRS-129] معيار القبول: لا تتجدد المهلة بفتح التطبيق ولا يتجاوز الطلب الإداري حد العشر دقائق دون سداد. [SRS-130] FR-029 | مهلة مراجعة الحوالة [SRS-131] خلال الدوام يرفع المستخدم إشعار الحوالة ويبدأ مسار مراجعة الإدارة بمهلة مستقلة عن مهلة الرفع. لا تثبت الصورة التحصيل. تضبط نتائج الرفض والاستكمال والتصعيد دون تمديد مفتوح. ولا تتجاوز المراجعة قفل طلب الإدارة البالغ 10 دقائق دون تأكيد العربون. [SRS-132] معيار القبول: تبقى الحوالة معلقة حتى اعتماد الإدارة، ولا تنشأ خارج الدوام أو تسجل مرتين. [SRS-133] FR-030 | شروط تأكيد الحجز [SRS-134] يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. ويطبق التأكيد الآلي عند الدفع كاملًا من الرصيد الداخلي المتاح. [SRS-135] معيار القبول: يتأكد حجز العميل وصاحب القاعة بالمحفظة دون اعتماد إداري للدفع مع التوفر والموافقة المطلوبة. [SRS-136] FR-031 | الحجوزات الأقرب من يومين [SRS-137] عند إنشاء حجز قريب من موعد المناسبة، يحيل النظام المراجعة المالية وإسناد المهمة فورًا وفق حالة اعتماد الحجز. ويظل التأكيد وبدء التركيب خاضعين للشروط نفسها، دون استثناء تلقائي بسبب قرب الموعد. [SRS-138] معيار القبول: تنشأ المتابعة والإسناد المطلوبان للحجز القريب ولا يتجاوز قيد السداد أو العهد. [SRS-139] 3.4 التحصيل والمحفظة والشروط المالية [SRS-140] FR-032 | العربون من وسيلة واحدة [SRS-141] يُسدد العربون كاملًا في دفعة واحدة، من المحفظة الداخلية أو من وسيلة دفع أخرى واحدة. ويرفض النظام تقسيمه بين وسائل متعددة، أو استخدام رصيد غير متاح، أو استكمال نقص المحفظة تلقائيًا بوسيلة ثانية. [SRS-142] معيار القبول: يرفض الدفع المركب للعربون ويقبل وسيلة واحدة تغطي قيمته المعتمدة. [SRS-143] FR-033 | الدفعات اللاحقة [SRS-144] يتيح النظام دفع مبالغ إضافية أو سداد المتبقي من المحفظة الداخلية، كليًا أو جزئيًا. ويسجل كل تحصيل بمرجع مستقل يوضح المبلغ والعملة والحجز ومصدر الدفع. [SRS-145] معيار القبول: يسجل دفع لاحق جزئي ويعاد حساب المتبقي من الحركات المعتمدة. [SRS-146] FR-034 | قنوات التحصيل المحددة [SRS-147] يدعم النظام الحوالات المرفوعة عبر التطبيق، والمحافظ الخارجية المعتمدة، والمحفظة الداخلية، والتحصيل النقدي لدى الإدارة. ولا يتيح للفني تحصيل الأموال ميدانيًا أو إصدار سند قبض. [SRS-148] معيار القبول: تعمل القنوات المعتمدة ويرفض الخادم طلب تحصيل صادر عن الفني. [SRS-149] FR-035 | تحصيل النقد بسند [SRS-150] عند استلام الإدارة مبلغًا نقديًا، يصدر النظام سند قبض فوريًا يرتبط بالمبلغ والحجز والمستخدم الذي سجل التحصيل، وفق القواعد المالية المعتمدة. [SRS-151] معيار القبول: ينتج سند واحد لتحصيل نقدي صحيح ويبقى مرتبطًا بأصله. [SRS-152] FR-036 | اعتماد الحوالة دون ازدواج [SRS-153] تراجع الإدارة المخولة إشعار الحوالة وتتحقق من وصول المبلغ قبل اعتماد التحصيل. ولا يُعد رفع الصورة وحده دفعًا موثقًا، كما لا يُسجل تحصيل جديد إذا ظهر التحويل نفسه لاحقًا أثناء المطابقة. [SRS-154] معيار القبول: اعتماد الدليل ثم مطابقته لا يزيد المدفوع مرتين. [SRS-155] FR-037 | المتبقي والمبلغ الزائد [SRS-156] يحسب النظام المدفوع والمتبقي من الحركات المعتمدة. وعند وجود دفعة زائدة أو غير مطابقة، يحيلها إلى التسوية بدل زيادة سعر الخدمة تلقائيًا. [SRS-157] معيار القبول: يظهر الفائض للتسوية ويبقى سعر الخدمة المعتمد دون تغيير. [SRS-158] FR-038 | ضمان مصدر رصيد المحفظة [SRS-159] لا يضاف رصيد إلا من مصدر مبلغ محصل موثق. يميز النظام المتاح للحجز والمؤهل للسحب النقدي والمحجوز والمديونية. رصيد الإلغاء المشروط متاح للحجز قبل البديل ولا يسمح بسحبه نقدًا. [SRS-160] معيار القبول: يمكن إنفاق رصيد الإلغاء على حجز آخر ويمنع سحبه قبل البديل. [SRS-161] FR-039 | منع الإنفاق المتزامن [SRS-162] يمنع النظام إنفاق الرصيد المتاح نفسه أكثر من مرة، بما في ذلك الطلبات المتزامنة. ويربط كل إضافة أو خصم أو حركة عكسية بمصدرها وبالحجز أو الاسترداد المرتبط بها. [SRS-163] معيار القبول: تحت طلبات متداخلة لا يتجاوز مجموع الخصم الرصيد المتاح. [SRS-164] FR-040 | تخصيص التحصيل دون رصيد مزدوج [SRS-165] لا يُستخدم المبلغ نفسه لتغطية حجز ولإتاحة رصيد حر في المحفظة في الوقت ذاته. وإذا نُقل إلى المحفظة، يسوي النظام تخصيصه السابق ضمن العملية نفسها. [SRS-166] معيار القبول: لا يمكن استخدام المبلغ نفسه لتغطية الحجز والدفع من المحفظة لحجز آخر. [SRS-167] FR-041 | الدفع المتأخر بعد انتهاء الحجز [SRS-168] يسجل النظام الدفع المتأخر الموثق مرة واحدة، في تسوية مرتبطة بالعميل والعملية الأصلية. ولا يعيد تفعيل الحجز تلقائيًا أو يسحب موارد سبق تخصيصها لعميل آخر. [SRS-169] معيار القبول: يحفظ المبلغ ويظل الحجز غير مؤكد حتى قرار التسوية وفحص التوفر المعتمدين. [SRS-170] FR-042 | منع البدء عند التعثر المالي [SRS-171] تراجع الإدارة السداد قبل المناسبة بيومين أو عند اعتماد الحجز الأقرب. يشترط السداد أو استثناء مالي مسجل، دون اشتراط اتصال الفني لحظة البدء؛ يستخدم آخر حالة محفوظة وتراجع التغيرات عند المزامنة. [SRS-172] معيار القبول: لا يمنع غياب الشبكة وحده البدء عندما تسمح المهمة المحفوظة؛ يراجع تعارض السداد لاحقًا. [SRS-173] FR-043 | ضبط الاستثناء المالي [SRS-174] يسجل النظام الحجز الذي يخصه الاستثناء المالي وسببه ومعتمده ومدته. ولا يمتد الاستثناء إلى حجوزات العميل الأخرى، ولا يُعد سدادًا للمبلغ أو بديلًا عن الاستثناء التشغيلي. [SRS-175] معيار القبول: يقبل الاستثناء الصحيح للحجز المحدد ويرفض استعماله لحجز آخر أو خارج مدته. [SRS-176] 3.5 التعديل والإلغاء والاسترداد [SRS-177] FR-044 | طلب التعديل واعتماده [SRS-178] تراجع الإدارة طلب تعديل الحجز وتوافق عليه قبل تنفيذه، دون فرض رسوم تعديل. ويعرض النظام أثر الطلب على الموعد والموارد وسعر الخدمة والعربون والمتبقي والعقد والاستحقاقات، مع حفظ البيانات السابقة وسبب التعديل ومعتمده. ويُعرض فرق سعر الخدمة بوصفه فرق سعر، لا رسم تعديل. [SRS-179] معيار القبول: لا ينفذ طلب غير معتمد تغييرًا في الموارد أو المال؛ لا تنشأ رسوم تعديل، ويظهر فرق قيمة الخدمة منفصلًا عند تغيرها. [SRS-180] FR-045 | نقل موعد دون فقد الحجز القديم [SRS-181] عند نقل موعد الحجز، يفحص النظام توفر الموارد الجديدة، ثم يخصصها ويحرر القديمة في عملية واحدة. وإذا فشل النقل، يبقى الموعد القديم وموارده دون تغيير. [SRS-182] معيار القبول: فشل توفر مكون واحد في الموعد الجديد لا يفقد الموعد القديم. [SRS-183] FR-046 | التحويل إلى تاريخ مفتوح [SRS-184] عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. [SRS-185] معيار القبول: تتحرر الموارد ويفك تخصيص المال للحجز الأول، ويؤكد الحجز الجديد من الرصيد الكافي دون قيد مزدوج. [SRS-186] FR-047 | زيادة القيمة وخفضها [SRS-187] إذا ارتفعت قيمة الحجز، يعيد النظام حساب المستحق. وإذا انخفضت، يخفض المبلغ غير المدفوع أولًا. ولا ينشئ رصيدًا قابلًا للإنفاق إلا مقابل فائض محصل يستحقه العميل بعد التسوية. [SRS-188] معيار القبول: في المثال غير التسعيري: قيمة 100,000 ومدفوع 20,000 وخفض إلى 80,000 ينتج متبقيًا 60,000 بلا رصيد جديد. [SRS-189] FR-048 | أثر التعديل على الأطراف والعقد [SRS-190] يعيد النظام حساب استحقاقات الفني ومسؤول الخدمات والقاعة وفق أسسها المعتمدة. وإذا سبق صرف استحقاق، يصحح أثره بتسوية مرتبطة به. وأي تغيير جوهري في العقد يستلزم موافقة جديدة. [SRS-191] معيار القبول: لا يحذف صرف سابق، ويظهر أثر التعديل والموافقة الجديدة عند لزومها. [SRS-192] FR-049 | الإلغاء المباشر [SRS-193] بعد اعتماد الإلغاء، يحرر النظام الموارد المرتبطة به ويسوي المبلغ المستحق للعميل دون رسوم إلغاء. ويميز بين قيمة الخدمة والمبلغ المدفوع والقابل للاسترداد؛ فلا ينشئ رصيدًا عن مبلغ لم يُحصّل. وتبقى شروط الاسترداد والمستأجر البديل كما وردت، دون إضافة خصومات جديدة. [SRS-194] معيار القبول: لا يسجل أي رسم إلغاء، ويطابق رد القيمة المحصل المستحق ومسار التسوية المعتمد مع بقاء سجل الحجز. [SRS-195] FR-050 | الإلغاء بانتظار بديل [SRS-196] في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. [SRS-197] معيار القبول: يمكن استخدام الرصيد قبل البديل مع منع سحبه؛ البديل لنفس الكوشة في أي موعد يؤهل المتبقي فقط للصرف ولا يزيد الرصيد. [SRS-198] FR-051 | سقف استرداد موحد [SRS-199] يربط النظام الاسترداد بأصل المبلغ واستخداماته بسقف مشترك بين المحفظة والصرف والمزود. إتاحة رصيد الإلغاء للحجز ليست صرفًا نقديًا؛ عند الصرف يخصم المتبقي نفسه. يبقى الرد الجاري محجوزًا حتى معرفة نتيجته. [SRS-200] معيار القبول: لا يصرف ما استُخدم في حجز ولا يرد المبلغ مرتين عبر مسارين. [SRS-201] FR-052 | تصحيح الاسترداد دون حذف [SRS-202] يحفظ النظام مراجع الاسترداد، ويجري التصحيحات بحركات عكسية أو تسويات مرتبطة بالأصل. وإذا كانت نتيجة الاسترداد مجهولة، يبقى مبلغه غير متاح لطلب آخر إلى حين التحقق. [SRS-203] معيار القبول: يبقى طلب مجهول النتيجة محجوزًا ويحرر عند ثبوت فشله وفق السياسة. [SRS-204] 3.6 التنفيذ الميداني والمزامنة [SRS-205] FR-053 | تقويم التشغيل [SRS-206] يعرض النظام تقويمًا هجريًا وميلاديًا يمكن تصفيته حسب الحجوزات والمهام. ويظهر الموعد والأوقات والفني والخدمات وحالة السداد والموارد، في حدود صلاحية المستخدم. [SRS-207] معيار القبول: تعرض البيانات المسموحة؛ لا يغير تحديث مهمة موعد الحجز أو قيمته تلقائيًا. [SRS-208] FR-054 | إسناد المهمة واستلامها [SRS-209] تُسند المهمة قبل المناسبة بيومين، أو فور اعتماد الحجز الأقرب من ذلك. ويثبت النظام استلام الفني للمهمة، ويقصر الوصول إليها على من أُسندت إليه. [SRS-210] معيار القبول: تظهر المهمة للفني الصحيح ويسجل الاستلام؛ تعالج المهمة المسحوبة كإصدار متغير. [SRS-211] FR-055 | الخدمات وملاحظات العميل [SRS-212] يستعرض مسؤول الخدمات الحجوزات المسندة إليه ويستلمها ويقرأ ملاحظات العميل والخدمات المطلوبة ويسجل تنفيذها من تطبيق الإدارة، دون الوصول للمال أو مهام الآخرين. [SRS-213] معيار القبول: تظهر خدمات المهمة في تطبيق الإدارة لمسؤولها ولا تظهر مهام غير مسندة؛ لوحة التحكم ليست بديلًا عن واجهته المعتمدة في التطبيق. [SRS-214] FR-056 | شرط الإرجاع قبل التركيب [SRS-215] قبل بدء التركيب، يتحقق النظام من إرجاع العهد اللازمة للحجز التالي، أو اعتماد نقل مباشر مطابق، أو وجود استثناء تشغيلي صحيح. ولا يكفي انتهاء المناسبة السابقة لإثبات الإرجاع. [SRS-216] معيار القبول: يمنع البدء إذا ظلت عهد لازمة غير مسواة بلا بديل معتمد. [SRS-217] FR-057 | مطابقة النقل المباشر [SRS-218] عند النقل المباشر بين حجزين، يسجل النظام الكميات السليمة والناقصة والتالفة، وهوية المسلم والمستلم، واعتماد المطابقة. [SRS-219] معيار القبول: تنقل السليمة فقط وتظل فروقات النقص والتلف ظاهرة. [SRS-220] FR-058 | ترحيل العهد بالنقل المباشر [SRS-221] يغلق النظام عهدة الكمية المنقولة في الحجز السابق ويفتحها في الحجز التالي، دون تسجيل عودة لم تحدث إلى المخزن أو احتساب الكمية مرتين. وتُصرف المواد الاستهلاكية الجديدة، ويُعوض عجز المستردات من الاحتياطي عند اعتماد ذلك. [SRS-222] معيار القبول: لا تظهر القطعة في العهدتين والمخزن معًا؛ لا تغلق الفروقات غير المسواة. [SRS-223] FR-059 | البديل الاحتياطي والاستثناء التشغيلي [SRS-224] يعتمد مدير العمليات القطع البديلة من مخزون متاح فعلًا، مع تسجيل السبب والكميات والحجز. ولا يلغي هذا الاستثناء عهدة معلقة، ولا يتجاوز شرط السداد. [SRS-225] معيار القبول: يرفض بديل غير موجود أو محاولة اعتبار الاستثناء التشغيلي إعفاءً ماليًا. [SRS-226] FR-060 | تحديث التركيب والصور [SRS-227] يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. يرفع الفني حتى ثلاث صور ليلة المناسبة ويحفظها محليًا عند الانقطاع لتظهر للعميل بعد المزامنة. تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. [SRS-228] معيار القبول: تحفظ الحالات والصور وتزامن، ويرفض العدد الزائد على ثلاث والحجم أو النوع غير المسموح. [SRS-229] FR-061 | تسجيل محلي منضبط [SRS-230] عند انقطاع الاتصال، يحفظ التطبيق الصور والقوائم والملاحظات والعمليات المسموح بها محليًا. ويرفق بكل عملية معرفًا فريدًا وإصدار المهمة ووقت التسجيل، مع تطبيق ضوابط حماية بيانات الجهاز والاحتفاظ بها. [SRS-231] معيار القبول: تبقى العملية المحلية معلقة قابلة للمزامنة عند انقطاع الاتصال. [SRS-232] FR-062 | إعادة المزامنة بلا تكرار [SRS-233] يزامن التطبيق العمليات تلقائيًا عند عودة الاتصال. وإذا تكرر معرف عملية سبق قبولها، يعيد الخادم نتيجتها السابقة دون إنشاء حركة مالية أو عهدة أو مهمة جديدة. [SRS-234] معيار القبول: تعيد المزامنة المكررة النتيجة نفسها ولا تضاعف الكميات أو الأثر. [SRS-235] FR-063 | مراجعة تعارض النسخة [SRS-236] يفحص الخادم صلاحية المستخدم وحالة المهمة وإصدارها قبل قبول المزامنة. ولا يعيد تفعيل مهمة ملغاة أو يستبدل بيانات أحدث بتغيير قديم. ويعرض حالة كل عملية، معلقة أو مقبولة أو مرفوضة، مع السبب وحفظ الأدلة المرتبطة بها. [SRS-237] معيار القبول: ترفض أو تحال للمراجعة نسخة مهمة مسحوبة دون حذف الدليل المحلي قبل تأكيد الحفظ حسب السياسة. [SRS-238] FR-064 | بدء التركيب والعمل دون اتصال [SRS-239] لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. [SRS-240] معيار القبول: يبدأ الفني ويسجل تم التركيب والصور دون اتصال، ثم يزامن دون تكرار ويُظهر التعارض للمراجعة. [SRS-241] 3.7 المحاسبة والاستحقاقات والولاء [SRS-242] FR-065 | الحسابات التشغيلية [SRS-243] تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. تشمل الوظائف المحافظ والصندوق والبنوك والسندات وحسابات الأطراف. [SRS-244] معيار القبول: توجد الحسابات الأساسية الأربعة ويضيف المحاسب الفروع وترفض عملة أخرى. [SRS-245] FR-066 | أثر القيود والتصحيح [SRS-246] يربط النظام كل سند وحركة بأصلها والمستخدم والتاريخ والاعتماد. وإذا احتاجت حركة معتمدة إلى تصحيح، يُجرى بعكسها أو بتسوية مرتبطة بها، دون حذفها أو استبدال بياناتها الأصلية. [SRS-247] معيار القبول: يبقى الأصل والتصحيح قابلين للتتبع ولا يرحل طلب معاد الإرسال مرتين. [SRS-248] FR-067 | أساس استحقاق الفني والخدمات [SRS-249] لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. [SRS-250] معيار القبول: يطبق تخصيص الحجز إذا أدخل، وإلا الافتراضي؛ لا يعامل الصفر كحقل فارغ. [SRS-251] FR-068 | المعلق والمستحق والمصروف [SRS-252] عند اكتمال سداد الكوشة، يسجل النظام استحقاقات الفني ومسؤول الخدمات كأرصدة معلقة. وتصبح قابلة للصرف بعد بلوغ نقطة الإنجاز المعتمدة لكل طرف، مع عرض المعلق والمستحق والمصروف والتسويات بصورة منفصلة. [SRS-253] معيار القبول: لا يكفي أول حدث تركيب أو إرجاع لجميع الأطراف إلا إذا كانت تلك سياستهم المعتمدة. [SRS-254] FR-069 | عمولة شريك القاعة [SRS-255] تحسب عمولة القاعة من صافي المدفوع بعد الخصم. تؤخذ قيمة الحجز المخصصة إن وجدت، وإلا الافتراضي في بطاقة الطرف. تربط بالحساب المالي والتحصيل؛ التصحيح بعد الصرف بتسوية لا حذف. [SRS-256] معيار القبول: تطابق العمولة الأساس المعتمد ويتتبع الحجز والقاعة والتحصيل. [SRS-257] FR-070 | تسوية استحقاق سبق صرفه [SRS-258] إذا وقع إلغاء أو استرداد أو تعديل أو تلف بعد الصرف، ينشئ النظام تسوية مرتبطة بالحركة السابقة. وعندما تتجاوز مطالبة التلف الرصيد المتاح للخصم، يُظهر المبلغ المتبقي وفق السياسة المعتمدة. [SRS-259] معيار القبول: لا يحذف الصرف السابق ولا تختفي المطالبة الزائدة عن الرصيد. [SRS-260] FR-071 | كسب نقاط الولاء [SRS-261] يمنح النظام نقاط الولاء للحجوزات المكتملة، وفق المستفيدين وتعريف الاكتمال ومعادلة المنح المعتمدة. ولا يكرر منح النقاط عند تكرار حدث الاكتمال أو المزامنة. [SRS-262] معيار القبول: يكسب المستفيد المؤهل النقاط مرة واحدة للحجز المكتمل. [SRS-263] FR-072 | استبدال الولاء والتسوية [SRS-264] يتيح النظام استبدال النقاط بخصم على حجوزات قادمة، لا بمبلغ نقدي. ويطبق مدة صلاحيتها وحدود جمعها مع العروض، وتسوياتها عند التعديل أو الإلغاء أو الاسترداد. [SRS-265] معيار القبول: لا يصرف رصيد النقاط نقدًا وتطابق الخصومات والتسويات أمثلة السياسة. [SRS-266] FR-073 | تقييم مسؤولية التلف [SRS-267] يسجل النظام حادث التلف مع الصنف والكمية والأدلة والحجز والقيمة والاعتماد، ويحدد الطرف الذي يتحمله: العميل أو الفني أو المؤسسة. وإذا اعتُمد توزيع المسؤولية، فلا يتجاوز مجموع الأنصبة قيمة الحادث. [SRS-268] معيار القبول: لا تحمل قيمة التلف كاملة مرتين، ولا يتحول إثبات المطالبة إلى تحصيل. [SRS-269] FR-074 | الأثر المالي للتلف [SRS-270] بحسب جهة تحمل التلف، ينشئ النظام مطالبة على العميل، أو خصمًا معتمدًا من استحقاق الفني، أو مصروف تلف على المؤسسة. وتُراجع صلاحية القطعة للاستخدام بصورة مستقلة عن الجهة التي تحملت تكلفتها. [SRS-271] معيار القبول: يسجل الأثر في الجهة الصحيحة وتبقى القطعة التالفة غير متاحة حتى المعالجة المعتمدة. [SRS-272] 3.8 المخزون والعهد والإرجاع [SRS-273] FR-075 | تعريف الصنف والتوريد [SRS-274] يتيح النظام تعريف الأصناف ووحداتها وكمياتها، وتحديد ما إذا كانت مستردة أو استهلاكية. ويسجل التوريد بحركات مخزنية موثقة. [SRS-275] معيار القبول: تعكس حركة توريد صحيحة الكمية ونوعها دون تعديل إجمالي خفي. [SRS-276] FR-076 | صرف القالب للعهدة [SRS-277] تجلب مكونات القالب، ويختار الفني أدوات الطلب المسحوبة وكمياتها ضمن الصلاحية والتوفر. تربط الحركة بالحجز والمهمة والعهدة دون تعديل سعر الخدمة. [SRS-278] معيار القبول: ينتج صرف معتمد بالمكونات المتاحة المرتبطة بالحجز؛ يرفض الصرف من رصيد غير موجود. [SRS-279] FR-077 | تعديل قائمة الصرف [SRS-280] يسجل النظام سبب تعديل المكونات أو استبدالها، ويفحص توفر البدائل. وإذا أثر التغيير في الخدمة أو السعر أو العقد، يعيده إلى مسار تعديل الحجز بدل تنفيذه كتغيير مخزني فقط. [SRS-281] معيار القبول: لا ينفذ تغيير سعر خفي من شاشة المخزن ولا يعتمد استبدال غير متاح. [SRS-282] FR-078 | عرض أرصدة المخزون [SRS-283] يعرض النظام الكميات الموجودة والمتاحة والمحجوزة والمصروفة والمنقولة وتحت الفحص والتالفة، استنادًا إلى الحركات المخزنية. ولا يجمع هذه الحالات كأنها أرصدة مستقلة، بما يؤدي إلى احتساب القطعة أكثر من مرة. [SRS-284] معيار القبول: يمكن تفسير كل كمية بحركتها ولا تضاعف كمية نقل مباشر إجمالي المخزون. [SRS-285] FR-079 | الإرجاع الجزئي وحد الكمية [SRS-286] يؤشر الفني إرجاع ما استلمه مع الكميات والحالة. تدعم المطابقة الإرجاع الجزئي وتبقي المتبقي مفتوحًا، ولا تخفي علامة إرجاع الجميع نقصًا أو تلفًا أو تسمح بكمية زائدة. [SRS-287] معيار القبول: تظل العهدة مفتوحة للمتبقي ويرفض إرجاع زائد. [SRS-288] FR-080 | الفحص قبل الإتاحة [SRS-289] لا يعيد النظام القطعة المرتجعة إلى الرصيد المتاح إلا بعد اجتياز الفحص المطلوب. كما لا يعتبر المصروف أو المنقول أو التالف متاحًا لمجرد الانتقال إلى يوم جديد. [SRS-290] معيار القبول: لا يسمح حجز قطعة تحت الفحص كقطعة جاهزة قبل تحقق القاعدة المعتمدة. [SRS-291] FR-081 | جرد المخزون [SRS-292] يسجل النظام فرق الجرد ويعتمده بحركة مناسبة وفق السياسة المحددة، دون حذف حركات سابقة أو تعديل إجمالي المخزون مباشرة. [SRS-293] معيار القبول: يظهر فرق الجرد وأثره ومعتمده في التتبع. [SRS-294] FR-082 | فصل المستهلكات [SRS-295] لا يدرج النظام المواد الاستهلاكية المصروفة ضمن العهد المطلوب إرجاعها، ولا يقبل إدخالها بوصفها مواد مستردة إلا من خلال إجراء تصحيح معتمد. [SRS-296] معيار القبول: تستبعد الخدمة الاستهلاكية من كمية الإرجاع العادية. [SRS-297] FR-083 | تتبع حركة الصنف [SRS-298] يتيح النظام تتبع الصنف من المخزن إلى الحجز، ثم إلى الإرجاع أو النقل المباشر أو التلف. وتبقى مراجع الحركات محفوظة بعد أرشفة المستخدم أو القالب أو الحجز. [SRS-299] معيار القبول: يبقى مسار الصنف قابلًا للاسترجاع بعد أرشفة عناصره المرجعية. [SRS-300] FR-084 | الإغلاق التشغيلي دون إسقاط حقوق [SRS-301] لا يؤدي إغلاق الحجز إلى إسقاط مطالبة مالية أو عهدة متبقية. ولا تُغلق فروقات العهد إلا بعد تسويتها أو تسجيل المسؤولية عنها. [SRS-302] معيار القبول: يبقى دين أو فرق غير مسوى ظاهرًا بعد إغلاق الجزء المنفذ. [SRS-303] 3.9 تكامل الدفع والمطابقة [SRS-304] FR-085 | قائمة المزودين وموائماتهم [SRS-305] يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يحدد اسم المحفظة وحساب التاجر ووثائقها قبل الربط وتختبر القدرات الفعلية. [SRS-306] معيار القبول: تسلم محفظة واحدة مربوطة ومختبرة؛ لا تعرض محفظة غير منفذة كوسيلة عاملة. [SRS-307] FR-086 | إعدادات المزود وإخفاء الأسرار [SRS-308] تتضمن صفحة «إدارة طرق الدفع» التفعيل والإيقاف والبيئة وحساب التاجر وعناوين الربط والتوقيع والعملة والحدود والأولوية. تحفظ الأسرار على الخادم ولا تظهر كاملة، مع سجل تغيير. [SRS-309] معيار القبول: لا يظهر المفتاح كاملًا في التطبيق أو السجل وتنفصل أسرار الاختبار والإنتاج. [SRS-310] FR-087 | إنشاء طلب الدفع الخارجي [SRS-311] قبل إنشاء طلب لدى مزود الدفع، يتحقق الخادم من الحجز والمبلغ المستحق والعملة وصلاحية العملية. ثم يحفظ المرجع الداخلي ومرجع المزود عند توفره. [SRS-312] معيار القبول: يرتبط الطلب الصحيح بالمزود والحجز؛ لا يعد إنشاء المرجع تحصيلًا. [SRS-313] FR-088 | التحقق قبل إثبات النجاح [SRS-314] لا يسجل النظام نجاح الدفع إلا بعد التحقق من مصدر النتيجة وتوقيعها، أو من آلية التوثيق الرسمية المعتمدة، ومطابقة العملية الأصلية والمبلغ والعملة وحساب التاجر وبيئة التشغيل. [SRS-315] معيار القبول: ترفض أو تحال للمراجعة نتائج غير موثقة أو غير مطابقة؛ لا تكفي شاشة نجاح التطبيق. [SRS-316] FR-089 | ترحيل نجاح الدفع مرة واحدة [SRS-317] بعد توثيق نجاح الدفع، يسجل النظام القيد ويحدث المدفوع والمتبقي مرة واحدة، ثم يرسل الإشعار. ويظل تأكيد الحجز خاضعًا لشروطه، وليس لنجاح الدفع وحده. [SRS-318] معيار القبول: لا ينشئ إشعار مكرر قيدًا آخر، ولا يؤكد النجاح حجزًا منتهيًا تلقائيًا. [SRS-319] FR-090 | الإشعارات المتأخرة وغير المرتبة [SRS-320] لا يسمح النظام لإشعار قديم بتغيير حالة دفع موثقة إلى حالة غير صحيحة. وعند تعارض النتائج، يحيلها للتحقق والمطابقة دون تكرار القيود. [SRS-321] معيار القبول: لا يلغي إشعار انتظار قديم نجاحًا موثقًا. أما التسوية الجديدة الموثقة فتُعالج بمرجعها وأثرها الخاصين. [SRS-322] FR-091 | النتيجة المجهولة وانقطاع المزود [SRS-323] عند انقطاع الاتصال بمزود الدفع، يحتفظ النظام بالطلب ومراجعه في حالة «قيد التحقق». ويتابع النتيجة بالاستعلام أو المطابقة، دون افتراض الفشل أو بدء عملية دفع جديدة من الصفر. [SRS-324] معيار القبول: يستعاد المرجع بعد الانقطاع ولا ينشأ تحصيل بديل غير منضبط. [SRS-325] FR-092 | تعطيل مزود واحتفاظ تاريخه [SRS-326] يمكن تفعيل استقبال الطلبات الجديدة أو إيقافه لكل مزود على حدة. ويحتفظ النظام بالعمليات السابقة، ويواصل تتبعها ومطابقتها وإظهارها في التقارير حتى بعد إيقاف المزود. [SRS-327] معيار القبول: تعطيل المزود لا يحذف طلباته السابقة ولا يؤثر في وسائل أخرى. [SRS-328] FR-093 | مطابقة تقارير المزود [SRS-329] يستورد النظام تقارير المزود بالصيغة المعتمدة، ويطابق المراجع والمبالغ والعملات وبيئة التشغيل. وإعادة استيراد التقرير نفسه لا تنشئ أثرًا ماليًا جديدًا. [SRS-330] معيار القبول: تظهر الناجحة غير المسجلة والمكررة والمختلفة دون تكرار قيد الاستيراد. [SRS-331] FR-094 | تسوية فروقات المطابقة [SRS-332] يسجل النظام كل فرق مطابقة بمرجع وحالة وقرار ومعتمد، ويتيح تقاريره حسب المزود والفترة. ولا يُفترض جلب التقارير آليًا من مزود لا يدعم ذلك. [SRS-333] معيار القبول: يتتبع فرق حتى قراره وتطابق تقاريره البيانات المعتمدة. [SRS-334] FR-095 | تنفيذ الاسترداد بحسب القدرة [SRS-335] ينفذ النظام الاسترداد الكامل أو الجزئي عبر API عندما تكون الخدمة مدعومة ومعتمدة للمزود. وعند عدم توفرها، يستخدم مسارًا يدويًا موثقًا. ويرتبط كل مسار بالتحصيل الأصلي واستحقاق الاسترداد وسقفه. [SRS-336] معيار القبول: لا يوصف طلب الاسترداد ناجحًا قبل إثبات نتيجته؛ يظهر المتبقي في الجزئي. [SRS-337] FR-096 | العكس وحالة الاسترداد [SRS-338] يميز النظام بين العكس الموثق من المزود والاسترداد الطوعي، ويحفظ مرجع العكس وأثره المالي. كما يفصل بين استرداد ثبت فشله وآخر لم تتضح نتيجته بعد. [SRS-339] معيار القبول: ينشأ أثر عكسي مرتبط دون حذف الأصل، ولا يحرر مبلغ استرداد مجهول النتيجة. [SRS-340] 3.10 الإشعارات والتقارير والتسليم [SRS-341] FR-097 | قنوات الرسائل وقوالبها [SRS-342] تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. [SRS-343] معيار القبول: تعمل القنوات المختارة لكل رسالة؛ رمز واحد بالقناتين يعد إرسالًا واحدًا؛ لا ترسل OTP عبر إشعارات التطبيق. [SRS-344] FR-098 | فشل الرسائل وإعادتها [SRS-345] يحفظ النظام حالة إرسال الرسالة والأخطاء ومحاولات الإعادة، ويتيح إعادة الإرسال وفق ضوابط المزود. ولا يُعد إرسالها موافقة أو دفعًا، ولا يلغي فشلها عملية صحيحة. أما فشل إرسال رمز التحقق فلا يسمح بتجاوز التحقق نفسه. [SRS-346] معيار القبول: فشل إشعار تحصيل لا يعكس المال؛ فشل رمز لازم لا يسمح بتجاوز التحقق. [SRS-347] FR-099 | الملفات والمستندات الخاصة [SRS-348] تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. تحفظ المرفقات في موضع غير قابل للتنفيذ ولا يغني الرابط عن فحص الصلاحية. [SRS-349] معيار القبول: تقبل الصور وPDF ضمن الحد، وترفض الملفات المخالفة والوصول لملفات الغير. [SRS-350] FR-100 | التقارير المعتمدة [SRS-351] تشمل التقارير كشف الحساب والقيود اليومية والمصروفات اليومية وطرق الدفع والإيرادات والربح والخسارة والحجوزات ومرشحاتها، والقاعات وحساباتها، والفنيين ومسؤولي الخدمات وحساباتهم، والكوش ومرات حجزها والعملاء والقاعات المرتبطة بها، ومبالغ الإلغاء المستردة وأهليتها. تطابق الإجماليات الحركات الموثقة. [SRS-352] معيار القبول: تطابق التقارير بيانات الاختبار وتظهر متبقي رصيد الإلغاء بعد الاستخدام دون ازدواج. [SRS-353] FR-101 | متابعة الاستثناءات التشغيلية [SRS-354] تشمل المتابعة التشغيلية أخطاء الدفع والمزامنة، وتراكم الطلبات التي تنتظر المراجعة، وفشل النسخ الاحتياطي. وتُحدد جهات الإخطار وإجراءات المعالجة، دون إضافة لوحة تحليل جديدة لم يتفق عليها. [SRS-355] معيار القبول: يولد فشل مختبَر أثر متابعة وإخطارًا وإجراء معالجة طبقًا لدليل التشغيل. [SRS-356] FR-102 | تصدير بيانات العميل [SRS-357] يحصل العميل على نسخة قابلة للاستخدام من بياناته وقاعدة بياناته وملفاته التشغيلية دون اشتراط شراء الشفرة، مع استبعاد أسرار الشركة وبيانات الآخرين وتوثيق الصيغة وطريقة التسليم. [SRS-358] معيار القبول: تفتح العينة المصدرة وتتطابق الملفات مع مراجعها ولا تشمل بيانات خارج نطاق العميل. [SRS-359] FR-103 | توثيق الواجهات وبيئة الاختبار [SRS-360] تسلم الشركة توثيق OpenAPI/Swagger لجميع الوظائف، بما يشمل المدخلات والمخرجات والصلاحيات والأخطاء والأمثلة ومفاتيح منع التكرار. وتوفر بيئة اختبار مستقلة والمخططات اللازمة لفهم الواجهات. [SRS-361] معيار القبول: يمكن استدعاء وظائف النطاق وفق التوثيق في البيئة المستقلة؛ ليست الوثيقة قائمة أسماء فقط. [SRS-362] FR-104 | حزمة التسليم وأدلة القبول [SRS-363] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. [SRS-364] يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. [SRS-365] لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. [SRS-366] معيار القبول: تراجع المخرجات والمنصات وحقوق البيانات وخطة التدريب وحد تكلفة الزيارة ومسؤولية الإدخال. [SRS-367] 3.11 تسجيل صاحب القاعة وإعداد العربون [SRS-368] FR-105 | نوع الحساب وبيانات صاحب القاعة [SRS-369] عند إدخال الاسم في تطبيق العميل، يختار المستخدم نوع حسابه: «عميل» أو «صاحب قاعة». وإذا اختار صاحب قاعة، تظهر حقول رقم تواصل القاعة وموقعها ورابط Google Maps وسعر الإيجار بالريال اليمني، وتُحفظ مرتبطة بحسابه. وتتاح له وظائف الشريك السابقة داخل التطبيق نفسه، دون الوصول إلى بيانات قاعات أخرى. [SRS-370] معيار القبول: يظهر لكل نوع حساب مساره المناسب. وعند اختيار «صاحب قاعة»، تظهر الحقول الأربعة وتُحفظ وتُعرض لصاحبها، مع بقاء تحقق الهاتف وصلاحيات الخادم. ولا يضيف رابط الموقع خدمة خرائط مدفوعة أو إمكانية حجز إيجار القاعة عبر النظام. [SRS-371] FR-106 | إعداد العربون في لوحة التحكم [SRS-372] تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. [SRS-373] معيار القبول: يغير المخول المبلغ الثابت مع حفظ الأثر وعدم تغيير العقود السابقة بصمت؛ لا نسبة أو معادلة في هذا الإعداد. [SRS-374] 4. الواجهات والبيانات المشتركة [SRS-375] 4.1 حدود الواجهات [SRS-376] الواجهة | المحتوى المطلوب وحدود الاعتماد واجهات المستخدم | تطبيق العميل للعملاء وأصحاب القاعات؛ تطبيق الإدارة للفنيين والخدمات؛ كلاهما Flutter. لوحة التحكم PHP / Laravel. تصميم الشاشات لا يوسع صلاحيات الأدوار. الخادم والتطبيقات | RESTful API، JSON، HTTPS/TLS؛ جميع وظائف النطاق دون اتصال مباشر بقاعدة البيانات. مزود الدفع | محفظة خارجية واحدة؛ تحقق ومطابقة واسترداد بحسب الدعم. كل إضافة باتفاق مستقل. الرسائل والتحقق | واتساب وSMS وإشعارات التطبيق عدا OTP، والبريد للتحقق في مساره المحدد. الملفات والتصدير | مرفقات وحوالات وصور وعقود وسندات ونسخ بيانات وفق النوع والحجم والصلاحية والسياسة. المزامنة | عمليات الفني المسموح بها فقط، بمعرف وإصدار مهمة ونتيجة؛ لا وعد بجميع الوظائف دون اتصال. [SRS-378] التقارير المطلوبة [SRS-379] التقرير | المحتوى كشف الحساب | الحركات والرصيد بحسب الحساب والفترة. القيود اليومية | القيود وحساباتها ومراجعها ومبالغها. المصروفات اليومية | المصروفات بحسب اليوم والحساب. طرق الدفع | التحصيلات والتسويات بحسب وسيلة الدفع. الإيرادات والربح والخسارة | الإيرادات والمصروفات والنتيجة للفترة. الحجوزات | الحجوزات ومرشحات التاريخ والحالة والعميل والقاعة. قاعات الأفراح وحساباتها | حجوزات القاعات وحساباتها المالية. الفنيون ومسؤولو الخدمات | المهام والحسابات المالية لكل طرف. الكوش ومرات الحجز | الكوش والعملاء والقاعات المرتبطة بالحجوزات وعددها. مبالغ الإلغاء المستردة | الحجز الملغى والعربون والبديل والرصيد المستخدم والمتبقي وأهلية الصرف. [SRS-381] 4.2 مجموعات API الواجب تغطيتها [SRS-382] تشمل الواجهات مجموعات Authentication، Users، Catalog، Availability، Bookings، Payments، Wallet، Contracts، Partners، Technicians، Inventory، Services، Notifications، Reports، Admin، Audit. وتُحدد أسماء المسارات وطرق HTTP وحقول الطلب والاستجابة في التصميم وتوثيق OpenAPI؛ فلم تُعتمد عناوين Endpoint تفصيلية ضمن هذه الحزمة. [SRS-383] 4.3 الحد الأدنى لوصف كل واجهة [SRS-384] يوثق كل مسار API بغرضه وصلاحياته ومدخلاته ومخرجاته وأخطائه ومنع التكرار، والنتيجة المباشرة أو مرجع المتابعة، مع أمثلة وأثر المال والمخزون والتدقيق. [SRS-385] 4.4 ضوابط البيانات العابرة للوحدات [SRS-386] تحفظ مراجع الحركات ونسخ العقود والأسعار والمكونات ومبلغ العربون ونوع الحساب. تبقى حالات الحجز والدفع والعهد مستقلة، ويختلف الرصيد المتاح للحجز عن المؤهل للسحب النقدي. [SRS-387] 5. متطلبات الجودة والتشغيل [SRS-388] NFR-01 | مصدر المنطق والبيانات [SRS-389] الخادم المركزي هو المرجع المعتمد للبيانات والقواعد التشغيلية والمحاسبية. ولا تتصل التطبيقات أو المتصفح بقاعدة البيانات مباشرة. [SRS-390] التحقق: فحص مسارات الوظائف واختبار رفض الوصول المباشر؛ T30. [SRS-391] NFR-02 | بروتوكول الواجهات [SRS-392] تستخدم الواجهات RESTful API وJSON وHTTPS/TLS، مع إصدارات واضحة وصيغة موحدة للنتائج والأخطاء. وتدعم تقسيم النتائج إلى صفحات والبحث والتصفية والترتيب حيث تحتاج الوظيفة إلى ذلك. [SRS-393] التحقق: مراجعة التوثيق وتشغيل نماذج الواجهات والتحقق من النقل المشفر؛ T30. [SRS-394] NFR-03 | سلامة التنفيذ الذري [SRS-395] تُنفذ العمليات المترابطة على الموارد والأرصدة كوحدة واحدة: إما أن يثبت أثرها كاملًا، أو تتراجع عند الفشل، دون ترك تخصيص أو حركة جزئية خاطئة. [SRS-396] التحقق: إحداث فشل وتزامن فعليين وفحص موارد وقيود العملية؛ T04 وT12 وT21. [SRS-397] NFR-04 | منع تكرار الأثر [SRS-398] تستخدم العمليات الحساسة مفاتيح لمنع التكرار. وعند إعادة الطلب نفسه، يعيد النظام نتيجته السابقة، ويرفض استخدام المفتاح نفسه مع بيانات مختلفة. ويحدد التصميم نطاق المفتاح ومدة الاحتفاظ به وطريقة ربطه بالعملية. [SRS-399] التحقق: إعادة طلب مطابق ومختلف تحت التزامن ومقارنة عدد الآثار؛ T15 وT21 وT22. [SRS-400] NFR-05 | التحقق وحدود الطلبات [SRS-401] يتحقق الخادم من المدخلات والسعر والتوفر والصلاحيات، ويطبق حدود الطلبات المعتمدة. ولا يعتمد على تحقق واجهة المستخدم وحدها. [SRS-402] التحقق: تجربة المدخلات غير الصحيحة وحدود الطلبات والصلاحيات ورفض المخالفات. [SRS-403] NFR-06 | حماية الأسرار والبيئات [SRS-404] لا تُضمّن المفاتيح أو الرموز السرية في التطبيقات أو السجلات. وتُفصل أسرار بيئة الإنتاج عن الاختبار، مع ضبط صلاحيات فريق الدعم وتوثيق وصوله إلى البيانات الحساسة. [SRS-405] التحقق: مراجعة إعدادات وملفات وسجلات البيئة التجريبية وأثر وصول الدعم؛ T02 وT22 وT30. [SRS-406] NFR-07 | حماية الملفات وخصوصية السجل [SRS-407] تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. [SRS-408] التحقق: تحميل وتنزيل مصرح وغير مصرح وملفات مخالفة للحدود؛ T03 وT27. [SRS-409] NFR-08 | أمان الدفع [SRS-410] يتحقق النظام من إشعارات الدفع وفق آلية المزود، ويمنع تنفيذ أثرها أكثر من مرة. ولا يخزن بيانات البطاقات الحساسة أو يكشف الأسرار. [SRS-411] التحقق: اختبار إشعار غير صحيح ومكرر ومتأخر وأقدم؛ T22. [SRS-412] NFR-09 | سلامة الوقت والقياس المالي [SRS-413] تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. تُضبط من إعدادات النظام فترات إشغال الموارد والتجهيز والنقل والفحص، وسعات الألوان اليومية، والمنطقة الزمنية وطريقة التحويل الهجري. لا تصبح القطعة المصروفة أو المنقولة أو تحت الفحص متاحة لمجرد تغير اليوم. [SRS-414] التحقق: مطابقة الأمثلة الزمنية والحسابية، وإظهار YER ورفض عملة مختلفة دون تحويل صامت؛ T04 وT20 وT29 وT33 وT42. [SRS-415] NFR-10 | تحمل انقطاع الاتصال [SRS-416] لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. [SRS-417] التحقق: قطع الاتصال بعد الإرسال ومتابعة الطلب الأصلي؛ T15 وT23 وT24. [SRS-418] NFR-11 | قابلية التتبع والتدقيق [SRS-419] يربط سجل الخطأ الطلب بالعملية والأصل المتأثر وسبب القرار، بما يتيح تتبع ما حدث. ولا يستطيع مستخدم التشغيل محو أثر عمله. [SRS-420] التحقق: تتبع حادثة من طلبها إلى أثرها واعتمادها دون كشف أسرار؛ T03 وT25 وT36. [SRS-421] NFR-12 | الأداء تحت حمل محدد [SRS-422] تُقاس العمليات المتفق عليها في بيئة محددة، وبحجم معلوم من البيانات والمستخدمين المتزامنين. وتُقارن النتائج بأهداف الأداء المعتمدة، لا بانطباع عام عن سرعة النظام. [SRS-423] التحقق: اختبار حمل موثق ببيئة وحجم بيانات ومستخدمين وحدود قبول محددة قبل القياس. [SRS-424] NFR-13 | التوفر والدعم التشغيلي [SRS-425] يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. [SRS-426] التحقق: مراجعة سجلات القياس وحوادث اختبار ضمن القيم المعتمدة؛ T31 وT32. [SRS-427] NFR-14 | النسخ والاستعادة [SRS-428] تتولى الشركة المستضيفة النسخ الاحتياطية ضمن اشتراك VPS. توثق التغطية وطريقة طلب الاستعادة وتختبر قاعدة البيانات والملفات والعلاقات. لا تفترض مدة احتفاظ أو زمن استعادة غير محدد في الخدمة. [SRS-429] التحقق: استعادة فعلية ومقارنة البيانات مع هدف فقد البيانات ومدة الاستعادة المعتمدين؛ T28. [SRS-430] NFR-15 | التوافق وحدود المنصات [SRS-431] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. [SRS-432] التحقق: مراجعة مخرجات الإصدار والتقنيات والتوزيع إلى تطبيقين، واختبار مصفوفة المنصات بعد تحديدها؛ T32 وT37. [SRS-433] NFR-16 | الفصل بين المزودين [SRS-434] يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. يفصل موائم المزود عن منطق الحجز والمال، وتبقى المطابقة بعد إيقاف الطلبات الجديدة. [SRS-435] التحقق: تعطيل أو إضافة موائم اختباري لا يعطل غيره وتظل العمليات القديمة قابلة للمطابقة؛ T26. [SRS-436] NFR-17 | حماية بيانات الجهاز [SRS-437] تُحدد البيانات التي تُحفظ على الجهاز ومدتها وحمايتها، وما يحدث لها عند تسجيل الخروج أو سحب الصلاحية. ولا يُفترض إمكان حذف البيانات أو سحبها فورًا من جهاز غير متصل. [SRS-438] التحقق: اختبار البيانات المحلية والخروج وسحب الصلاحية والمزامنة دون افتراض سحب فوري من جهاز غير متصل. [SRS-439] NFR-18 | اكتمال التوثيق والتسليم [SRS-440] تسلم أدلة الاستخدام والتشغيل والواجهات والاختبارات الفعلية وبيانات العميل، مع حفظ حقوق الاستخدام والمصدر. يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. [SRS-441] التحقق: مطابقة قائمة التسليم ومصفوفة التتبع ونتائج الاختبار ونسخة البيانات؛ T28 وT30 وT32. [SRS-442] متابعة التشغيل والخدمة [SRS-443] المجال | ما يحدد ويختبر الأداء | البيئة والعمليات وعدد المستخدمين والبيانات وحدود القبول قبل القياس. الاستضافة | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. الضمان والدعم | المدد والاستجابة والتكاليف حسب الاتفاق، دون افتراض دعم مفتوح. التدريب | يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. [SRS-445] لم تحدد قيم عددية للأداء أو مدد الضمان والدعم هنا. تثبت قبل اختبارها، ولا يفترض تشغيل غير محدود. [SRS-447] 6. معايير القبول وسجل الاختبارات [SRS-448] يتطلب القبول اكتمال الوظائف وسلامة المال والعهد والصلاحيات واجتياز الاختبارات وتسليم الأدلة والبيانات. يُختبر التزامن بطلبات متداخلة فعلًا. لا يعد عرض الشاشات أو مرور الوقت قبولًا نهائيًا. [SRS-449] شدة العيب | أثرها على القبول حرج | فقد أو فساد أو تسرب بيانات، أو تحصيل/رد مكرر، أو تخصيص فوق السعة: يمنع القبول النهائي حتى الإصلاح وإعادة الاختبار. جسيم | تعطل مسار أساسي دون بديل معتمد: يمنع قبول الجزء المتأثر. متوسط أو منخفض | يمكن إغلاقه بخطة ومسؤول وموعد وموافقة مكتوبة إذا لم يهدد الوظيفة الأساسية أو المال والبيانات. [SRS-451] يسجل لكل اختبار الإصدار والبيئة والبيانات والخطوات والنتيجة الفعلية والدليل والمنفذ والتاريخ. السيناريوهات التالية للاختبار عند التنفيذ وليست نتائج اختبار قائمة. [SRS-452] T01 | اختبار قبول [SRS-453] يُختبر التسجيل وربط الحسابات ودمجها وتغيير بيانات التواصل. ويُتحقق من ملكية الحساب، وعدم تكرار الأرصدة أو نقل الحجوزات إلى مستخدم غير مخول، ومن احتفاظ المستندات السابقة ببياناتها وقت الإصدار. [SRS-454] T02 | اختبار قبول [SRS-455] يُختبر قبول رمز OTP الصحيح قبل مرور 60 ثانية وضمن 3 محاولات، ورفضه عند انتهاء المدة أو استخدامه أو استنفاد المحاولات. وتُختبر الجلسة الملغاة مع التأكد من عدم كشف الأسرار. وتظل سياسة إعادة الإرسال مستقلة عن محاولات إدخال الرمز. [SRS-456] T03 | اختبار قبول [SRS-457] يحاول مستخدم الوصول إلى حجز أو عقد أو ملف يخص مستخدمًا آخر، ويحاول موظف تنفيذ عملية خارج صلاحياته. يجب أن يرفض الخادم هذه المحاولات، حتى عندما يكون المستخدمان ضمن الدور نفسه. [SRS-458] T04 | اختبار قبول [SRS-459] تُرسل طلبات متزامنة من العميل وصاحب القاعة داخل تطبيق العميل، ومن لوحة التحكم، لحجز آخر كمية مشتركة أو سعة لون متاحة. ويُتحقق من عدم تجاوز السعة، ومن تحرير أي تخصيص جزئي لطلب مرفوض. [SRS-460] T05 | اختبار قبول [SRS-461] عند إنشاء الحجز من لوحة التحكم، تُقفل الكوشة واللون والموارد اللازمة في موعد المناسبة لمدة 10 دقائق. إذا لم يتأكد سداد العربون خلالها، ينتهي القفل وتتحرر الموارد، حتى إن حُفظ الطلب. لا يمدد تحديث الشاشة القفل، ويتحول عند التأكيد الصحيح إلى تخصيص دون تكرار الكمية. يُختبر انتهاء القفل رغم حفظ الطلب وتأكيد صحيح داخله دون تكرار التخصيص. [SRS-462] T06 | اختبار قبول [SRS-463] بعد موافقة العميل، يُجرى تعديل جوهري على العقد ثم تُجرب وصلة الموافقة القديمة. يجب حفظ النسخة السابقة وطلب موافقة جديدة، وألا تسمح الوصلة القديمة باعتماد المحتوى المعدل. [SRS-464] T07 | اختبار قبول [SRS-465] تراجع الإدارة المخولة إشعار حوالة وتتحقق منه ثم تعتمد الصحيح. وتُختبر حالات الرفض وتأخر المراجعة والدفع قبل موافقة العقد بعد تحديد المهل. ولا تثبت صورة الإشعار وحدها التحصيل، ولا يُسجل المبلغ مرة ثانية عند المطابقة. [SRS-466] T08 | اختبار قبول [SRS-467] يصل تأكيد دفع موثق بعد انتهاء الحجز وتخصيص موارده لحجز آخر. يجب تسجيل المبلغ مرة واحدة، دون إعادة تأكيد الحجز المنتهي بما يتعارض مع الحجز الجديد. [SRS-468] T09 | اختبار قبول [SRS-469] تُجرّب تجزئة العربون بين أكثر من وسيلة، ثم محاولة دفعه من محفظة غير كافية. يجب رفض التجزئة، مع السماح بسداد الدفعات اللاحقة جزئيًا عندما تجيز القاعدة ذلك. [SRS-470] T10 | اختبار قبول [SRS-471] تسجل الإدارة تحصيلًا نقديًا، وتُجرّب محاولة تحصيل من الفني وبدء تركيب لحجز غير مسدد. يجب إصدار سند الإدارة، ومنع تحصيل الفني، ومنع بدء التركيب ما لم يوجد استثناء صحيح. [SRS-472] T11 | اختبار قبول [SRS-473] تُخفض قيمة حجز سُدد جزء منه. يجب أن ينخفض المتبقي دون إنشاء رصيد غير مستحق في المحفظة. وإذا تجاوز المحصل القيمة الجديدة، يُسوّى الفائض مرة واحدة. [SRS-474] T12 | اختبار قبول [SRS-475] تُجرّب عملية نقل موعد لا تتوافر موارده، ثم تحويل الحجز إلى تاريخ مفتوح. عند فشل النقل يبقى الموعد القديم. وعند اعتماد التاريخ المفتوح، تُحرر الموارد ويبقى المحصل المستحق فقط في المحفظة، دون رسوم تعديل أو قيد مكرر. [SRS-476] T13 | اختبار قبول [SRS-477] يستخدم العميل جزءًا من رصيد الإلغاء في حجز آخر قبل البديل، ويُرفض سحبه نقدًا. يؤكد مستأجر آخر الكوشة نفسها بتاريخ سابق أو لاحق للموعد الملغى؛ يظهر إشعار الأهلية ويصرف المتبقي غير المستخدم فقط دون زيادة الرصيد. [SRS-478] T14 | اختبار قبول [SRS-479] يُنشأ حجز قريب من المناسبة، وتُختبر عملية إسناد المهمة أو سحبها. يجب إحالة المراجعة والإسناد فورًا، دون تجاوز الشروط المالية أو التشغيلية تلقائيًا. [SRS-480] T15 | اختبار قبول [SRS-481] تُرسل المزامنة أكثر من مرة، ثم يصل تغيير محفوظ لمهمة سبق إلغاؤها. يجب منع التكرار وعدم اعتماد التعارض بصمت، مع حفظ الدليل وإظهار نتيجة المزامنة. [SRS-482] T16 | اختبار قبول [SRS-483] يحمل الفني مهمة مستوفية ثم يقطع الاتصال ويبدأ التركيب ويسجل اكتماله وصوره. تحفظ محليًا وترفع تلقائيًا عند الاتصال؛ التعارض مع تغيير لاحق يراجع دون إحياء مهمة ملغاة. [SRS-484] T17 | اختبار قبول [SRS-485] يُختبر الإرجاع الناقص والنقل المباشر والتعويض من الاحتياطي. يجب نقل العهد الصحيحة فقط، وعدم استخدام قطعة تالفة أو رصيد غير موجود، أو احتساب الكمية مرتين. [SRS-486] T18 | اختبار قبول [SRS-487] تُعدل قائمة الصرف، ويُسجل إرجاع جزئي وفرق جرد. ويُتحقق من التوفر والاعتماد، ومن رفض إرجاع كمية تتجاوز العهدة أو تغيير سعر الخدمة من خلال حركة مخزنية فقط. [SRS-488] T19 | اختبار قبول [SRS-489] يُسجل تلف بعد صرف الاستحقاق، ثم تُختبر مطالبة تتجاوز الرصيد المتاح للخصم. يجب إثبات التسوية والمبلغ المتبقي وفق السياسة، دون حذف الصرف السابق أو تحميل التلف مرتين. [SRS-490] T20 | اختبار قبول [SRS-491] يُطبق خصم أو تعديل أو استرداد بعد احتساب عمولة أو نقاط ولاء. يجب أن تطابق الحسابات الأساس المعتمد، وأن ترتبط التسويات بأصلها دون تكرار المنح أو الخصم. [SRS-492] T21 | اختبار قبول [SRS-493] تُرسل عمليتا إنفاق متزامنتان من المحفظة، ومحاولتا تسوية للاسترداد نفسه. يجب ألا يتجاوز الإنفاق الرصيد المتاح، ولا مجموع التسويات سقف الاسترداد عبر جميع المسارات. [SRS-494] T22 | اختبار قبول [SRS-495] تُختبر نتائج الدفع الناجحة والمرفوضة، والإشعارات غير الموثقة والمكررة وغير المرتبة. يجب التحقق من النتيجة وتسجيل قيد واحد، دون الرجوع إلى حالة أقدم، مع رفض المبلغ أو العملة أو حساب التاجر غير المطابق. [SRS-496] T23 | اختبار قبول [SRS-497] يتعطل مزود الدفع أو تنتهي مهلة الاستجابة بعد إرسال الطلب. يجب حفظ المرجع وإظهار الحالة قيد التحقق، ومتابعة النتيجة دون إنشاء دفع جديد قبل حسم العملية السابقة. [SRS-498] T24 | اختبار قبول [SRS-499] يُختبر الاسترداد الكامل والجزئي والطلب الذي لم تتضح نتيجته. يجب تطبيق سقف موحد، وحجز مبلغ الطلب الجاري، وعدم تسجيل الاسترداد ناجحًا لمجرد إرسال المحاولة. [SRS-500] T25 | اختبار قبول [SRS-501] يُستورد تقرير مزود يتضمن فروقات مرتين. يجب ألا ينتج الاستيراد الثاني أثرًا ماليًا مكررًا، وأن تظهر العمليات الناجحة غير المسجلة وغير المتطابقة للمراجعة الموثقة. [SRS-502] T26 | اختبار قبول [SRS-503] تختبر المحفظة الواحدة المشمولة وخصائصها، ويوقف استقبال طلبات جديدة مع بقاء المطابقة والتاريخ. لا يعد ذلك التزامًا بربط محفظة ثانية دون سعر مستقل. [SRS-504] T27 | اختبار قبول [SRS-505] يُختبر فشل إرسال إشعار، ورفع ملف مخالف، وتنزيل مستند خاص دون صلاحية. يجب ألا يغير فشل الإشعار التحصيل، وأن تُطبق ضوابط الملفات والوصول. [SRS-506] T28 | اختبار قبول [SRS-507] تُستعاد نسخة احتياطية في بيئة مستقلة، وتُصدر بيانات العميل. ويُتحقق من تطابق الحجوزات والقيود والأرصدة والمخزون والملفات ومراجعها. [SRS-508] T29 | اختبار قبول [SRS-509] تُختبر التقارير المعتمدة ومرشحاتها وإجمالياتها وتصديرها. يجب أن تتطابق مع القيود وبيانات الاختبار، وأن تشمل جميع الوظائف الواردة في قائمة التقارير المعتمدة. [SRS-510] T30 | اختبار قبول [SRS-511] تُراجع الواجهات وتوثيقها في بيئة الاختبار المستقلة. يجب أن تكون جميع الوظائف المطلوبة قابلة للاستدعاء وفق الصلاحيات، مع أمثلة واضحة للطلبات والنتائج والأخطاء. [SRS-512] T31 | اختبار قبول [SRS-513] يُجرى اختبار حمل بحجم التشغيل المتفق عليه. وتُقاس النتائج مقابل الأهداف المعتمدة، مع توثيق البيئة والبيانات، بدل الاكتفاء بانطباع عن سرعة النظام. [SRS-514] T32 | اختبار قبول [SRS-515] تُراجع حزمة التسليم: تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما Flutter، ولوحة PHP/Laravel والخادم والبيانات وبقية الحزمة. ويُتحقق من الأدوار والمنصات المحددة والحقوق المتفق عليها، دون افتراض نقل ملكية المصدر. [SRS-516] T33 | اختبار قبول [SRS-517] يُختبر تصفح النماذج والمكونات والوسائط والتصنيفات والتقويم والمرشحات والألوان والمفضلة والمشاركة وتنبيه المقاسات. يجب أن تطابق النتائج البيانات والسعات والسياسة، وأن تبقى نسخة الحجز ثابتة بعد تعديل القالب. [SRS-518] T34 | اختبار قبول [SRS-519] يتابع العميل عقده وصوره وتقييمه، ويتابع مسؤول الخدمات مهامه. يجب أن تقتصر الوظائف على صاحبها، وأن تنفصل المواد الاستهلاكية عن المستردة، مع الالتزام بحد 3 صور للفني. وتُختبر تفاصيل التقييم بعد اعتمادها. [SRS-520] T35 | اختبار قبول [SRS-521] تُرسل أنواع الرسائل المعتمدة، وتُختبر إعادة المحاولة والفشل. يجب إظهار المرجع وحالة الإرسال، دون اعتبار الإرسال موافقة أو تحصيلًا، أو استخدام فشله لتجاوز التحقق. [SRS-522] T36 | اختبار قبول [SRS-523] يُسجل سند وقيد ثم يُصحح، وتُراجع بيانات التدقيق. يجب أن يبقى الأصل والتصحيح والسبب والمعتمد قابلين للتتبع، دون حذف أو أثر مالي مكرر. [SRS-524] T37 | التطبيقان والتقنيات والتوزيع [SRS-525] تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. يُستخدم GitHub لحفظ المشروع وإدارة تحديثاته ونشرها، ويُنشر التطبيقان في App Store وGoogle Play من حسابات الشركة المبرمجة. يتحمل العميل رسوم الاستضافة والنطاق. تُختبر واجهات كل دور وحدود بياناته. [SRS-526] T38 | تسجيل صاحب القاعة [SRS-527] عند إدخال الاسم، يختار المستخدم «عميل» أو «صاحب قاعة». يجب أن تظهر لصاحب القاعة حقول رقم التواصل والموقع ورابط Google Maps وسعر الإيجار، وأن تُحفظ وتُعرض بالريال اليمني. ولا يمنحه اختيار نوع الحساب بيانات قاعة أخرى أو صلاحيات إدارية عامة. [SRS-528] T39 | حدود OTP الدقيقة [SRS-529] صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. يُختبر الفصل بين الإرسال ومحاولات الإدخال وعدم استخدام الرمز مرتين. [SRS-530] T40 | إعداد العربون [SRS-531] تضبط الإدارة المخولة العربون كمبلغ ثابت بالريال اليمني في لوحة التحكم، وليس نسبة أو معادلة. يحفظ كل حجز المبلغ الذي طُبق عليه، ولا يغيّر تعديل الإعداد الحجوزات السابقة بصمت. يُسدد العربون كاملًا من وسيلة واحدة دون تجزئة بين وسائل الدفع. يُختبر رفض تعديل المبلغ من غير المخول وعدم تغيير عقد سابق بصمت. [SRS-532] T41 | غياب الرسوم والتاريخ المفتوح [SRS-533] تُنفذ حالات تعديل وإلغاء للتأكد من عدم فرض أي رسوم. وفي مثال اختباري، يُحول حجز قيمته 100,000 والمدفوع منه 20,000، دون تسويات أخرى، إلى تاريخ مفتوح. يجب تحرير الموارد وإبقاء 20,000 في المحفظة مرة واحدة، لا كامل سعر الحجز. ويظل فرق سعر الخدمة المعدلة منفصلًا عن الرسوم. [SRS-534] T42 | العملة الوحيدة [SRS-535] تستخدم الأسعار والمحافظ والسندات والعمولات والتقارير YER وحدها. يرفض الطلب بعملة أخرى دون تحويل ضمني، وتطابق الدقة ضبط المحاسب. [SRS-536] T43 | الدوام والتأكيد الآلي [SRS-537] النتيجة المطلوبة: خارج دوام الإدارة، لا يقبل النظام تقديم طلب حجز يحتاج مراجعة إدارية، ولا ينشئ له طلبًا أو قفلًا أو تخصيصًا للموارد. تظهر رسالة بأن هذا المسار متاح وقت الدوام. يستمر الحجز والتأكيد الآلي بالمحافظ للعميل وصاحب القاعة، ويشمل ذلك رصيد المحفظة الداخلية الكافي. تُضبط أوقات الدوام من إعدادات النظام. يتأكد حجز العميل وصاحب القاعة تلقائيًا بعد نجاح الدفع الموثق بالمحفظة، دون موافقة إدارية على الدفع، مع استيفاء التوفر وموافقة العميل المطلوبة. في مسار الحوالة، يبقى الطلب بانتظار مراجعة الإدارة والتحقق من التحصيل. لا تكفي صورة الحوالة أو رسالة نجاح التطبيق لإثبات الدفع. [SRS-538] T44 | رصيد الإلغاء والأهلية النقدية [SRS-539] النتيجة المطلوبة: في الإلغاء بانتظار مستأجر بديل، تتحرر الكوشة ويُتاح العربون في محفظة العميل لاستخدامه في حجز كوشة أخرى، لكنه غير قابل للسحب نقدًا قبل تحقق البديل. يتحقق البديل بتأكيد حجز مستأجر آخر للكوشة نفسها وسداد عربونه، سواء كان موعد مناسبته قبل موعد الحجز الملغى أو بعده؛ لا يشترط تطابق الموعدين. يظهر للإدارة إشعار بأهلية الاسترداد وتقرير بالمبالغ المستردة من الإلغاء. لا يضيف تحقق البديل رصيدًا جديدًا ولا يصرف المال تلقائيًا. يقتصر الصرف النقدي على ما بقي من رصيد الإلغاء ولم يُستخدم في حجز آخر أو يصرف أو يُحجز لرد جارٍ؛ فلا يُنفق المبلغ ثم يصرف مرة ثانية. إلغاء البديل لاحقًا يحتاج مراجعة مالية، ولم يُحدد له أثر عكسي تلقائي. [SRS-540] T45 | إعادة استخدام رصيد التاريخ المفتوح [SRS-541] النتيجة المطلوبة: عند التحويل إلى تاريخ مفتوح، تُحرر موارد الحجز القديم ويُفك تخصيص المبلغ المحصل له، ويبقى في محفظة العميل دون رسوم، مع حفظ مرجع مصدره. يختار العميل حجزًا جديدًا و«الدفع من الرصيد»، فيؤكد النظام الحجز آليًا عند كفاية الرصيد للعربون كاملًا والتوفر والموافقة المطلوبة، بما في ذلك تساوي العربون الجديد مع السابق. عند اختلافه يُفحص الرصيد الفعلي، ولا يفترض أنه يكفي ولا يُقسّم العربون بين وسيلتين. [SRS-542] T46 | البريد البديل وحماية الحساب [SRS-543] النتيجة المطلوبة: صلاحية رمز التحقق دقيقة واحدة (60 ثانية)، وله ثلاث محاولات إدخال كحد أقصى. يظهر عداد للوقت المتبقي، ثم زر إعادة الإرسال بعد انتهاء الدقيقة. يُسمح بثلاث إرسالات إلى الهاتف إجمالًا: الإرسال الأول وإعادتان، وهي مستقلة عن محاولات إدخال كل رمز. إذا لم تصل الرسالة بعد ذلك وكان الدخول بالهاتف، يطلب التطبيق بريدًا إلكترونيًا يدخله المستخدم في تلك اللحظة ويرسل رمز التحقق إليه. لا يُستخدم الرمز أكثر من مرة أو لغرض مختلف، ولا تُحفظ قيمته نصًا في السجلات. إثبات ملكية البريد المدخل لا يثبت وحده ملكية رقم هاتف مسجل أو يجيز دمج حسابه ونقل محفظته وحجوزاته؛ تبقى إجراءات التحقق من ملكية الحساب ومراجعة تعارض الهوية مطبقة. [SRS-544] T47 | قنوات الرسائل [SRS-545] النتيجة المطلوبة: تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. [SRS-546] T48 | حدود الملفات [SRS-547] النتيجة المطلوبة: تقتصر الملفات المرفوعة من التطبيقين على الصور وPDF بحد أقصى 1 ميجابايت لكل ملف. يتحقق الخادم من النوع الفعلي والحجم وصلاحية المستخدم، وتبقى المستندات الخاصة محمية عند العرض والتنزيل. [SRS-548] T49 | استحقاق الطرف [SRS-549] النتيجة المطلوبة: لكل طرف حساب مالي وبطاقة موظف أو طرف تتضمن نسبة استحقاق أو مبلغًا افتراضيًا. يمكن تخصيص القيمة داخل طلب الحجز؛ إذا تُرك الحقل فارغًا، يستخدم النظام الافتراضي في بطاقة الطرف. الصفر المدخل صراحة ليس حقلًا فارغًا. يحفظ النظام القيمة والأساس المستخدمين؛ استحقاق الفني من السعر الأساسي للكوشة، وعمولة القاعة من صافي المدفوع بعد الخصم. [SRS-550] T50 | الحسابات والتقارير [SRS-551] النتيجة المطلوبة: تبدأ شجرة الحسابات بالأصول والمصروفات والإيرادات والالتزامات، وينشئ محاسب العميل الحسابات الفرعية اللازمة. تستخدم الأسعار والأرصدة والسندات والقيود والتقارير الريال اليمني (YER) وحده دون تحويل أو تعدد عملات. تطابق التقارير المالية وتقارير الحجوزات والقاعات والفنيين والخدمات والكوش والإلغاء بيانات الاختبار. [SRS-552] T51 | مراحل عمل الفني [SRS-553] النتيجة المطلوبة: يستعرض الفني ومسؤول الخدمات حجوزاتهما المسندة ويستلمانها ويطلعان على ملاحظات العميل، كل ضمن دوره. يختار الفني أدوات الطلب المسحوبة من المخزن، ويؤشر عند الإرجاع إلى إعادة ما استلمه مع مطابقة الكميات والحالة. يحدّث حالة الطلب إلى «تم استلام الطلب»، و«تنفيذ التركيب»، و«تم التركيب»، و«تم سحب الكوشة». لا يمنحه ذلك تحصيل المال أو تعديل الأسعار أو تجاوز صلاحية المخزن. تطابق الكميات المرتجعة بالعهدة ولا تخفي علامة إرجاع الجميع الفروق. [SRS-554] T52 | التدريب والتصدير [SRS-555] النتيجة المطلوبة: يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. [SRS-556] T53 | بدء التركيب دون اتصال [SRS-557] النتيجة المطلوبة: لا يشترط اتصال الفني بالإنترنت عند بدء التركيب. يعمل على المهمة المحفوظة في تطبيق الإدارة، ويسجل بدء التنفيذ وحالة «تم التركيب» والصور محليًا عند انقطاع الشبكة. تزامن البيانات تلقائيًا عند أول اتصال، وتظهر الصور للعميل بعد وصولها إلى الخادم. تبقى شروط السداد والعهد بحسب آخر حالة محفوظة، ولا يُطلب تفويض إضافي لمجرد الانقطاع. لا يستطيع الخادم تحديث جهاز غير متصل فورًا عند تغير السداد أو إلغاء المهمة. تُفحص حالة المهمة وإصدارها عند المزامنة، وتحال التعارضات للمراجعة مع حفظ الأدلة دون إحياء مهمة ملغاة أو مضاعفة الحركات. لا تعني المراجعة اللاحقة أن النظام منع تنفيذًا ميدانيًا وقع أثناء الانقطاع. [SRS-558] 7. تغطية المتطلبات بالاختبارات [SRS-559] تغطي الاختبارات الوظائف في المجالات التالية؛ ولا يغني اختبار عام للمجموعة عن معيار قبول كل متطلب. [SRS-560] المجال | المتطلبات | الاختبارات الهوية والوصول | FR-001–FR-010؛ FR-099؛ FR-105 | T01–T03؛ T27؛ T38–T39؛ T46؛ T48 الحجز والعقد | FR-011–FR-031؛ FR-106 | T04–T08؛ T12؛ T14؛ T33–T34؛ T40؛ T43؛ T45 المال والتعديل والإلغاء | FR-032–FR-052 | T09–T13؛ T21؛ T24؛ T41–T44 التنفيذ والمخزون | FR-053–FR-064؛ FR-075–FR-084 | T14–T19؛ T34؛ T51؛ T53 الحسابات والولاء | FR-065–FR-074 | T19–T20؛ T29؛ T36؛ T42؛ T49–T50 التكامل والتقارير والتسليم | FR-085–FR-104 | T22–T32؛ T35؛ T37؛ T47–T48؛ T50؛ T52 [SRS-562] 8. التسليم والتغيير والاعتماد [SRS-563] المخرج | المحتوى التطبيقات واللوحة | تتكون المنظومة من تطبيق العميل للعملاء وأصحاب القاعات، وتطبيق الإدارة للفنيين ومسؤولي الخدمات، وكلاهما مبني باستخدام Flutter ويعمل على Android وiOS باللغة العربية. وترتبط الواجهات بلوحة تحكم ويب بلغة PHP وإطار Laravel وخادم مركزي يعمل على Ubuntu. الدفع والرسائل | يشمل التنفيذ الحالي ربط محفظة إلكترونية خارجية واحدة، وتوجد صفحة «إدارة طرق الدفع» لإعدادها وتفعيلها وإيقافها وعرض قدراتها. يمكن إضافة محافظ بالتدريج، لكن لكل محفظة إضافية سعر واتفاق مستقلان؛ وجود صفحة الإعدادات لا يعني أن ربطها مشمول تلقائيًا. تتضمن لوحة التحكم إعدادات واتساب وSMS مع إمكان تفعيل كل قناة أو إيقافها واختيار قناة أو قناتين لكل نوع رسالة. يُرسل OTP نفسه إلى القناتين عند اختيارهما وتفعيلهما، ويحسب ذلك إرسالًا واحدًا لا إرسالين. يقترح النظام قوالب للرسائل، ومنها تأكيد الحجز وتذكير السداد والمهام. تعمل إشعارات التطبيق افتراضيًا للرسائل الأخرى عدا OTP، ويستخدم البريد لمسار التحقق والتحويل إليه بعد تعذر رمز الهاتف. تسجل نتيجة كل قناة دون اعتبار الإرسال إثباتًا للدفع أو الموافقة. التشغيل | يستضاف النظام على VPS يعمل على Ubuntu باشتراك سنوي. يتحمل العميل الاستضافة والنطاق، وتتولى الشركة المبرمجة الإعداد والإدارة التقنية للتطبيق. توفر البنية وخدمة النسخ الاحتياطي لدى الشركة المستضيفة؛ توثق تغطية النسخ للبيانات والملفات وآلية طلب الاستعادة. لا تُفترض نسبة توفر أو مدة احتفاظ غير محددة في الخدمة. البيانات والتوثيق | تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. التدريب والتهيئة | يبدأ التدريب بعد اختبار النظام خلال الشهر الأول من تشغيله، ويستمر شهرًا. تكلفة النزول الميداني لا تتجاوز 15 دولارًا لكل زيارة، لا لمجموع زيارات الشهر. تُنسق المواعيد مع العميل دون افتراض عدد زيارات أو جلسات لم يحدد. يجهز العميل ملفات البيانات الأولية ويحدد حجمها ومحتواها، ويدخلها موظف من طرفه بمساعدة الشركة المبرمجة. لا يُفترض ترحيل تاريخي شامل أو إدخال جميع البيانات بواسطة الشركة. [SRS-565] تبقى الشفرة مملوكة للشركة المبرمجة والبيانات التشغيلية للعميل. يحق للعميل طلب الشفرة وحزمة المشروع وملفات قاعدة البيانات اللازمة للتشغيل بمقابل حسب الاتفاق، لا يتجاوز قيمة النظام الأساسية قبل التوسعات حسب الاتفاق. يظل حقه في الحصول على نسخة من بياناته التشغيلية مستقلًا عن شراء الشفرة. لا يعني تسليم المصدر تلقائيًا نقل ملكيته أو حق إعادة بيعه؛ تحدد حقوق استخدامه وصيانته في اتفاق التسليم. [SRS-566] تغيير المتطلبات وضبط النسخ [SRS-567] يعالج عدم مطابقة المتطلب كعيب، والتفصيل اللازم لتحقيق النتيجة نفسها كإيضاح. إضافة وظيفة أو منصة أو تكامل جديد طلب تغيير يوضح أثره الفني والمالي والزمني ويعتمده العميل قبل التنفيذ. [SRS-568] اعتماد الوثيقة [SRS-569] الطرف | الاسم والمسؤولية | التوقيع والتاريخ العميل ومفوضوه | عبدالله وأخوه طه؛ اعتماد النطاق والسياسات والقبول. | ........................ الشركة المبرمجة | التنفيذ والاختبار والتوثيق. | ........................ [SRS-571] يثبت قبول النظام بعد مراجعة المخرجات ونتائج الاختبار، وليس بمجرد إعداد هذه الوثيقة.