Files
pj0235-eai_agentplatform/eai_agentplatform/backend-go/internal/api/router.go
T
eaiadminandClaude Code d0d7b3588c refactor: 对象命名标准化落地(RoleKind→ObjectKind、capability/assistant 收口)
后端
- model.SkillDefinition.RoleKind 改名 ObjectKind(列 role_kind → object_kind);
  新增 migrateSkillObjectKindColumn:先拷数据再显式 drop 旧列。
  GORM AutoMigrate 只加不删,字段改名不手写迁移就会新旧两列并存。
- Specialist 结构化列更名走同一套 migrateColumnData:
  role_card_json → interaction_card_json、source_records_json → inputs_records_json
- api/capability_definition.go(413 行)拆为 skill_action_definition.go,
  不再让 capability 充当一级对象名;该文件同时承载技能与动作定义处理器
- 新增 model/app_definition.go + api/app_definition.go:应用目录定义正式建模
- SkillDefinition 移除已废弃的 LegacyObjectEntryRoute 字段,对应迁移分支一并删除
- skill_keys.go 注释更新:权威来源为前端 staticSkillCatalog

前端
- api/assistant.js → chat.js、api/capability.js → skill.js,新增 api/appDefinition.js
- 新增 store/specialistCatalog.js、skillCatalog.js、appCatalog.js,
  取代 config/productizedApps.js(已删)
- config/workbench.js 静态目录去失真:businessApps → staticSpecialistCatalog
  (该变量装的其实是专员目录,与应用 app 语义直接冲突)、
  availableSkills → staticSkillCatalog
- 修复入口 query 协议断裂:写端 appCatalog 用 app_specialist/app_skill/app_prompt,
  读端 SmartAssistantPage 读同名参数并挂响应式监听。
  此前写读两侧命名不一致且无人读旧名,导致从应用目录打开应用时
  预置专员/技能/提示词被静默丢弃、无任何报错
- 页面与组件局部变量去失真:拿到专员对象不再命名为 app

验证:CGO_ENABLED=0 go build ./... 通过;go test ./... 全包通过;npm run build 通过。
旧变量名 businessApps / availableSkills / productizedApps / api/capability / api/assistant
全仓 grep 无残留。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 23:38:40 +08:00

258 lines
13 KiB
Go

package api
import (
"os"
"path/filepath"
"github.com/gin-gonic/gin"
"eai_agentplatform/backend/internal/config"
"eai_agentplatform/backend/internal/middleware"
)
// Cfg 全局配置,RegisterRoutes 时注入
var Cfg *config.Config
// RegisterRoutes 注册所有路由
func RegisterRoutes(r *gin.Engine, cfg *config.Config) {
Cfg = cfg
// 素材静态预览(只读):仅公开 approved/ 子目录(已审批通过文件),
// pending/ 未审批文件不对外暴露,落实「审批前置」。
if err := os.MkdirAll(filepath.Join(cfg.KBDataDir, "approved"), 0o755); err == nil {
r.Static("/media", filepath.Join(cfg.KBDataDir, "approved"))
}
r.GET("/api/health", func(c *gin.Context) {
ver := "1.1.0"
if p, err := config.LoadPlatformConfig(); err == nil {
ver = p.Version
}
c.JSON(200, gin.H{"status": "ok", "service": "eai_agentplatform-app", "version": ver})
})
auth := r.Group("/api/auth")
{
auth.POST("/login", Login)
auth.GET("/me", middleware.Auth(cfg), Me)
}
// 员工可读
r.GET("/api/company-train", middleware.Auth(cfg), GetCompanyTrain)
r.POST("/api/company-train/suggest-material", middleware.Auth(cfg), SuggestMaterial)
r.GET("/api/specialists", middleware.Auth(cfg), ListSpecialists)
r.GET("/api/specialists/by-key/:key", middleware.Auth(cfg), GetSpecialistByKey)
r.GET("/api/specialists/summary", middleware.Auth(cfg), SpecialistSummary)
r.GET("/api/skills", middleware.Auth(cfg), ListSkillDefinitions)
r.GET("/api/skills/by-key/:key", middleware.Auth(cfg), GetSkillDefinitionByKey)
r.GET("/api/apps", middleware.Auth(cfg), ListAppDefinitions)
r.GET("/api/apps/by-key/:key", middleware.Auth(cfg), GetAppDefinitionByKey)
r.GET("/api/actions", middleware.Auth(cfg), ListActionDefinitions)
r.GET("/api/actions/by-key/:key", middleware.Auth(cfg), GetActionDefinitionByKey)
r.GET("/api/workbench/overview", middleware.Auth(cfg), WorkbenchOverview)
r.GET("/api/worker/tasks", middleware.Auth(cfg), ListWorkerTasks)
r.GET("/api/worker/tasks/:id", middleware.Auth(cfg), GetWorkerTaskDetail)
// 员工自己的工作区:「新建任务」和侧边栏的任务列表走这三个。
// 归属由服务端按登录用户定,请求里的 owner 一律不读。
r.GET("/api/worker/my-tasks", middleware.Auth(cfg), ListMyTasks)
r.POST("/api/worker/my-tasks", middleware.Auth(cfg), CreateMyTask)
r.PUT("/api/worker/my-tasks/:id", middleware.Auth(cfg), UpdateMyTask)
r.DELETE("/api/worker/my-tasks/:id", middleware.Auth(cfg), DeleteMyTask)
// 项目:任务的容器。和「我的任务」同一套归属规则,归属服务端定死。
r.GET("/api/worker/projects", middleware.Auth(cfg), ListProjects)
r.POST("/api/worker/projects", middleware.Auth(cfg), CreateProject)
r.PUT("/api/worker/projects/:id", middleware.Auth(cfg), UpdateProject)
r.DELETE("/api/worker/projects/:id", middleware.Auth(cfg), DeleteProject)
r.GET("/api/worker/projects/:id/tasks", middleware.Auth(cfg), ListProjectTasks)
r.GET("/api/worker/artifacts/:id", middleware.Auth(cfg), GetWorkerArtifactDetail)
r.POST("/api/official-account/tasks", middleware.Auth(cfg), CreateOfficialAccountTask)
r.GET("/api/official-account/tasks/:id/workflow", middleware.Auth(cfg), GetOfficialAccountWorkflow)
r.PUT("/api/official-account/tasks/:id", middleware.Auth(cfg), UpdateOfficialAccountTask)
r.POST("/api/official-account/tasks/:id/steps/:stepKey", middleware.Auth(cfg), ExecuteOfficialAccountWorkflowStep)
r.POST("/api/official-account/tasks/:id/images/:imageKey/regenerate", middleware.Auth(cfg), RegenerateOfficialAccountImage)
r.GET("/api/official-account/tasks/:id/export", middleware.Auth(cfg), ExportOfficialAccountDocument)
r.GET("/api/official-account/generated-images/:filename", middleware.Auth(cfg), ServeOfficialAccountGeneratedImage)
r.GET("/api/connectors", middleware.Auth(cfg), ListConnectors)
r.GET("/api/connectors/:key", middleware.Auth(cfg), GetConnector)
r.POST("/api/connectors/:key/query", middleware.Auth(cfg), QueryConnector)
r.GET("/api/products", middleware.Auth(cfg), ListProducts)
r.GET("/api/products/:id", middleware.Auth(cfg), GetProduct)
r.GET("/api/courses", middleware.Auth(cfg), ListCourses)
r.GET("/api/courses/:id", middleware.Auth(cfg), GetCourse)
// 学员端考试
r.GET("/api/exam/list", middleware.Auth(cfg), ExamList)
r.GET("/api/exam/cover", middleware.Auth(cfg), ExamCover)
r.POST("/api/exam/start", middleware.Auth(cfg), ExamStart)
r.POST("/api/exam/submit", middleware.Auth(cfg), ExamSubmit)
r.GET("/api/exam/record", middleware.Auth(cfg), ExamRecordList)
r.GET("/api/exam/record/:recordId", middleware.Auth(cfg), ExamRecordDetail)
r.GET("/api/exam/mistakes", middleware.Auth(cfg), MyMistakes)
r.PUT("/api/exam/mistakes/:id/resolve", middleware.Auth(cfg), ResolveMistake)
r.POST("/api/exam/mistakes/practice", middleware.Auth(cfg), MistakePractice)
r.GET("/api/exam/certificates", middleware.Auth(cfg), MyCertificates)
r.GET("/api/exam/certificates/:id", middleware.Auth(cfg), CertificateDetail)
// 学员:我的岗位应学清单 / 学习档案 / 积分与排行榜
r.GET("/api/my/position", middleware.Auth(cfg), MyPosition)
r.GET("/api/my/profile", middleware.Auth(cfg), MyProfile)
r.GET("/api/my/app-center", middleware.Auth(cfg), GetMyAppCenter)
r.PUT("/api/my/app-center", middleware.Auth(cfg), UpdateMyAppCenter)
r.GET("/api/points/me", middleware.Auth(cfg), MyPoints)
r.GET("/api/points/leaderboard", middleware.Auth(cfg), Leaderboard)
// 站内消息通知
r.GET("/api/notifications", middleware.Auth(cfg), MyNotifications)
r.GET("/api/notifications/unread-count", middleware.Auth(cfg), UnreadNotificationCount)
r.PUT("/api/notifications/:id/read", middleware.Auth(cfg), MarkNotificationRead)
r.PUT("/api/notifications/read-all", middleware.Auth(cfg), MarkAllNotificationsRead)
// 素材媒体(员工/管理员均可上传、预览)
r.POST("/api/media/upload", middleware.Auth(cfg), Upload)
r.POST("/api/media/upload-init", middleware.Auth(cfg), UploadInit)
r.POST("/api/media/upload-chunk", middleware.Auth(cfg), UploadChunk)
r.POST("/api/media/upload-complete", middleware.Auth(cfg), UploadComplete)
r.GET("/api/media/preview/:mediaId", middleware.Auth(cfg), Preview)
r.GET("/api/media/status/:mediaId", middleware.Auth(cfg), MediaStatus)
r.GET("/api/knowledge/spaces", middleware.Auth(cfg), ListKnowledgeSpaces)
r.GET("/api/knowledge/search", middleware.Auth(cfg), SearchKnowledge)
r.GET("/api/knowledge/status/:sourceId", middleware.Auth(cfg), KnowledgeStatus)
// ── AI 对话(普通员工可访问,管理员访问)──
r.POST("/api/ai-chat/message", middleware.Auth(cfg), ChatMessage)
r.GET("/api/ai-chat/quick-actions", middleware.Auth(cfg), QuickActions)
r.POST("/api/ai-chat/quick-action", middleware.Auth(cfg), QuickAction)
r.GET("/api/ai/me", middleware.Auth(cfg), AIUsageMe)
r.GET("/api/ai/usage", middleware.Auth(cfg), AIUsage)
r.GET("/api/ai/routes/chat", ListChatRoutes)
r.GET("/api/ai/routes/embed", ListEmbedRoutes)
// 学习进度(员工上报 + 本人查询)
r.POST("/api/learning/progress", middleware.Auth(cfg), RecordLearningProgress)
r.GET("/api/learning/me", middleware.Auth(cfg), MyLearningProgress)
// 学习笔记(员工个人工具)
r.GET("/api/notes", middleware.Auth(cfg), ListNotes)
r.POST("/api/notes", middleware.Auth(cfg), CreateNote)
r.PUT("/api/notes/:id", middleware.Auth(cfg), UpdateNote)
r.DELETE("/api/notes/:id", middleware.Auth(cfg), DeleteNote)
// ── 报告生成(普通员工可访问)──
r.POST("/api/report/generate", middleware.Auth(cfg), ReportGenerate)
r.POST("/api/report/export/pdf", middleware.Auth(cfg), ReportExportPDF)
r.POST("/api/report/export/docx", middleware.Auth(cfg), ReportExportDOCX)
r.POST("/api/report/export/pptx", middleware.Auth(cfg), ReportExportPPTX)
r.POST("/api/report/export/xlsx", middleware.Auth(cfg), ReportExportXLSX)
r.POST("/api/report/preview", middleware.Auth(cfg), ReportPreview)
r.POST("/api/contract/review", middleware.Auth(cfg), ReviewContract)
// 文档工具
r.POST("/api/document/translate", middleware.Auth(cfg), TranslateDocument)
r.POST("/api/copy/proofread", middleware.Auth(cfg), ProofreadCopy)
r.GET("/api/copy/quick", middleware.Auth(cfg), QuickProofread)
r.POST("/api/batch/extract", middleware.Auth(cfg), ExtractBatch)
r.POST("/api/batch/files", middleware.Auth(cfg), ExtractFromFiles)
r.POST("/api/skills/office/execute", middleware.Auth(cfg), ExecuteOfficeSkill)
r.POST("/api/skills/office/ocr", middleware.Auth(cfg), ExecuteOfficeSkillOCR)
r.POST("/api/assistant/chat", middleware.Auth(cfg), Chat)
// 语音工具
r.POST("/api/audio/transcribe", middleware.Auth(cfg), TranscribeAudio)
// 管理员维护
admin := r.Group("/api")
admin.Use(middleware.Auth(cfg), middleware.RequireAdmin())
{
admin.POST("/products", CreateProduct)
admin.PUT("/products/:id", UpdateProduct)
admin.DELETE("/products/:id", DeleteProduct)
admin.POST("/products/import", ImportProducts)
admin.POST("/courses", CreateCourse)
admin.PUT("/courses/:id", UpdateCourse)
admin.GET("/exam/questions", ListQuestions)
admin.POST("/exam/questions", CreateQuestion)
admin.PUT("/exam/questions/:id", UpdateQuestion)
admin.DELETE("/exam/questions/:id", DeleteQuestion)
admin.GET("/exam/papers", ListPapers)
admin.POST("/exam/papers", CreatePaper)
admin.PUT("/exam/papers/:id", UpdatePaper)
admin.DELETE("/exam/papers/:id", DeletePaper)
admin.GET("/media/audit-list", AuditList)
admin.POST("/media/audit/:mediaId", AuditMedia)
admin.POST("/knowledge/scan", KnowledgeScan)
admin.POST("/knowledge/index/rebuild", RebuildKnowledgeIndex)
admin.POST("/knowledge/spaces", CreateKnowledgeSpace)
admin.PUT("/knowledge/spaces/:id", UpdateKnowledgeSpace)
admin.DELETE("/knowledge/spaces/:id", DeleteKnowledgeSpace)
admin.GET("/knowledge/faqs", ListKnowledgeFAQs)
admin.POST("/knowledge/faqs", CreateKnowledgeFAQ)
admin.PUT("/knowledge/faqs/:id", UpdateKnowledgeFAQ)
admin.DELETE("/knowledge/faqs/:id", DeleteKnowledgeFAQ)
admin.GET("/knowledge/audit-list", KnowledgeAuditList)
admin.POST("/knowledge/audit/:sourceId", KnowledgeAudit)
admin.GET("/knowledge/export", ExportKnowledge)
admin.GET("/positions", ListPositions)
admin.POST("/positions", CreatePosition)
admin.PUT("/positions/:id", UpdatePosition)
admin.DELETE("/positions/:id", DeletePosition)
admin.POST("/specialists", CreateSpecialist)
admin.PUT("/specialists/:id", UpdateSpecialist)
admin.DELETE("/specialists/:id", DeleteSpecialist)
admin.POST("/skills", CreateSkillDefinition)
admin.PUT("/skills/:id", UpdateSkillDefinition)
admin.DELETE("/skills/:id", DeleteSkillDefinition)
admin.POST("/apps", CreateAppDefinition)
admin.PUT("/apps/:id", UpdateAppDefinition)
admin.DELETE("/apps/:id", DeleteAppDefinition)
admin.POST("/actions", CreateActionDefinition)
admin.PUT("/actions/:id", UpdateActionDefinition)
admin.DELETE("/actions/:id", DeleteActionDefinition)
admin.POST("/worker/tasks", CreateWorkerTask)
admin.PUT("/worker/tasks/:id", UpdateWorkerTask)
admin.PUT("/worker/tasks/:id/status", UpdateWorkerTaskStatus)
admin.DELETE("/worker/tasks/:id", DeleteWorkerTask)
admin.POST("/worker/tasks/:id/actions", ExecuteWorkerTaskAction)
admin.PUT("/worker/artifacts/:id/status", UpdateWorkerArtifactStatus)
admin.GET("/positions/:id/knowledge", ListPositionKnowledge)
admin.PUT("/positions/:id/knowledge", SavePositionKnowledge)
admin.GET("/positions/:id/blueprint", ListPositionBlueprint)
admin.PUT("/positions/:id/blueprint", SavePositionBlueprint)
admin.PUT("/users/:id/position", SetUserPosition)
admin.GET("/departments", ListDepartments)
admin.POST("/departments", CreateDepartment)
admin.PUT("/departments/:id", UpdateDepartment)
admin.DELETE("/departments/:id", DeleteDepartment)
admin.GET("/system/users", ListUsers)
admin.POST("/system/users", CreateUser)
admin.PUT("/system/users/:id", UpdateUser)
admin.GET("/system/users/:id/overview", UserOverview)
admin.GET("/system/exam-records", ListExamRecords)
admin.GET("/system/exam-records/export", ExportExamRecords)
admin.GET("/system/exam-records/:id", GetExamRecord)
admin.DELETE("/system/exam-records/:id", DeleteExamRecord)
admin.GET("/system/dashboard", AdminDashboard)
admin.GET("/system/exam-stats", ExamStats)
admin.GET("/system/exam-stats-by-position", PositionExamStats)
admin.GET("/system/department-stats", DepartmentStats)
admin.GET("/system/certificates", AdminCertificates)
admin.GET("/system/exam-coverage", ExamCoverage)
admin.GET("/system/learning-progress", AdminLearningProgress)
admin.GET("/system/config", GetConfig)
admin.PUT("/system/config", UpdateConfig)
admin.GET("/ai/config", GetAIConfig)
admin.PUT("/ai/config", PutAIConfig)
admin.POST("/ai/reload", ReloadAIConfig)
admin.GET("/ai/secrets-status", SecretsStatusHandler)
admin.GET("/ai/usage/users", AIUsageUsers)
}
}