package httpapi import ( "context" "net/http" "slices" "time" postgresstore "knowledge-governance/internal/platform/postgres" ) // workerHeartbeatStore 是队列存活记录的只读视图。页面要回答“执行器在不在”, // 只能看 worker 认领任务时自己写下的 job_types;readiness 只证明接口可达。 type workerHeartbeatStore interface { ListWorkerHeartbeats(context.Context) ([]postgresstore.WorkerHeartbeat, error) } type workerCapabilityView struct { WorkerID string `json:"worker_id"` JobTypes []string `json:"job_types"` Alive bool `json:"alive"` LastSeenAt string `json:"last_seen_at"` } type testUploadCapability struct { State string `json:"state"` Consumers int `json:"consumers"` Detail string `json:"detail"` } // 与 qaopsmirror 的工作就绪判定同一个窗口:2 分钟没有认领记录就当作不在线。 const workerHeartbeatTTL = 2 * time.Minute const testUploadJobType = "test.upload" func testUploadCapabilityOf(workers []postgresstore.WorkerHeartbeat, now time.Time) testUploadCapability { alive, consumers := 0, 0 for _, worker := range workers { if now.Sub(worker.LastSeenAt) > workerHeartbeatTTL { continue } alive++ if slices.Contains(worker.JobTypes, testUploadJobType) { consumers++ } } switch { case consumers > 0: return testUploadCapability{State: "enabled", Consumers: consumers, Detail: "上传/解析执行器已注册(认领过 test.upload)"} case alive > 0: return testUploadCapability{State: "disabled", Consumers: 0, Detail: "worker 在线但没有注册 test.upload:上传/解析任务不会被消费"} default: return testUploadCapability{State: "stale", Consumers: 0, Detail: "没有有效的 worker 认领记录:执行器未运行,或从未接单"} } } func (config Config) handleWorkerCapabilities(w http.ResponseWriter, r *http.Request) { store, ok := config.Store.(workerHeartbeatStore) if !ok || store == nil { writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{ "test_upload": testUploadCapability{State: "unknown", Detail: "worker 存活记录不可用"}, "workers": []workerCapabilityView{}, }}) return } workers, err := store.ListWorkerHeartbeats(r.Context()) if err != nil { writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{ "test_upload": testUploadCapability{State: "unknown", Detail: "读取 worker 存活记录失败"}, "workers": []workerCapabilityView{}, }}) return } now := time.Now().UTC() views := make([]workerCapabilityView, 0, len(workers)) for _, worker := range workers { views = append(views, workerCapabilityView{ WorkerID: worker.WorkerID, JobTypes: worker.JobTypes, Alive: now.Sub(worker.LastSeenAt) <= workerHeartbeatTTL, LastSeenAt: worker.LastSeenAt.UTC().Format(time.RFC3339), }) } writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{ "test_upload": testUploadCapabilityOf(workers, now), "workers": views, }}) }