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