📚 docs(roadmap): 同步真实集成测试基线

[ZhaoXingPeng]

Closes #116

关联 Issue

• 📚 docs(roadmap): 整理 v0.3 后续架构与功能路线 #116 :books: docs(roadmap): 整理 v0.3 后续架构与功能路线
• 📚 docs(roadmap): 整理 v0.3 后续架构与功能路线 #116 的交付物是可从 README 访问、按 P0/P1/P2 组织并记录证据边界的路线图。路线图内的工程项继续按独立 Issue/PR 实施，关闭本 Issue 不代表 P0 全部完成。

背景（Situation）

路线图已合并，但仍将当前基线写为 2803b40 与 660 单测，并称 MySQL/PostgreSQL 只覆盖 TCP/类型映射。PR #133 已合并为 7b07599：新增真实 ConnectionManager -> DatabaseIntrospector.describe_table 容器契约，并修复 PostgreSQL psycopg2 % literal 转义。因此旧文字已与 main 的已验证状态不一致。

任务（Task）

• 将文档基线更新至 🧪 test(integration): 覆盖真实元数据契约 #133 合并后的证据快照与 668 单测。
• 记录已完成的 MySQL 8.0/PostgreSQL 16-alpine metadata、外键、复合索引、自增和 schema 隔离覆盖。
• 明确 P0 集成矩阵仍处于进行中：containerized codegen、SQLite 等价 fixture、权限与版本组合未完成。
• 不将本次文档更新夸大为性能、完整 P0 或客户环境兼容性结论。

行动（Action）

只修改 docs/roadmap-v0.3.md：

• 基线从历史 2803b40 改为 7b07599 的证据快照。
• 单测命令与结果改为 PYTHONPATH=src python -m pytest tests/unit/ -q、668 passed。
• 将 🧪 test(integration): 覆盖真实元数据契约 #133 的真实容器 contract 与已知未覆盖项写入当前基线。
• 增加 P0 进展记录，保留“进行中/未立项”的真实状态，记录 LIKE 'nextval(%%' psycopg2 发现但不把它作为完整查询合同结论。

提交：955d751 :books: docs(roadmap): 同步真实集成测试基线

验证（Verification）

本地 Windows 11 x86_64 执行：

git -c core.whitespace=cr-at-eol diff --check
PYTHONPATH=src python -m pytest tests/unit/ -q
668 passed in 6.55s

本 PR 不改 Python、CI 或运行时文件；未重新执行 container test 或性能实验。#133 的最终 CI 已实际通过 MySQL/PostgreSQL Testcontainers integration，因此本次仅引用其已记录证据，而非重复宣称新的运行时结果。

实验与证据（Evidence）

文档事实	旧状态	更新后证据	未证明的边界
unit baseline	660	#133 后 668 passed	非 unit 范围
容器 metadata	MySQL TCP、PG 类型映射	#133 CI 真实 describe_table contract 与 schema 隔离	codegen、权限、客户数据库
P0 #1 状态	未区分进度	进行中，列出已完成与剩余项	不标记为完成
psycopg2 LIKE 模式	未记录	#133 真实 CI 失败并修复为 %%	不代表所有查询合同完成

兼容性、风险与回滚

仅文档变更，无 API、数据库、发布物或性能行为变化。风险是证据快照随 future main 演进再次过期；通过在文本中注明快照 commit、测试环境和未覆盖边界缓解。回滚为 revert 单文件文档提交；不涉及数据或外部服务。

[ZhaoXingPeng]

实施记录：路线图证据刷新，而非 P0 完成声明

基线校正依据

路线图原文的 660 passed、2803b40 和“仅 MySQL 连通性/PG 类型映射”在 #133 合并后已失真。更新使用可追溯的 7b07599 作为快照，而不使用“最新”这类不可复核的措辞；单测命令也统一为当前 CI/本地一致的 PYTHONPATH=src python -m pytest tests/unit/ -q。

范围约束

#133 的真实 CI 证明固定 MySQL 8.0、PostgreSQL 16-alpine temporary schema 下的 metadata contract 和 PostgreSQL 显式 schema 隔离；它并没有执行：

• 从容器元数据到模板/生成 Java 的完整链路；
• SQLite 的 integration fixture（现有 SQLite coverage 仍以 unit/in-memory 为主）；
• 最小权限用户、客户版本矩阵、性能或吞吐测试。

因此新增 P0 进展记录 的状态是“进行中”，并把上述三类工作保留为剩余验收项。关闭 #116 仅表示路线图文档入口与更新机制到位，后续实现必须另开 Issue。

已执行验证

git -c core.whitespace=cr-at-eol diff --check
PYTHONPATH=src python -m pytest tests/unit/ -q
# 668 passed in 6.55s

本提交没有 Python 文件、测试逻辑或 workflow 变更，因此不为文档变动重复启动单独的本地 Testcontainers/性能实验。合并前只需按当前协作约定核对 PR 最新提交对应的一轮 CI；通过后 squash merge。

[ZhaoXingPeng]

最终 CI 记录

PR 最新提交 955d751 对应 GitHub Actions run 34213417704 的 12 项检查全部成功：

• Commit and PR policy：5s；Changed-file format gate：11s
• Python quality：3.11（21s）、3.12（25s）、3.13（20s）
• Database integration tests：48s；Template rendering contract：8s
• Generated Java compile smoke：31s；NPM package contract：6s
• Docker image smoke test：28s；Python package build smoke test：16s
• Required CI status：4s

该 CI 没有产生新的文档外行为结论；它确认文档提交可与现有完整门禁共同通过。路线图事实仍以正文和前一条实施评论划定：#133 的 integration 证据已存在，尚未覆盖的 codegen、SQLite integration fixture、权限与性能项目没有被标为完成。满足 squash merge 条件，回滚为 revert 此单文件文档提交。