Files
knowledge-governance/docs/P41_SOURCE_CONNECTIONS_ACCEPTANCE.md
T
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

101 lines
2.2 KiB
Markdown
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.
# P4.1 来源连接只读工作台验收
## 范围
本切片将“来源管理”从占位页接入真实 PostgreSQL,只提供安全只读视图:
- 列出已登记来源连接;
- 展示启用状态、是否配置调度、健康枚举、对象数和更新时间;
- 汇总总数、启用、停用、健康、降级、异常和未知;
- 不展示或读取到 API 投影中的连接地址、secret引用和原始健康错误正文;
- 不创建、修改、启用或删除来源连接;
- 不调用 PP、AList 或钉钉写接口。
## API
```text
GET /api/v1/source-connections
```
安全字段:
```text
id
source_type
name
enabled
schedule_configured
health_status
item_count
updated_at
```
明确省略:
```text
base_url
secret_ref
schedule原始JSON
last_health原始JSON及错误正文
API Key、Token、Cookie
```
## 当前真实数据
```text
connections=2
enabled=0
disabled=2
healthy=0
degraded=0
unhealthy=0
unknown=2
```
来源对象数:
```text
manual=5
pp=613
```
## 自动化验证
```text
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。