085de29cc8
写 6 个核心概念到 prop-acc/concepts/billing/: - bill-six-state-machine:6 状态(Unpaid/Partial/Paid/Suspended/Processing/Void), prop-acc 最复杂状态机;canBePaid/canBeDeleted/canBeVoided 守护方法详解 - bill-types-and-sources:周期/计量/临时 三类账单 + sourceable polymorphism (MeterReading / 周期任务 / null 三种 source 类型) - bill-vs-collection-order:Bill(应收)vs CollectionOrder(已收), CollectionOrderBill 多对多关联 + allocated_amount 字段语义; 与 adhoc 的 1:1 关系对比 - periodic-bill-generation:GeneratePeriodicBillsAction 完整流程 + BillingMergeStrategy 三种策略(SkipExisting / Merge / Replace) - delete-vs-void-dual-track:双轨制设计哲学,物理删(Unpaid 无付款)vs 作废(留状态留审计);issue.md Q6 第一轮修复历史 - smart-bulk-delete-design:智能批量删除 Modal 设计(预检查三档分类 + 必填原因 + 单条 activitylog 含 affected_bill_nos 数组); bill.bulkDelete 独立高敏权限 新建子模块知识地图: - prop-acc/maps/billing-knowledge-map.md:6 概念入口 + 16 场景预占 + 跨子模块对比(billing 与 deposit/prepaid/meter 的 6 维度差异)+ 代码索引 更新导航: - prop-acc/maps/knowledge-map.md:域总图 billing 行链 billing 知识地图,状态 🟡 - prop-acc/index.md:同步 billing 是 prop-acc 的"收款中枢" -- 上游对接 meter/周期任务/手工, 下游对接 CollectionOrder/Receipt,侧链对接 prepaid 抵扣。 下一轮:16 个场景文档(billing/scenarios/),按本知识地图骨架填充。 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 篇 |
|
|
| **账单** | 周期性账单 + 计量账单 | [billing 知识地图](maps/billing-knowledge-map.md) | 🟡 6 概念已完成,16 场景待补 |
|
|
| **收款订单** | 一次收款的支付方式、银行账户记录 | _待补_ | 🚧 |
|
|
| **收据** | 成功收款后生成的凭证 | _待补_ | 🚧 |
|
|
|
|
## 域内总图
|
|
|
|
![[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)
|