项目初始化

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

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