CM95/docs/报告/CM95_S52_ProductionPipelineV2与九州运行报告_v3.md

CM95 S-52 Production Pipeline v2 与九州运行报告 v3

日期：2026-09-19

1. 本阶段结论

本阶段已完成九州工程 AOI 的 S-52 资源契约补全、MySQL 8 空间查询修复、全量 PBF 重新生产、Release finalize、release-scoped S-52 style 编译和 Web 对比页切换。

最终 Release 状态为 PASS。本次 PASS 表示 Production Pipeline、AOI footprint、S-52 resource/runtime contract、PBF/report/decoded feature 对账和当前 release gate 均通过；不表示所有 ENC 语义待审项目已经清零。

2. 权威输入与版本

• OpenCPN S-52 参考 commit：f7211b4e1874c453e37a7f190aa191c55a25c32e
• Builder contract：cm95pbf-builder/0.4.10-s52-resource-contract
• Production pipeline：cm95pbf-production/2.2-s52-resource-contract
• Lookup IR SHA-256：f63cbc0d3c9317b1873c0b0c470a5e7371d1b6d8d58393da660f70b837a52eb7
• Resource contract SHA-256：ebdce70cf8f67dff3ecdeecc8e8f161d9626153a860c69972d41612ed803ef1e

3. S-52 资源契约

按当前 OpenCPN 定义统计，完整资源宇宙为：

• SY：1018
• AP：30
• LC：59
• Defined total：1107
• Active reachable：SY 902 / AP 27 / LC 48 / total 977

build/s52_resources_v2/resource_contract.json 最终为 PASS，defined missing=0，active missing=0。

资源编译同时处理了 OpenCPN 重名 symbol 的 bitmap/vector 选择、真正 vector-only symbol、全部 vector AP、全部 LC，以及 OpenCPN 自身未定义资源引用的官方 fallback 语义；未人为伪造上游不存在的资源。

4. AOI 与生产计划

工程 AOI：kyushu-main-nearby-v1

bbox：128.0,29.5,132.5,34.8

Zoom 5–12 的完整计划数：

• z5=2，z6=4，z7=12，z8=24
• z9=70，z10=247，z11=962，z12=3744
• total=5065

Plan ID：2b2e7d976a43df64da3d031c3863ab596469c7331fc990a4025238e6b9b0d0c9

Release ID：cm95-d1-62a85bd40d3a-2b2e7d976a43

旧 incomplete release cm95-d1-62a85bd40d3a-7cb5890160d2 已在本次生产前整目录删除。新 release 从零建立，不做 migrate / hardlink / copy，也不复用旧 PBF。历史已 finalize 的 sparse release cm95-d1-62a85bd40d3a-bbaaeafee1b4 仅作为历史参考保留。

5. MySQL 8 空间索引问题与修复

实际生产数据库位于 NAS 192.168.200.230 的 MySQL 8.0.45 Docker 实例，数据库为 cm95_japan；X220 本地 MySQL 不是本次生产数据源。

原 geometry 列虽然数据实际为 SRID 4326，但列定义没有声明固定 SRID。MySQL 8 因此不把现有 SPATIAL index 作为查询候选，即使 SQL 使用 FORCE INDEX(spx_*)，执行计划仍为 type=ALL / possible_keys=None，每个 tile 会反复扫描几十万 geometry。

隔离实验确认：将列声明改为 ... NOT NULL SRID 4326 后，执行计划变为 type=range 并实际使用 spx_*。

已修复：

• chart_area_geometry + spx_area_geom
• chart_line_geometry + spx_line_geom
• chart_point_geometry + spx_point_geom
• chart_sounding_point + spx_sounding_geom

代表性查询修复后实测：AREA 约 0.31s、LINE 热缓存约 0.09s、POINT 约 0.02s、SOUNDING 约 0.03–0.07s。生产恢复后吞吐显著提升。

仓库仍保留 MySQL 5.7 历史兼容 schema，本次没有把 sql/001_schema_mysql57.sql 强行改成 MySQL 8 专用列语法。后续若新建 MySQL 8 production 数据库，必须在投入 PBF 生产前同样确认四张空间表的列级 SRID 4326 与 spx_* 实际可用，避免回退到全表扫描。

6. 九州 Production 最终结果

生产任务最终为：

• PASS：5065 / 5065
• FAILED：0
• Report：5065
• 实体 PBF：5064
• 合法显式空 tile：1
• planned output features：476121
• report output features：476121
• decoded PBF features：476121

唯一没有实体 PBF 的 tile 是 12/3530/1648。其 report 明确记录 planned_output_feature_count=0、output_feature_count=0，且无 hard gate、无 encoder drop，因此属于合法空瓦片，不应伪造空 PBF。

Release gate 已调整为：AOI complete 要求每个计划 tile 都有 PASS report；非空 tile 必须有 PBF；经过明确验证的空 tile 可以不产生实体 PBF。

最终 tile_footprint_contract.status=PASS，materialized_or_empty_tile_count=5065，missing non-empty PBF=[]，unexpected PBF=[]。

7. S-52 Runtime Contract

本 release 使用：

• point table：Paper
• boundary table：Plain
• mariner mode：runtime

Final manifest：

• s52_resource_contract.status=PASS
• s52_runtime_contract.status=PASS
• mariner-dependent features：286975
• dynamic final leaks：{}
• runtime failure count：0

Runtime CSP 数量：

• DEPARE01：47516
• DEPCNT02：46189
• OBSTRN04：45633
• SOUNDG02：146728
• WRECKS02：909

因此 PBF 保存水深、危险物、sounding 等事实字段，而不会永久写死当前用户的 safety contour / safety depth / isolated danger 等动态最终结果。

8. Release-scoped S-52 Style

对新 release 的 5064 个实体 PBF 做 aggregate usage 编译后生成：

build/s52_style_compiler_release_2b2e7d976a43/style.s52.json

结果：

• compiled layers：142
• 使用范围：5064 PBF / 28 source layers / 476121 features
• resource contract：PASS
• hard gate failures：[]

关键 FSHFAC、FSHHAV、SOUNDG 和 LOWACC/fallback 资源均可在生成 style 中找到。

完整 sprite 使用 build/s52_resources_v2/final/s52-sprite-full，并补齐浏览器需要的 1x / 2x sprite JSON/PNG。

9. Web 对比与实际 WebGL 验证

比较服务已切换到新 Release，端口 18888。

/health 当前返回新 release、release status PASS、PBF=5064、decoded features=476121、S-52 runtime contract PASS。 浏览器实际加载验证已完成，而不是只检查 DOM：

• release-scoped style：HTTP 200
• sprite 1x/2x JSON/PNG：HTTP 200
• 普通 PBF：HTTP 200
• 合法空 tile：HTTP 204
• 左右 MapLibre style 状态均为 OK
• 左侧实际 querySourceFeatures / queryRenderedFeatures 有数据
• 静态 LANDA fill 在截图中实际出现；其 0.92 opacity 混合色 #CABD83 有大量像素

为验证 runtime PBF，本地比较页增加了可关闭的 runtime 默认阈值预览。默认值来自现有 S52MarinerSettings：shallow=2m、safety contour=3m、safety depth=3m、deep=6m。

z11 近岸样本实测：

• effective safety contour：5m
• runtime DEPARE rendered：24
• runtime DEPCNT rendered：35
• runtime SOUNDG rendered：61
• source SOUNDG facts：202

实际截图已生成并检查。runtime preview 只读取 PBF facts，不修改 PBF；Hazard exact isolated-danger / symbol composition 仍明确留给正式 NavSea Runtime Adapter，不在 Web 调试页中伪造。

10. 仍然保留的语义待审项

Final manifest 的 semantic_completeness 仍为 PENDING_REVIEW：

• observed gap variants：141
• pending semantic review：112
• pending semantic review feature rows：52828

这部分是既有语义映射 backlog，与本次资源契约、PBF 技术生产和 runtime contract PASS 是不同维度。

因此本阶段可以确认“技术生产链与 S-52 资源/runtime 契约闭环”，但不能描述为“全部 ENC/S-52 业务语义已经 100% 完成”。

11. 最终结论

九州完整 AOI 的新 S-52 runtime Release 已完成从零生产并 finalize PASS。MySQL 8 空间查询根因已确认并在当前 NAS 数据库修复，生产查询已真正使用 SPATIAL index。

新 Release、完整 S-52 资源、release-scoped style、Web 对比服务和 runtime facts 预览已连通。后续工作可以基于该 Release 继续做语义 backlog 审查和正式 NavSea Runtime Adapter，而不需要重新设计本次 Production/Resource Contract 基线。