arc42 §7 — عرض النشر

الحالة: مسودة v0.1 · التاريخ: 2026-07-20 يتتبع إلى: ADR-0001 (الاستضافة)، ADR-0003 (Kubernetes)، CON-13 (إقامة البيانات)، QAS-SCL-01، QAS-OPS-01 وثيقة مرافقة: تعمّق DevOps — تفاصيل الـ container الداخلية، وCI/CD، والتحصين

7.1 نظرة عامة على البنية التحتية#

flowchart TB
    subgraph INTERNET["🌐 Internet"]
        MOB["📱 Mobile clients"]
        WEB["🌐 Web / Admin"]
        VERIFY["🔍 Public certificate<br/>verification"]
    end

    subgraph KSA["🇸🇦 Kingdom of Saudi Arabia — CON-13"]
        subgraph PRIMARY["Primary Region — Riyadh"]
            subgraph EDGE["Edge"]
                CDN["CDN"]
                WAF["WAF + DDoS"]
                LB["Load Balancer"]
            end

            subgraph K8S["Kubernetes Cluster (managed control plane)"]
                subgraph NP1["Node pool: general"]
                    API["API pods<br/><i>HPA: RPS + p95</i>"]
                    WRK["Worker pods<br/><i>HPA: queue depth</i>"]
                    SCH["Scheduler<br/><i>singleton</i>"]
                end
                subgraph NP2["Node pool: memory"]
                    PDF["Document renderer"]
                    SRCH["Search engine"]
                    AV["Malware scanner"]
                end
                subgraph NP3["Node pool: media — conditional, ADR-0005"]
                    MEDIA["Media servers<br/><i>hostNetwork</i>"]
                    TURN["TURN"]
                end
            end

            subgraph DATA["Managed data services"]
                PG[("PostgreSQL<br/>primary + replica<br/>RLS enabled")]
                RD[("Redis<br/>cache · queues · locks")]
                OBJ[("Object Storage<br/>encrypted")]
            end
        end

        subgraph DR["DR Region — Jeddah"]
            PGDR[("PostgreSQL<br/>standby")]
            OBJDR[("Object Storage<br/>replica")]
        end
    end

    MOB & WEB --> CDN --> WAF --> LB --> API
    VERIFY --> WAF
    MOB -.->|"WebRTC — bypasses ingress"| MEDIA
    MOB -.->|"signed URL — direct"| OBJ

    API --> PG & RD & OBJ & SRCH
    WRK --> PG & RD & OBJ & SRCH
    WRK --> PDF & AV
    SCH --> RD

    PG ==>|"async replication<br/><b>never leaves KSA</b>"| PGDR
    OBJ ==>|"replication"| OBJDR

    style KSA fill:#e8f5e9,stroke:#2d8659
    style DR fill:#f0f0f0,stroke:#888
    style NP3 fill:#fff4e5,stroke:#d98c1f

منطقة التعافي من الكوارث (DR) هي الخاصية الحاسمة في ADR-0001. Oracle هو المزوّد الوحيد القابل للتطبيق الذي يملك منطقتين داخل المملكة في مرحلة الإتاحة العامة (GA)، ما يجعل التعافي من الكوارث قابلًا للتحقيق دون أن تغادر بايت واحدة أرض السعودية. وكل بديل آخر يفرض أن يكون الـ DR إمّا عابرًا للحدود — فيعيد إدخال مسار عمل الامتثال للنقل عبر الحدود بأكمله — أو داخل المنطقة نفسها بتعدد مناطق الإتاحة (multi-AZ)، وهو ما لا يحمي من فقدان منطقة كاملة.

7.2 البيئات#

⚠️ يجب ألا تحتوي بيئة Staging على بيانات شخصية إنتاجية إطلاقًا. نسخ قاعدة بيانات إنتاجية إلى بيئة أدنى من أشيع خروقات PDPL عمليًا — فبيئة staging لديها ضوابط وصول أضعف، وعدد أكبر من الأشخاص الذين يملكون الوصول، ولا سجل تدقيق. وإذا لُزمت أحجام واقعية، فوَلِّدها.

قاعدة تكافؤ البيئات: تشغّل staging الـ manifests نفسها بعدد نسخ (replicas) مختلف وطلبات موارد مختلفة. والتباعد في الطوبولوجيا يعني أن staging تكفّ عن التنبؤ بسلوك الإنتاج، وهو غرضها الوحيد.

7.3 مجموعات العُقد (node pools) والتوزيع#

قيود التوزيع#

7.4 طبقة البيانات#

PostgreSQL#

Redis#

الذاكرة المؤقتة، والطوابير، والأقفال، وعدّادات تحديد المعدل. ليس مخزنًا معمّرًا — فأي شيء يجب أن ينجو من فقدان Redis يعيش في PostgreSQL. ومهام الطوابير هي الاستثناء البارز: فقدانها محتمَل لأن المعاملة التي أنشأتها قد أُودعت (committed) بالفعل (انظر قواعد الـ pipeline).

التخزين الكائني (Object Storage)#

الكل مشفَّر أثناء السكون. والوثائق القانونية مشفّرة إضافيًا بتشفير مغلَّف على مستوى التطبيق (envelope encryption) (الأمن §4).

7.5 طوبولوجيا الشبكة#

flowchart TB
    subgraph PUB["Public subnet"]
        LB2["Load balancer"]
        NAT["NAT gateway"]
    end
    subgraph PRIV2["Private subnet — no inbound internet"]
        NODES["Kubernetes nodes"]
    end
    subgraph DATA2["Data subnet — no internet route at all"]
        DB2[("PostgreSQL")]
        RD2[("Redis")]
    end

    INT["🌐"] --> LB2 --> NODES
    NODES --> NAT --> INT
    NODES --> DB2 & RD2
    DB2 -.->|"❌ no route"| INT

    style DATA2 fill:#e8f5e9,stroke:#2d8659

7.6 التعافي من الكوارث#

الأهداف — مقترحة، وتتطلب تأكيد الراعي#

⚠️ لا يُذكر أي RTO أو RPO في أي وثيقة مصدر. هذه مقترحات من المعماري مشتقة من QAS-AVL-02 (توفّر 99.5 % في ساعات العمل) ومن طبيعة عبء العمل — مواعيد مجدولة وتنزيل وثائق، لا مدفوعات لحظية. وهي تحتاج اعتمادًا صريحًا من الراعي، لأنها تقود طوبولوجيا الـ standby ومن ثمّ التكلفة.

التحويل بين المناطق#

يدويّ، وعن قصد. فالتحويل التلقائي عبر المناطق يخاطر بانقسام الدماغ (split-brain) في نظام لا يبرّر هدف توفّره ذلك. والإجراء — ترقية الـ standby في جدة، وإعادة توجيه الـ DNS، والتحقق من تأخّر تكرار التخزين الكائني — يجب أن يكون موثّقًا ومُتمرَّنًا عليه، لا نظريًا.

ما لا يغطّيه التكرار (replication)#

الصف الأخير خاصية معمارية مقصودة: لأن فهرس البحث projection ويُرشَّح بعديًا مقابل قاعدة البيانات (Flow 5)، فإن فقدانه كليًا حادثة أداء لا حادثة فقدان بيانات.

7.7 السعة — حجم الإطلاق#

تقديرات بترتيب المقدار فقط. الأرقام الحقيقية تتطلب عروض أسعار المزوّدين التي ما تزال معلّقة في ADR-0001.

خاصيتان جديرتان بالاستغلال#

1. الطلب على الفيديو معروف مسبقًا. الاستشارات محجوزة، لذا فسعة QAS-SCL-02 مجدولة لا عشوائية. وينبغي للـ scheduler أن يُحمِّي سعة الوسائط مسبقًا انطلاقًا من تقويم المواعيد، مع HPA تفاعلي كشبكة أمان فقط. وهذا مهم لأن توسّع الوسائط يجري بحبيبة العقدة وببطء — والتفاعل بعد ثلاث دقائق من بدء استشارة مدفوعة يعني استردادًا.

2. الحمل يتركّز في ساعات العمل السعودية. من الأحد إلى الخميس، 08:00–20:00 بتوقيت AST. وينبغي تقليص السعة خارج الذروة بحزم (QAS-OPS-02)؛ وافترض نسبة ذروة إلى متوسط لا تقل عن 5:1.

7.8 البنود المفتوحة#