feat: implement cancellation policy, no-show tracking, and waitlist management

- Add implementation notes for cancellation and waitlist features.
- Create task documentation outlining goals, current status, and acceptance criteria for cancellation policy and resource utilization reporting.
- Establish architecture for domain events and outbox pattern to ensure reliable event publishing.
- Define database schema for domain events and necessary queries for resource utilization and plan accuracy reports.
- Implement detailed implementation notes covering edge cases, testing strategies, and documentation requirements.

docs/new_feture/taskes/task-12-treatment-course/task.md

@@ -0,0 +1,78 @@
+# تسک ۱۲ — دوره درمان
+
+**فاز:** ۳ (کسب‌وکار) · **وابستگی:** ۰۷، ۱۱ · **زمان:** ۱۶-۲۰ ساعت
+
+---
+
+## هدف
+
+مستند بند ۱۳: «لیزر معمولاً شش تا هشت جلسه است. طراحی قبلی فقط نوبت تکی می‌شناخت، در
+حالی که این حالت اصلی کسب‌وکار است.»
+
+## وضعیت فعلی
+
+هیچ مفهومی از دوره وجود ندارد. `PatientSession` وجود دارد ولی «مراجعهٔ انجام‌شده» است،
+نه جلسهٔ برنامه‌ریزی‌شدهٔ یک دوره. تسک ۰۴ ستون `session_count` را به `ServiceItem` اضافه
+کرده ولی هیچ رفتاری به آن وصل نیست.
+
+## دامنه
+
+**هست:**
+- `CourseProtocol` — پروتکل دوره: تعداد جلسه، فاصلهٔ حداقل/ایده‌آل/حداکثر، پارامتر هر جلسه
+- `TreatmentCourse` — دورهٔ یک بیمار
+- `CourseSession` — جلسات دوره (برنامه‌ریزی‌شده یا انجام‌شده)
+- رزرو کل دوره یکجا، یا جلسه‌به‌جلسه
+- پیشنهاد تاریخ جلسهٔ بعدی
+- هشدار عبور از حداکثر فاصله
+- ردیابی پیشرفت («جلسهٔ ۳ از ۸»)
+- ترجیح **همان منبع قبلی** (استراتژی `same_as_previous` تسک ۰۶)
+
+**نیست:** موتور قانون فاصله (تسک ۰۹ — `spacing` از آن استفاده می‌شود)، پکیج (تسک ۱۱ —
+اتصال دارد ولی مستقل است).
+
+## Endpoint ها
+
+| متد | مسیر | توضیح |
+|---|---|---|
+| GET/POST | `/api/v1/course-protocols` | پروتکل دوره per سرویس |
+| GET/PATCH/DELETE | `/api/v1/course-protocol/{uuid}` | |
+| POST | `/api/v1/treatment-course` | شروع دوره برای بیمار |
+| GET | `/api/v1/treatment-course/{uuid}` | جزئیات + جلسات + پیشرفت |
+| GET | `/api/v1/patient/{uuid}/courses` | دوره‌های بیمار |
+| POST | `/api/v1/treatment-course/{uuid}/book-all` | رزرو همهٔ جلسات باقی‌مانده |
+| GET | `/api/v1/treatment-course/{uuid}/next-slot-suggestion` | پیشنهاد تاریخ جلسهٔ بعدی |
+| POST | `/api/v1/treatment-course/{uuid}/abandon` | رهاکردن دوره با دلیل |
+
+## معیار پذیرش
+
+- ✅ موفق: پروتکل «لیزر فول‌بادی: ۸ جلسه، حداقل ۲۱ / ایده‌آل ۲۸ / حداکثر ۴۵ روز،
+  سطح انرژی ۱۲،۱۴،۱۶،۱۸،۲۰،۲۰،۲۲،۲۲» تعریف می‌شود →
+  `POST /treatment-course` هشت `CourseSession` با وضعیت `planned` می‌سازد و پارامتر هر
+  جلسه را از پروتکل کپی می‌کند.
+- ✅ موفق: `POST /book-all` → هشت نوبت با فاصلهٔ ایده‌آل ۲۸ روز رزرو می‌شود؛ هر جلسه به
+  `CourseSession` متناظر لینک می‌شود. اگر روز ایده‌آل ظرفیت نداشت، **نزدیک‌ترین روز داخل
+  بازهٔ حداقل..حداکثر** انتخاب می‌شود.
+- ✅ موفق: بعد از انجام جلسهٔ ۳، `GET /next-slot-suggestion` تاریخ ۲۸ روز بعد از **جلسهٔ ۳**
+  را پیشنهاد می‌دهد (نه از شروع دوره).
+- ✅ موفق: بیمار ۵۰ روز از جلسهٔ قبل گذشته → پاسخ شامل
+  `warning: 'از حداکثر فاصلهٔ مجاز (۴۵ روز) عبور شده است'`.
+- ✅ موفق: جلسهٔ ۲ به بعد، `same_as_previous` اپراتور جلسهٔ ۱ را انتخاب می‌کند اگر آزاد باشد.
+- ✅ موفق: پیشرفت — `GET /treatment-course/{uuid}` می‌دهد
+  `{ completed: 3, total: 8, next_session_number: 4, next_params: { energy: 18 } }`.
+- ❌ خطا: `book-all` وقتی برای یکی از جلسات هیچ وقتی نیست → **هیچ‌کدام رزرو نمی‌شود**،
+  `422` با شمارهٔ جلسهٔ مشکل‌دار. رزرو نیمه‌کاره ممنوع.
+- ❌ خطا: شروع دوره برای سرویسی که پروتکل ندارد → `422`.
+- ⚠️ مرزی: بیمار دورهٔ فعال دیگری برای همان سرویس دارد → `422` با لینک به دورهٔ موجود.
+- ⚠️ مرزی: لغو یک جلسهٔ وسط دوره → آن `CourseSession` به `planned` برمی‌گردد، بقیه
+  دست‌نخورده؛ پیشنهاد بعدی مبنایش آخرین جلسهٔ **انجام‌شده** است.
+- ⚠️ مرزی: دورهٔ متصل به پکیج (تسک ۱۱) → هر جلسه یک واحد اعتبار مصرف می‌کند.
+- ⚠️ مرزی: تعداد جلسات پروتکل تغییر کرد → دوره‌های فعال دست‌نخورده (snapshot).
+- ⚠️ مرزی: `book-all` بیشتر از بازهٔ ۹۰ روزهٔ مجاز (۸ جلسه × ۲۸ روز = ۲۲۴ روز) →
+  فقط جلساتی که در ۹۰ روز جا می‌شوند رزرو شوند، بقیه `planned` بمانند + پیام روشن.
+
+## خروجی
+
+- `src/Course/`
+- `assets/admin/pages/CourseProtocolsPage.tsx` + `TreatmentCoursePage.tsx`
+- کارت «دوره‌های درمان» در `PatientDetailPage.tsx`
+- `docs/api/course.md`