127 lines
4.8 KiB
Markdown
127 lines
4.8 KiB
Markdown
---
|
|
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)
|