「仓库层」是 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>
121 lines
3.4 KiB
Go
121 lines
3.4 KiB
Go
package api
|
||
|
||
import (
|
||
"time"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"eai_agentplatform/backend/internal/dal"
|
||
"eai_agentplatform/backend/internal/middleware"
|
||
"eai_agentplatform/backend/internal/model"
|
||
"eai_agentplatform/backend/internal/web"
|
||
)
|
||
|
||
// learningDAO 学习进度仓库(便于测试时覆写),包内共享。
|
||
var learningDAO dal.LearningProgressDAO
|
||
|
||
func init() {
|
||
learningDAO = dal.LearningProgressDAO{}
|
||
}
|
||
|
||
var validItemTypes = map[string]bool{"company": true, "product": true, "course": true}
|
||
|
||
// RecordLearningProgress POST /api/learning/progress —— 员工浏览内容时上报进度
|
||
func RecordLearningProgress(c *gin.Context) {
|
||
u := middleware.CurrentUser(c)
|
||
if u == nil {
|
||
web.Fail(c, web.NewAuthError("未登录"))
|
||
return
|
||
}
|
||
var req struct {
|
||
ItemType string `json:"item_type"`
|
||
ItemID uint `json:"item_id"`
|
||
}
|
||
if err := c.ShouldBindJSON(&req); err != nil || !validItemTypes[req.ItemType] {
|
||
web.Fail(c, web.NewBadRequest("item_type 必填且合法(company/product/course)"))
|
||
return
|
||
}
|
||
if req.ItemType == "company" {
|
||
req.ItemID = 0
|
||
}
|
||
lp := model.LearningProgress{UserID: u.ID, ItemType: req.ItemType, ItemID: req.ItemID}
|
||
// 幂等:已存在则仅刷新 updated_at;首次记录才加分(避免重复刷分)
|
||
if _, exists := learningDAO.Get(u.ID, req.ItemType, req.ItemID); !exists {
|
||
if !learningDAO.Insert(&lp) {
|
||
web.Fail(c, web.NewBadRequest("记录学习进度失败"))
|
||
return
|
||
}
|
||
awardFirstView(u.ID, req.ItemType, req.ItemID)
|
||
} else {
|
||
// Upsert 命中已存在分支时只刷新 updated_at,不新增行
|
||
learningDAO.Upsert(&lp)
|
||
}
|
||
web.OK(c, gin.H{"recorded": true, "item_type": req.ItemType, "item_id": req.ItemID})
|
||
}
|
||
|
||
// MyLearningProgress GET /api/learning/me —— 我的学习进度
|
||
func MyLearningProgress(c *gin.Context) {
|
||
u := middleware.CurrentUser(c)
|
||
if u == nil {
|
||
web.Fail(c, web.NewAuthError("未登录"))
|
||
return
|
||
}
|
||
items := learningDAO.ListByUser(u.ID)
|
||
if items == nil {
|
||
items = []model.LearningProgress{}
|
||
}
|
||
web.OK(c, items)
|
||
}
|
||
|
||
// AdminLearningProgress GET /api/system/learning-progress —— 全员学习进度(管理员)
|
||
func AdminLearningProgress(c *gin.Context) {
|
||
// 管理端全员视图:不限状态,已停用的员工也要能看到其历史进度
|
||
employees := userDAO.ListEmployees("")
|
||
items := learningDAO.ListAll()
|
||
|
||
type agg struct {
|
||
CompanyViewed bool `json:"company_viewed"`
|
||
ProductCount int `json:"product_count"`
|
||
CourseCount int `json:"course_count"`
|
||
TotalItems int `json:"total_items"`
|
||
LastViewedAt *time.Time `json:"last_viewed_at"`
|
||
}
|
||
perUser := map[uint]*agg{}
|
||
for _, lp := range items {
|
||
a := perUser[lp.UserID]
|
||
if a == nil {
|
||
a = &agg{}
|
||
perUser[lp.UserID] = a
|
||
}
|
||
switch lp.ItemType {
|
||
case "company":
|
||
a.CompanyViewed = true
|
||
case "product":
|
||
a.ProductCount++
|
||
case "course":
|
||
a.CourseCount++
|
||
}
|
||
a.TotalItems++
|
||
if a.LastViewedAt == nil || lp.UpdatedAt.After(*a.LastViewedAt) {
|
||
t := lp.UpdatedAt
|
||
a.LastViewedAt = &t
|
||
}
|
||
}
|
||
|
||
out := make([]gin.H, 0, len(employees))
|
||
for _, e := range employees {
|
||
a := perUser[e.ID]
|
||
if a == nil {
|
||
a = &agg{}
|
||
}
|
||
out = append(out, gin.H{
|
||
"user_id": e.ID, "username": e.Username, "full_name": e.FullName,
|
||
"department": e.Department, "position": e.Position,
|
||
"company_viewed": a.CompanyViewed, "product_count": a.ProductCount,
|
||
"course_count": a.CourseCount, "total_items": a.TotalItems,
|
||
"last_viewed_at": a.LastViewedAt,
|
||
})
|
||
}
|
||
web.OK(c, gin.H{"users": out})
|
||
}
|