第 4 阶段：订单、交接与账务--ok

docs/api.md

@@ -37,3 +37,7 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `POST /api/orders/{id}/handoff`
 - `GET /api/orders/{id}/handoff-records`
 - `POST /api/orders/{id}/confirm-receive`
+- `POST /api/orders/{id}/return`
+- `POST /api/orders/{id}/confirm-return`
+- `GET /api/wallet/balance`
+- `GET /api/wallet/ledger`

docs/business-rules.md

@@ -45,3 +45,21 @@
 - 租客确认收号后，订单状态变为 `renting`，交接状态变为 `received`。
 - 确认收号时会重新计算租赁开始时间和结束时间。
 - 交接记录保存在 `handoff_records`，订单双方都可以查看。
+
+## 开发态归还与完成
+
+- 租赁中订单可以由租客提交归还。
+- 租客提交归还后，订单状态变为 `pending_return_confirm`，交接状态变为 `pending_owner_return_confirm`。
+- 只有号主可以确认归还。
+- 号主确认归还后，订单状态变为 `completed`，交接状态变为 `returned`，结算状态先标记为 `settled`。
+- 订单完成后，账号和发布状态恢复为 `published`。
+- 当前只做状态闭环，不生成真实钱包流水，资金流水后续接入。
+
+## 开发态钱包账务
+
+- 钱包账务当前为模拟流水，不代表真实支付、充值或提现。
+- 创建订单时为租客生成一笔冻结流水，金额为租金加押金。
+- 取消待交接订单时释放租客冻结金额。
+- 订单完成时释放租客冻结金额，给号主生成租金入账流水，并给租客生成押金退回流水。
+- 每笔流水记录 `balance_after`，用于后续对账。
+- 后续接入真实支付后，需要把模拟冻结替换为支付成功后的真实冻结。