Files
knowledge-governance/docs/P41_SOURCE_CONNECTIONS_ACCEPTANCE.md
zheromiku dcdc8d1ddd feat: 知识治理平台(含已验证发布/回滚契约)
全栈知识治理平台首次入库(P1-P10 + 发布链路模拟验证闭环):

- 治理核心:源目录/变更集/人工审核/发布批次/发布执行(fail-closed 闸口)
- 测试通道:WeKnora 测试 KB 上传/轮询/验收;poll 完成时写入
  parser_generation/index_generation,修复 manual/seed 路径发布闸口永久拦截
- 发布适配器 v071(本地 source=测试角色 / 云端 target=生产角色 模拟验证通过):
  * ES 导出/导入 mapping 自适应(.keyword 子字段、可选 tenant_id)
  * OSS locator 支持嵌套 scheme;chunks.seq_id 由目标序列分配
  * bundle 归档同身份重试原子替换;verifier 按 bundle chunk_type 计数
  * 回滚 job payload 支持 prior_execution_id(strict 解码)
- 三通道发布+回滚演练实测:publish 4/4 verified,检索命中,
  rollback 4/4 rolled_back,目标端 PG is_enabled=false、ES is_enabled=false
- 前端 A·Data-console 风格全站统一,120 用例通过
- 门禁:go vet / go test 全包通过,gofmt 干净
2026-09-30 10:54:06 +08:00

2.2 KiB
Raw Permalink Blame History

P4.1 来源连接只读工作台验收

范围

本切片将“来源管理”从占位页接入真实 PostgreSQL,只提供安全只读视图:

  • 列出已登记来源连接;
  • 展示启用状态、是否配置调度、健康枚举、对象数和更新时间;
  • 汇总总数、启用、停用、健康、降级、异常和未知;
  • 不展示或读取到 API 投影中的连接地址、secret引用和原始健康错误正文;
  • 不创建、修改、启用或删除来源连接;
  • 不调用 PP、AList 或钉钉写接口。

API

GET /api/v1/source-connections

安全字段:

id
source_type
name
enabled
schedule_configured
health_status
item_count
updated_at

明确省略:

base_url
secret_ref
schedule原始JSON
last_health原始JSON及错误正文
API Key、Token、Cookie

当前真实数据

connections=2
enabled=0
disabled=2
healthy=0
degraded=0
unhealthy=0
unknown=2

来源对象数:

manual=5
pp=613

自动化验证

Store安全投影单元测试:passed
HTTP API安全投影测试:passed
前端严格解析与额外字段剥离:passed
一次性PostgreSQL集成测试:passed (0.121s)
Go全量测试:passed
Go vet:passed
Web测试:26/26 passed
TypeScript typecheck:passed
Vite production build:passed
Compose config:passed

一次性 PostgreSQL 测试实际插入包含敏感 base_url、secret_ref 和健康 detail 的连接,再确认序列化投影不包含这些内容。临时数据库在测试后删除,持久治理库没有写入测试记录。

浏览器验收

Firefox headless 1440×900:

  • 左侧导航“来源管理”高亮;
  • 顶部保留“工作台/来源管理”多标签;
  • 两条真实连接记录可见;
  • 状态、调度、健康、对象数易读;
  • 来源占位文案已移除;
  • 页面敏感字段泄漏为 0;
  • 紧凑表格修复后“更新时间”标题及两行时间完整可见;
  • 无横向裁切、遮挡或乱码。

截图:tmp/P41_SOURCE_CONNECTIONS_FIREFOX.png

运行边界

  • 只重建 API 与 Web;
  • PostgreSQL、普通 Worker、Release Worker 未重建;
  • Release Worker 继续保持关闭;
  • 未连接生产;
  • 未 commit、未 push。