项目初始化

10-项目执行/Agent任务派发模板.md

@@ -0,0 +1,35 @@
+# Agent 任务派发模板
+
+## 1. 使用目标
+提供一套可直接复制给 agent 的任务描述模板，减少每次派发任务时重复组织上下文。
+
+## 2. 模板示例
+```markdown
+请基于以下文档实现一个模块：
+
+模块名称：
+目标工程：微信小程序 / 商户后台 / 管理后台 / 后台 API
+任务范围：
+相关文档：
+- 01-基础与总览/... 或 02-用户侧流程/... 
+- 05-通用基础/... 或 09-后台API说明/... 
+- 10-项目执行/... 
+
+需要完成：
+1. 
+2. 
+3. 
+
+验收标准：
+- 
+- 
+
+注意事项：
+- 不要偏离当前文档定义的字段和状态
+- 如遇未确认规则，先回写待确认项
+```
+
+## 3. 推荐用法
+- 一次只发一个模块或一个子任务。
+- 带上最少但足够的上下文文档路径。
+- 明确是否需要同时补测试和文档。

10-项目执行/Agent开发交接清单.md

@@ -0,0 +1,33 @@
+# Agent 开发交接清单
+
+## 1. 文档目标
+当业务内容补充完成后，本文件可作为交给开发 agent 的统一入口，减少 agent 自行猜测范围。
+
+## 2. 交接前必须补齐的信息
+- 赛事规则与计分模型
+- 支付与退款规则
+- 商户审核与赛事审核规则
+- 关键页面字段与表单项
+- 角色权限与可见范围
+- API 返回字段和错误码细节
+
+## 3. 推荐交接顺序
+1. 先让 agent 阅读 `README.md`
+2. 再阅读 `01-基础与总览/`、`02-用户侧流程/`、`03-商户侧流程/`、`04-平台治理流程/`
+3. 然后阅读 `05-通用基础/`、`06-微信小程序说明/`、`07-商户后台说明/`、`08-管理后台说明/`、`09-后台API说明/`
+4. 最后根据模块拆任务：小程序、商户后台、管理后台、后台 API
+
+## 4. 推荐任务拆分方式
+- 第 1 批：初始化项目骨架与基础配置
+- 第 2 批：登录鉴权、基础数据模型
+- 第 3 批：赛事与报名主链路
+- 第 4 批：支付退款、成绩排名
+- 第 5 批：报表、通知、运维能力
+
+## 5. 交接标准
+满足以下条件后，就可以较稳妥地交给 agent 开发：
+- 关键流程都有独立文档
+- 主要状态流转已确认
+- 角色权限矩阵已确认
+- 数据模型与接口规范已有初稿
+- 待确认事项已有明确结论或优先级

10-项目执行/README.md

@@ -0,0 +1,25 @@
+# 项目执行
+
+本目录用于沉淀项目推进、任务拆分、版本规划和 agent 派发执行相关文档。
+
+## 建议阅读顺序
+1. `执行总览与使用方式.md`
+2. `里程碑与版本规划.md`
+3. `模块任务拆解建议.md`
+4. `模块实施总任务单.md`
+5. 按需进入各端实施任务单
+
+## 当前包含文档
+- `执行总览与使用方式.md`
+- `里程碑与版本规划.md`
+- `模块任务拆解建议.md`
+- `模块实施总任务单.md`
+- `微信小程序实施任务单.md`
+- `商户后台实施任务单.md`
+- `管理后台实施任务单.md`
+- `后台API实施任务单.md`
+- `风险清单与依赖项.md`
+- `部署与环境规划.md`
+- `Agent开发交接清单.md`
+- `Agent任务派发模板.md`
+- `周计划与状态跟踪模板.md`

10-项目执行/后台API实施任务单.md

@@ -0,0 +1,28 @@
+# 后台 API 实施任务单
+
+## 1. 实施目标
+完成支撑三端业务的核心服务，包括认证、赛事、报名、支付退款、成绩、通知与报表能力。
+
+## 2. 模块任务
+| 编号 | 任务 | 主要产出 | 依赖文档 | 优先级 |
+| --- | --- | --- | --- | --- |
+| API-01 | 初始化后端工程 | 项目骨架、配置管理、日志、异常处理 | `系统架构总览.md` | P0 |
+| API-02 | 认证与鉴权 | 登录、token、权限中间件 | `认证与鉴权方案.md`、`登录鉴权接口字段清单.md` | P0 |
+| API-03 | 商户与赛事域 | 商户入驻、赛事创建、审核流转 | `商户赛事管理接口字段清单.md` | P0 |
+| API-04 | 报名与订单域 | 报名提交、订单创建、状态更新 | `用户报名相关接口字段清单.md` | P0 |
+| API-05 | 支付与退款域 | 支付拉起、回调、退款处理 | `支付退款接口字段清单.md` | P1 |
+| API-06 | 成绩与排名域 | 成绩导入、排名计算、发布查询 | `成绩与排名接口字段清单.md` | P1 |
+| API-07 | 通知与上传 | 消息通知、文件上传、字典配置 | `消息通知接口字段清单.md`、`文件上传接口字段清单.md` | P1 |
+| API-08 | 结算与报表 | 结算单、对账结果、运营报表接口 | `结算对账接口字段清单.md`、`平台审核与运营接口字段清单.md` | P2 |
+
+## 3. 验收标准
+- 三端接口可按文档正常调用。
+- 核心状态流转一致，非法状态跳转被拦截。
+- 支付回调、退款回调、消息发送具备幂等与日志。
+- 基础测试可覆盖主流程和关键异常。
+
+## 4. 交给 agent 的建议拆法
+- 第 1 批：`API-01` + `API-02`
+- 第 2 批：`API-03` + `API-04`
+- 第 3 批：`API-05` + `API-06`
+- 第 4 批：`API-07` + `API-08`

10-项目执行/周计划与状态跟踪模板.md

@@ -0,0 +1,18 @@
+# 周计划与状态跟踪模板
+
+## 本周目标
+- 
+
+## 本周计划
+| 模块 | 负责人/Agent | 目标 | 状态 |
+| --- | --- | --- | --- |
+| 示例：小程序报名页 | Agent-A | 完成报名页联调 | 进行中 |
+
+## 风险与阻塞
+- 
+
+## 需确认事项
+- 
+
+## 下周计划
+- 

10-项目执行/商户后台实施任务单.md

@@ -0,0 +1,27 @@
+# 商户后台实施任务单
+
+## 1. 实施目标
+完成商户端从“提交入驻 → 创建赛事 → 管理报名 → 录入成绩”的核心管理能力。
+
+## 2. 模块任务
+| 编号 | 任务 | 主要产出 | 依赖文档 | 优先级 |
+| --- | --- | --- | --- | --- |
+| MB-01 | 初始化商户后台工程 | 项目骨架、布局、权限框架 | `README.md`、`功能模块清单.md` | P0 |
+| MB-02 | 商户资料与入驻能力 | 商户资料页、入驻表单、提审能力 | `商户入驻流程.md`、`表单字段与导出说明.md` | P0 |
+| MB-03 | 赛事管理能力 | 赛事列表、创建编辑页、提审能力 | `赛事编辑页字段说明.md` | P0 |
+| MB-04 | 报名管理能力 | 报名查询、导出名单、核销签到 | `报名管理页字段说明.md` | P1 |
+| MB-05 | 成绩录入与发布 | 成绩录入页、发布结果、重算排名 | `成绩录入页字段说明.md` | P1 |
+| MB-06 | 财务与退款查看 | 订单列表、退款状态查询 | `支付退款接口字段清单.md` | P2 |
+| MB-07 | 子账号与权限管理 | 账号管理页、角色授权 | `角色与权限矩阵.md` | P2 |
+
+## 3. 验收标准
+- 商户能提交入驻资料并查看审核状态。
+- 商户能创建赛事草稿并提交审核。
+- 报名列表支持筛选、导出、签到核销。
+- 成绩可录入、校验并发布。
+
+## 4. 交给 agent 的建议拆法
+- 第 1 批：`MB-01` + `MB-02`
+- 第 2 批：`MB-03`
+- 第 3 批：`MB-04` + `MB-05`
+- 第 4 批：`MB-06` + `MB-07`

10-项目执行/微信小程序实施任务单.md

@@ -0,0 +1,27 @@
+# 微信小程序实施任务单
+
+## 1. 实施目标
+完成用户端从“浏览赛事 → 报名支付 → 查看报名 → 查看成绩”的核心闭环。
+
+## 2. 模块任务
+| 编号 | 任务 | 主要产出 | 依赖文档 | 优先级 |
+| --- | --- | --- | --- | --- |
+| MP-01 | 初始化小程序工程 | 项目骨架、路由、公共请求层 | `页面清单与路由草案.md` | P0 |
+| MP-02 | 完成登录与用户态 | 登录页、token 管理、用户信息存储 | `登录鉴权接口字段清单.md` | P0 |
+| MP-03 | 实现首页与赛事列表 | 首页、列表页、筛选与分页 | `首页字段说明.md`、`赛事列表页字段说明.md` | P0 |
+| MP-04 | 实现赛事详情与报名页 | 详情页、表单页、校验逻辑 | `赛事详情页字段说明.md`、`报名填写页字段说明.md` | P0 |
+| MP-05 | 接入支付结果流程 | 支付拉起、结果页、失败重试 | `支付结果页字段说明.md`、`支付退款接口字段清单.md` | P1 |
+| MP-06 | 实现我的报名与成绩页 | 报名记录、成绩详情、状态展示 | `我的报名页字段说明.md`、`成绩详情页字段说明.md` | P1 |
+| MP-07 | 接入通知中心 | 消息列表、已读状态 | `消息通知接口字段清单.md` | P2 |
+
+## 3. 验收标准
+- 用户可以完整完成一次报名支付。
+- 我的报名能够正确展示待支付、已报名、已退款状态。
+- 成绩发布后，用户可查看自己的成绩和排名。
+- 关键异常有明确提示，不出现白屏或无响应。
+
+## 4. 交给 agent 的建议拆法
+- 第 1 批：`MP-01` + `MP-02`
+- 第 2 批：`MP-03` + `MP-04`
+- 第 3 批：`MP-05` + `MP-06`
+- 第 4 批：`MP-07` + 样式与体验优化

10-项目执行/执行总览与使用方式.md

@@ -0,0 +1,22 @@
+# 执行总览与使用方式
+
+## 1. 文档目标
+说明本项目在进入实施阶段后，如何使用本目录中的文档推进开发、联调和发布。
+
+## 2. 推荐执行顺序
+1. 先阅读 `里程碑与版本规划.md`，明确当前阶段目标。
+2. 再阅读 `模块实施总任务单.md`，确定优先模块。
+3. 然后从对应端的实施任务单中挑选一个具体任务交给 agent。
+4. 开发完成后同步更新状态、风险与依赖项。
+5. 进入联调后转到 `11-项目验收/` 目录执行验收流程。
+
+## 3. 使用原则
+- 一次只交付一个明确任务给 agent。
+- 每个任务都要有输入文档、输出物和验收标准。
+- 若业务规则未定，先补文档再开发。
+- 每轮实施后同步记录进展与阻塞项。
+
+## 4. 与其他目录的关系
+- 业务依据来自 `01-基础与总览/`、`02-用户侧流程/`、`03-商户侧流程/`、`04-平台治理流程/`
+- 技术依据来自 `05-通用基础/`、`06-微信小程序说明/`、`07-商户后台说明/`、`08-管理后台说明/`、`09-后台API说明/`
+- 验收依据来自 `11-项目验收/`

10-项目执行/模块任务拆解建议.md

@@ -0,0 +1,36 @@
+# 模块任务拆解建议
+
+## 1. 文档目标
+为后续把需求拆给 agent 提供任务颗粒度建议，避免一次性给过大需求。
+
+## 2. 推荐拆法
+### 小程序
+- 登录与基础框架
+- 赛事列表与详情
+- 报名与支付
+- 我的报名与成绩查询
+
+### 商户后台
+- 登录与权限
+- 商户资料与入驻
+- 赛事管理
+- 报名与成绩管理
+
+### 管理后台
+- 审核中心
+- 报表中心
+- 异常处理与系统配置
+
+### 后台 API
+- 用户与认证
+- 商户与赛事
+- 报名与订单
+- 支付退款与通知
+- 成绩与报表
+
+## 3. 对应实施任务单
+- 小程序：`微信小程序实施任务单.md`
+- 商户后台：`商户后台实施任务单.md`
+- 管理后台：`管理后台实施任务单.md`
+- 后台 API：`后台API实施任务单.md`
+- 联调上线：`../11-项目验收/联调测试与上线任务单.md`

10-项目执行/模块实施总任务单.md

@@ -0,0 +1,32 @@
+# 模块实施总任务单
+
+## 1. 文档目标
+将射箭赛事平台的实施工作拆成可分配、可验收、可交给 agent 执行的任务单，作为后续开发排期和协作入口。
+
+## 2. 模块划分
+| 模块 | 对应工程 | 核心范围 |
+| --- | --- | --- |
+| 用户端 | 微信小程序 | 登录、赛事浏览、报名支付、成绩查询 |
+| 商户端 | 商户后台 | 入驻、赛事管理、报名管理、成绩录入 |
+| 平台端 | 管理后台 | 商户审核、赛事审核、报表、异常工单 |
+| 服务端 | 后台 API | 认证鉴权、业务接口、支付退款、通知、报表 |
+| 联调交付 | 全部工程 | 联调、测试、上线准备、验收 |
+
+## 3. 推荐实施顺序
+1. 后台 API 基础能力
+2. 微信小程序主链路
+3. 商户后台核心管理能力
+4. 管理后台审核与报表能力
+5. 联调、测试、上线准备
+
+## 4. 推荐交给 agent 的执行方式
+- 每次只派发一个模块或一个子任务。
+- 每个子任务需带明确输入文档、预期产出、验收标准。
+- 开发后必须同步更新文档与测试结果。
+
+## 5. 关联任务单
+- `微信小程序实施任务单.md`
+- `商户后台实施任务单.md`
+- `管理后台实施任务单.md`
+- `后台API实施任务单.md`
+- `../11-项目验收/联调测试与上线任务单.md`

10-项目执行/管理后台实施任务单.md

@@ -0,0 +1,25 @@
+# 管理后台实施任务单
+
+## 1. 实施目标
+完成平台运营端对商户、赛事、异常与报表的管理能力。
+
+## 2. 模块任务
+| 编号 | 任务 | 主要产出 | 依赖文档 | 优先级 |
+| --- | --- | --- | --- | --- |
+| AD-01 | 初始化管理后台工程 | 管理台骨架、权限菜单、通用列表组件 | `功能模块清单.md` | P0 |
+| AD-02 | 商户审核模块 | 审核列表、详情、通过/驳回操作 | `商户审核页字段说明.md` | P0 |
+| AD-03 | 赛事审核模块 | 赛事审核列表、详情、风险标签 | `赛事审核页字段说明.md` | P0 |
+| AD-04 | 报表总览模块 | 平台关键指标看板与趋势图 | `报表总览页字段说明.md` | P1 |
+| AD-05 | 异常工单模块 | 工单列表、分派、处理和结案 | `异常工单页字段说明.md` | P1 |
+| AD-06 | 系统配置与字典 | 基础字典、公告、配置维护 | `字典与配置接口字段清单.md` | P2 |
+
+## 3. 验收标准
+- 平台可完成商户和赛事的审核闭环。
+- 审核结论、驳回原因和日志可追溯。
+- 报表可展示核心经营指标。
+- 异常工单能分派、处理并留痕。
+
+## 4. 交给 agent 的建议拆法
+- 第 1 批：`AD-01` + `AD-02`
+- 第 2 批：`AD-03` + `AD-04`
+- 第 3 批：`AD-05` + `AD-06`

10-项目执行/部署与环境规划.md

@@ -0,0 +1,27 @@
+# 部署与环境规划
+
+## 1. 文档目标
+提前规划开发、测试、预发、生产环境的用途和差异，方便后续初始化工程和部署流水线。
+
+## 2. 环境建议
+| 环境 | 用途 |
+| --- | --- |
+| dev | 日常开发联调 |
+| test | 测试验证、接口回归 |
+| staging | 预发布演练 |
+| prod | 正式线上环境 |
+
+## 3. 配置建议
+- 不同环境应隔离数据库、缓存、对象存储配置。
+- 第三方密钥应通过环境变量或密钥管理系统注入。
+- 日志级别、域名、回调地址需按环境隔离。
+
+## 4. 部署关注点
+- 后台 API 需支持滚动发布或平滑重启。
+- 商户后台和管理后台建议支持静态资源版本化。
+- 小程序版本需有提审、灰度、正式发布流程。
+
+## 5. 待确认项
+- 云服务商与部署方式。
+- 是否引入容器化与 CI/CD。
+- 是否需要多地域或灾备。

10-项目执行/里程碑与版本规划.md

@@ -0,0 +1,18 @@
+# 里程碑与版本规划
+
+## 1. 目标
+将整个平台建设拆成多个版本，便于分阶段交付与 agent 分批开发。
+
+## 2. 建议版本
+| 版本 | 范围 |
+| --- | --- |
+| V0.1 | 文档定稿、工程初始化、登录鉴权 |
+| V0.2 | 商户入驻、赛事发布、用户报名 |
+| V0.3 | 支付退款、成绩录入与发布 |
+| V0.4 | 报表、通知、风控、运维能力 |
+
+## 3. 每个版本建议输出
+- 可运行的代码
+- 对应测试结果
+- 已更新的文档
+- 已知问题与待办清单

10-项目执行/风险清单与依赖项.md

@@ -0,0 +1,17 @@
+# 风险清单与依赖项
+
+## 1. 风险清单
+- 赛事规则复杂度高，可能影响数据模型和成绩计算实现。
+- 支付与退款链路涉及资金安全，需谨慎验证。
+- 多角色权限边界不清时，容易导致接口返工。
+- 技术栈未定前，工程初始化存在不确定性。
+
+## 2. 外部依赖
+- 微信登录与支付能力
+- 云存储与短信服务
+- 部署环境与域名证书
+- 运营审核规则与风控策略
+
+## 3. 管理建议
+- 对高风险模块先做 PoC 或最小可行实现。
+- 对未确认规则，必须先落文档再开发。