archery-event-docs/09-后台API说明/README.md

后台 API 说明

1. 定位

作为平台统一业务中台，服务微信小程序、商户后台和管理后台，承载核心业务逻辑与数据处理。

2. 建议领域模块

• 用户与认证
• 商户与资质审核
• 赛事管理
• 报名与订单
• 支付与退款
• 成绩与排名
• 消息通知
• 报表统计

3. 设计要求

• 业务规则集中管理，避免前端自行判断核心状态。
• 接口需保证幂等、权限隔离、日志审计。
• 与第三方平台交互需封装统一适配层。

4. 相关细分文档

4.1 架构与设计

• 领域模块划分.md
• 认证与鉴权方案.md
• 数据库表设计草案.md
• 状态机设计建议.md
• 缓存与异步任务设计.md
• 第三方集成清单.md

4.2 接口清单

• 接口清单规划.md
• 字段级接口清单模板.md
• 登录鉴权接口字段清单.md
• 用户报名相关接口字段清单.md
• 商户赛事管理接口字段清单.md
• 平台审核与运营接口字段清单.md
• 支付退款接口字段清单.md
• 成绩与排名接口字段清单.md
• 消息通知接口字段清单.md
• 结算对账接口字段清单.md
• 文件上传接口字段清单.md
• 字典与配置接口字段清单.md

5. 待确认项

• 是否采用单体 + 模块化架构，还是服务拆分。
• 是否使用统一网关、统一鉴权、统一日志链路。