112 lines
2.6 KiB
Markdown
112 lines
2.6 KiB
Markdown
# 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个核心模块
|
||
|
||
## 🔧 依赖项
|
||
|
||
```toml
|
||
[dependencies]
|
||
nac-udm = { path = "../nac-udm" }
|
||
serde = { version = "1.0", features = ["derive"] }
|
||
serde_json = "1.0"
|
||
sha3 = "0.10"
|
||
|
||
[dev-dependencies]
|
||
tempfile = "3.8"
|
||
```
|
||
|
||
## 🧪 测试
|
||
|
||
运行所有测试：
|
||
|
||
```bash
|
||
cargo test
|
||
```
|
||
|
||
测试结果：32个测试全部通过 ✅
|
||
|
||
## 📄 许可证
|
||
|
||
Copyright © 2026 NAC Team. All rights reserved.
|