2026-05-25 13:18:00 +08:00
|
|
|
---
|
2026-05-25 20:44:43 +08:00
|
|
|
title: prop-acc · 物业财务(域首页)
|
|
|
|
|
aliases:
|
|
|
|
|
- prop-acc
|
|
|
|
|
- 物业财务
|
|
|
|
|
- 财务模块
|
|
|
|
|
- 财务模块总览
|
2026-05-25 13:18:00 +08:00
|
|
|
tags:
|
2026-05-25 20:44:43 +08:00
|
|
|
- 域首页
|
2026-05-25 13:18:00 +08:00
|
|
|
- prop-acc
|
|
|
|
|
audience:
|
|
|
|
|
- 业户
|
|
|
|
|
- 业务人员
|
2026-05-25 20:44:43 +08:00
|
|
|
status: 已发布
|
|
|
|
|
last_review: 2026-05-25
|
2026-05-25 13:18:00 +08:00
|
|
|
---
|
|
|
|
|
|
2026-05-25 20:44:43 +08:00
|
|
|
# 物业财务(prop-acc)
|
2026-05-25 13:18:00 +08:00
|
|
|
|
|
|
|
|
物业财务系统,管业户的各种收费、押金、预存款,自动出账单、收款、生成收据。
|
|
|
|
|
|
2026-05-25 21:46:28 +08:00
|
|
|
## 七大子模块进度
|
2026-05-25 20:44:43 +08:00
|
|
|
|
2026-05-25 22:52:49 +08:00
|
|
|
| 子模块 | 一句话 | 深度地图 | 状态 |
|
|
|
|
|
| --------- | ---------------- | --------------------------------------------- | ------ |
|
|
|
|
|
| **一次性收费** | IC 卡、装修证、泳票等单次购买 | [adhoc 知识地图](maps/adhoc-knowledge-map.md) | ✅ 28 篇 |
|
|
|
|
|
| **保证金** | 装修押金等代管资金,完工后退还 | [deposit 知识地图](maps/deposit-knowledge-map.md) | ✅ 25 篇 |
|
prepaid 子模块 · 轮 2:16 场景 + 知识地图收尾
写 16 个场景到 prop-acc/scenarios/prepaid/,覆盖 6 类业务:
📥 充值(3):
- deposit-first-time(张阿姨首次充 5000)
- deposit-additional-topup(已有账户追加充值)
- deposit-via-miniapp-pending(小程序在线充值设计意图,待补)
🧹 消费 Consume(4,最核心):
- consume-monthly-property-bill(手动抵扣月物业费)
- consume-multiple-bills-priority(多账单按 due_at 优先级抵扣)
- consume-meter-bill(抵扣计量账单 - 水电费)
- consume-batch-auto-monthly(月初批量自动抵扣 job 设计 + 业务流程,待补)
💰 退款(2):
- refund-full-resident-moveout(业户搬走全额退余,**不自动关账**)
- refund-partial-after-consume(部分退余,余额非零保持 Active)
🧊 冻结/解冻(2):
- freeze-suspected-fraud(疑似欺诈 / 风控冻结)
- unfreeze-after-verification(核实后解冻 = ReactivateAccountAction)
🔒 结清(2):
- close-resident-moveout(业户搬走主动关账,**需手动**与 deposit 不同)
- close-with-zero-balance-decision(余额清零不自动关,业户决定)
🛡️ 异常/审计(3):
- exception-cross-community-consume(跨社区消费三层防御,模型层抛 InvalidArgumentException)
- exception-refund-on-frozen(冻结状态退款三层守护,模型层最严 canOperate)
- audit-low-balance-and-overdue(低余额业户预警 + 逾期账单排查,
关联 LowBalancePrepaidListWidget + DepositPrepaidDashboard)
每篇结构:典型情境 → 业户视角 → 业务人员视角 → 系统流程(mermaid)→
常见问题 → 异常分支 → 相关文档(WikiLinks)。
prepaid 与 deposit 的核心差异在场景中持续强调:
- 一户一账约束(deposit 不允许跨账户操作的设计)
- 零余额不自动关账(consume / refund 后状态保持 Active)
- 消费走 CollectionType=Bill(账单视角,fund_source=prepaid)
- 没有 ForceClose(纠纷罕见,简化设计)
- 缴款人只能是业户本人(deposit 支持装修公司代缴)
收尾:
- prop-acc/maps/prepaid-knowledge-map.md:16 场景全部 ✅,加完成 callout
- prop-acc/maps/knowledge-map.md:prepaid 行状态改 "✅ 23 篇"
- prop-acc/index.md:同步
prepaid 子模块完整覆盖:6 概念 + 16 场景 + 1 知识地图 = 23 篇。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-25 23:39:05 +08:00
|
|
|
| **预存款** | 业户预存,自动抵扣月度账单 | [prepaid 知识地图](maps/prepaid-knowledge-map.md) | ✅ 23 篇 |
|
2026-05-25 23:56:41 +08:00
|
|
|
| **计量表** | 水表/电表/燃气表,抄表生成账单 | [meter 知识地图](maps/meter-knowledge-map.md) | 🟡 6 概念已完成,14 场景待补 |
|
2026-05-25 22:52:49 +08:00
|
|
|
| **账单** | 周期性账单 + 计量账单 | _待补_ | 🚧 |
|
|
|
|
|
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
|
|
|
|
|
| **收据** | 成功收款后生成的凭证 | _待补_ | 🚧 |
|
2026-05-25 20:44:43 +08:00
|
|
|
|
2026-05-25 21:46:28 +08:00
|
|
|
## 域内总图
|
|
|
|
|
|
|
|
|
|
![[knowledge-map]]
|
2026-05-25 13:18:00 +08:00
|
|
|
|
2026-05-25 21:46:28 +08:00
|
|
|
[查看完整域知识地图(Gitea / GitHub 可点)](maps/knowledge-map.md)
|
2026-05-25 13:18:00 +08:00
|
|
|
|
|
|
|
|
## 你是谁?
|
|
|
|
|
|
|
|
|
|
> [!tip] 业户(物业的客户)
|
2026-05-25 21:46:28 +08:00
|
|
|
> 关心"我怎么买/缴/取/退",看 [flow-a-vs-flow-b](concepts/adhoc/flow-a-vs-flow-b.md) 最直观。
|
2026-05-25 13:18:00 +08:00
|
|
|
|
|
|
|
|
> [!tip] 业务人员(物业职员、财务)
|
|
|
|
|
> 关心"前台怎么操作、出问题怎么救",每个场景都有"业务人员视角"段落。
|
|
|
|
|
|
|
|
|
|
## 文档约定
|
|
|
|
|
|
|
|
|
|
- **业户口语**:称"您",场景里描述真实生活情境
|
|
|
|
|
- **mermaid 流程图**:每个场景配一张,直观看完整链路
|
2026-05-25 21:46:28 +08:00
|
|
|
- **WikiLinks**:`[[XX]]` 是 vault 内部跳转(仅 Obsidian / Quartz 渲染);Gitea / GitHub 看导航请走表格里的 Markdown 链接
|
2026-05-25 13:18:00 +08:00
|
|
|
- **callouts**:`tip` / `warning` / `example` 标注重点
|
2026-05-25 20:44:43 +08:00
|
|
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
2026-05-25 21:46:28 +08:00
|
|
|
- [prop-acc · 域知识地图](maps/knowledge-map.md)
|
|
|
|
|
- [adhoc 子模块知识地图](maps/adhoc-knowledge-map.md)
|
|
|
|
|
- [顶层域索引](../maps/domain-map.md)
|
|
|
|
|
- [跨域协作地图](../cross/maps/cross-domain-map.md)
|