chore: 全量快照提交以防磁盘风险

NavSea_九州_Delivery_对象属性分组_2026-04-07.md

@@ -0,0 +1,434 @@
+# 九州 Delivery 对象属性分组
+
+## 目的
+
+本文不再按“航海用 / 钓鱼用”分，而是按对象属性与业务语义相同的 group 重新整理当前 `kyushu delivery` 图层。
+
+整理目标是：
+
+- 让后续 style 拆分时，先按对象类别看清当前图层结构
+- 明确每一组对象当前对应哪些 `source-layer`
+- 明确每一组对象当前实际由哪些 render layer 在画
+
+这里的“group”按业务对象语义来定，例如：
+
+- 等深线
+- 鱼礁
+- 灯塔
+- 港口灯
+- 渔网
+- 海上标识
+- 陆地设施
+- 桥梁 / 跨空线
+- 海底质
+- 海底危险物
+
+## 基础说明
+
+本次整理基于当前样式：
+
+- [`style.navsea-delivery-kyushu.json`](/root/sourceserver/pbf/src/pbf/style.navsea-delivery-kyushu.json)
+
+说明：
+
+- `source-layer`
+  - 指 delivery PBF 中的语义层
+- `render layer`
+  - 指样式里的具体绘制层 id
+- 一个 group 可能对应多个 `source-layer`
+- 一个 `source-layer` 也可能被拆成多个 render layer 表现
+
+## 1. 等深线
+
+## 含义
+
+- 主要表达海底深浅变化与地形坡坎
+- 是读海底结构的主线索
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `depth_contour` |
+| source-layer | `depth_contour_overview` |
+| source-layer | `bathymetry_line` |
+| render layer | `depth-contours` |
+| render layer | `depth-contours-major` |
+| render layer | `depth-contour-labels` |
+| render layer | `depth-contours-major-labels` |
+| render layer | `bathymetry-support` |
+| render layer | `bathymetry-depth-labels` |
+
+## 说明
+
+- `depth_contour`
+  - 主等深线
+- `depth_contour_overview`
+  - 概略等深线
+- `bathymetry_line`
+  - 海底辅助线与水深数字承载线
+
+## 2. 鱼礁
+
+## 含义
+
+- 鱼礁、人工礁、抛锚注意障碍中的鱼礁类对象
+- 对钓鱼和避碰都重要
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `anchor_caution_hazard_area` |
+| source-layer | `anchor_caution_hazard_outline` |
+| source-layer | `anchor_caution_hazard_point` |
+| source-layer | `submerged_reef_area` |
+| render layer | `hazard-polygons` |
+| render layer | `anchor-danger-outline` |
+| render layer | `anchor-hazard-points` |
+| render layer | `anchor-hazard-points-428` |
+| render layer | `submerged-structures` |
+
+## 说明
+
+- 当前“鱼礁”并不是单独一层
+- 主要散落在：
+  - `anchor_caution_hazard_*`
+  - `submerged_reef_area`
+- 后续如果要单做钓鱼版，建议把鱼礁从 `anchor_caution_hazard_*` 里再细拆出来
+
+## 3. 灯塔
+
+## 含义
+
+- 大型灯塔、沿岸灯塔、航海定位核心灯标
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `navigation_marks` |
+| render layer | `nav-marks-harbor-lighthouses` |
+| render layer | `nav-marks-breakwater-lighthouses` |
+| render layer | `nav-light-arc` |
+| render layer | `nav-light-flare` |
+| render layer | `nav-mark-labels` |
+| render layer | `nav-light-abbr-labels` |
+
+## 说明
+
+- 当前样式中，灯塔类都从 `navigation_marks` 分流出来
+- 弧光与 flare 仍是同一个 `source-layer` 上的附加表现
+
+## 4. 港口灯
+
+## 含义
+
+- 港口灯、防波堤灯、近港入口灯标
+- 属于航海用的强引导对象
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `navigation_marks` |
+| render layer | `nav-marks-harbor-lighthouses` |
+| render layer | `nav-marks-breakwater-lighthouses` |
+| render layer | `nav-light-flare` |
+| render layer | `nav-mark-labels` |
+| render layer | `nav-light-abbr-labels` |
+
+## 说明
+
+- “港口灯”目前不是单独 source-layer
+- 依靠 `navigation_marks` 内部的 `display_code` / 语义分层来区分
+
+## 5. 渔网 / 渔具
+
+## 含义
+
+- 定置渔具、渔网、渔场作业相关区域
+- 对航行规避与钓点判断都很重要
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `fixed_fishing_gear_area` |
+| render layer | `fishery-areas` |
+| render layer | `fishery-areas-outline` |
+
+## 说明
+
+- 这是当前最接近“渔网 / 渔具”独立 group 的一组
+- 后续如果要单做渔业专题层，可以直接从这一组开始
+
+## 6. 海上标识
+
+## 含义
+
+- 浮标、灯浮标、灯标、AIS、一般航标与引导标识
+- 用于导助航、回点、通航识别
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `navigation_marks` |
+| render layer | `nav-marks-small-lights` |
+| render layer | `nav-marks-light-beacons` |
+| render layer | `nav-marks` |
+| render layer | `nav-light-flare` |
+| render layer | `nav-mark-labels` |
+| render layer | `nav-light-abbr-labels` |
+
+## 说明
+
+- 这是一个大 group
+- 当前内部实际又包含：
+  - 小灯
+  - 灯标
+  - 浮标
+  - 其他海上标识
+- 如后续要再细分，可从 `navigation_marks` 内继续拆：
+  - `display_code`
+  - `shape_class_code`
+  - `chart_symbol_code`
+
+## 7. 陆地设施
+
+## 含义
+
+- 陆上结构物
+- 港口/设施边界相关点面
+- 可用于近岸定位和设施识别
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `facility_boundary_area` |
+| source-layer | `facility_boundary_outline` |
+| source-layer | `facility_boundary_point` |
+| source-layer | `onshore_structure_area` |
+| source-layer | `onshore_structure_line` |
+| source-layer | `onshore_structure_point` |
+| render layer | `facility-zones` |
+| render layer | `facility-zone-outline` |
+| render layer | `facility-points` |
+| render layer | `land-structures-area` |
+| render layer | `land-structures-line` |
+| render layer | `landmark-points` |
+| render layer | `landmark-point-fallback` |
+
+## 说明
+
+- 这组里其实包含两类对象：
+  - 港口设施 / 边界设施
+  - 一般陆上结构物 / 地标
+- 如果后续要更清楚，建议再拆成：
+  - 港口设施
+  - 陆标设施
+
+## 8. 桥梁 / 跨空线
+
+## 含义
+
+- 桥梁
+- 净空限制
+- 影响通过性判断的跨越结构
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `bridge_structure` |
+| source-layer | `clearance_limit_line` |
+| source-layer | `clearance_limit_point` |
+| render layer | `bridge-area` |
+| render layer | `bridge-outline` |
+| render layer | `height-limit-line` |
+| render layer | `height-limit-points` |
+| render layer | `height-limit-name-labels` |
+| render layer | `height-limit-value-labels` |
+
+## 说明
+
+- “桥梁”和“跨空线/净空线”当前是两组 source-layer
+- 但从业务上可以放在同一个大 group
+
+## 9. 海底质
+
+## 含义
+
+- 泥、沙、砾、壳、岩等底质信息
+- 对钓鱼、底拖、地形理解很重要
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `seabed_text_point` |
+| source-layer | `seabed_line` |
+| render layer | `bottom-material-labels` |
+| render layer | `subsea-cables` |
+
+## 说明
+
+- `seabed_text_point`
+  - 明确是底质文字层
+- `seabed_line`
+  - 当前命名较宽，样式里实际由 `subsea-cables` 在消费
+- 这一组后续建议再查清：
+  - `seabed_line` 到底是海底辅助线，还是混有其他线性海底对象
+
+## 10. 海底危险物
+
+## 含义
+
+- 暗礁、沉船、露岩、洗岩、浅滩、危险障碍、潜堤等
+- 这是航行安全核心 group
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `navigation_hazard_area` |
+| source-layer | `navigation_hazard_outline` |
+| source-layer | `navigation_hazard_point` |
+| source-layer | `anchor_caution_hazard_area` |
+| source-layer | `anchor_caution_hazard_outline` |
+| source-layer | `anchor_caution_hazard_point` |
+| source-layer | `submerged_reef_area` |
+| source-layer | `baseline_area` |
+| render layer | `navigation-hazard-polygons` |
+| render layer | `navigation-hazard-outline` |
+| render layer | `hazard-points` |
+| render layer | `hazard-polygons` |
+| render layer | `anchor-danger-outline` |
+| render layer | `anchor-hazard-points` |
+| render layer | `anchor-hazard-points-428` |
+| render layer | `submerged-structures` |
+| render layer | `shoal-danger-area` |
+| render layer | `unsurveyed-area` |
+
+## 说明
+
+- 这是当前最复杂的一组
+- 里面混合了：
+  - 直接航行危险物
+  - 抛锚注意危险物
+  - 潜堤/潜礁
+  - 浅滩/未测区域背景提示
+- 后续若做航海版，建议把这一组作为最高优先级 group
+
+## 11. 锚地
+
+## 含义
+
+- 锚地、锚泊区、锚泊相关符号
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `anchorage_area` |
+| source-layer | `anchorage_outline` |
+| source-layer | `anchorage_point` |
+| render layer | `anchorage-areas` |
+| render layer | `anchorage-outline` |
+| render layer | `anchorage-symbols` |
+
+## 12. 引航 / 航海服务
+
+## 含义
+
+- 引航站
+- 其他后续可加入的航海服务点
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `pilot_station_point` |
+| render layer | `pilot-station-points` |
+
+## 13. 陆海背景与海岸线
+
+## 含义
+
+- 海陆底图
+- 岸线、浅滩、河口、水域背景
+- 是所有其他 group 的底板
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `baseline_area` |
+| source-layer | `baseline_line` |
+| source-layer | `baseline_outline` |
+| source-layer | `land_area` |
+| source-layer | `hole_area` |
+| render layer | `sea-area-fill` |
+| render layer | `tidal-flat` |
+| render layer | `river-water` |
+| render layer | `unsurveyed-area` |
+| render layer | `shoal-danger-area` |
+| render layer | `coast-structures-area` |
+| render layer | `coast-structures-line` |
+| render layer | `clip-outline` |
+| render layer | `land-area` |
+| render layer | `land-hole` |
+
+## 说明
+
+- 这组不是“专题对象”，更像基础底板
+- 但在 style 组织上必须单列，因为很多危险层是叠在这组之上的
+
+## 14. 地名与定位参考
+
+## 含义
+
+- 海上地名
+- 陆上地名
+- 用于读图与定位
+
+## 当前对应层
+
+| 类型 | 当前层 |
+| --- | --- |
+| source-layer | `place_label_sea` |
+| source-layer | `place_label_land` |
+| render layer | `place-labels-sea-en` |
+| render layer | `place-labels-sea-ja` |
+| render layer | `place-labels-land-en` |
+| render layer | `place-labels-land-ja` |
+
+## 15. 当前最值得后续继续细拆的 group
+
+按后续 style / 产品价值排序，最值得再往下细拆的是这几组：
+
+1. 海底危险物
+   - 需要拆清“航行危险物 / 抛锚注意危险物 / 鱼礁 / 潜堤 / 浅滩 / 未测区”
+2. 海上标识
+   - 需要拆清“灯塔 / 港口灯 / 灯标 / 灯浮标 / 一般浮标 / AIS”
+3. 陆地设施
+   - 需要拆清“港口设施 / 陆标设施 / 一般地标”
+4. 海底质
+   - 需要拆清“底质文字 / 海底辅助线 / 海底电缆或其他海底线”
+
+## 16. 推荐的后续落地方向
+
+如果下一步要继续推进 delivery 版本组织，建议顺序是：
+
+1. 先保持同一套 PBF
+2. 先把 style 内部按本文件的 group 重排
+3. 再决定哪些 group 要继续拆成单独 profile
+
+建议优先可见的 profile 方向：
+
+1. `navigation-core`
+   - 强化：海底危险物、海上标识、桥梁 / 跨空线、锚地、引航
+2. `fishing-detail`
+   - 强化：等深线、鱼礁、海底质、穴、海底结构