95 lines
4.9 KiB
Markdown
95 lines
4.9 KiB
Markdown
# 业务规则
|
|
|
|
业务规则以 [项目计划](project-plan.md) 为准。
|
|
|
|
一期关键边界：
|
|
|
|
- 哈夫币是游戏账号内资产，不是平台币。
|
|
- 哈夫币数量由号主手动填报，订单创建时生成账号资产快照。
|
|
- 平台不保存游戏账号密码，不代收验证码，不绕过游戏安全机制。
|
|
- 账号交接采用号主手动交接。
|
|
- 资金先做账务模型，不直接接真实支付和提现。
|
|
- 押金、交接超时、归还超时、短信限流等阈值进入系统配置。
|
|
|
|
## 开发态实名认证
|
|
|
|
- 当前实现为 mock 实名服务。
|
|
- 提交合法姓名和 18 位身份证号后直接通过认证。
|
|
- 后端只返回脱敏姓名和脱敏证件号。
|
|
- 用户表 `realname_status` 会同步更新为 `verified`。
|
|
- 后续接入阿里云或腾讯云实名服务时，保持 `POST /api/realname/start` 和 `GET /api/realname/status` 的业务语义不变。
|
|
|
|
## 开发态租号发布
|
|
|
|
- 发布租号前必须登录并完成实名认证。
|
|
- 一期创建发布时同时创建 `game_accounts` 和 `rental_listings`。
|
|
- 哈夫币数量是号主手动填报值，不代表实时值。
|
|
- 当前提交审核会 mock 为自动通过并上架，后续再接后台人工审核。
|
|
- 公开列表只展示 `status = published` 且 `review_status = approved` 的发布。
|
|
|
|
## 开发态订单创建
|
|
|
|
- 创建订单需要登录。
|
|
- 一期创建订单暂不接真实支付和押金冻结，创建成功后直接进入 `pending_handoff`。
|
|
- 创建订单时会在数据库事务内锁定发布和账号，防止同一账号重复出租。
|
|
- 创建订单时生成 `account_snapshot`，记录下单时账号资产状态。
|
|
- 订单创建后发布状态变为 `rented`，不再出现在公开租号列表。
|
|
- 待交接订单可以由租客取消，取消后发布状态恢复为 `published`。
|
|
|
|
## 开发态账号交接
|
|
|
|
- 创建订单后状态为 `pending_handoff`，交接状态为 `pending_owner`。
|
|
- 只有号主可以提交交接说明。
|
|
- 号主提交交接说明后，交接状态变为 `pending_renter_confirm`。
|
|
- 只有租客可以确认收号。
|
|
- 租客确认收号后，订单状态变为 `renting`，交接状态变为 `received`。
|
|
- 确认收号时会重新计算租赁开始时间和结束时间。
|
|
- 交接记录保存在 `handoff_records`，订单双方都可以查看。
|
|
|
|
## 开发态归还与完成
|
|
|
|
- 租赁中订单可以由租客提交归还。
|
|
- 租客提交归还后，订单状态变为 `pending_return_confirm`，交接状态变为 `pending_owner_return_confirm`。
|
|
- 只有号主可以确认归还。
|
|
- 号主确认归还后，订单状态变为 `completed`，交接状态变为 `returned`，结算状态先标记为 `settled`。
|
|
- 订单完成后，账号和发布状态恢复为 `published`。
|
|
- 当前会生成开发态模拟钱包流水，不代表真实支付或提现。
|
|
|
|
## 开发态钱包账务
|
|
|
|
- 钱包账务当前为模拟流水，不代表真实支付、充值或提现。
|
|
- 创建订单时为租客生成一笔冻结流水，金额为租金加押金。
|
|
- 取消待交接订单时释放租客冻结金额。
|
|
- 订单完成时释放租客冻结金额，给号主生成租金入账流水，并给租客生成押金退回流水。
|
|
- 每笔流水记录 `balance_after`，用于后续对账。
|
|
- 后续接入真实支付后，需要把模拟冻结替换为支付成功后的真实冻结。
|
|
|
|
## 开发态站内信
|
|
|
|
- 订单创建后通知号主和租客。
|
|
- 租客取消订单后通知号主和租客。
|
|
- 号主提交交接说明后通知租客。
|
|
- 租客确认收号后通知号主。
|
|
- 租客提交归还后通知号主。
|
|
- 号主确认归还后通知号主和租客。
|
|
- 发起申诉后通知对方和发起人。
|
|
- 仲裁完成后通知号主和租客。
|
|
- 站内信支持列表查询和标记已读。
|
|
|
|
## 开发态申诉仲裁
|
|
|
|
- 订单双方都可以在非终态订单发起申诉。
|
|
- 同一个订单同一时间只允许存在一个 `open` 或 `processing` 申诉。
|
|
- 发起申诉后订单状态变为 `disputing`，账号和发布保持锁定。
|
|
- 开发态后台仲裁接口为 `/api/admin/disputes`，当前只要求登录，后续接后台管理员和 RBAC。
|
|
- 仲裁结果先只落状态和通知：全额退款、部分退款、关闭订单会将订单置为 `closed`；扣押金、释放押金、赔付号主会将订单置为 `completed`。
|
|
- 仲裁完成后账号和发布恢复为 `published`。
|
|
- 当前仲裁不做真实扣款、退款、赔付落账，后续接真实支付后再补资金流水和审计日志。
|
|
|
|
## 开发态系统配置
|
|
|
|
- 系统配置接口为 `/api/admin/system-configs`。
|
|
- 首次查询会自动补齐一组默认配置，包括交接超时、归还确认超时、短信限流、最低押金、实名下单开关、平台抽成和提现门槛。
|
|
- 更新配置会写入 `audit_logs`，记录操作人、配置项、修改前值和修改后值。
|
|
- 当前后台接口仍是开发态 mock 权限，只要求登录；后续接入后台管理员、角色和权限后再限制可操作配置项。
|