14 KiB

Raw Permalink Blame History

工单 #26 实施计划

工单信息

工单编号: #26
工单标题: NAC公链资产一键上链核心技术白皮书
工单链接: #26
开始时间: 2026-02-19
状态: 进行中

实施目标

100%完整实现NAC公链资产一键上链系统，包括：

✅ 编排引擎（调用SDK适配器）
✅ 9个核心模块（100%完整功能）
✅ Web管理界面（前后端完整实现）
✅ 独立域名 + SSL证书
✅ 生产级部署到备份服务器
✅ 完整的数据库设计
✅ 完整的测试覆盖
✅ 完整的文档

技术架构

1. 后端架构

┌─────────────────────────────────────────────────────────────┐
│                    一键上链编排引擎                          │
│                  (Rust + Actix-web)                         │
└─────────────┬───────────────┬───────────────┬───────────────┘
              ↓               ↓               ↓
┌─────────────┴──────┐ ┌──────┴──────┐ ┌──────┴─────────────┐
│  AI合规审批模块    │ │  AI估值模块  │ │  DNA生成模块       │
│  (调用L4适配器)    │ │ (调用L4适配器)│ │ (调用L1适配器)     │
└─────────────┬──────┘ └──────┬──────┘ └──────────┬──────────┘
              ↓               ↓                    ↓
┌─────────────┴───────────────────────────────────┴──────────┐
│              NAC SDK适配器 (工单#36已完成)                  │
│  L0 | L1 | L2 | L3 | L4 | L5                               │
└─────────────────────────────┬───────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│              NAC公链底层模块                                 │
└─────────────────────────────────────────────────────────────┘

2. 前端架构

┌─────────────────────────────────────────────────────────────┐
│                    Web管理界面                               │
│              (React + TypeScript + Tailwind)                │
├─────────────────────────────────────────────────────────────┤
│  用户前台  │  资产管理  │  进度跟踪  │  文档下载  │  统计    │
├─────────────────────────────────────────────────────────────┤
│  系统后台  │  用户管理  │  审批管理  │  配置管理  │  日志    │
└─────────────────────────────────────────────────────────────┘

3. 数据库设计

┌─────────────────────────────────────────────────────────────┐
│                    MySQL/TiDB数据库                          │
├─────────────────────────────────────────────────────────────┤
│  users        - 用户表                                       │
│  assets       - 资产表                                       │
│  submissions  - 提交记录表                                   │
│  compliance   - 合规审查表                                   │
│  valuations   - 估值记录表                                   │
│  dna_records  - DNA记录表                                    │
│  custody      - 托管记录表                                   │
│  xtzh_minting - XTZH铸造记录表                               │
│  tokens       - 代币发行记录表                               │
│  listings     - 上线记录表                                   │
│  audit_logs   - 审计日志表                                   │
└─────────────────────────────────────────────────────────────┘

9个核心模块详细设计

模块1: 一键上链编排引擎

职责: 管理资产上链状态机，协调各模块调用，处理错误和重试

状态定义:

Pending - 初始提交
ComplianceCheck - 合规审查中
Valuation - 估值中
DNAGeneration - DNA生成中
Custody - 托管对接中
XTZHMinting - XTZH铸造中
TokenIssuance - 代币发行中
Listed - 完成（浏览器、钱包、交易所）
Failed - 失败（附原因）

实现要点:

✅ 完整的状态机实现
✅ 每个状态的完整处理逻辑
✅ 完整的错误处理和重试机制
✅ 完整的日志记录
✅ 完整的通知机制（WebSocket实时推送）

模块2: AI合规审批模块

输入:

资产类型
法律文件哈希
发行方KYC凭证
管辖权信息

处理流程:

从宪法状态加载合规规则（调用L2适配器）
调用AI模型验证文件真伪（调用L4适配器）
检查KYC等级是否满足要求
输出合规性评分及证明

输出:

合规审批结果哈希
提交给宪法执行引擎（CEE）

实现要点:

✅ 100%完整的合规规则验证
✅ 真实调用L4 AI合规适配器
✅ 完整的KYC等级检查
✅ 完整的错误处理

模块3: AI估值模块

输入:

资产类型
相关市场数据（预言机提供）
历史交易数据

处理流程:

从宪法状态加载估值模型参数（调用L2适配器）
聚合预言机数据（调用L4适配器）
运行估值模型，输出估值结果（以SDR计价）

输出:

估值结果哈希
提交给宪法执行引擎（CEE）

实现要点:

✅ 100%完整的估值模型实现
✅ 真实调用L4 AI估值适配器
✅ 完整的预言机数据聚合
✅ 完整的SDR计价转换

模块4: DNA生成模块

职责: 根据资产信息生成48位GNACS编码和资产DNA

处理流程:

解析资产类型、风险权重、合规等级等
调用GNACS编码器生成完整48位编码（调用L1适配器）
创建资产DNA结构（包含基因组、表型、进化历史）

输出:

GNACS编码
DNA哈希

实现要点:

✅ 100%完整的GNACS编码生成
✅ 真实调用L1 GNACS适配器
✅ 完整的DNA结构创建
✅ 完整的加密和哈希计算

模块5: 宪法执行引擎（CEE）

职责: 为每一步操作签发宪法收据（CR），确保合规

交互流程:

每个模块调用前，先向CEE申请收据
模块执行后，将结果提交CEE验证
CEE签发最终收据，附于交易中

实现要点:

✅ 100%完整的收据签发逻辑
✅ 真实调用L2宪政适配器
✅ 完整的验证逻辑
✅ 完整的收据聚合

模块6: 托管对接模块

职责: 对接第三方托管机构，生成托管凭证

处理流程:

从宪法白名单中选择合格托管机构
通过API发送托管请求（资产DNA、估值、法律文件）
接收托管机构签发的托管凭证（数字签名），上链存证

输出:

托管凭证哈希

实现要点:

✅ 100%完整的托管机构对接
✅ 完整的白名单验证
✅ 完整的API调用和签名验证
✅ 完整的上链存证

模块7: XTZH铸造模块

职责: 基于资产估值铸造等值XTZH

处理流程:

根据宪法覆盖率要求（125%），计算需铸造的XTZH数量
调用XTZH合约mint函数（调用L1适配器）
铸造记录关联资产DNA和托管凭证

实现要点:

✅ 100%完整的XTZH铸造逻辑
✅ 真实调用L1 ACC协议适配器
✅ 完整的覆盖率计算
✅ 完整的关联记录

模块8: 权益代币发行模块

职责: 发行代表资产权益的ACC-20/ACC-1400代币

处理流程:

根据资产类型选择合适模板
调用Charter合约工厂部署新合约（调用L1适配器）
将代币所有权转移给发行方或投资者

实现要点:

✅ 100%完整的代币发行逻辑
✅ 真实调用L1 NVM适配器
✅ 完整的合约部署
✅ 完整的所有权转移

模块9: 链上公示模块

职责: 将资产信息自动推送到区块链浏览器、钱包和交易所

处理流程:

向区块链浏览器API注册资产（调用L5适配器）
向合作钱包推送代币信息
向合作交易所提交上币申请

实现要点:

✅ 100%完整的公示逻辑
✅ 真实调用L5应用层适配器
✅ 完整的API对接
✅ 完整的通知机制

Web管理界面设计

用户前台功能

资产提交页面
- 资产类型选择
- 资产信息填写
- 法律文件上传
- KYC凭证上传
进度跟踪页面
- 实时状态显示
- 每个步骤的详细信息
- 错误提示和重试选项
资产管理页面
- 我的资产列表
- 资产详情查看
- TOKEN下载
- DNA和CODE查看
文档下载页面
- 链上权证下载
- 托管凭证下载
- 估值报告下载
统计页面
- 资产统计
- 代币统计
- 估值统计

系统后台功能

用户管理
- 用户列表
- KYC审核
- 权限管理
审批管理
- 待审批列表
- 审批历史
- 审批规则配置
配置管理
- 宪法规则配置
- 托管机构白名单
- 估值模型参数
日志管理
- 操作日志
- 审计日志
- 错误日志

部署方案

1. 域名和SSL

域名: onboarding.newassetchain.io（待确认）

SSL证书: 通过宝塔面板申请Let's Encrypt免费证书

2. 服务器配置

服务器: 103.96.148.7:22000

部署目录: /www/wwwroot/onboarding.newassetchain.io

Nginx配置:

server {
    listen 443 ssl http2;
    server_name onboarding.newassetchain.io;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        root /www/wwwroot/onboarding.newassetchain.io/dist;
        try_files $uri $uri/ /index.html;
    }
    
    location /api {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 数据库配置

数据库: MySQL 8.0

数据库名: nac_onboarding

备份策略: 每天自动备份到 /backup/nac_onboarding

开发计划

第1周: 后端开发

Day 1-2: 编排引擎和状态机

完整的状态机实现
完整的错误处理
完整的日志记录

Day 3-4: 9个核心模块实现

AI合规审批模块
AI估值模块
DNA生成模块
宪法执行引擎
托管对接模块
XTZH铸造模块
权益代币发行模块
链上公示模块

Day 5: API接口和数据库

RESTful API实现
WebSocket实时通知
数据库表设计和创建

第2周: 前端开发

Day 1-2: 用户前台

资产提交页面
进度跟踪页面
资产管理页面

Day 3-4: 系统后台

用户管理
审批管理
配置管理
日志管理

Day 5: 集成和测试

前后端集成
功能测试
性能测试

第3周: 部署和文档

Day 1-2: 部署到备份服务器

配置域名和SSL
部署前后端
配置数据库

Day 3-4: 测试和优化

生产环境测试
性能优化
安全加固

Day 5: 文档和交付

API文档
用户手册
部署指南
交付验收

质量保证

1. 代码质量

✅ 100%完整实现，绝无简化
✅ 完整的错误处理
✅ 完整的日志记录
✅ 完整的注释文档
✅ 代码审查

2. 测试覆盖

✅ 单元测试（覆盖率 > 80%）
✅ 集成测试
✅ 端到端测试
✅ 性能测试
✅ 安全测试

3. 文档完整性

✅ API文档
✅ 用户手册
✅ 部署指南
✅ 运维手册
✅ 故障排查指南

验收标准

功能验收

用户可以提交资产上链申请
系统自动完成9个步骤的处理
用户可以实时查看进度
用户可以下载TOKEN、DNA、CODE
用户可以下载链上权证
系统管理员可以管理用户
系统管理员可以审批资产
系统管理员可以配置规则
系统管理员可以查看日志

性能验收

单个资产上链流程 < 5分钟
并发处理 > 100个资产
API响应时间 < 500ms
前端加载时间 < 3秒

安全验收

HTTPS加密访问
用户认证和授权
SQL注入防护
XSS攻击防护
CSRF攻击防护

部署验收

独立域名访问
SSL证书有效
数据库备份正常
日志记录正常
监控告警正常

交付清单

代码文件

后端代码（Rust）
前端代码（React + TypeScript）
数据库脚本（SQL）
部署脚本（Shell）

文档文件

API文档
用户手册
部署指南
运维手册
故障排查指南

配置文件

Nginx配置
数据库配置
环境变量配置

账号信息

系统管理员账号
数据库账号
服务器账号

制定人: NAC开发团队
制定时间: 2026-02-19
文档状态: 正式版

14 KiB Raw Permalink Blame History Unescape Escape

工单 #26 实施计划

工单信息

实施目标

技术架构

1. 后端架构

2. 前端架构

3. 数据库设计

9个核心模块详细设计

模块1: 一键上链编排引擎

模块2: AI合规审批模块

模块3: AI估值模块

模块4: DNA生成模块

模块5: 宪法执行引擎（CEE）

模块6: 托管对接模块

模块7: XTZH铸造模块

模块8: 权益代币发行模块

模块9: 链上公示模块

Web管理界面设计

用户前台功能

系统后台功能

部署方案

1. 域名和SSL

2. 服务器配置

3. 数据库配置

开发计划

第1周: 后端开发

第2周: 前端开发

第3周: 部署和文档

质量保证

1. 代码质量

2. 测试覆盖

3. 文档完整性

验收标准

功能验收

性能验收

安全验收

部署验收

交付清单

代码文件

文档文件

配置文件

账号信息

14 KiB

Raw Permalink Blame History