contest-go

国防知识竞赛的精简 Go 重写版：只保留 CAS 登录、答题、自动交卷和历史分数。

决策

• 题目在启动时从 data/problems.yaml 载入进程内存，不写入 Redis。
• PostgreSQL 只保存最终成绩，一张 scores 表。
• 不保留 Django Admin、回顾、姓名、单位、本地密码、Celery。
• 多选全对得分。
• 断线续答与自动交卷依赖 Redis 草稿和 deadline ZSET。

前端

无构建步骤：web/templates/ 是 Go 模板，web/static/ 下的 css/js/img 即源码， 直接以 /static/ 路径提供并随二进制 embed 分发。

• static/js/common.js：所有页面共享的 ES module（API 封装、CSRF、登出、移动端菜单）
• static/js/index.js / contest.js / info.js：各页面只加载自己的脚本
• 答题页倒计时以 /api/exam 下发的 now_unix_ms 校准客户端时钟
• 答题页/成绩页背景图放在 static/img/background/ 下，每次渲染随机选取一张，增删图片无需改代码

本地开发

不依赖 Redis/PostgreSQL：

USE_MEMORY_STORE=1 DEV_LOGIN_ENABLED=true BANK_PATH=data/problems.yaml go run ./cmd/server

打开 http://localhost:8080，使用页面上的“开发登录”。

测试：

go test ./...

生产部署

镜像由 GitHub Actions 构建并推送到：

ghcr.io/bitnp/contest-go:latest

docker-compose.yml 是单文件生产栈：

app + PostgreSQL + Redis + Traefik labels

部署步骤：

cp .env.example .env
# 编辑 .env，填写 POSTGRES_PASSWORD、POSTGRES_URL、SESSION_SECRET、CAS_SERVICE_URL 等

# 题库不放进镜像，部署时放到 ./data/problems.yaml
cp /path/to/problems.yaml ./data/problems.yaml

podman-compose up -d

生产环境必须保持：

DEV_LOGIN_ENABLED=false
COOKIE_SECURE=true

停止但保留数据：

podman-compose down

Redis 必须开启 AOF，除非使用 compose 中的默认配置：

appendonly yes

当前接口

GET  /api/me
GET  /api/exam
POST /api/answer
POST /api/submit
GET  /api/scores
GET  /auth/cas/login
GET  /auth/cas/callback
GET  /auth/dev
POST /auth/logout
GET  /healthz

/api/answer 示例：

{
  "question_id": 205,
  "choice_ids": [20500, 20502, 20503]
}