From bcf1034079d4fa5fc75c2c3d47130f7370cddde7 Mon Sep 17 00:00:00 2001
From: nacadmin <admin@newassetchain.io>
Date: Sun, 22 Mar 2026 23:06:34 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E5=8F=98=E6=9B=B4?=
 =?UTF-8?q?=E6=97=A5=E5=BF=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/CHANGELOG.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 docs/CHANGELOG.md

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
new file mode 100644
index 0000000..b435ccf
--- /dev/null
+++ b/docs/CHANGELOG.md
@@ -0,0 +1,54 @@
+# 变更日志 (CHANGELOG)
+
+## 2026-03-22
+
+### 修复 (fix)
+
+**工单 #1**: 修复 `GET /api/assets/{id}` 接口 `onchain_info` 字段聚合不完整
+
+**问题描述**：
+调用 `GET /api/assets/{asset_id}` 接口时，返回的 `onchain_info` 字段中所有链上数据（DNA Hash、Chain TX、Token Symbol、Token Address、XTZH Minted 等）均为空值（`--`），但前端界面能正确显示这些数据。
+
+**根本原因**：
+API 接口直接返回 MongoDB 文档，没有从各步骤专用字段中聚合链上数据。链上数据分散存储在：
+- `doc["dna"]["hash"]` — DNA 哈希（Step 5）
+- `doc["warrant"]["tx_hash"]` — 链上交易哈希（Step 6）
+- `doc["token"]["symbol"]` — 代币符号（Step 14）
+- `doc["token"]["address"]` — 代币地址（Step 14）
+- `doc["xtzh"]["amount"]` — XTZH 铸造量（Step 13）
+- 等其他字段
+
+**修复方案**：
+在 `backend/routers/assets.py` 中新增 `_build_onchain_info()` 函数，遍历各步骤专用字段，聚合完整的 `onchain_info` 对象并注入到 API 响应中。
+
+**修复文件**：
+- `backend/routers/assets.py`（新增 `_build_onchain_info()` 函数，修改 `get_asset()` 接口）
+
+**验证结果**：
+- onchain_info.dna_hash ✅
+- onchain_info.chain_tx ✅
+- onchain_info.token_symbol ✅
+- onchain_info.token_address ✅
+- onchain_info.xtzh_minted ✅
+- onchain_info.token_supply ✅
+- onchain_info.valuation_usd ✅
+- onchain_info.compliance_score ✅
+- onchain_info.warrant_id ✅
+- onchain_info.custody_id ✅
+- onchain_info.exchange_listed ✅
+- onchain_info.block_height — 模拟值（`--`），正常
+
+---
+
+**MongoDB 开机自启修复**：
+创建 `/etc/systemd/system/mongod.service` 服务文件，确保服务器重启后 MongoDB 自动启动。
+
+---
+
+## 历史版本
+
+### 2026-03-08（部署）
+- 初始部署一键上链系统 v3.0
+- 17 步工作流完整实现
+- AI 合规审查（7 层验证）
+- XTZH 铸造和代币发行功能