NAC_Blockchain/docs_center/nac-admin/modules/01-dashboard.md

65 lines
2.2 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.

# 模块01全局态势感知仪表盘 - 运维日志
**模块路径**`/`(首页)
**前端文件**`client/src/pages/Dashboard.tsx`
**后端路由**`server/routers.ts` → `dashboard.stats`、`dashboard.jurisdictionStats`
**数据源**MongoDBnac_knowledge_engine+ MySQLnac_id
---
## 功能说明
仪表盘是管理后台的核心监控页面,提供 NAC 知识引擎的全局运行状态视图。
| 指标卡片 | 数据来源 | 说明 |
|----------|----------|------|
| 合规规则总数 | MongoDB compliance_rules | 知识库中的合规规则条目数 |
| 活跃协议 | MongoDB protocols | 状态为 active 的协议族数量 |
| 采集器运行 | MongoDB crawlers | 状态为 running 的采集器数量 |
| 审批通过率 | MongoDB approval_cases | 近30天通过/总数比率 |
| 待人工审核 | MongoDB approval_cases | 状态为 pending_human 的案例数 |
| 系统用户 | MySQL nac_id.users | NAC 注册用户总数 |
| 审计日志 | MySQL audit_logs | 不可篡改审计记录总数 |
| 司法辖区覆盖 | MongoDB compliance_rules | 已覆盖的辖区数量 |
## API 端点
```
GET /api/trpc/dashboard.stats
GET /api/trpc/dashboard.jurisdictionStats
```
## 图表说明
- **审批趋势图近7天**:折线图,显示通过/拒绝/待审三条曲线,使用 Recharts 渲染
- **司法辖区覆盖饼图**显示各辖区SG/HK/CN/AE/EU/US的规则分布
## 系统服务状态监控
| 服务 | 数据库 | 检测方式 |
|------|--------|----------|
| MongoDB 知识引擎 | nac_knowledge_engine | ping 命令 |
| MySQL 认证数据库 | nac_id | SELECT 1 |
| Charter 编译服务 | - | 进程检测 |
| CNNL 神经网络 | - | 进程检测 |
| ACC-20 协议服务 | - | 进程检测 |
| GNACS 资产分类 | - | 进程检测 |
## 已知问题
| 问题 | 状态 | 说明 |
|------|------|------|
| 审批通过率显示 0% | 已知 | 初始数据中无已审批案例,属正常现象 |
| Charter/CNNL 服务状态 | 模拟数据 | 实际服务检测接口待接入 |
## 运维操作
```bash
# 查看仪表盘 API 日志
journalctl -u nac-admin -n 50 | grep "dashboard"
# 手动测试 API
curl -sk https://admin.newassetchain.io/api/trpc/dashboard.stats \
-H "Cookie: nac_admin_token=<token>"
```