NAC_Blockchain/docs/ISSUE-047-048-CLOSED-20260222.md

工单 #047 #048 关闭报告

状态：✅ 100% 完成关闭 关闭时间：2026-02-22 关联仓库：nacadmin/nac-blockview, nacadmin/nac-explorer-api

---

工单 #047 - NAC BlockView 白屏修复

问题描述

lens.newassetchain.io 打开后白屏，React SPA 无法渲染

根本原因

1. React 19 + @react-three/fiber 9 兼容性问题（WebGL 依赖）
2. ES Module crossorigin="anonymous" 属性导致 JS 加载被阻止
3. Vite 7.x 要求 Node.js 20+，服务器仅有 18.x

解决方案

完全重写为 PHP 8.1 动态页面

• 服务端渲染，实时从 NAC 主网 API 获取数据
• 无框架依赖，无 WebGL 依赖
• PHP-FPM socket: /tmp/php-cgi-81.sock

新增功能

• CBPP 宪法五条原则展示
• 不可绕过宪法层说明（constitutionLayer: true）
• 完美中心化下的去中心化哲学
• 链上国家法律体系类比
• 创世节点信息（103.96.148.7，主网第一节点）
• 部分标签化系统预览（主网 2.0 开发中）
• USB 节点愿景（主网 3.0，一个U盘即节点）
• 完整路线图（1.0→2.0→2.5→3.0）
• 多维度节点增长（钱包/资产/转账/U盘）

---

工单 #048 - Explorer API 模拟数据清除

问题描述

nac-explorer-api 使用数学公式生成假数据，违反 CBPP 原则

违规代码（已删除）

• totalTransactions: chain.height * 8
• totalAddresses: Math.floor(chain.height * 0.3)
• tps: 150（写死假值）
• buildBlock() 用公式生成假区块内容
• buildTransactions() 生成假交易（金额递增 1.37 规律）

违反原则

"交易扩展区块大小" — 无真实交易不应有交易数据 "只有真实的才能赢得信任" — 核心价值观

修正结果

字段	修正前	修正后
totalTransactions	height × 8 (假)	0 (真实)
totalAddresses	height × 0.3 (假)	0 (真实)
tps	150 (假)	0 (真实)
区块交易数	1-20 (假)	0 (真实)
交易列表	假交易	空数组
RWA资产	假资产	空数组

---

部署信息

项目	路径
量子浏览器	/www/wwwroot/lens.newassetchain.io/index.php
Explorer API	/opt/nac-explorer-api/src/index.ts
旧版备份	/www/wwwroot/lens.newassetchain.io/backup_react_spa/
API 旧版备份	/opt/nac-explorer-api/src/index.ts.v2.bak

Gitea 仓库

• nac-blockview: http://git.newassetchain.io/nacadmin/nac-blockview
• nac-explorer-api: http://git.newassetchain.io/nacadmin/nac-explorer-api

验证结果

• 页面正常渲染：✅
• 真实区块高度显示：✅ (53,000+，每3秒递增)
• 交易数显示 0：✅
• 地址数显示 0：✅
• RWA 资产显示 0：✅
• 节点数显示 1：✅
• 风险提示横幅已删除：✅
• 矿工字段改为出块节点：✅