Files
eaiadminandClaude Code e8aedd50d2 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>
2026-09-19 09:19:21 +08:00

129 lines
3.6 KiB
Go
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package dal
import (
"eai_agentplatform/backend/internal/model"
)
// Position 岗位仓库。
type PositionDAO struct{ *QueryBuilder }
// List 获取岗位列表。
func (r PositionDAO) List(status string) []model.Position {
q := r.Type(&model.Position{})
if status != "" {
q = q.Where("status = ?", status)
} else {
q = q.Where("status = ?", "active")
}
var items []model.Position
if q.Order("id ASC").Find(&items) {
return items
}
return nil
}
// GetByID 按 ID 获取。
func (r PositionDAO) GetByID(id uint) (model.Position, bool) {
var p model.Position
if r.Type(&p).Where("id = ?", id).First(&p) {
return p, true
}
return model.Position{}, false
}
// GetByName 按名称获取。
func (r PositionDAO) GetByName(name string) (model.Position, bool) {
var p model.Position
if r.Type(&p).Where("name = ?", name).First(&p) {
return p, true
}
return model.Position{}, false
}
// Insert 创建岗位。
func (r PositionDAO) Insert(p *model.Position) bool {
return r.QueryBuilder.Insert(p)
}
// Update 更新岗位。
func (r PositionDAO) Update(p *model.Position) bool {
return r.Save(p)
}
// Delete 软删除。
func (r PositionDAO) Delete(id uint) bool {
return r.Type(&model.Position{}).Where("id = ?", id).Updates(map[string]any{"status": "inactive"})
}
// CountByDepartment 统计某部门的岗位数。
func (r PositionDAO) CountByDepartment(departmentID uint) int64 {
var c int64
r.Inner().Model(&model.Position{}).Where("department_id = ?", departmentID).Count(&c)
return c
}
// CountByName 按名称统计(唯一性检查)。
func (r PositionDAO) CountByName(name string, excludeID *uint) int64 {
q := r.Inner().Model(&model.Position{}).Where("name = ?", name)
if excludeID != nil {
q = q.Where("id <> ?", *excludeID)
}
var c int64
q.Count(&c)
return c
}
// ============ 岗位知识映射(PositionKnowledge) ============
// Knowledge 取岗位知识映射(按 id ASC)。学员应学清单与管理员编辑页共用。
func (r PositionDAO) Knowledge(positionID uint) []model.PositionKnowledge {
var items []model.PositionKnowledge
if r.Type(&items).Where("position_id = ?", positionID).Order("id ASC").Find(&items) {
return items
}
return nil
}
// ReplaceKnowledge 整表覆盖岗位知识映射(先删旧、再批量插入)。
// 两步非原子:调用方若需强一致,应在事务中执行。
func (r PositionDAO) ReplaceKnowledge(positionID uint, rows []model.PositionKnowledge) bool {
if !r.Type(&model.PositionKnowledge{}).Where("position_id = ?", positionID).
Delete(&model.PositionKnowledge{}) {
return false
}
if len(rows) == 0 {
return true
}
return r.Type(&rows).Create(&rows)
}
// CountKnowledge 统计岗位知识映射条数。
func (r PositionDAO) CountKnowledge(positionID uint) int64 {
var c int64
r.Inner().Model(&model.PositionKnowledge{}).Where("position_id = ?", positionID).Count(&c)
return c
}
// ============ 岗位考试蓝图(PositionExamBlueprint) ============
// Blueprints 取岗位考试蓝图(按 id ASC)。
func (r PositionDAO) Blueprints(positionID uint) []model.PositionExamBlueprint {
var items []model.PositionExamBlueprint
if r.Type(&items).Where("position_id = ?", positionID).Order("id ASC").Find(&items) {
return items
}
return nil
}
// ReplaceBlueprints 整表覆盖岗位考试蓝图(先删旧、再批量插入)。
func (r PositionDAO) ReplaceBlueprints(positionID uint, rows []model.PositionExamBlueprint) bool {
if !r.Type(&model.PositionExamBlueprint{}).Where("position_id = ?", positionID).
Delete(&model.PositionExamBlueprint{}) {
return false
}
if len(rows) == 0 {
return true
}
return r.Type(&rows).Create(&rows)
}