文档核验记录：2026-09-19

基线与范围

Core HEAD：95a72d03。核验时工作树已有文档、API 文档配置及相关 Java/POM 的在途修改；本轮文档以当前工作树为依据，不将这些在途修改宣称为已发布版本。

范围：根 README、AGENTS 与 docs/ 文档体系。更新导航与规范入口，修复旧链接和错误码双源，补充 AI 任务路径、开发教程、配置/租户/权限/事务/缓存/事件/JDBC 等指南。

实际执行

检查	结果	证明范围
Core 定向 Maven 测试	29 个报告，366 个测试；失败/错误/跳过均为 0	选定业务链、租户、缓存、事件契约
分类模块定向 Maven 测试	6 个报告，9 个测试；失败/错误/跳过均为 0	真实样例模块的闭合、事务/授权相关测试与边界检查
effective POM	`java.version=17`、`maven.compiler.release=17`	本机当前解析到的编译配置
文档结构检查	56 份文档、416 个链接；0 个问题、0 个外部链接跳过	内外部文件链接、标题锚点、总索引、围栏和可检测敏感模式
检查器回归	6 个 Python 测试通过	中文/重复标题、外部仓库、代码块、缺失索引和敏感值报告边界
核心事实核对	对照 POM、源码和现有测试	类型、配置默认值、注册条件、租户写入、缓存/事件时序与示例落点

工具链：JDK 25、Maven 3.9.15。测试命令分别见测试规范与分类教程。测试报告统计仅包含对应执行时间和选择模式内的 Surefire XML，不能将历史报告一起累加。

结构检查与测试摘要的机器可读记录见验证数据。

本次发现并修正

原 3 处失效文件链接改为现行路径。
Core 中旧应用错误码块表退出维护，使用 design 全局登记；样板号码改为明确占位。
原统一长必读清单改为短入口与任务路由；规则正文由稳定索引定位。
工具链区分编译 release、验证 JVM 与尚未执行的运行兼容矩阵，移除通用指南里的本机安装路径。
模块支持口径改为按能力和证据描述，保留动态数据源等已确认边界。
数据库元数据现状按当前 RdbMetadataException 实现修正。
业务模块命名允许实际存在的“域+能力”和带分组结构，不要求虚构中间层。
更新分类模块的历史描述：当前已有九层骨架与 contract 目录，不再标记为缺少 JDBC/响应式。
分类教程明确选择具体代码子模块；仅选择聚合 POM 的零测试执行不计入上述结果。

不包含的验证

本轮没有重建业务数据库、启动新的开发服务或执行带真实身份的浏览器流程；教程中 MySQL/Redis/HTTP 步骤已对照源码，但未宣称本轮运行通过。框架 Map/mock 测试及分类模块局部测试不替代这些环境验证。

未执行所有 JDK/数据库厂商兼容矩阵，未逐行编译旧模板中的占位代码。可执行例子链接到真实编译单元；占位模板明确要求替换。

尚无独立开发人员试读或独立 AI 实施试用结果。持续验收任务已写入维护规则，后续真实使用中记录卡点；不能由文档作者自评替代这些结果。

工作树保护

首次整理修改 15 份已有文档，新增 28 份专题/入口文档和根 AGENTS 入口，并提供检查脚本与核验记录。工作树还包含 3 份原有文档变更，经本次复核后一并纳入用户授权的文档提交。开始前已有的 11 个非文档变更文件，其 SHA-256 与复核时一致；本次提交不包含这些 Java/POM 修改。

提交前第二轮复核

用户要求再次核验并提交文档后，重新执行上述两组 Maven 测试、文档检查、6 项检查器测试及 git diff --check，结果均通过。重新生成的 Surefire 报告仍为 Core 29 份 / 366 项、分类 6 份 / 9 项；只统计本次命令之后更新且符合选择模式的报告。

本轮额外修正：

分类定义是 GLOBAL_ONLY；教程改为隔离环境中的全局维护身份，并说明有效目标租户的前提和普通租户写入拒绝的断言。
分类 Manager 使用 CreateOrRefreshManager；重复 POST 可能刷新已有对象，不再暗示必然触发重复创建错误。
补充 Python 3.9+、curl 7.76.0+ 与 jq 的要求，说明链接检查器的解析范围与人工复核边界。
API 文档指南区分 Scalar 目标配置与 95a72d03 仍保留的 Swagger UI 兼容基线，保留迁移门槛。MongoDB 已在该基线聚合中；原有 POM 修改只调整了声明顺序。

提交范围为根 README、AGENTS、docs/ 及文档检查器和其回归测试。测试证据来自当前工作树，不能推导为此次纯文档提交已交付 API 文档相关代码迁移；真实数据库和 HTTP 等未执行范围仍如上所述。