Vault/uniprop-manual
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

vault backup: 2026-05-25 21:42:29

Browse Source
This commit is contained in:
Willie
2026-05-25 21:42:29 +08:00
parent 44518fe1e2
commit c08aa47dbd
5 changed files with 139 additions and 135 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
.obsidian/workspace.json vendored
View File

@@ -13,12 +13,12 @@
"state": {
"type": "markdown",
"state": {
"file": "patrol/index.md",
"file": "prop-acc · 物业财务(域首页).md",
"mode": "source",
"source": false
},
"icon": "lucide-file",
"title": "index"
"title": "prop-acc · 物业财务(域首页)"
}
}
]
@@ -94,7 +94,7 @@
"state": {
"type": "backlink",
"state": {
"file": "patrol/index.md",
"file": "prop-acc · 物业财务(域首页).md",
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical",
@@ -104,7 +104,7 @@
"unlinkedCollapsed": true
},
"icon": "links-coming-in",
"title": "Backlinks for index"
"title": "Backlinks for prop-acc · 物业财务(域首页)"
}
},
{
@@ -113,12 +113,12 @@
"state": {
"type": "outgoing-link",
"state": {
"file": "patrol/index.md",
"file": "prop-acc · 物业财务(域首页).md",
"linksCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-going-out",
"title": "Outgoing links from index"
"title": "Outgoing links from prop-acc · 物业财务(域首页)"
}
},
{
@@ -156,13 +156,13 @@
"state": {
"type": "outline",
"state": {
"file": "patrol/index.md",
"file": "prop-acc · 物业财务(域首页).md",
"followCursor": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-list",
"title": "Outline of index"
"title": "Outline of prop-acc · 物业财务(域首页)"
}
},
{
@@ -196,6 +196,11 @@
},
"active": "b06ed69835363258",
"lastOpenFiles": [
"prop-acc/maps/adhoc-knowledge-map.md",
"prop-acc · 知识地图.md",
"prop-acc · 物业财务(域首页).md",
"index.md",
"patrol/index.md",
"业户.md",
"prop-acc/scenarios/adhoc/config-add-item.md",
"prop-acc/scenarios/adhoc/config-delist-item-handle-pending.md",
@@ -217,11 +222,6 @@
"prop-acc/scenarios/adhoc/cancel-amount-error-redo.md",
"prop-acc/scenarios/adhoc/cancel-resident-withdrawal.md",
"prop-acc/scenarios/adhoc/flow-b-miniapp-alipay.md",
"prop-acc/scenarios/adhoc/flow-b-miniapp-wechat-pay.md",
"prop-acc/scenarios/adhoc/flow-a-renovation-bulk-pass.md",
"prop-acc/scenarios/adhoc/flow-a-counter-buy-renovation-pass.md",
"prop-acc/scenarios/adhoc/flow-a-counter-ev-charging-topup.md",
"prop-acc/scenarios/adhoc/flow-a-counter-buy-pool-ticket.md",
"prop-acc/scenarios/adhoc",
"prop-acc/concepts/adhoc",
"resident-portal/scenarios",

0
prop-acc · 物业财务(域首页).md Normal file
View File

0
prop-acc · 知识地图.md Normal file
View File

126
prop-acc/maps/adhoc-knowledge-map.md Normal file
View File

@@ -0,0 +1,126 @@
---
title: prop-acc · adhoc · 知识地图
aliases:
- adhoc 知识地图
- 一次性收费
- 一次性收费索引
- prop-acc · 一次性收费索引
- 一次性收费(一次性收费)
tags:
- 规范
- prop-acc
- 知识地图
- 一次性收费
sub_feature: adhoc
audience:
- 业户
- 业务人员
status: 已发布
last_review: 2026-05-25
code_version: 2026-05-22
---
# 一次性收费(adhoc)知识地图
> 本子模块 = AdHocEvent(临时购买事件)。覆盖 prop-acc 域内"业户单次购买物品 / 一次性缴费"的全部 26 场景 + 3 概念。
## 这是什么?
业户在物业**单次购买**或缴费的事项 —— 不像物业费那样按月反复出账。典型有:
- **IC 卡**(门禁卡、停车卡、电梯卡)
- **装修出入证**(给装修工人用)
- **泳票**(夏季泳池单次票)
- **充电桩电费**(电动车一次性充值)
> [!info] 系统里叫什么
> 后台数据模型名是 `AdHocEvent`(临时事件)。每发生一笔购买就建一条记录,关联一张收款订单和收据(详见 [collection-order-and-receipt](../concepts/adhoc/collection-order-and-receipt.md))。
## 两种支付方式
> [!example] 您是怎么买的?
> - **线下 A 流**:去物业前台,职员当场收钱给您出货
> - **线上 B 流**:打开小程序,选项目下单,微信/支付宝付款
详见 [flow-a-vs-flow-b](../concepts/adhoc/flow-a-vs-flow-b.md)。
## 核心概念(3 篇)
| 文档 | 一句话 |
|---|---|
| [flow-a-vs-flow-b](../concepts/adhoc/flow-a-vs-flow-b.md) | 线下/线上两种购买流程对比 |
| [collection-order-and-receipt](../concepts/adhoc/collection-order-and-receipt.md) | 您买完后系统生成了什么 |
| [event-state-machine](../concepts/adhoc/event-state-machine.md) | 一笔购买从下单到完成的状态机 |
## 场景手册(25 篇,**全部完成 ✅**)
### 📦 A 流(线下前台,即收即付)
- ✅ [前台购买 IC 卡](../scenarios/adhoc/flow-a-counter-buy-ic-card.md)
- ✅ [前台购买装修出入证](../scenarios/adhoc/flow-a-counter-buy-renovation-pass.md)
- ✅ [前台购买泳票](../scenarios/adhoc/flow-a-counter-buy-pool-ticket.md)
- ✅ [前台办理充电桩电费充值](../scenarios/adhoc/flow-a-counter-ev-charging-topup.md)
- ✅ [装修公司批量采购出入证](../scenarios/adhoc/flow-a-renovation-bulk-pass.md)
### 📱 B 流(线上小程序)
- ✅ [小程序下单+微信支付](../scenarios/adhoc/flow-b-miniapp-wechat-pay.md)
- ✅ [小程序下单+支付宝](../scenarios/adhoc/flow-b-miniapp-alipay.md)
- ✅ [跨渠道补缴](../scenarios/adhoc/cross-channel-supplementary-payment.md) — 儿女线上下,老人前台付
### ❌ 取消 / 退款
- ✅ [业户改主意主动撤单](../scenarios/adhoc/cancel-resident-withdrawal.md)
- ✅ [超时未付自动作废](../scenarios/adhoc/auto-void-timeout.md)
- ✅ [已收款作废](../scenarios/adhoc/void-after-payment.md)
- ✅ [录错金额作废重做](../scenarios/adhoc/cancel-amount-error-redo.md)
### ⚠️ 异常 / 故障
- ✅ [支付完成但实物发不出](../scenarios/adhoc/exception-paid-but-cannot-deliver.md)
- ✅ [微信支付回调延迟](../scenarios/adhoc/exception-wechat-callback-delay.md)
- ✅ [业户重复下单](../scenarios/adhoc/exception-duplicate-order.md)
- ✅ [支付分账失败](../scenarios/adhoc/exception-payment-split-failure.md)
- ✅ [同业户跨社区 Pending 单](../scenarios/adhoc/exception-cross-community-pending.md)
### 🧾 收据 / 凭证
- ✅ [现场打印纸质收据](../scenarios/adhoc/receipt-onsite-print.md)
- ✅ [重打丢失收据](../scenarios/adhoc/receipt-reprint-lost.md)
- ✅ [小程序自助下载 PDF](../scenarios/adhoc/receipt-miniapp-pdf-download.md)
### 📊 审计 / 对账
- ✅ [月底现金对账](../scenarios/adhoc/audit-month-end-cash-reconciliation.md)
- ✅ [IC 卡库存与售出数对账](../scenarios/adhoc/audit-ic-card-stock-reconciliation.md)
- ✅ [作废事由抽查](../scenarios/adhoc/audit-void-reason-sampling.md)
### 🔧 配置 / 准备
- ✅ [新增收费项目](../scenarios/adhoc/config-add-item.md)
- ✅ [下架收费项目并处理 Pending 单](../scenarios/adhoc/config-delist-item-handle-pending.md)
## 跨域引用
本子模块引用以下跨域共享概念:
- [业户](../../cross/concepts/resident.md) — 缴费主体
- [门卡 / IC 卡](../../cross/concepts/access-card.md) — 售卖物之一
- [房屋单元](../../cross/concepts/housing-unit.md) — 收费归属对象
## 相关代码
业务设计决策详见 `packages/prop-acc/issue.md` 的 Q1/Q2 段。
## 相关文档
- [prop-acc 域首页](../index.md)
- [prop-acc 域知识地图](knowledge-map.md)
- [跨域协作地图](../../cross/maps/cross-domain-map.md)
---
> [!success] 一次性收费子模块:25 场景 + 3 概念 = **28 篇完成**
>
> 写作日期:2026-05-25
> 对应代码版本:2026-05-22(详见 `packages/prop-acc/issue.md` Q1/Q2)

122
prop-acc/maps/knowledge-map.md
View File

@@ -1,122 +0,0 @@
---
title: prop-acc · 知识地图
aliases:
- prop-acc 知识地图
- 一次性收费
- 一次性收费索引
- prop-acc · 一次性收费索引
- 一次性收费(一次性收费)
tags:
- 规范
- prop-acc
- 知识地图
audience:
- 业户
- 业务人员
status: 已发布
last_review: 2026-05-25
code_version: 2026-05-22
---
# prop-acc · 知识地图
> 物业财务域的全部文档入口。当前覆盖**一次性收费**子模块,其他子模块待补。
## 一次性收费(AdHocEvent)子模块
业户在物业**单次购买**或缴费的事项 —— 不像物业费那样按月反复出账。典型有:
- **IC 卡**(门禁卡、停车卡、电梯卡)
- **装修出入证**(给装修工人用)
- **泳票**(夏季泳池单次票)
- **充电桩电费**(电动车一次性充值)
> [!info] 系统里叫什么
> 后台数据模型名是 `AdHocEvent`(临时事件)。每发生一笔购买就建一条记录,关联一张[[概念-CollectionOrder与Receipt|收款订单和收据]]。
### 两种支付方式
> [!example] 您是怎么买的?
> - **线下 A 流**:去物业前台,职员当场收钱给您出货
> - **线上 B 流**:打开小程序,选项目下单,微信/支付宝付款
详见 [[概念-A流与B流|A 流与 B 流对比]]。
### 核心概念(3 篇)
- [[概念-A流与B流]] — 线下/线上两种购买流程对比
- [[概念-CollectionOrder与Receipt]] — 您买完后系统生成了什么
- [[概念-AdHocEvent状态机]] — 一笔购买从下单到完成中间的几种状态
### 场景手册(26 篇,**全部完成 ✅**)
#### 📦 A 流(线下前台,即收即付)
- ✅ [[场景-A流-前台购买IC卡]]
- ✅ [[场景-A流-前台购买装修出入证]]
- ✅ [[场景-A流-前台购买泳票]]
- ✅ [[场景-A流-前台办理充电桩电费充值]]
- ✅ [[场景-A流-装修公司批量采购出入证]]
#### 📱 B 流(线上小程序)
- ✅ [[场景-B流-小程序下单+微信支付]]
- ✅ [[场景-B流-小程序下单+支付宝]]
- ✅ [[场景-跨渠道补缴]] — 儿女线上下,老人前台付
#### ❌ 取消 / 退款
- ✅ [[场景-取消-业户改主意主动撤单]]
- ✅ [[场景-超时未付自动作废]]
- ✅ [[场景-已收款作废]]
- ✅ [[场景-取消-录错金额作废重做]]
#### ⚠️ 异常 / 故障
- ✅ [[场景-异常-支付完成但实物发不出]]
- ✅ [[场景-异常-微信支付回调延迟]]
- ✅ [[场景-异常-业户重复下单]]
- ✅ [[场景-异常-支付分账失败]]
- ✅ [[场景-异常-同业户跨社区Pending单]]
#### 🧾 收据 / 凭证
- ✅ [[场景-收据-现场打印纸质收据]]
- ✅ [[场景-收据-重打丢失收据]]
- ✅ [[场景-收据-小程序自助下载PDF]]
#### 📊 审计 / 对账
- ✅ [[场景-审计-月底现金对账]]
- ✅ [[场景-审计-IC卡库存与售出数对账]]
- ✅ [[场景-审计-作废事由抽查]]
#### 🔧 配置 / 准备
- ✅ [[场景-配置-新增收费项目]]
- ✅ [[场景-配置-下架收费项目并处理Pending单]]
## 跨域引用
本域引用以下共享概念:
- [[业户]] — 缴费主体
- [[门卡]] — 售卖物之一
- [[房屋单元]] — 收费归属对象
- [[预存款]] — 关联模块(待补)
## 相关代码
业务设计决策详见 `packages/prop-acc/issue.md` 的 Q1/Q2 段。
## 相关文档
- [[prop-acc · 域首页]]
- [[domain-map|跨域索引]]
---
> [!success] 一次性收费子模块:26 场景 + 3 概念 + 1 知识地图 = **30 篇完成**
>
> 写作日期:2026-05-25
> 对应代码版本:2026-05-22(详见 `packages/prop-acc/issue.md` Q1/Q2)