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
@@ -5,17 +5,17 @@ import (
"github.com/gin-gonic/gin"
"eai_agentplatform/backend/internal/repository"
"eai_agentplatform/backend/internal/dal"
skillmodel "eai_agentplatform/backend/internal/skills/model"
"eai_agentplatform/backend/internal/web"
)
// skillDefinitionRepo 技能定义仓库(便于测试时覆写)。query_handlers.go 里的读接口共用,
// skillDefinitionDAO 技能定义仓库(便于测试时覆写)。query_handlers.go 里的读接口共用,
// 声明只此一处 —— 两份变量持有同一个仓库时,测试里覆写一份、另一份照旧,行为会静默分叉。
var skillDefinitionRepo repository.SkillDefinitionRepo
var skillDefinitionDAO dal.SkillDefinitionDAO
func init() {
skillDefinitionRepo = repository.SkillDefinitionRepo{}
skillDefinitionDAO = dal.SkillDefinitionDAO{}
}
func CreateSkillDefinition(c *gin.Context) {
@@ -48,7 +48,7 @@ func CreateSkillDefinition(c *gin.Context) {
State: req.State,
SortOrder: req.SortOrder,
}
if !skillDefinitionRepo.Insert(&item) {
if !skillDefinitionDAO.Insert(&item) {
web.Fail(c, web.NewBadRequest("创建技能定义失败"))
return
}
@@ -61,7 +61,7 @@ func UpdateSkillDefinition(c *gin.Context) {
return
}
item, found := skillDefinitionRepo.GetByID(id)
item, found := skillDefinitionDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("技能定义不存在"))
return
@@ -99,7 +99,7 @@ func UpdateSkillDefinition(c *gin.Context) {
item.State = req.State
item.SortOrder = req.SortOrder
if !skillDefinitionRepo.Update(&item) {
if !skillDefinitionDAO.Update(&item) {
web.Fail(c, web.NewBadRequest("更新技能定义失败"))
return
}
@@ -112,12 +112,12 @@ func DeleteSkillDefinition(c *gin.Context) {
return
}
item, found := skillDefinitionRepo.GetByID(id)
item, found := skillDefinitionDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("技能定义不存在"))
return
}
if !skillDefinitionRepo.Delete(&item) {
if !skillDefinitionDAO.Delete(&item) {
web.Fail(c, web.NewBadRequest("删除技能定义失败"))
return
}
@@ -18,20 +18,20 @@ import (
officecontracts "eai_agentplatform/backend/internal/skills/runtime/office/contracts"
specialistruntime "eai_agentplatform/backend/internal/specialists/runtime"
"eai_agentplatform/backend/internal/dal"
"eai_agentplatform/backend/internal/middleware"
"eai_agentplatform/backend/internal/model"
"eai_agentplatform/backend/internal/repository"
"eai_agentplatform/backend/internal/store"
"eai_agentplatform/backend/internal/web"
)
// taskRecordRepo 任务仓库(便于测试时覆写)。本文件里还有两处
// taskRecordDAO 任务仓库(便于测试时覆写)。本文件里还有两处
// store.DB.Transaction —— 运行记录和交付物要在同一个事务里落库,
// QueryBuilder 不带事务,那两处维持原样。
var taskRecordRepo repository.TaskRecordRepo
var taskRecordDAO dal.TaskRecordDAO
func init() {
taskRecordRepo = repository.TaskRecordRepo{}
taskRecordDAO = dal.TaskRecordDAO{}
}
type officeSkillExecuteReq struct {
@@ -314,7 +314,7 @@ func persistOfficeExecution(task model.TaskRecord, definition officecontracts.Ru
}
func loadMyOwnedTask(c *gin.Context, user *model.User, taskID uint) (model.TaskRecord, bool) {
task, found := taskRecordRepo.GetByIDForOwners(taskID, specialistruntime.MyTaskOwners(user))
task, found := taskRecordDAO.GetByIDForOwners(taskID, specialistruntime.MyTaskOwners(user))
if !found {
web.Fail(c, web.NewNotFoundError("任务不存在"))
return model.TaskRecord{}, false
@@ -323,7 +323,7 @@ func loadMyOwnedTask(c *gin.Context, user *model.User, taskID uint) (model.TaskR
}
func reloadTask(taskID uint) (model.TaskRecord, error) {
task, found := taskRecordRepo.GetByID(taskID)
task, found := taskRecordDAO.GetByID(taskID)
if !found {
return model.TaskRecord{}, gorm.ErrRecordNotFound
}
@@ -21,7 +21,7 @@ func ListSkillDefinitions(c *gin.Context) {
b := v == "true"
exposed = &b
}
web.OK(c, skillDefinitionRepo.List(state, exposed))
web.OK(c, skillDefinitionDAO.List(state, exposed))
}
func GetSkillDefinitionByKey(c *gin.Context) {
@@ -31,7 +31,7 @@ func GetSkillDefinitionByKey(c *gin.Context) {
return
}
item, found := skillDefinitionRepo.GetByKey(key)
item, found := skillDefinitionDAO.GetByKey(key)
if !found {
web.Fail(c, web.NewNotFoundError("技能定义不存在"))
return