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

48 lines
3.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.
# 文档工作台 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。