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

24 lines
674 B
Markdown
Raw Permalink Normal View History

2026-04-07 16:15:59 +08:00
# 状态机设计建议
## 1. 目标
为后台 API 的状态流转实现提供统一设计建议,避免不同模块各自维护状态导致混乱。
## 2. 建议纳入状态机管理的对象
- 商户入驻状态
- 赛事状态
- 报名单状态
- 订单状态
- 退款单状态
- 成绩发布状态
## 3. 设计原则
- 状态变化必须由明确事件触发。
- 非法状态跳转应统一拦截。
- 每次状态变化需要记录操作人、时间、原因。
- 尽量避免前端拼凑状态逻辑。
## 4. 实现建议
- 在领域服务层集中处理状态变更。
- 为关键状态机编写转移表与单元测试。
- 支持审计日志和状态回溯。