meter 子模块 · 轮 2:14 场景 + 知识地图收尾
写 14 个场景到 prop-acc/scenarios/meter/,覆盖 4 类业务: 📦 表管理(4): - init-new-community-batch(新社区批量建表 + 初始读数 Excel 导入, 走 MeterInitializationImporter + BaseImporter chunk rollback) - register-single-meter(单独新增一张表,陈先生厨房分户表) - replace-broken-meter(换表场景,旧表 5000 → 新表 -R1 后缀 + initial 5000 继承, ReplaceMeterAction 完整流程) - decommission-without-replacement(退役不换表,3 种典型情境: 房屋拆除 / 商铺撤店 / 法定年限到) 📊 抄表(4): - read-single-meter-manual(后台单录,李师傅集抄掉线补抄) - read-batch-via-excel-import(MeterReadingsImporter + 模板下载流程 + 双义列名 silent corruption 已知风险) - read-via-iot-remote-source(集抄系统对接,API + 防重放 + 与 deposit/prepaid 集成) - read-with-photo-proof(物理表头照片,业户争议时关键凭证) 💰 账单生成(3): - generate-bill-tiered-pricing(progressive 累进算法完整算例 35 吨水的三段计算, 对比 full-tier 简陋实现) - generate-bill-with-multiplier(工业表 multiplier=10 算例 + 抄表员录入注意事项) - generate-bill-min-max-cap(漏水 max 封顶 + 零用量 min 兜底 + 正常范围三情境) 🛡️ 异常/审计(3): - exception-high-consumption(HighConsumptionReadingsListWidget 预警 + 分级处置 + 完整排查流程) - exception-readings-locked-after-bill(双锁机制下的修正流程,当前手工 + 未来 VoidBillAction 设计目标态,issue.md Q5 待补) - audit-meters-needing-reading(MetersNeedingReadingListWidget + 月度完成率 99% 目标 + 月度报告模板) 每篇结构:典型情境 → 业户/抄表员/业务人员视角 → 系统流程(mermaid)→ 对比表 / 算例 → 常见问题 → 异常分支 → 相关文档(WikiLinks)。 meter 模块特性在场景中持续强调: - 物理硬件维度(非抽象账户) - 不直接产 Receipt(走 Bill 中转) - 三层业务分层(Calculator + Service + Action) - 双锁机制(创建即不可改 + 有 Bill 更严) - 抄表来源 + 拍照存证 + 集抄对接 - progressive 累进 vs full-tier 简陋实现的设计正确性 - 倍率 + 阶梯 + min/max 三层叠加算法 收尾: - prop-acc/maps/meter-knowledge-map.md:14 场景全部 ✅,加完成 callout - prop-acc/maps/knowledge-map.md:meter 行状态改 "✅ 21 篇" - prop-acc/index.md:同步 meter 子模块完整覆盖:6 概念 + 14 场景 + 1 知识地图 = 21 篇。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -22,7 +22,7 @@ last_review: 2026-05-25
|
||||
| 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 场景待补 |
|
||||
| meter | 计量表 | 水表/电表/燃气表,抄表生成账单 | [meter 知识地图](meter-knowledge-map.md) | ✅ 14 场景 + 6 概念 + 1 地图 = 21 篇 |
|
||||
| billing | 账单 | 周期性账单 + 计量账单 | _待补_ | 🚧 |
|
||||
| payment-order | 收款订单 | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
|
||||
| receipt | 收据 | 成功收款后生成的凭证 | _待补_ | 🚧 |
|
||||
|
||||
@@ -60,35 +60,33 @@ code_version: 2026-05-22
|
||||
| [抄表来源与拍照存证](../concepts/meter/reading-source-and-photo-proof.md) | `manual` 手抄 vs `remote` 集抄 + `photo_url` 凭证,业户争议时的证据 |
|
||||
| [表退役与读数锁定](../concepts/meter/decommission-and-locking.md) | 5 种退役原因 + Reading 双锁机制(创建即不可改,有 Bill 更不可改) |
|
||||
|
||||
## 场景手册(14 篇,**待补充 ✋**)
|
||||
|
||||
> 🚧 概念骨架已就位,场景文档将在下一轮(轮 2)产出。预定结构如下。
|
||||
## 场景手册(14 篇,**全部完成 ✅**)
|
||||
|
||||
### 📦 表管理(4 篇)
|
||||
|
||||
- 🚧 [新社区批量建表 + 初始读数 Excel 导入](../scenarios/meter/init-new-community-batch.md)
|
||||
- 🚧 [单独新增一张表(后台单录)](../scenarios/meter/register-single-meter.md)
|
||||
- 🚧 [换表:旧表故障/退役,新表带 -R1 后缀,初始读数继承](../scenarios/meter/replace-broken-meter.md)
|
||||
- 🚧 [退役不换表(房屋拆除 / 业户永久弃用)](../scenarios/meter/decommission-without-replacement.md)
|
||||
- ✅ [新社区批量建表 + 初始读数 Excel 导入](../scenarios/meter/init-new-community-batch.md)
|
||||
- ✅ [单独新增一张表(后台单录)](../scenarios/meter/register-single-meter.md)
|
||||
- ✅ [换表:旧表故障/退役,新表带 -R1 后缀,初始读数继承](../scenarios/meter/replace-broken-meter.md)
|
||||
- ✅ [退役不换表(房屋拆除 / 业户永久弃用)](../scenarios/meter/decommission-without-replacement.md)
|
||||
|
||||
### 📊 抄表(4 篇)
|
||||
|
||||
- 🚧 [单张表后台手动录入](../scenarios/meter/read-single-meter-manual.md)
|
||||
- 🚧 [一次导入整月所有读数(Excel 批量)](../scenarios/meter/read-batch-via-excel-import.md)
|
||||
- 🚧 [集抄系统自动推送(`source=remote`)](../scenarios/meter/read-via-iot-remote-source.md)
|
||||
- 🚧 [抄表拍照存证(物理表头照片)](../scenarios/meter/read-with-photo-proof.md)
|
||||
- ✅ [单张表后台手动录入](../scenarios/meter/read-single-meter-manual.md)
|
||||
- ✅ [一次导入整月所有读数(Excel 批量)](../scenarios/meter/read-batch-via-excel-import.md)
|
||||
- ✅ [集抄系统自动推送(`source=remote`)](../scenarios/meter/read-via-iot-remote-source.md)
|
||||
- ✅ [抄表拍照存证(物理表头照片)](../scenarios/meter/read-with-photo-proof.md)
|
||||
|
||||
### 💰 账单生成(3 篇)
|
||||
|
||||
- 🚧 [阶梯水电价生成账单(progressive 累进算例)](../scenarios/meter/generate-bill-tiered-pricing.md)
|
||||
- 🚧 [工业表 10x 倍率生成账单](../scenarios/meter/generate-bill-with-multiplier.md)
|
||||
- 🚧 [单笔账单上下限封顶(防异常用量爆账)](../scenarios/meter/generate-bill-min-max-cap.md)
|
||||
- ✅ [阶梯水电价生成账单(progressive 累进算例)](../scenarios/meter/generate-bill-tiered-pricing.md)
|
||||
- ✅ [工业表 10x 倍率生成账单](../scenarios/meter/generate-bill-with-multiplier.md)
|
||||
- ✅ [单笔账单上下限封顶(防异常用量爆账)](../scenarios/meter/generate-bill-min-max-cap.md)
|
||||
|
||||
### 🛡️ 异常 / 审计(3 篇)
|
||||
|
||||
- 🚧 [高用量异常(漏水 / 电器故障),`HighConsumptionReadingsListWidget` 预警](../scenarios/meter/exception-high-consumption.md)
|
||||
- 🚧 [已生成 Bill 的 Reading 锁定,要修正需作废 Bill](../scenarios/meter/exception-readings-locked-after-bill.md)
|
||||
- 🚧 [待抄表清单 + 月度抄表完成率(`MetersNeedingReadingListWidget`)](../scenarios/meter/audit-meters-needing-reading.md)
|
||||
- ✅ [高用量异常(漏水 / 电器故障),`HighConsumptionReadingsListWidget` 预警](../scenarios/meter/exception-high-consumption.md)
|
||||
- ✅ [已生成 Bill 的 Reading 锁定,要修正需作废 Bill](../scenarios/meter/exception-readings-locked-after-bill.md)
|
||||
- ✅ [待抄表清单 + 月度抄表完成率(`MetersNeedingReadingListWidget`)](../scenarios/meter/audit-meters-needing-reading.md)
|
||||
|
||||
## 跨域引用
|
||||
|
||||
@@ -129,6 +127,9 @@ code_version: 2026-05-22
|
||||
|
||||
---
|
||||
|
||||
> [!info] 概念已完成,场景待补
|
||||
> 本轮(轮 1)产出:6 个概念 + 本子模块地图 + 域总图更新。
|
||||
> 下一轮(轮 2)产出:14 个场景文档,基于本知识地图骨架填充。
|
||||
> [!success] meter 子模块:6 概念 + 14 场景 + 1 知识地图 = **21 篇完成**
|
||||
>
|
||||
> 写作日期:2026-05-26
|
||||
> 对应代码版本:2026-05-22(详见 `packages/prop-acc/issue.md` Q5 段)
|
||||
>
|
||||
> 如果发现遗漏的场景或需要补充的细节,告诉我,可以单独补充新文档。
|
||||
|
||||
Reference in New Issue
Block a user