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>
4.7 KiB
4.7 KiB
title, aliases, tags, audience, status, last_review, code_version
| title | aliases | tags | audience | status | last_review | code_version | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| prop-acc · 场景 - A 流 - 前台购买装修出入证 |
|
|
|
已发布 | 2026-05-25 | 2026-05-22 |
场景:前台购买装修出入证
业户装修期间需要发给工人的临时出入凭证。和 场景-A流-前台购买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 |
| 备注 | 列出工人姓名 + 身份证号 + 装修期 |
系统流程
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流-装修公司批量采购出入证 — 装修公司角度(承包多个项目)