hamedandClaude Opus 5
4bca659939
Task 08's pricing chain was reachable only through the API, so a clinic could not define a price list or see what a booked appointment was actually charged. Price lists - Draft / active / expired are shown as three states because they mean three different things operationally: a draft has no effect on today's price at all - Activation is a separate action rather than a checkbox in the form, matching the backend rule that creating a list must not change anything - "Copy" seeds a new list from an existing one starting the day the old one ends, since most lists are last quarter's with a few numbers moved - "All branches" is an explicit option, not an empty field Invoice card - Renders the recorded chain down to the final amount, hiding zero rows so the card stays readable - A missing invoice renders as a normal state, not an error: an appointment that was never confirmed has no invoice - Says outright that the numbers are from the appointment's own date and later tariff changes do not move them — otherwise someone who edited a price yesterday reads today's older number as a bug Also corrects task 08's checklist: its test section carried a copy-pasted "no UI was built" note against rows whose tests have existed since the task shipped. Replaced with the real test names and the two that genuinely are not covered. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
8.0 KiB
8.0 KiB
چکلیست — تسک ۰۸ (لیست قیمت بازهدار و snapshot فاکتور)
وضعیت کلی: ✅ تمامشده — بکاند، مستندات و UI · آخرین بازبینی: —
قواعد: _shared/definition-of-done.md · red-lines.md · ui-conventions.md
۰. خط سرخ
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۰.۱ | --group=slot-mode-frozen سبز |
✅ | |
| ۰.۲ | Tariff دستنخورده — سطر ۴ زنجیرهٔ PriceResolver |
✅ | |
| ۰.۳ | AppointmentInsuranceService و TenantServiceCoverage بازنویسی نشدند |
✅ | قاعدهٔ «اول بگرد» |
| ۰.۴ | DiscountRule/DiscountEngine دستنخورده |
✅ | |
| ۰.۵ | Invoice/InvoiceItem دستنخورده و حذف نشدند |
✅ | کار متفاوتی میکنند |
| ۰.۶ | ستونهای موجود نوبت استفاده شدند، ستون جدید مالی روی appointments اضافه نشد |
✅ |
۱. بکاند
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۱.۱ | PriceList · PriceListItem · PriceSnapshot · PriceSnapshotLine · DepositPolicy |
✅ | |
| ۱.۲ | PricingEngine — هفت مرحله، هر کدام سرویس مستقل |
✅ | |
| ۱.۳ | مراحل ۳ و ۴ از روز اول در زنجیره، حتی no-op | ✅ | تسک ۰۹ و ۱۱ |
| ۱.۴ | PriceResolver — ترتیب پنجگانه، هرگز صفر یا خطا |
✅ | |
| ۱.۵ | تاریخ مبنا = slot_start (تاریخ رزرو)، نه time() |
✅ | ⭐ دو تفسیر دارد |
| ۱.۶ | همهٔ محاسبات با intdiv، هیچ float در مسیر پول |
✅ | |
| ۱.۷ | تخفیف پشتسرهم، نه جمع درصدها | ✅ | ۴۰ سپس ۱۰ = ۴۶ |
| ۱.۸ | سقف جمع تخفیف اعمال شد | ✅ | |
| ۱.۹ | final = max(0, …) + ردیف adjustment هنگام فعال شدن سقف |
✅ | |
| ۱.۱۰ | appliedPolicyIds از روز اول ثبت میشود |
✅ | |
| ۱.۱۱ | PriceSnapshotLine.label و source_id بدون FK (کپی متنی) |
✅ | قانون پنجم |
| ۱.۱۲ | DepositCalculator روی ستونهای موجود نوبت مینویسد |
✅ | |
| ۱.۱۳ | activate تداخل بازه را میسنجد؛ لیست شعبه با محیط تداخل ندارد |
✅ | |
| ۱.۱۴ | هفت endpoint | ✅ | |
| ۱.۱۵ | قلاب مرحلهٔ ۶ BookingService::confirm وصل شد |
✅ | |
| ۱.۱۶ | TenantOwnershipChecker روی هر uuid از request |
✅ |
۲. دیتابیس
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۲.۱ | پنج جدول | ✅ | |
| ۲.۲ | final_rials و amount_rials از نوع BIGINT |
✅ | ⭐ پکیج بزرگ از سقف INT عبور میکند |
| ۲.۳ | بقیهٔ price_rials ها INT ماندند |
✅ | قیمت واحد عبور نمیکند |
| ۲.۴ | UNIQUE(appointment_id) روی snapshot |
✅ | |
| ۲.۵ | price_list_items و price_snapshot_lines در AGGREGATE_CHILDREN |
✅ | |
| ۲.۶ | app:pricing:backfill-snapshots --force — idempotent |
✅ | نوبتهای موجود فاکتور خالی نداشته باشند |
| ۲.۷ | TenantSchemaCoverageTest سبز |
✅ |
۳. UI
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۳.۱ | PriceListsPage |
✅ | لیست + مودال ویرایش با ردیفهای قیمت |
| ۳.۲ | وضعیت شمسی: پیشنویس/فعال/منقضی | ✅ | سه حالت با معنای عملیاتی متفاوت؛ فعالسازی عمل جداست، نه تیک داخل فرم |
| ۳.۳ | بازهٔ تاریخ با PersianDateInput |
✅ | تبدیل ISO↔Unix در همان صفحه |
| ۳.۴ | قیمتها با PriceInput |
✅ | |
| ۳.۵ | شعبه با SearchableSelect |
✅ | «همهٔ شعبهها» گزینهٔ صریح است، نه خالیگذاشتن |
| ۳.۶ | «کپی از لیست قیمت قبلی» | ✅ | ⭐ بازه از پایان لیست قبلی شروع میشود |
| ۳.۷ | کارت فاکتور در AppointmentDetailPage |
✅ | AppointmentInvoiceCard — ردیفهای صفر پنهان میشوند |
| ۳.۸ | متن «قیمت بر اساس تاریخ نوبت محاسبه شده» | ✅ | ⭐ وگرنه کاربری که دیروز تعرفه را عوض کرده فکر میکند سیستم خراب است |
| ۳.۹ | هیچ رنگ/شعاع hard-code | ✅ | |
| ۳.۱۰ | دارکمود و حالت فشرده | ⚠️ | فقط توکنها؛ بازبینی چشمی انجام نشد |
| ۳.۱۱ | RTL و موبایل | ✅ | جدول لیستها اسکرول افقی داخلی دارد |
| ۳.۱۲ | مبالغ با formatRial · تاریخ با formatDate |
✅ | |
| ۳.۱۳ | وضعیت لیست در URL | ✅ | useUrlState |
| ۳.۱۴ | همهٔ رشتهها فارسی | ✅ | |
| ۳.۱۵ | تست فرانت کارت فاکتور | ✅ | چهار تست، شامل «نبودِ فاکتور خطا نیست» |
۴. تست
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۴.۱ | ترتیب لایههای قیمت + fallback | ✅ | testFullChainAppliesInOrder · testFallsBackToTheServicePrice · testBranchOverrideBeatsThePriceList |
| ۴.۲ | تخفیف پشتسرهم، سقف، منفی → صفر | ✅ | testDiscountLargerThanTheAmountFloorsAtZero · testTotalDiscountCapIsApplied |
| ۴.۳ | invariant جمع ردیفها = مبلغ نهایی | ⚠️ | زنجیره در testFullChainAppliesInOrder عددبهعدد سنجیده میشود؛ invariant بهصورت property-based روی سناریوهای تصادفی نوشته نشد |
| ۴.۴ | تغییرناپذیری فاکتور (قانون پنجم) | ✅ | ⭐ testBookedAppointmentKeepsItsOriginalInvoiceAfterAPriceChange |
| ۴.۵ | فعالسازی و تداخل بازه | ✅ | testOverlappingActiveListsAreRejected · testBranchListWinsOverTheGeneralList · testDraftListHasNoEffectUntilActivated |
| ۴.۶ | محاسبهٔ بیعانه | ⚠️ | درصدی و مبلغی هر دو در PricingEngine هست و در زنجیرهٔ کامل تست میشود؛ تست اختصاصی با min/max ندارد |
| ۴.۷ | سرویس محیط دیگر ۴۰۴ | ✅ | testForeignServiceIsNotFound |
| ۴.۸ | نوبت بدون سرویس → فاکتور با visit_price_rials |
⚠️ | مسیرش هست (recordFlatVisit)؛ تست اختصاصی ندارد |
| ۴.۹ | قیمت منفی رد میشود | ✅ | testNegativePriceIsRejected |
| ۴.۱۰ | تست فرانت کارت فاکتور | ✅ | چهار تست |
اجرا: ddev exec php bin/phpunit tests/Pricing → ۱۲ تست.
۵. مستندات
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۵.۱ | docs/api/pricing.md |
✅ | |
| ۵.۲ | تصمیم «تاریخ رزرو، نه تاریخ ثبت» صریح | ✅ | |
| ۵.۳ | docs/architecture/insurance-billing-system.md جدول PriceSnapshot vs Invoice |
✅ | ⭐ وگرنه یکی حذف میشود |
۶. بازبینی پایانی
| # | مورد | وضعیت | یادداشت |
|---|---|---|---|
| ۶.۱ | هیچ 🔄 و ⏳ بیدلیل نمانده | ✅ | |
| ۶.۲ | bin/phpunit کامل سبز |
✅ | |
| ۶.۳ | --group=slot-mode-frozen سبز |
✅ | |
| ۶.۴ | phpstan بدون خطای جدید |
✅ | |
| ۶.۵ | npx tsc --noEmit و yarn test سبز |
✅ | |
| ۶.۶ | تستهای tenant سبز | ✅ | |
| ۶.۷ | docs/api/* بهروز |
✅ | |
| ۶.۸ | چکلیست UI کامل | ✅ | |
| ۶.۹ | ⚠️ مبلغ نمایشی رزرو ممکن است عوض شود → دو کلاینت دستی بررسی شدند | ✅ | |
| ۶.۱۰ | commit، سپس graphify update . |
✅ | |
| ۶.۱۱ | موارد بهتعویق با دلیل و تسک مقصد | ✅ |