# NAC CEE 合规执行引擎架构文档

**版本**: 1.0.0  
**日期**: 2026-03-07  
**协议**: NAC_Lens/4.0  
**状态**: 生产级

---

## 一、架构概览

NAC CEE（Constitutional Execution Engine，宪法执行引擎）是 NAC 公链的核心合规层，负责在交易进入 NVM 执行前进行辖区宪法规则验证。

```
┌─────────────────────────────────────────────────────────────┐
│                    NAC 主网架构（生产级）                    │
├─────────────────────────────────────────────────────────────┤
│  L0 层 (CSNP 网络)                                          │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  nac-l0-csnp (端口 9546) — 节点发现与消息路由       │   │
│  │  NAC_Lens/4.0 辖区路由层 (nac-lens-jurisdiction-router)│ │
│  └─────────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────────┤
│  L1 层 (协议层)                                             │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │ CBPP 节点    │  │ NVM 虚拟机   │  │ 宪法服务         │  │
│  │ (端口 9545)  │  │ (端口 9547)  │  │ (端口 9548)      │  │
│  └──────────────┘  └──────────────┘  └──────────────────┘  │
├─────────────────────────────────────────────────────────────┤
│  L2 层 (应用层)                                             │
│  ┌──────────────────────┐  ┌──────────────────────────────┐ │
│  │ NAC API 网关          │  │ CEE 集成服务 [新]            │ │
│  │ (端口 9550)           │  │ (端口 9558)                  │ │
│  │ NAC_Lens/4.0 入口    │  │ 31辖区宪法规则验证           │ │
│  └──────────────────────┘  └──────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```

---

## 二、CEE 模块依赖关系

```
nac-cee-integration (v1.0.0)
├── nac-jurisdiction-rules (v1.0.0)        ← 31辖区宪法规则
│   ├── Tier 1: CN/HK/SG/AE/US/EU/JP/KR/AU/CH/GB
│   ├── Tier 2: BM/KY/VG/MT/LU/GI/JE/IM/PA/MU
│   └── Tier 3: BR/IN/TH/ID/NG/MX/ZA/TR/SA/RU
├── nac-cee-plugin-loader (v0.1.0)         ← 动态插件加载
├── nac-jurisdiction-version (v0.1.0)      ← 版本管理
├── nac-jurisdiction-compat (v0.1.0)       ← 兼容性检测
└── nac-lens-jurisdiction-router (v0.1.0)  ← NAC_Lens路由
```

---

## 三、交易验证流程

```
交易请求
    │
    ▼
NAC_Lens/4.0 路由层
    │
    ├── 单辖区交易 ──► 辖区宪法规则验证 ──► CR出具 ──► NVM执行
    │
    └── 跨辖区交易 ──► 源辖区验证 ──► CR(源)
                   └── 目标辖区验证 ──► CR(目标)
                                    └── 双CR确认 ──► NVM执行
```

**CBPP 原则体现**：
- 参与即是共识：每个辖区节点独立出具CR，无需等待其他节点
- 约法即是治法：CA签名的规则更新立即生效，无需链上投票
- 宪法即是规则：每辖区独立的宪法规则文件（constitution_rules.cnnl）

---

## 四、辖区规则文件结构

每个辖区包含以下文件：

```
nac-jurisdiction-rules/{CODE}/
├── README.md                    ← 辖区监管框架说明
├── constitution_rules.cnnl      ← CNNL 宪法规则定义
└── protocol_template.charter    ← Charter 合约模板
```

---

## 五、NAC_Lens 消息类型

| 消息类型 | 描述 | CA签名要求 |
|---------|------|-----------|
| `IntraJurisdiction` | 单辖区内部消息 | 否 |
| `CrossJurisdiction` | 跨辖区消息 | 否（各辖区独立验证）|
| `JurisdictionRuleUpdate` | 规则更新广播 | **必须** |
| `ConstitutionalReceiptBroadcast` | CR广播 | 否 |
| `NodeRegistration` | 节点注册 | 须GIDS证明 |