hfb_sys/docs/business-rules.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，订单双方都可以查看。