产品就绪报告

这份报告把仓库能够证明的事，与仍需专业复核或真实运行环境才能确认的事分开。构建变绿是证据，不是终端里突然住进了一位领域专家。

这份报告说明站点现在可以可靠交付什么，以及使用者仍需自行复核什么。机器可读版本见 product-readiness.json。

当前结论

指标	当前值
就绪等级	guarded
历史评分（评分方法缺失）	78
课程卷	14
章节文件	509
学习路径	6

guarded 表示可以按需阅读，但使用具体结论和代码前仍需核对适用条件。中英文各有 509 个课次，目录、双语对应、链接、课次编号及 Python/JSON 示例语法均有自动检查；全量独立人工技术复核以及尚未覆盖的 Java、Shell、SQL 等运行环境仍需补齐。

对不同读者的直接影响：

• 自学者可以沿学习路径阅读，但遇到未验证示例时应先核对环境和输出；
• 专业读者可以把页面当作知识索引，不应仅凭“章节文件存在”判断结论已经复核；
• 教师和培训团队应先选定固定范围，逐篇检查讲义、练习和运行环境，再对外承诺交付内容；
• 任何付费或有考核要求的课程，都需要讲师复核，不能直接把整站视为同一完成度。

78 分保留自历史机器数据。仓库没有可复算的评分方法，这个数字不能用来判断当前内容质量；应查看具体检查结果与未完成项。

已具备的治理能力

• catalog.json：机器可读课程目录；
• learning-paths.json：带受众、阶段、时长估计和结业产出的学习路径；
• product-readiness.json：就绪等级、风险和验证命令；
• content-review-status.json：逐篇写作阶段、自动校验状态和内容哈希；
• 课程目录与学习路径：面向读者的导航页；
• npm run validate:docs：检查链接、导航、目录数量、章与课次编号、学习路径和产品就绪元数据；
• npm run validate:content：检查逐篇写作阶段、自动校验状态与内容哈希是否失效；
• npm run validate:examples：检查代码围栏完整性，并解析 Python 与 JSON 示例。

这些门禁能发现路径、数量和状态失配，不能证明技术论述正确，也不能替代代码执行。

发布阻塞项

Code	说明	发布前处理
HUMAN_TECHNICAL_REVIEW	双语内容和自动门禁已通过，但全量独立人工技术复核及多环境示例执行尚未完成。	固定交付范围；逐篇由领域讲师复核；补跑 Java、Shell、SQL 等环境相关示例。

验证命令

机器可读就绪报告要求以下命令通过：

npm run validate:docs
npm run validate:content
npm run validate:examples
npm run build

风险披露

509 是每种语言的编号课次数，其中部分主题被拆成多个渐进课时；这个数字不等于 509 个独立顶层主题。中英文课次均已登记 Humanizer 与自动校验状态，但不等于全部经过独立人工专家复核。

发布固定范围课程前，应以 product-readiness.json 的 blocker 和 content-review-status.json 的逐篇状态为准，记录课程边界、运行环境、已验证示例和仍待补充的内容。