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.
2026-07-30 11:43:58 +03:30
parent 1d338503c8
commit 021d0eb6b2
62 changed files with 8098 additions and 0 deletions
@@ -0,0 +1,71 @@
+# دیتابیس — تسک ۱۰
+
+## `policy_simulation_runs`
+
+تنها جدول جدید این تسک — و تنها چیزی که شبیه‌سازی می‌نویسد.
+
+| ستون | نوع | توضیح |
+|---|---|---|
+| `id` | INT PK AI | |
+| `uuid` | VARCHAR(36) UNIQUE | |
+| `entity_type` / `entity_id` | VARCHAR(10) / INT NOT NULL | |
+| `policy_id` | INT NOT NULL | FK → `policies.id` ON DELETE CASCADE |
+| `policy_version` | SMALLINT NOT NULL | نسخهٔ آزمایش‌شده |
+| `sample_size` | SMALLINT NOT NULL | تعداد نوبت نمونه |
+| `affected_count` | SMALLINT NOT NULL | تعداد تحت تأثیر |
+| `severity` | VARCHAR(10) NOT NULL | `none`\|`low`\|`medium`\|`high` |
+| `report` | JSON NOT NULL | ردیف‌های تفصیلی (حداکثر ۵۰) |
+| `run_by` | INT NULL | FK → `users.id` ON DELETE SET NULL |
+| `created_at` | INT NOT NULL | |
+
+```sql
+KEY idx_psr_policy (policy_id, policy_version, created_at)
+KEY idx_psr_tenant (entity_type, entity_id, created_at)
+```
+
+`report` سقف حجم دارد: ۵۰ ردیف × چند فیلد ≈ چند کیلوبایت. بیشتر ذخیره نکن — گزارش
+تفصیلی‌تر با اجرای دوباره به دست می‌آید.
+
+## هیچ تغییری در جدول‌های دیگر
+
+`policies.active` از قبل هست. شرط آزمایش در سطح سرویس اعمال می‌شود، نه schema.
+
+## نمونه‌گیری — `SimulationSampler`
+
+```sql
+-- نوبت‌های واقعی، مرتبط با دامنهٔ قانون، جدیدترین اول
+SELECT a.* FROM appointments a
+WHERE a.entity_type = :type AND a.entity_id = :id
+  AND a.status IN ('confirmed','completed')
+  AND (:branchId IS NULL OR a.branch_id = :branchId)
+  AND (:serviceId IS NULL OR a.service_item_id = :serviceId)
+ORDER BY a.slot_start DESC
+LIMIT 50
+```
+
+فیلتر `service_item_id` از خودِ شرط قانون استخراج می‌شود (اگر قانون سرویس مشخصی را
+هدف گرفته). بدون آن، شبیه‌سازی قانون لیزر روی ۵۰ نوبت دندانپزشکی اجرا می‌شود و
+«۰٪ تحت تأثیر» می‌دهد — که گمراه‌کننده است.
+
+## Migration
+
+```bash
+ddev exec php bin/console doctrine:migrations:diff --no-interaction
+ddev exec php bin/console doctrine:migrations:migrate --no-interaction
+```
+
+## پاکسازی
+
+اجراهای آزمایشی قدیمی ارزشی ندارند:
+
+```bash
+ddev exec php bin/console app:policy:prune-simulations --older-than=30d --force
+```
+
+آخرین اجرا per (policy, version) **هرگز** حذف نمی‌شود — چون شرط `activate` به آن وابسته است.
+
+## طبقه‌بندی tenant
+
+| جدول | وضعیت |
+|---|---|
+| `policy_simulation_runs` | جفت tenant |