nacadmin
/
NAC_Blockchain
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NAC_Blockchain/nac-constitution-clauses
History
NAC Admin fe8f935bab Issue #75/76/77: Tier3辖区(225测试)+跨版本兼容检测(6测试)+NAC_Lens路由层(8测试) 
Issue #75: 实现10个Tier3新兴市场辖区(BR/IN/TH/ID/NG/MX/ZA/TR/SA/RU)
- 每辖区独立TxContext数据结构和ConstitutionalValidator
- 225个测试全部通过(Tier1:55+Tier2:100+Tier3:70)
- in模块重命名为in_jurisdiction避免Rust关键字冲突

Issue #76: 实现辖区规则跨版本兼容性检测(nac-jurisdiction-compat)
- CompatibilityChecker支持4种兼容性级别
- 检测AML阈值/KYC等级/资产类型/监管机构变更
- 6个测试全部通过

Issue #77: NAC_Lens辖区路由层集成(nac-lens-jurisdiction-router)
- 支持单辖区/跨辖区/规则更新广播/CR广播/节点注册5种消息类型
- 跨辖区各自独立出具CR(参与即是共识,非多签)
- 规则更新须CA签名立即生效(约法即是治法)
- 8个测试全部通过

NRPC->NAC_Lens: 更新nac-api-server/nac-sdk/nac-asset-onboarding/nac-udm注释
修复Issue#74测试隔离问题(并发测试目录污染)

总测试: 252个全部通过
CBPP合规: 约法即是治法|宪法即是规则|参与即是共识|节点产生区块交易决定区块大小
 		2026-03-07 15:28:13 +08:00
..
src Issue #75/76/77: Tier3辖区(225测试)+跨版本兼容检测(6测试)+NAC_Lens路由层(8测试) 2026-03-07 15:28:13 +08:00
.gitignore Initial commit: NAC公链核心模块 - 生产级别代码 2026-02-16 19:19:43 -05:00
Cargo.lock Issue #75/76/77: Tier3辖区(225测试)+跨版本兼容检测(6测试)+NAC_Lens路由层(8测试) 2026-03-07 15:28:13 +08:00
Cargo.toml feat: Issue #25 - 为所有模块增加统一的升级机制 2026-02-19 01:45:46 -05:00
README.md 同步所有模块更新 2026-02-18 23:28:26 -05:00

README.md

NAC Constitution Clauses - NAC宪法条款管理系统

📋 模块概述

NAC宪法条款管理系统提供完整的宪法条款管理功能，支持三级分层架构、条款验证、持久化存储、版本管理和生命周期管理。

🎯 核心功能

1. 三级分层架构

  • 永恒级 (Eternal): 索引1-100，定义核心价值观和基本原则
  • 战略级 (Strategic): 索引101-1000，定义长期战略和重要规则
  • 战术级 (Tactical): 索引1001+，定义具体操作和细节规范

2. 条款验证

  • ✅ 内容验证 - 标题、内容、索引、生效时间
  • ✅ 层级验证 - 索引范围与层级匹配
  • ✅ 依赖验证 - 依赖存在性检查
  • ✅ 循环依赖检测 - 防止依赖死循环
  • ✅ 哈希验证 - SHA3-384完整性校验

3. 持久化存储

  • ✅ JSON格式存储
  • ✅ 内存缓存加速
  • ✅ 层级索引优化
  • ✅ 增量保存
  • ✅ 查询接口

4. 版本管理

  • ✅ 自动版本号
  • ✅ 变更历史记录
  • ✅ 版本回滚
  • ✅ 变更说明
  • ✅ 创建者追踪

5. 生命周期管理

  • ✅ 状态管理 (草稿/待激活/已激活/已停用/已废止)
  • ✅ 激活/停用/废止操作
  • ✅ 优先级管理
  • ✅ 生效时间范围
  • ✅ 操作审计

6. CBPP升级机制

  • ✅ 升级提案（新增/修改/废止/紧急升级）
  • ✅ 宪法审查委员会
  • ✅ 2/3多数通过规则
  • ✅ 计划执行时间
  • ✅ 升级执行器
  • ✅ 原子性回滚
  • ✅ 执行历史追踪

📦 模块结构

nac-constitution-clauses/
├── src/
│   ├── lib.rs              # 主模块和基础类型
│   ├── validator/          # 条款验证
│   │   └── mod.rs
│   ├── storage/            # 持久化存储
│   │   └── mod.rs
│   ├── manager/            # 条款管理器
│   │   └── mod.rs
│   ├── lifecycle/          # 生命周期管理
│   │   └── mod.rs
│   └── upgrade/            # CBPP升级机制
│       └── mod.rs
├── tests/                  # 集成测试
├── docs/                   # 文档
├── Cargo.toml
└── README.md

📊 代码统计

  • 总代码行数: 2,400+行
  • 测试数量: 39个
  • 测试通过率: 100%
  • 模块数量: 5个核心模块

🔧 依赖项

[dependencies]
nac-udm = { path = "../nac-udm" }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
sha3 = "0.10"

[dev-dependencies]
tempfile = "3.8"

🧪 测试

运行所有测试：

cargo test

测试结果：32个测试全部通过 ✅

📄 许可证

Copyright © 2026 NAC Team. All rights reserved.