写 6 个核心概念到 prop-acc/concepts/meter/: - meter-vs-meter-reading:物理表配置 + 不可变读数流水双对象;与"账户+流水"模式 对比(主对象有 balance vs 物理硬件配置;直接产 Receipt vs 通过 Bill 中转) - replacement-chain:replaced_meter_id + 自动 -R1 后缀 + 初始读数继承; nextReplacementCode() 算法 + 整链追溯 + ReplaceMeterAction 流程 - multiplier-and-tiered-pricing:倍率(decimal(10,4),工业表 10x/100x)+ 阶梯计价(progressive 累进算法,非 full-tier 简陋实现)+ min/max 封顶 - bill-generation-pipeline:三层分层 Calculator(纯算)→ Service(查费率+找业主+建账) → Action(入口);多调用方共用业务层;prop-acc 后续模块的样板 - reading-source-and-photo-proof:MeterReadingSource 2 种(manual/remote)+ photo_url 拍照存证;业户对账单争议时的凭证依据 - decommission-and-locking:MeterDecommissionReason 5 种 + Reading 双锁机制 (创建即不可改;有 bill_id 更不可改/删);issue.md Q5 第二轮修复历史 新建子模块知识地图: - prop-acc/maps/meter-knowledge-map.md:6 概念入口 + 14 场景预占清单 + 跨子模块对比(meter 与 deposit/prepaid 的核心差异)+ 代码索引 更新导航: - prop-acc/maps/knowledge-map.md:域总图 meter 行链 meter 知识地图,状态 🟡 - prop-acc/index.md:同步 下一轮:14 个场景文档(meter/scenarios/),按本知识地图骨架填充。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
---
|
|
title: prop-acc · 知识地图
|
|
aliases:
|
|
- prop-acc 知识地图
|
|
- 物业财务知识地图
|
|
tags:
|
|
- 规范
|
|
- prop-acc
|
|
- 知识地图
|
|
status: 已发布
|
|
last_review: 2026-05-25
|
|
---
|
|
|
|
# prop-acc · 域知识地图
|
|
|
|
物业财务域的全部子模块入口。每个子模块对应一张深度地图。
|
|
|
|
## 7 子模块
|
|
|
|
| 子模块 | 中文 | 一句话 | 深度地图 | 状态 |
|
|
|---|---|---|---|---|
|
|
| adhoc | 一次性收费 | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](adhoc-knowledge-map.md) | ✅ 25 场景 + 3 概念 |
|
|
| prepaid | 预存款 | 业户预存,自动抵扣月度账单 | [prepaid 知识地图](prepaid-knowledge-map.md) | ✅ 16 场景 + 6 概念 + 1 地图 = 23 篇 |
|
|
| deposit | 保证金 | 装修押金等代管资金,完工后退还 | [deposit 知识地图](deposit-knowledge-map.md) | ✅ 18 场景 + 6 概念 + 1 地图 = 25 篇 |
|
|
| meter | 计量表 | 水表/电表/燃气表,抄表生成账单 | [meter 知识地图](meter-knowledge-map.md) | 🟡 6 概念已完成,14 场景待补 |
|
|
| billing | 账单 | 周期性账单 + 计量账单 | _待补_ | 🚧 |
|
|
| payment-order | 收款订单 | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
|
|
| receipt | 收据 | 成功收款后生成的凭证 | _待补_ | 🚧 |
|
|
|
|
## 跨子模块概念
|
|
|
|
(本域内多个子模块共享的概念,落在 `concepts/` 顶层,不在任何子模块文件夹里)
|
|
|
|
(待添加)
|
|
|
|
## 跨域引用
|
|
|
|
本域引用以下共享概念:
|
|
|
|
- [业户](../../cross/concepts/resident.md)
|
|
- [门卡 / IC 卡](../../cross/concepts/access-card.md)
|
|
- [房屋单元](../../cross/concepts/housing-unit.md)
|
|
|
|
## 相关文档
|
|
|
|
- [prop-acc 域首页](../index.md)
|
|
- [跨域协作地图](../../cross/maps/cross-domain-map.md)
|
|
- [顶层域索引](../../maps/domain-map.md)
|