diff --git a/README.md b/README.md index 1cb6701..fd7feab 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,74 @@ -# nac-onboarding +# NAC 资产一键上链系统 (nac-onboarding) -NAC 资产一键上链系统 v3.0 - RWA Asset Onboarding System (FastAPI + MongoDB + 17-Step Workflow) \ No newline at end of file +## 系统概述 + +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 |