92f3c6698e
写 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>
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
---
|
|
title: prop-acc · 物业财务(域首页)
|
|
aliases:
|
|
- prop-acc
|
|
- 物业财务
|
|
- 财务模块
|
|
- 财务模块总览
|
|
tags:
|
|
- 域首页
|
|
- prop-acc
|
|
audience:
|
|
- 业户
|
|
- 业务人员
|
|
status: 已发布
|
|
last_review: 2026-05-25
|
|
---
|
|
|
|
# 物业财务(prop-acc)
|
|
|
|
物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。
|
|
|
|
## 七大子模块进度
|
|
|
|
| 子模块 | 一句话 | 深度地图 | 状态 |
|
|
| --------- | ---------------- | --------------------------------------------- | ------ |
|
|
| **一次性收费** | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](maps/adhoc-knowledge-map.md) | ✅ 28 篇 |
|
|
| **保证金** | 装修押金等代管资金,完工后退还 | [deposit 知识地图](maps/deposit-knowledge-map.md) | ✅ 25 篇 |
|
|
| **预存款** | 业户预存,自动抵扣月度账单 | [prepaid 知识地图](maps/prepaid-knowledge-map.md) | ✅ 23 篇 |
|
|
| **计量表** | 水表/电表/燃气表,抄表生成账单 | [meter 知识地图](maps/meter-knowledge-map.md) | ✅ 21 篇 |
|
|
| **账单** | 周期性账单 + 计量账单 | _待补_ | 🚧 |
|
|
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
|
|
| **收据** | 成功收款后生成的凭证 | _待补_ | 🚧 |
|
|
|
|
## 域内总图
|
|
|
|
![[knowledge-map]]
|
|
|
|
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
|
|
|
|
## 你是谁?
|
|
|
|
> [!tip] 业户(物业的客户)
|
|
> 关心"我怎么买/缴/取/退",看 [flow-a-vs-flow-b](concepts/adhoc/flow-a-vs-flow-b.md) 最直观。
|
|
|
|
> [!tip] 业务人员(物业职员、财务)
|
|
> 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。
|
|
|
|
## 文档约定
|
|
|
|
- **业户口语**:称"您",场景里描述真实生活情境
|
|
- **mermaid 流程图**:每个场景配一张,直观看完整链路
|
|
- **WikiLinks**:`[[XX]]` 是 vault 内部跳转(仅 Obsidian / Quartz 渲染);Gitea / GitHub 看导航请走表格里的 Markdown 链接
|
|
- **callouts**:`tip` / `warning` / `example` 标注重点
|
|
|
|
## 相关文档
|
|
|
|
- [prop-acc · 域知识地图](maps/knowledge-map.md)
|
|
- [adhoc 子模块知识地图](maps/adhoc-knowledge-map.md)
|
|
- [顶层域索引](../maps/domain-map.md)
|
|
- [跨域协作地图](../cross/maps/cross-domain-map.md)
|