订单超时任务系统

docs/api.md

@@ -74,3 +74,5 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `GET /api/admin/audit-logs`
 
 说明：`GET /api/admin/listings` 支持按 `owner_id`、`status`、`review_status` 和 `limit` 查询商品。`GET /api/admin/wallet/ledger` 支持按 `user_id`、`order_id`、`biz_type` 和 `limit` 查询最近资金流水。`GET /api/admin/audit-logs` 支持按 `actor_id`、`action`、`biz_type` 和 `limit` 查询最近审计日志。`/api/admin/*` 当前已使用独立后台登录，后续接入 RBAC 和 Casbin 权限后再按角色收紧访问控制。
+
+订单超时扫描任务为后端内部任务，不暴露公开 API；超时阈值通过 `/api/admin/system-configs` 调整。

docs/business-rules.md

@@ -51,12 +51,24 @@
 ## 开发态归还与完成
 
 - 租赁中订单可以由租客提交归还。
+- 逾期中订单仍允许租客提交归还，但后台和号主可以根据逾期情况发起申诉或客服处理。
 - 租客提交归还后，订单状态变为 `pending_return_confirm`，交接状态变为 `pending_owner_return_confirm`。
 - 只有号主可以确认归还。
 - 号主确认归还后，订单状态变为 `completed`，交接状态变为 `returned`，结算状态先标记为 `settled`。
 - 订单完成后，账号和发布状态恢复为 `published`。
 - 当前会生成开发态模拟钱包流水，不代表真实支付或提现。
 
+## 开发态超时任务
+
+- 后端启动后会运行订单超时扫描任务，默认每 1 分钟执行一次。
+- 任务从 `system_configs` 读取超时阈值，包括号主待交接、租客确认收号、租客归还宽限和号主确认归还。
+- 号主待交接超时：订单保持 `pending_handoff`，交接状态变为 `owner_timeout`，租客仍可取消订单或发起申诉。
+- 租客确认收号超时：订单状态变为 `abnormal`，交接状态变为 `renter_confirm_timeout`，进入客服介入。
+- 租客逾期未归还：订单状态变为 `overdue`，交接状态变为 `return_overdue`，租客仍可提交归还，号主可发起申诉。
+- 号主确认归还超时：订单状态变为 `abnormal`，交接状态变为 `owner_return_confirm_timeout`，进入客服复核。
+- 每个超时动作只推进一次状态，避免重复通知。
+- 超时动作会给相关用户写入站内信，并以 `system` 身份写入 `audit_logs`。
+
 ## 开发态钱包账务
 
 - 钱包账务当前为模拟流水，不代表真实支付、充值或提现。