fix(ui): 修复F12-F16入口与追溯缺陷
build / build (push) Successful in 1m59s

Dockerfile 运行阶段补齐 dws_dingtalk_scan(F12),并新增 runtime-scripts 门禁
做脚本依赖闭包正负例;就绪探测每次解析当前端点/绑定/凭据并区分 404、未配置、
不可达(F13);路由写入来源路径与父目录,历史空值仅按同连接同 item 的意图读时
补齐(F14);目标筛选显示短 ID 与当前绑定/历史并提供快捷筛选(F15);刷新终态
移除后台运行、展示失败时间/旧快照/脱敏原因/作业 ID 与重试(F16)。

验证:make verify 17 项全过(identity 本地按设计 skipped);一次性 schema 的
Monitor 目录/路由集成用例通过;8088 部署与真实 UI 验收仍由父会话执行。
This commit is contained in:
姚章浩
2026-11-05 10:38:26 +08:00
parent dfbf3336b2
commit 1c80b07f2c
29 changed files with 1436 additions and 75 deletions
+38 -22
View File
@@ -8,7 +8,6 @@ import (
"net/http"
"os"
"os/signal"
"strings"
"syscall"
"time"
@@ -26,6 +25,7 @@ import (
"knowledge-governance/internal/qaopsorg"
"knowledge-governance/internal/qaopsquality"
"knowledge-governance/internal/qawemail"
"knowledge-governance/internal/readiness"
"knowledge-governance/internal/serviceverify"
"knowledge-governance/internal/version"
)
@@ -90,26 +90,6 @@ func run(ctx context.Context, getenv func(string) string) error {
return errors.New("read production release authorization token")
}
}
// P10: with a mounted API key the probe verifies a real knowledge-base read
// (readiness); without one it degrades to the liveness-only HTTP check.
var weknoraReadiness func(context.Context) error
var knowledgeBaseLister httpapi.KnowledgeBaseLister
if strings.TrimSpace(config.TestWeKnoraBaseURL) != "" {
if apiKey, keyErr := weknora.ReadAPIKeyFile(config.TestWeKnoraAPIKeyFile); keyErr == nil {
probeTimeout := config.TestWeKnoraHTTPTimeout
if probeTimeout > 10*time.Second || probeTimeout <= 0 {
probeTimeout = 10 * time.Second
}
if probeClient, clientErr := weknora.NewClient(weknora.ClientConfig{BaseURL: config.TestWeKnoraBaseURL, APIKey: apiKey, Timeout: probeTimeout, AllowDockerHTTP: config.TestWeKnoraAllowDockerHTTP}); clientErr == nil {
knowledgeBaseLister = probeClient
routingKB := config.InternalRoutingKnowledgeBaseID
weknoraReadiness = func(probeCtx context.Context) error {
_, _, err := probeClient.ListKnowledge(probeCtx, routingKB, 1, 1)
return err
}
}
}
}
// Production WeKnora is probed for liveness only: the console must show the
// real state of that endpoint, while credentials and the publish target stay
// in the release runtime config (RELEASE_CONFIG_FILE).
@@ -131,7 +111,43 @@ func run(ctx context.Context, getenv func(string) string) error {
}
return settings.TestWeKnoraBaseURL
}
monitorProvider, err := monitoring.NewRealProvider(monitoring.RealProviderConfig{DB: pool, WeKnoraBaseURL: config.TestWeKnoraBaseURL, TestWeKnoraResolver: testEndpointResolver, ProductionWeKnoraBaseURL: config.ProductionWeKnoraBaseURL, ProductionWeKnoraResolver: productionEndpointResolver, MinerUBaseURL: config.MinerUBaseURL, WeKnoraReadiness: weknoraReadiness, WorkerStaleAfter: config.WorkerLivenessStaleAfter})
// P10 readiness 与执行链看同一目标:网页保存的端点、当前持久化绑定、同一份
// API Key。启动时只捕获 resolver,不捕获任何一项的值(F13:旧 env 绑定 404)。
readinessResolver := newWeKnoraReadinessResolver(
func(resolveCtx context.Context) string {
if saved := testEndpointResolver(resolveCtx); saved != "" {
return saved
}
return config.TestWeKnoraBaseURL
},
config.InternalRoutingKnowledgeBaseID,
func(resolveCtx context.Context) (string, error) {
internal, _, _, err := actionStore.LoadRoutingKBBindings(resolveCtx)
return internal, err
},
func() (string, error) { return weknora.ReadAPIKeyFile(config.TestWeKnoraAPIKeyFile) },
)
readinessProber := readiness.Prober{
Resolve: readinessResolver,
Timeout: config.TestWeKnoraHTTPTimeout,
AllowDockerHTTP: config.TestWeKnoraAllowDockerHTTP,
}
weknoraProbe := func(probeCtx context.Context) (string, error) {
result := readinessProber.Check(probeCtx)
return result.Target, result.Err
}
knowledgeBaseLister := &weKnoraLister{
endpoint: func(resolveCtx context.Context) string {
if saved := testEndpointResolver(resolveCtx); saved != "" {
return saved
}
return config.TestWeKnoraBaseURL
},
readKey: func() (string, error) { return weknora.ReadAPIKeyFile(config.TestWeKnoraAPIKeyFile) },
timeout: config.TestWeKnoraHTTPTimeout,
allowDockerHTTP: config.TestWeKnoraAllowDockerHTTP,
}
monitorProvider, err := monitoring.NewRealProvider(monitoring.RealProviderConfig{DB: pool, WeKnoraBaseURL: config.TestWeKnoraBaseURL, TestWeKnoraResolver: testEndpointResolver, ProductionWeKnoraBaseURL: config.ProductionWeKnoraBaseURL, ProductionWeKnoraResolver: productionEndpointResolver, MinerUBaseURL: config.MinerUBaseURL, WeKnoraReadiness: weknoraProbe, WorkerStaleAfter: config.WorkerLivenessStaleAfter})
if err != nil {
return err
}
+84
View File
@@ -0,0 +1,84 @@
package main
import (
"context"
"fmt"
"log"
"strings"
"time"
"knowledge-governance/internal/platform/weknora"
"knowledge-governance/internal/readiness"
)
// newWeKnoraReadinessResolver 把「探测目标」收敛到与业务同一组真源:
// 端点来自网页保存的服务配置(endpoint 内部已做 env 兜底),知识库来自
// 当前持久化绑定(未绑定才用 env 引导值),凭据每次重新读同一份 key 文件。
// 任何一项读取失败都必须显式报错——静默退回旧值正是 F13 的成因。
func newWeKnoraReadinessResolver(
endpoint func(context.Context) string,
envKnowledgeBaseID string,
loadBinding func(context.Context) (string, error),
readKey func() (string, error),
) func(context.Context) (readiness.Target, error) {
return func(ctx context.Context) (readiness.Target, error) {
knowledgeBaseID := strings.TrimSpace(envKnowledgeBaseID)
if loadBinding != nil {
stored, err := loadBinding(ctx)
if err != nil {
// 诊断细节进服务日志;探测结果只暴露固定文案,避免把内部地址带进页面。
log.Printf("readiness: load routing bindings: %v", err)
return readiness.Target{}, fmt.Errorf("读取当前知识库绑定失败")
}
if stored = strings.TrimSpace(stored); stored != "" {
knowledgeBaseID = stored
}
}
apiKey := ""
if readKey != nil {
value, err := readKey()
if err != nil {
log.Printf("readiness: read WeKnora API key: %v", err)
return readiness.Target{}, fmt.Errorf("读取 WeKnora API 凭据失败")
}
apiKey = strings.TrimSpace(value)
}
baseURL := ""
if endpoint != nil {
baseURL = strings.TrimSpace(endpoint(ctx))
}
return readiness.Target{BaseURL: baseURL, KnowledgeBaseID: knowledgeBaseID, APIKey: apiKey}, nil
}
}
// weKnoraLister 让「系统设置」的知识库下拉与保存校验同样跟随当前端点/凭据,
// 而不是复用启动时的客户端(否则改端点后选项仍来自旧实例)。
type weKnoraLister struct {
endpoint func(context.Context) string
readKey func() (string, error)
timeout time.Duration
allowDockerHTTP bool
}
func (lister *weKnoraLister) ListKnowledgeBases(ctx context.Context) ([]weknora.KnowledgeBase, error) {
baseURL := ""
if lister.endpoint != nil {
baseURL = strings.TrimSpace(lister.endpoint(ctx))
}
if baseURL == "" {
return nil, fmt.Errorf("WeKnora 端点未配置")
}
apiKey, err := lister.readKey()
if err != nil {
return nil, err
}
timeout := lister.timeout
if timeout <= 0 || timeout > 10*time.Second {
timeout = 10 * time.Second
}
client, err := weknora.NewClient(weknora.ClientConfig{BaseURL: baseURL, APIKey: apiKey, Timeout: timeout, AllowDockerHTTP: lister.allowDockerHTTP})
if err != nil {
return nil, err
}
return client.ListKnowledgeBases(ctx)
}
+112
View File
@@ -0,0 +1,112 @@
package main
import (
"context"
"errors"
"net/http"
"net/http/httptest"
"testing"
"time"
"knowledge-governance/internal/readiness"
)
// F13 的接线回归:探测目标必须来自「网页保存的端点 + 当前持久化绑定」,
// env 只能是未绑定时的引导兜底;任何一项都不许在启动时固化。
func TestReadinessResolverUsesPersistedBindingOverEnv(t *testing.T) {
const envKB = "1b52c140-2e18-4676-afc5-4c7d8d190a8c"
const storedKB = "0c84a098-d3ed-4b82-a165-e6de9691d6a8"
resolve := newWeKnoraReadinessResolver(
func(context.Context) string { return "https://weknora.test" },
envKB,
func(context.Context) (string, error) { return storedKB, nil },
func() (string, error) { return "key-1", nil },
)
target, err := resolve(context.Background())
if err != nil {
t.Fatal(err)
}
if target.KnowledgeBaseID != storedKB || target.BaseURL != "https://weknora.test" || target.APIKey != "key-1" {
t.Fatalf("resolved target = %#v", target)
}
}
func TestReadinessResolverFallsBackToEnvOnlyWhenUnbound(t *testing.T) {
const envKB = "1b52c140-2e18-4676-afc5-4c7d8d190a8c"
resolve := newWeKnoraReadinessResolver(
func(context.Context) string { return "https://weknora.test" },
envKB,
func(context.Context) (string, error) { return "", nil },
func() (string, error) { return "key-1", nil },
)
target, err := resolve(context.Background())
if err != nil || target.KnowledgeBaseID != envKB {
t.Fatalf("unbound fallback = %#v, %v", target, err)
}
}
func TestReadinessResolverReportsBindingAndCredentialFailures(t *testing.T) {
bindingDown := newWeKnoraReadinessResolver(
func(context.Context) string { return "https://weknora.test" },
"env-kb",
func(context.Context) (string, error) { return "", errors.New("db unavailable") },
func() (string, error) { return "key-1", nil },
)
target, err := bindingDown(context.Background())
if err == nil {
t.Fatalf("binding read failure must not silently probe env: %#v", target)
}
keyDown := newWeKnoraReadinessResolver(
func(context.Context) string { return "https://weknora.test" },
"env-kb",
func(context.Context) (string, error) { return "", nil },
func() (string, error) { return "", errors.New("key file missing") },
)
if _, err := keyDown(context.Background()); err == nil {
t.Fatal("missing API key must surface, not degrade to liveness-only")
}
}
func TestReadinessResolverMarksUnconfiguredEndpoint(t *testing.T) {
resolve := newWeKnoraReadinessResolver(
func(context.Context) string { return "" },
"env-kb",
func(context.Context) (string, error) { return "", nil },
func() (string, error) { return "key-1", nil },
)
// 端点缺失时归类为「未配置」,不是「服务不可用」。
result := readiness.Prober{Resolve: resolve}.Check(context.Background())
if !errors.Is(result.Err, readiness.ErrNotConfigured) {
t.Fatalf("blank endpoint probe = %v, want ErrNotConfigured", result.Err)
}
}
func TestKnowledgeBaseListerFollowsTheCurrentEndpoint(t *testing.T) {
base := func(name string) *httptest.Server {
return httptest.NewServer(http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) {
if request.URL.Path != "/api/v1/knowledge-bases" {
writer.WriteHeader(http.StatusNotFound)
return
}
_, _ = writer.Write([]byte(`{"success":true,"data":[{"id":"` + name + `","name":"` + name + `"}]}`))
}))
}
first, second := base("kb-a"), base("kb-b")
defer first.Close()
defer second.Close()
endpoint := first.URL
lister := &weKnoraLister{
endpoint: func(context.Context) string { return endpoint },
readKey: func() (string, error) { return "key-1", nil },
timeout: time.Second,
}
bases, err := lister.ListKnowledgeBases(context.Background())
if err != nil || len(bases) != 1 || bases[0].ID != "kb-a" {
t.Fatalf("initial endpoint bases = %#v, %v", bases, err)
}
endpoint = second.URL
bases, err = lister.ListKnowledgeBases(context.Background())
if err != nil || len(bases) != 1 || bases[0].ID != "kb-b" {
t.Fatalf("rotated endpoint bases = %#v, %v", bases, err)
}
}