From c08aa47dbd1f9c34aad64309c904535d387c3a2d Mon Sep 17 00:00:00 2001 From: Willie Date: Mon, 25 May 2026 21:42:29 +0800 Subject: [PATCH] vault backup: 2026-05-25 21:42:29 --- .obsidian/workspace.json | 26 +++--- prop-acc · 物业财务(域首页).md | 0 prop-acc · 知识地图.md | 0 prop-acc/maps/adhoc-knowledge-map.md | 126 +++++++++++++++++++++++++++ prop-acc/maps/knowledge-map.md | 122 -------------------------- 5 files changed, 139 insertions(+), 135 deletions(-) create mode 100644 prop-acc · 物业财务(域首页).md create mode 100644 prop-acc · 知识地图.md create mode 100644 prop-acc/maps/adhoc-knowledge-map.md delete mode 100644 prop-acc/maps/knowledge-map.md diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 5e75771..613bc29 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -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", diff --git a/prop-acc · 物业财务(域首页).md b/prop-acc · 物业财务(域首页).md new file mode 100644 index 0000000..e69de29 diff --git a/prop-acc · 知识地图.md b/prop-acc · 知识地图.md new file mode 100644 index 0000000..e69de29 diff --git a/prop-acc/maps/adhoc-knowledge-map.md b/prop-acc/maps/adhoc-knowledge-map.md new file mode 100644 index 0000000..7bccda9 --- /dev/null +++ b/prop-acc/maps/adhoc-knowledge-map.md @@ -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) diff --git a/prop-acc/maps/knowledge-map.md b/prop-acc/maps/knowledge-map.md deleted file mode 100644 index 34127b8..0000000 --- a/prop-acc/maps/knowledge-map.md +++ /dev/null @@ -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)