# 16 — مكتب الاستقبال

## نظرة عامة

واجهة مخصصة لموظف الاستقبال تجمع العمليات اليومية الأكثر شيوعاً في مكان واحد: تسجيل مشترك جديد، تسجيل موجود في مجموعة، تحصيل دفعة.

---

## الشاشات المنفذة

### 1. لوحة الاستقبال (`/receptionist`)

**من يراها:** من لديه صلاحية `participants.list` (موظف الاستقبال عادةً)

**المحتوى:**
- 3 بطاقات كبيرة (اختصارات):
  1. **تسجيل جديد** → ويزارد التسجيل الكامل
  2. **تسجيل في مجموعة** → ويزارد تسجيل مشترك موجود
  3. **تحصيل دفعة** → ويزارد التحصيل

- إحصائيات سريعة:
  - مشتركين تم تسجيلهم اليوم
  - مدفوعات اليوم
  - حصص اليوم

---

### 2. ويزارد التسجيل الجديد (`/receptionist/new-registration`)

**من يراها:** من لديه صلاحية `participants.create`

**الوصف:** ويزارد شامل يأخذ موظف الاستقبال من الصفر إلى مشترك مفعّل في خطوات واضحة.

**الخطوات:**

#### الخطوة 1: بيانات المشترك
- الاسم بالعربية (مطلوب)
- الاسم بالإنجليزية
- الرقم القومي → يستنتج تاريخ الميلاد والجنس
- تاريخ الميلاد
- الجنس
- الهاتف

#### الخطوة 2: ولي الأمر
- بحث عن ولي أمر موجود أو إنشاء جديد
- اسم ولي الأمر
- هاتف ولي الأمر
- صلة القرابة

#### الخطوة 3: اختيار البرنامج والمجموعة
- عرض البرامج المتاحة (مصفّاة حسب العمر والجنس)
- عرض المجموعات لكل برنامج (مع السعة المتبقية)
- اختيار المجموعة

#### الخطوة 4: حساب السعر والدفع
- عرض السعر المحسوب (من محرك التسعير)
- حقل كوبون (اختياري)
- اختيار طريقة الدفع
- خيار: دفع الآن أو تأجيل

#### الخطوة 5: مراجعة وتأكيد
- ملخص كل البيانات
- زر "تأكيد التسجيل"

```mermaid
flowchart TD
    A[الخطوة 1: بيانات المشترك] --> B[الخطوة 2: ولي الأمر]
    B --> C[الخطوة 3: البرنامج والمجموعة]
    C --> D[الخطوة 4: السعر والدفع]
    D --> E[الخطوة 5: مراجعة وتأكيد]
    E --> F{إتمام}
    F --> G[إنشاء شخص + مشترك + ولي أمر]
    F --> H[إنشاء اشتراك]
    F --> I[إنشاء فاتورة]
    F --> J[تسجيل دفعة - إذا دفع الآن]
    F --> K[تفعيل - إذا دُفع]
```

---

### 3. ويزارد تسجيل مشترك موجود (`/receptionist/enroll-existing`)

**من يراها:** من لديه صلاحية `enrollments.create`

**الوصف:** لمشترك مسجّل بالفعل يريد الانضمام لمجموعة جديدة أو تجديد اشتراك.

**الخطوات:**

#### الخطوة 1: البحث عن المشترك
- بحث بالاسم أو الهاتف أو رقم المشترك
- عرض بيانات المشترك المُختار

#### الخطوة 2: اختيار المجموعة
- عرض المجموعات المتاحة
- إظهار اشتراكاته الحالية (لتجنب التكرار)

#### الخطوة 3: السعر والدفع
- حساب السعر
- كوبون (اختياري)
- طريقة الدفع

#### الخطوة 4: تأكيد

---

### 4. ويزارد تحصيل دفعة (`/receptionist/collect-payment`)

**من يراها:** من لديه صلاحية `invoices.create`

**الوصف:** لتحصيل دفعة على فاتورة قائمة (بدون إنشاء اشتراك جديد).

**الخطوات:**

#### الخطوة 1: البحث عن المشترك
- بحث بالاسم أو الهاتف

#### الخطوة 2: اختيار الفاتورة
- عرض الفواتير المعلقة/المتأخرة للمشترك
- المبلغ المتبقي لكل فاتورة

#### الخطوة 3: إدخال الدفعة
- المبلغ (يعبأ بالمتبقي تلقائياً)
- طريقة الدفع
- ملاحظات

#### الخطوة 4: تأكيد وإيصال
- طباعة إيصال
- أو إرسال إيصال إلكتروني

---

## سيناريوهات يومية

### سيناريو 1: عميل جديد يأتي للسؤال ويسجّل
> 1. الأب يأتي مع ابنه (7 سنوات)
> 2. الاستقبال يضغط "تسجيل جديد"
> 3. يُدخل اسم الطفل + الرقم القومي → العمر 7 يظهر تلقائياً
> 4. يُدخل بيانات الأب كولي أمر
> 5. يعرض البرامج: "أشبال 7-9 سنوات" متاح
> 6. يعرض المجموعات: "سبت-اثنين" بها 3 أماكن
> 7. السعر: 1500 ج.م — كوبون "FRIEND": خصم 100 ج.م → 1400 ج.م
> 8. الأب يدفع كاش
> 9. تأكيد: المشترك نشط + فاتورة مدفوعة + إيصال
> 10. **إجمالي الوقت: 3 دقائق**

### سيناريو 2: مشترك حالي يجدد اشتراكه
> 1. "أحمد" اشتراكه ينتهي الأسبوع القادم
> 2. الأب يأتي للتجديد
> 3. الاستقبال يضغط "تسجيل في مجموعة"
> 4. يبحث "أحمد" → يظهر
> 5. يختار نفس المجموعة (تجديد)
> 6. السعر: 1500 ج.م — خصم ولاء (سنة+): 10% → 1350 ج.م
> 7. دفع + تأكيد

### سيناريو 3: ولي أمر يأتي لدفع فاتورة متأخرة
> 1. الاستقبال يضغط "تحصيل دفعة"
> 2. يبحث باسم الأب أو الابن
> 3. يظهر: فاتورة #INV-2024-0045 — متأخرة — متبقي 750 ج.م
> 4. الأب يدفع 750 ج.م كاش
> 5. الفاتورة → "مدفوعة"
> 6. طباعة إيصال

### سيناريو 4: المجموعة ممتلئة
> 1. الأب يريد تسجيل ابنه في مجموعة "سبت-اثنين"
> 2. الويزارد يُظهر: "ممتلئة (20/20)"
> 3. خيار: إضافة لقائمة الانتظار
> 4. الأب يوافق → "تمت الإضافة — سنُبلغكم عند فتح مكان"

---

## لماذا يحتاج عملك هذا

| الميزة | الفائدة |
|--------|---------|
| ويزارد شامل | 3 دقائق من البداية للنهاية — بدلاً من 5 شاشات مختلفة |
| بحث ذكي | يجد المشترك بسرعة بأي طريقة |
| حساب سعر فوري | لا حاجة لسؤال المدير عن السعر |
| طباعة إيصال فوري | احترافية — العميل يغادر بإيصال |
| كشف التكرار | لا يُسجّل نفس الطفل مرتين |
| التصفية الذكية | يُظهر فقط البرامج المناسبة للعمر |
| لا حاجة لتدريب طويل | الويزارد يوجّه الموظف خطوة بخطوة |

---

## التكاملات

| الوحدة | العلاقة |
|--------|---------|
| المشتركين | إنشاء مشترك جديد |
| التسجيل | إنشاء اشتراك |
| التسعير | حساب السعر + تطبيق الكوبون |
| المالية | إنشاء فاتورة + تسجيل دفعة |
| الورديات | العملية ترتبط بالوردية المفتوحة |
| الإشعارات | إرسال إيصال + إشعار تسجيل |
