# Admin Operational QA Execution Pass

## الهدف

هذا الملف هو خطة التنفيذ العملية لجولة QA التشغيلية بعد تثبيت:

- Admin shell
- CRM
- Corporate
- Finance
- Attendance
- Messaging / WhatsApp
- System / Health / Audit / Guide

ولتجميع الملاحظات اليومية استخدم:

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

الهدف هنا ليس فقط "فتح الصفحات"، بل تنفيذ جولة اختبار واقعية حسب دور كل موظف، مع تسجيل الملاحظات بطريقة موحدة وسريعة.

## قبل البدء

1. شغّل الحزمة الآلية أولًا:

```bash
composer test:admin-ui-regression
```

2. تأكد أن النتيجة:
- كل suites تمر
- `php artisan app:architecture-check` يبقى عند `Findings: 22`

3. استخدم هذا الملف مع:
- [admin_operational_qa_checklist.md](C:/Users/a-djoudi/apps/ecoinv3/docs/admin_operational_qa_checklist.md)

## ترتيب الجولات

### الجولة 1: Admin / Super Admin

الهدف:
- التأكد أن الهيكل العام متماسك
- التأكد أن كل domains تظهر بشكل منطقي
- اكتشاف أي route broken أو workspace label خاطئ

الوقت المقترح:
- 20 إلى 30 دقيقة

التركيز:
- sidebar
- topbar
- quick access
- workspace actions
- الانتقال بين الصفحات الرئيسية

### الجولة 2: الأدوار التشغيلية الأساسية

نفّذها بهذا الترتيب:

1. موظف التسجيلات
2. موظف CRM
3. موظف التكوين والحضور
4. موظف المؤسسات
5. موظف المالية
6. موظف التواصل / الرسائل

السبب:
- هذا الترتيب يمر من front-office إلى back-office
- ويسهّل فهم أين يبدأ أي احتكاك تشغيلي فعلي

### الجولة 3: صفحات النظام

نفّذها بعد الأدوار السابقة:

- Settings
- Audit
- Health
- Guide

الهدف:
- التأكد أن مسار الإدارة العليا واضح
- التأكد أن صفحات النظام ليست معزولة عن بقية اللوحة

## طريقة التنفيذ لكل مختبر

لكل موظف:

1. ادخل بحساب دوره الحقيقي.
2. افتح فقط الصفحات الخاصة بمساره.
3. نفّذ إجراءين أو ثلاثة حقيقية، لا مجرد فتح الصفحة.
4. سجّل فقط الملاحظات المهمة.

## ماذا نختبر في كل صفحة

### 1. الفهم السريع

- هل يفهم المستخدم أين هو؟
- هل `workspace label` واضح؟
- هل عنوان الصفحة دقيق؟

### 2. الإجراء التالي

- هل يوجد CTA واضح؟
- هل يعرف المستخدم ماذا يفعل بعد ذلك؟
- هل توجد روابط سريعة منطقية؟

### 3. الصلاحيات

- هل ظهرت فقط الروابط المسموحة؟
- هل اختفت الروابط غير المصرح بها؟
- هل route نفسها محمية؟

### 4. التماسك البصري

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

### 5. الموبايل

- هل cards أوضح من الجداول عند الحاجة؟
- هل jump bars أو quick actions ما زالت مفيدة؟
- هل النصوص تنكسر أو تتداخل؟

## سيناريوهات التنفيذ السريعة

### Admin / Super Admin

نفّذ:

1. افتح dashboard
2. انتقل إلى CRM
3. انتقل إلى Corporate Dashboard
4. انتقل إلى Finance Overview
5. انتقل إلى Attendance
6. افتح Messaging / WhatsApp
7. افتح Settings / Audit / Health / Guide

نتيجة متوقعة:
- لا يوجد route مكسور
- كل مساحة تعرض workspace مناسب
- topbar وsidebar متناسقان

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

نفّذ:

1. افتح registrations
2. افتح pipeline
3. افتح create registration
4. افتح payment review

نتيجة متوقعة:
- يرى فقط ما يخص التسجيلات
- لا يتشتت بروابط مالية أو مؤسساتية لا تخصه

### موظف CRM

نفّذ:

1. افتح CRM dashboard
2. افتح leads list
3. افتح lead detail
4. افتح tasks

نتيجة متوقعة:
- يجد `open lead` و`related tasks` بسرعة
- الصفحة لا تبدو مزدحمة
- المتابعات المتأخرة واضحة

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

نفّذ:

1. افتح corporate dashboard
2. افتح organizations
3. افتح proposal detail
4. افتح agreement detail
5. افتح invoice detail
6. افتح payment detail

نتيجة متوقعة:
- الانتقال بين خطوات workflow واضح
- لا يوجد shortcut مفقود أو رابط خاطئ

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

نفّذ:

1. افتح finance overview
2. revenue
3. expenses
4. expenses manage
5. cashflow
6. aging

نتيجة متوقعة:
- الواجهة عملية وواضحة
- لا يوجد خلط مع مساحات لا تخص المالية

### موظف التواصل

نفّذ:

1. messaging templates
2. messaging settings
3. messaging outbox
4. messaging logs
5. whatsapp dashboard
6. whatsapp inbox / templates / logs / settings

نتيجة متوقعة:
- التفريق بين Messaging وWhatsApp واضح
- الروابط السريعة منطقية

## تصنيف المشاكل

### P1

- 500 / 404
- route مكسور
- role يشاهد صفحات لا يجب أن يراها
- CTA أساسي لا يعمل

### P2

- workspace label خاطئ
- quick action غير منطقي
- route صحيح لكن يوجّه إلى صفحة مربكة
- mobile behavior سيئ في صفحة أساسية

### P3

- spacing
- copywriting
- ترتيب بصري
- تحسين قابلية الفهم

## قالب رفع الملاحظات

انسخ هذا القالب لكل ملاحظة:

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

## بعد نهاية كل جولة

1. اجمع الملاحظات حسب الدور.
2. افصل بين:
- broken routes
- permission issues
- UX confusion
- mobile issues

3. أصلح `P1` أولًا.
4. أعد نفس الجولة على نفس الدور.

## التوصية العملية

أفضل تنفيذ الآن:

1. Admin / Super Admin
2. CRM
3. Corporate
4. Finance
5. Attendance / Training
6. Messaging / WhatsApp
7. System

هذا الترتيب يعطي أسرع صورة عن readiness الفعلية للوحة.