Vault/uniprop-manual

Fork 0

Files

Willie bd00a94612 vault backup: 2026-05-25 13:24:32

2026-05-25 13:24:32 +08:00

3.9 KiB

Raw Blame History

title, tags, audience, status, last_reviewed, code_version

title

场景:前台购买 IC 卡

最典型最高频的一次性收费场景。门禁卡、停车卡、电梯卡都走这条路径。

典型情境

[!example] 真实情境张阿姨,72 岁,上周搬家钥匙丢了想配新门禁卡。她不会用小程序,下午 3 点去了物业前台办公室。

业户视角(您要做什么)

第 1 步:到前台

带上身份证 + 房产证(或租赁合同) 到物业前台。

[!tip] 装修业户特别注意如果您是装修公司,需要带上业主授权书或合同复印件。

第 2 步:告诉职员要办什么

"我要补办一张门禁卡,房号是 12-3-501。"

第 3 步:付款

职员会告诉您多少钱(常见 ¥30-50 一张),您可选:

现金 —— 最常见
微信扫码 —— 职员出示物业收款码
POS 刷卡 —— 银行卡支付

第 4 步:拿卡 + 收据

实物 IC 卡:当场拿到
收据:可以选打印纸质或微信收

[!success] 完成整个过程 5 分钟内搞定。回家就能刷卡进门了。

业务人员视角(职员怎么操作)

第 1 步:打开后台

第 2 步:填表单

字段	填什么
业户	通过手机号或房号查找业户
收费项目(RatePlan)	选 "IC 卡 - 门禁"
数量	1
金额	自动按 RatePlan 单价填(可手动改)
支付方式	现金 / 微信 / POS
收款银行账户	微信/POS 选对应银行账户;现金可空
备注	选填,如 "丢卡补办"

第 3 步:提交

点击"创建"。系统瞬间完成:

建 AdHocEvent(状态 Completed)
建 CollectionOrder(状态 Completed)
建 Receipt(状态 Issued)
触发收据 PDF 生成

第 4 步:出货 + 给收据

从抽屉拿一张空白 IC 卡,在制卡机里写入业户房号
把卡交给业户
把收据打印 / 发到业户微信

系统流程(技术视角)

sequenceDiagram
    participant 业户
    participant 前台
    participant Filament
    participant 数据库
    participant 监听器

    业户->>前台: 我要买门禁卡 + 付现金
    前台->>Filament: 填表单 + 提交
    Filament->>数据库: 开启事务
    Filament->>数据库: 1. 建 CollectionOrder (Completed)
    Filament->>数据库: 2. 建 AdHocEvent (Completed, 关联 CO)
    Filament->>监听器: 3. 触发 CollectionOrderCompleted 事件
    监听器->>数据库: 4. 建 Receipt + ReceiptItem
    Filament->>数据库: 提交事务
    Filament-->>前台: 成功通知
    前台->>业户: 出卡 + 给收据

[!info] 一气呵成第 1-4 步在一个数据库事务里完成 —— 任何一步失败,整笔操作回滚,不会出现"扣了钱但没出卡"的半成品状态。

常见问题

[!question] 业户没带身份证可以办吗? 各物业政策不同。系统不会强制 —— 是物业内部审核流程。

[!question] 业户现金不够可以拆分支付吗? 当前一笔订单只支持一种支付方式。需要拆,可以分两单做(2 张 IC 卡分两笔录入)。

[!question] 万一录错金额怎么办? 走场景-已收款作废流程,作废后重新录入。

[!question] 卡的物理库存怎么管? 当前系统不管物理库存,只管财务记录。需要库存管理可以接外部系统,或挂 TODO 等业务方反馈。

异常分支

业户付完反悔 → 场景-已收款作废
业户改主意不要了 → 录入前直接放弃,系统里没任何记录

3.9 KiB Raw Blame History