Files

Willie 92f3c6698e 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>

2026-05-26 00:31:08 +08:00

7.2 KiB

Raw Blame History

title, aliases, tags, sub_feature, audience, status, last_review, code_version

title

aliases

计量表(meter)知识地图

本子模块 = Meter(物理表配置)+ MeterReading(不可变抄表流水)。覆盖物业计量收费(水电气)的全生命周期 —— 建表、抄表、生成账单、表更换、表退役、异常处理。

这是什么?

物业管理水表 / 电表 / 燃气表的计量计费基础设施。从"业户家里有一张物理表"到"每月物业费账单里有一行水电费",中间走的就是本模块。

[!info] meter 是 prop-acc 里最成熟的子模块 issue.md Q5 评估:数据模型对齐市场标准 ~90%,业务分层清楚(Calculator → Service → Action),完整的换表链、倍率支持、阶梯计价、min/max 封顶、抄表来源跟踪、拍照存证、初始化批量导入。后续 deposit / prepaid / adhoc 模块的分层方法是从 meter 学的。

与其他子模块的关系

关系	说明
下游产 Bill,不直接产 Receipt	抄表 → 生成 Bill → 业户付账单时走 adhoc 的 CollectionOrder + Receipt 体系
业户付账单的资金可来自预存款	走 prepaid 的 consume 模式 —— Bill.amount 自动从预存款余额扣
本模块不涉及押金	计量表是日常计费工具,无押金概念

核心特性(与其他模块对比)

维度	meter	deposit / prepaid
主对象类型	物理硬件(表)	抽象账户
主对象有 balance	❌	✅
流水方向	单向(只录读数,无 +/-)	双向(deposit / refund / forfeit / consume)
直接产 Receipt	❌(走 Bill 中转)	✅
表更换 / 退役机制	✅(`replaced_meter_id` 链 + 5 种退役原因)	N/A
来源标记(manual/remote)	✅	❌
拍照存证	✅	❌

核心概念(6 篇)

文档	一句话
计量表与抄表流水	双对象(物理表配置 + 不可变读数流水),与"账户+流水"模式的差异
表更换链	`replaced_meter_id` + 自动 `-R1` 后缀 + 初始读数继承,保证用量计算连续
倍率与阶梯计价	倍率(工业表 10x/100x) + 阶梯计价(progressive 累进) + min/max 封顶
账单生成的三层分层	Calculator(纯算)→ Service(查费率 + 找业主)→ Action(入口),prop-acc 的样板
抄表来源与拍照存证	`manual` 手抄 vs `remote` 集抄 + `photo_url` 凭证,业户争议时的证据
表退役与读数锁定	5 种退役原因 + Reading 双锁机制(创建即不可改,有 Bill 更不可改)

场景手册(14 篇,全部完成 ✅)

📦 表管理(4 篇)

📊 抄表(4 篇)

💰 账单生成(3 篇)

🛡️ 异常 / 审计(3 篇)

跨域引用

本子模块引用以下跨域共享概念:

业户 — 账单关联业户
房屋单元 — asset_id,表绑定房屋
组织结构 — community_id,物业项目归属

跨子模块引用

adhoc · CollectionOrder 与 Receipt — 计量账单付款时走的凭证体系
prepaid · Consume 走 CollectionType=Bill 的设计 — 计量账单可由预存款抵扣
deposit · 账户与流水 — 账户+流水模式对比

7.2 KiB Raw Blame History