Files

Willie 085de29cc8 billing 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新

写 6 个核心概念到 prop-acc/concepts/billing/:
- bill-six-state-machine:6 状态(Unpaid/Partial/Paid/Suspended/Processing/Void),
  prop-acc 最复杂状态机;canBePaid/canBeDeleted/canBeVoided 守护方法详解
- bill-types-and-sources:周期/计量/临时 三类账单 + sourceable polymorphism
  (MeterReading / 周期任务 / null 三种 source 类型)
- bill-vs-collection-order:Bill(应收)vs CollectionOrder(已收),
  CollectionOrderBill 多对多关联 + allocated_amount 字段语义;
  与 adhoc 的 1:1 关系对比
- periodic-bill-generation:GeneratePeriodicBillsAction 完整流程 +
  BillingMergeStrategy 三种策略(SkipExisting / Merge / Replace)
- delete-vs-void-dual-track:双轨制设计哲学,物理删(Unpaid 无付款)vs
  作废(留状态留审计);issue.md Q6 第一轮修复历史
- smart-bulk-delete-design:智能批量删除 Modal 设计(预检查三档分类 +
  必填原因 + 单条 activitylog 含 affected_bill_nos 数组);
  bill.bulkDelete 独立高敏权限

新建子模块知识地图:
- prop-acc/maps/billing-knowledge-map.md:6 概念入口 + 16 场景预占 +
  跨子模块对比(billing 与 deposit/prepaid/meter 的 6 维度差异)+ 代码索引

更新导航:
- prop-acc/maps/knowledge-map.md:域总图 billing 行链 billing 知识地图,状态 🟡
- prop-acc/index.md:同步

billing 是 prop-acc 的"收款中枢" -- 上游对接 meter/周期任务/手工,
下游对接 CollectionOrder/Receipt,侧链对接 prepaid 抵扣。

下一轮:16 个场景文档(billing/scenarios/),按本知识地图骨架填充。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-26 00:48:58 +08:00

2.5 KiB

Raw Blame History

title, aliases, tags, audience, status, last_review

title

aliases

物业财务(prop-acc)

物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。

七大子模块进度

子模块	一句话	深度地图	状态
一次性收费	IC 卡、装修证、泳票等单次购买	adhoc 知识地图	✅ 28 篇
保证金	装修押金等代管资金,完工后退还	deposit 知识地图	✅ 25 篇
预存款	业户预存,自动抵扣月度账单	prepaid 知识地图	✅ 23 篇
计量表	水表/电表/燃气表,抄表生成账单	meter 知识地图	✅ 21 篇
账单	周期性账单 + 计量账单	billing 知识地图	🟡 6 概念已完成,16 场景待补
收款订单	一次收款的支付方式、银行账户记录	待补	🚧
收据	成功收款后生成的凭证	待补	🚧

域内总图

!knowledge-map

查看完整域知识地图(Gitea / GitHub 可点)

你是谁?

[!tip] 业户(物业的客户) 关心"我怎么买/缴/取/退",看 flow-a-vs-flow-b 最直观。

[!tip] 业务人员(物业职员、财务) 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。

文档约定

业户口语:称"您",场景里描述真实生活情境
mermaid 流程图:每个场景配一张,直观看完整链路
WikiLinks:[[XX]] 是 vault 内部跳转(仅 Obsidian / Quartz 渲染);Gitea / GitHub 看导航请走表格里的 Markdown 链接
callouts:tip / warning / example 标注重点

2.5 KiB Raw Blame History

物业财务(prop-acc)

七大子模块进度

域内总图

你是谁?

文档约定

相关文档

2.5 KiB

Raw Blame History