archery-event-docs/09-后台API说明/状态机设计建议.md

状态机设计建议

1. 目标

为后台 API 的状态流转实现提供统一设计建议，避免不同模块各自维护状态导致混乱。

2. 建议纳入状态机管理的对象

• 商户入驻状态
• 赛事状态
• 报名单状态
• 订单状态
• 退款单状态
• 成绩发布状态

3. 设计原则

• 状态变化必须由明确事件触发。
• 非法状态跳转应统一拦截。
• 每次状态变化需要记录操作人、时间、原因。
• 尽量避免前端拼凑状态逻辑。

4. 实现建议

• 在领域服务层集中处理状态变更。
• 为关键状态机编写转移表与单元测试。
• 支持审计日志和状态回溯。