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

docs/api.md

@@ -30,3 +30,10 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `DELETE /api/listings/{id}`
 - `GET /api/seller/listings`
 - `GET /api/seller/listings/{id}`
+- `POST /api/orders`
+- `GET /api/orders`
+- `GET /api/orders/{id}`
+- `POST /api/orders/{id}/cancel`
+- `POST /api/orders/{id}/handoff`
+- `GET /api/orders/{id}/handoff-records`
+- `POST /api/orders/{id}/confirm-receive`

docs/business-rules.md

@@ -26,3 +26,22 @@
 - 哈夫币数量是号主手动填报值，不代表实时值。
 - 当前提交审核会 mock 为自动通过并上架，后续再接后台人工审核。
 - 公开列表只展示 `status = published` 且 `review_status = approved` 的发布。
+
+## 开发态订单创建
+
+- 创建订单需要登录。
+- 一期创建订单暂不接真实支付和押金冻结，创建成功后直接进入 `pending_handoff`。
+- 创建订单时会在数据库事务内锁定发布和账号，防止同一账号重复出租。
+- 创建订单时生成 `account_snapshot`，记录下单时账号资产状态。
+- 订单创建后发布状态变为 `rented`，不再出现在公开租号列表。
+- 待交接订单可以由租客取消，取消后发布状态恢复为 `published`。
+
+## 开发态账号交接
+
+- 创建订单后状态为 `pending_handoff`，交接状态为 `pending_owner`。
+- 只有号主可以提交交接说明。
+- 号主提交交接说明后，交接状态变为 `pending_renter_confirm`。
+- 只有租客可以确认收号。
+- 租客确认收号后，订单状态变为 `renting`，交接状态变为 `received`。
+- 确认收号时会重新计算租赁开始时间和结束时间。
+- 交接记录保存在 `handoff_records`，订单双方都可以查看。