# 模块01：全局态势感知仪表盘 - 运维日志

**模块路径**：`/`（首页）  
**前端文件**：`client/src/pages/Dashboard.tsx`  
**后端路由**：`server/routers.ts` → `dashboard.stats`、`dashboard.jurisdictionStats`  
**数据源**：MongoDB（nac_knowledge_engine）+ MySQL（nac_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>"
```