Files
knowledge-governance/docs/DOCUMENT_WORKBENCH_V2_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

3.2 KiB
Raw Blame History

文档工作台 V2 验收

入口:http://100.92.49.78:8088/(Tailscale 内)

已实现

  • 日常首页默认只显示613份PP业务文档;5份隔离验收文档默认隐藏,可手动显示。
  • 来源/分类 → 文件清单为主操作路径;顶部显示可点击的来源、分类/目录、文件上下文。
  • 来源与可靠分类可设置对内/对外;规则作用于当前目录及子目录。分类待补齐不允许伪装成独立目录规则。
  • 单文件可单独覆盖目录规则;清除覆盖后回退至最近目录规则,再回退至来源原始标记。
  • 每次设置或清除都要求操作人和判断原因,并与当前规则在同一数据库事务中记录审计。
  • 范围规则只更新治理判断,不修改PP/钉钉/AList源文件,也不自动发布生产。
  • 解析监控按来源显示:已就绪、独立解析、内容复用、处理中、需处理、等待;不显示虚构百分比。
  • 文件详情显示取得文件、上传测试库、解析与索引、测试检索四段真实状态,明确原文与版本差异尚未接通。

数据口径

  • 全部记录:618;默认业务清单:613;隐藏验收文档:5。
  • PP:独立解析530、内容复用29、需处理54、处理中0、等待0;已就绪559/613。
  • 当前原始范围:对外613、对内5。
  • Migration 8仅新增directory_scope_rules、source_item_scope_overrides、scope_change_events。

自动化与运行验收

  • Web:12个测试文件、54项测试全部通过;TypeScript和Vite构建通过。
  • Go:GOPROXY=off go test ./...全部通过;范围规则相关包vet通过。
  • 独立数据库:文件覆盖 → 目录继承 → 来源默认的真实PostgreSQL链路通过。
  • 真实Firefox:目录规则设置、5份文件生效、单文件覆盖、清除覆盖恢复继承、清除目录恢复来源标记、顶部上下文、处理链、默认隐藏测试文档、1440/1024/768无页面横向溢出均通过。
  • 三轮浏览器写回验收共留下12条审计事件(目录/文件各3次set和3次clear);当前有效目录规则0、文件覆盖0,没有遗留验收设置。
  • 最终数据保持:source_items/content_objects/versions/test_publications = 618/535/618/535;活动任务0。
  • API、PostgreSQL健康;所有服务运行、零重启且镜像匹配;本机和Tailscale入口HTTP 200。
  • 生产请求开关false;Release Worker开关false、配置路径空。

证据:

  • tmp/document-workbench-v2-acceptance.json
  • tmp/DOCUMENT_WORKBENCH_V2_FIREFOX.png
  • tmp/DOCUMENT_MONITOR_V2_FIREFOX.png
  • tmp/backups/pre-scope-rules-20260908T170120.dump(PostgreSQL custom dump,290185字节,0600,目录可读)
  • 回退镜像:knowledge-governance-api:before-scope-v2、knowledge-governance-web:before-scope-v2

仍未伪装成已完成的能力

  • PP目前只有分类快照,不是完整原始目录树;钉钉/AList目录仍未接通。
  • 原文预览和版本差异仍未接通。
  • 本轮范围规则会影响后续人工审核时看到的治理范围,但不会绕过审核或自动改变既有生产知识;生产生效仍需独立发布和验证。
  • 未提交、未push,未连接或写入生产WeKnora。