---
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)