项目初始化

06-微信小程序说明/README.md

@@ -0,0 +1,42 @@
+# 微信小程序说明
+
+## 1. 定位
+面向参赛用户，承担赛事浏览、报名支付、订单查看、成绩查看等用户侧能力。
+
+## 2. 建议核心页面
+- 首页/推荐赛事
+- 赛事列表
+- 赛事详情
+- 报名填写页
+- 支付结果页
+- 我的报名
+- 成绩查询
+- 个人中心
+
+## 3. 关键模块
+- 登录与用户信息
+- 赛事展示
+- 报名表单
+- 订单支付
+- 消息通知
+
+## 4. 与后台 API 的关系
+- 所有业务规则以后台接口返回为准。
+- 小程序主要负责展示、交互和状态提示。
+
+## 5. 相关细分文档
+- `页面与模块划分.md`
+- `页面清单与路由草案.md`
+- `页面字段级说明模板.md`
+- `首页字段说明.md`
+- `赛事列表页字段说明.md`
+- `赛事详情页字段说明.md`
+- `报名填写页字段说明.md`
+- `支付结果页字段说明.md`
+- `我的报名页字段说明.md`
+- `成绩详情页字段说明.md`
+
+## 6. 待确认项
+- 是否需要订阅消息提醒。
+- 是否支持分享裂变与海报功能。
+- 是否需要赛事分享海报、邀请码或活动裂变能力。

06-微信小程序说明/成绩详情页字段说明.md

@@ -0,0 +1,26 @@
+# 成绩详情页字段说明
+
+## 1. 页面信息
+- 页面名称：成绩详情页
+- 页面路径建议：`/pages/mine/result-detail`
+- 页面目标：展示用户在某场赛事中的成绩、排名和分项成绩。
+
+## 2. 展示字段
+| 字段 | 说明 | 来源接口 |
+| --- | --- | --- |
+| eventName | 赛事名称 | `/user/results/{id}` |
+| groupName | 组别 | `/user/results/{id}` |
+| participantName | 选手姓名 | `/user/results/{id}` |
+| totalScore | 总分 | `/user/results/{id}` |
+| rank | 排名 | `/user/results/{id}` |
+| roundScoreList | 分轮成绩 | `/user/results/{id}` |
+| resultStatus | 成绩状态 | `/user/results/{id}` |
+| publishedAt | 发布时间 | `/user/results/{id}` |
+
+## 3. 操作按钮
+- 返回成绩列表
+- 分享成绩（如后续支持）
+- 发起申诉（如后续支持）
+
+## 4. 待确认项
+- 是否展示证书下载、奖项信息。

06-微信小程序说明/我的报名页字段说明.md

@@ -0,0 +1,39 @@
+# 我的报名页字段说明
+
+## 1. 页面信息
+- 页面名称：我的报名页
+- 页面路径建议：`/pages/mine/signup-list`
+- 页面目标：展示用户已报名记录、支付状态、参赛状态和退款状态。
+
+## 2. 列表字段
+| 字段 | 说明 | 来源接口 |
+| --- | --- | --- |
+| signupId | 报名单ID | `/signup/my-list` |
+| eventName | 赛事名称 | `/signup/my-list` |
+| groupName | 报名组别 | `/signup/my-list` |
+| signupStatus | 报名状态 | `/signup/my-list` |
+| payStatus | 支付状态 | `/signup/my-list` |
+| amount | 支付金额 | `/signup/my-list` |
+| eventDate | 比赛日期 | `/signup/my-list` |
+| location | 比赛地点 | `/signup/my-list` |
+| resultStatus | 成绩状态 | `/signup/my-list` |
+| refundStatus | 退款状态 | `/signup/my-list` |
+
+## 3. 操作按钮
+| 按钮 | 条件 | 行为 |
+| --- | --- | --- |
+| 去支付 | 订单待支付 | 跳转支付页 |
+| 查看详情 | 始终显示 | 跳转报名详情页 |
+| 申请退款 | 满足退款规则 | 发起退款流程 |
+| 查看成绩 | 成绩已发布 | 跳转成绩页 |
+
+## 4. 筛选项建议
+- 全部
+- 待支付
+- 已报名
+- 已退款
+- 已结束
+
+## 5. 待确认项
+- 是否需要展示参赛二维码/核销码。
+- 是否允许在列表直接取消报名。

06-微信小程序说明/报名填写页字段说明.md

@@ -0,0 +1,45 @@
+# 报名填写页字段说明
+
+## 1. 页面信息
+- 页面名称：报名填写页
+- 页面路径建议：`/pages/signup/form`
+- 页面目标：收集报名信息、校验资格并提交报名。
+- 前置条件：用户已登录并选择赛事/组别。
+
+## 2. 表单字段
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| eventId | hidden/string | 是 | 当前赛事ID |
+| groupId | select | 是 | 参赛组别 |
+| participantName | input | 是 | 参赛人姓名 |
+| participantPhone | input | 是 | 联系手机号 |
+| gender | select | 否 | 性别（按赛事要求） |
+| birthday | date | 否 | 出生日期（按组别判断年龄） |
+| idCardNo | input | 否 | 身份证号（如后续需要） |
+| clubName | input | 否 | 所属俱乐部/机构 |
+| emergencyContact | input | 否 | 紧急联系人 |
+| emergencyPhone | input | 否 | 紧急联系电话 |
+| remark | textarea | 否 | 备注说明 |
+| agreeProtocol | checkbox | 是 | 同意报名须知与隐私协议 |
+
+## 3. 页面展示字段
+- 赛事名称
+- 组别信息
+- 报名费用
+- 退款规则摘要
+- 报名须知摘要
+
+## 4. 校验规则
+- 手机号格式必须正确。
+- 必填项不可为空。
+- 若赛事配置年龄限制，则需校验出生日期。
+- 未勾选协议时不可提交。
+
+## 5. 提交行为
+- 点击“提交并支付”后，调用报名接口。
+- 成功后生成待支付订单并跳转支付流程。
+- 失败时显示明确错误提示。
+
+## 6. 待确认项
+- 是否支持代他人报名。
+- 是否允许一次填写多个参赛人。

06-微信小程序说明/支付结果页字段说明.md

@@ -0,0 +1,25 @@
+# 支付结果页字段说明
+
+## 1. 页面信息
+- 页面名称：支付结果页
+- 页面路径建议：`/pages/order/result`
+- 页面目标：反馈支付结果并引导用户继续后续操作。
+
+## 2. 展示字段
+| 字段 | 说明 | 来源接口 |
+| --- | --- | --- |
+| orderId | 订单ID | `/order/detail` |
+| payStatus | 支付状态 | `/order/detail` |
+| amount | 支付金额 | `/order/detail` |
+| eventName | 赛事名称 | `/order/detail` |
+| groupName | 组别名称 | `/order/detail` |
+| paidAt | 支付时间 | `/order/detail` |
+| failReason | 失败原因 | `/order/detail` |
+
+## 3. 操作按钮
+- 查看我的报名
+- 返回首页
+- 重新支付（支付失败时）
+
+## 4. 待确认项
+- 是否展示电子票/参赛码。

06-微信小程序说明/赛事列表页字段说明.md

@@ -0,0 +1,31 @@
+# 赛事列表页字段说明
+
+## 1. 页面信息
+- 页面名称：赛事列表页
+- 页面路径建议：`/pages/event/list`
+- 页面目标：按条件筛选并浏览可报名赛事。
+
+## 2. 筛选字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| keyword | input | 搜索赛事名称/地点 |
+| city | select | 按城市筛选 |
+| dateRange | daterange | 按比赛时间筛选 |
+| eventStatus | select | 按状态筛选 |
+| sortType | select | 按时间/热度排序 |
+
+## 3. 列表字段
+| 字段 | 说明 |
+| --- | --- |
+| eventId | 赛事ID |
+| eventName | 赛事名称 |
+| cover | 封面图 |
+| location | 地点 |
+| startTime | 开赛时间 |
+| feeText | 费用说明 |
+| signupStatusText | 报名状态文案 |
+
+## 4. 交互要求
+- 支持分页加载。
+- 支持空结果提示。
+- 支持点击卡片进入赛事详情。

06-微信小程序说明/赛事详情页字段说明.md

@@ -0,0 +1,49 @@
+# 赛事详情页字段说明
+
+## 1. 页面信息
+- 页面名称：赛事详情页
+- 页面路径建议：`/pages/event/detail`
+- 页面目标：展示赛事完整信息，并引导用户完成报名。
+- 进入方式：从首页、赛事列表、分享链接进入。
+
+## 2. 展示字段
+| 字段 | 说明 | 来源接口 | 是否必显 |
+| --- | --- | --- | --- |
+| eventId | 赛事ID | `/event/detail` | 否 |
+| eventName | 赛事名称 | `/event/detail` | 是 |
+| eventCover | 赛事封面图 | `/event/detail` | 是 |
+| eventStatus | 赛事状态 | `/event/detail` | 是 |
+| signupStatusText | 报名状态文案 | `/event/detail` | 是 |
+| location | 比赛地点 | `/event/detail` | 是 |
+| startTime | 开赛时间 | `/event/detail` | 是 |
+| endTime | 结束时间 | `/event/detail` | 否 |
+| signupStartTime | 报名开始时间 | `/event/detail` | 是 |
+| signupEndTime | 报名截止时间 | `/event/detail` | 是 |
+| feeText | 报名费用说明 | `/event/detail` | 是 |
+| groupList | 组别列表 | `/event/detail` | 是 |
+| ruleSummary | 赛事规则摘要 | `/event/detail` | 是 |
+| noticeText | 参赛须知 | `/event/detail` | 否 |
+| merchantName | 主办方名称 | `/event/detail` | 是 |
+| contactPhone | 联系电话 | `/event/detail` | 否 |
+
+## 3. 操作按钮
+| 按钮 | 显示条件 | 点击行为 |
+| --- | --- | --- |
+| 立即报名 | `eventStatus=已发布` 且在报名期内 | 跳转报名填写页 |
+| 查看组别 | 存在多个组别 | 打开组别选择弹层 |
+| 联系主办方 | 配置了联系电话 | 拉起拨号或复制电话 |
+| 分享赛事 | 支持分享时 | 触发小程序分享 |
+
+## 4. 状态与空态
+- 加载中：展示骨架屏。
+- 无数据：提示“赛事不存在或已下架”。
+- 已截止：按钮置灰并提示报名已结束。
+- 已满员：展示“名额已满”。
+
+## 5. 交互说明
+- 用户切换组别后，应实时更新费用、剩余名额、报名资格提示。
+- 页面需兼容分享进入场景。
+- 若赛事已结束，可展示成绩查询入口（如有）。
+
+## 6. 待确认项
+- 是否展示往届成绩、主办方介绍、地图导航。

06-微信小程序说明/页面与模块划分.md

@@ -0,0 +1,26 @@
+# 页面与模块划分
+
+## 1. 页面建议
+- 首页
+- 赛事列表页
+- 赛事详情页
+- 报名填写页
+- 支付结果页
+- 我的报名页
+- 成绩查询页
+- 个人中心页
+
+## 2. 模块建议
+| 模块 | 说明 |
+| --- | --- |
+| 登录鉴权模块 | 微信登录、手机号绑定、登录态维护 |
+| 赛事展示模块 | 列表、筛选、详情展示 |
+| 报名模块 | 表单填写、资格校验、提交报名 |
+| 支付模块 | 拉起支付、查询结果、失败重试 |
+| 消息通知模块 | 订阅消息、系统通知 |
+| 用户中心模块 | 报名记录、成绩、个人资料 |
+
+## 3. 交互原则
+- 关键状态以后台接口返回为准。
+- 支付、报名、成绩等结果页需有明确状态提示。
+- 重要操作失败时要给出可恢复路径。

06-微信小程序说明/页面字段级说明模板.md

@@ -0,0 +1,28 @@
+# 页面字段级说明模板
+
+## 1. 使用说明
+后续每个页面都可以按本模板补字段与交互，便于直接交给前端或 agent 开发。
+
+## 2. 模板
+### 页面名称
+- 页面路径：
+- 页面目标：
+- 进入条件：
+
+### 展示字段
+| 字段 | 说明 | 来源接口 | 是否必显 |
+| --- | --- | --- | --- |
+| 示例：赛事名称 | 展示赛事标题 | `/event/detail` | 是 |
+
+### 操作按钮
+| 按钮 | 条件 | 点击后行为 |
+| --- | --- | --- |
+| 示例：立即报名 | 可报名时显示 | 跳转报名页 |
+
+### 状态与空态
+- 加载中：
+- 无数据：
+- 异常提示：
+
+### 待确认项
+- 

06-微信小程序说明/页面清单与路由草案.md

@@ -0,0 +1,24 @@
+# 页面清单与路由草案
+
+## 1. 目标
+梳理微信小程序主要页面、路由关系与页面职责，便于后续快速搭建页面骨架。
+
+## 2. 页面清单
+| 页面 | 路径建议 | 说明 |
+| --- | --- | --- |
+| 首页 | `/pages/home/index` | 推荐赛事、搜索入口 |
+| 赛事列表 | `/pages/event/list` | 筛选、排序、分页展示 |
+| 赛事详情 | `/pages/event/detail` | 展示赛事信息、组别、报名入口 |
+| 报名填写 | `/pages/signup/form` | 填写报名信息 |
+| 支付结果 | `/pages/order/result` | 支付成功/失败结果页 |
+| 我的报名 | `/pages/mine/signup-list` | 查看报名记录 |
+| 成绩查询 | `/pages/mine/result-list` | 查看成绩与排名 |
+| 个人中心 | `/pages/mine/index` | 用户信息与设置 |
+
+## 3. 页面跳转关系
+- 首页 → 赛事列表 → 赛事详情 → 报名填写 → 支付结果
+- 个人中心 → 我的报名 / 成绩查询
+
+## 4. 待补充项
+- 每个页面的字段、按钮、交互状态说明。
+- 空态、异常态和加载态设计。

06-微信小程序说明/首页字段说明.md

@@ -0,0 +1,23 @@
+# 首页字段说明
+
+## 1. 页面信息
+- 页面名称：首页
+- 页面路径建议：`/pages/home/index`
+- 页面目标：展示推荐赛事、快捷入口和平台公告。
+
+## 2. 展示字段
+| 字段 | 说明 | 来源接口 | 是否必显 |
+| --- | --- | --- | --- |
+| bannerList | 轮播图列表 | `/home/index` | 否 |
+| recommendEventList | 推荐赛事列表 | `/home/index` | 是 |
+| noticeList | 公告列表 | `/home/index` | 否 |
+| quickEntryList | 快捷入口 | `/home/index` | 否 |
+| cityName | 当前城市 | `/home/index` | 否 |
+
+## 3. 操作按钮
+- 搜索赛事
+- 查看全部赛事
+- 点击推荐赛事进入详情
+
+## 4. 待确认项
+- 是否需要城市切换、热门分类、活动横幅。