docs: 主网部署日志+CEE架构文档+API参考文档

- docs/deployment/MAINNET_DEPLOY_LOG_20260307.md: 2026-03-07主网部署日志 - docs/architecture/NAC_CEE_ARCHITECTURE.md: CEE集成服务架构文档 - docs/api/CEE_API_REFERENCE.md: CEE API参考文档部署摘要: - 6个核心服务全部运行 - 31个辖区宪法规则验证在线 - 258个测试全部通过 - NAC_Lens/4.0协议集成完成
2026-03-07 15:36:37 +08:00 · 2026-03-07 15:36:37 +08:00 · a09b59bd15
parent 9c1c716ee8
commit a09b59bd15
3 changed files with 300 additions and 0 deletions
--- a/docs/api/CEE_API_REFERENCE.md
+++ b/docs/api/CEE_API_REFERENCE.md
@ -0,0 +1,94 @@
+# NAC CEE 集成服务 API 参考
+
+**版本**: 1.0.0  
+**协议**: NAC_Lens/4.0  
+**端口**: 9558  
+**状态**: 生产级
+
+---
+
+## 健康检查接口
+
+**端点**: `GET /health`  
+**描述**: 返回 CEE 集成服务的完整健康状态
+
+**响应示例**:
+```json
+{
+  "service": "nac-cee-integration",
+  "version": "1.0.0",
+  "status": "healthy",
+  "jurisdictions_loaded": 31,
+  "total_tests_passed": 252,
+  "cbpp_principles": {
+    "constitutional_law_is_governance": true,
+    "constitution_is_rules": true,
+    "participation_is_consensus": true,
+    "nodes_produce_blocks": true
+  },
+  "modules": {
+    "nac-jurisdiction-rules": {
+      "name": "NAC辖区宪法规则验证插件集（31辖区）",
+      "status": "running",
+      "test_count": 225,
+      "version": "1.0.0"
+    }
+  }
+}
+```
+
+---
+
+## 交易验证接口
+
+**端点**: `POST /validate`  
+**描述**: 对指定辖区的交易进行宪法规则验证
+
+**请求体**:
+```json
+{
+  "jurisdiction": "CN",
+  "tx_hash": "0xabcdef1234567890",
+  "amount_usd": 5000.0,
+  "asset_type": "RWA_REAL_ESTATE",
+  "kyc_level": "Institutional",
+  "aml_cleared": true,
+  "is_cross_border": false,
+  "sanctions_cleared": true
+}
+```
+
+**响应体**:
+```json
+{
+  "jurisdiction": "CN",
+  "tx_hash": "0xabcdef1234567890",
+  "valid": true,
+  "cr_issued": true,
+  "rules_passed": ["CN_AML_001", "CN_KYC_001", "CN_SANCTIONS_001"],
+  "violation": null,
+  "protocol": "NAC_Lens/4.0"
+}
+```
+
+---
+
+## 支持的辖区列表
+
+| 层级 | 辖区代码 |
+|------|---------|
+| 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 |
+
+---
+
+## 错误码
+
+| 错误码 | 描述 |
+|--------|------|
+| `{JUR}_AML_001` | AML 金额超限，需要反洗钱清除 |
+| `{JUR}_KYC_001` | KYC 验证缺失 |
+| `{JUR}_SANCTIONS_001` | 制裁筛查未通过 |
+| `Jurisdiction not supported` | 不支持的辖区代码 |
+
--- a/docs/architecture/NAC_CEE_ARCHITECTURE.md
+++ b/docs/architecture/NAC_CEE_ARCHITECTURE.md
@ -0,0 +1,101 @@
+# 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证明 |
+
--- a/docs/deployment/MAINNET_DEPLOY_LOG_20260307.md
+++ b/docs/deployment/MAINNET_DEPLOY_LOG_20260307.md
@ -0,0 +1,105 @@
+# NAC 主网部署日志 — 2026-03-07
+
+**部署时间**: 2026-03-07 15:34:44 CST  
+**部署人员**: NAC 开发团队  
+**服务器**: 103.96.148.7:22000  
+**协议版本**: NAC_Lens/4.0  
+**状态**: ✅ 全部服务正常运行
+
+---
+
+## 一、本次部署内容
+
+本次部署完成了 Issue #71 至 #77 的全部工单，实现了 NAC 公链全球 31+ 辖区合规验证体系的生产级部署。
+
+### 新增服务
+
+| 服务名 | 端口 | 描述 | 状态 |
+|--------|------|------|------|
+| `nac-cee-integration` | 9558 | CEE集成服务（31辖区+NAC_Lens路由） | ✅ 运行中 |
+
+### 新增模块（库）
+
+| 模块 | 版本 | 测试数 | 描述 |
+|------|------|--------|------|
+| `nac-jurisdiction-rules` | 1.0.0 | 225 | 31辖区宪法规则验证插件集 |
+| `nac-cee-plugin-loader` | 0.1.0 | 7 | CEE插件动态加载器 |
+| `nac-jurisdiction-version` | 0.1.0 | 6 | 辖区规则版本管理 |
+| `nac-jurisdiction-compat` | 0.1.0 | 6 | 跨版本兼容性检测 |
+| `nac-lens-jurisdiction-router` | 0.1.0 | 8 | NAC_Lens辖区路由层 |
+| `nac-cee-integration` | 1.0.0 | 6 | 生产级CEE集成服务 |
+
+**总测试通过数**: 258 个（全部通过，0 失败）
+
+---
+
+## 二、服务状态验证
+
+```
+✅ nac-cbpp-node:          active  (端口 9545)
+✅ nac-l0-csnp:            active  (端口 9546)
+✅ nac-l1-nvm:             active  (端口 9547)
+✅ nac-constitution-service: active (端口 9548)
+✅ nac-api-server:         active  (端口 9550)
+✅ nac-cee-integration:    active  (端口 9558) [新增]
+```
+
+---
+
+## 三、辖区覆盖范围
+
+### Tier 1 — 高度成熟监管框架（11个）
+
+| 辖区 | 国家/地区 | 监管机构 |
+|------|---------|---------|
+| CN | 中国 | PBOC/CSRC |
+| HK | 香港 | SFC/HKMA |
+| SG | 新加坡 | MAS |
+| AE | 阿联酋 | VARA/CBUAE |
+| US | 美国 | SEC/CFTC |
+| EU | 欧盟 | MiCA/EBA |
+| JP | 日本 | FSA/JFSA |
+| KR | 韩国 | FSC/FSS |
+| AU | 澳大利亚 | ASIC/AUSTRAC |
+| CH | 瑞士 | FINMA |
+| GB | 英国 | FCA/PRA |
+
+### Tier 2 — 离岸金融中心（10个）
+
+BM（百慕大）、KY（开曼群岛）、VG（英属维京群岛）、MT（马耳他）、LU（卢森堡）、GI（直布罗陀）、JE（泽西岛）、IM（马恩岛）、PA（巴拿马）、MU（毛里求斯）
+
+### Tier 3 — 新兴市场（10个）
+
+BR（巴西）、IN（印度）、TH（泰国）、ID（印度尼西亚）、NG（尼日利亚）、MX（墨西哥）、ZA（南非）、TR（土耳其）、SA（沙特阿拉伯）、RU（俄罗斯）
+
+---
+
+## 四、CBPP 合规验证
+
+| 原则 | 状态 | 说明 |
+|------|------|------|
+| 约法即是治法 | ✅ | CA签名直接生效，无需链上投票 |
+| 宪法即是规则 | ✅ | 每辖区独立宪法规则，节点注册须GIDS证明 |
+| 参与即是共识 | ✅ | 验证通过即出具CR，无多签机制 |
+| 节点产生区块交易决定区块大小 | ✅ | 节点独立处理，无全局锁 |
+
+---
+
+## 五、系统资源状态
+
+- **内存使用**: 2.1Gi / 7.8Gi (27%)
+- **磁盘使用**: 43G / 69G (66%)
+- **CPU 负载**: 1.07, 0.72, 0.36
+- **量子浏览器**: https://explorer.newassetchain.io/ ✅ 在线
+
+---
+
+## 六、后台管理账号
+
+| 服务 | 地址 | 账号 | 密码 |
+|------|------|------|------|
+| SSH | 103.96.148.7:22000 | root | XKUigTFMJXhH |
+| 宝塔面板 | http://103.96.148.7:12/btwest | cproot | vajngkvf |
+| Gitea | http://localhost:3333 | nacadmin | NACadmin2026! |
+| 代码库 | https://git.newassetchain.io/nacadmin/NAC_Blockchain | — | — |
+