「仓库层」是 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>
157 lines
4.5 KiB
Go
157 lines
4.5 KiB
Go
package dal
|
|
|
|
import (
|
|
"eai_agentplatform/backend/internal/model"
|
|
)
|
|
|
|
// Question 题目仓库。
|
|
type QuestionDAO struct{ *QueryBuilder }
|
|
|
|
// List 获取题目列表(id 升序)。
|
|
//
|
|
// status 沿用本站列表的档位约定(与 CourseDAO.List 一致):
|
|
//
|
|
// "" → 只看 active(学员侧默认)
|
|
// "all" → 不过滤(管理端题库默认,含已停用)
|
|
// 其它 → 按该 status 过滤
|
|
//
|
|
// domain 为空表示不过滤该维度。
|
|
func (r QuestionDAO) List(domain, status string) []model.Question {
|
|
q := r.Type(&model.Question{})
|
|
if domain != "" {
|
|
q = q.Where("domain = ?", domain)
|
|
}
|
|
switch status {
|
|
case "":
|
|
q = q.Where("status = ?", "active")
|
|
case "all":
|
|
// 不过滤
|
|
default:
|
|
q = q.Where("status = ?", status)
|
|
}
|
|
var items []model.Question
|
|
if q.Order("id ASC").Find(&items) {
|
|
return items
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ListByIDs 按 ID 批量取题,**不过滤 status**(id 升序)。
|
|
//
|
|
// 判分专用:考试会话里下发的题目即使事后被停用,也必须能判分,
|
|
// 否则学员交了卷却判不出来。要「只取可作答题目」用 ListActiveByIDs。
|
|
func (r QuestionDAO) ListByIDs(ids []uint) []model.Question {
|
|
if len(ids) == 0 {
|
|
return nil
|
|
}
|
|
var items []model.Question
|
|
if r.Type(&items).Where("id IN ?", ids).Order("id ASC").Find(&items) {
|
|
return items
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ListActiveByIDs 按 ID 批量取「已启用」的题(id 升序)。
|
|
//
|
|
// 下发专用:错题重练等场景要剔除已停用/删除的题目。
|
|
func (r QuestionDAO) ListActiveByIDs(ids []uint) []model.Question {
|
|
if len(ids) == 0 {
|
|
return nil
|
|
}
|
|
var items []model.Question
|
|
if r.Type(&items).Where("id IN ? AND status = ?", ids, "active").Order("id ASC").Find(&items) {
|
|
return items
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// ActivePool 返回「岗位应学范围内已启用题目」的查询构建器,供抽题逻辑继续细分。
|
|
//
|
|
// 口径(P0 岗位考试抽题,抽题主流程与蓝图抽题共用,避免两处手写漂移):
|
|
// - 只取 status=active
|
|
// - domains 非空时限定 domain IN domains
|
|
// - courseIDs 非空时「题目属于这些课程,或未绑定课程但域匹配」(宽松口径,沿用原行为)
|
|
//
|
|
// 两个参数都为空表示全题库。
|
|
func (r QuestionDAO) ActivePool(domains []string, courseIDs []uint) *QueryBuilder {
|
|
q := r.Type(&model.Question{}).Where("status = ?", "active")
|
|
if len(domains) > 0 {
|
|
q = q.Where("domain IN ?", domains)
|
|
}
|
|
if len(courseIDs) > 0 {
|
|
q = q.Where("course_id IN ? OR course_id IS NULL", courseIDs)
|
|
}
|
|
return q
|
|
}
|
|
|
|
// GetByID 按 ID 获取题目。
|
|
func (r QuestionDAO) GetByID(id uint) (model.Question, bool) {
|
|
var q model.Question
|
|
if r.Type(&q).Where("id = ?", id).First(&q) {
|
|
return q, true
|
|
}
|
|
return model.Question{}, false
|
|
}
|
|
|
|
// GetActiveIDs 获取指定状态的题目 ID 列表。
|
|
func (r QuestionDAO) GetActiveIDs(ids []uint) []uint {
|
|
var result []uint
|
|
r.Inner().Model(&model.Question{}).Where("id IN ? AND status = ?", ids, "active").Pluck("id", &result)
|
|
return result
|
|
}
|
|
|
|
// DomainMap 返回「题目 ID → 知识域」映射。
|
|
//
|
|
// 学员能力雷达要拿答题明细里的题目 ID 反查所属域;只取两列,避免整表加载题干。
|
|
func (r QuestionDAO) DomainMap() map[uint]string {
|
|
var rows []model.Question
|
|
r.Inner().Model(&model.Question{}).Select("id", "domain").Find(&rows)
|
|
out := make(map[uint]string, len(rows))
|
|
for _, q := range rows {
|
|
out[q.ID] = q.Domain
|
|
}
|
|
return out
|
|
}
|
|
|
|
// CountByType 统计某类题目数量。
|
|
func (r QuestionDAO) CountByType(domain, qType string) int64 {
|
|
q := r.Inner().Model(&model.Question{})
|
|
if domain != "" {
|
|
q = q.Where("domain = ?", domain)
|
|
}
|
|
var c int64
|
|
q.Where("type = ? AND status = ?", qType, "active").Count(&c)
|
|
return c
|
|
}
|
|
|
|
// Insert 创建题目。
|
|
func (r QuestionDAO) Insert(item *model.Question) bool {
|
|
return r.QueryBuilder.Insert(item)
|
|
}
|
|
|
|
// Update 更新题目。
|
|
func (r QuestionDAO) Update(item *model.Question) bool {
|
|
return r.Save(item)
|
|
}
|
|
|
|
// Delete 软删除。
|
|
func (r QuestionDAO) Delete(id uint) bool {
|
|
return r.Type(&model.Question{}).Where("id = ?", id).Updates(map[string]any{"status": "inactive"})
|
|
}
|
|
|
|
// PickRandom 随机抽取 N 道题。
|
|
func (r QuestionDAO) PickRandom(domain, qType string, count int, excludeIDs []uint) []model.Question {
|
|
q := r.Type(&model.Question{}).Where("status = ? AND type = ?", "active", qType)
|
|
if domain != "" {
|
|
q = q.Where("domain = ?", domain)
|
|
}
|
|
if len(excludeIDs) > 0 {
|
|
q = q.Where("id NOT IN ?", excludeIDs)
|
|
}
|
|
var items []model.Question
|
|
if q.Order("RANDOM()").Limit(count).Find(&items) {
|
|
return items
|
|
}
|
|
return nil
|
|
}
|