NAC_Blockchain/docs/nac-docs-center/devlog/v14-v20-devlog.md

130 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# NAC-ADMIN v14-v20 运维日志
**日期:** 2026-02-27
**操作人:** admin@newassetchain.io
**工单范围:** v14补充 / v15补充 / v16补充 / v17 / v18 / v19 / v20
**状态:** ✅ 100% 完成部署并测试通过
---
## 工单清单
| 工单 | 功能描述 | 新增文件 | 状态 |
|------|----------|----------|------|
| v14补充 | AI语义搜索增加开关可选启用AI增强 | KnowledgeBase.tsx | ✅ |
| v15补充 | 版本历史并排对比(任意两版本文本差异) | KnowledgeBase.tsx | ✅ |
| v16补充 | PDF导出章节筛选包含/排除特定辖区) | KnowledgeBase.tsx, reportGenerator.ts | ✅ |
| v17 | 监管动态AI自动更新RSS监控+AI分析+Webhook告警 | server/regulatoryMonitor.ts, pages/RegulatoryMonitor.tsx | ✅ |
| v18 | 知识库多维度统计分析(热力图+覆盖率+空白区域) | pages/KnowledgeAnalytics.tsx | ✅ |
| v19 | 规则冲突检测引擎(跨辖区冲突检测+冲突报告) | server/conflictDetector.ts, pages/ConflictDetector.tsx | ✅ |
| v20 | 一键上链合规验证(七层合规+钱包绑定+交易所清单) | pages/ChainValidation.tsx | ✅ |
---
## 详细实现说明
### v14补充 — AI语义搜索开关
- 在知识库搜索栏右侧添加"AI增强"开关Switch组件
- 默认关闭,启用后切换至语义向量检索模式
- 关闭时使用普通关键词全文检索节省API调用
### v15补充 — 版本并排对比
- 版本历史对话框中,每个历史版本新增"选择对比"按钮
- 选择两个版本后,点击"对比选中版本"展开并排对比面板
- 对比面板显示:变更字段名称、旧值(红色背景)、新值(绿色背景)
### v16补充 — PDF章节筛选
- PDF导出对话框新增"排除辖区"多选(默认全选)
- `reportGenerator.ts``ReportConfig` 类型新增 `excludeJurisdictions` 字段
- 生成PDF时过滤掉用户排除的辖区规则
### v17 — 监管动态AI自动更新
**后端模块:** `server/regulatoryMonitor.ts`
- 定义六辖区官方监管机构RSS源CN/HK/SG/US/EU/AE
- `fetchRegulatoryUpdates()` 抓取RSS并调用LLM分析影响
- `applyRegulatoryUpdate()` 将AI建议写入 `regulatory_updates` 集合
- `sendWebhookAlert()` 支持企微/钉钉/飞书Webhook告警
**前端页面:** `/regulatory-monitor`
- 统计面板:监管动态总数、待处理、高优先级、已应用
- 辖区/状态筛选器
- "立即抓取"按钮触发实时抓取
### v18 — 知识库多维度统计分析
**前端页面:** `/knowledge-analytics`
- 辖区×资产类型覆盖热力图6×6矩阵颜色深浅表示规则数量
- 整体覆盖率47.2%17/36组合已覆盖
- 空白区域19个知识产权/设备/大宗商品覆盖不足)
- 辖区覆盖率排名(进度条可视化)
- 资产类型覆盖率排名证券100%、房地产83%、数字代币83%
### v19 — 规则冲突检测引擎
**后端模块:** `server/conflictDetector.ts`
- 基于规则关键词匹配检测跨辖区冲突
- 冲突类型:禁止冲突/要求冲突/阈值冲突/程序冲突
- 严重性:紧急/高/中/低
**检测结果6个冲突**
1. 🔴 紧急 — 数字代币 CN vs HK禁止冲突
2. 🔴 紧急 — 证券 US vs EUSEC vs MiCA要求冲突
3. 🟠 高 — 房地产 CN vs AE登记体系程序冲突
4. 🟡 中 — 房地产 SG vs US投资者门槛阈值冲突
5. 🟡 中 — 大宗商品 EU vs AE碳排放要求冲突
6. 🟢 低 — 证券 HK vs SG最低投资额阈值冲突
### v20 — 一键上链合规验证
**前端页面:** `/chain-validation`
- 资产信息表单:资产名称/类型/目标辖区/价值USD
- NAC钱包绑定输入NAC地址NAC开头32字节Address类型
- 钱包关联说明:
- 钱包地址绑定资产合规档案,作为链上身份标识
- XTZH质押量影响可发行代币数量上限
- 钱包持有的CBPP验证节点资格影响合规评分
- 验证结果展示七层合规评分0-100分、交易所上市资格清单
---
## 生产服务器部署记录
| 检查项 | 结果 |
|--------|------|
| 构建工具 | Node.js 24.13.0(宝塔面板 `/www/server/nodejs/v24.13.0/bin/` |
| 构建结果 | ✅ DONEpnpm build成功 |
| systemd服务 | active ✅ |
| HTTPS响应 | HTTP 200 ✅ |
| 新功能代码bundle | 已包含 ✅ |
| Gitea推送 | `7a5a3af → a449b66` ✅ |
| NAC_AI内联引用 | 0 ✅ |
---
## 浏览器测试结果
| 页面 | URL | 测试结果 |
|------|-----|----------|
| 仪表盘 | / | ✅ 正常35条规则6辖区全绿 |
| 监管动态 | /regulatory-monitor | ✅ 正常(立即抓取按钮可用) |
| 统计分析 | /knowledge-analytics | ✅ 正常(热力图、覆盖率、空白区域全部显示) |
| 冲突检测 | /conflict-detector | ✅ 正常6个冲突2个紧急 |
| 一键上链 | /chain-validation | ✅ 正常(资产表单+钱包绑定+验证按钮) |
---
## 账号信息
| 角色 | 账号 | 密码 |
|------|------|------|
| NAC后台管理员 | admin@newassetchain.io | NacAdmin2026! |
| Gitea管理员 | nacadmin | NacAdmin2026 |
| MongoDB root | root | idP0ZaRGyLsTUA3a |
| 宝塔面板 | cproot | vajngkvf |
| 服务器SSH | root | XKUigTFMJXhH |
---
## 下一步建议
- v21一键上链验证结果写入MongoDB生成合规档案PDF
- v22钱包地址与XTZH质押量实时查询接入NAC链RPC
- v23交易所上市申请流程自动化生成申请材料包