docs: 添加目录重组日志 DIRECTORY_RESTRUCTURE_20260307.md

This commit is contained in:
NAC Admin 2026-03-07 17:47:52 +08:00
parent 1cdfd6c7cc
commit a489b88f78
1 changed files with 123 additions and 0 deletions

View File

@ -0,0 +1,123 @@
# 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 |