竞赛成绩管理系统代码 - 专业级自动化成绩处理解决方案

? 真实场景还原

教师A（下午3:20）："张三总分算错了，我再核对一下……"
教师B（下午3:45）："李四的附加题分没加，快改！"
教务处（下午4:10）："王老师，Excel文件名是'最终版v3_真的最终版'还是'v4_确认无误'？"

? 实际效能对比（某市中学生数学竞赛）

? 项目根目录结构

competition-score-system/
├── src/                # 源代码目录
│   ├── core/           # 核心逻辑（校验引擎、排名算法）
│   ├── api/            # RESTful API接口
│   ├── views/          # 前端模板（HTML+CSS+JS）
│   ├── utils/          # 工具函数（时间处理、格式化等）
│   └── config/         # 配置文件（数据库、密钥等）
├── public/             # 静态资源（CSS/JS/图片）
├── tests/              # 单元测试与E2E测试
├── docs/               # 文档（部署指南、API文档）
├── docker/             # Docker部署配置
├── .env.example        # 环境变量模板
├── package.json        # Node.js依赖
└── README.md           # 项目说明

✅ 成绩校验核心逻辑（JavaScript）

function validateRecord(record) {
  const errors = [];
  // 必填字段检查
  if (!record.student_id) errors.push("学生ID不能为空");
  if (!record.name) errors.push("姓名不能为空");
  if (typeof record.score_base !== 'number')
    errors.push("基础分必须为数字");
  // 逻辑校验
  const calculatedTotal =
    (record.score_base || 0) +
    (record.score_bonus || 0) -
    (record.score_penalty || 0);
  if (Math.abs(calculatedTotal - record.total_score) > 0.01) {
    errors.push(`总分不匹配：计算值${calculatedTotal.toFixed(1)} ≠ 输入值${record.total_score}`);
  }
  // 范围校验
  if (record.score_base < 0 || record.score_base > 100)
    errors.push("基础分需在0~100之间");
  return {
    valid: errors.length === 0,
    errors
  };
}

? 排名算法（Python）

def calculate_rank(scores, method="standard"):
    """
    计算成绩排名
    :param scores: 列表，元素为字典{student_id, total_score}
    :param method: "standard" (同分同名次), "dense" (无空缺名次)
    :return: 排名列表
    """
    # 按分数降序排序
    sorted_scores = sorted(scores, key=lambda x: x["total_score"], reverse=True)
    ranks = []
    current_rank = 0
    for i, entry in enumerate(sorted_scores):
        # 标准排名：同分同名次
        if method == "standard":
            if i == 0 or entry["total_score"] != sorted_scores[i-1]["total_score"]:
                current_rank = i + 1
        # 密集排名：同分同名次，后续名次连续
        elif method == "dense":
            if i == 0 or entry["total_score"] != sorted_scores[i-1]["total_score"]:
                current_rank += 1
        ranks.append({
            "student_id": entry["student_id"],
            "rank": current_rank,
            "score": entry["total_score"]
        })
    return ranks

? Docker Compose配置示例

version: '3.8'
services:
  app:
    image: yiounet/competition-score:v3.2
    ports:
      - "3000:3000"
    environment:
      - DB_HOST=mysql
      - DB_USER=root
      - DB_PASS=your_password
      - DB_NAME=csystem
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=your_password
      - MYSQL_DATABASE=csystem
    volumes:
      - ./data:/var/lib/mysql
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql

? API请求示例（Postman）

POST /api/scores HTTP/1.1
Host: localhost:3000
Content-Type: application/json
Authorization: Bearer your_token
{
  "competition_id": "math2024",
  "scores": [
    {"student_id": "S2024001", "score_base": 85.5, "score_bonus": 10.0},
    {"student_id": "S2024002", "score_base": 92.0, "score_bonus": 15.0}
  ]
}

❓ Q1：为什么批量导入后部分数据未生效？

A：检查导入日志中的错误提示，常见原因包括：

• 学生ID在系统中不存在（需先导入学生信息）；
• 分数字段为空或非数字（如输入"85分"而非85）；
• 总分字段与计算值偏差＞0.1（建议删除total_score字段，让系统自动计算）。

❓ Q2：如何修改已发布成绩？

A：系统支持成绩修订流程：

1. 在成绩管理页点击"修订"按钮；
2. 填写修订原因（系统自动记录）；
3. 提交后需二级审核（如教研组长）；
4. 审核通过后生效，原数据自动归档。

❓ Q3：如何处理团队竞赛成绩？

A：系统支持"团队-个人"双层结构：

• 团队成绩：在team表中定义（如"数学建模队A"）；
• 个人成绩：关联team_id，自动计入团队总分；
• 团队排名：按团队总分排序，支持自定义权重（队长分×1.5 + 成员均分×0.5）。

❓ Q4：成绩发布后发现重大错误怎么办？

A：启用"成绩冻结"功能：

1. 管理员进入"系统设置→安全中心"；
2. 点击"冻结竞赛成绩"；
3. 系统生成PDF冻结凭证（含时间戳与操作人）；
4. 修改后需"解冻"才能重新发布。