Files

Willie 35c0147a7b P3.5: prop-acc 启用子模块嵌套(adhoc/),应对大型业务域扩展

背景:
单纯按 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>

2026-05-25 20:55:59 +08:00

4.8 KiB

Raw Permalink Blame History

title, aliases, tags, audience, status, sub_feature, last_review, code_version

title

aliases

场景:前台购买装修出入证

业户装修期间需要发给工人的临时出入凭证。和场景-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 流支持,但实际很少这么做 —— 因为要核对工人身份和装修合同,前台当面办更稳妥。

异常分支

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

4.8 KiB Raw Permalink Blame History Unescape Escape