42c135a5cf
写 16 个场景到 prop-acc/scenarios/billing/,覆盖 5 类业务: 📝 账单创建(3): - create-periodic-property-fee(月度物业费 300 户批量,SkipExisting 默认策略) - create-meter-bill-auto(抄表自动生成计量账单,与 meter pipeline 衔接) - create-single-bill-manual(电梯维修分摊 / 罚款 / 跨期补开 三典型情境) 💰 收款(3): - collect-payment-single(单张收款,Modal + 数据示例 + 部分付场景) - collect-payment-batch(同业户多账单一次收款,1 个 CO + N 个 COBill) - collect-via-prepaid-auto(billing × prepaid 跨模块联动,fund_source=prepaid) ✂️ 账单调整(3): - split-bill(房东/租户分摊场景,SplitBillAction 全转/部分拆模式) - suspend-bill(纠纷/失联 SuspendBillAction,与 Unpaid/Partial 状态守护) - resume-bill(智能恢复 Unpaid / Partial,suspend_history 数组设计) 🗑️ 删除 / 作废(3): - delete-bill-unpaid(物理删 canBeDeleted=Unpaid+无付款,activitylog 留 bill_no) - void-paid-bill(Partial 作废可用 + Paid 作废需手工/tinker 流程的局限) - bulk-delete-batch-mistake(智能批删 Modal 三档分类 + 完整 activitylog 实战) 🛡️ 异常 / 审计(4): - exception-partial-payment(Partial 状态完整生命周期 + 多次补付流水) - exception-overdue-bills(OverdueBillsListWidget + 分级催收 + 滞纳金合规 + 服务限制合规边界) - audit-monthly-billing-vs-collection(收款率核心指标 + SQL 报表 + 与会计科目映射) - audit-activitylog-trace(spatie activitylog 实战查询 + 与 meta JSON 对比 + 跨模块审计 + 法务用途) 每篇结构:典型情境 → 业户/业务/财务/审计视角 → 系统流程(mermaid) → SQL 报表 / 数据示例 → 常见问题 → 异常分支 → 相关文档(WikiLinks)。 billing 独特设计在场景中持续强调: - 6 状态机的状态流转(Unpaid → Partial → Paid;Suspended ↔ Unpaid;Void 终态) - 多对多关联(CollectionOrderBill 中间表 + allocated_amount 语义) - 删 vs 作废双轨制(双层守护 + 业务场景区分) - 智能批删 Modal(预检查三档分类 + 必填原因 + 单条 activitylog 含 affected_bill_nos) - spatie activitylog 审计(properties JSON 跨模块查询) - 跨子模块联动(meter → billing,prepaid → billing,billing → CollectionOrder) 收尾: - prop-acc/maps/billing-knowledge-map.md:16 场景全部 ✅ - prop-acc/maps/knowledge-map.md:billing 行状态改 "✅ 23 篇" - prop-acc/index.md:同步 billing 子模块完整覆盖:6 概念 + 16 场景 + 1 知识地图 = 23 篇。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>