后端: 1. Memory 管理面 API 落地(“我的记忆”增删改查 + 恢复) - 补齐 List/Get/Create/Update/Delete/Restore 的 handler、请求模型与返回视图 - 注册 `/api/v1/memory/items*` 路由并接入 MemoryHandler - 新增 memory item not found / invalid memory type / invalid memory content 三类管理面错误码 2. Memory Module / Service / Repo 扩展为“可管理 + 可治理”门面 - 新增 NewModuleWithObserve / ObserveDeps,导出 GetItem / CreateItem / UpdateItem / DeleteItem / RestoreItem / RunDedupCleanup / MemoryObserver / MemoryMetrics - 新增手动新增、修改、恢复能力;删除链路切到 SoftDeleteByID;所有管理动作统一事务内写 audit,并桥接向量同步与管理面观测 - 补齐 CreateItemFields / UpdateItemFields、单条 Create、管理侧字段更新、软删/恢复,以及 dedup 扫描/归档所需 repo 能力 - 审计操作补齐 archive / restore 3. Memory 读侧与注入侧观测补齐 - HybridRetrieve 返回 telemetry,统一记录 pinned hit / semantic hit / dedup drop / degraded / RAG fallback,并上报读取命中、去重丢弃、RAG 降级指标 - AgentService 持有 memory observer / metrics;injectMemoryContext 对读取失败、空注入、成功注入补齐结构化日志与注入计数 4. Worker / 决策 / 向量同步链路治理增强 - 召回结果显式携带 fallbackMode;hash 精确命中、rag→mysql 降级、最终动作统一写入决策观测 - 接入 vectorSyncer / observer / metrics;为 job 重试、任务成功/失败、决策分布与 fallback 补齐打点;向量 upsert/delete 统一改走公共 Syncer,并收敛 parseMemoryID 解析逻辑 5. 启动层接入 Memory 观测依赖 - 启动时创建 LoggerObserver + MetricsRegistry,并通过 NewModuleWithObserve 注入 memory 模块 前端:无 仓库:无
115 lines
5.8 KiB
Go
115 lines
5.8 KiB
Go
// Package routers 路由配置
|
|
// 定义所有HTTP路由和路由组
|
|
package routers
|
|
|
|
import (
|
|
"log"
|
|
|
|
"github.com/LoveLosita/smartflow/backend/api"
|
|
"github.com/LoveLosita/smartflow/backend/dao"
|
|
"github.com/LoveLosita/smartflow/backend/middleware"
|
|
"github.com/LoveLosita/smartflow/backend/pkg"
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/spf13/viper"
|
|
)
|
|
|
|
// StartEngine 注册路由
|
|
func StartEngine(r *gin.Engine) {
|
|
// 从配置中获取端口
|
|
port := viper.GetString("server.port")
|
|
if port == "" {
|
|
port = "8080" // 默认端口
|
|
}
|
|
|
|
// 启动服务器
|
|
log.Printf("Server starting on port %s...", port)
|
|
if err := r.Run(":" + port); err != nil {
|
|
log.Fatalf("Failed to start server: %v", err)
|
|
}
|
|
}
|
|
|
|
func RegisterRouters(handlers *api.ApiHandlers, cache *dao.CacheDAO, userRepo *dao.UserDAO, limiter *pkg.RateLimiter) *gin.Engine {
|
|
// 初始化Gin引擎
|
|
r := gin.Default()
|
|
// 在这里注册所有的路由和路由组
|
|
apiGroup := r.Group("/api/v1")
|
|
{
|
|
// 健康检查路由
|
|
apiGroup.GET("/health", func(c *gin.Context) {
|
|
c.JSON(200, gin.H{
|
|
"status": "ok",
|
|
"version": "0.4.0.dev",
|
|
})
|
|
})
|
|
|
|
userGroup := apiGroup.Group("/user")
|
|
{
|
|
userGroup.POST("/register", handlers.UserHandler.UserRegister)
|
|
userGroup.POST("/login", handlers.UserHandler.UserLogin)
|
|
userGroup.POST("/refresh-token", handlers.UserHandler.RefreshTokenHandler)
|
|
userGroup.POST("/logout", middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1), handlers.UserHandler.UserLogout)
|
|
}
|
|
taskGroup := apiGroup.Group("/task")
|
|
{
|
|
taskGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
taskGroup.POST("/create", middleware.IdempotencyMiddleware(cache), handlers.TaskHandler.AddTask)
|
|
taskGroup.PUT("/complete", middleware.IdempotencyMiddleware(cache), handlers.TaskHandler.CompleteTask)
|
|
taskGroup.PUT("/undo-complete", middleware.IdempotencyMiddleware(cache), handlers.TaskHandler.UndoCompleteTask)
|
|
taskGroup.GET("/get", handlers.TaskHandler.GetUserTasks)
|
|
}
|
|
courseGroup := apiGroup.Group("/course")
|
|
{
|
|
courseGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
courseGroup.POST("/validate", handlers.CourseHandler.CheckUserCourse)
|
|
courseGroup.POST("/import", middleware.IdempotencyMiddleware(cache), handlers.CourseHandler.AddUserCourses)
|
|
}
|
|
taskClassGroup := apiGroup.Group("/task-class")
|
|
{
|
|
taskClassGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
taskClassGroup.POST("/add", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.UserAddTaskClass)
|
|
taskClassGroup.GET("/list", handlers.TaskClassHandler.UserGetTaskClassInfos)
|
|
taskClassGroup.GET("/get", handlers.TaskClassHandler.UserGetCompleteTaskClass)
|
|
taskClassGroup.PUT("/update", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.UserUpdateTaskClass)
|
|
taskClassGroup.POST("/insert-into-schedule", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.UserAddTaskClassItemIntoSchedule)
|
|
taskClassGroup.DELETE("/delete-item", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.DeleteTaskClassItem)
|
|
taskClassGroup.DELETE("/delete-class", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.DeleteTaskClass)
|
|
taskClassGroup.PUT("/apply-batch-into-schedule", middleware.IdempotencyMiddleware(cache), handlers.TaskClassHandler.UserInsertBatchTaskClassItemsIntoSchedule)
|
|
}
|
|
scheduleGroup := apiGroup.Group("/schedule")
|
|
{
|
|
scheduleGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
scheduleGroup.GET("/today", handlers.ScheduleHandler.GetUserTodaySchedule)
|
|
scheduleGroup.GET("/week", handlers.ScheduleHandler.GetUserWeeklySchedule)
|
|
scheduleGroup.DELETE("/delete", middleware.IdempotencyMiddleware(cache), handlers.ScheduleHandler.DeleteScheduleEvent)
|
|
scheduleGroup.GET("/recent-completed", handlers.ScheduleHandler.GetUserRecentCompletedSchedules)
|
|
scheduleGroup.GET("/current", handlers.ScheduleHandler.GetUserOngoingSchedule)
|
|
scheduleGroup.DELETE("/undo-task-item", middleware.IdempotencyMiddleware(cache), handlers.ScheduleHandler.UserRevocateTaskItemFromSchedule)
|
|
scheduleGroup.GET("/smart-planning", handlers.ScheduleHandler.SmartPlanning)
|
|
scheduleGroup.POST("/smart-planning-multi", handlers.ScheduleHandler.SmartPlanningMulti)
|
|
}
|
|
agentGroup := apiGroup.Group("/agent")
|
|
{
|
|
agentGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
agentGroup.POST("/chat", middleware.TokenQuotaGuard(cache, userRepo), handlers.AgentHandler.ChatAgent)
|
|
agentGroup.GET("/conversation-meta", handlers.AgentHandler.GetConversationMeta)
|
|
agentGroup.GET("/conversation-list", handlers.AgentHandler.GetConversationList)
|
|
agentGroup.GET("/conversation-history", handlers.AgentHandler.GetConversationHistory)
|
|
agentGroup.GET("/schedule-preview", handlers.AgentHandler.GetSchedulePlanPreview)
|
|
agentGroup.GET("/context-stats", handlers.AgentHandler.GetContextStats)
|
|
}
|
|
memoryGroup := apiGroup.Group("/memory")
|
|
{
|
|
memoryGroup.Use(middleware.JWTTokenAuth(cache), middleware.RateLimitMiddleware(limiter, 20, 1))
|
|
memoryGroup.GET("/items", handlers.MemoryHandler.ListItems)
|
|
memoryGroup.GET("/items/:id", handlers.MemoryHandler.GetItem)
|
|
memoryGroup.POST("/items", middleware.IdempotencyMiddleware(cache), handlers.MemoryHandler.CreateItem)
|
|
memoryGroup.PATCH("/items/:id", middleware.IdempotencyMiddleware(cache), handlers.MemoryHandler.UpdateItem)
|
|
memoryGroup.DELETE("/items/:id", middleware.IdempotencyMiddleware(cache), handlers.MemoryHandler.DeleteItem)
|
|
memoryGroup.POST("/items/:id/restore", middleware.IdempotencyMiddleware(cache), handlers.MemoryHandler.RestoreItem)
|
|
}
|
|
}
|
|
// 初始化Gin引擎
|
|
log.Println("Routes setup completed")
|
|
return r
|
|
}
|