项目初始化

01-基础与总览/README.md

@@ -0,0 +1,9 @@
+# 基础与总览
+
+本目录存放项目的全局认知文档，建议最先阅读。
+
+## 包含内容
+- `核心业务流程总览.md`
+- `角色与场景地图.md`
+- `业务名词表.md`
+- `业务规则待确认清单.md`

01-基础与总览/业务名词表.md

@@ -0,0 +1,18 @@
+# 业务名词表
+
+| 名词 | 定义 |
+| --- | --- |
+| 商户 | 入驻平台、负责举办赛事的机构或个人主体 |
+| 平台运营 | 负责审核、风控、运营管理的后台人员 |
+| 赛事 | 一次可独立报名的比赛活动 |
+| 场次 | 同一赛事下的时间段或赛程安排 |
+| 组别 | 依据年龄、性别、弓种、水平等划分的参赛类别 |
+| 报名单 | 用户提交报名后的业务记录 |
+| 订单 | 与报名费用对应的支付单据 |
+| 成绩单 | 比赛结束后记录选手得分与排名的数据 |
+| 审核状态 | 商户或赛事在平台审核中的业务状态 |
+| 退款单 | 对已支付订单发起退款后的记录 |
+
+## 使用原则
+- 新增业务文档时，优先复用本词表中的定义。
+- 若新增术语，请同步补充到本文件，避免不同文档描述不一致。

01-基础与总览/业务规则待确认清单.md

@@ -0,0 +1,32 @@
+# 业务规则待确认清单
+
+## 1. 文档目标
+集中记录当前仍未拍板的关键业务规则，方便产品负责人逐项补充，避免 agent 在开发时自行猜测。
+
+## 2. 赛事规则类
+- 是否支持团体赛、淘汰赛、多轮晋级。
+- 是否支持不同弓种的规则模板。
+- 同分排名的处理方式如何定义。
+
+## 3. 报名与支付类
+- 是否允许代报名、多人一单、候补报名。
+- 支付超时时长是多少。
+- 是否允许部分退款，手续费谁承担。
+
+## 4. 商户与审核类
+- 商户入驻是否必须人工审核。
+- 是否有白名单商户可免审核发布赛事。
+- 商户是否支持多子账号、多角色协作。
+
+## 5. 数据与隐私类
+- 成绩是否公开展示。
+- 用户隐私字段哪些对商户可见。
+- 日志与数据保留多久。
+
+## 6. 运营与结算类
+- 平台抽佣规则。
+- 商户结算周期与打款方式。
+- 是否需要营销活动、优惠券、邀请码等能力。
+
+## 7. 使用方式
+建议后续每次补全一个规则时，直接在本文件记录“最终决定 + 生效时间 + 影响文档”。

01-基础与总览/核心业务流程总览.md

@@ -0,0 +1,50 @@
+# 核心业务流程总览
+
+## 1. 文档目标
+本文件用于统一描述“射箭赛事平台”的核心业务闭环，作为后续产品设计、接口设计、前后端开发和测试用例编写的基础。
+
+## 2. 平台角色
+| 角色 | 说明 | 主要目标 |
+| --- | --- | --- |
+| 用户 | 使用微信小程序报名参赛的个人用户 | 浏览赛事、报名、支付、查看成绩 |
+| 商户 | 赛事主办方/入驻机构 | 入驻平台、创建赛事、管理报名、录入成绩 |
+| 平台运营 | 平台管理人员 | 审核商户、审核赛事、处理异常、查看报表 |
+| 系统服务 | 后台 API、消息、支付等能力 | 提供鉴权、订单、通知、成绩、数据支持 |
+
+## 3. 核心业务闭环
+1. 商户申请入驻并提交资质。
+2. 平台审核通过后，商户可创建并发布赛事。
+3. 用户在微信小程序浏览赛事并完成报名支付。
+4. 商户进行现场签到、成绩录入与排名确认。
+5. 平台与商户查看报表、处理退款或异常申诉。
+
+## 4. 核心对象
+| 对象 | 说明 |
+| --- | --- |
+| 商户 | 赛事组织方主体信息与资质 |
+| 赛事 | 一场可报名的比赛活动 |
+| 场次/组别 | 比赛时间段、年龄组、性别组、弓种等 |
+| 报名单 | 用户针对某赛事提交的报名记录 |
+| 订单 | 对应报名费用的支付单据 |
+| 成绩单 | 用户参赛后的分数与排名数据 |
+| 退款单 | 报名取消、赛事关闭等场景产生的退款记录 |
+
+## 5. 建议拆分的详细流程文档
+- `../02-用户侧流程/用户报名参赛流程.md`
+- `../03-商户侧流程/商户入驻流程.md`
+- `../03-商户侧流程/赛事创建与发布流程.md`
+- `../02-用户侧流程/支付流程.md`
+- `../02-用户侧流程/退款流程.md`
+- `../03-商户侧流程/成绩录入与排名流程.md`
+- `../04-平台治理流程/平台审核与运营流程.md`
+
+## 6. 当前业务边界
+- 当前先聚焦中国大陆微信生态。
+- 支持微信登录、微信支付。
+- 暂不展开直播、社群、积分商城等扩展能力。
+- 技术栈未定，本文档仅约束业务和系统边界。
+
+## 7. 待确认事项
+- 是否支持团体赛、淘汰赛、分轮晋级等复杂赛制。
+- 平台是否抽佣，商户结算周期如何定义。
+- 成绩是否公开展示给所有用户，还是仅报名用户可见。

01-基础与总览/角色与场景地图.md

@@ -0,0 +1,48 @@
+# 角色与场景地图
+
+## 1. 文档目标
+从角色视角梳理平台的核心使用场景，帮助后续产品设计、页面设计与权限设计保持一致。
+
+## 2. 主要角色
+| 角色 | 使用端 | 核心目标 |
+| --- | --- | --- |
+| 普通用户 | 微信小程序 | 找到合适赛事、完成报名、查看成绩 |
+| 商户管理员 | 商户后台 | 入驻平台、发布赛事、管理报名和成绩 |
+| 商户子账号 | 商户后台 | 协助处理赛事执行、报名核销、成绩录入 |
+| 平台审核员 | 管理后台 | 审核商户、审核赛事、处理异常 |
+| 平台运营管理员 | 管理后台 | 运营配置、报表分析、风险控制 |
+
+## 3. 角色核心场景
+
+### 3.1 用户场景
+- 浏览赛事列表与详情
+- 报名并支付
+- 查看报名记录与参赛信息
+- 查看成绩与排名
+- 发起退款或申诉（如支持）
+
+### 3.2 商户场景
+- 提交入驻资料
+- 创建赛事并提审
+- 维护赛事配置与组别信息
+- 核销签到、录入成绩、导出名单
+- 查看订单、退款与运营数据
+
+### 3.3 平台场景
+- 审核商户与赛事
+- 处理异常订单与争议退款
+- 下架违规赛事、停用异常商户
+- 查看平台数据报表与经营指标
+
+## 4. 场景阶段地图
+| 阶段 | 用户 | 商户 | 平台 |
+| --- | --- | --- | --- |
+| 筹备阶段 | 浏览赛事信息 | 入驻、创建赛事 | 审核商户和赛事 |
+| 报名阶段 | 提交报名并支付 | 查看报名情况、准备赛事 | 监控报名、处理异常 |
+| 比赛阶段 | 到场参赛 | 核销签到、录入成绩 | 巡检与处理问题 |
+| 赛后阶段 | 查看成绩、退款/申诉 | 发布成绩、对账结算 | 复核投诉、看报表 |
+
+## 5. 输出给设计与开发的价值
+- 可作为页面清单与权限矩阵的上游依据。
+- 可为测试场景设计提供角色视角。
+- 可作为 agent 拆解任务时的功能边界说明。