# 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 可安全重建
```

---
