المعمارية English

🌐 العربية · ← 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

يقرأ الرسم من الأعلى إلى الأسفل: تبدأ من ① الأساس، ثم ② المعمارية، ثم ③ المخاطر والتشغيل، وتنتهي عند ④ القرارات. الأسهم المتقطعة تمثّل علاقات تتبّع وتأثير لا تسلسل قراءة.


🚦 من أين تبدأ — حسب الدور#

أنت… اقرأ، بهذا الترتيب
القائد التقني (أمير هارون) READMEالمخاطرالمتطلبات ← كل شيء
راعي الأعمال / إدارة Qwizin README §العوائق الحاسمة ← المتطلبات §5 التناقضاتالأسئلة المفتوحة أدناه
جهة التنفيذ / قائد فريق التطوير المتطلباتالكتل البنائيةتدفقات الميزاتDevOps
مطوّر Backend الكتل البنائيةتدفقات الميزات الأساسية + التجاريةالمفاهيم الشاملة
مهندس DevOps / مهندس منصة تعمّق DevOpsعرض النشرADR-0001 + ADR-0003
مراجع أمني معمارية الأمنسيناريوهات الجودة §1–2عرض وقت التشغيل التدفقات 1، 2، 4، 6 ← ADR-0007
مستشار قانوني / امتثال الأمن §11المخاطر §الفئة AADR-0001 §PDPLC-00 طوبولوجيا الأموال
مهندس ضمان الجودة (QA) سيناريوهات الجودةالمفاهيم الشاملة §8.7 — أربع طبقات اختبار خاصة بهذا النظام

🔍 اعثر عليه بسرعة — حسب السؤال#

"أين أجد…" الوثيقة
…ما الذي تفعله المنصة فعليًا؟ 00-requirements-baseline §3
…التناقضات في ملفات PDF المصدرية؟ 00-requirements-baseline §5
كيف تتدفق البيانات للميزة X؟ فهرس الميزات أدناه
…خريطة pipeline البيانات على مستوى النظام؟ 06b §Level 0
…التدفقات الأمنية / حدود الثقة (trust boundaries)؟ الأمن §1 + 06 التدفقات 1، 2، 6
…بنية الوحدات (modules) وحدودها؟ 05-building-block-view
كيف تُفرض الحدود في CI؟ 05 §5.6 — Deptrac، اختبارات المعمارية، اختبار المخطط
…كتالوج الأحداث بين الوحدات؟ 05 §5.5
…لماذا لا نتّبع الخدمات المصغّرة (microservices)؟ ADR-0002
…تصميم Kubernetes؟ DevOps §2 + ADR-0003
…موازنة الأحمال؟ DevOps §3 — ثلاثة مسارات مستقلة
…إشارات التوسّع التلقائي (autoscaling)؟ DevOps §4
…مسار CI/CD؟ DevOps §6
…تحصين الـ containers؟ DevOps §5, §9
…المناطق، node pools، التعافي من الكوارث (DR)؟ 07-deployment-view
…كيف يعمل عزل المستأجرين (tenant isolation)؟ ADR-0007 + 06 التدفق 6
…التعامل مع العربية / ثنائية اللغة؟ 08 §8.1
…اتفاقيات المال والوقت والمعرّفات؟ 08 §8.4
…استراتيجية الاختبار؟ 08 §8.7
…الاحتفاظ بالبيانات وحذفها؟ 08 §8.8
…طوبولوجيا الدفع / الأموال؟ 06c C-00
…نموذج التهديدات STRIDE؟ الأمن §9
…لماذا الاستضافة على Oracle KSA؟ ADR-0001
…قرار منصة الفيديو؟ ADR-0005
…ما الذي قد يُفشل هذا المشروع؟ 11-risks §الملخص التنفيذي
…ما الذي يلزمني اتخاذ قرار بشأنه؟ الأسئلة المفتوحة أدناه

🗂 فهرس الميزات ← التدفقات#

تغطية كاملة لـ 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-12R-16 PDF العربي · لا يوجد LTS لـ Laravel · بوابة الدفع · الفجوات 🟡 متوسطة 11

📊 حالة التوثيق#

الوثيقة الحالة
NAVIGATOR · README ✅ مكتملة
00-requirements-baseline ✅ مكتملة
01-quality-attribute-scenarios ✅ مكتملة
arc42/03-context-and-containers ✅ مكتملة
arc42/05-building-block-view ✅ مكتملة
arc42/06-runtime-view ✅ مكتملة
arc42/06b-feature-flows-core ✅ مكتملة
arc42/06c-feature-flows-commerce-admin ✅ مكتملة
arc42/07-deployment-view ✅ مكتملة
arc42/08-crosscutting-concepts ✅ مكتملة
arc42/11-risks-and-technical-debt ✅ مكتملة
deep-dives/devops-containerization-orchestration ✅ مكتملة
deep-dives/security-architecture ✅ مكتملة
ADR-0001 الاستضافة ✅ مقترح — 4 بنود تحقق
ADR-0002 نمط أحادي معياري (modular monolith) ✅ معتمد
ADR-0003 Kubernetes ✅ معتمد — مع تحفّظ مُوثَّق
ADR-0005 منفذ الفيديو (port) ✅ مقترح — مشروط
ADR-0007 تعدد المستأجرين (multi-tenancy) ✅ معتمد
ADR-0004 منفذ الدفع معلّق على OQ-10 — كتابته الآن ستكون تخمينًا
ADR-0006 محرك البحث معلّق على تجربة المقارنة للبحث العربي — قرار غير قابل للتراجع يحتاج قياسًا لا رأيًا
deep-dives/capacity-cost-model معلّق على OQ-08 + عروض أسعار المزوّدين
arc42/09 فهرس القرارات المعمارية ⬜ حلّ محلها هذا الجدول + adr/
arc42/10 متطلبات الجودة ⬜ حلّ محلها 01

البنود الثلاثة المعلّمة بـ ⛔ لم تُكتب عن قصد. ADR-0004 يعتمد على إجابة قانونية تغيّر طوبولوجيا الدفع؛ ADR-0006 يعتمد على استرجاع عربي مقيس، لا على تقدير شخصي؛ ونموذج التكلفة يعتمد على قرار التسجيل وعلى عروض أسعار غير موجودة بعد. كتابتها الآن ستنتج قرارات بلا أي دليل خلفها — وهذا أسوأ من فجوة معترف بها.


🎯 الإجراءات التالية#

قرارات مطلوبة منك / من الراعي — البنود السبعة المعلّمة بـ ⛔ أعلاه.

تجارب استكشافية (spikes) تُزيل مخاطر غير متناسبة:

  1. تجربة مقارنة للبحث العربي — 2–3 أيام، قرار غير قابل للتراجع
  2. إخراج PDF عربي — يوم واحد، اعرضه على متحدث بالعربية
  3. التحقق من مصفوفة خدمات منطقة OCI + فئة تسجيل CST — ساعات، وتحكم بوابة ADR-0001

ابْنِ هذا قبل وجود الوحدة الثانية: 4. منظومة الفرض (enforcement harness) — Deptrac + اختبارات المعمارية + مجموعة اختبار عدائية بمستأجرَين 5. صندوق الصادر المعاملاتي (outbox) + واجهة EventBus 6. سياسات RLS بالتزامن مع أول migration مرتبط بالمستأجر

القائد التقني · أمير هارون مسودة v0.1 · بحث وتصميم فقط