prepaid 子模块 · 轮 1:6 概念 + 知识地图 + 导航更新

写 6 个核心概念到 prop-acc/concepts/prepaid/:
- prepaid-account-vs-transaction:账户+流水双对象,与 deposit 同构但多两条独有约束(一户一账、零余额不自动关账)
- account-state-machine:Active / Frozen / Closed,canOperate 统一守护,与 deposit 差异(零余额行为、无 ForceClose)
- one-account-per-resident:unique(community_id, profile_id) + 跨社区防御(prepaid 独有)
- transaction-types:4 种流水(deposit / consume / refund / adjustment),consume 是最高频
- consume-via-bill-collection-type:Consume 走 CollectionType=Bill 而非 Prepaid 的独特设计,资金来源标 meta.fund_source
- auto-deduction-design:月初批量自动抵扣 scheduled job 的设计意图(代码待补,issue.md Q4 已记录)

新建子模块知识地图:
- prop-acc/maps/prepaid-knowledge-map.md:6 概念入口 + 16 场景预占清单 + 跨域引用 + 代码索引

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

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Willie
2026-05-25 23:04:35 +08:00
parent b3a8c502e7
commit c9b92c6c1b
3 changed files with 132 additions and 2 deletions

View File

@@ -25,7 +25,7 @@ last_review: 2026-05-25
| --------- | ---------------- | --------------------------------------------- | ------ |
| **一次性收费** | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](maps/adhoc-knowledge-map.md) | ✅ 28 篇 |
| **保证金** | 装修押金等代管资金,完工后退还 | [deposit 知识地图](maps/deposit-knowledge-map.md) | ✅ 25 篇 |
| **预存款** | 业户预存,自动抵扣月度账单 | _待补_ | 🚧 |
| **预存款** | 业户预存,自动抵扣月度账单 | [prepaid 知识地图](maps/prepaid-knowledge-map.md) | 🟡 6 概念已完成,16 场景待补 |
| **计量表** | 水表/电表/燃气表,抄表生成账单 | _待补_ | 🚧 |
| **账单** | 周期性账单 + 计量账单 | _待补_ | 🚧 |
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |