diff --git a/docs/ISSUE-047-048-CLOSED-20260222.md b/docs/ISSUE-047-048-CLOSED-20260222.md new file mode 100644 index 0000000..8b021f9 --- /dev/null +++ b/docs/ISSUE-047-048-CLOSED-20260222.md @@ -0,0 +1,89 @@ +# 工单 #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:✅ +- 风险提示横幅已删除:✅ +- 矿工字段改为出块节点:✅