deposit 子模块 · 轮 2:18 场景 + 知识地图收尾

写 18 个场景到 prop-acc/scenarios/deposit/,覆盖 7 类业务:

📥 缴纳(3):
- deposit-first-time-renovation(张阿姨首次缴 5000)
- deposit-additional-topup(陈先生追加 2000)
- deposit-on-behalf-by-company(王装修代 3 户业主缴 15000)

💰 退款(3):
- refund-full-no-damage(无损全退)
- refund-partial-after-forfeit(扣 800 退 4200)
- refund-with-payment-channel-switch(现金缴 → 银行转账退)

⚠️ 扣罚(2):
- forfeit-damage-public-area(墙面损坏扣 800)
- forfeit-violation-no-permit(未报备私自动工违约扣 3000)

🧊 冻结/解冻(2):
- freeze-during-dispute(纠纷期间冻结)
- unfreeze-after-mediation(调解后解冻)

🔒 结清(2):
- close-after-zero-balance(余额清零自动 Closed)
- close-manual-with-zero-balance(主动关空账户)

🚨 强制关账(3,Frozen + 有余额困境):
- force-close-refund(全退,鉴定无责)
- force-close-forfeit(全扣,仲裁全责)
- force-close-retain(资金保留,业户失联/装修方倒闭)

🛡️ 异常/审计(3):
- exception-deposit-on-frozen(冻结状态尝试缴款被三层守护拦截)
- audit-monthly-deposit-balance(月度三方对账:账面 == 银行专户 == 流水净值)
- audit-long-pending-accounts(超 2 年未关账户分类清理)

每篇结构:典型情境 → 业户视角 → 业务人员视角 → 系统流程(mermaid)→
流水台账 → 常见问题 → 异常分支 → 相关文档。

收尾:
- prop-acc/maps/deposit-knowledge-map.md:18 场景全部 ,加完成 callout
- prop-acc/maps/knowledge-map.md:deposit 行状态改 " 25 篇"
- prop-acc/index.md:同步

deposit 子模块完整覆盖:6 概念 + 18 场景 + 1 知识地图 = 25 篇。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Willie
2026-05-25 22:40:19 +08:00
parent 29938ecbe0
commit a98bdaf98e
4 changed files with 213 additions and 26 deletions

View File

@@ -43,50 +43,48 @@ code_version: 2026-05-22
| [红字凭证设计](../concepts/deposit/red-receipt-design.md) | 退款扣罚走红字 CollectionOrder + Receipt,而非新增枚举 |
| [押金 vs 一次性收费 vs 预存款](../concepts/deposit/deposit-vs-adhoc-vs-prepaid.md) | 三个子模块的会计本质区别(收入 vs 预收 vs 代管) |
## 场景手册(18 篇,**待补充 ✋**)
> 🚧 概念骨架已就位,场景文档将在下一轮产出。预定结构如下。
## 场景手册(18 篇,**全部完成 ✅**)
### 📥 缴纳(Deposit)— 3 篇
- 🚧 [装修业户首次缴 5,000 保证金](../scenarios/deposit/deposit-first-time-renovation.md)
- 🚧 [已有账户后续追加缴款](../scenarios/deposit/deposit-additional-topup.md)
- 🚧 [装修公司代业户缴纳](../scenarios/deposit/deposit-on-behalf-by-company.md)
- [装修业户首次缴 5,000 保证金](../scenarios/deposit/deposit-first-time-renovation.md)
- [已有账户后续追加缴款](../scenarios/deposit/deposit-additional-topup.md)
- [装修公司代业户缴纳](../scenarios/deposit/deposit-on-behalf-by-company.md)
### 💰 退款(Refund)— 3 篇
- 🚧 [装修完无损全额退还](../scenarios/deposit/refund-full-no-damage.md)
- 🚧 [部分扣罚后退还差额](../scenarios/deposit/refund-partial-after-forfeit.md)
- 🚧 [退款渠道与缴款渠道不同](../scenarios/deposit/refund-with-payment-channel-switch.md)
- [装修完无损全额退还](../scenarios/deposit/refund-full-no-damage.md)
- [部分扣罚后退还差额](../scenarios/deposit/refund-partial-after-forfeit.md)
- [退款渠道与缴款渠道不同](../scenarios/deposit/refund-with-payment-channel-switch.md)
### ⚠️ 扣罚(Forfeiture)— 2 篇
- 🚧 [损坏公共走道墙面扣 800](../scenarios/deposit/forfeit-damage-public-area.md)
- 🚧 [未申请直接动工违约扣罚](../scenarios/deposit/forfeit-violation-no-permit.md)
- [损坏公共走道墙面扣 800](../scenarios/deposit/forfeit-damage-public-area.md)
- [未申请直接动工违约扣罚](../scenarios/deposit/forfeit-violation-no-permit.md)
### 🧊 冻结 / 解冻(Freeze / Unfreeze)— 2 篇
- 🚧 [业户纠纷期间冻结账户](../scenarios/deposit/freeze-during-dispute.md)
- 🚧 [调解结束后解冻](../scenarios/deposit/unfreeze-after-mediation.md)
- [业户纠纷期间冻结账户](../scenarios/deposit/freeze-during-dispute.md)
- [调解结束后解冻](../scenarios/deposit/unfreeze-after-mediation.md)
### 🔒 结清(Close)— 2 篇
- 🚧 [余额清零自动关闭](../scenarios/deposit/close-after-zero-balance.md)
- 🚧 [主动关账(已无业务往来)](../scenarios/deposit/close-manual-with-zero-balance.md)
- [余额清零自动关闭](../scenarios/deposit/close-after-zero-balance.md)
- [主动关账(已无业务往来)](../scenarios/deposit/close-manual-with-zero-balance.md)
### 🚨 强制关账(ForceClose)— 3 篇
> 解决 "Frozen + 有余额 + 想关账" 的设计困境。三种 disposition 对应不同业务出口。
- 🚧 [冻结状态强制全退并关账](../scenarios/deposit/force-close-refund.md)
- 🚧 [冻结状态强制全扣并关账](../scenarios/deposit/force-close-forfeit.md)
- 🚧 [法律保留期 / 业户失联,资金保留并关账](../scenarios/deposit/force-close-retain.md)
- [冻结状态强制全退并关账](../scenarios/deposit/force-close-refund.md)
- [冻结状态强制全扣并关账](../scenarios/deposit/force-close-forfeit.md)
- [法律保留期 / 业户失联,资金保留并关账](../scenarios/deposit/force-close-retain.md)
### 🛡️ 异常 / 审计 / 配置 — 3 篇
- 🚧 [冻结账户尝试缴款被守护拦截](../scenarios/deposit/exception-deposit-on-frozen.md)
- 🚧 [月度押金账户余额对账](../scenarios/deposit/audit-monthly-deposit-balance.md)
- 🚧 [长期未关账户排查](../scenarios/deposit/audit-long-pending-accounts.md)
- [冻结账户尝试缴款被守护拦截](../scenarios/deposit/exception-deposit-on-frozen.md)
- [月度押金账户余额对账](../scenarios/deposit/audit-monthly-deposit-balance.md)
- [长期未关账户排查](../scenarios/deposit/audit-long-pending-accounts.md)
## 跨域引用
@@ -120,6 +118,9 @@ code_version: 2026-05-22
---
> [!info] 概念已完成,场景待补
> 本轮(轮 1)产出:6 个概念 + 本子模块地图 + 域总图更新。
> 下一轮(轮 2)产出:18 个场景文档,基于本知识地图骨架填充。
> [!success] deposit 子模块:6 概念 + 18 场景 + 1 知识地图 = **25 篇完成**
>
> 写作日期:2026-05-25
> 对应代码版本:2026-05-22(详见 `packages/prop-acc/issue.md` Q3 段)
>
> 如果发现遗漏的场景或需要补充的细节,告诉我,可以单独补充新文档。