Files
knowledge-governance/internal/httpapi/worker_capabilities.go
T
dev 8e6094e9e5
build / build (push) Successful in 2m6s
feat(settings): worker 能力心跳读取 + 封存源对照 + 知识库映射合并
F01:新增 /api/v1/system/worker-capabilities,按 job_types 判定 test.upload 执行器是否注册,
服务卡片分「地址可达 / 凭据与库读取 / 执行器能力」三行。
F04:routing-bindings 返回 LIBRARY_SOURCE_KB_* 与一致性,设置页同屏显示入库目标与封存源。
结构:测试绑定与生产目标合并为「知识库映射」。
2026-11-17 16:04:00 +08:00

92 lines
3.0 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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,
}})
}