refinement phase 3

dev/contracts/domains/booking-requests.md

@@ -146,3 +146,21 @@
 
 ## Changelog
 - b8 — initial contract (create/accept/reject/cancel + role-scoped list + single get + admin expire).
+
+---
+
+## Refinement phase 3 additions (REQ-013/014/016/017)
+
+- **`BookingRequestDto`** gains `variantPrice` (IRR digit-string — the chosen variant's *display rate*, not
+  an engagement total; the request stays money-free), `nurseAvatarUrl` (nullable), and `bookingId`
+  (nullable — the booking created once the request is `converted`, for the confirmation deep-link).
+- **`BookingRequestListItemDto`** gains `variantLabel` (self-describing inbox row) and `patientAge`
+  (nullable coarse triage age).
+- **`GET api/v1/booking_requests/checkout_summary/{id}`** (owner-scoped) — the C6 money breakdown:
+  `{ bookingRequestId, requestStatus, nurseName, patientName, variantLabel, variantPriceUnit, sessionCount,
+  requestedDate, requestedTimeStart, requestedTimeEnd, paymentDeadlineAt, serviceCostIrr, commissionIrr,
+  vatIrr, vatRate, totalIrr, grossPriceIrr, balinyaarCommissionIrr, nursePayoutAmount }`. All IRR
+  digit-strings, computed server-side. **Canonical rates:** `platform_fee_rate = 0.15`, `vat_rate = 0.10`.
+  VAT is **carved out of the commission** so `serviceCostIrr + commissionIrr + vatIrr = totalIrr = gross`
+  (the captured amount); `commissionIrr` is the commission **net of VAT**, and the raw b10 amounts
+  (`grossPriceIrr = balinyaarCommissionIrr + nursePayoutAmount`) are surfaced alongside.