一、系统简介
篮球赛事管理系统是一套面向赛事组织方与现场裁判的轻量级管理工具，解决办赛中三类核心问题：
- 赛程编排：快速创建赛事、录入对阵、安排时间场地、分配执裁裁判；
- 现场登记：裁判用手机登录，只需处理自己执裁的比赛，实时录入比分与赛事数据；
- 数据汇总：管理者通过总看板一屏掌握所有赛程状态、实时比分与数据统计。
系统采用响应式设计，手机、平板、电脑均可使用；数据统一存储在云端数据库，多终端实时同步。
二、功能一览
📋 赛程编排
创建赛事，批量添加比赛，设置时间、场地，为每场比赛指定执裁裁判。
📱 手机比分登记
裁判手机端一键录入比分、状态（未开始/进行中/已结束）及备注数据。
🔒 裁判权限隔离
每位裁判登录后仅能看到和操作分配给自己的比赛，互不干扰。
📊 管理总看板
全部赛事状态、实时比分、比赛场次、总得分一目了然，随时汇总。
👥 裁判账号管理
管理员可随时新增裁判账号、分配初始密码，支持多名裁判并行执裁。
🔄 多赛事并行
支持多个赛事同时进行，赛程与数据独立管理，适合长期办赛沉淀。
三、管理员使用指南
管理员负责：建赛事 → 排赛程 → 分配裁判 → 看总看板
- 登录系统：打开 https://basketball.sportsfor.fun，使用管理员账号登录（默认 admin）。
- 新建赛事：进入「赛程编排」→ 填写赛事名称与起止日期 → 创建赛事。
- 添加比赛：选择赛事 → 填写对阵双方、比赛时间、场地 → 在「裁判」下拉框中选择执裁裁判 → 添加比赛。
- 管理裁判：进入「裁判管理」→ 新增裁判账号（登录账号 + 显示姓名 + 初始密码），把账号分发给对应裁判。
- 查看总看板：进入「总看板」→ 查看每个赛事的比赛总数、未开始/进行中/已结束数量、总得分等汇总数据。
提示 管理员也可直接修改任何比赛的比分与状态，便于仲裁或修正数据。
四、裁判使用指南
裁判只处理自己的比赛，操作极简
- 登录：手机浏览器打开系统地址，使用管理员分发的账号密码登录（如 ref1）。
- 查看我的赛事：登录后自动显示分配给自己的全部比赛，含赛事名称、对阵、时间、场地、当前状态。
- 录入比分：点比赛卡片上的「录入 / 修改比分」→ 填写双方得分 → 选择状态（进行中 / 已结束）→ 可在备注中记录犯规、节次等赛事数据 → 保存。
- 随时修改：比赛结束前可反复修改比分，保存后管理端看板实时同步。
说明 你无法看到其他裁判的比赛，也不会收到其他赛事的干扰。
五、常见问题（FAQ）
Q1：裁判能看到别人的比赛吗？
不能。系统按「裁判 ↔ 比赛」的分配关系做权限隔离，每位裁判登录后只显示自己执裁的比赛。
Q2：比分录错了能改吗？
能。执裁裁判可随时重新进入该场比赛修改比分与状态，管理员也可代为修正。
Q3：忘记密码怎么办？
联系管理员。管理员在「裁判管理」中重新创建账号或更换密码即可。
Q4：手机打不开或页面很慢？
请确认网络正常，并使用手机自带浏览器或最新版微信内置浏览器访问；页面为响应式设计，自动适配手机屏幕。
Q5：数据存在哪里？安全吗？
数据存储于云端服务器的 PostgreSQL 数据库中，通过 HTTPS 加密传输。如需长期保障，可进一步配置自动备份。
Q6：一个比赛可以安排多个裁判吗？
当前版本每场比赛分配一名执裁裁判；如需主裁/副裁协作，可联系管理员扩展。
六、技术架构
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | HTML / CSS / JavaScript | 响应式单页应用，手机与电脑通用 |
| 接入层 | Nginx + HTTPS（Certbot 证书） | 域名解析、加密传输、反向代理 |
| 应用层 | Gunicorn + Flask | API 服务，systemd 守护常驻运行 |
| 数据层 | PostgreSQL 16 | 云端独立数据库，支持长期数据积累 |
| 部署环境 | asiacloud（Ubuntu 24.04） | 公网云服务器，自动续期证书 |
访问链路：浏览器 → Cloudflare/HTTPS → Nginx → Gunicorn → Flask → PostgreSQL