EaiLab/pj0235-eai_agentplatform
11
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
45 Commits 1 Branch 0 Tags
d1a737d44822c1396bc6bd7a297e37612741b0d6
Commit Graph
4 Commits
Author SHA1 Message Date
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
eaiadminandClaude Code 19cf6fb5f2 refactor: 后端仓库层收口（A3：考试/部门/学习/证书/档案/公司介绍） 
把 A 档剩余对象的 api 裸查询全部收进仓库，api 层裸 store.DB 从 182 降到 99，
剩下的全是 B 档（任务/项目/笔记等尚无仓库的对象）与 C 档（报表聚合查询）。

按对象补齐的仓库方法：
- QuestionRepo：List 重写（status 档位改为显式 all/空/具体值）、
  ListByIDs（判分不过滤 status）、ListActiveByIDs（下发剔除停用）、
  ActivePool（抽题口径，主流程与蓝图共用）、DomainMap（能力雷达反查域）
- ExamPaperRepo.List；ExamRecordRepo.ListByUserChronological（趋势图正序）
- DepartmentRepo.ListByStatus / CountByName
- UserRepo.ListEmployees / CountActiveByDepartment / RenameDepartment
- LearningProgressRepo.ListAll；CertificateRepo.ListAll / GetByExamRecord
- MediaFileRepo.ListApprovedByBindType

顺带修掉两处隐患：
- CertificateRepo.GetByUserAndExam 按不存在的 exam_id 列查，一调即 SQL 报错，
  换成按 exam_record_id 的 GetByExamRecord（颁发幂等本来就该按考试记录）
- exam.go 与 system.go 各声明了一个 ExamRecordRepo 变量，同一个仓库两份变量
  会导致测试覆写时行为分叉，统一为一个 examRecordRepo

考证来源（趋势图正序 vs 列表页倒序）与抽题口径（岗位蓝图/岗位知识映射两条路径）
各自抽成单一出处，避免两处手写漂移。聚合与百分比计算仍留在 handler，未搬进仓库。

验证：tmp 验证程序走真实路由 + 真实 HTTP，对 DB 副本跑 111 项断言全绿
（覆盖停用题仍可判分、错题重练剔除停用题、趋势正序、改名同步 user.department
且 updated_at 仍刷新、未通过的正式考不发证书、公司介绍只出 approved 素材等）。
另对其中 8 条关键语义做了变异测试：逐条注入反向实现，确认断言确实会失败，
并因此发现并修掉验证程序自身一处漏洞（写语句的约束错误只在 rows.Err() 浮出，
原先未检查，导致一条断言实为空断言）。

原始 data/eai_agentplatform.db 全程未触碰，md5 复核一致。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-19 01:41:33 +08:00
eaiadminandClaude Code 14f303459e refactor: 后端仓库层收口（A1：课程/产品/素材）+ 收进工作区既有对象化重构 
本提交含两部分。第一部分是本轮工作；第二部分是此前一直留在工作区、
从未提交的对象化重构，与第一部分在文件上互相咬合（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>
 2026-09-19 01:23:51 +08:00
eaiadminandClaude Code 0455f064ac feat: 新增语音转文字（ASR）功能 
- 后端：新增 /api/audio/transcribe 接口，调用 Ollama whisper 进行语音识别
- 前端：新增 AudioTranscribePage.vue 页面，支持 MP3/WAV/M4A/OGG/FLAC 等格式
- 注册路由、工具卡片、智能助手欢迎语更新

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-14 00:53:36 +08:00