b7c0cd6e0c
P3 — prop-acc 30 文件迁移到多域 UDAS 结构:
- 3 概念:旧 prop-acc/一次性收费/概念-*.md
→ prop-acc/concepts/adhoc-*.md (kebab-case 英文)
- 25 场景:旧 prop-acc/一次性收费/场景-*.md
→ prop-acc/scenarios/adhoc-*.md
- 子文件夹 index.md → prop-acc/maps/knowledge-map.md (域内地图)
- prop-acc/index.md 重写为域首页(embed knowledge-map)
- 删除空目录 prop-acc/一次性收费/
每个迁移文件:
- title 加域前缀 "prop-acc · "
- aliases 含原 title (带空格) + 原文件名 basename (无空格),保证既有 [[...]] 引用解析
- status: stable → 已发布 / draft → 草稿 (UDAS 中文枚举)
- last_reviewed → last_review (UDAS 字段名)
- tags 补加 UDAS 类型分类 "概念" / "场景"
- 路径式 WikiLink 清除:
* [[../预存款/index|XX]] → [[预存款]]
* [[一次性收费/index|XX]] → [[prop-acc · 一次性收费索引]]
P4 — 4 个新业务域骨架:
- community (社区管理)
- administrative (行政人事)
- patrol (巡护工单)
- resident-portal (业户门户)
每域含 index.md (域首页) + maps/knowledge-map.md (域内地图模板)。
另补 cross/index.md + cross/maps/cross-domain-map.md。
P5 — 顶层入口:
- index.md: 站点首页 (Quartz 着陆点),embed domain-map
- maps/domain-map.md: 5 业务域 + cross 的索引表
迁移后状态:
- 共 50 篇 .md (30 原 + 8 跨域 stub + 4 域 index + 4 域 map + 2 cross + 2 root)
- 残留路径式 WikiLink: 0
- 残留英文 status: 0
- 残留 last_reviewed 字段: 0
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
147 lines
4.7 KiB
Markdown
147 lines
4.7 KiB
Markdown
---
|
||
title: prop-acc · 场景 - A 流 - 前台购买装修出入证
|
||
aliases:
|
||
- 场景 - A 流 - 前台购买装修出入证
|
||
- 场景-A流-前台购买装修出入证
|
||
tags:
|
||
- 场景
|
||
- prop-acc
|
||
- 一次性收费
|
||
- 业务场景
|
||
- A流
|
||
audience:
|
||
- 业户
|
||
- 业务人员
|
||
status: 已发布
|
||
last_review: 2026-05-25
|
||
code_version: 2026-05-22
|
||
---
|
||
|
||
# 场景:前台购买装修出入证
|
||
|
||
业户装修期间需要发给工人的临时出入凭证。和 [[场景-A流-前台购买IC卡|IC 卡场景]]非常类似,但有几个**装修专属特点**。
|
||
|
||
## 典型情境
|
||
|
||
> [!example] 真实情境
|
||
> 王先生买了新房要装修,装修公司带 8 个工人。装修队进场要刷卡进小区门禁,他需要去物业办 8 张装修出入证。
|
||
|
||
## 业户视角
|
||
|
||
### 第 1 步:准备材料
|
||
|
||
| 材料 | 用途 |
|
||
|---|---|
|
||
| 业主身份证 / 房产证 | 证明是您的房 |
|
||
| **装修施工合同** | 物业要存档登记 |
|
||
| **装修方案 / 报建表** | 部分高端物业要求 |
|
||
| 工人身份证(全部)| 出入证上要写工人姓名 |
|
||
|
||
### 第 2 步:到前台
|
||
|
||
"我家要装修,需要办 8 张工人出入证。"
|
||
|
||
### 第 3 步:核对工人信息
|
||
|
||
职员会**逐人录入工人信息**,这一步比 IC 卡慢。每张装修证关联具体工人姓名 + 身份证号。
|
||
|
||
### 第 4 步:付款 + 拿证
|
||
|
||
- 单张装修证常见 ¥10-50(各物业政策不同)
|
||
- 8 张合计可能 ¥80-400
|
||
- 现金 / 微信 / POS 均可
|
||
- 当场拿到 8 张实体出入证
|
||
|
||
> [!info] 装修押金?
|
||
> 大部分物业除了收装修证费用,还会同时收**装修押金**(¥5000-10000),押金属于保证金模块,不是一次性收费。两者一般同时办,但走不同流程。详见保证金模块文档(待补)。
|
||
|
||
## 业务人员视角
|
||
|
||
### 操作差异(对比 IC 卡)
|
||
|
||
| 维度 | IC 卡 | 装修出入证 |
|
||
|---|---|---|
|
||
| 数量 | 通常 1 张 | 经常 5-20 张 |
|
||
| 单价 | ¥30-50 | ¥10-50 |
|
||
| 必填字段 | 业户 + 房号 | 业户 + 房号 + **每个工人身份信息** |
|
||
| 关联其他模块 | ❌ | 通常同时办**装修押金** |
|
||
| 有效期 | 长期 | **装修期内**(常见 3-6 个月) |
|
||
| 实物 | IC 卡片 | 出入证(卡片或臂章) |
|
||
|
||
### 建议操作流程
|
||
|
||
```
|
||
1. 装修合同存档(纸质或扫描进系统)
|
||
2. 收装修押金(走保证金模块的 DepositAction)
|
||
├── 业户付 ¥5000
|
||
└── 系统建 DepositAccount + 收据
|
||
3. 收装修证费用(本场景)
|
||
├── 8 张 × ¥30 = ¥240
|
||
├── Filament 后台 → 一次性收费 → 新建
|
||
├── 数量填 8
|
||
├── 备注栏列出 8 个工人姓名 + 身份证
|
||
└── 提交
|
||
4. 制证 + 发证
|
||
```
|
||
|
||
### Filament 录入
|
||
|
||
| 字段 | 填什么 |
|
||
|---|---|
|
||
| 业户 | 通过房号搜业户 |
|
||
| 收费项目 | "装修出入证" |
|
||
| 数量 | 8 |
|
||
| 金额 | 自动计算 ¥240(可手动调)|
|
||
| 支付方式 | 微信 / 现金 / POS |
|
||
| 备注 | 列出工人姓名 + 身份证号 + 装修期 |
|
||
|
||
## 系统流程
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant 业户
|
||
participant 前台
|
||
participant 保证金模块
|
||
participant 一次性收费模块
|
||
|
||
业户->>前台: 我要装修,办手续
|
||
前台->>前台: 核对身份 + 合同存档
|
||
|
||
Note over 业户,保证金模块: 第 1 笔:装修押金
|
||
前台->>保证金模块: DepositAction (¥5000)
|
||
保证金模块-->>业户: 押金收据
|
||
|
||
Note over 业户,一次性收费模块: 第 2 笔:装修出入证
|
||
前台->>一次性收费模块: CreateAdHocEventAction (8张 × ¥30)
|
||
一次性收费模块-->>业户: 收据 + 8 张出入证
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
> [!question] 业户想加几个工人怎么办?
|
||
> **新开一笔订单**录入新工人,不影响原订单。系统里就是两笔独立 AdHocEvent。
|
||
|
||
> [!question] 装修期延长,出入证可以续期吗?
|
||
> 当前系统**不管出入证的有效期**,这是物业内部管理事项。如需续期,通常的做法是**新开一笔订单**重新收费。
|
||
|
||
> [!question] 装修中工人退出怎么办?
|
||
> 出入证收回作废即可,**不会退费**(本来就是临时性消耗品)。系统里那笔订单**不需要作废**(产品已售出)。
|
||
|
||
> [!question] 装修结束,押金怎么退?
|
||
> 走保证金模块的 `RefundFromDepositAccountAction`,生成红字凭证。详见保证金模块退款场景(待补)。
|
||
|
||
> [!question] 业户在小程序上能办装修证吗?
|
||
> 技术上 B 流支持,但实际很少这么做 —— 因为要核对工人身份和装修合同,前台**当面办更稳妥**。
|
||
|
||
## 相关概念
|
||
|
||
- [[概念-A流与B流]]
|
||
- [[概念-CollectionOrder与Receipt]]
|
||
- [[场景-A流-前台购买IC卡]] — 标准 A 流模板
|
||
- [[场景-A流-装修公司批量采购出入证]] — 装修公司角度(承包多个项目)
|
||
|
||
## 异常分支
|
||
|
||
- 录错金额 / 工人数 → [[场景-已收款作废]]
|
||
- 业户付完反悔 → [[场景-已收款作废]]
|