# 数据研发 V60-V65 验收报告

日期：2026-07-22

## 1. 验收结论

V60-V65 的非外部依赖开发项全部完成：多源采集、证据治理、数据元素生命周期、本体 MVP、动态本体、交换/知识/MCP 服务、运营对账、Vue 2 完整工作流及发布副本均已交付。最终状态为“代码验收通过；真实外部服务集成待可用 Docker/发布环境补跑”。

## 2. 阶段交付

| 阶段 | 核心交付 | 阶段提交 |
|---|---|---|
| V60 | 采集控制面、任务状态机、权限、API/OpenAPI | `3b004fa` |
| V61 | SQL/CSV/Excel、目录采集、数据元素与候选决策 | `6bcd697` |
| V62 | DOCX/PDF、OCR、统一文件策略、MinIO/证据 | `cf464b2` |
| V63 | 本体控制面、校验、发布/回滚、Vue 本体中心 | `b804f9e` |
| V64 | 动态建议、变更集、JSON/OWL、知识/MCP/语义查询 | `d32b4ce` |
| V65 | 运营对账、数据研发中心、发布同步、综合验收 | 本阶段最终提交 |

## 3. 最终测试矩阵

| 验收命令 | 结果 |
|---|---|
| `PYTHONPATH=. .venv/bin/pytest -q tests/data_research tests/acceptance/test_data_research_v60_v65.py` | `79 passed` |
| `PYTHONPATH=. .venv/bin/pytest -q` | `372 passed, 23 skipped, 59 subtests passed` |
| `PATH=<bundled-node-24>:$PATH npm --prefix frontend run build` | 构建成功；0 error，21 条既有 `no-console` 警告，另有依赖年龄/CSS 顺序/包体积警告 |
| `python scripts/generate_openapi.py --output docs/architecture/OPENAPI.yaml` | 138 个操作 |
| `PYTHONPATH=. .venv/bin/pytest -q tests/test_architecture_artifacts.py` | 通过 |
| `diff -qr app deployment/app` | 无差异 |
| `git diff --check` | 通过 |

验收期间全量测试曾捕获任务令牌尾字符的非规范 Base64URL 别名问题；验证器现强制 JWT 三段采用规范编码，专项测试与全量回归均已通过。

## 4. 安全与治理断言

- OCR 未配置时失败关闭，HTTP 提供方必须 HTTPS、TLS 校验、超时和响应大小限制。
- 上传文件同时校验扩展名、MIME、文件头、大小/页数；旧 DOC 要求转换为 DOCX。
- 证据预览脱敏，原件下载要求 `evidence:download`。
- 候选项不能直接发布；数据元素和本体发布分别要求独立发布权限。
- 发布版本不可变；回滚创建新版本；Neo4j/知识文档通过 Outbox/对账修复，不覆盖 PostgreSQL 历史。
- AI 建议必须携带证据、置信度、模型/提示版本；未决建议不进入草稿或发布。
- 语义查询使用固定深度与固定 Cypher，只返回已发布、业务域范围内的白名单字段。

## 5. 环境受限项

`docker compose -f deploy/docker/docker-compose.yml ps` 返回 Docker daemon 未运行。因此以下真实服务测试在本机保持跳过，不用单元假件结果冒充生产集成结果：

- Alembic 在临时 PostgreSQL 数据库的重复升级/降级与实际表检查。
- PostgreSQL/MySQL 目录采集及查询超时集成。
- PostgreSQL Outbox 与 Neo4j 投影重试/幂等的真实跨存储验证。
- MinIO 原件上传、哈希复用、缺失工件对账。
- MCP stdio/canary 依赖的外部运行环境及真实服务权限验证。

这些检查不阻断代码验收，但在生产发布前必须在 Docker 或等价预发布环境补跑，并将结果附加到本报告。