package api import ( "encoding/json" "errors" "io" "net/http" "strings" "time" "github.com/gin-gonic/gin" "github.com/jmoiron/sqlx" "git.gozeros.com/wsk/eightbf-analysis-go/internal/logging" "git.gozeros.com/wsk/eightbf-analysis-go/internal/service" ) // Handler HTTP 入口,路径与 Java AnalysisJobController 对齐。 // // 为什么用 Gin:路由、参数、中间件是这层的全部职责,业务判断仍在 JobService。 // 约定:成功业务体是 {code:0,message,data};health/ready 是给探活的扁平 JSON,不要套这层外壳。 type Handler struct { Jobs *service.JobService DB *sqlx.DB Version string Started time.Time } // Register 挂上 /api/v1/analysis 下的全部路径。方法+路径与 Java 保持一致,前端不用改。 func (h *Handler) Register(r *gin.Engine) { g := r.Group("/api/v1/analysis") g.GET("/health", h.health) g.GET("/ready", h.ready) g.POST("/jobs", h.create) g.GET("/jobs/:id", h.get) g.GET("/jobs", h.getByTask) g.POST("/jobs/:id/cancel", h.cancel) g.POST("/jobs/:id/resume", h.resume) g.POST("/jobs/:id/plan", h.patchPlan) g.POST("/jobs/:id/inject", h.inject) g.GET("/jobs/:id/result", h.result) } func (h *Handler) caller(c *gin.Context) service.Caller { return service.NewCaller(c.GetHeader("X-Account-Id"), c.GetHeader("X-Analysis-Role")) } // health 存活探活:进程在听即可,不查依赖(给进程托管用)。 func (h *Handler) health(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ "ok": true, "service": "eightbf-analysis-go", "version": h.Version, "uptime": time.Since(h.Started).Round(time.Second).String(), }) } // ready 就绪:至少能 ping MySQL;失败返回 503,便于摘流量。 func (h *Handler) ready(c *gin.Context) { body := gin.H{ "ok": true, "service": "eightbf-analysis-go", "checks": map[string]string{}, } checks := body["checks"].(map[string]string) if h.DB == nil { checks["db"] = "not_configured" body["ok"] = false c.JSON(http.StatusServiceUnavailable, body) return } if err := h.DB.PingContext(c.Request.Context()); err != nil { checks["db"] = "fail" body["ok"] = false body["error"] = err.Error() logging.L.Errorw("就绪检查失败", "check", "db", "err", err) c.JSON(http.StatusServiceUnavailable, body) return } checks["db"] = "ok" c.JSON(http.StatusOK, body) } // create 新建一场会商。空 body 允许(字段都有服务端缺省);非法 JSON 直接 400,不再当成空请求吞掉。 func (h *Handler) create(c *gin.Context) { var body service.CreateJobRequest if err := bindBody(c, &body); err != nil { Fail(c, http.StatusBadRequest, 400, "请求体不是合法 JSON") return } caller := h.caller(c) job, err := h.Jobs.Create(&body, caller) if err != nil { h.mapErr(c, err) return } logging.L.Infow("作业创建", logging.KeyReqID, RequestIDFrom(c), logging.KeyJobID, job.ID, logging.KeyRequestID, job.RequestID, logging.KeyTaskID, job.TaskID, logging.KeyAccountID, caller.AccountID, logging.KeyStatus, job.Status, ) Created(c, job) } func (h *Handler) get(c *gin.Context) { job, err := h.Jobs.Get(c.Param("id"), h.caller(c)) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } OK(c, job) } // getByTask 用 taskId 找作业。latest=true 只取最近一场;否则先找还在跑的,没有再退回最近一场。 func (h *Handler) getByTask(c *gin.Context) { taskID := strings.TrimSpace(c.Query("taskId")) if taskID == "" { Fail(c, http.StatusBadRequest, 400, "taskId required") return } latest := c.Query("latest") == "true" job, err := h.Jobs.GetByTaskID(taskID, latest, h.caller(c)) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found for taskId") return } OK(c, job) } func (h *Handler) cancel(c *gin.Context) { caller := h.caller(c) job, err := h.Jobs.Cancel(c.Param("id"), caller) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } logging.L.Infow("作业取消", logging.KeyReqID, RequestIDFrom(c), logging.KeyJobID, job.ID, logging.KeyAccountID, caller.AccountID, logging.KeyStatus, job.Status, ) OK(c, job) } func (h *Handler) resume(c *gin.Context) { var body service.ResumeJobRequest if err := bindBody(c, &body); err != nil { Fail(c, http.StatusBadRequest, 400, "请求体不是合法 JSON") return } caller := h.caller(c) job, err := h.Jobs.Resume(c.Param("id"), &body, caller) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } logging.L.Infow("作业续跑", logging.KeyReqID, RequestIDFrom(c), logging.KeyJobID, job.ID, logging.KeyAccountID, caller.AccountID, logging.KeyStatus, job.Status, logging.KeyPhase, job.Phase, ) OK(c, job) } func (h *Handler) patchPlan(c *gin.Context) { var body service.PatchJobPlanRequest if err := bindBody(c, &body); err != nil { Fail(c, http.StatusBadRequest, 400, "请求体不是合法 JSON") return } caller := h.caller(c) job, err := h.Jobs.PatchPlan(c.Param("id"), &body, caller) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } logging.L.Infow("作业改计划", logging.KeyReqID, RequestIDFrom(c), logging.KeyJobID, job.ID, logging.KeyAccountID, caller.AccountID, logging.KeyStatus, job.Status, logging.KeyModel, job.Model, ) OK(c, job) } func (h *Handler) inject(c *gin.Context) { var body service.InjectJobRequest if err := bindBody(c, &body); err != nil { Fail(c, http.StatusBadRequest, 400, "请求体不是合法 JSON") return } caller := h.caller(c) job, err := h.Jobs.Inject(c.Param("id"), &body, caller) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } // 不打印 inject 全文(脱敏),只留字数,确认请求到了即可。 logging.L.Infow("作业注入补充", logging.KeyReqID, RequestIDFrom(c), logging.KeyJobID, job.ID, logging.KeyAccountID, caller.AccountID, "chars", len([]rune(strings.TrimSpace(body.Text))), ) OK(c, job) } func (h *Handler) result(c *gin.Context) { job, err := h.Jobs.Get(c.Param("id"), h.caller(c)) if err != nil { h.mapErr(c, err) return } if job == nil { Fail(c, http.StatusNotFound, 404, "job not found") return } OK(c, gin.H{ "id": job.ID, "status": job.Status, "result": job.Result, "error": job.Error, "dialogues": job.Dialogues, }) } // mapErr 把业务错误翻成前端已经认的 HTTP 状态。未知错误才 500,并打全量 err。 func (h *Handler) mapErr(c *gin.Context, err error) { var be *service.BizError if errors.As(err, &be) { switch { case errors.Is(be.Kind, service.ErrForbidden): logging.L.Warnw("权限拒绝", logging.KeyReqID, RequestIDFrom(c), "path", c.Request.URL.Path, "msg", be.Msg, ) Fail(c, http.StatusForbidden, 403, be.Msg) case errors.Is(be.Kind, service.ErrBadState), errors.Is(be.Kind, service.ErrBadArg): logging.L.Infow("业务拒绝", logging.KeyReqID, RequestIDFrom(c), "path", c.Request.URL.Path, "msg", be.Msg, ) Fail(c, http.StatusBadRequest, 400, be.Msg) default: Fail(c, http.StatusInternalServerError, 500, be.Msg) } return } logging.L.Errorw("接口内部错误", logging.KeyReqID, RequestIDFrom(c), "path", c.Request.URL.Path, "err", err, ) Fail(c, http.StatusInternalServerError, 500, err.Error()) } // bindBody 读取 JSON。没有 body(或只有空白)视为空对象,和以前「解码失败就当空请求」里合法的那一半对齐。 // 有内容但不是 JSON 则返回错误,由调用方回 400。 func bindBody(c *gin.Context, dst interface{}) error { if c.Request.Body == nil { return nil } dec := json.NewDecoder(c.Request.Body) err := dec.Decode(dst) if err == nil || errors.Is(err, io.EOF) { return nil } return err }