🏛️ تصميم معمارية نظام منصة “لجنة تصحيح أوضاع اليمنيين” في المملكة العربية السعودية

بناءً على المعطيات المقدمة، سأقدم لك تصميماً هندسياً متكاملاً يغطي المعمارية، التقنيات، الأمان، واجهات API، وتجربة المستخدم. المشروع جديد ويستهدف جمهوراً محدّداً (يمنيون في السعودية) بمتطلبات حكومية حسّاسة.

---

1️⃣ تحليل المتطلبات

المتطلبات الوظيفية (Functional)

#	المتطلب	الأولوية
F1	تسجيل بيانات المستفيد (نموذج متعدد الحقول)	🔴 حرجة
F2	رفع المرفقات (شخصية إجبارية + مستندات اختيارية)	🔴 حرجة
F3	التحقق من صحة البيانات (Validation)	🔴 حرجة
F4	إرسال الطلب لدورة مراجعة (Workflow)	🔴 حرجة
F5	توليد بطاقة توثيق مؤقتة PDF مع QR/RFID	🔴 حرجة
F6	طباعة حزمة كاملة (بطاقة + بيانات + مستندات + إرشادات)	🟠 عالية
F7	إعادة طباعة الطلب بعد الإرسال	🟠 عالية
F8	بحث/استعلام عن حالة الطلب (للمستفيد)	🟡 متوسطة
F9	لوحة تحكم للمراجعين والمدققين	🔴 حرجة
F10	تقارير وإحصاءات للجنة	🟡 متوسطة

المتطلبات غير الوظيفية (NFR)

• الأداء: استجابة < 2s لـ 95% من الطلبات، دعم 10,000 مستخدم متزامن (المرحلة الأولى).
• التوافر: 99.9% Uptime.
• الأمان: تشفير TLS 1.3، AES-256 at rest، MFA للمراجعين.
• الامتثال: NCA (السعودية) ECC، SDAIA PDPL، ISO 27001، GDPR (للبيانات الحساسة).
• اللغات: العربية (RTL) أساسي، الإنجليزية ثانوي.
• التوافق: جوال أولاً (Mobile-first)، دعم المتصفحات الحديثة.

---

2️⃣ المعمارية المقترحة (System Architecture)

النمط المعماري: Modular Monolith → Microservices (تدريجياً)

text

┌─────────────────────────────────────────────────────────────┐
│                    CDN + WAF (Cloudflare/Akamai)            │
└─────────────────────────────────────────────────────────────┘
                            │
┌─────────────────────────────────────────────────────────────┐
│              API Gateway (Kong / AWS API Gateway)           │
│         - Rate Limiting - Auth - Routing - Logging          │
└─────────────────────────────────────────────────────────────┘
        │              │              │              │
   ┌────▼───┐    ┌────▼───┐    ┌────▼───┐    ┌────▼────┐
   │ Identity│    │Applic. │    │Document│    │Workflow │
   │ Service │    │Service │    │Service │    │ Service │
   │ (Auth)  │    │(CRUD)  │    │(Files) │    │(Review) │
   └────┬────┘    └────┬───┘    └────┬───┘    └────┬────┘
        │              │              │              │
        └──────────────┴──────────────┴──────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        │                   │                   │
   ┌────▼────┐        ┌────▼────┐        ┌────▼────┐
   │PostgreSQL│        │  Redis  │        │ MinIO/S3│
   │ (Primary)│        │ (Cache) │        │ (Files) │
   └─────────┘        └─────────┘        └─────────┘
                            │
                   ┌────────▼────────┐
                   │  Message Queue  │
                   │ (RabbitMQ/Kafka)│
                   └────────┬────────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
        ┌─────▼────┐  ┌────▼────┐  ┌────▼─────┐
        │Notification│ │ PDF Gen │  │Analytics │
        │  (SMS/Email)│ │ Service │  │ Service  │
        └───────────┘  └─────────┘  └──────────┘

طبقات النظام:

1. طبقة العرض (Presentation): تطبيق ويب (React/Next.js) + PWA للجوال.
2. طبقة الـ API: RESTful + GraphQL للاستعلامات المعقدة.
3. طبقة الخدمات (Business Logic): Modular Monolith يبدأ بـ 4 وحدات.
4. طبقة البيانات: PostgreSQL (بيانات علائقية) + Redis (Cache) + S3 (ملفات).
5. طبقة التكامل: APIs مع الأنظمة السعودية (أبشر/ناجز – إن لزم) + الجوازات اليمنية للتحقق.

---

3️⃣ التقنيات المقترحة (Tech Stack)

الواجهة الأمامية (Frontend)

التقنية	السبب
Next.js 14 (App Router)	SSR + SEO + أداء عالٍ + RTL ممتاز
TypeScript	أمان الأنواع لتقليل الأخطاء
TailwindCSS + shadcn/ui	تصميم سريع + دعم RTL
React Hook Form + Zod	إدارة النماذج + Validation قوي
i18next	دعم متعدد اللغات
TanStack Query	إدارة حالة السيرفر

الواجهة الخلفية (Backend)

التقنية	السبب
NestJS (Node.js) أو Spring Boot	Modular + TypeScript + جاهز للمؤسسات
PostgreSQL 16	ACID + JSONB + مرونة
Prisma / TypeORM	ORM آمن
Redis	Cache + Sessions
MinIO (On-Prem) أو AWS S3	تخزين الملفات
RabbitMQ / Kafka	الطوابير للعمليات غير المتزامنة
BullMQ	معالجة المهام (PDF، إشعارات)

البنية التحتية

المكون	التقنية
الحاويات	Docker + Kubernetes (K8s)
CI/CD	GitLab CI / GitHub Actions + ArgoCD
المراقبة	Prometheus + Grafana + Loki
التتبع	OpenTelemetry + Jaeger
إدارة الأسرار	HashiCorp Vault
بوابة API	Kong / Traefik

توليد PDF

• Puppeteer / Playwright (HTML → PDF): لمرونة عالية في القوالب العربية RTL.
• pdf-lib: للتلاعب بالـ PDF (إضافة QR، ختم).
• QR Code: مكتبة qrcode لتوليد رمز التحقق.

---

4️⃣ الأمان والامتثال (NCA + PDPL + ISO 27001)

الضوابط الأساسية (NCA ECC-1:2018)

المجال	الإجراء
إدارة الهوية	MFA إجباري للموظفين، OTP للجوال للمستفيدين
تشفير البيانات	TLS 1.3، AES-256 at rest، تشفير الأعمدة الحساسة (رقم الجوال، رقم البطاقة)
إدارة الوصول	RBAC + ABAC، مبدأ أقل صلاحية
سجلات التدقيق	Audit Log لكل عملية (من، ماذا، متى، من أين)
حماية البيانات الشخصية	PDPL: موافقة صريحة، حق الوصول/الحذف، إخفاء الهوية في التقارير
إدارة الثغرات	SAST/DAST في CI/CD، فحص شهري
الاستجابة للحوادث	SIEM (Wazuh/ELK) + خطة استجابة
النسخ الاحتياطي	3-2-1، اختبار استعادة ربع سنوي

ضوابط خاصة بالمشروع

• التحقق من الهوية اليمنية: تكامل مع الجوازات اليمنية (إن أمكن) أو التحقق اليدوي.
• منع التكرار: فحص رقم البطاقة/الجواز قبل الحفظ.
• Watermark على البطاقة: اسم اللجنة + تاريخ + رقم تسلسلي.
• QR للتحقق: يشير إلى نقطة تحقق حكومية (Verify Endpoint).
• تسجيل كل طباعة: لمنع التزوير.
• Data Residency: البيانات داخل السعودية (وفق NCA).

---

5️⃣ تصميم واجهات API

نمط RESTful مع إصدارات

text

POST   /api/v1/applicants              # إنشاء طلب جديد
GET    /api/v1/applicants/{id}         # جلب طلب
PATCH  /api/v1/applicants/{id}         # تعديل جزئي
POST   /api/v1/applicants/{id}/submit  # إرسال للمراجعة
GET    /api/v1/applicants/{id}/pdf     # توليد/جلب حزمة الطباعة
POST   /api/v1/applicants/{id}/reprint # إعادة طباعة
GET    /api/v1/applicants/{id}/status  # حالة الطلب

POST   /api/v1/files/upload            # رفع مرفق (presigned URL)
DELETE /api/v1/files/{fileId}          # حذف مرفق

GET    /api/v1/admin/applications      # قائمة للمراجعين (مع فلترة)
POST   /api/v1/admin/applications/{id}/approve
POST   /api/v1/admin/applications/{id}/reject
GET    /api/v1/admin/reports           # تقارير

POST   /api/v1/auth/login              # دخول المستفيد (OTP)
POST   /api/v1/auth/staff/login        # دخول الموظف (MFA)
POST   /api/v1/auth/refresh            # تجديد التوكن

GET    /api/v1/verify/{token}          # تحقق عام من بطاقة

مثال Request: إنشاء طلب

json

POST /api/v1/applicants
{
  "fullName": "محمد أحمد علي الحسني",
  "idType": "national_id",           // national_id | passport | none
  "idNumber": "01234567",
  "maritalStatus": "married",
  "gender": "male",
  "occupation": "engineer",
  "birthPlace": "صنعاء",
  "birthDate": "1990-05-15",
  "residencePlace": "الرياض",
  "mobile": "966512345678",
  "email": "user@example.com",
  "region": "riyadh",
  "addressYemen": {
    "governorate": "صنعاء",
    "district": "السبعين",
    "village": "بيت بوس"
  },
  "attachments": {
    "personalPhoto": "file_id_1",
    "passport": "file_id_2"
  }
}

معايير الـ API

• المصادقة: OAuth 2.0 + JWT (Access 15min + Refresh 7d).
• الإصدارات: /v1/ في المسار.
• الأخطاء: RFC 7807 (Problem Details).
• Pagination: Cursor-based.
• Rate Limiting: 100 req/min للمستفيد، 1000 للموظف.
• OpenAPI 3.1: توثيق تلقائي (Swagger UI).

---

6️⃣ تجربة المستخدم (UX) للخدمات الحكومية

مبادئ التصميم

1. البساطة: خطوات واضحة، لا مصطلحات تقنية.
2. الشفافية: عرض سبب كل خطأ فوراً.
3. RTL أصلي: ليس ترجمة، بل تصميم عربي.
4. Mobile-First: 80% من المستخدمين على الجوال.
5. إمكانية الوصول: WCAG 2.1 AA.

رحلة المستفيد (User Journey)

text

[الصفحة الرئيسية]
    │
    ├─► شرح الخدمة + تنبيه (جواز يمني = لا وثيقة مؤقتة)
    │
    ▼
[نموذج متعدد الخطوات]  ←── شريط تقدم
    ├─ 1. البيانات الشخصية
    ├─ 2. العنوان (اليمن + الإقامة)
    ├─ 3. معلومات الاتصال
    ├─ 4. المرفقات
    └─ 5. مراجعة + موافقة
    │
    ▼
[إرسال الطلب] → رقم مرجعي + SMS
    │
    ▼
[صفحة النجاح]
    ├─► طباعة الحزمة (PDF متعدد الصفحات)
    ├─► إعادة الطباعة لاحقاً
    └─► إرشادات ما بعد الطباعة

تحسينات UX مقترحة

• حفظ تلقائي (Draft): لا تفقد البيانات عند انقطاع الإنترنت.
• Validation فوري: عند blur وليس عند الإرسال فقط.
• رفع الملفات: Drag & Drop + كاميرا الجوال مباشرة.
• معاينة الصورة: قبل الحفظ.
• شريط تقدم: يوضح الخطوة الحالية.
• رسائل خطأ واضحة: “الاسم يجب أن يكون رباعياً” بدلاً من “خطأ في الحقل”.
• وضع ليلي: اختياري.
• دعم القارئ الشاشي: ARIA labels.

قالب حزمة الطباعة (PDF)

1. الصفحة 1: بطاقة التوثيق المؤقتة (QR + ختم + رقم تسلسلي).
2. الصفحة 2: بيانات المستفيد كاملة.
3. الصفحة 3+: المستندات المرفقة (عدا الصورة الشخصية).
4. الصفحة الأخيرة: إرشادات ما بعد الطباعة.

---

7️⃣ مراجعة الكود والمعمارية

قائمة تدقيق للمراجعة (Checklist)

• □ الأمان: لا توجد بيانات حساسة في الـ logs، لا eval، إدخال مُعقّم.
• □ الأداء: استعلامات N+1، فهارس (Indexes)، Cache.
• □ الاختبارات: Unit ≥ 80%، Integration، E2E (Playwright).
• □ التوثيق: OpenAPI محدّث، README، ADRs.
• □ الامتثال: Audit Log، Data Retention Policy.
• □ قابلية التوسع: Stateless، Horizontal Scaling.
• □ التعافي: Circuit Breaker، Retry، Timeout.

أدوات مقترحة

• Linting: ESLint + Prettier + SonarQube.
• Testing: Jest + Supertest + Playwright.
• Security: Snyk + OWASP ZAP + Trivy.
• Performance: k6 + Lighthouse CI.

---

8️⃣ خارطة الطريق المقترحة (Roadmap)

المرحلة	المدة	المخرجات
1. Discovery	2-3 أسابيع	متطلبات مفصلة، Wireframes، مخطط ERD
2. MVP	8-10 أسابيع	نموذج + رفع مرفقات + مراجعة + PDF
3. Hardening	3-4 أسابيع	أمان، اختبارات، تدقيق NCA
4. Pilot	2 أسابيع	100 مستخدم تجريبي
5. Launch	1 أسبوع	إطلاق رسمي + مراقبة
6. Iterate	مستمر	تحسينات بناءً على التغذية الراجعة

---

9️⃣ توصيات حرجة للمشروع

1. ⚖️ الامتثال أولاً: التعاون المبكر مع NCA و SDAIA قبل كتابة سطر كود.
2. 🔐 التحقق من الهوية: تكامل مع الجهات اليمنية إن أمكن، وإلا عملية تحقق يدوي موثقة.
3. 📄 PDF عربي: اختبر Puppeteer مع خطوط عربية (Cairo, Tajawal) قبل الالتزام.
4. 🌐 Data Residency: استضافة داخل السعودية (STC Cloud, Oracle Jeddah, AWS Bahrain مع اعتبارات).
5. 🔄 التكامل مع أبشر: اختياري لكنه يقلل الاحتيال.
6. 📊 تحليلات: لوحة KPIs (عدد الطلبات، معدل القبول، زمن المعالجة).
7. 🛡️ خطة استجابة للحوادث: فريق + أدوات + سيناريوهات.
8. 📱 PWA: لتقليل الاعتماد على App Store.

---

🔟 الخطوة التالية

هل تريد أن أتعمق في أحد الجوانب التالية؟

• 📐 مخطط ERD تفصيلي لقاعدة البيانات
• 🔌 مواصفات OpenAPI كاملة لجميع الـ endpoints
• 🎨 Wireframes / Mockups لواجهة النموذج
• 🔒 مصفوفة ضوابط NCA مفصلة لكل مكوّن
• 💰 تقدير التكاليف والموارد (فريق + بنية تحتية)
• 🧪 خطة اختبارات شاملة

أخبرني بأولويتك وسأعمّق فيها. 🚀

📐 مخطط ERD تفصيلي لقاعدة البيانات

📐 مخطط ERD تفصيلي لقاعدة بيانات منصة “لجنة تصحيح أوضاع اليمنيين”

1️⃣ نظرة عامة على المخطط

قاعدة البيانات مصممة وفق 3NF مع بعض التنازلات المدروسة للأداء، وتتكون من 8 مجموعات رئيسية:

text

┌─────────────────────────────────────────────────────────────┐
│                    DATABASE SCHEMA GROUPS                    │
├─────────────────────────────────────────────────────────────┤
│  1. Identity & Auth      → المستخدمون والصلاحيات            │
│  2. Applicants           → المستفيدون وبياناتهم             │
│  3. Addresses            → العناوين (اليمن + الإقامة)        │
│  4. Attachments          → المرفقات والملفات                │
│  5. Applications         → الطلبات ودورة حياتها             │
│  6. Workflow             → المراجعة والقرارات               │
│  7. Documents            → البطاقات والطباعة                │
│  8. Audit & Reference    → التدقيق والبيانات المرجعية       │
└─────────────────────────────────────────────────────────────┘

---

2️⃣ المخطط البصري (ASCII ERD)

text

┌──────────────────┐         ┌──────────────────┐
│      users       │         │      roles       │
├──────────────────┤         ├──────────────────┤
│ PK id            │◄───────┤ PK id            │
│    username      │  M:N    │    name          │
│    email         │         │    permissions   │
│    password_hash │         └──────────────────┘
│    full_name     │                 ▲
│    role_id       │                 │
│    is_active     │         ┌───────┴──────────┐
│    last_login    │         │  user_roles      │
└────────┬─────────┘         │  (junction)      │
         │                   └──────────────────┘
         │ 1:N (reviewer)
         │
         ▼
┌──────────────────────────────────────────────────────────────┐
│                        applications                          │
├──────────────────────────────────────────────────────────────┤
│ PK id                    │  BIGSERIAL                          │
│ UK reference_number      │  VARCHAR(20)  -- YEM-2026-000123   │
│ FK applicant_id          │  → applicants.id                    │
│    status                │  ENUM: draft, submitted, under_    │
│                          │  review, approved, rejected,        │
│                          │  printed, cancelled                 │
│    current_step          │  SMALLINT                           │
│ FK assigned_reviewer_id  │  → users.id (nullable)              │
│    submitted_at          │  TIMESTAMPTZ                        │
│    reviewed_at           │  TIMESTAMPTZ                        │
│    decided_at            │  TIMESTAMPTZ                        │
│    printed_count         │  SMALLINT DEFAULT 0                 │
│    last_printed_at       │  TIMESTAMPTZ                        │
│    notes                 │  TEXT                               │
│    created_at            │  TIMESTAMPTZ                        │
│    updated_at            │  TIMESTAMPTZ                        │
│    deleted_at            │  TIMESTAMPTZ (soft delete)          │
└──────────┬───────────────────────────────────────────────────┘
           │ 1:1
           ▼
┌──────────────────────────────────────────────────────────────┐
│                        applicants                            │
├──────────────────────────────────────────────────────────────┤
│ PK id                    │  BIGSERIAL                          │
│    full_name_ar          │  VARCHAR(200)  -- رباعي             │
│    full_name_en          │  VARCHAR(200)  (nullable)           │
│    id_type               │  ENUM: national_id, passport, none  │
│    id_number             │  VARCHAR(30)   (encrypted)          │
│    id_issue_date         │  DATE          (nullable)           │
│    id_expiry_date        │  DATE          (nullable)           │
│    marital_status        │  ENUM: single, married, divorced,   │
│                          │  widowed                            │
│    gender                │  ENUM: male, female                 │
│    occupation            │  VARCHAR(100)                       │
│    birth_place           │  VARCHAR(100)                       │
│    birth_date            │  DATE                               │
│ FK nationality_id        │  → nationalities.id                 │
│    mobile                │  VARCHAR(20)   (encrypted)          │
│    mobile_hash           │  VARCHAR(64)   -- للبحث بدون فك    │
│    email                 │  VARCHAR(150)                       │
│    has_yemeni_passport   │  BOOLEAN DEFAULT false              │
│    created_at            │  TIMESTAMPTZ                        │
│    updated_at            │  TIMESTAMPTZ                        │
└──────────┬───────────────────────────────────────────────────┘
           │
           ├─── 1:N ──►┌─────────────────────────────────────┐
           │           │        addresses                    │
           │           ├─────────────────────────────────────┤
           │           │ PK id                               │
           │           │ FK applicant_id                     │
           │           │    type  ENUM: residence, yemen_    │
           │           │           origin                    │
           │           │    region_id (للسعودية فقط)         │
           │           │    governorate_id (لليمن فقط)       │
           │           │    district_id (لليمن فقط)          │
           │           │    village (لليمن فقط)              │
           │           │    street_address                   │
           │           │    is_primary                       │
           │           └─────────────────────────────────────┘
           │
           ├─── 1:N ──►┌─────────────────────────────────────┐
           │           │        attachments                  │
           │           ├─────────────────────────────────────┤
           │           │ PK id                               │
           │           │ FK applicant_id                     │
           │           │    type  ENUM: personal_photo,      │
           │           │           passport, national_id,     │
           │           │           birth_cert, family_card,  │
           │           │           other_1, other_2          │
           │           │    file_name                        │
           │           │    file_path (S3 key)               │
           │           │    file_size                        │
           │           │    mime_type                        │
           │           │    checksum_sha256                  │
           │           │    uploaded_at                      │
           │           │    is_verified                      │
           │           │ FK verified_by                     │
           │           └─────────────────────────────────────┘
           │
           └─── 1:N ──►┌─────────────────────────────────────┐
                       │     workflow_history                │
                       ├─────────────────────────────────────┤
                       │ PK id                               │
                       │ FK application_id                   │
                       │ FK actor_id (users)                 │
                       │    action                           │
                       │    from_status                      │
                       │    to_status                        │
                       │    comment                          │
                       │    created_at                       │
                       └─────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│                      issued_documents                        │
├──────────────────────────────────────────────────────────────┤
│ PK id                    │  BIGSERIAL                          │
│ FK application_id        │  → applications.id                  │
│ UK document_number       │  VARCHAR(30)  -- DOC-2026-XXXXXX    │
│    document_type         │  ENUM: temporary_id_card, full      │
│    verification_token    │  UUID (للـ QR)                      │
│    qr_payload_hash       │  VARCHAR(64)                        │
│    pdf_s3_key            │  VARCHAR(500)                       │
│    issued_at             │  TIMESTAMPTZ                        │
│    expires_at            │  TIMESTAMPTZ                        │
│    printed_by            │  FK users.id (nullable)             │
│    revoked_at            │  TIMESTAMPTZ (nullable)             │
│    revocation_reason     │  TEXT                               │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│                      audit_logs                              │
├──────────────────────────────────────────────────────────────┤
│ PK id                    │  BIGSERIAL                          │
│    actor_type            │  ENUM: user, applicant, system      │
│    actor_id              │  BIGINT (nullable)                  │
│    action                │  VARCHAR(100)                       │
│    entity_type           │  VARCHAR(50)                        │
│    entity_id             │  BIGINT                             │
│    old_values            │  JSONB                              │
│    new_values            │  JSONB                              │
│    ip_address            │  INET                               │
│    user_agent            │  TEXT                               │
│    request_id            │  UUID                               │
│    created_at            │  TIMESTAMPTZ                        │
└──────────────────────────────────────────────────────────────┘

---

3️⃣ الجداول التفصيلية (DDL)

🔹 مجموعة 1: الهوية والصلاحيات

roles

sql

CREATE TABLE roles (
    id              SERIAL PRIMARY KEY,
    name            VARCHAR(50) NOT NULL UNIQUE,  -- admin, reviewer, supervisor, viewer
    name_ar         VARCHAR(100) NOT NULL,
    description     TEXT,
    permissions     JSONB NOT NULL DEFAULT '[]',
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

-- Seed
INSERT INTO roles (name, name_ar, permissions) VALUES
('super_admin',  'مدير عام',      '["*"]'),
('reviewer',     'مراجع',         '["applications:read","applications:review"]'),
('supervisor',   'مشرف',          '["applications:*","reports:read"]'),
('viewer',       'مشاهد',         '["applications:read"]');

users

sql

CREATE TABLE users (
    id              BIGSERIAL PRIMARY KEY,
    username        VARCHAR(50) NOT NULL UNIQUE,
    email           VARCHAR(150) NOT NULL UNIQUE,
    mobile          VARCHAR(20),
    password_hash   VARCHAR(255) NOT NULL,       -- bcrypt/argon2
    full_name       VARCHAR(200) NOT NULL,
    national_id     VARCHAR(30),                 -- للموظف السعودي/اليمني
    role_id         INTEGER NOT NULL REFERENCES roles(id),
    is_active       BOOLEAN NOT NULL DEFAULT TRUE,
    is_locked       BOOLEAN NOT NULL DEFAULT FALSE,
    failed_attempts SMALLINT NOT NULL DEFAULT 0,
    mfa_enabled     BOOLEAN NOT NULL DEFAULT TRUE,
    mfa_secret      VARCHAR(255),
    last_login_at   TIMESTAMPTZ,
    last_login_ip   INET,
    password_changed_at TIMESTAMPTZ,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at      TIMESTAMPTZ
);

CREATE INDEX idx_users_email ON users(email) WHERE deleted_at IS NULL;
CREATE INDEX idx_users_role ON users(role_id) WHERE is_active = TRUE;

sessions

sql

CREATE TABLE sessions (
    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id         BIGINT REFERENCES users(id) ON DELETE CASCADE,
    applicant_id    BIGINT,  -- nullable، للمستفيد
    refresh_token_hash VARCHAR(255) NOT NULL,
    ip_address      INET,
    user_agent      TEXT,
    expires_at      TIMESTAMPTZ NOT NULL,
    revoked_at      TIMESTAMPTZ,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_sessions_user ON sessions(user_id) WHERE revoked_at IS NULL;
CREATE INDEX idx_sessions_expires ON sessions(expires_at);

otp_verifications (للتحقق من الجوال/البريد)

sql

CREATE TABLE otp_verifications (
    id              BIGSERIAL PRIMARY KEY,
    identifier      VARCHAR(150) NOT NULL,       -- mobile أو email
    identifier_type ENUM('mobile','email') NOT NULL,
    otp_hash        VARCHAR(255) NOT NULL,
    purpose         VARCHAR(50) NOT NULL,        -- login, verify_mobile, verify_email
    attempts        SMALLINT NOT NULL DEFAULT 0,
    max_attempts    SMALLINT NOT NULL DEFAULT 5,
    expires_at      TIMESTAMPTZ NOT NULL,
    consumed_at     TIMESTAMPTZ,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_otp_identifier ON otp_verifications(identifier, purpose) 
    WHERE consumed_at IS NULL;

---

🔹 مجموعة 2: المستفيدون

nationalities

sql

CREATE TABLE nationalities (
    id          SERIAL PRIMARY KEY,
    code        CHAR(2) NOT NULL UNIQUE,   -- ISO 3166-1 alpha-2
    name_ar     VARCHAR(100) NOT NULL,
    name_en     VARCHAR(100) NOT NULL,
    is_active   BOOLEAN DEFAULT TRUE
);

applicants

sql

CREATE TABLE applicants (
    id                  BIGSERIAL PRIMARY KEY,
    full_name_ar        VARCHAR(200) NOT NULL,
    full_name_en        VARCHAR(200),
    id_type             VARCHAR(20) NOT NULL 
                        CHECK (id_type IN ('national_id','passport','none')),
    id_number_encrypted BYTEA,                    -- pgcrypto
    id_number_hash      VARCHAR(64),              -- SHA-256 للبحث
    id_issue_date       DATE,
    id_expiry_date      DATE,
    marital_status      VARCHAR(20) NOT NULL 
                        CHECK (marital_status IN ('single','married','divorced','widowed')),
    gender              VARCHAR(10) NOT NULL 
                        CHECK (gender IN ('male','female')),
    occupation          VARCHAR(100) NOT NULL,
    birth_place         VARCHAR(100) NOT NULL,
    birth_date          DATE NOT NULL,
    nationality_id      INTEGER REFERENCES nationalities(id),
    mobile_encrypted    BYTEA,                    -- pgcrypto
    mobile_hash         VARCHAR(64) NOT NULL,     -- SHA-256
    email               VARCHAR(150) NOT NULL,
    has_yemeni_passport BOOLEAN NOT NULL DEFAULT FALSE,
    -- التحقق
    is_identity_verified BOOLEAN DEFAULT FALSE,
    verified_at         TIMESTAMPTZ,
    verified_by         BIGINT REFERENCES users(id),
    -- timestamps
    created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at          TIMESTAMPTZ,
    
    CONSTRAINT chk_name_quad CHECK (
        array_length(regexp_split_to_array(trim(full_name_ar), '\s+'), 1) >= 4
    ),
    CONSTRAINT chk_id_required CHECK (
        (id_type = 'none' AND id_number_encrypted IS NULL)
        OR (id_type IN ('national_id','passport') AND id_number_encrypted IS NOT NULL)
    )
);

CREATE INDEX idx_applicants_mobile_hash ON applicants(mobile_hash);
CREATE INDEX idx_applicants_id_hash ON applicants(id_number_hash);
CREATE INDEX idx_applicants_email ON applicants(email);
CREATE UNIQUE INDEX uk_applicants_id_hash ON applicants(id_number_hash) 
    WHERE id_number_hash IS NOT NULL AND deleted_at IS NULL;
CREATE INDEX idx_applicants_created ON applicants(created_at DESC);

ملاحظة أمنية: نستخدم pgcrypto لتشفير id_number و mobile، مع الاحتفاظ بـ hash (SHA-256 + salt) للبحث السريع دون فك التشفير.

addresses

sql

CREATE TABLE addresses (
    id              BIGSERIAL PRIMARY KEY,
    applicant_id    BIGINT NOT NULL REFERENCES applicants(id) ON DELETE CASCADE,
    type            VARCHAR(20) NOT NULL CHECK (type IN ('residence','yemen_origin')),
    -- للسعودية
    region_id       INTEGER REFERENCES regions(id),
    -- لليمن
    governorate_id  INTEGER REFERENCES governorates(id),
    district_id     INTEGER REFERENCES districts(id),
    village         VARCHAR(150),
    street_address  VARCHAR(300),
    postal_code     VARCHAR(20),
    is_primary      BOOLEAN DEFAULT TRUE,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_addresses_applicant ON addresses(applicant_id);
CREATE UNIQUE INDEX uk_address_applicant_type ON addresses(applicant_id, type);

---

🔹 مجموعة 3: البيانات الجغرافية

regions (مناطق السعودية)

sql

CREATE TABLE regions (
    id          SERIAL PRIMARY KEY,
    code        VARCHAR(10) NOT NULL UNIQUE,
    name_ar     VARCHAR(100) NOT NULL,
    name_en     VARCHAR(100) NOT NULL,
    is_active   BOOLEAN DEFAULT TRUE
);

-- Seed: 13 منطقة
INSERT INTO regions (code, name_ar, name_en) VALUES
('RUH','الرياض','Riyadh'),
('MAK','مكة المكرمة','Makkah'),
('MED','المدينة المنورة','Madinah'),
('EAP','المنطقة الشرقية','Eastern Province'),
('ASR','عسير','Asir'),
('TAB','تبوك','Tabuk'),
('HAI','حائل','Hail'),
('NOR','الحدود الشمالية','Northern Borders'),
('JAZ','جازان','Jazan'),
('NAJ','نجران','Najran'),
('BAH','الباحة','Al-Bahah'),
('JAW','الجوف','Al-Jouf'),
('QAS','القصيم','Qassim');

governorates (محافظات اليمن)

sql

CREATE TABLE governorates (
    id          SERIAL PRIMARY KEY,
    code        VARCHAR(10) NOT NULL UNIQUE,
    name_ar     VARCHAR(100) NOT NULL,
    name_en     VARCHAR(100),
    is_active   BOOLEAN DEFAULT TRUE
);

-- Seed: 22 محافظة يمنية
INSERT INTO governorates (code, name_ar) VALUES
('SAN','صنعاء'),('ADE','عدن'),('TAI','تعز'),('HAD','الحديدة'),
('HAD2','حضرموت'),('IBB','إب'),('LAH','لحج'),('ABY','أبين'),
('DHM','ذمار'),('BAY','البيضاء'),('MAA','مأرب'),('SAA','صعدة'),
('HAJ','حجة'),('AMR','عمران'),('DAL','الضالع'),('JOF','الجوف'),
('MAH','المحويت'),('RAY','ريمة'),('SHA','شبوة'),('SOC','أرخبيل سقطرى'),
('MWS','المهرة'),('HOD','حجة');

districts (المديريات – ~333 مديرية)

sql

CREATE TABLE districts (
    id              SERIAL PRIMARY KEY,
    governorate_id  INTEGER NOT NULL REFERENCES governorates(id),
    code            VARCHAR(15) NOT NULL UNIQUE,
    name_ar         VARCHAR(100) NOT NULL,
    name_en         VARCHAR(100),
    is_active       BOOLEAN DEFAULT TRUE
);

CREATE INDEX idx_districts_gov ON districts(governorate_id);

---

🔹 مجموعة 4: المرفقات

attachments

sql

CREATE TABLE attachments (
    id              BIGSERIAL PRIMARY KEY,
    applicant_id    BIGINT NOT NULL REFERENCES applicants(id) ON DELETE CASCADE,
    type            VARCHAR(30) NOT NULL CHECK (type IN (
                        'personal_photo','passport','national_id',
                        'birth_cert','family_card','other_1','other_2'
                    )),
    original_name   VARCHAR(255) NOT NULL,
    file_path       VARCHAR(500) NOT NULL,      -- S3 key: applicants/{id}/{uuid}.jpg
    file_size       BIGINT NOT NULL,            -- bytes
    mime_type       VARCHAR(100) NOT NULL,
    checksum_sha256 VARCHAR(64) NOT NULL,
    width_px        INTEGER,                    -- للصور
    height_px       INTEGER,                    -- للصور
    is_verified     BOOLEAN DEFAULT FALSE,
    verified_by     BIGINT REFERENCES users(id),
    verified_at     TIMESTAMPTZ,
    uploaded_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at      TIMESTAMPTZ,
    
    CONSTRAINT chk_file_size CHECK (file_size <= 5 * 1024 * 1024),  -- 5 MB
    CONSTRAINT chk_mime CHECK (mime_type IN (
        'image/jpeg','image/png','application/pdf'
    ))
);

CREATE INDEX idx_attachments_applicant ON attachments(applicant_id) 
    WHERE deleted_at IS NULL;
CREATE UNIQUE INDEX uk_attachment_type ON attachments(applicant_id, type) 
    WHERE deleted_at IS NULL;

ملاحظة: الصورة الشخصية (personal_photo) إجبارية، والباقي اختياري — يُفرض ذلك في طبقة التطبيق، وليس في قاعدة البيانات، لمرونة أكبر.

---

🔹 مجموعة 5: الطلبات

applications

sql

CREATE TABLE applications (
    id                    BIGSERIAL PRIMARY KEY,
    reference_number      VARCHAR(20) NOT NULL UNIQUE,   -- YEM-2026-000123
    applicant_id          BIGINT NOT NULL REFERENCES applicants(id),
    status                VARCHAR(20) NOT NULL DEFAULT 'draft' CHECK (status IN (
                            'draft','submitted','under_review',
                            'approved','rejected','printed','cancelled'
                          )),
    current_step          SMALLINT NOT NULL DEFAULT 1,
    assigned_reviewer_id  BIGINT REFERENCES users(id),
    priority              SMALLINT NOT NULL DEFAULT 0,   -- 0=normal, 1=high
    submitted_at          TIMESTAMPTZ,
    review_started_at     TIMESTAMPTZ,
    decided_at            TIMESTAMPTZ,
    rejection_reason      TEXT,
    internal_notes        TEXT,
    -- الطباعة
    printed_count         SMALLINT NOT NULL DEFAULT 0,
    last_printed_at       TIMESTAMPTZ,
    last_printed_by       BIGINT REFERENCES users(id),
    -- timestamps
    created_at            TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at            TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at            TIMESTAMPTZ
);

CREATE INDEX idx_applications_status ON applications(status) WHERE deleted_at IS NULL;
CREATE INDEX idx_applications_reviewer ON applications(assigned_reviewer_id, status);
CREATE INDEX idx_applications_submitted ON applications(submitted_at DESC);
CREATE INDEX idx_applications_applicant ON applications(applicant_id);

application_sequences (لتوليد رقم مرجعي)

sql

CREATE TABLE application_sequences (
    year        SMALLINT PRIMARY KEY,
    last_number BIGINT NOT NULL DEFAULT 0
);

-- Function لتوليد رقم مرجعي
CREATE OR REPLACE FUNCTION next_reference_number()
RETURNS VARCHAR AS $$
DECLARE
    v_year SMALLINT := EXTRACT(YEAR FROM NOW());
    v_num  BIGINT;
BEGIN
    INSERT INTO application_sequences (year, last_number)
    VALUES (v_year, 1)
    ON CONFLICT (year) DO UPDATE
        SET last_number = application_sequences.last_number + 1
    RETURNING last_number INTO v_num;
    
    RETURN 'YEM-' || v_year || '-' || LPAD(v_num::TEXT, 6, '0');
END;
$$ LANGUAGE plpgsql;

---

🔹 مجموعة 6: سير العمل (Workflow)

workflow_history

sql

CREATE TABLE workflow_history (
    id              BIGSERIAL PRIMARY KEY,
    application_id  BIGINT NOT NULL REFERENCES applications(id) ON DELETE CASCADE,
    actor_id        BIGINT REFERENCES users(id),
    actor_type      VARCHAR(20) NOT NULL CHECK (actor_type IN ('user','applicant','system')),
    action          VARCHAR(50) NOT NULL,   -- submit, assign, approve, reject, print, etc.
    from_status     VARCHAR(20),
    to_status       VARCHAR(20),
    comment         TEXT,
    metadata        JSONB,                   -- بيانات إضافية
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_workflow_app ON workflow_history(application_id, created_at DESC);
CREATE INDEX idx_workflow_actor ON workflow_history(actor_id, created_at DESC);

review_assignments (توزيع المهام)

sql

CREATE TABLE review_assignments (
    id              BIGSERIAL PRIMARY KEY,
    application_id  BIGINT NOT NULL REFERENCES applications(id),
    reviewer_id     BIGINT NOT NULL REFERENCES users(id),
    assigned_by     BIGINT NOT NULL REFERENCES users(id),
    assigned_at     TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    accepted_at     TIMESTAMPTZ,
    completed_at    TIMESTAMPTZ,
    is_active       BOOLEAN DEFAULT TRUE
);

CREATE UNIQUE INDEX uk_active_assignment ON review_assignments(application_id) 
    WHERE is_active = TRUE;

---

🔹 مجموعة 7: الوثائق الصادرة

issued_documents

sql

CREATE TABLE issued_documents (
    id                  BIGSERIAL PRIMARY KEY,
    application_id      BIGINT NOT NULL REFERENCES applications(id),
    document_number     VARCHAR(30) NOT NULL UNIQUE,   -- DOC-2026-000123
    document_type       VARCHAR(30) NOT NULL CHECK (document_type IN (
                            'temporary_id_card','full_id_card'
                        )),
    verification_token  UUID NOT NULL UNIQUE DEFAULT gen_random_uuid(),
    qr_payload_hash     VARCHAR(64) NOT NULL,
    pdf_s3_key          VARCHAR(500) NOT NULL,
    issued_at           TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    expires_at          TIMESTAMPTZ,
    issued_by           BIGINT REFERENCES users(id),
    revoked_at          TIMESTAMPTZ,
    revocation_reason   TEXT,
    is_valid            BOOLEAN GENERATED ALWAYS AS (revoked_at IS NULL) STORED
);

CREATE INDEX idx_issued_app ON issued_documents(application_id);
CREATE INDEX idx_issued_token ON issued_documents(verification_token);

print_jobs

sql

CREATE TABLE print_jobs (
    id                  BIGSERIAL PRIMARY KEY,
    application_id      BIGINT NOT NULL REFERENCES applications(id),
    document_id         BIGINT REFERENCES issued_documents(id),
    printed_by          BIGINT NOT NULL REFERENCES users(id),
    printer_ip          INET,
    copies              SMALLINT NOT NULL DEFAULT 1,
    status              VARCHAR(20) NOT NULL CHECK (status IN ('queued','processing','completed','failed')),
    error_message       TEXT,
    started_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    completed_at        TIMESTAMPTZ
);

CREATE INDEX idx_print_jobs_app ON print_jobs(application_id);

---

🔹 مجموعة 8: التدقيق والمرجعيات

audit_logs (Partitioned by month)

sql

CREATE TABLE audit_logs (
    id              BIGSERIAL,
    actor_type      VARCHAR(20) NOT NULL,
    actor_id        BIGINT,
    actor_username  VARCHAR(50),
    action          VARCHAR(100) NOT NULL,
    entity_type     VARCHAR(50) NOT NULL,
    entity_id       BIGINT,
    old_values      JSONB,
    new_values      JSONB,
    ip_address      INET,
    user_agent      TEXT,
    request_id      UUID,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    PRIMARY KEY (id, created_at)
) PARTITION BY RANGE (created_at);

-- Partitions شهرية
CREATE TABLE audit_logs_2026_01 PARTITION OF audit_logs
    FOR VALUES FROM ('2026-01-01') TO ('2026-02-01');
-- ... إلخ

CREATE INDEX idx_audit_entity ON audit_logs(entity_type, entity_id);
CREATE INDEX idx_audit_actor ON audit_logs(actor_id, created_at DESC);
CREATE INDEX idx_audit_action ON audit_logs(action, created_at DESC);

settings

sql

CREATE TABLE settings (
    key         VARCHAR(100) PRIMARY KEY,
    value       JSONB NOT NULL,
    description TEXT,
    updated_by  BIGINT REFERENCES users(id),
    updated_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

-- Seed
INSERT INTO settings (key, value, description) VALUES
('application.max_file_size',    '5242880',      'حد أقصى 5MB'),
('application.allowed_mimes',    '["image/jpeg","image/png","application/pdf"]', ''),
('application.otp_ttl_seconds',  '300',          'مدة صلاحية OTP'),
('application.max_otp_attempts', '5',            'عدد محاولات OTP'),
('workflow.auto_assign',         'true',         'توزيع تلقائي على المراجعين');

notifications

sql

CREATE TABLE notifications (
    id              BIGSERIAL PRIMARY KEY,
    recipient_type  VARCHAR(20) NOT NULL CHECK (recipient_type IN ('user','applicant')),
    recipient_id    BIGINT NOT NULL,
    channel         VARCHAR(20) NOT NULL CHECK (channel IN ('sms','email','push','in_app')),
    template_code   VARCHAR(50) NOT NULL,
    subject         VARCHAR(200),
    body            TEXT NOT NULL,
    metadata        JSONB,
    status          VARCHAR(20) NOT NULL DEFAULT 'pending' 
                    CHECK (status IN ('pending','sent','failed','delivered','read')),
    sent_at         TIMESTAMPTZ,
    delivered_at    TIMESTAMPTZ,
    read_at         TIMESTAMPTZ,
    error_message   TEXT,
    retry_count     SMALLINT DEFAULT 0,
    created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX idx_notif_recipient ON notifications(recipient_type, recipient_id, created_at DESC);
CREATE INDEX idx_notif_status ON notifications(status) WHERE status IN ('pending','failed');

---

4️⃣ العلاقات (Relationships Summary)

العلاقة	النوع	الوصف
users → roles	M:1	كل مستخدم له دور واحد
users → applications	1:N	المراجع مسؤول عن عدة طلبات
applicants → applications	1:1	كل مستفيد له طلب واحد نشط
applicants → addresses	1:N	عنوان الإقامة + عنوان اليمن
applicants → attachments	1:N	1 شخصية + 6 اختيارية
applications → workflow_history	1:N	سجل كامل للتغييرات
applications → issued_documents	1:N	بطاقات صادرة
applications → print_jobs	1:N	عمليات الطباعة
regions/governorates → districts	1:N	هرمية جغرافية
issued_documents → verification	1:1	رمز QR للتحقق

---

5️⃣ الفهارس الحرجة (Critical Indexes)

sql

-- بحث سريع عن طلب برقم مرجعي (شائع)
CREATE UNIQUE INDEX CONCURRENTLY uk_app_reference ON applications(reference_number);

-- قائمة انتظار المراجعة (dashboard)
CREATE INDEX CONCURRENTLY idx_review_queue ON applications(status, priority DESC, submitted_at ASC)
    WHERE status IN ('submitted','under_review');

-- بحث المستفيد (شائع جداً)
CREATE INDEX CONCURRENTLY idx_applicant_search ON applicants 
    USING GIN (to_tsvector('arabic', full_name_ar));
CREATE INDEX CONCURRENTLY idx_applicant_mobile ON applicants(mobile_hash);

-- تحقق من QR
CREATE INDEX CONCURRENTLY idx_verify_token ON issued_documents(verification_token) 
    WHERE revoked_at IS NULL;

---

6️⃣ العرض المادي (Materialized Views) للتقارير

sql

-- لوحة KPI اليومية
CREATE MATERIALIZED VIEW mv_daily_stats AS
SELECT
    DATE(created_at) AS day,
    COUNT(*) FILTER (WHERE status = 'submitted')     AS submitted,
    COUNT(*) FILTER (WHERE status = 'approved')      AS approved,
    COUNT(*) FILTER (WHERE status = 'rejected')      AS rejected,
    COUNT(*) FILTER (WHERE status = 'printed')       AS printed,
    AVG(EXTRACT(EPOCH FROM (decided_at - submitted_at))/3600)::NUMERIC(10,2) AS avg_review_hours
FROM applications
WHERE deleted_at IS NULL
GROUP BY DATE(created_at);

CREATE UNIQUE INDEX ON mv_daily_stats(day);

-- تحديث كل ساعة
-- REFRESH MATERIALIZED VIEW CONCURRENTLY mv_daily_stats;

---

7️⃣ سياسات الاحتفاظ بالبيانات (Retention)

الجدول	المدة	الإجراء
applications	10 سنوات	أرشفة (cold storage)
audit_logs	7 سنوات	تقسيم + S3 Glacier
attachments	5 سنوات بعد الرفض	حذف تلقائي
issued_documents	10 سنوات	أرشفة
notifications	2 سنوات	حذف
sessions	90 يوم	حذف
otp_verifications	30 يوم	حذف

sql

-- مثال: دالة حذف OTP منتهية
CREATE OR REPLACE FUNCTION cleanup_expired_otps()
RETURNS void AS $$
BEGIN
    DELETE FROM otp_verifications
    WHERE created_at < NOW() - INTERVAL '30 days';
END;
$$ LANGUAGE plpgsql;

---

8️⃣ الأمان على مستوى الصفوف (RLS)

sql

-- المراجعون يرون فقط الطلبات المسندة إليهم
ALTER TABLE applications ENABLE ROW LEVEL SECURITY;

CREATE POLICY reviewer_sees_assigned ON applications
    FOR SELECT
    TO reviewer_role
    USING (assigned_reviewer_id = current_setting('app.current_user_id')::BIGINT
           OR status = 'submitted');

-- المشرفون يرون الكل
CREATE POLICY supervisor_sees_all ON applications
    FOR ALL
    TO supervisor_role
    USING (TRUE);

---

9️⃣ اعتبارات الأداء والتوسع

التقسيم (Partitioning)

• audit_logs → شهري (PostgreSQL native).
• notifications → شهري.
• applications → سنوي (عند تجاوز 5M صف).

النسخ المتماثل (Replication)

• Primary (كتابة) + 2 Read Replicas للتقارير.
• Streaming Replication مع synchronous_commit = remote_apply للبيانات الحساسة.

النسخ الاحتياطي

• WAL Archiving مستمر → S3.
• Full Backup يومي (pg_basebackup).
• PITR لمدة 30 يوم.
• اختبار استعادة ربع سنوي.

الاتصالات

• PgBouncer في وضع transaction pooling.
• max_connections = 500 (مع PgBouncer).

---

🔟 مخطط ERD بصيغة Mermaid (للاستخدام في المستندات)

---

1️⃣1️⃣ الخطوات التالية

هل تريد أن أتعمق في:

• 🔌 مواصفات OpenAPI 3.1 كاملة لكل endpoint مرتبط بهذا المخطط؟
• 🔐 أمثلة عملية لتشفير pgcrypto (تشفير/فك تشفير/بحث)؟
• 📊 استعلامات SQL جاهزة للتقارير ولوحات التحكم؟
• 🚀 سكريبتات Migration (Flyway/Prisma)؟
• 🧪 بيانات Seed واقعية (محافظات، مديريات، أدوار)؟
• 📄 قالب PDF حزمة الطباعة (HTML/CSS → PDF)؟
• 🔄 آلية Workflow Engine (State Machine)؟

اختر الأولوية وسأعمّق فيها. 🚀

https://registeryem.somee.com/registerYemen/Register.aspx