166 lines
6.3 KiB
Markdown
166 lines
6.3 KiB
Markdown
|
---
|
||
|
|
title: prop-acc · deposit · 场景 - 装修业户首次缴 5000 保证金
|
||
|
|
aliases:
|
||
|
|
- 首次缴装修保证金
|
||
|
|
- deposit-first-time-renovation
|
||
|
|
- 场景-装修业户首次缴保证金
|
||
|
|
tags:
|
||
|
|
- 场景
|
||
|
|
- prop-acc
|
||
|
|
- 保证金
|
||
|
|
- 缴纳
|
||
|
|
audience:
|
||
|
|
- 业户
|
||
|
|
- 业务人员
|
||
|
|
status: 已发布
|
||
|
|
sub_feature: deposit
|
||
|
|
last_review: 2026-05-25
|
||
|
|
code_version: 2026-05-22
|
||
|
|
---
|
||
|
|
|
||
|
|
# 场景:装修业户首次缴 5,000 保证金
|
||
|
|
|
||
|
|
最常见的保证金场景。业户准备装修,**第一次**给物业交装修押金,系统**当场建账户 + 收钱 + 出收据**。
|
||
|
|
|
||
|
|
## 典型情境
|
||
|
|
|
||
|
|
> [!example] 真实情境
|
||
|
|
> 张阿姨,72 岁,儿子要装修她家(12-3-501)。装修前一天她带着身份证、房产证、装修施工合同来物业前台,要交 ¥5,000 装修保证金。
|
||
|
|
|
||
|
|
## 业户视角(您要做什么)
|
||
|
|
|
||
|
|
### 第 1 步:到前台带齐材料
|
||
|
|
|
||
|
|
- 身份证(或户口本)
|
||
|
|
- 房产证(或租赁合同 + 业主授权书)
|
||
|
|
- 装修施工合同(物业要存档,确认装修方信息)
|
||
|
|
|
||
|
|
### 第 2 步:告诉职员
|
||
|
|
|
||
|
|
"我家要装修了,来交装修保证金,房号 12-3-501。"
|
||
|
|
|
||
|
|
### 第 3 步:付款
|
||
|
|
|
||
|
|
职员告诉您**多少钱**(常见 ¥3,000-10,000,各小区不同),您可选:
|
||
|
|
|
||
|
|
- **现金**
|
||
|
|
- **微信扫码**
|
||
|
|
- **POS 刷卡**
|
||
|
|
- **银行转账**(需打印银行凭证)
|
||
|
|
|
||
|
|
### 第 4 步:拿收据
|
||
|
|
|
||
|
|
- 纸质收据:**当场打印**
|
||
|
|
- 电子收据:发到您的微信或邮箱
|
||
|
|
|
||
|
|
> [!success] 完成
|
||
|
|
> 整个过程 10 分钟内搞定。收据写"装修保证金缴纳 ¥5,000",妥善保管,装修结束时退押凭这个。
|
||
|
|
|
||
|
|
## 业务人员视角(物业职员怎么操作)
|
||
|
|
|
||
|
|
> [!info] 关键差异
|
||
|
|
> 这是**首次**开户 + 缴款。之后追加缴款走 [[deposit-additional-topup]],流程更简短。
|
||
|
|
|
||
|
|
### 第 1 步:打开后台
|
||
|
|
|
||
|
|
登录 Filament 后台 → 保证金 → **新建账户**(`CreateDepositAccount` 页面)。
|
||
|
|
|
||
|
|
### 第 2 步:填表单(账户信息)
|
||
|
|
|
||
|
|
| 字段 | 填什么 |
|
||
|
|
|---|---|
|
||
|
|
| **缴款人类型(`payer_type`)** | 选 `Owner`(业主)/ `Tenant`(租户)/ `Contractor`(承包商)等;详见 [[payer-types]] |
|
||
|
|
| **缴款人姓名(`payer_name`)** | "张某某" |
|
||
|
|
| **缴款人联系方式(`payer_contact`)** | 张阿姨手机号 |
|
||
|
|
| **业户档案(`community_user_profile_id`)** | 通过房号 12-3-501 找到张阿姨绑定的业户档案(Owner / Tenant 类型必填) |
|
||
|
|
| **房屋单元(`asset_id`)** | 12-3-501 房屋资产 |
|
||
|
|
| **押金种类(`fee_type_id`)** | "装修保证金"(本物业项目预先配置的 FeeType) |
|
||
|
|
| **备注(`remark`)** | 选填,如 "2026 年春季装修,施工方:王装修有限公司" |
|
||
|
|
|
||
|
|
### 第 3 步:填首次缴款信息
|
||
|
|
|
||
|
|
`CreateDepositAccount` 页面下半部分有"首次缴款"段,**和开户一起一气呵成**:
|
||
|
|
|
||
|
|
| 字段 | 填什么 |
|
||
|
|
|---|---|
|
||
|
|
| **缴款金额** | ¥5,000 |
|
||
|
|
| **支付方式(PaymentChannel)** | 现金 / 微信 / POS / 银行转账 |
|
||
|
|
| **收款银行账户** | 微信/POS/转账选对应银行;现金可空 |
|
||
|
|
| **缴款备注** | 选填,如 "首次开户缴款" |
|
||
|
|
|
||
|
|
### 第 4 步:提交
|
||
|
|
|
||
|
|
点击"创建"。系统在一个数据库事务内完成:
|
||
|
|
|
||
|
|
1. 建 `DepositAccount`(`status=Active`,`balance=5000`)
|
||
|
|
2. 建 `CollectionOrder`(`actual_amount=+5000`,`status=Completed`)
|
||
|
|
3. 建 `DepositTransaction`(`type=deposit`,`amount=5000`,`balance_before=0`,`balance_after=5000`,关联 CO)
|
||
|
|
4. 触发 `CollectionOrderCompleted` 事件
|
||
|
|
5. Listener 自动建 `Receipt` + `ReceiptItem`,文案"装修保证金缴纳 ¥5,000"
|
||
|
|
|
||
|
|
### 第 5 步:打印 / 发收据
|
||
|
|
|
||
|
|
- 后台收据列表找到刚生成的 Receipt → 点击"打印"或"发送"
|
||
|
|
- 把纸质收据交给张阿姨,或直接微信发她
|
||
|
|
|
||
|
|
## 系统流程
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
sequenceDiagram
|
||
|
|
participant 业户
|
||
|
|
participant 前台
|
||
|
|
participant Filament
|
||
|
|
participant 数据库
|
||
|
|
participant 监听器
|
||
|
|
|
||
|
|
业户->>前台: 我要交装修保证金 5000(现金)
|
||
|
|
前台->>Filament: CreateDepositAccount 填表 + 提交
|
||
|
|
Filament->>数据库: 开启事务
|
||
|
|
Filament->>数据库: 1. 建 DepositAccount (Active, balance=5000)
|
||
|
|
Filament->>数据库: 2. 建 CollectionOrder (actual=+5000, Completed)
|
||
|
|
Filament->>数据库: 3. 建 DepositTransaction (deposit, balance 0→5000)
|
||
|
|
Filament->>监听器: 4. 触发 CollectionOrderCompleted
|
||
|
|
监听器->>数据库: 5. 建 Receipt + ReceiptItem ("装修保证金缴纳 ¥5,000")
|
||
|
|
Filament->>数据库: 提交事务
|
||
|
|
Filament-->>前台: 成功通知 + 显示新账户
|
||
|
|
前台->>业户: 给收据
|
||
|
|
```
|
||
|
|
|
||
|
|
> [!info] 一气呵成
|
||
|
|
> 5 个数据库写入在同一事务里。任何一步失败,整笔回滚 —— 不会出现"账户建了但钱没记""收据生成了但流水没建"的半成品状态。
|
||
|
|
|
||
|
|
## 常见问题
|
||
|
|
|
||
|
|
> [!question] 业户没带身份证 / 房产证可以办吗?
|
||
|
|
> 各物业政策不同,系统不强制证件检查。属于物业内部审核流程。
|
||
|
|
|
||
|
|
> [!question] 装修方是装修公司不是业户,该怎么开?
|
||
|
|
> 走 [[deposit-on-behalf-by-company]] 流程:`payer_type=Company`,不绑业户档案,只记公司名 + 联系人。
|
||
|
|
|
||
|
|
> [!question] 业户没带够现金可以拆分付款吗?
|
||
|
|
> 单笔 `CollectionOrder` 只支持一种支付方式。可以**先开账户缴一部分**,过几天 [[deposit-additional-topup|追加缴款]] 补齐。
|
||
|
|
|
||
|
|
> [!question] 录错金额(把 ¥5,000 录成 ¥50,000)怎么办?
|
||
|
|
> 不要试图改流水,流水是不可变的。正确做法:建一笔 `Refund` 退还多收的差额,业户拿到一张红字收据。详见 [[transaction-types]] "真实修正场景示例" 段。
|
||
|
|
|
||
|
|
> [!question] 这个账户绑了张阿姨,但实际付钱的是她儿子,可以吗?
|
||
|
|
> 系统只看 `payer_*` 字段。如果想严格反映"儿子代付",可在 `payer_name` 写儿子名 + `community_user_profile_id` 仍绑张阿姨;退款时收据上文案会按 `payer_name` 显示。或者继续用张阿姨名,备注里说明。
|
||
|
|
|
||
|
|
> [!question] 同一业户能开多个押金账户吗?
|
||
|
|
> 可以,只要 `(community_id, fee_type_id, payer_type, asset_id)` 组合不同。例如张阿姨可以同时有"装修保证金"和"入驻押金"两个账户,各自独立。
|
||
|
|
|
||
|
|
## 异常分支
|
||
|
|
|
||
|
|
- 录错金额想撤回 → [[refund-partial-after-forfeit]] 或 [[refund-full-no-damage]]
|
||
|
|
- 装修过程出问题(损坏 / 违约)→ [[forfeit-damage-public-area]] / [[forfeit-violation-no-permit]]
|
||
|
|
- 业户和物业有纠纷暂时冻结 → [[freeze-during-dispute]]
|
||
|
|
- 已开账户后续追加 → [[deposit-additional-topup]]
|
||
|
|
|
||
|
|
## 相关文档
|
||
|
|
|
||
|
|
- [[deposit-account-vs-transaction]]
|
||
|
|
- [[account-state-machine]]
|
||
|
|
- [[payer-types]]
|
||
|
|
- [[refund-full-no-damage]]
|
||
|
|
- [[deposit-additional-topup]]
|