الإعداد الإرشادي والتنظيمي

بعد قيام المستخدم بالتسجيل، يجب عليه إما الانضمام إلى منظمة كنسية موجودة أو توفير منظمة جديدة قبل أن يتمكن من الوصول إلى الميزات التشغيلية.

---

1. مسارات الإعداد

عند الوصول إلى المسار /welcome، يتم تقديم إجراءين أساسيين للمستخدمين:

المسار أ: إنشاء منظمة جديدة

يستخدم من قبل القساوسة أو القادة الإداريين لإعداد منصة لأبرشيتهم.

• معلمات الإدخال: اسم الكنيسة، المدينة، الولاية، البريد الإلكتروني لجهة الاتصال، هاتف جهة الاتصال، ونوع المؤسسة (“الكنيسة” أو “الأبرشية”).
• تنفيذ قاعدة البيانات: ينفذ العميل RPC create_organization_with_admin.
• تهيئة النظام:
  1. يقوم بإدراج سجل جديد في “public.organizations”.
  2. يُنشئ رمز انضمام فريدًا مكونًا من 8 أحرف عبر مشغل قاعدة البيانات (generate_org_join_code).
  3. يقوم بإدراج أدوار النظام الأساسي الافتراضية (المسؤول، العضو) عبر المشغل trg_seed_church_roles.
  4. يربط الملف الشخصي للمنشئ بالمؤسسة الجديدة (profiles.organization_id = org_id).
  5. يمنح المستخدم دور “المسؤول” في النظام في “public.user_church_roles”.

المسار ب: الانضمام إلى منظمة موجودة

يستخدمه أعضاء الكنيسة والمتطوعين والخدم للتسجيل ضمن أبرشيتهم المحلية.

• معلمة الإدخال: رمز_الانضمام فريد مكون من 8 أحرف (على سبيل المثال، A3F9B2C7).
• التحقق: يتحقق النظام من وجود مؤسسة برمز الانضمام المطابق.
• الإرسال: إذا تم التحقق منه، يقوم العميل بإدخال طلب في public.join_requests الذي يحتوي على معرف المستخدم، ومعرف المؤسسة، وهاتف جهة الاتصال، وإجابات نموذج الاشتراك الاختيارية (form_data JSONB).

---

2. تدفق طلبات الانضمام (طلبات_الانضمام)

عندما يرسل المستخدم طلب انضمام، يتم وضعه في نمط الحجز.

[يرسل المستخدم طلب الانضمام]
             │
             ▼
    [الحالة: "في انتظار المراجعة"] ◄─── (يرى المستخدم شاشة التحميل "في انتظار الموافقة")
             │
      (مراجعات إدارة الكنيسة)
             ├────────────────────────┐
             ▼ (موافقة) ▼ (رفض)
    [الحالة: "موافق عليها"] [الحالة: "مرفوضة"]
             │ │
    * رابط Profiles.org_id * يظل غير متصل
    * منح "العضو" الافتراضي * يمكن للمستخدم إعادة المحاولة
      دور الكنيسة

منطق المراجعة

• رؤية المسؤول: يتم عرض الطلبات في لوحة إعدادات الكنيسة ضمن الدعوات والطلبات المعلقة. يمكن للمسؤولين عرض الأسماء وأرقام الهواتف ومحتوى الرسالة المقدمة.
• معالجة الموافقة:
  • يوافق المشرف على الطلب.
  • يقوم النظام بتحديث join_requests.status = 'approved'.
  • يقوم النظام بتحديث “profiles.organization_id” الخاص بمقدم الطلب ليتوافق مع رقم تعريف الكنيسة.
  • يتم تعيين دور “العضو” الافتراضي لمقدم الطلب داخل “user_church_roles”.
• معالجة الرفض:
  • المشرف يرفض الطلب.
  • تم تحديث الحالة إلى ""مرفوض"". يتم إعلام المستخدم ويمكنه التقدم إلى كنيسة مختلفة باستخدام رمز آخر.