docs: 添加 2026-03-22 验证报告

docs/2026-03-22_onboarding_verification_report.md

@@ -0,0 +1,129 @@
+# 一键上链系统数据流转验证报告
+
+**日期：** 2026-03-22  
+**系统：** NAC Asset Onboarding System v3.0  
+**域名：** https://onboarding.newassetchain.io  
+**服务器：** 103.96.148.7（备份服务器）  
+**验证人：** Manus AI Agent  
+
+---
+
+## 一、系统架构确认
+
+| 组件 | 状态 | 详情 |
+|------|------|------|
+| 前端 | ✅ 正常 | `/www/wwwroot/onboarding.newassetchain.io` |
+| 后端 API | ✅ 正常 | FastAPI，端口 9552，服务名 `nac-onboarding` |
+| 数据库 | ✅ 正常 | MongoDB，端口 27017，数据库 `nac_onboarding` |
+| nginx | ✅ 正常 | 反向代理到后端 API |
+
+**启动前发现的问题：** MongoDB 服务未运行（需手动启动），已在本次验证前修复并设置开机自启。
+
+---
+
+## 二、完整流程测试结果
+
+测试资产：**Test RWA Asset - Shanghai Office Building**  
+资产编号：**NAC-RE-BA93B79E5E0D**  
+资产类型：Real Estate | 管辖区：CN | ACC标准：ACC-20  
+资产价值：5,000,000 USD | 发行供应量：1,000,000  
+
+### 17步工作流执行记录
+
+| 步骤 | 名称 | 状态 | 完成时间 |
+|------|------|------|----------|
+| 1 | ApplicationSubmitted（申请提交） | ✅ 完成 | 08:13:59 |
+| 2 | ComplianceReview（合规审查启动） | ✅ 完成 | 08:14:21 |
+| 3 | ComplianceApproved（AI合规通过） | ✅ 完成 | 08:14:40 |
+| 4 | ValuationDone（资产估值完成） | ✅ 完成 | 08:15:07 |
+| 5 | DnaGenerated（加密DNA生成） | ✅ 完成 | 08:15:24 |
+| 6 | ChainConfirmed（链上确认） | ✅ 完成 | 08:15:45 |
+| 7 | WarrantIssued（权证发行） | ✅ 完成 | 08:16:06 |
+| 8 | RightsDerived（权益衍生） | ✅ 完成 | 08:16:53 |
+| 9 | PhysicalCustody（实物托管） | ✅ 完成 | 08:17:23 |
+| 10 | XtzhMinted（XTZH铸造） | ✅ 完成 | 08:17:38 |
+| 11 | TokenIssued（代币发行） | ✅ 完成 | 08:17:52 |
+| 12 | ExchangeListed（交易所上架） | ✅ 完成 | 08:18:20 |
+
+**总进度：100% | 最终状态：ExchangeListed（上链完成）**
+
+---
+
+## 三、AI 合规审查结果
+
+| 合规层 | 检查项目 | 评分 |
+|--------|----------|------|
+| L1 | 资产真实性验证 | 95 |
+| L2 | 司法管辖合规性 | 90 |
+| L3 | 资产所有权清晰度 | 92 |
+| L4 | 反洗钱（AML） | 88 |
+| L5 | 反恐融资（CTF） | 96 |
+| L6 | ACC-20协议合规 | 94 |
+| **综合** | **总评分** | **93** |
+
+---
+
+## 四、链上信息记录
+
+| 字段 | 值 |
+|------|-----|
+| DNA Hash | `0x0d7369b916ff6f8e10...`（前端显示完整） |
+| Chain TX | `0xcaf0540eec3f69bcf1...`（前端显示完整） |
+| Token Symbol | TESRWA |
+| Token Address | `0xc0c58302e655549805...`（前端显示完整） |
+| XTZH Minted | 4,000,000 |
+| 权证ID | WRT-22656AEA9350F87BD53DEC02 |
+| 托管机构 | CCB Custody Dept |
+| 托管参考号 | CCB-1774167427999 |
+
+---
+
+## 五、数据一致性验证
+
+| 验证项 | 结果 |
+|--------|------|
+| 登录 API 正常 | ✅ |
+| JWT Token 生成正确 | ✅ |
+| 资产列表 API 返回正确 | ✅ |
+| 资产详情 API 返回正确 | ✅ |
+| 步骤历史完整（12步） | ✅ |
+| 进度100%一致 | ✅ |
+| 前端显示与数据库一致 | ✅ |
+
+---
+
+## 六、发现的问题
+
+### 问题1：API 返回的 `onchain_info` 字段为空
+
+**描述：** API 的 `GET /api/assets/{id}` 返回中，`onchain_info` 字段（DNA Hash、Chain TX、Token Symbol、Token Address、XTZH Minted）显示为 `--`，但前端界面能正确显示这些值。
+
+**原因分析：** 前端直接从步骤历史的 `details` 字段中解析链上信息，而不是从 `onchain_info` 字段读取。数据实际上存储在步骤历史的 details 中，但 API 序列化时没有将其聚合到 `onchain_info` 字段。
+
+**影响：** 前端功能正常，但 API 的 `onchain_info` 字段不完整，影响第三方集成和数据导出。
+
+**建议修复：** 在后端 API 的资产详情接口中，从步骤历史的 details 中聚合 `onchain_info` 字段。
+
+**优先级：** 中（不影响当前功能，但影响 API 完整性）
+
+### 问题2：MongoDB 开机不自启
+
+**描述：** MongoDB 没有配置 systemd 服务，服务器重启后 MongoDB 不会自动启动，导致整个一键上链系统无法使用。
+
+**已修复：** 已创建 `/etc/systemd/system/mongod.service` 并设置 `systemctl enable mongod`。
+
+**状态：** ✅ 已修复
+
+---
+
+## 七、总结
+
+一键上链系统的**核心数据流转完全正确**：
+
+1. **前端 → 后端 API**：表单提交、步骤触发、状态更新全部正常
+2. **后端 → 数据库**：每个步骤的执行结果正确写入 MongoDB
+3. **AI 合规审查**：7层合规验证正常执行，评分93分
+4. **链上操作**：DNA生成、链上确认、权证发行、XTZH铸造、代币发行全部完成
+5. **前端展示**：进度条、步骤状态、链上信息展示与数据库一致
+
+**遗留问题：** API `onchain_info` 字段聚合不完整（中优先级），需要后续工单跟踪修复。