5.4 KiB
5.4 KiB
NavSea Server Codex Tasks v2
Architecture: NavSea V11 / Codex6 Scope: Server Side Only
Global Rules（全局强制规则）
以下规则适用于所有 NavSea Server Tasks。
Rule 1 — 必须保留原始 PBF 属性
语义系统 不得删除或覆盖任何原始 PBF feature 属性。
必须保留包括但不限于：
- 日文对象名称
- 海图原始属性
- 灯塔信息
- 深度信息
- 渔区信息
- 海图符号属性
- 任何原始 metadata
语义字段只能 新增，不能替换。
示例：
class = 灯
shape = 灯標
name = 大島灯台
新增语义字段：
canonical_object_type = navigation_aid_light
object_family = navigation_aid
detection_class = navigation_mark
Rule 2 — 不得修改 style.json 依赖属性
任何被 style.json 使用的属性字段 必须保持不变。
典型字段包括：
source_layer
class
shape
name
symbol
depth
type
category
语义系统 不得重命名或删除这些字段。
Rule 3 — 语义字段只能新增
NavSea Semantic Overlay 只能增加字段，例如：
canonical_object_type
object_family
detection_class
capability
detection_key
不得改变：
geometry
source_layer
original_attributes
Task 01 — Semantic Overlay Validation System v2
任务目标
构建验证系统，确保语义重建不会破坏原始 PBF 渲染结构。
验证内容包括：
- feature 数量一致
- geometry 类型一致
- style 渲染一致
- 原始属性完整保留
输入表
Codex 自动检测：
canonical_layer_rules
pbf_relayer_candidates
pbf_render_compatibility
pbf_detection_catalog
输出验证表
classification_validation
geometry_consistency
style_render_equivalence
attribute_preservation_check
semantic_validation_summary
新增验证
必须新增：
attribute_preservation_check
用于确认：
原始 PBF 属性未丢失
Task 02 — Object Taxonomy Builder v2
任务目标
建立稳定的海图对象分类体系。
输出表
navsea_object_taxonomy
字段
canonical_object_type
object_family
detection_class
description
示例
rock → hazard → obstacle
wreck → hazard → obstacle
reef → hazard → obstacle
light → navigation_aid → navigation_mark
约束
Taxonomy 不能改变：
source_layer
original_attributes
Task 03 — Object Capability System v2
任务目标
定义海图对象在航行中的能力（capability）。
输出表
navsea_object_capabilities
字段
canonical_object_type
capability
示例
rock → collision
wreck → collision
reef → grounding
fishery → entangle
light → navigation_mark
breakwater → wave_barrier
目的
使检测系统可以查询：
所有 collision 对象
所有 grounding 对象
Task 04 — Detection Object View v2
任务目标
创建统一检测对象视图。
视图
navsea_detection_objects
字段
feature_id
geometry
canonical_object_type
object_family
detection_class
capability
detection_key
数据来源
pbf_relayer_candidates
navsea_object_taxonomy
navsea_object_capabilities
约束
该视图：
只读
不修改原始数据
Task 05 — Spatial Index Builder v2
任务目标
优化空间查询性能。
当前数据规模：
~6.6 million features
Codex 任务
自动分析 geometry 字段并创建空间索引。
优化查询：
半径查询
航线走廊查询
船舶前方查询
目标对象
navsea_detection_objects
semantic feature tables
约束
不得改变表结构。
Task 08 — Semantic Layer Coverage Report v2
任务目标
统计语义系统覆盖率。
检测：
未分类对象
layer 覆盖率
canonical_object 覆盖率
输出表
semantic_layer_coverage
canonical_object_coverage
source_layer_coverage
unclassified_features
coverage_summary
用途
发现：
规则遗漏
新对象
数据异常
Task 09 — Vector Tile Semantic Drift Detection v2
任务目标
检测 PBF 更新导致的语义漂移。
检测内容
新对象类型
source_layer 变化
geometry 类型变化
属性结构变化
语义规则冲突
输出表
semantic_drift_summary
new_object_types
source_layer_drift
geometry_drift
attribute_drift
rule_conflict_report
用途
确保新 PBF 数据不会破坏语义系统。
推荐执行顺序
1 Semantic Overlay Validation
2 Semantic Coverage Report
3 Object Taxonomy
4 Object Capability
5 Detection Object View
6 Spatial Index Builder
7 Drift Detection
最终服务器结构
完成全部任务后服务器语义系统结构：
PBF
↓
Semantic Reconstruction
↓
Taxonomy
↓
Capability
↓
Detection Objects
↓
Spatial Index
↓
Validation / Drift Monitoring
该结构确保：
PBF 稳定
原始属性保留
style.json 可安全重建