# Sprint 5 — الوظائف والتقديمات

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

## ▶ تنفيذ الاسبرينت (في Cursor)
افتح هذا الملف وقل للمساعد:
```
نفّذ هذا الاسبرينت بالكامل (sprints/5.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=5 --status=in_progress` (وسيب `/kanban` مفتوح قدامك).
2. **نفّذ الخطط واحدة-واحدة بالترتيب — خطة تخلص بالكامل قبل ما تبدأ اللي بعدها.**
   > 🚫 **ممنوع تمامًا:** تبني أكتر من خطة مع بعض، أو تكتب كود كل الخطط الأول وتعلّم حالاتهم دفعة في الآخر. كارت **واحد** بس بيبقى «قيد التنفيذ» في المرة.

   **loop لكل خطة، بالترتيب — مايبدأش الدور اللي بعده غير لما اللي قبله يخلص:**
   - **(أ)** `php artisan board:set --sprint=5 --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=5 --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). **لا تتجاوز ما هو مذكور في الخطط.**
## النطاق (ملفات الخطط في هذا الاسبرينت)
- lookup: `docs/project/api/shared/lookups/job-categories.md`
- user jobs: `docs/project/api/user/jobs/home.md` · `docs/project/api/user/jobs/index.md` · `docs/project/api/user/jobs/show.md` · `docs/project/api/user/jobs/apply.md`
- user applications: `docs/project/api/user/applications/index.md` · `docs/project/api/user/applications/show.md` · `docs/project/api/user/applications/withdraw.md`
- provider jobs: `docs/project/api/provider/jobs/step-1.md` · `docs/project/api/provider/jobs/step-2.md` · `docs/project/api/provider/jobs/step-3.md` · `docs/project/api/provider/jobs/index.md` · `docs/project/api/provider/jobs/show.md` · `docs/project/api/provider/jobs/update.md` · `docs/project/api/provider/jobs/close.md`

## الاعتماديات
- يعتمد على: Sprint 4

## فكّر-الأول (think-first)
- **الكيانات:** JobPost + translations · JobCategory · job_skill · JobApplication (`job_post_id`).
- **فلو النشر 3 خطوات:** draft → تفاصيل مترجمة → نشر (active + published_at). لا تدمج الخطوات في endpoint واحد.
- **تقديم:** 409 لو مكرر أو الوظيفة غير active · withdraw من pending/reviewed فقط.
- **match_percent:** احسبه في الخدمة من مهارات/مدينة/عنوان — صيغة بسيطة وموثّقة في الخطة عند التنفيذ.
- **side effects:** إشعار للشركة عند تقديم جديد (`SendNotificationJob`).
- تطوع/تدريب = `purpose` على نفس الجدول.

## design pattern (فقط لو يستحق)
- **مقترح عند التنفيذ (ينتظر نعم/لا):** خدمة `MatchPercentCalculator` صغيرة داخل `App\Services\Hiring` — ليست Strategy إلا إذا وافق المطوّر. الافتراضي: ميثود في `JobApplicationService`.
## نتيجة الإنجاز (DoD) — تُملأ بعد التنفيذ
```
migrate:fresh --seed:  ⏭ polluted local DB (same as sprint 1)
pint:                  ✅
dump-autoload -o:      ✅
schema:check:          ⏭ hiring unchanged
php artisan test:      ✅  42 Feature/Api (212 assertions)
smoke (ar+en):         ✅ via Feature/Api tests
commit:                b4a9877
```