75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
# NAC 资产一键上链系统 (nac-onboarding)
|
||
|
||
## 系统概述
|
||
|
||
NAC Asset Onboarding System v3.0 - 基于 NAC 公链的 RWA 资产一键上链系统。
|
||
|
||
## 技术栈
|
||
|
||
- **后端**: Python FastAPI
|
||
- **数据库**: MongoDB
|
||
- **区块链**: NAC 公链（CBPP 共识，NVM 虚拟机）
|
||
- **合规**: ACC-20 协议，7 层 AI 合规审查
|
||
- **工作流**: 17 步完整上链流程
|
||
|
||
## 服务信息
|
||
|
||
| 项目 | 值 |
|
||
|------|-----|
|
||
| 运行服务器 | 103.96.148.7（备份服务器） |
|
||
| 服务端口 | 9552 |
|
||
| 前端域名 | https://onboarding.newassetchain.io |
|
||
| API 文档 | https://onboarding.newassetchain.io/api/docs |
|
||
| 服务名称 | nac-onboarding.service |
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
backend/
|
||
├── main.py # FastAPI 主入口
|
||
├── requirements.txt # 依赖列表
|
||
├── database.py # 数据库连接
|
||
├── models.py # 数据模型
|
||
└── routers/ # API 路由
|
||
├── assets.py # 资产 CRUD 接口（含 onchain_info 聚合）
|
||
├── onboarding.py # 上链工作流接口（17 步）
|
||
└── users.py # 用户认证接口
|
||
docs/
|
||
└── 2026-03-22_onboarding_verification_report.md # 验证报告
|
||
```
|
||
|
||
## 17 步工作流
|
||
|
||
1. Application（申请提交）
|
||
2. Compliance Review（合规审查启动）
|
||
3. Compliance Approved（AI 合规通过）
|
||
4. Valuation Done（资产估值）
|
||
5. DNA Generated（加密 DNA 生成）
|
||
6. Chain Confirmed（链上确认）
|
||
7. Token Structure（代币结构设计）
|
||
8. Code Generated（合约代码生成）
|
||
9. Warrant Issued（权证发行）
|
||
10. Rights Derived（权益衍生）
|
||
11. Warrant Custody（权证托管）
|
||
12. Custody Setup（实物托管）
|
||
13. XTZH Minted（XTZH 铸造）
|
||
14. Token Issued（代币发行）
|
||
15. Explorer Display（区块浏览器展示）
|
||
16. Wallet Deposit（钱包存入）
|
||
17. Exchange Listed（交易所上架）
|
||
|
||
## 变更日志
|
||
|
||
### 2026-03-22
|
||
- **修复工单 #1**: `GET /api/assets/{id}` 接口 `onchain_info` 字段聚合不完整
|
||
- 新增 `_build_onchain_info()` 函数，从各步骤专用字段聚合链上数据
|
||
- 修复字段：dna_hash, chain_tx, token_symbol, token_address, xtzh_minted 等 12 个字段
|
||
- **修复**: MongoDB 开机不自启问题，已创建 systemd 服务
|
||
- **验证**: 完整 17 步工作流数据流转验证通过（12/12 步骤）
|
||
|
||
## 工单追踪
|
||
|
||
| 工单 | 标题 | 状态 | 关闭时间 |
|
||
|------|------|------|----------|
|
||
| #1 | API onchain_info 字段聚合不完整 | 已关闭 | 2026-03-22 |
|