登录与入口
管理员登录后直接进入管理后台（/admin），左侧导航栏包含球队管理、赛程管理、用户管理、系统设置四大模块。管理员可同时执裁比赛，通过 /matches 进入比赛选择页。
球队管理
- 查看所有球队及球员数量，新增/编辑/删除球队
- 展开球队管理球员：号码、中英文名、进球/罚时统计
赛程管理
- 新增/编辑/删除比赛，设置队伍、棍色、场地、裁判、时间
- 小组赛结束后一键更新淘汰赛对阵（根据小组排名自动填充）
- 手动修改比赛状态和比分，支持退回未开始状态
用户管理
- 创建/删除系统用户，设置角色（admin/referee/ck等）
- 重置用户密码（需用户明确同意后方可操作）
Excel 导入导出
- 支持多Sheet格式导入球队、球员、教练数据（含中英文名）
- 一键导出当前所有球队数据为Excel文件，含汇总Sheet
- 支持赛程Excel导入导出，便于批量编排和存档
比赛接管与手动完赛
- 裁判断线超过10秒，后台收到实时弹窗通知
- 点击断线比赛进入执裁页面，自动解除原裁判执裁锁
- 无法恢复时可手动输入最终比分结束比赛（红色按钮）
- 手动完赛后可通过admin页面补录进球/罚时记录
系统设置
- 配置默认比赛参数：半场时长、暂停规则、加时赛、开始方式等
日志管理
- 查看每场比赛的详细操作日志（JSON格式）
- 单个删除或批量清理过期日志文件
登录与入口
检录员登录后跳转至比赛选择页。ck1只能操作Court 1的比赛，ck2只能操作Court 2的比赛。ckadmin和refadmin可以操作所有比赛。
检录流程
比赛已排程
→
检录队A
→
检录队B
→
检录完成
→
裁判可开始
检录操作
- 在比赛列表中点击比赛进入检录页面
- 两侧分别显示两队完整大名单
- 点击球员卡片移出不在场的球员（上场名单需≤10人）
- 再次点击灰色球员可恢复到大名单
- 确认后点击"确认检录"提交，系统自动通知裁判端
退回检录（仅ckadmin/refadmin）
检录有误时，ckadmin或refadmin可退回检录状态，清除检录记录后重新操作。两队都完成检录后，ck1/ck2无法再修改大名单。
注意事项
- 上场名单最多10人，超出时需移出多余球员
- 检录完成后系统自动通知裁判端，裁判方可开始比赛
- 退回检录需二次确认，操作不可撤销
登录与入口
裁判员登录后跳转至比赛选择页（/matches），只能看到分配给自己的比赛。refadmin可看到所有比赛。点击比赛卡片进入执裁页面。比赛必须已完成检录（两队均已确认）才能开始。
赛前设置
- 配置半场时长、中场休息、加时赛、金球、暂停规则、开始方式等
- 查看检录后的大名单，点击移出球员（上场≤10人）
- 比赛必须已完成检录（两队均已确认）才能开始
开始方式
- 纯手动：点击开始按钮后直接进入上半场
- 定时开始：设置当地时间，到时自动开始
- 倒计时开始：设置倒计时分钟数，倒计时结束自动开始
比赛操作
- 进球：选择球队和球员，记录进球（可补登记）
- 罚时：选择球队和球员，设置罚时时长（1-5分钟）
- 暂停：记录球队暂停（每队每场限次）
- 犯规/死球：暂停计时，等待比赛继续
- 点球：进入点球模式，记录点球结果
- 裁判员暂停：暂停比赛处理特殊情况（不消耗球队暂停次数）
快捷键
| 快捷键 | 功能 |
|---|
| 空格 | 开始/暂停比赛 |
| D | 犯规/死球 |
| R | 比赛继续 |
| G | 确认进球 |
| T | 确认暂停 |
| P | 判罚出场 |
| K | 点球 |
| S | 裁判员暂停 |
比赛阶段
赛前
→
上半场
→
中场休息
→
下半场
→
裁判决策
裁判决策
→
加时赛前休息
→
加时上半场
→
加时休息
→
加时下半场
→
金球
断线恢复
- 裁判端每5秒发送心跳，超过10秒未收到判定断线
- 网络异常时自动进入离线模式，事件暂存localStorage
- 原裁判重连后直接显示恢复界面，可编辑关键数据后恢复
- admin/refadmin可接管断线比赛，选择恢复或手动完赛
补登记
比赛中或休息阶段可补录之前遗漏的进球或罚时事件，选择类型、阶段、球员后确认。进球会自动更新比分。
结束比赛
- 常规流程：下半场结束→裁判决策→直接结束或进入加时赛
- 加时赛流程：加时赛结束→金球制胜→比赛结束
- 比赛结束后自动生成操作日志，射手榜/罚时榜自动更新
- 异常情况：admin/refadmin可通过手动完赛输入最终比分结束比赛