# Sprint 8 — لوحة الأدمن: CRUDs + الرئيسية + التقارير

> اسبرينت مرتّب بالاعتماديات، يجمّع ملفات الخطط أدناه. **قابل للتنفيذ مباشرةً:** شدّ المساعد على هذا الملف ينفّذ الاسبرينت كله.

## ▶ تنفيذ الاسبرينت (في Cursor)
افتح هذا الملف وقل للمساعد:
```
نفّذ هذا الاسبرينت بالكامل (sprints/8.md): اقرأ كل ملف خطة في «النطاق» ونفّذه عبر docs/build/* ثم احفظ.
```

> 📋 **لوحة الكانبان (`/kanban`):** كل خطوة تحت تظهر **لايف** على اللوحة. لو التاسكات لسه مش ظاهرة، شغّل `php artisan board:sync` مرة.

**عقد التنفيذ للمساعد:**
0. **اقرا `docs/project/CONTEXT.md` الأول** (الخريطة + اللي اتعمل + الملفات اللي تحاكيها) — اشتغل منه ومن ملفات الخطط؛ **متعملش re-scan للريبو**. حدّث §B فيه بعد الـ DoD.
1. **بوابة الاسبرينت (مرة واحدة):** اعرض «فكّر-الأول» + أي **design pattern** مقترح، واطلب موافقة المطوّر (نعم/لا). لا تطبّق أي pattern قبل الموافقة.
   - بعد الموافقة **وقبل أول خطة**، علّم الاسبرينت **قيد التنفيذ**: `php artisan board:set --sprint=8 --status=in_progress` (وسيب `/kanban` مفتوح قدامك).
2. **نفّذ الخطط واحدة-واحدة بالترتيب — خطة تخلص بالكامل قبل ما تبدأ اللي بعدها.**
   > 🚫 **ممنوع تمامًا:** تبني أكتر من خطة مع بعض، أو تكتب كود كل الخطط الأول وتعلّم حالاتهم دفعة في الآخر. كارت **واحد** بس بيبقى «قيد التنفيذ» في المرة.

   **loop لكل خطة، بالترتيب — مايبدأش الدور اللي بعده غير لما اللي قبله يخلص:**
   - **(أ)** `php artisan board:set --sprint=8 --plan=<plan-path> --status=in_progress` — قبل ما تبدأها.
   - **(ب) ابنِ الخطة دي بالكامل:** **API** → [`../build/build-api.md`](../../build/build-api.md) · **CRUD** → [`../build/build-dashboard-crud.md`](../../build/build-dashboard-crud.md) ثم [`build-tests`](../../build/build-tests.md) **لنفس الخطة**.
   - **(ج)** `php artisan board:set --sprint=8 --plan=<plan-path> --status=done` — بعد ما تعدّي.
   - **(د)** انتقل للخطة اللي بعدها.
3. **بوابة الإنجاز (DoD)** [`verify.md`](../../build/verify.md) §B: `migrate:fresh --seed` · `pint` · `dump-autoload -o` · `schema:check` · `php artisan test` · smoke (ar+en).
4. [`build-postman`](../../build/build-postman-collection.md) — أضف requests من أقسام Postman في ملفات الخطط.
5. **حدّث الوثائق ثم commit:** CONTEXT §B · prepend CHANGELOG · README المتأثر · commit checkpoint.

> اتبع development-workflow + قواعد [`../build/README.md`](../../build/README.md). **لا تتجاوز ما هو مذكور في الخطط.**
## النطاق (ملفات الخطط في هذا الاسبرينت)
- CRUD: `docs/project/cruds/users.md` · `docs/project/cruds/providers.md` · `docs/project/cruds/job-categories.md` · `docs/project/cruds/skills.md` · `docs/project/cruds/job-posts.md` · `docs/project/cruds/job-applications.md` · `docs/project/cruds/interviews.md` · `docs/project/cruds/plans.md` · `docs/project/cruds/subscriptions.md` · `docs/project/cruds/candidate-requests.md`
- home: `docs/project/cruds/dashboard-home.md`
- reports: `docs/project/cruds/reports.md`
- support/notifications APIs (reuse): `docs/project/api/user/support/complaint.md` · `docs/project/api/provider/support/complaint.md` · `docs/project/api/user/notifications/index.md`

## الاعتماديات
- يعتمد على: 5 و يعتمد على: 6 و يعتمد على: 7

## فكّر-الأول (think-first)
- **وسّع** users الموجود؛ ابنِ باقي الكيانات على `AdminBaseController` + `CrudBaseService`.
- سايدبار مجموعات: `hiring` · `billing` · `business` · تقارير.
- كل النصوص ar+en. الإحصائيات من الخدمات لا من Blade.
- Complaints/Pages/Faqs/Settings **موجودة** — لا تُعد بناؤها.

## design pattern (فقط لو يستحق)
- **مش محتاج pattern جديد** — mirror Country/User admin.
## نتيجة الإنجاز (DoD) — تُملأ بعد التنفيذ
```
migrate:fresh --seed:  ⏭  (DB مشتركة ملوّثة — لم نُشغّل fresh)
pint:                  ✅
dump-autoload -o:      ✅
schema:check:          ⏭  (cms فارغ + جداول غريبة pre-existing · hiring ✅)
php artisan test:      ✅  52 Feature/Api+Admin (301)
smoke (ar+en):         ✅  عبر الاختبارات
commit:                53f6225
```