uniprop-manual/prop-acc/maps/adhoc-knowledge-map.md

title, aliases, tags, sub_feature, audience, status, last_review, code_version

title	aliases	tags	sub_feature	audience	status	last_review	code_version
prop-acc · adhoc · 知识地图	adhoc 知识地图 一次性收费 一次性收费索引 prop-acc · 一次性收费索引 一次性收费(一次性收费)	规范 prop-acc 知识地图 一次性收费	adhoc	业户 业务人员	已发布	2026-05-25	2026-05-22

一次性收费(adhoc)知识地图

本子模块 = AdHocEvent(临时购买事件)。覆盖 prop-acc 域内"业户单次购买物品 / 一次性缴费"的全部 26 场景 + 3 概念。

这是什么?

业户在物业单次购买或缴费的事项 —— 不像物业费那样按月反复出账。典型有:

• IC 卡(门禁卡、停车卡、电梯卡)
• 装修出入证(给装修工人用)
• 泳票(夏季泳池单次票)
• 充电桩电费(电动车一次性充值)

[!info] 系统里叫什么 后台数据模型名是 AdHocEvent(临时事件)。每发生一笔购买就建一条记录,关联一张收款订单和收据(详见 collection-order-and-receipt)。

两种支付方式

[!example] 您是怎么买的?

• 线下 A 流:去物业前台,职员当场收钱给您出货
• 线上 B 流:打开小程序,选项目下单,微信/支付宝付款

详见 flow-a-vs-flow-b。

核心概念(3 篇)

文档	一句话
flow-a-vs-flow-b	线下/线上两种购买流程对比
collection-order-and-receipt	您买完后系统生成了什么
event-state-machine	一笔购买从下单到完成的状态机

场景手册(25 篇,全部完成 ✅)

📦 A 流(线下前台,即收即付)

• ✅ 前台购买 IC 卡
• ✅ 前台购买装修出入证
• ✅ 前台购买泳票
• ✅ 前台办理充电桩电费充值
• ✅ 装修公司批量采购出入证

📱 B 流(线上小程序)

• ✅ 小程序下单+微信支付
• ✅ 小程序下单+支付宝
• ✅ 跨渠道补缴 — 儿女线上下,老人前台付

❌ 取消 / 退款

• ✅ 业户改主意主动撤单
• ✅ 超时未付自动作废
• ✅ 已收款作废
• ✅ 录错金额作废重做

⚠️ 异常 / 故障

• ✅ 支付完成但实物发不出
• ✅ 微信支付回调延迟
• ✅ 业户重复下单
• ✅ 支付分账失败
• ✅ 同业户跨社区 Pending 单

🧾 收据 / 凭证

• ✅ 现场打印纸质收据
• ✅ 重打丢失收据
• ✅ 小程序自助下载 PDF

📊 审计 / 对账

• ✅ 月底现金对账
• ✅ IC 卡库存与售出数对账
• ✅ 作废事由抽查

🔧 配置 / 准备

• ✅ 新增收费项目
• ✅ 下架收费项目并处理 Pending 单

跨域引用

本子模块引用以下跨域共享概念:

• 业户 — 缴费主体
• 门卡 / IC 卡 — 售卖物之一
• 房屋单元 — 收费归属对象

相关代码

业务设计决策详见 packages/prop-acc/issue.md 的 Q1/Q2 段。

相关文档

• prop-acc 域首页
• prop-acc 域知识地图
• 跨域协作地图

---

[!success] 一次性收费子模块:25 场景 + 3 概念 = 28 篇完成

写作日期:2026-05-25 对应代码版本:2026-05-22(详见 packages/prop-acc/issue.md Q1/Q2)