# 变更日志 (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 铸造和代币发行功能