---
title: 场景 - A 流 - 前台购买装修出入证
tags:
  - prop-acc
  - 一次性收费
  - 业务场景
  - A流
audience:
  - 业户
  - 业务人员
status: stable
last_reviewed: 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流-装修公司批量采购出入证]] — 装修公司角度(承包多个项目)

## 异常分支

- 录错金额 / 工人数 → [[场景-已收款作废]]
- 业户付完反悔 → [[场景-已收款作废]]