Vault/uniprop-manual

Fork 0

Files

Willie 29938ecbe0 vault backup: 2026-05-25 22:37:41

2026-05-25 22:37:41 +08:00

7.2 KiB

Raw Blame History

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

title

aliases

场景:冻结状态强制全扣并关账

账户处于 Frozen 状态、还有余额,纠纷结果明确利向物业(损坏归责确认业户全责、违约严重、司法判决物业胜诉等)。物业用 ForceCloseAction 选 forfeit disposition,一步完成"解冻 + 全额扣罚 + 关账"。

典型情境

[!example] 真实情境刘先生家装修时多次违反装修管理协议(深夜施工、随意丢弃建筑垃圾、损坏 3 处公共设施),物业累计要扣 ¥6,000,而账户只有 ¥5,000。其间刘先生拒绝补缴,账户被冻结进入仲裁。仲裁裁决"业户全责,押金 ¥5,000 全部用于罚款,差额 ¥1,000 业户另行支付"。

物业财务依据仲裁书走 ForceClose forfeit,把账户里的 ¥5,000 全扣转入物业收入,账户关闭。差额 ¥1,000 通过司法执行另案处理(不在本系统内)。

业户视角

您会感受到什么

收到通知:"您的押金账户已结清,余额 ¥5,000 全额扣罚"
收到红字收据:"装修保证金扣罚 ¥-5,000(强制关账扣罚,事由:仲裁裁决业户全责)"
银行 / 微信没有退款(钱已转入物业收入)
小程序"我的押金账户"显示 "🔒 已结清,余额 0"

您要做什么

接受裁决结果(钱已转出账户,无法追回)
保管红字收据(税务凭证,有时报税)
如有异议走司法上诉(不在本系统内)

业务人员视角

第 1 步:确认全扣判定

仲裁裁决书 / 司法判决书 / 物业内部决议(必须书面)
物业内部已审批,具备实施权限

[!warning] 比 ForceClose refund 更敏感全扣是把业户的钱全部转入物业,法律风险比"全退"更高。书面凭证必须完整,内部多层审批,任何疏漏未来纠纷物业败诉概率大。

第 2 步:打开 Frozen 账户

后台 → 保证金 → 账户列表 → 找 Frozen 账户 → 进 ViewDepositAccount。

第 3 步:点击 `ForceCloseAction`(标签"强制关账")

Modal 表单:

字段	填什么
处置方式 (disposition)	选 ✅ `forfeit`(扣罚)
扣罚事由(memo)	必填且详细。例: "2026-XX-XX 仲裁案号 XXX 裁决:业户多次违约,押金 5000 全额作为罚款。"

[!info] forfeit 不需要选退款渠道扣罚的钱不退给业户,直接转入物业收入,无需 PaymentChannel。Modal 表单选 forfeit 后退款渠道字段隐藏。

[!warning] Policy 守护同 force-close-refund:update 权限 + isFrozen() && hasBalance()。

第 4 步:提交

系统调 ForceCloseDepositAccountAction(disposition=forfeit),事务内:

校验 isFrozen() && hasBalance()
建 CollectionOrder(actual_amount=-5000 红字,status=Completed)—— 表达"从代管负债转出"
加 DepositTransaction(type=forfeiture,amount=5000,balance_before=5000,balance_after=0,关联红字 CO)
更新 balance=0
直接 status=Closed(Frozen → Closed)
在 meta.force_closed_disposition=forfeit、meta.force_closed_memo=...、meta.force_closed_at=... 记审计字段
触发 CollectionOrderCompleted → Listener 建红字 Receipt"装修保证金扣罚 ¥-5,000(强制关账扣罚,事由 XXX)"

第 5 步:无线下退款,只给红字凭证

后台找到红字 Receipt → 发业户。不要走任何转账操作 —— 资金已通过 forfeiture 流水转入物业维修收入科目,账面已完成。

系统流程

sequenceDiagram
    participant 业户
    participant 财务
    participant Filament
    participant ForceCloseDepositAccountAction
    participant 数据库
    participant 监听器

    Note over 业户,财务: 账户 Frozen + balance=5000,仲裁裁决全扣

    财务->>Filament: ViewDepositAccount → ForceCloseAction (disposition=forfeit)
    Filament->>ForceCloseDepositAccountAction: handle(account, disposition=forfeit, memo)
    ForceCloseDepositAccountAction->>ForceCloseDepositAccountAction: isFrozen() && hasBalance()? yes
    ForceCloseDepositAccountAction->>数据库: 开启事务
    ForceCloseDepositAccountAction->>数据库: 1. 建 CO (-5000 红字, Completed)
    ForceCloseDepositAccountAction->>数据库: 2. 建 DepositTransaction (forfeiture, 5000→0)
    ForceCloseDepositAccountAction->>数据库: 3. balance=0, status=Closed
    ForceCloseDepositAccountAction->>数据库: 4. meta.force_closed_disposition=forfeit + memo + at
    ForceCloseDepositAccountAction->>监听器: 5. 触发 CollectionOrderCompleted
    监听器->>数据库: 6. 建 Receipt (强制关账扣罚 ¥-5,000)
    ForceCloseDepositAccountAction->>数据库: 提交事务
    Filament-->>财务: 成功通知
    财务-->>业户: 红字凭证(无退款)

资金流意义

flowchart LR
  A[业户押金 5000<br/>物业代管负债] -->|forfeit| B[物业维修/罚没收入<br/>5000]

会计上:其他应付款 → 装修维修收入,资金从未离开物业账户,只是科目变化。

常见问题

[!question] forfeit 的钱进什么科目? 通常进"装修维修收入"或"罚没收入"科目(视物业财务核算细则)。账面通过 Receipt 上的 line item 描述触发科目映射(Listener generateDepositReceiptItems 按 DepositTransaction.type=forfeiture 选词)。

[!question] 业户能反悔追讨吗? 已扣的钱要回去只能走司法:

业户起诉物业不当扣罚

法院判决物业败诉 → 物业按判决退款(可能需开新账户做反向 deposit + refund 操作记账,审计完整)

法院判决物业胜诉 → 维持原状

系统层面的 ForceClose 不可逆,司法判决物业败诉走"补偿"路径,不"撤销"原 ForceClose。

[!question] 仲裁裁决有补充条款(例如要求物业方做某些工作)怎么办? 系统只处理资金,补充条款(如修复方案、整改要求)需物业线下执行 + 留档。系统不强制关联。

[!question] 业户已经搬走,联系不上怎么给红字收据? 系统层面凭证已生成,业务上若联系不上业户:

用挂号信寄到登记地址

物业内部档案保留

等业户联系时再补发

如果业户失联前提下连扣罚都不应做(可能未让业户充分应诉),走 force-close-retain 等业户出现更稳妥。

[!question] 比 forfeit 多扣怎么办(扣 5000 还不够,要扣 6000)? 账户最多扣到余额清零(amount ≤ balance 守护)。差额追偿不在本系统内:

单独的 adhoc-flow-a-vs-flow-b 流(开违约金账单)

司法执行(系统不参与)

异常分支

部分扣部分退 → 走 unfreeze-after-mediation + 普通 refund-partial-after-forfeit
全退给业户 → force-close-refund
资金保留待定 → force-close-retain

7.2 KiB Raw Blame History