# Admin Operational QA Checklist

## الهدف

هذا الدليل مخصص لتجربة لوحة الإدارة بشكل تشغيلي واقعي بعد تنظيم:

- الـ sidebar
- الـ topbar
- الـ workspace labels
- الـ quick actions
- صفحات CRM
- صفحات Corporate
- صفحات Finance / Attendance / WhatsApp / Messaging / System

استخدم معه ملف التنفيذ العملي:

- [admin_operational_qa_execution_pass.md](C:/Users/a-djoudi/apps/ecoinv3/docs/admin_operational_qa_execution_pass.md)

الهدف ليس فقط التأكد أن الصفحة تفتح، بل التأكد أن الموظف يستطيع فهم مكانه، معرفة الإجراء التالي، وإنجاز عمله بدون ارتباك.

## قواعد عامة قبل البدء

1. استخدم حسابًا مناسبًا للدور الذي ستختبره.
2. اختبر من سطح المكتب ثم من الهاتف أو شاشة ضيقة.
3. تحقق من:
   - عنوان الصفحة
   - workspace label
   - وجود quick actions المناسبة
   - عدم ظهور روابط غير مسموحة
   - عدم ظهور raw translation keys
   - عدم وجود أزرار معطلة بلا سبب واضح
4. عند ظهور مشكلة، سجّل:
   - الصفحة
   - الدور المستخدم
   - الخطوات
   - النتيجة الحالية
   - النتيجة المتوقعة
   - لقطة شاشة إن أمكن

## قالب تسجيل الملاحظات

| الحقل | القيمة |
|---|---|
| التاريخ | |
| اسم المختبر | |
| الدور | |
| الصفحة | |
| الرابط | |
| الخطوات | |
| النتيجة الحالية | |
| النتيجة المتوقعة | |
| الشدة | منخفض / متوسط / عال |
| مرفقات | |

## 1) Admin / Super Admin

### صفحات يجب فتحها

- `/admin/dashboard`
- `/admin/crm`
- `/admin/organizations`
- `/admin/corporate-dashboard`
- `/admin/finance/overview`
- `/admin/attendance`
- `/admin/messaging/templates`
- `/admin/messaging/whatsapp`
- `/admin/settings`
- `/admin/audit`
- `/admin/health`
- `/admin/guide`

### ما يجب التحقق منه

- تظهر كل أقسام الـ sidebar بترتيب واضح ومنطقي.
- يظهر `quick access` في الـ topbar.
- يظهر `workspace actions` في الصفحات الأساسية.
- التنقل بين الصفحات يتم بدون روابط مكسورة.
- صفحات النظام تعرض `مساحة الإدارة`.
- صفحات المؤسسات تعرض `مساحة المؤسسات`.
- صفحات CRM تعرض `مساحة CRM`.
- صفحات المالية تعرض `مساحة المالية`.
- صفحات الحضور والتكوين تعرض `مساحة التكوين`.
- صفحات الرسائل وواتساب تعرض `مساحة التواصل`.

## 2) موظف التسجيلات

### الصفحات الأساسية

- `/admin/registrations`
- `/admin/registrations/create`
- `/admin/registrations/pipeline`
- `/admin/payments/review`

### التحقق

- يرى قسم `التسجيلات والطلاب`.
- لا يرى أقسام المالية أو المؤسسات إذا لم تكن له صلاحية.
- في صفحة التسجيلات:
  - يظهر workspace label الصحيح
  - يظهر زر `تسجيل جديد`
  - يظهر رابط `خط سير التسجيلات`
  - لا تظهر روابط غير مرتبطة بعمله

## 3) موظف CRM / المبيعات

### الصفحات الأساسية

- `/admin/crm`
- `/admin/crm/leads`
- `/admin/crm/leads/create`
- `/admin/crm/tasks`

### التحقق

- تظهر `مساحة CRM`.
- تظهر leads وtasks بوضوح.
- تظهر quick actions المناسبة:
  - فتح lead
  - عرض مهام lead
  - الانتقال بين dashboard والقائمة والمهام
- في الهاتف:
  - cards واضحة
  - jump bars تعمل
  - لا يوجد تكدس بصري

## 4) موظف التكوين والحضور

### الصفحات الأساسية

- `/admin/courses`
- `/admin/cohorts`
- `/admin/attendance`
- `/admin/attendance/manage`
- `/admin/attendance/no-show`

### التحقق

- تظهر `مساحة التكوين`.
- روابط:
  - الدورات
  - الأفواج
  - الحضور
  - عدم الحضور
  واضحة وغير مكسورة.
- صفحة الحضور تعرض:
  - cohort/date filters
  - quick actions
  - مؤشرات الجلسة
- صفحة no-show تعرض:
  - روابط عودة واضحة
  - زر follow-up واضح

## 5) موظف المؤسسات

### الصفحات الأساسية

- `/admin/corporate-dashboard`
- `/admin/organizations`
- `/admin/b2b/leads`
- `/admin/corporate-proposals`
- `/admin/corporate-agreements`
- `/admin/corporate-cohorts`
- `/admin/corporate-reports`
- `/admin/corporate-invoices`
- `/admin/corporate-payments`
- `/admin/corporate-finance/receivables`
- `/admin/corporate-credit-notes`

### التحقق

- كل هذه الصفحات تعرض `مساحة المؤسسات`.
- القوائم تعرض quick actions منطقية حسب السياق.
- صفحات التفاصيل تعرض اختصارات نحو الصفحة التالية في workflow.
- لا يوجد رابط مكسور بين:
  - المؤسسة
  - العرض
  - الاتفاقية
  - الفوج
  - التقرير
  - الفاتورة
  - الدفعة
  - المستحقات
  - الإشعار الدائن

## 6) موظف المالية

### الصفحات الأساسية

- `/admin/finance/overview`
- `/admin/finance/revenue`
- `/admin/finance/expenses`
- `/admin/finance/expenses/manage`
- `/admin/finance/cashflow`
- `/admin/finance/aging`
- `/admin/payments/review`

### التحقق

- تظهر `مساحة المالية`.
- تظهر quick actions مثل:
  - نظرة عامة
  - المصاريف
  - إدارة المصاريف
- القيم واضحة بصريًا.
- لا تظهر صفحات لا تخص الدور.

## 7) موظف التواصل / الرسائل

### الصفحات الأساسية

- `/admin/messaging/templates`
- `/admin/settings/messaging`
- `/admin/messaging/outbox`
- `/admin/messaging/logs`
- `/admin/messaging/whatsapp`
- `/admin/messaging/whatsapp/inbox`
- `/admin/messaging/whatsapp/templates`
- `/admin/messaging/whatsapp/outbox`
- `/admin/messaging/whatsapp/logs`
- `/admin/messaging/whatsapp/settings`
- `/admin/messaging/whatsapp/flows`

### التحقق

- تظهر `مساحة التواصل`.
- الانتقال بين messaging العام وWhatsApp واضح.
- quick actions منطقية:
  - الإعدادات
  - القوالب
  - السجلات
  - الصندوق
- لا يوجد خلط بين صفحات WhatsApp وصفحات messaging العامة.

## 8) صفحات النظام والإدارة

### الصفحات الأساسية

- `/admin/settings`
- `/admin/audit`
- `/admin/audit/logs`
- `/admin/health`
- `/admin/health/alerts`
- `/admin/health/rules`
- `/admin/guide`
- `/admin/guide/workflows`

### التحقق

- تظهر `مساحة الإدارة`.
- توجد روابط سريعة متبادلة بين:
  - Settings
  - Audit
  - Health
  - Guide
- صفحة Guide واضحة كمرجع تشغيلي وليست صفحة معزولة.

## 9) تجربة الهاتف

اختبر على عرض ضيق أو من الهاتف:

- هل الـ sidebar والـ topbar يبقيان مفهومين؟
- هل الأزرار الأساسية ما زالت واضحة؟
- هل cards أهم من الجداول عند الحاجة؟
- هل النصوص لا تتكسر؟
- هل الأزرار لا تتداخل؟

## 10) إشارات تعتبر Bug مباشرة

- رابط يرجع 404 أو 500.
- صفحة لا تعرض workspace label صحيح.
- ظهور raw key مثل `admin_nav.*` أو `corporate.*`.
- ظهور صفحة لا يجب أن يراها هذا الدور.
- زر مهم مختفٍ رغم وجود الصلاحية.
- زر ظاهر لكن يؤدي إلى route غير صحيح.
- ترتيب تنقل يربك الموظف أو يقوده إلى صفحة لا تخص مساره.

## 11) ترتيب تنفيذ التجربة

1. ابدأ بالـ Admin الكامل للتأكد من الهيكل العام.
2. اختبر كل دور على حدة.
3. ركز على workflow الحقيقي لكل موظف.
4. وثّق المشاكل حسب الدور وليس حسب الصفحة فقط.
5. بعد أول جولة، أعد اختبار الإصلاحات على نفس checklist.

## 12) الحالة الحالية

حتى لحظة إعداد هذا الدليل:

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

## توصية التشغيل

لأفضل نتيجة:

- خصص لكل موظف 20 إلى 30 دقيقة.
- اطلب منه تنفيذ مساره الحقيقي فقط.
- لا تبدأ بجميع الصفحات دفعة واحدة.
- استخدم هذا الدليل كمرجع موحد لجمع الملاحظات.