🌐 العربية · ← English · الفهرس ثنائي اللغة
🧭 معمارية Qwizin — الدليل الملاحي (Navigator)
مركز التنقل الرئيسي. كل وثيقة، كل ميزة، كل معرّف، كل سؤال مفتوح — مع مسار يقود إلى كلٍّ منها.
التاريخ: 2026-07-20 · الحالة: مسودة v0.1 · الوثائق: 19
خريطة الوثائق#
flowchart TB
NAV["🧭 <b>NAVIGATOR.md</b><br/><i>you are here</i>"]
RM["📖 <b>README.md</b><br/>Overview · blockers ·<br/>baseline decisions"]
subgraph FOUND["① Foundation — start here"]
REQ["📋 <b>00-requirements-baseline</b><br/>Actors · modules · constraints<br/>5 contradictions · 25 open questions"]
QAS["🎯 <b>01-quality-attribute-scenarios</b><br/>21 measurable scenarios"]
end
subgraph ARCH["② Architecture"]
C4["🏛️ <b>arc42/03-context-and-containers</b><br/>C4 L1 + L2 · why not microservices"]
BB["🧱 <b>arc42/05-building-block-view</b><br/>C4 L3 · modules · contracts ·<br/>events · <b>CI enforcement</b>"]
RV["🔀 <b>arc42/06-runtime-view</b><br/>6 critical flows<br/><i>auth · docs · booking · certs ·<br/>search · tenancy</i>"]
FB["⚙️ <b>arc42/06b-feature-flows-core</b><br/>F-01…F-09 + Level-0 pipeline map"]
FC["💰 <b>arc42/06c-feature-flows-commerce-admin</b><br/>C-01…C-09"]
DV["🚀 <b>arc42/07-deployment-view</b><br/>Regions · node pools · DR · capacity"]
CC["🧩 <b>arc42/08-crosscutting-concepts</b><br/>Bilingual · errors · money · time ·<br/>idempotency · testing · retention"]
end
subgraph RISK["③ Risk & Ops"]
RSK["⚠️ <b>arc42/11-risks-and-technical-debt</b><br/>16 ranked risks · 4 blockers"]
DO["🐳 <b>deep-dives/devops-containerization-orchestration</b><br/>Containers · K8s · LB · autoscaling ·<br/>CI/CD · hardening"]
SEC["🔐 <b>deep-dives/security-architecture</b><br/>Trust boundaries · tenancy · uploads ·<br/>integrity · STRIDE"]
end
subgraph ADR["④ Decisions"]
A1["📐 <b>ADR-0001</b> Hosting"]
A2["📐 <b>ADR-0002</b> Modular monolith"]
A3["📐 <b>ADR-0003</b> Kubernetes"]
A5["📐 <b>ADR-0005</b> Video port"]
A7["📐 <b>ADR-0007</b> Multi-tenancy"]
end
NAV --> RM
RM --> FOUND
REQ --> QAS
QAS --> ARCH
REQ -.->|"traces to"| ARCH
C4 --> BB --> RV --> FB --> FC
C4 --> DV
ARCH --> CC
ARCH --> RISK
QAS -.->|"drives"| RSK
RISK --> ADR
C4 -.-> A1
BB -.-> A2
DV -.-> A3
RV -.-> A5
SEC -.-> A7
style NAV fill:#1168bd,stroke:#0b4884,color:#fff
style REQ fill:#e8f0fe,stroke:#1168bd
style RSK fill:#fde8e8,stroke:#c94a4a
يقرأ الرسم من الأعلى إلى الأسفل: تبدأ من ① الأساس، ثم ② المعمارية، ثم ③ المخاطر والتشغيل، وتنتهي عند ④ القرارات. الأسهم المتقطعة تمثّل علاقات تتبّع وتأثير لا تسلسل قراءة.
🚦 من أين تبدأ — حسب الدور#
🔍 اعثر عليه بسرعة — حسب السؤال#
🗂 فهرس الميزات ← التدفقات#
تغطية كاملة لـ SRC-BRD §7.1. هذه هي الخريطة من الـ BRD الخاص بك إلى تدفقات البيانات.
إدارة المستخدمين والتحقق#
| الميزة |
التدفق |
الوثيقة |
| تسجيل فرد / شركة / مستشار / مزوّد خدمة |
F-01 |
06b |
| Google Sign-In · البريد الإلكتروني · الهاتف · OTP |
التدفق 1 |
06 |
| دورة حياة الـ token · التحديث · الإبطال |
التدفق 1 |
06 |
| إدارة الملف الشخصي (بما فيها الموظف "محدود الصلاحية") |
F-02 |
06b |
| تزويد حسابات الموظفين |
F-03 |
06b |
| رفع المستندات القانونية · الفحص · المراجعة |
التدفق 2 |
06 |
| الاعتماد / الرفض / إعادة الإرسال · التفعيل |
F-04 |
06b |
الاستشارات#
| الميزة |
التدفق |
الوثيقة |
| دليل المستشارين · الملفات الشخصية · الإتاحة |
F-05 |
06b |
| الحجز · الحجز على المبلغ (hold) · اعتماد المستشار |
التدفق 3 |
06 |
| جلسة الاستشارة عبر الفيديو |
التدفق 3 |
06 |
| الاستشارة الميدانية (تدفق منفصل) |
F-06 |
06b |
| آلة حالات الموعد (state machine) |
C-01 |
06c |
القوالب#
| الميزة |
التدفق |
الوثيقة |
| الكتالوج · التصنيفات · التحميل المجاني |
F-07 |
06b |
| طلب قالب مخصّص (مدفوع، تنفيذ بشري) |
F-08 |
06b |
التدريب · التقييم · الشهادات#
| الميزة |
التدفق |
الوثيقة |
| تأليف المحتوى · الإسناد · التقدّم |
F-09 |
06b |
| تقديم أسئلة الاختيار من متعدد (MCQ) · التصحيح الآلي · سجل المحاولات |
التدفق 4 |
06 |
| إصدار الشهادات · QR · التحقق |
التدفق 4 |
06 |
السوق الإلكتروني (marketplace)#
| الميزة |
التدفق |
الوثيقة |
| الدليل · البحث · التصفية (بالعربية) |
التدفق 5 |
06 |
| شراء الإدراج المميّز (featured) |
C-03 |
06c |
| أثر الترتيب المميّز |
C-04 |
06c |
الدفع#
| الميزة |
التدفق |
الوثيقة |
| طوبولوجيا تدفق الأموال (النموذج A مقابل B) |
C-00 |
06c |
| آلة حالات دفع الاستشارة |
C-01 |
06c |
| اشتراك المزوّد · التجديد · متابعة التحصيل (dunning) |
C-02 |
06c |
| دفع الإدراج المميّز |
C-03 |
06c |
| التحويلات للمزوّدين (payouts) (⚠ أكبر مخاطرة تنظيمية) |
C-05 |
06c |
الإدارة#
| الميزة |
التدفق |
الوثيقة |
| إدارة متعددة الأدوار · طوابير الاعتماد |
C-06 |
06c |
| إدارة المحتوى والسوق الإلكتروني |
C-07 |
06c |
| مراقبة المدفوعات · التقارير · لوحة المعلومات |
C-08 |
06c |
| توزيع الإشعارات (fan-out) |
C-09 |
06c |
🔖 سجل المعرّفات#
كل بادئة مستخدمة عبر الوثائق، وأين تُعرَّف.
| البادئة |
المعنى |
معرّفة في |
SRC-* |
وثيقة مصدرية (BRD, MOM, UFC, DECK, TRN, CNT) |
00 §1 |
ACT-* |
نوع الجهة الفاعلة (IND, CO, EMP, CON, SP, ADM) |
00 §2 |
MOD-* |
وحدة (module) / كتلة بنائية |
00 §3 |
CONF-* |
تناقض في الوثائق المصدرية |
00 §5 |
OQ-* |
سؤال مفتوح يتطلب قرارًا |
00 §6 + أدناه |
SEAM-* |
نقطة فصل مستقبلية (seam) للمرحلة الثانية |
00 §7 |
CON-* |
قيد (إلزامي) |
00 §8 |
QAS-* |
سيناريو سمة الجودة |
01 |
R-* |
مخاطرة |
11 |
Flow N |
سيناريو حرج في وقت التشغيل |
06 |
F-* |
تدفق ميزة أساسية |
06b |
C-* |
تدفق تجاري / إداري |
06c |
ADR-* |
سجل قرار معماري |
adr/ |
❓ سجل الأسئلة المفتوحة#
25 سؤالًا مفتوحًا. مرتّبة حسب درجة الإعاقة. ⛔ = يوقف العمل الهندسي.
⛔ عوائق حاسمة — تحتاج قرارًا قبل البناء#
| المعرّف |
السؤال |
المسؤول |
التدفق |
OQ-10 |
⛔ هل تحتفظ Qwizin بالأموال وتصرفها؟ وهل يلزم ترخيص SAMA؟ |
مستشار قانوني |
C-00 |
OQ-11 |
⛔ مدى انطباق الفوترة الإلكترونية ZATCA (+ قيد على التوسّع) |
مستشار ضريبي |
المخاطر R-02 |
OQ-06 |
⛔ مصفوفة الأدوار والصلاحيات المصحّحة (CONF-03) |
الراعي / محلل الأعمال |
C-06 |
OQ-08 |
⛔ هل تُسجَّل الاستشارات؟ (تغيّر تكلفة الفيديو بنحو 80%) |
الراعي |
ADR-0005 |
OQ-01 |
⛔ بوابة الدفع — يجب أن تدعم mada + authorize/capture/void + payouts |
المعماري |
C-00 |
OQ-04 |
⛔ حسم نطاق التدريب (CONF-01 — BRD مقابل عرض التدريب) |
الراعي |
F-09 |
OQ-05 |
⛔ سياسة الاسترداد + مستوى خدمة استجابة المستشار (SLA) (CONF-02) |
الراعي |
C-01 |
🟠 عالية — تعيق وحدة (module) بعينها#
| المعرّف |
السؤال |
التدفق |
OQ-02 |
مجموعة المستندات القانونية الدقيقة لكل نوع حساب |
F-01 |
OQ-03 |
نموذج إتاحة المستشار (متكرر / فترات زمنية / تفاوض) |
F-05 |
OQ-07 |
تسلسل أثر تعليق الشركة ← الموظفون، المحاولات، الشهادات |
F-03 |
OQ-09 |
هل تحتاج الشهادات إلى قابلية تحقق من طرف ثالث؟ |
التدفق 4 |
OQ-12 |
نطاق ثنائية اللغة — عربي/إنجليزي مزدوج، أم العربية أساسًا؟ |
التدفق 5 |
OQ-18 |
تسعير الخدمة الميدانية — عرض سعر لكل طلب أم سعر ثابت؟ |
F-06 |
OQ-19 |
من يتحمل تكلفة زيارة ميدانية متنازع عليها؟ |
F-06 |
OQ-21 |
مواضع الإدراج المميّز (featured) — غير محدودة أم شحيحة؟ |
C-03 |
OQ-23 |
نموذج العمولة — نسبة ثابتة، متدرجة، أم حسب التصنيف؟ |
C-05 |
OQ-24 |
دورية التسوية المالية |
C-05 |
OQ-25 |
من يتحمّل رسوم بوابة الدفع؟ |
C-01 |
OQ-14 |
كم مراجعة (revision) يتضمنها طلب القالب المخصّص؟ |
F-08 |
OQ-15 |
مستوى خدمة التسليم (SLA) للطلبات المخصّصة |
F-08 |
🟡 متوسطة#
| المعرّف |
السؤال |
التدفق |
OQ-13 |
هل يلزم تسلسل هرمي شركة ← فرع؟ |
F-09 |
OQ-16 |
حد سعة التنفيذ / تحديد وتيرة استقبال الطلبات |
F-08 |
OQ-17 |
هل تعيد تعديلات تسعير المستشار أو ظهوره الحساب إلى المراجعة؟ |
F-02 |
OQ-20 |
فترة السماح للاشتراك قبل الإزالة من الدليل |
C-02 |
OQ-22 |
هل يؤدي خفض درجة النجاح إلى نجاح المحاولات بأثر رجعي؟ |
C-07 |
⚠️ مرجع سريع للمخاطر#
| المعرّف |
المخاطرة |
الشدّة |
التفصيل |
R-01 |
ترخيص SAMA |
🔴 حرجة |
11 §A |
R-05 |
تسرّب بيانات بين المستأجرين |
🔴 حرجة |
11 §B |
R-02 |
نطاق ZATCA + قيد التسلسل |
🔴 عالية |
11 §A |
R-03 |
الواجبات التشغيلية لـ PDPL غير مُتحقَّق منها |
🟠 عالية |
11 §A |
R-04 |
التسجيلات كبيانات صحية حسّاسة |
🟠 عالية |
11 §A |
R-06 |
نزاهة التقييمات / الشهادات |
🟠 عالية |
11 §B |
R-07 |
رفع ملفات خبيثة |
🟠 عالية |
11 §B |
R-08 |
تآكل حدود الوحدات (modules) |
🟠 عالية |
11 §C |
R-09 |
العبء التشغيلي لـ K8s مقابل حجم الفريق |
🟠 عالية |
11 §C |
R-10 |
تكلفة الفيديو / قرار التسجيل |
🟠 عالية |
ADR-0005 |
R-11 |
جودة البحث العربي (قرار غير قابل للتراجع) |
🟠 عالية |
11 §C |
R-12–R-16 |
PDF العربي · لا يوجد LTS لـ Laravel · بوابة الدفع · الفجوات |
🟡 متوسطة |
11 |
📊 حالة التوثيق#
البنود الثلاثة المعلّمة بـ ⛔ لم تُكتب عن قصد. ADR-0004 يعتمد على إجابة قانونية تغيّر طوبولوجيا الدفع؛ ADR-0006 يعتمد على استرجاع عربي مقيس، لا على تقدير شخصي؛ ونموذج التكلفة يعتمد على قرار التسجيل وعلى عروض أسعار غير موجودة بعد. كتابتها الآن ستنتج قرارات بلا أي دليل خلفها — وهذا أسوأ من فجوة معترف بها.
🎯 الإجراءات التالية#
قرارات مطلوبة منك / من الراعي — البنود السبعة المعلّمة بـ ⛔ أعلاه.
تجارب استكشافية (spikes) تُزيل مخاطر غير متناسبة:
- تجربة مقارنة للبحث العربي — 2–3 أيام، قرار غير قابل للتراجع
- إخراج PDF عربي — يوم واحد، اعرضه على متحدث بالعربية
- التحقق من مصفوفة خدمات منطقة OCI + فئة تسجيل CST — ساعات، وتحكم بوابة ADR-0001
ابْنِ هذا قبل وجود الوحدة الثانية:
4. منظومة الفرض (enforcement harness) — Deptrac + اختبارات المعمارية + مجموعة اختبار عدائية بمستأجرَين
5. صندوق الصادر المعاملاتي (outbox) + واجهة EventBus
6. سياسات RLS بالتزامن مع أول migration مرتبط بالمستأجر