diff --git a/docs/architecture/DIRECTORY_RESTRUCTURE_20260307.md b/docs/architecture/DIRECTORY_RESTRUCTURE_20260307.md new file mode 100644 index 0000000..9732725 --- /dev/null +++ b/docs/architecture/DIRECTORY_RESTRUCTURE_20260307.md @@ -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 配置修复:原指向 9547(NVM,仅有 /health 端点), + 修正为指向 9550(NAC_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 |