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

149 lines
3.8 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 api
import (
"strconv"
"github.com/gin-gonic/gin"
"eai_agentplatform/backend/internal/model"
"eai_agentplatform/backend/internal/web"
)
// 本文件的仓库实例:courseDAO 声明在 position.go,mediaDAO 声明在 media.go。
// courseView 课程详情视图(含绑定产品)
func courseView(c *gin.Context, co model.Course) {
out := gin.H{
"id": co.ID,
"code": co.Code,
"name": co.Name,
"category": co.Category,
"target_customers": co.TargetCustomers,
"forbidden_customers": co.ForbiddenCustomers,
"scripts": co.Scripts,
"sales_process": co.SalesProcess,
"objection_handling": co.ObjectionHandling,
"delivery_pitfalls": co.DeliveryPitfalls,
"report_rules": co.ReportRules,
"related_product_id": co.RelatedProductID,
"status": co.Status,
"created_at": co.CreatedAt,
"updated_at": co.UpdatedAt,
}
if co.RelatedProductID != nil {
if p, ok := productDAO.GetVisibleByID(*co.RelatedProductID); ok {
out["product"] = gin.H{"id": p.ID, "code": p.Code, "name": p.Name, "category": p.Category}
}
}
medias := mediaDAO.ListByBind("course", co.ID)
if len(medias) > 0 {
items := make([]gin.H, 0, len(medias))
for _, m := range medias {
items = append(items, gin.H{
"id": m.ID,
"filename": m.Filename,
"file_ext": m.FileExt,
"preview_url": "/api/media/preview/" + strconv.FormatUint(uint64(m.ID), 10),
})
}
out["medias"] = items
}
web.OK(c, out)
}
// ListCourses GET /api/courses?category=&status=
func ListCourses(c *gin.Context) {
web.OK(c, courseDAO.List(c.Query("category"), c.Query("status")))
}
// GetCourse GET /api/courses/{id}
func GetCourse(c *gin.Context) {
id, ok := parseID(c, "id")
if !ok {
return
}
co, found := courseDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("课程不存在"))
return
}
courseView(c, co)
}
// CreateCourse POST /api/courses (admin)
func CreateCourse(c *gin.Context) {
var co model.Course
if err := c.ShouldBindJSON(&co); err != nil {
web.Fail(c, web.NewBadRequest("请求参数错误"))
return
}
if co.Code == "" || co.Name == "" || co.Category == "" {
web.Fail(c, web.NewBadRequest("编号、名称、分类为必填"))
return
}
if courseDAO.CountByCode(co.Code, nil) > 0 {
web.Fail(c, web.NewConflictError("课程编号已存在"))
return
}
if co.Status == "" {
co.Status = "active"
}
if !courseDAO.Insert(&co) {
web.Fail(c, web.NewBadRequest("创建课程失败"))
return
}
web.OK(c, co)
}
// UpdateCourse PUT /api/courses/{id} (admin) —— 支持绑定/解绑产品
func UpdateCourse(c *gin.Context) {
id, ok := parseID(c, "id")
if !ok {
return
}
co, found := courseDAO.GetByID(id)
if !found {
web.Fail(c, web.NewNotFoundError("课程不存在"))
return
}
var req model.Course
if err := c.ShouldBindJSON(&req); err != nil {
web.Fail(c, web.NewBadRequest("请求参数错误"))
return
}
if req.Name == "" || req.Category == "" {
web.Fail(c, web.NewBadRequest("名称、分类为必填"))
return
}
if req.Status == "" {
req.Status = "active"
}
if req.Code != "" && req.Code != co.Code {
if courseDAO.CountByCode(req.Code, &id) > 0 {
web.Fail(c, web.NewConflictError("课程编号已存在"))
return
}
co.Code = req.Code
}
co.Name = req.Name
co.Category = req.Category
co.TargetCustomers = req.TargetCustomers
co.ForbiddenCustomers = req.ForbiddenCustomers
co.Scripts = req.Scripts
co.SalesProcess = req.SalesProcess
co.ObjectionHandling = req.ObjectionHandling
co.DeliveryPitfalls = req.DeliveryPitfalls
co.ReportRules = req.ReportRules
co.RelatedProductID = req.RelatedProductID
co.Status = req.Status
if !courseDAO.Update(&co) {
web.Fail(c, web.NewBadRequest("更新课程失败"))
return
}
courseView(c, co)
}