# 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 |