zhouwentao
/
golang-yitisheng-server
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
golang-yitisheng-server/project_doing.md

4.9 KiB
Raw Blame History

项目过程记录

2025-12-17

[任务执行] 初始化模块 yitisheng/yx_user_score

  • 操作目标: 创建新的业务模块目录，并准备实现用户分数和志愿管理功能。
  • 影响范围: server/modules/yitisheng/yx_user_score/
  • 修改前记录: 项目中暂无此模块。

[任务执行] 修正模块路径并实现 CRUD

  • 操作目标: 根据 Task3.md 要求，将 yx_user_score, yx_volunteer, yx_volunteer_record 实现于 modules/yx/ 下。
  • 影响范围: server/modules/yx/
  • 修改结果:
    • 删除了错误的 modules/yitisheng 目录（尝试删除）。
    • 在 modules/yx 下实现了 Entity, Mapper, Service, Controller。
    • 更新了 main.go 注册路由。

[任务执行] 增加 Swagger 文档访问密码验证

  • 操作目标: 为 Swagger 文档接口添加 Basic Auth 验证，防止未授权访问。
  • 影响范围: server/config/config.go, server/main.go
  • 修改前记录: Swagger 接口公开，无验证。
  • 修改结果:
    • server/config/config.go: 新增 SwaggerConfig 配置项 (默认 admin/password)。
    • server/main.go: 为 /swagger 路由组添加了 gin.BasicAuth 中间件。

[任务执行] 解决本地调试 CORS 问题

  • 操作目标: 允许前端 Vue3 项目跨域调用后端接口。
  • 影响范围: server/middleware/cors.go, server/main.go
  • 修改前记录: 后端未配置 CORS，前端跨域请求被拦截。
  • 修改结果:
    • server/middleware/cors.go: 创建了 CORS 中间件，允许 Origin 头部指定的来源，并放行 OPTIONS 请求。
    • server/main.go: 全局注册了 CORS 中间件。

[任务执行] 实现用户成绩保存接口

  • 操作目标: 根据 Task4.md 要求，实现用户成绩信息的保存接口，并包含特定的业务校验逻辑。
  • 影响范围: server/modules/yx/controller/yx_user_score_controller.go
  • 修改前记录: YxUserScoreController 仅有基本的 CRUD 接口。
  • 修改结果:
    • 定义了 SaveScoreRequest 结构体，包含严格的字段校验逻辑（文理分科、科目限制、成绩范围等）。
    • 实现了 SaveUserScore 方法，处理 DTO 到 Entity 的转换（包括科目列表拼接、子专业成绩映射）。
    • 注册了 POST /yx-user-scores/save-score 路由。

[任务执行] 重构 DTO 代码结构

  • 操作目标: 将 SaveScoreRequest 结构体从 Controller 中分离到独立的 DTO 包中。
  • 影响范围: server/modules/yx/dto/yx_user_score_dto.go, server/modules/yx/controller/yx_user_score_controller.go
  • 修改前记录: DTO 结构体直接定义在 Controller 文件中。
  • 修改结果:
    • 创建了 server/modules/yx/dto/ 目录。
    • 将 SaveScoreRequest 及其校验逻辑移动到 yx_user_score_dto.go。
    • Controller 改为引用 dto 包。

[任务执行] 处理 UserScoreVO 信息转换

  • 操作目标: 在 UserScoreService 中实现 Entity 到 VO 的转换，并完善 UserScoreVO 定义。
  • 影响范围: server/modules/user/vo/user_score_vo.go, server/modules/user/service/user_score_service.go
  • 修改前记录: UserScoreVO 为空，GetActiveByID 返回原始 Entity。
  • 修改结果:
    • 定义了 UserScoreVO 结构体，其字段设计参考了 SaveScoreRequest。
    • 在 UserScoreService 中实现了 convertEntityToVo 私有方法，处理了逗号分隔字符串到切片的转换，以及具体分数字段到 Map 的映射。
    • 更新 GetActiveByID 返回 UserScoreVO 对象。

[任务执行] 增加用户成绩分页列表接口

  • 操作目标: 在 UserScoreController 和 UserScoreService 中增加获取当前用户所有成绩的分页列表接口。
  • 影响范围: server/modules/user/service/user_score_service.go, server/modules/user/controller/user_score_controller.go
  • 修改前记录: 仅支持获取当前激活的单条成绩。
  • 修改结果:
    • 在 UserScoreService 中实现了 ListByUser 方法，支持分页查询并返回 VO 列表。
    • 在 UserScoreController 中增加了 List 方法，并注册了 GET /user/score/list 路由。

[任务执行] 统一管理 Redis Key 及全局常量

  • 操作目标: 创建专门存放 Redis Key 和业务常量的地方，并重构相关代码以引用这些常量。
  • 影响范围: server/common/constants.go, server/modules/system/service/sys_user_service.go, server/middleware/auth.go, server/common/context.go
  • 修改前记录: 常量散落在各个业务文件和中间件中，存在硬编码和重复定义。
  • 修改结果:
    • 创建了 server/common/constants.go，集中管理 Redis 前缀、Token 请求头、业务状态码等。
    • 重构了 SysUserService，使用 common.RedisTokenPrefix 和 common.RedisTokenExpire。
    • 重构了 AuthMiddleware，使用 common.TokenHeader 和 common.ContextUserKey。
    • 清理了 common/context.go 中的重复定义。