NAC_Blockchain/docs/architecture/DIRECTORY_RESTRUCTURE_20260...

124 lines
4.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 代码库目录重组日志
**执行时间**: 2026-03-07
**提交哈希**: 1cdfd6c
**执行人**: 运维自动化
---
## 重组背景
原有代码库存在"继承式开发恶习":所有功能被错误地归集到 `services/nac-admin` 目录,
导致知识库、资产审批、协议注册等去中心化业务功能被放置在带有明显中心化联想的 admin 目录中。
**核心原则**
- `ops/nac-admin` 只做运维(节点监控、审计日志、合规监控)
- 区块链协议和业务服务完全独立,不归属任何 admin 目录
---
## 新目录结构
```
NAC_Blockchain/
├── ops/ ← 运维层(中心化,明确标注)
│ ├── nac-admin/ ← 运维管理后台(仅保留运维功能)
│ ├── nac-monitor/ ← 节点监控
│ ├── nac-daemon/ ← 守护进程
│ ├── nac-deploy/ ← 部署脚本
│ └── nac-cee-integration/ ← CEE 集成服务
├── services/ ← 对外服务层(去中心化业务)
│ ├── nac-api-server/ ← NAC_Lens/4.0 API 网关
│ ├── nac-explorer-api/ ← 量子浏览器 API
│ ├── nac-knowledge-portal/ ← 知识库门户(从 admin 迁出)
│ ├── nac-rwa-portal/ ← RWA 审批/标签门户(从 admin 迁出)
│ ├── nac-protocol-registry/ ← 协议注册表(从 admin 迁出)
│ └── nac-data-crawler/ ← 数据爬虫(从 admin 迁出)
├── sdk/ ← 开发者工具
│ ├── nac-sdk/
│ ├── nac-cli/
│ └── nac-serde/
└── archive/ ← 归档(旧版本/备份)
├── nac-nac_lens.bak.20260228/
├── nac-cli-backup/
└── nac-explorer-api.backup-20260227_141339/
```
---
## ops/nac-admin 职责拆分
### 保留(纯运维)
| 页面 | 功能 |
|------|------|
| Dashboard | 节点状态监控、服务健康检查 |
| AuditLog | 系统操作审计日志 |
| RegulatoryMonitor | 合规监控 |
### 迁出(去中心化业务)
| 原位置 | 功能 | 新位置 |
|--------|------|--------|
| KnowledgeBase | NAC 知识库 | services/nac-knowledge-portal/ |
| Crawlers | 数据采集 | services/nac-data-crawler/ |
| ApprovalCases | RWA 资产审批 | services/nac-rwa-portal/ |
| TagEngine | 资产标签引擎 | services/nac-rwa-portal/ |
| ProtocolRegistry | 协议注册表 | services/nac-protocol-registry/ |
---
## 域名访问测试结果(搬迁后)
| 域名 | 状态 | HTTP 码 |
|------|------|---------|
| admin.newassetchain.io | ✅ 正常 | 200 |
| api.newassetchain.io | ✅ 正常 | 200 |
| explorer.newassetchain.io | ✅ 正常 | 200 |
| git.newassetchain.io | ✅ 正常 | 200 |
| id.newassetchain.io | ✅ 正常 | 200 |
| lens.newassetchain.io | ✅ 正常 | 200 |
| rpc.newassetchain.io | ✅ 已修复 | 200 |
| rwa.newassetchain.io | ✅ 正常 | 200 |
| onboarding.newassetchain.io | ✅ 正常 | 200 |
| wallet.newassetchain.io | ✅ 正常 | 200 |
| exchange.newassetchain.io | ✅ 正常 | 200 |
| exchange-admin.newassetchain.io | ✅ 正常 | 200 |
| chat.newassetchain.io | ✅ 正常 | 200 |
| cnnl.newassetchain.io | ✅ 正常 | 200 |
| mainnet-monitor.newassetchain.io | ✅ 正常 | 302 |
| presale.newassetchain.io | ✅ 正常 | 200 |
| downloads.newassetchain.io | ✅ 正常 | 200 |
| prometheus.newassetchain.io | ✅ 正常 | 302 |
| ico.newassetchain.io | ✅ 正常 | 200 |
| dev.newassetchain.io | ✅ 正常 | 200 |
**总计20/20 域名全部正常访问 ✅**
---
## 附加修复
- `rpc.newassetchain.io` nginx 配置修复:原指向 9547NVM仅有 /health 端点),
修正为指向 9550NAC_Lens/4.0 API 网关),现在返回 HTTP 200。
---
## 后续规划(单独工单)
- `protocol/` 分组:将 CBPP/CSNP/NVM/宪法/NAC_Lens 协议模块归组
- `rwa/` 分组:将 RWA 法律要素体系模块归组
- 以上需要更新大量 Cargo.toml 路径引用,风险较高,建议单独工单执行
---
## 后台管理账号
| 服务 | 地址 | 账号 | 密码 |
|------|------|------|------|
| SSH | 103.96.148.7:22000 | root | XKUigTFMJXhH |
| 宝塔面板 | http://103.96.148.7:12/btwest | cproot | vajngkvf |
| Gitea | https://git.newassetchain.io | nacadmin | NACadmin2026! |
| MongoDB | 103.96.148.7 | root | idP0ZaRGyLsTUA3a |