eaiadminandClaude Code
14f303459e
本提交含两部分。第一部分是本轮工作；第二部分是此前一直留在工作区、
从未提交的对象化重构，与第一部分在文件上互相咬合（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>
97 lines
2.7 KiB
Go
97 lines
2.7 KiB
Go
// Package jsonutil 提供各对象目录（store、skills、specialists、xapps、api）共用的
|
|
// JSON 序列化与合法性校验辅助函数。
|
|
//
|
|
// 该包是最底层的中立工具包：不引用任何业务/域包，只依赖标准库，因此能被
|
|
// store（最底层数据层）与各领域、api 层同时导入而不会产生 import 循环。
|
|
// 各领域原来的 mustJSON / ValidateJSONObjectJSON / ValidateJSONStringArray /
|
|
// ValidateStructuredRecordsJSON 实现统一收敛到这里，避免重复。
|
|
package jsonutil
|
|
|
|
import (
|
|
"encoding/json"
|
|
"strings"
|
|
)
|
|
|
|
// MustJSON 序列化任意值；序列化失败时返回 "[]"（与历史行为一致）。
|
|
func MustJSON(v any) string {
|
|
data, err := json.Marshal(v)
|
|
if err != nil {
|
|
return "[]"
|
|
}
|
|
return string(data)
|
|
}
|
|
|
|
// ValidateObjectJSON 校验 value 是否为合法的「对象」JSON（空串视为合法）。
|
|
func ValidateObjectJSON(value string) bool {
|
|
if trimJSON(value) == "" {
|
|
return true
|
|
}
|
|
var obj map[string]any
|
|
return json.Unmarshal([]byte(trimJSON(value)), &obj) == nil
|
|
}
|
|
|
|
// ValidateStringArrayJSON 校验 value 是否为合法的「字符串数组」JSON（空串视为合法）。
|
|
func ValidateStringArrayJSON(value string) bool {
|
|
if trimJSON(value) == "" {
|
|
return true
|
|
}
|
|
var arr []string
|
|
return json.Unmarshal([]byte(trimJSON(value)), &arr) == nil
|
|
}
|
|
|
|
// ValidateStructuredRecordsJSON 校验 value 是否为合法的「结构化记录数组」JSON（空串视为合法）。
|
|
func ValidateStructuredRecordsJSON(value string) bool {
|
|
if trimJSON(value) == "" {
|
|
return true
|
|
}
|
|
var arr []map[string]any
|
|
return json.Unmarshal([]byte(trimJSON(value)), &arr) == nil
|
|
}
|
|
|
|
func trimJSON(value string) string {
|
|
return strings.TrimSpace(value)
|
|
}
|
|
|
|
// ParseJSON 安全反序列化 JSON 字符串；空串返回 nil（不报错）。
|
|
func ParseJSON(data string, v any) error {
|
|
if trimJSON(data) == "" {
|
|
return nil
|
|
}
|
|
return json.Unmarshal([]byte(data), v)
|
|
}
|
|
|
|
// ParseStringArray 解析 JSON 字符串数组；空串返回 nil（不报错）。
|
|
func ParseStringArray(data string) ([]string, error) {
|
|
if trimJSON(data) == "" {
|
|
return nil, nil
|
|
}
|
|
var arr []string
|
|
if err := json.Unmarshal([]byte(data), &arr); err != nil {
|
|
return nil, err
|
|
}
|
|
if arr == nil {
|
|
return []string{}, nil
|
|
}
|
|
return arr, nil
|
|
}
|
|
|
|
// ParseObject 解析 JSON 对象；空串返回 nil map（不报错）。
|
|
func ParseObject(data string) (map[string]any, error) {
|
|
if trimJSON(data) == "" {
|
|
return nil, nil
|
|
}
|
|
var obj map[string]any
|
|
if err := json.Unmarshal([]byte(data), &obj); err != nil {
|
|
return nil, err
|
|
}
|
|
return obj, nil
|
|
}
|
|
|
|
// ParseArray 解析任意 JSON 数组；空串返回 nil（不报错）。
|
|
func ParseArray(data string, v any) error {
|
|
if trimJSON(data) == "" {
|
|
return nil
|
|
}
|
|
return json.Unmarshal([]byte(data), v)
|
|
}
|