# 代码库函数概览

## server/common
- `constants`: 存放全局常量，如 `RedisTokenPrefix`, `TokenHeader`, `StateActive` 等。
- `Response`: 统一的HTTP响应结构体 `{Code, Message, Data}`。
- `Success(c *gin.Context, data interface{})`: 发送成功响应。
- `Error(c *gin.Context, code int, msg string)`: 发送错误响应。

## server/config
- `InitDB()`: 初始化GORM数据库连接。
- `InitRedis()`: 初始化Redis客户端。
- `AppConfig`: 全局配置变量，包含 `Log`, `Security`, `RateLimit`, `Swagger` 配置。

## server/middleware
- `AuthMiddleware`: JWT认证中间件。
- `SecurityMiddleware`: 安全校验中间件（请求头签名）。
- `RateLimitMiddleware`: 接口限流中间件。
- `CorsMiddleware`: 跨域资源共享中间件。

## server/modules/yx
- `YxSchoolMajorController`: 院校专业控制器。
- `YxHistoryMajorEnrollController`: 历年招生记录控制器。
- `YxCalculationMajorController`: 计算专业控制器。
- `YxUserScoreController`: 用户分数控制器。
- `YxVolunteerController`: 志愿控制器。
- `YxVolunteerRecordController`: 志愿明细控制器。

## server/modules/user
 - `UserScoreService`: 用户成绩服务。
   - `GetActiveByID(userID string)`: 获取用户当前激活的成绩，返回 `UserScoreVO`。
   - `ListByUser(userID string, page, size int)`: 获取用户的所有成绩分页列表。
   - `SaveUserScore(req *dto.SaveScoreRequest)`: 保存用户成绩，处理旧记录状态更新及 DTO 转换。
 - `UserScoreVO`: 用户成绩视图对象，包含基础信息、选课列表及子专业成绩映射。