docs: 更新 README - 完整项目说明

README.md

@@ -1,3 +1,74 @@
-# nac-onboarding
+# NAC 资产一键上链系统 (nac-onboarding)
 
-NAC 资产一键上链系统 v3.0 - RWA Asset Onboarding System (FastAPI + MongoDB + 17-Step Workflow)
+## 系统概述
+
+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 |