本提交含两部分。第一部分是本轮工作;第二部分是此前一直留在工作区、
从未提交的对象化重构,与第一部分在文件上互相咬合(internal/repository
整个包都是未跟踪状态,且 api 层已有文件引用它),无法拆成两个可编译的提交。
一、仓库层收口 A1 批(本轮工作)
把 api 层手写的 store.DB 查询收进具名仓库方法,只给真正获益的对象做方法,
不机械包裹全量。本批迁移 22 处裸查询(courses.go 9 / media.go 12 / products.go 1),
新增方法:
- MediaFileRepo.ListByBind / ListForAudit / MarkExtracted
- KnowledgeChunkRepo.CountByMediaFile
- ProductRepo.GetVisibleByID
两条业务口径改由仓库单点持有,避免各处手写漂移:
「只有 approved 素材出现在课程详情」与「已停用产品不在课程详情露出」。
修掉两个真实缺陷:
- ProductRepo.GetByID 缺 Where 条件。此前 GET /api/products/{id} 对任意 id 都返回
第一条产品、对不存在的 id 返回 200,且 PUT /api/products/{id} 会覆盖第一条产品
—— 数据损坏级。全仓扫描确认这是唯一一处同型写法。
- ProductRepo.Delete 写 status="deleted",而 DELETE 处理器文档与回包都声称
"inactive",接口在说谎;管理员用 status=all 拉列表会看到前端不认识的状态。
已对齐为 inactive(与 CourseRepo.Delete 一致)。
删除 8 个零调用且列名不存在的死方法(一调即 SQL 报错):
- media_file 上的 file_path / file_type / approval_status 三列并不存在,
GetByPath / ListByType / UpdateStatus 全废
- knowledge_chunk 上的 space_id 列不存在(模型早已改为 knowledge_space_key),
List / Total / ListBySpaceIDs / DeleteBySpace / SearchByVector 全废
取舍边界:能对当前 schema 跑通的死方法保留,跑不通的删或修。
CourseRepo.List 补齐 status=all 档(此前传给它会当作 status='all' 过滤出空列表)。
该方法此前零调用,现与产品列表语义对齐。
验证:go build ./... 与 go test ./... 全绿;另用真实 HTTP 请求验证 34 项
(课程 17 / 产品 3 / 素材 14),跑在数据库副本与独立 KB_DATA_DIR 上,
含 multipart 真上传 → 审批 → pdftotext 提取 → 分片入库的完整链路。
二、此前未提交的对象化重构(非本轮工作)
- 新增 internal/repository 仓库层、connectors、skills、specialists、xapps、jsonutil,
model/task_record|task_run|task_artifact、api/task_runtime|action_definition|chat_message
- 删除 api/app_definition、connectors、my_app_center、notification、office_skill、
export_docx|pptx|xlsx、official_account_* 等,随 XApp/Skill/Specialist/Connector
可插拔打包方向(AR10/AR11)调整
- 资产目录归位:backend-go/knowledge_source → assets/knowledge/source、
training_materials → assets/training/materials;README 内相对路径同步加深两级;
deploy env 补 ASSET_ROOT_DIR 并改 KNOWLEDGE_SOURCE_DIR / TRAINING_MATERIALS_DIR
- 前端新增 skills/ specialists/ connectors/ xapps/ 目录与对应页面
验证:前端 npm run build 通过(7.26s)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
354 lines
9.0 KiB
Go
354 lines
9.0 KiB
Go
package api
|
||
|
||
import (
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"eai_agentplatform/backend/internal/middleware"
|
||
"eai_agentplatform/backend/internal/model"
|
||
"eai_agentplatform/backend/internal/repository"
|
||
"eai_agentplatform/backend/internal/web"
|
||
)
|
||
|
||
var (
|
||
positionRepo repository.PositionRepo
|
||
courseRepo repository.CourseRepo // productRepo 定义在 products.go
|
||
)
|
||
|
||
func init() {
|
||
positionRepo = repository.PositionRepo{}
|
||
courseRepo = repository.CourseRepo{}
|
||
}
|
||
|
||
// ============ 岗位 CRUD(管理员) ============
|
||
|
||
// ListPositions GET /api/positions?status= —— 岗位列表
|
||
func ListPositions(c *gin.Context) {
|
||
items := positionRepo.List(c.Query("status"))
|
||
web.OK(c, items)
|
||
}
|
||
|
||
// CreatePosition POST /api/positions (admin)
|
||
func CreatePosition(c *gin.Context) {
|
||
var p model.Position
|
||
if err := c.ShouldBindJSON(&p); err != nil {
|
||
web.Fail(c, web.NewBadRequest("请求参数错误"))
|
||
return
|
||
}
|
||
if p.Code == "" || p.Name == "" {
|
||
web.Fail(c, web.NewBadRequest("编号、名称为必填"))
|
||
return
|
||
}
|
||
if p.Status == "" {
|
||
p.Status = "active"
|
||
}
|
||
if positionRepo.CountByName(p.Code, nil) > 0 {
|
||
web.Fail(c, web.NewConflictError("岗位编号已存在"))
|
||
return
|
||
}
|
||
if !positionRepo.Insert(&p) {
|
||
web.Fail(c, web.NewBadRequest("创建岗位失败"))
|
||
return
|
||
}
|
||
web.OK(c, p)
|
||
}
|
||
|
||
// UpdatePosition PUT /api/positions/{id} (admin)
|
||
func UpdatePosition(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
p, found := positionRepo.GetByID(id)
|
||
if !found {
|
||
web.Fail(c, web.NewNotFoundError("岗位不存在"))
|
||
return
|
||
}
|
||
var req model.Position
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
web.Fail(c, web.NewBadRequest("请求参数错误"))
|
||
return
|
||
}
|
||
if req.Name == "" {
|
||
web.Fail(c, web.NewBadRequest("名称为必填"))
|
||
return
|
||
}
|
||
if req.Status == "" {
|
||
req.Status = "active"
|
||
}
|
||
if req.Code != "" && req.Code != p.Code {
|
||
if positionRepo.CountByName(req.Code, &id) > 0 {
|
||
web.Fail(c, web.NewConflictError("岗位编号已存在"))
|
||
return
|
||
}
|
||
p.Code = req.Code
|
||
}
|
||
p.Name = req.Name
|
||
p.Description = req.Description
|
||
p.Status = req.Status
|
||
if !positionRepo.Update(&p) {
|
||
web.Fail(c, web.NewBadRequest("更新岗位失败"))
|
||
return
|
||
}
|
||
web.OK(c, p)
|
||
}
|
||
|
||
// DeletePosition DELETE /api/positions/{id} (admin) —— 软删除(status=inactive)
|
||
func DeletePosition(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
if !positionRepo.Delete(id) {
|
||
web.Fail(c, web.NewBadRequest("停用岗位失败"))
|
||
return
|
||
}
|
||
web.OK(c, gin.H{"id": id, "status": "inactive"})
|
||
}
|
||
|
||
// ============ 岗位知识映射(管理员) ============
|
||
|
||
// positionKnowledgeReq 映射条目入参(与 model.PositionKnowledge 同构)
|
||
type positionKnowledgeReq struct {
|
||
Domain string `json:"domain"`
|
||
CourseID *uint `json:"course_id"`
|
||
ProductID *uint `json:"product_id"`
|
||
RequiredLevel string `json:"required_level"`
|
||
Weight float64 `json:"weight"`
|
||
IsMandatory bool `json:"is_mandatory"`
|
||
}
|
||
|
||
// ListPositionKnowledge GET /api/positions/{id}/knowledge —— 某岗位知识映射列表
|
||
func ListPositionKnowledge(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
items := positionRepo.Knowledge(id)
|
||
if items == nil {
|
||
items = []model.PositionKnowledge{}
|
||
}
|
||
web.OK(c, items)
|
||
}
|
||
|
||
// SavePositionKnowledge PUT /api/positions/{id}/knowledge —— 保存映射(整表覆盖)
|
||
func SavePositionKnowledge(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
_, found := positionRepo.GetByID(id)
|
||
if !found {
|
||
web.Fail(c, web.NewNotFoundError("岗位不存在"))
|
||
return
|
||
}
|
||
var req struct {
|
||
Items []positionKnowledgeReq `json:"items"`
|
||
}
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
web.Fail(c, web.NewBadRequest("请求参数错误"))
|
||
return
|
||
}
|
||
// 校验并规整映射条目
|
||
rows := make([]model.PositionKnowledge, 0, len(req.Items))
|
||
for _, it := range req.Items {
|
||
if !validDomains[it.Domain] {
|
||
web.Fail(c, web.NewBadRequest("知识域 domain 非法(仅 company/product/sales)"))
|
||
return
|
||
}
|
||
if it.RequiredLevel == "" {
|
||
it.RequiredLevel = model.LevelL1
|
||
}
|
||
if !model.ValidLevels[it.RequiredLevel] {
|
||
web.Fail(c, web.NewBadRequest("级别 required_level 非法(仅 L1/L2/L3/L4)"))
|
||
return
|
||
}
|
||
if it.Weight <= 0 {
|
||
it.Weight = 1
|
||
}
|
||
rows = append(rows, model.PositionKnowledge{
|
||
PositionID: id,
|
||
Domain: it.Domain,
|
||
CourseID: it.CourseID,
|
||
ProductID: it.ProductID,
|
||
RequiredLevel: it.RequiredLevel,
|
||
Weight: it.Weight,
|
||
IsMandatory: it.IsMandatory,
|
||
})
|
||
}
|
||
// 整表覆盖:先删旧,再批量插入
|
||
if !positionRepo.ReplaceKnowledge(id, rows) {
|
||
web.Fail(c, web.NewBadRequest("保存岗位知识映射失败"))
|
||
return
|
||
}
|
||
out := positionRepo.Knowledge(id)
|
||
if out == nil {
|
||
out = []model.PositionKnowledge{}
|
||
}
|
||
web.OK(c, out)
|
||
}
|
||
|
||
// ============ 用户设岗(管理员) ============
|
||
|
||
// SetUserPosition PUT /api/users/{id}/position —— {position_id: 5 | null}
|
||
func SetUserPosition(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
u, found := userRepo.GetByID(id)
|
||
if !found {
|
||
web.Fail(c, web.NewNotFoundError("用户不存在"))
|
||
return
|
||
}
|
||
var req struct {
|
||
PositionID *uint `json:"position_id"`
|
||
}
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
web.Fail(c, web.NewBadRequest("请求参数错误"))
|
||
return
|
||
}
|
||
if req.PositionID != nil {
|
||
_, found := positionRepo.GetByID(*req.PositionID)
|
||
if !found {
|
||
web.Fail(c, web.NewBadRequest("岗位不存在或已停用"))
|
||
return
|
||
}
|
||
}
|
||
u.PositionID = req.PositionID
|
||
if !userRepo.Update(&u) {
|
||
web.Fail(c, web.NewBadRequest("设置用户岗位失败"))
|
||
return
|
||
}
|
||
web.OK(c, gin.H{"id": u.ID, "position_id": u.PositionID})
|
||
}
|
||
|
||
// ============ 学员:我的岗位应学清单 ============
|
||
|
||
// MyPosition GET /api/my/position —— 我的岗位 + 应学范围(课程/产品/域)
|
||
func MyPosition(c *gin.Context) {
|
||
u := middleware.CurrentUser(c)
|
||
if u == nil || u.PositionID == nil {
|
||
web.OK(c, gin.H{"position": nil, "knowledge": []gin.H{}, "count": 0})
|
||
return
|
||
}
|
||
pos, found := positionRepo.GetByID(*u.PositionID)
|
||
if !found || pos.Status != "active" {
|
||
web.OK(c, gin.H{"position": nil, "knowledge": []gin.H{}, "count": 0})
|
||
return
|
||
}
|
||
|
||
pks := positionRepo.Knowledge(pos.ID)
|
||
|
||
// 批量解析课程/产品名称
|
||
courseIDs := make([]uint, 0, len(pks))
|
||
productIDs := make([]uint, 0, len(pks))
|
||
for _, pk := range pks {
|
||
if pk.CourseID != nil {
|
||
courseIDs = append(courseIDs, *pk.CourseID)
|
||
}
|
||
if pk.ProductID != nil {
|
||
productIDs = append(productIDs, *pk.ProductID)
|
||
}
|
||
}
|
||
courseName := courseRepo.NamesByIDs(courseIDs)
|
||
productName := productRepo.NamesByIDs(productIDs)
|
||
|
||
list := make([]gin.H, 0, len(pks))
|
||
for _, pk := range pks {
|
||
list = append(list, gin.H{
|
||
"id": pk.ID,
|
||
"domain": pk.Domain,
|
||
"course_id": pk.CourseID,
|
||
"product_id": pk.ProductID,
|
||
"course_name": nameOrDash(courseName, pk.CourseID),
|
||
"product_name": nameOrDash(productName, pk.ProductID),
|
||
"required_level": pk.RequiredLevel,
|
||
"weight": pk.Weight,
|
||
"is_mandatory": pk.IsMandatory,
|
||
})
|
||
}
|
||
web.OK(c, gin.H{
|
||
"position": pos,
|
||
"knowledge": list,
|
||
"count": len(list),
|
||
})
|
||
}
|
||
|
||
// ============ 岗位考试蓝图(管理员) ============
|
||
|
||
type blueprintReq struct {
|
||
Domain string `json:"domain"`
|
||
Type string `json:"type"`
|
||
Count int `json:"count"`
|
||
}
|
||
|
||
// ListPositionBlueprint GET /api/positions/{id}/blueprint —— 某岗位考试蓝图列表
|
||
func ListPositionBlueprint(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
items := positionRepo.Blueprints(id)
|
||
if items == nil {
|
||
items = []model.PositionExamBlueprint{}
|
||
}
|
||
web.OK(c, items)
|
||
}
|
||
|
||
// SavePositionBlueprint PUT /api/positions/{id}/blueprint —— 保存蓝图(整表覆盖)
|
||
func SavePositionBlueprint(c *gin.Context) {
|
||
id, ok := parseID(c, "id")
|
||
if !ok {
|
||
return
|
||
}
|
||
_, found := positionRepo.GetByID(id)
|
||
if !found {
|
||
web.Fail(c, web.NewNotFoundError("岗位不存在"))
|
||
return
|
||
}
|
||
var req struct {
|
||
Items []blueprintReq `json:"items"`
|
||
}
|
||
if err := c.ShouldBindJSON(&req); err != nil {
|
||
web.Fail(c, web.NewBadRequest("请求参数错误"))
|
||
return
|
||
}
|
||
rows := make([]model.PositionExamBlueprint, 0, len(req.Items))
|
||
for _, it := range req.Items {
|
||
if !validQTypes[it.Type] {
|
||
web.Fail(c, web.NewBadRequest("题型 type 非法(仅 single/multiple/judge/essay)"))
|
||
return
|
||
}
|
||
if it.Domain != "" && !validDomains[it.Domain] {
|
||
web.Fail(c, web.NewBadRequest("知识域 domain 非法(仅 company/product/sales,或留空不限)"))
|
||
return
|
||
}
|
||
if it.Count <= 0 {
|
||
web.Fail(c, web.NewBadRequest("蓝图各条 count 必须大于 0"))
|
||
return
|
||
}
|
||
rows = append(rows, model.PositionExamBlueprint{
|
||
PositionID: id, Domain: it.Domain, Type: it.Type, Count: it.Count,
|
||
})
|
||
}
|
||
if !positionRepo.ReplaceBlueprints(id, rows) {
|
||
web.Fail(c, web.NewBadRequest("保存岗位考试蓝图失败"))
|
||
return
|
||
}
|
||
out := positionRepo.Blueprints(id)
|
||
if out == nil {
|
||
out = []model.PositionExamBlueprint{}
|
||
}
|
||
web.OK(c, out)
|
||
}
|
||
|
||
func nameOrDash(m map[uint]string, id *uint) string {
|
||
if id == nil {
|
||
return ""
|
||
}
|
||
if n, ok := m[*id]; ok {
|
||
return n
|
||
}
|
||
return ""
|
||
}
|