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:
@@ -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 段)
|
||||
>
|
||||
> 如果发现遗漏的场景或需要补充的细节,告诉我,可以单独补充新文档。
|
||||
|
||||
Reference in New Issue
Block a user