项目初始化

07-商户后台说明/README.md

@@ -0,0 +1,30 @@
+# 商户后台说明
+
+## 1. 定位
+面向赛事主办方，承担商户入驻资料维护、赛事创建发布、报名管理、成绩录入、数据导出等能力。
+
+## 2. 建议核心模块
+- 商户资料管理
+- 赛事管理
+- 报名管理
+- 成绩管理
+- 数据导出
+- 账户与子账号管理
+
+## 3. 关键规则
+- 只能访问本商户数据。
+- 提交审核后的赛事需限制高风险修改。
+- 重要操作应保留操作日志。
+
+## 4. 相关细分文档
+- `功能模块清单.md`
+- `页面清单与操作路径.md`
+- `表单字段与导出说明.md`
+- `工作台页面字段说明.md`
+- `赛事编辑页字段说明.md`
+- `报名管理页字段说明.md`
+- `成绩录入页字段说明.md`
+
+## 5. 待确认项
+- 是否支持 Excel 批量导入参赛名单。
+- 是否支持多子账号按模块授权。

07-商户后台说明/功能模块清单.md

@@ -0,0 +1,27 @@
+# 功能模块清单
+
+## 1. 目标
+用于拆分商户后台的核心页面与功能模块，便于后续前端开发和权限设计。
+
+## 2. 建议模块
+| 模块 | 说明 |
+| --- | --- |
+| 首页工作台 | 查看待处理事项、报名数据、赛事概览 |
+| 商户资料管理 | 维护商户信息、资质信息、联系人信息 |
+| 赛事管理 | 创建、编辑、提交审核、关闭赛事 |
+| 报名管理 | 查看报名列表、核销签到、导出名单 |
+| 成绩管理 | 录入成绩、发布排名、处理成绩修正 |
+| 财务与退款 | 查看订单、申请退款、对账 |
+| 账号权限 | 子账号管理、角色授权、日志查看 |
+
+## 3. 页面拆分建议
+- 赛事列表页
+- 赛事编辑页
+- 报名详情页
+- 成绩录入页
+- 数据导出页
+- 账户权限页
+
+## 4. 开发建议
+- 表格类页面优先支持筛选、分页、导出。
+- 所有关键操作建议增加二次确认与操作日志。

07-商户后台说明/工作台页面字段说明.md

@@ -0,0 +1,24 @@
+# 工作台页面字段说明
+
+## 1. 页面信息
+- 页面名称：工作台
+- 页面目标：展示赛事概览、待处理事项和关键经营数据。
+
+## 2. 展示字段
+| 字段 | 说明 |
+| --- | --- |
+| totalEventCount | 赛事总数 |
+| signupTodayCount | 今日报名人数 |
+| paidTodayAmount | 今日支付金额 |
+| pendingRefundCount | 待处理退款数 |
+| pendingReviewEventCount | 待审核赛事数 |
+| recentNoticeList | 最近通知列表 |
+
+## 3. 操作入口
+- 去创建赛事
+- 查看报名管理
+- 查看成绩管理
+- 查看退款处理
+
+## 4. 待确认项
+- 是否展示趋势图和快捷统计卡片。

07-商户后台说明/成绩录入页字段说明.md

@@ -0,0 +1,37 @@
+# 成绩录入页字段说明
+
+## 1. 页面信息
+- 页面名称：成绩录入页
+- 页面目标：录入成绩、校验结果并发布排名。
+
+## 2. 筛选字段
+- 赛事
+- 组别
+- 场次/轮次
+
+## 3. 列表字段
+| 字段 | 说明 |
+| --- | --- |
+| participantName | 选手姓名 |
+| groupName | 组别 |
+| roundScore | 本轮成绩 |
+| totalScore | 总成绩 |
+| rank | 当前排名 |
+| resultStatus | 成绩状态 |
+| updatedAt | 最后更新时间 |
+
+## 4. 操作按钮
+- 批量导入
+- 保存草稿
+- 重新计算排名
+- 发布成绩
+- 作废并重录
+
+## 5. 校验规则
+- 成绩值必须在合法区间内。
+- 未录全的选手不可直接发布。
+- 发布后修改需保留操作记录。
+
+## 6. 待确认项
+- 是否支持 Excel 批量导入。
+- 是否有多轮成绩和淘汰对阵结构。

07-商户后台说明/报名管理页字段说明.md

@@ -0,0 +1,38 @@
+# 报名管理页字段说明
+
+## 1. 页面信息
+- 页面名称：报名管理页
+- 页面目标：查看报名记录、筛选订单状态、执行签到核销和导出名单。
+
+## 2. 筛选字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| eventId | select | 按赛事筛选 |
+| groupId | select | 按组别筛选 |
+| signupStatus | select | 按报名状态筛选 |
+| payStatus | select | 按支付状态筛选 |
+| keyword | input | 搜索姓名/手机号 |
+| signupTimeRange | daterange | 按报名时间筛选 |
+
+## 3. 列表字段
+| 字段 | 说明 |
+| --- | --- |
+| signupId | 报名单ID |
+| participantName | 报名人姓名 |
+| participantPhone | 联系电话 |
+| groupName | 组别 |
+| signupStatus | 报名状态 |
+| payStatus | 支付状态 |
+| amount | 支付金额 |
+| checkinStatus | 签到状态 |
+| signupTime | 报名时间 |
+
+## 4. 操作按钮
+- 查看详情
+- 导出名单
+- 核销签到
+- 补录备注
+
+## 5. 待确认项
+- 是否支持批量核销。
+- 是否支持现场报名补录。

07-商户后台说明/表单字段与导出说明.md

@@ -0,0 +1,22 @@
+# 表单字段与导出说明
+
+## 1. 文档目标
+统一商户后台关键表单和导出字段，避免前后端口径不一致。
+
+## 2. 重点表单
+- 商户入驻表单
+- 赛事创建表单
+- 报名筛选表单
+- 成绩录入表单
+- 退款申请表单
+
+## 3. 导出场景
+| 场景 | 建议导出字段 |
+| --- | --- |
+| 报名名单导出 | 用户名、手机号、组别、支付状态、报名时间 |
+| 成绩导出 | 赛事、组别、选手、得分、排名 |
+| 财务导出 | 订单号、金额、支付时间、退款状态 |
+
+## 4. 待补充项
+- 每个表单的字段类型、校验规则、必填项。
+- 每种导出的权限限制与文件格式。

07-商户后台说明/赛事编辑页字段说明.md

@@ -0,0 +1,50 @@
+# 赛事编辑页字段说明
+
+## 1. 页面信息
+- 页面名称：赛事编辑页
+- 页面目标：创建或编辑赛事，配置报名规则与展示内容。
+
+## 2. 基础信息字段
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| eventName | input | 是 | 赛事名称 |
+| eventCover | upload | 是 | 赛事封面 |
+| eventIntro | textarea | 是 | 赛事简介 |
+| location | input | 是 | 比赛地点 |
+| startTime | datetime | 是 | 开赛时间 |
+| endTime | datetime | 是 | 结束时间 |
+| contactName | input | 是 | 联系人姓名 |
+| contactPhone | input | 是 | 联系电话 |
+
+## 3. 报名配置字段
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| signupStartTime | datetime | 是 | 报名开始时间 |
+| signupEndTime | datetime | 是 | 报名截止时间 |
+| refundRule | textarea | 是 | 退款规则 |
+| noticeText | textarea | 否 | 参赛须知 |
+| groupConfigList | list | 是 | 组别配置列表 |
+
+## 4. 组别配置字段
+- groupName
+- price
+- capacity
+- ageLimit
+- genderLimit
+- bowType
+- ruleSummary
+
+## 5. 操作按钮
+- 保存草稿
+- 预览
+- 提交审核
+- 关闭赛事（编辑已发布赛事时）
+
+## 6. 校验规则
+- 报名截止时间不得晚于开赛时间。
+- 组别至少配置一个。
+- 价格、容量必须大于等于 0。
+
+## 7. 待确认项
+- 是否支持赛事复制创建。
+- 是否支持富文本图文详情。

07-商户后台说明/页面清单与操作路径.md

@@ -0,0 +1,26 @@
+# 页面清单与操作路径
+
+## 1. 目标
+明确商户后台的主要页面及关键操作链路，便于后续前端页面开发和权限拆分。
+
+## 2. 页面清单
+| 页面 | 说明 |
+| --- | --- |
+| 工作台 | 查看赛事概览、待办事项 |
+| 商户资料页 | 编辑机构信息、上传资质 |
+| 赛事列表页 | 查看、筛选、复制、关闭赛事 |
+| 赛事编辑页 | 创建与编辑赛事 |
+| 报名管理页 | 查看报名记录、导出名单、签到核销 |
+| 成绩管理页 | 录入成绩、发布排名 |
+| 财务退款页 | 查看订单、退款申请与处理状态 |
+| 账号权限页 | 管理子账号与授权 |
+
+## 3. 关键操作路径
+- 入驻资料维护 → 提交审核
+- 赛事列表 → 新建赛事 → 提交审核
+- 报名管理 → 导出名单 / 核销签到
+- 成绩管理 → 录入成绩 → 发布结果
+
+## 4. 待补充项
+- 每个页面的筛选字段和操作按钮。
+- 表格列定义与导出字段。