archery-event-docs/README.md

射箭赛事平台文档仓库

1. 项目说明

本仓库用于梳理“射箭赛事平台”的业务文档、系统说明和开发前置资料，后续可直接提供给 agent 进行代码开发、接口设计、测试用例整理与任务拆解。

2. 代码工程范围

当前平台包含 4 个核心代码工程：

工程	面向对象	主要职责
微信小程序	参赛用户	浏览赛事、报名支付、查看通知与成绩
商户后台	赛事入驻方	入驻申请、赛事发布、报名管理、成绩录入
管理后台	平台运营人员	审核商户、审核赛事、风控治理、报表统计
后台 API 服务	全部客户端	提供统一接口、权限控制、订单支付、成绩与消息能力

3. 当前文档目录

archery-event/
├── README.md
├── 01-基础与总览/
├── 02-用户侧流程/
├── 03-商户侧流程/
├── 04-平台治理流程/
├── 05-通用基础/
├── 06-微信小程序说明/
├── 07-商户后台说明/
├── 08-管理后台说明/
├── 09-后台API说明/
├── 10-项目执行/
└── 11-项目验收/

4. 推荐阅读顺序

第 1 层：先理解业务

1. 01-基础与总览/README.md
2. 01-基础与总览/核心业务流程总览.md
3. 01-基础与总览/角色与场景地图.md
4. 01-基础与总览/业务名词表.md

第 2 层：再看核心闭环

5. 03-商户侧流程/商户入驻流程.md
6. 03-商户侧流程/赛事创建与发布流程.md
7. 02-用户侧流程/用户报名参赛流程.md
8. 02-用户侧流程/支付流程.md
9. 02-用户侧流程/退款流程.md
10. 03-商户侧流程/成绩录入与排名流程.md

第 3 层：补充规则与治理

11. 03-商户侧流程/赛事规则与计分模型.md
12. 04-平台治理流程/状态流转总表.md
13. 02-用户侧流程/消息通知与触达流程.md
14. 04-平台治理流程/结算与对账流程.md
15. 04-平台治理流程/异常处理与申诉流程.md
16. 01-基础与总览/业务规则待确认清单.md

第 4 层：最后交给开发实现

17. 05-通用基础/README.md
18. 05-通用基础/系统架构总览.md
19. 05-通用基础/角色与权限矩阵.md
20. 05-通用基础/核心数据模型草案.md
21. 09-后台API说明/领域模块划分.md
22. 09-后台API说明/接口清单规划.md

第 5 层：进入执行与验收

23. 10-项目执行/README.md
24. 10-项目执行/模块实施总任务单.md
25. 11-项目验收/README.md
26. 11-项目验收/功能验收标准总表.md

5. 文档编写原则

• 文档默认使用中文。
• 优先明确业务边界、角色职责、状态流转和关键数据对象。
• 当前技术栈未定，先不绑定具体框架实现。
• 所有新增术语应同步更新到 01-基础与总览/业务名词表.md。
• 一条业务规则有变化时，应同步更新相关流程文档、状态文档和接口说明。

6. 当前优先级

• P0：商户入驻流程
• P0：赛事创建与发布流程
• P1：用户报名参赛流程
• P1：支付流程
• P1：退款流程
• P1：成绩录入与排名流程
• P2：通知、结算、异常、报表与交付规范

7. 交给 agent 前建议至少补齐的内容

只要把下面这些信息补完整，就已经足以让 agent 分阶段做出较完整的平台：

1. 赛事规则
   • 支持哪些赛制、组别、计分方式、同分规则
2. 支付与退款规则
   • 退款时限、手续费承担、结算周期、抽佣规则
3. 审核规则
   • 商户和赛事的审核标准、驳回原因模板、白名单机制
4. 页面字段与表单项
   • 各页面要展示哪些字段、各表单必填项是什么
5. 接口字段细节
   • 请求参数、返回字段、错误码、分页与筛选条件
6. 技术选型
   • 前端框架、后端语言、数据库、部署环境

8. 下一步建议

1. 先补齐 10-项目执行/模块实施总任务单.md 中每个任务的具体业务细节。
2. 用 10-项目执行/Agent任务派发模板.md 把任务逐批交给 agent 执行。
3. 开发完成后按 11-项目验收/ 目录逐项做联调、验收与上线检查。