⛷️ 跳绳比赛裁判系统

1. 系统概览 #

本系统是一套面向跳绳比赛的实时成绩管理平台，支持比赛建档、项目编排、运动员分组、场地分配、裁判执裁、成绩录入、实时大屏展示与导出统计的全流程。

1.1 五大端的能力矩阵

1.2 技术架构（极简版）

2. 系统入口与登录 #

2.1 三大端入口

访问部署后的主域名 https://你的域名/，进入系统门户：

2.2 默认账号

3. 管理员端使用 #

管理员端是整个系统的"驾驶舱"，通过左侧导航切换 7 大功能模块：

3.1 侧边栏导航

3.1.1 比赛管理

创建一场新比赛，作为所有数据（项目、组别、场地、运动员、成绩）的顶层容器。

3.1.2 项目管理

管理比赛中的所有竞赛项目（如 30 秒单摇、3 分钟单摇接力、个人花样、规定套路等）。

3.1.3 赛事组别

为比赛划分组别（如「男子组 - 三年级」「女子组 - 四年级」「混合组 - 五年级」），便于成绩分组统计。

3.1.4 场地管理

这是系统的核心调度界面，用于把"裁判员 + 运动员 + 项目"三者绑定到具体场地。

3.1.5 运动员管理

批量导入 · 分组校验详解

系统采用两层防护机制，确保只有分组正确的运动员才能被导入：

导入完成后，系统会弹出导入结果汇总：

失败记录支持：📥 导出 Excel（便于修正后重新导入）、重新导入失败记录（快速重试）。

3.1.6 大屏管理

在管理员端无需打开大屏窗口，就能直接调整大屏的呈现样式。

3.1.7 成绩总览

查看、修改、导出所有已录入的成绩。

3.1.8 裁判员管理

4. 裁判员端 Web 版 #

4.1 登录与执裁任务选择

4.2 计数赛执裁流程

4.3 规定赛执裁（3 个角色）

规定赛由3 名裁判员分工评分，各角色登录后会自动进入对应执裁界面（judge-head.html / judge-creative.html / judge-completion.html）。

最终得分 = 100 − T3扣分 + T1 + T2（满分 100 + 20 + 80 = 100，因为 T1 + T2 也是 0-100）

4.4 查看历史成绩

小程序端提供"我的历史"页面（history.wxml），可查看本裁判员历史上报的所有成绩，便于赛后回顾和申诉。

5. 裁判员端 小程序 / App #

移动端（微信小程序 / Android / iOS App）使用流程与 Web 版完全一致，但 UI 针对小屏做了优化（数字键盘更大、按钮更易点击）。

5.1 登录与界面

5.2 Android / iOS App 构建

1. 在微信开发者工具中切换到「多端应用模式」。
2. 点击菜单「工具」→「多端框架」→「生成 Android 工程」 / 「生成 iOS 工程」 → 自动生成原生项目壳。
3. Android：使用 Android Studio 打开生成的工程 → 编译 APK。
   iOS：使用 Xcode 打开 → 配置证书 → 编译 IPA。
4. App 内核与小程序完全一致，无需重复开发业务逻辑。

6. 大屏展示端 #

大屏端面向现场观众，通过浏览器全屏运行，实时同步裁判员录入的成绩。

6.1 启动与全屏

6.2 界面布局

6.3 场次切换动画

当管理员切换到下一场次时，大屏会显示"第 X 场次 → 第 Y 场次"的过渡卡片，旧场次卡片向左滑出，新场次卡片从右滑入。

6.4 赛后庆祝特效

当某场次所有运动员成绩录入完成时，大屏会触发：

• 🏆 金色径向闪光 覆盖全屏
• 📜 50 片彩色纸屑 从天而降（带随机摆动）
• 💬 居中显示 "全部成绩已录入 · 本场次比赛完毕"
• ⏱️ 5 秒后自动消失

6.5 底部跑马灯

滚动播报最新成绩或管理员自定义的公告文案。右侧实时显示「已录 / 总人数」统计。

7. 完整比赛流程 #

下面以一场 30 人 30 秒单摇计数赛为例，演示从开赛到结束的完整操作流。

8. 常见问题 FAQ #

Q1. 裁判员登录时一直显示"账号审核中"怎么办？

显示"账号审核中"说明该裁判员注册后尚未通过管理员审核。需要管理员在「裁判员管理」中找到该裁判员，点击「通过审核」按钮。审核通过后账号自动启用，裁判员即可登录。

Q2. 输入密码错误时只有通用错误，没有红色边框？

检查后端是否正确返回 errorCode: 'WRONG_PASSWORD'。如果后端没问题但前端没显示，尝试清除浏览器缓存（Ctrl+Shift+R 强制刷新）。

Q3. 成绩提交后大屏没有立即更新？

大屏默认 5 秒自动轮询。如需即时刷新，在管理员端"大屏管理"中调整轮询频率；或在管理员端点击「设为大屏」重新下发一次。

Q4. 打印成绩统计表时没有边框？

已修复（2026-06-13 更新）。如仍有问题，请使用 Chrome 浏览器，且在打印设置中将边距设为"默认"或"无"。

Q5. 多个裁判员同时录入同一运动员会冲突吗？

不会。系统在数据库层使用唯一约束 + 后写入覆盖原则。同一个运动员的规定赛 T1/T2/T3 来自不同裁判员，互不冲突；计数赛成绩以后提交者为准。

Q6. 大屏显示"暂无比赛"？

需要在管理员端「比赛管理」中找到目标比赛，点击「📺 设为大屏」按钮。每个时刻只能有一个比赛被设为大屏。

Q7. 小程序编译报错 "Cannot read property of undefined"？

通常是用了 ?. 或 ?? 这类 ES2020 语法。微信小程序编译器默认不支持，需要改写成传统写法：

// ❌ 不支持
const name = app.globalData.judgeInfo?.name
// ✅ 改写为
const info = app.globalData.judgeInfo || {}
const name = info.name

Q8. 如何重置管理员密码？

登录 Cloudflare Dashboard → D1 → 找到 admins 表 → 用 SQL 直接更新密码字段（密码需先用 BCrypt 加密）。

Q9. 部署到 Cloudflare Pages 失败？

常见原因：wrangler.toml 中 database_id 没改成真实 ID。详见 DEPLOY.md。

Q10. 大屏可以连接投影仪吗？

可以。推荐用一台笔记本电脑连接投影仪 → 浏览器打开大屏 → F11 全屏 → 设置浏览器开机自启。系统对宽屏（1920×1080+）和超宽屏（21:9）都做了适配。

Q11. 批量导入运动员时，分组名称不匹配怎么处理？

预览阶段会将分组不匹配的行标红，并在分组列下方显示具体原因（如"分组不匹配：运动员所属分组[少年组]不在赛事组别中"）。处理方式：

• 直接点「确认导入」— 系统自动跳过标红记录，仅导入有效数据
• 导入完成后在结果弹窗里点「📥 导出失败记录」— 下载含失败原因的 Excel，修正后再次导入
• 点「重新导入失败记录」— 失败记录自动回填到预览窗口，便于快速重试

Q12. 批量导入时提示"确认导入"按钮是灰色的？

这说明预览中所有记录都不符合分组要求（全部标红），没有可导入的有效数据。需要先修正 Excel 中的组别名称，重新上传文件。

Q13. 分组字段为空的运动员能导入吗？

可以。分组为空的运动员不触发分组校验，会直接导入。导入后可在运动员管理列表中手动编辑补充组别。

Q14. 裁判员提示"账号已在其他设备登录"怎么办？

系统采用严格单点登录机制——同一裁判员账号同一时间只能在一个设备上使用（不限 Web 或小程序）。出现此提示说明该账号已在其他设备登录。解决方式：

• 联系当前使用者退出登录，退出后其他设备即可正常登录
• 管理员也可以在「裁判员管理」中禁用再启用该裁判员，强制释放会话