refactor: 后端仓库层更名为数据访问层(internal/repository → internal/dal)

「仓库层」是 repository 的直译,中文里与「代码仓库 / git 仓库」同词,
而这一层做的事就是数据访问。名字改成它实际在做的事。

改名口径(纯机械替换,无逻辑改动):
- 包:internal/repository → internal/dal(package repository → package dal)
- 类型:XxxRepo → XxxDAO(TaskRecordDAO / SpecialistDAO / PositionDAO …)
- 变量:xxxRepo → xxxDAO
- import 路径、包限定符、日志前缀 [repository] → [dal] 同步
- 注释里的「仓库层」→「数据访问层」;core.go 包注释补上 DAL/DAO 全称

命名规范补登(AR09 是命名问题的最高依据,改了名就得回去登记):
- AR09 §3.1 术语表新增「数据访问层 dal / DAO」一行
- AR09 §5.6 缩写表新增 DAO / dal —— 原文是「只有下表内的缩写允许使用」,
  不登记就是自己破自己的规矩
- PROJECT_STATE.md 新增 D27 记录本次更名决策

验证:全部在 db 副本上做,生产库 data/eai_agentplatform.db 未触碰。
- 等价性对照:拿 HEAD 源码 + 仅改名 造出第二棵树,两棵树各自起
  httptest 服务跑同一份探针(60 个 GET + 13 个写/回读,覆盖专员/技能/应用/
  任务/交付物/项目/岗位/考试/知识/积分/管理端只读等),逐端点比对响应体:
  73 项里 52 项字节完全一致、21 项仅运行期时间戳不同、内容差异 0。
- 探针非空:往改名后的树注入「SpecialistDAO.List 限 3 条」变异,
  /api/specialists 立刻被抓出 —— 证明上面那个 0 不是没测到。
- 暂存区自洽:把索引整个导出成源码树,go build / go vet / go test ./... 全绿。
- gofmt:因 import 排序变化而错位的 19 个文件已修;另 2 个文件(skill_definition.go、
  seed.go)的格式问题是工作区里别人的在制品带来的,未替其改动。

未纳入本次提交:工作区里正在进行中的「文生语音技能 + 技能展示色/交互卡」
(tts_handlers.go、text_to_speech/manifest.go、skillCatalog.js 等),
以及 router.go / skill_definition.go / seed.go 三个文件里属于该在制品的改动 ——
这三个文件只把「改名那一版」放进索引,工作区原样保留。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
eaiadmin
2026-09-19 09:19:21 +08:00
co-authored by Claude Code
parent 1875e7dd4c
commit e8aedd50d2
70 changed files with 738 additions and 733 deletions
@@ -10,21 +10,21 @@ import (
"github.com/gin-gonic/gin"
"eai_agentplatform/backend/internal/auth"
"eai_agentplatform/backend/internal/dal"
"eai_agentplatform/backend/internal/model"
"eai_agentplatform/backend/internal/repository"
"eai_agentplatform/backend/internal/web"
)
// systemConfigRepo 声明在此;examRecordRepo 与考试域同属一个对象,
// systemConfigDAO 声明在此;examRecordDAO 与考试域同属一个对象,
// 统一声明在 exam.go 的「考试域仓库」块内,避免同一个仓库有两份变量导致覆写时行为分叉。
var (
userRepo repository.UserRepo
configRepo repository.SystemConfigRepo
userDAO dal.UserDAO
configDAO dal.SystemConfigDAO
)
func init() {
userRepo = repository.UserRepo{}
configRepo = repository.SystemConfigRepo{}
userDAO = dal.UserDAO{}
configDAO = dal.SystemConfigDAO{}
}
// ============ 用户管理(管理员) ============
@@ -32,11 +32,11 @@ func init() {
// ListUsers GET /api/system/users —— 含考试统计(考试次数/通过数/最近成绩)
func ListUsers(c *gin.Context) {
var items []model.User
userRepo.Query().Type(&model.User{}).Order("id ASC").Find(&items)
userDAO.Query().Type(&model.User{}).Order("id ASC").Find(&items)
// 获取考试记录
var recs []model.ExamRecord
examRecordRepo.Inner().Model(&model.ExamRecord{}).Order("submitted_at DESC").Find(&recs)
examRecordDAO.Inner().Model(&model.ExamRecord{}).Order("submitted_at DESC").Find(&recs)
type stat struct {
ExamCount int
@@ -108,7 +108,7 @@ func CreateUser(c *gin.Context) {
if req.Role != "admin" && req.Role != "employee" {
req.Role = "employee"
}
_, found := userRepo.GetByUsername(req.Username)
_, found := userDAO.GetByUsername(req.Username)
if found {
web.Fail(c, web.NewConflictError("用户名已存在"))
return
@@ -126,7 +126,7 @@ func CreateUser(c *gin.Context) {
if req.Role == "admin" {
u.AiPoints = 999999
}
if !userRepo.Insert(&u) {
if !userDAO.Insert(&u) {
web.Fail(c, web.NewBadRequest("创建用户失败"))
return
}
@@ -139,7 +139,7 @@ func UpdateUser(c *gin.Context) {
if !ok {
return
}
u, found := userRepo.GetByID(id)
u, found := userDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("用户不存在"))
return
@@ -191,7 +191,7 @@ func UpdateUser(c *gin.Context) {
}
u.AiPoints = *req.AiPoints
}
if !userRepo.Update(&u) {
if !userDAO.Update(&u) {
web.Fail(c, web.NewBadRequest("更新用户失败"))
return
}
@@ -200,7 +200,7 @@ func UpdateUser(c *gin.Context) {
// defaultAiPoints 读取新用户默认 AI 算力点(system_config.ai_points_default,缺省 100)
func defaultAiPoints() int {
val := configRepo.GetByKey("ai_points_default")
val := configDAO.GetByKey("ai_points_default")
if v, err := strconv.Atoi(strings.TrimSpace(val)); err == nil {
return v
}
@@ -211,7 +211,7 @@ func defaultAiPoints() int {
// ListExamRecords GET /api/system/exam-records?user_id=&paper_id=
func ListExamRecords(c *gin.Context) {
items := examRecordRepo.List(c.Query("user_id"), c.Query("paper_id"))
items := examRecordDAO.List(c.Query("user_id"), c.Query("paper_id"))
web.OK(c, items)
}
@@ -233,7 +233,7 @@ func GetExamRecord(c *gin.Context) {
if !ok {
return
}
rec, found := examRecordRepo.GetByID(id)
rec, found := examRecordDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("考试记录不存在"))
return
@@ -254,7 +254,7 @@ func DeleteExamRecord(c *gin.Context) {
if !ok {
return
}
if !examRecordRepo.Remove(id) {
if !examRecordDAO.Remove(id) {
web.Fail(c, web.NewBadRequest("删除考试记录失败"))
return
}
@@ -264,7 +264,7 @@ func DeleteExamRecord(c *gin.Context) {
// ExportExamRecords GET /api/system/exam-records/export —— 导出 CSV(支持 user_id/paper_id 过滤)
func ExportExamRecords(c *gin.Context) {
var items []model.ExamRecord
q := repository.DB.Model(&model.ExamRecord{})
q := dal.DB.Model(&model.ExamRecord{})
if uid := c.Query("user_id"); uid != "" {
q = q.Where("user_id = ?", uid)
}
@@ -278,7 +278,7 @@ func ExportExamRecords(c *gin.Context) {
// 用户名映射
var users []model.User
repository.DB.Find(&users)
dal.DB.Find(&users)
nameMap := map[uint]model.User{}
for _, u := range users {
nameMap[u.ID] = u
@@ -316,7 +316,7 @@ func ExportExamRecords(c *gin.Context) {
// GetConfig GET /api/system/config —— 所有系统参数
func GetConfig(c *gin.Context) {
items := configRepo.List()
items := configDAO.List()
type cfgItem struct {
Key string `json:"config_key"`
Value string `json:"config_value"`
@@ -338,7 +338,7 @@ func UpdateConfig(c *gin.Context) {
web.Fail(c, web.NewBadRequest("configs 必填"))
return
}
configRepo.BulkUpsert(toSystemConfigs(req.Configs))
configDAO.BulkUpsert(toSystemConfigs(req.Configs))
web.OK(c, gin.H{"updated": len(req.Configs)})
}