Qwizin — سيناريوهات سمات الجودة

الحالة: مسودة v0.1 · التاريخ: 2026-07-20 المُدخل: 00-requirements-baseline.md · المنهج: الصيغة السداسية للسيناريو (المصدر، المحفّز، المكوّن، البيئة، الاستجابة، مقياس الاستجابة)

الملخّص#

الوثائق المصدرية تذكر أهداف الجودة كصفات فقط: "آمن"، "قابل للتوسّع"، "سهل الاستخدام"، "مكالمات فيديو مستقرة". لا شيء منها قابل للقياس، وبالتالي لا شيء منها قادر على توجيه قرار تصميمي أو دحضه. تحوّل هذه الوثيقة تلك الصفات إلى 21 سيناريو قابلًا للاختبار.

النتيجة الأبرز هي أن سمات الجودة المهيمنة في Qwizin ليست تلك التي تُشدّد عليها الوثائق. الوثائق تركّز على التكلفة وسهولة الاستخدام. أما المعمارية فتهيمن عليها فعليًا:

1. السرّية وعزل المستأجرين (tenant isolation) — تحتفظ المنصة بسجلات تجارية وبطاقات ضريبية وسجلات صاحب عمل عن موظفيه. تسريب عابر للمستأجرين حدث وجودي وواجب الإبلاغ بموجب PDPL. هذا يتفوّق على كل ما عداه.
2. سلامة التقييم والشهادات — الشهادات تُثبت كفاءة في سلامة الغذاء. شهادة قابلة للتزوير أو العبث تنقل خطرًا واقعيًا إلى روّاد المطاعم وتُدمّر ادعاء القيمة الجوهري للمنصة. هذا شأن مجاور للسلامة (safety-adjacent) لا تتعامل معه أي وثيقة مصدرية على هذا الأساس.
3. قابلية التعديل عند نقاط الفصل المستقبلية (seams) للمرحلة الثانية — يلتزم CONF-04 بنطاق للمرحلة الثانية يبلغ أضعاف نطاق الـ MVP. تكلفة الخطأ في رسم الحدود هي إعادة كتابة كاملة.

في المقابل، التوافرية (availability) والأداء الخام متطلبات متوسطة. هذا نظام مواعيد مجدولة وتنزيل مستندات ودليل كثيف القراءة — لا مِقسم مدفوعات ولا منصة تداول لحظية. المبالغة في هندسة التوافرية على حساب السمات الثلاث أعلاه هي الخطأ الكلاسيكي هنا.

منهج تحديد الأولويات#

يحمل كل سيناريو زوجًا بأسلوب ATAM (القيمة التجارية، الأثر المعماري)، كل منهما H/M/L.

• (H,H) — يجب التصميم لها صراحةً والتحقق منها. هذه هي التي تقود المعمارية.
• (H,L) — مهمّة لكن يمكن تحقيقها بالممارسات المعتادة؛ لا تُفرط في الاستثمار فيها.
• (L,H) — مكلفة معماريًا مقابل قيمة محدودة؛ مرشّحة للتأجيل المتعمّد.

1. الأمن — السرّية وعزل المستأجرين#

QAS-SEC-01 — عزل بيانات المستأجرين (H,H) ⭐ الأولوية القصوى#

المبرّر: العيب الكارثي الأرجح على الإطلاق في تطبيق Laravel متعدد المستأجرين هو استعلام نسي نطاق المستأجر الخاص به. فحوص التخويل لكل نقطة نهاية تفشل لأنها تعتمد على انضباط المطوّر عند كل نقطة نهاية جديدة إلى الأبد. يفرض المقياس عمدًا آلية إنفاذ لا نتيجة، لأن الآلية وحدها هي القابلة للاختبار مسبقًا.

QAS-SEC-02 — سرّية المستندات القانونية (H,H)#

QAS-SEC-03 — رفع ملف خبيث (H,M)#

QAS-SEC-04 — نطاق الضرر عند اختراق بيانات الاعتماد (H,M)#

2. السلامة — التقييم والشهادات#

QAS-INT-01 — سرّية مفتاح إجابات التقييم (H,H) ⭐#

المبرّر: التنفيذ الساذج يرسل كائن السؤال كاملًا — بما فيه is_correct — إلى العميل ويصحّح محليًا. ينصّ SRC-MOM REQ-05 على "التصحيح الآلي الفوري"، وهو ما يدعو إلى هذا تحديدًا. ولأن الشهادات تحمل وزنًا خارجيًا، فهذا ضابط سلامة لا ترفًا.

QAS-INT-02 — العبث بالدرجات (H,M)#

QAS-INT-03 — أصالة الشهادة (H,M)#

يعتمد على OQ-09. إذا استُبعد التحقق من النطاق، ينزل هذا السيناريو إلى (M,L) — لكن على المعماري أن يلاحظ أن شهادة سلامة غذاء غير قابلة للتحقق يسهل تزويرها في محرّر رسوميات، وهو ما يقوّض SRC-MOM KPI 3 وادعاء المنصة بالمصداقية.

3. التوافرية#

موقف متعمّد: لا تحتاج Qwizin إلى أربعة تسعات. تحتاج توافرية يمكن التنبؤ بها مركّزة في ساعات العمل السعودية، وتحتاج ألّا تفشل الاستشارات المحجوزة. يجب أن يكون الاستثمار في التوافرية غير متماثل.

QAS-AVL-01 — استشارة الفيديو في موعدها (H,H) ⭐#

هذا أعلى سيناريوهات التوافرية قيمةً لأن الفشل فيه هو في الوقت نفسه حدث استرداد، وحدث سمعة، وفشل في سوق ثنائي الجانب — فهو يحرق فترة المستشار الزمنية ومال العميل معًا.

QAS-AVL-02 — توافرية المنصة الأساسية (H,M)#

QAS-AVL-03 — انقطاع مزوّد المدفوعات (H,M)#

QAS-AVL-04 — التدهور السلس للوحدات غير الحرجة (M,M)#

4. الأداء وقابلية التوسّع#

QAS-PERF-01 — استجابة API الجوال على شبكات الجوال السعودية (H,M)#

QAS-PERF-02 — البحث في الـ marketplace باللغة العربية (H,H) ⭐#

مُصنَّف (H,H) عن قصد. جودة البحث العربي هي المكان الذي تفشل فيه المنظومات الساذجة فشلًا ذريعًا، وهي ليست مسألة تجميلية — المستخدم السعودي الذي يبحث بالعربية فلا يجد شيئًا يستنتج أن الدليل فارغ. البحث النصي الكامل العام على العربية دون تسوية ينتج استرجاعًا يقارب الصفر. هذا يقيّد اختيار محرك البحث وهو موضوع بحث مخصّص.

QAS-SCL-01 — النمو إلى الحجم المستهدف (H,H)#

QAS-SCL-02 — مرونة سعة الفيديو (H,H) ⭐#

الجملة الأخيرة رؤية معمارية تستحق الحفظ: على خلاف معظم الأنظمة، تعرف Qwizin حملها المستقبلي مسبقًا لأن الجلسات محجوزة. التوسّع التنبّئي انطلاقًا من تقويم المواعيد أفضل قطعًا من الـ autoscaling التفاعلي هنا.

QAS-SCL-03 — دفعة توليد الشهادات/ملفات PDF (M,M)#

5. قابلية التعديل#

QAS-MOD-01 — استبدال مزوّد المدفوعات (H,H) ⭐#

رُفِع هذا السيناريو إلى (H,H) لأن القرار مؤجَّل عن قصد. تأجيل القرار آمن فقط إذا جعلته المعمارية رخيصًا لاحقًا — وهذا هو كامل مبرّر وجود المنفذ.

QAS-MOD-02 — استبدال مزوّد الفيديو (H,H)#

QAS-MOD-03 — استخراج وحدة في المرحلة الثانية (H,H) ⭐#

بند الإنفاذ في CI هو المقصد كلّه. الأنماط الأحادية المعيارية (modular monoliths) لا تفشل لأن الحدود رُسمت خطأً، بل لأن لا شيء منع تآكلها. الحد الذي لا تفحصه الآلة مجرد تعليق.

QAS-MOD-04 — إضافة قالب بوصفه أداة مهيكلة (M,H)#

(M,H) — قيمة متواضعة في الـ MVP، ورافعة معمارية عالية. التكلفة اليوم صغيرة (مخطط أغنى خلف API لم يتغير)؛ أما تكلفة التعديل لاحقًا فهي إعادة نمذجة كاملة للوحدة.

6. الامتثال والتوطين والتشغيلية#

QAS-CMP-01 — طلب صاحب البيانات لحقوقه (H,M)#

الجزء الصعب ليس الحذف — بل الحصر. يجب صيانة جرد للبيانات الشخصية بوصفه مُنتَجًا من الدرجة الأولى، وإلا صار هذا السيناريو غير قابل للتحقيق بمجرد انتشار البيانات في فهرس بحث وpipeline سجلات.

QAS-CMP-02 — مسار التدقيق لقرارات الاعتماد (H,L)#

QAS-LOC-01 — صحة العربية/RTL في المخرجات المولَّدة (H,M)#

هذا يستبعد عدة مكتبات PHP شائعة لتوليد PDF استبعادًا تامًا. إنه قيد حقيقي على اختيار التقنية، لا تفصيل عرض — فالشهادة ذات الحروف العربية المفكّكة المعكوسة غير صالحة للاستعمال وتبدو هاوية بشكل ظاهر لكل مستخدم سعودي.

QAS-LOC-02 — التوسّع الخليجي (M,M)#

QAS-OPS-01 — قابلية التشغيل بفريق صغير (H,H) ⭐#

(H,H) وغير قابل للتفاوض. CON-15 (Kubernetes) يرفع الأرضية التشغيلية. اختيار Kubernetes دون استثمار مقابل في الـ observability والأتمتة يحوّل خيارًا في البنية التحتية إلى ضريبة تشغيلية دائمة على فريق صغير — وهذه المفاضلة يجب أن تُدفع عن قصد لا أن تُكتشف لاحقًا.

QAS-OPS-02 — كفاءة التكلفة عند الاستغلال المنخفض (H,M)#

الأدلة مقابل الافتراضات#

الأدلة (قابلة للتتبع إلى الوثائق المصدرية):

• onboarding مقيّد بالاعتماد، ستة أنواع جهات فاعلة، قدرات الوحدات — SRC-BRD
• التصحيح الآلي لأسئلة MCQ + شهادة PDF تلقائية — SRC-MOM REQ-05
• الإدراج المميّز (featured) يُرتَّب فوق العادي — SRC-MOM REQ-06
• "مكالمة فيديو مستقرة من البداية إلى النهاية" — SRC-MOM REQ-03
• أمن المستندات القانونية المرفوعة — SRC-MOM NFR-1
• تفضيل التكلفة المنخفضة/المصادر المفتوحة — SRC-BRD §12، SRC-MOM NFR-3
• قابلية التوسّع الخليجي دون إعادة تصميم — SRC-BRD §3.7

الافتراضات (من عندي — تتطلب تأكيدًا):

المخاطر والمفاضلات#

ملخّص أولويات السيناريوهات#

الخطوات التالية الموصى بها#

1. architecture-risk-assessor على مجموعة (H,H) — وبخاصة توتر Kubernetes/قابلية التشغيل (#2) وقرار الدفع المؤجَّل (OQ-10).
2. tradeoff-analysis-writer لقراري البناء مقابل الشراء في الفيديو، واختيار محرك البحث، بمجرد صدور نتائج مسارات البحث.
3. adr-writer لكل قرار اتُّخذ فعلًا (الاستضافة، النمط، orchestration، المنافذ) حتى يُوثَّق المبرّر وهو طازج.