项目初始化

This commit is contained in:
kron
2026-04-07 16:15:59 +08:00
commit 852e522695
97 changed files with 3137 additions and 0 deletions

View File

@@ -0,0 +1,9 @@
# 商户侧流程
本目录聚焦商户入驻、赛事发布与成绩管理相关流程。
## 包含内容
- `商户入驻流程.md`
- `赛事创建与发布流程.md`
- `成绩录入与排名流程.md`
- `赛事规则与计分模型.md`

View File

@@ -0,0 +1,59 @@
# 商户入驻流程
## 1. 文档目标
说明赛事主办方如何注册商户账号、提交入驻资料并通过平台审核,获得后续创建赛事和经营后台的资格。
## 2. 参与角色
| 角色 | 职责 |
| --- | --- |
| 商户管理员 | 注册账号、填写机构资料、提交资质 |
| 平台审核员 | 审核商户主体信息与资质材料 |
| 后台 API | 保存资料、驱动状态流转、记录日志 |
## 3. 主流程
1. 商户注册后台账号。
2. 填写机构基础信息:机构名称、联系人、联系电话、地址等。
3. 上传资质材料:营业执照、负责人信息、赛事组织相关证明。
4. 提交入驻申请。
5. 平台审核员进行初审与复核。
6. 审核通过后,商户状态变为“已入驻”,可进入商户后台继续创建赛事。
## 4. 异常分支
- 资料不完整:退回补充。
- 资质无效、过期或不清晰:驳回申请。
- 重复申请:提示已有主体记录,进入人工处理。
- 长时间未处理:进入运营待办提醒。
## 5. 状态流转
| 状态 | 说明 |
| --- | --- |
| 未入驻 | 尚未提交申请 |
| 待补充 | 信息未填完或被要求补充 |
| 待审核 | 已提交,等待平台审核 |
| 已驳回 | 审核未通过,需修改后重提 |
| 已入驻 | 审核通过,可正式使用商户后台 |
| 已停用 | 因违规或异常被平台停用 |
## 6. 关键数据字段
- 商户ID
- 机构名称
- 联系人姓名/电话
- 营业执照号
- 资质图片
- 审核状态
- 驳回原因
- 提交时间/审核时间
## 7. 风险与控制点
- 入驻审核需保留完整操作日志。
- 资质材料建议支持结构化校验与人工复核。
- 商户启用/停用属于高风险操作,需留痕。
## 8. 关联文档
- `赛事创建与发布流程.md`
- `../07-商户后台说明/README.md`
## 9. 待确认事项
- 商户是否允许多个子账号协作。
- 是否支持不同类型主体(公司/个体/协会)入驻。
- 是否需要签署电子协议后才算正式入驻。

View File

@@ -0,0 +1,35 @@
# 成绩录入与排名流程
## 1. 文档目标
明确商户如何录入比赛成绩、系统如何生成排名,以及成绩发布后的查看与申诉处理规则。
## 2. 参与角色
- 商户管理员 / 裁判录入员
- 后台 API
- 参赛用户
- 平台运营(处理异常申诉)
## 3. 主流程
1. 赛事结束或某轮次结束后,商户进入成绩管理页面。
2. 按组别/场次录入选手成绩。
3. 系统校验数据完整性与格式合法性。
4. 系统按规则生成排名结果。
5. 商户确认无误后提交发布。
6. 用户在小程序查看成绩与排名。
## 4. 异常场景
- 成绩缺失或重复录入。
- 成绩与参赛名单不匹配。
- 排名规则调整后需重新计算。
- 用户提出成绩申诉,需重新审核。
## 5. 关键状态
| 对象 | 状态 |
| --- | --- |
| 成绩记录 | 草稿 / 已提交 / 已发布 / 已作废 |
| 申诉单 | 待处理 / 处理中 / 已解决 |
## 6. 待确认事项
- 是否支持 Excel 批量导入成绩。
- 是否支持多轮成绩、淘汰赛对阵与晋级逻辑。
- 成绩发布前是否需要平台复核。

View File

@@ -0,0 +1,64 @@
# 赛事创建与发布流程
## 1. 文档目标
说明商户在通过入驻审核后,如何在商户后台创建赛事、配置报名规则并提交平台审核,最终完成赛事发布。
## 2. 参与角色
| 角色 | 职责 |
| --- | --- |
| 商户管理员 | 创建赛事、编辑信息、提交审核 |
| 商户子账号 | 在授权范围内协助编辑赛事 |
| 平台审核员 | 审核赛事内容与合规性 |
| 后台 API | 保存数据、校验规则、驱动状态流转 |
## 3. 前置条件
- 商户已完成入驻并处于“已启用”状态。
- 商户具备赛事创建权限。
- 平台已配置可用的赛事类目、审核规则和基础字典。
## 4. 主流程
1. 商户进入“赛事管理”页面并点击“创建赛事”。
2. 填写基础信息:赛事名称、封面、地点、时间、联系人、简介。
3. 配置报名规则:报名时间、人数上限、组别、费用、退款规则。
4. 配置扩展内容:报名表单、参赛须知、证书/奖项说明。
5. 保存草稿并预览展示效果。
6. 提交平台审核。
7. 平台审核通过后,赛事进入“已发布/报名中”状态。
8. 用户可在微信小程序中查看并报名。
## 5. 异常分支
- 基础信息缺失:系统阻止提交审核。
- 报名截止时间晚于开赛时间:校验不通过。
- 审核驳回:商户根据驳回原因修改后重新提交。
- 发布后出现重大问题:平台可强制下架或关闭报名。
## 6. 状态流转
| 状态 | 说明 |
| --- | --- |
| 草稿 | 编辑中,用户不可见 |
| 待审核 | 已提交,等待平台审核 |
| 审核驳回 | 需修改后再次提交 |
| 已发布 | 用户可见,可报名 |
| 已关闭 | 手动关闭或平台关闭 |
| 已结束 | 赛事已完赛 |
## 7. 关键数据字段
- 赛事ID
- 商户ID
- 赛事名称
- 开赛时间/结束时间
- 报名开始/结束时间
- 组别配置
- 报名费用
- 退款规则
- 审核状态/驳回原因
## 8. 规则与控制点
- 提交审核后,涉及价格、时间、组别的修改需重新审核。
- 已有报名记录后,应限制高风险字段直接修改。
- 所有审核和发布动作都需记录操作日志。
## 9. 待确认事项
- 是否支持平台代商户发布赛事。
- 是否支持无需审核直接发布的白名单商户。
- 是否允许赛事复制创建。

View File

@@ -0,0 +1,29 @@
# 赛事规则与计分模型
## 1. 文档目标
梳理射箭赛事在平台中的规则抽象方式,为赛事配置、成绩录入、排名计算和前端展示提供统一依据。
## 2. 建议抽象维度
| 维度 | 说明 |
| --- | --- |
| 赛事类型 | 个人赛、团体赛、公开赛、邀请赛 |
| 赛制 | 单轮累计、双轮累计、淘汰赛、积分赛 |
| 组别 | 年龄组、性别组、弓种组、等级组 |
| 轮次 | 资格赛、晋级赛、决赛 |
| 计分方式 | 总分制、命中环数、加权分 |
## 3. 基础规则建议
- 每个赛事至少包含一个组别。
- 每个组别需要配置人数上限、报名费、参赛要求。
- 成绩计算规则应独立配置,避免写死在代码中。
- 排名规则需明确同分处理方式。
## 4. 计分模型建议
- 原始成绩:每轮每箭的基础得分。
- 汇总成绩:按轮次累计得到总分。
- 排名结果:按总分排序,必要时结合附加规则打破平分。
## 5. 待确认事项
- 是否支持复杂赛制,如多轮晋级、淘汰对阵。
- 是否需要按协会/地区赛规则做模板化配置。
- 是否支持团体积分与个人积分并存。