35c0147a7b
背景: 单纯按 UDAS 严格扁平,prop-acc/scenarios/ 装齐 7 子模块后预计 100-150 篇 .md 单一文件夹,Explorer 无法浏览、Quartz folder page 无法阅读。 扩展规则(已写入 SKILL.md 多域章节 + multi-domain.md 第 10 节): - 单类型文件夹文件数 > 30 且能按业务子模块分组时,启用嵌套 - 路径:<domain>/<type>/<sub-feature>/<file>.md - 文件名去 <sub-feature>- 前缀(路径已表达) - title 三段式:<domain> · <sub-feature> · <名> - frontmatter 新增 sub_feature 字段(便于 RAG 过滤) - 跨子模块文档落在 <domain>/<type>/(不进子文件夹),与"跨域→cross/"对称 本次迁移: - prop-acc/concepts/adhoc-*.md (3) → prop-acc/concepts/adhoc/*.md - prop-acc/scenarios/adhoc-*.md (25) → prop-acc/scenarios/adhoc/*.md - 每个文件:title 加 adhoc 段、aliases 追加旧 prop-acc · 前缀形式(兼容)、 新增 sub_feature: adhoc 字段 WikiLink 解析未受影响: - 既有 [[场景-A流-...]] 等 200+ 引用通过 aliases (含旧 basename) 解析 - 新引用可用 [[adhoc · 前台购买 IC 卡]] 或 [[prop-acc · adhoc · 前台购买 IC 卡]] - 各域 knowledge-map.md 内 WikiLink 全部仍有效 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
149 lines
4.8 KiB
Markdown
149 lines
4.8 KiB
Markdown
---
|
||
title: prop-acc · adhoc · 场景 - A 流 - 前台购买装修出入证
|
||
aliases:
|
||
- prop-acc · 场景 - A 流 - 前台购买装修出入证
|
||
- 场景 - A 流 - 前台购买装修出入证
|
||
- 场景-A流-前台购买装修出入证
|
||
tags:
|
||
- 场景
|
||
- prop-acc
|
||
- 一次性收费
|
||
- 业务场景
|
||
- A流
|
||
audience:
|
||
- 业户
|
||
- 业务人员
|
||
status: 已发布
|
||
sub_feature: adhoc
|
||
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流-装修公司批量采购出入证]] — 装修公司角度(承包多个项目)
|
||
|
||
## 异常分支
|
||
|
||
- 录错金额 / 工人数 → [[场景-已收款作废]]
|
||
- 业户付完反悔 → [[场景-已收款作废]]
|