「仓库层」是 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>
129 lines
3.6 KiB
Go
129 lines
3.6 KiB
Go
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)
|
||
}
|