refactor: 后端仓库层收口(A5:技能/应用定义 + 用户应用中心)

D25 定的对象层三类一级对象(专员 / 技能 / 应用),A4 收了专员,这次是
技能与应用。原先是 handler 里直接 store.DB.Create/Save/Delete,现在统一走
repository,与 A1~A4 同一形状:仓库方法返回 bool,三态参数用 *bool 表达。

新增:
- repository.SkillDefinitionRepo / XAppDefinitionRepo —— List / GetByID /
  GetByKey / Insert / Update / Delete
- repository.UserXAppCenterRepo —— 收藏/最近使用/自定义应用,每人一份

两处刻意偏离既有惯例,都写了理由在代码里:

1. List(state string, exposedToUser *bool) 不在仓库里定默认值。「不传 state
   就只看 active」是列表接口的契约,解析 query 参数是 handler 的活;仓库只
   执行过滤。exposedToUser 用 *bool 而非 bool,因为「不传该参数」与「传
   false」语义不同——前者要全量,压成 bool 会把不传当成 false。

2. UserXAppCenterRepo.FindByUser 返回 (row, error) 而不是 bool。「没找到」在
   这个仓库是有意义的第三态:表示该用户还没配过、调用方要新建一份。若压成
   bool,一旦读取真出错(SQLite 本地锁等待是常事)就会被当成「没配过」,转而
   写一份空白配置,把用户已有的收藏和最近使用抹掉。

技能与应用的读接口共用同一个仓库变量,只声明一处(skillDefinitionRepo 留在
admin_handlers.go)——两份变量持有同一仓库时,测试里覆写一份、另一份照旧,
行为会静默分叉。

A5 范围内的 store.DB 直用已清零;skills/api/office_handlers.go 里仍有 3 处,
是 store.DB.Transaction,QueryBuilder 不带事务,留着别动。

验证(tmp_vfy_a5,临时程序,验完已删):真实路由 + 真实 HTTP,跑在数据库
副本上。55 条断言全绿,覆盖技能/应用的列表三态、按 key 取、增改删、404 路径、
用户应用中心的空配置/覆盖写/多用户隔离。

另有 14 条变异测试确认断言真的会红(13 捕获 / 1 设计上不可观测),其中
排序断言原本是假的:三条种子的插入顺序恰好也是 sort_order 升序,删掉
ORDER BY 照样绿。补了一条「sort_order 更小但插入更晚」的记录才透光。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
eaiadmin
2026-09-19 02:11:00 +08:00
co-authored by Claude Code
parent 71f1b6246f
commit c5af5084b1
6 changed files with 235 additions and 66 deletions
@@ -0,0 +1,69 @@
package repository
import (
skillmodel "eai_agentplatform/backend/internal/skills/model"
)
// SkillDefinition 技能定义仓库。
//
// 技能是对象层三类一级对象之一(专员 / 技能 / 应用),与专员目录一样,
// 「按 key 取技能」原先在多个文件里各写一遍,统一收这里。
type SkillDefinitionRepo struct{ *QueryBuilder }
// List 技能定义列表(sort_order ASC, id ASC)。
//
// state 不在这里定默认值:「不传 state 就只看 active」是列表接口的契约,
// 由 handler 解析 query 参数后把结果传进来(与 ActionDefinitionRepo.List 同一约定)。
//
// exposedToUser 是三态:nil 表示不按该列过滤,非 nil 按值精确匹配。
// 不用 bool 是因为「不传该参数」与「传 false」语义不同,前者要全量。
func (r SkillDefinitionRepo) List(state string, exposedToUser *bool) []skillmodel.SkillDefinition {
q := r.Type(&skillmodel.SkillDefinition{})
if state != "" {
q = q.Where("state = ?", state)
}
if exposedToUser != nil {
q = q.Where("exposed_to_user = ?", *exposedToUser)
}
var items []skillmodel.SkillDefinition
if q.Order("sort_order ASC, id ASC").Find(&items) {
return items
}
return nil
}
// GetByID 按 ID 取。
func (r SkillDefinitionRepo) GetByID(id uint) (skillmodel.SkillDefinition, bool) {
var s skillmodel.SkillDefinition
if r.Type(&s).Where("id = ?", id).First(&s) {
return s, true
}
return skillmodel.SkillDefinition{}, false
}
// GetByKey 按 key 取(key 上有唯一索引)。
func (r SkillDefinitionRepo) GetByKey(key string) (skillmodel.SkillDefinition, bool) {
var s skillmodel.SkillDefinition
if r.Type(&s).Where("key = ?", key).First(&s) {
return s, true
}
return skillmodel.SkillDefinition{}, false
}
// Insert 新建技能定义。
func (r SkillDefinitionRepo) Insert(s *skillmodel.SkillDefinition) bool {
return r.QueryBuilder.Insert(s)
}
// Update 更新技能定义。
func (r SkillDefinitionRepo) Update(s *skillmodel.SkillDefinition) bool {
return r.Save(s)
}
// Delete 硬删除技能定义。
//
// 表上没有软删字段,删了就是删了 —— 跟「停用」(state=inactive)是两回事:
// 停用还留着记录,挂在它名下的技能引用仍能解释。
func (r SkillDefinitionRepo) Delete(s *skillmodel.SkillDefinition) bool {
return r.QueryBuilder.Delete(s)
}
@@ -0,0 +1,39 @@
package repository
import (
"errors"
"gorm.io/gorm"
xappmodel "eai_agentplatform/backend/internal/xapps/model"
)
// UserXAppCenter 用户自己的应用中心状态仓库(收藏 / 最近使用 / 自定义应用,每人一份)。
//
// 这里的方法签名**有意不跟**其它仓库的 bool 惯例:FindByUser 返回 error。
// 原因是本仓库的「没找到」是一个有意义的第三态 —— 它表示「该用户还没配过,
// 调用方要新建一份」。若压成 bool,一旦读取真出错(SQLite 本地锁等待是常事)
// 就会被当成「没配过」,转而写一份空白配置,把用户已有的收藏和最近使用抹掉。
// user_id 上有唯一索引,这种误写多半会撞唯一键而失败,但那是运气不是设计。
type UserXAppCenterRepo struct{ *QueryBuilder }
// FindByUser 取某用户的应用中心配置。三种结果:
// - row != nil 找到
// - row == nil, err == nil 该用户还没有配置,调用方应新建(不是错误)
// - err != nil 读取出错,调用方应报错,**不要**当成「没有配置」
func (r UserXAppCenterRepo) FindByUser(userID uint) (*xappmodel.UserXAppCenter, error) {
var row xappmodel.UserXAppCenter
err := r.Inner().Where("user_id = ?", userID).First(&row).Error
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, nil
}
if err != nil {
return nil, err
}
return &row, nil
}
// Save 保存应用中心配置(新建或更新,由 row.ID 是否为零值决定)。
func (r UserXAppCenterRepo) Save(row *xappmodel.UserXAppCenter) bool {
return r.QueryBuilder.Save(row)
}
@@ -0,0 +1,63 @@
package repository
import (
xappmodel "eai_agentplatform/backend/internal/xapps/model"
)
// XAppDefinition 应用定义仓库。
//
// 应用(App)是对象层三类一级对象之一,定位是「长程任务运行壳」。
// 本仓库只管应用目录本身的取数;用户自己的应用中心状态见 UserXAppCenterRepo。
type XAppDefinitionRepo struct{ *QueryBuilder }
// List 应用定义列表(sort_order ASC, id ASC)。
//
// state 与 exposedToUser 的约定同 SkillDefinitionRepo.List:
// state 的默认值由 handler 定,exposedToUser 用三态指针区分「不传」与「传 false」。
func (r XAppDefinitionRepo) List(state string, exposedToUser *bool) []xappmodel.XAppDefinition {
q := r.Type(&xappmodel.XAppDefinition{})
if state != "" {
q = q.Where("state = ?", state)
}
if exposedToUser != nil {
q = q.Where("exposed_to_user = ?", *exposedToUser)
}
var items []xappmodel.XAppDefinition
if q.Order("sort_order ASC, id ASC").Find(&items) {
return items
}
return nil
}
// GetByID 按 ID 取。
func (r XAppDefinitionRepo) GetByID(id uint) (xappmodel.XAppDefinition, bool) {
var a xappmodel.XAppDefinition
if r.Type(&a).Where("id = ?", id).First(&a) {
return a, true
}
return xappmodel.XAppDefinition{}, false
}
// GetByKey 按 key 取(key 上有唯一索引)。
func (r XAppDefinitionRepo) GetByKey(key string) (xappmodel.XAppDefinition, bool) {
var a xappmodel.XAppDefinition
if r.Type(&a).Where("key = ?", key).First(&a) {
return a, true
}
return xappmodel.XAppDefinition{}, false
}
// Insert 新建应用定义。
func (r XAppDefinitionRepo) Insert(a *xappmodel.XAppDefinition) bool {
return r.QueryBuilder.Insert(a)
}
// Update 更新应用定义。
func (r XAppDefinitionRepo) Update(a *xappmodel.XAppDefinition) bool {
return r.Save(a)
}
// Delete 硬删除应用定义。
func (r XAppDefinitionRepo) Delete(a *xappmodel.XAppDefinition) bool {
return r.QueryBuilder.Delete(a)
}