# 中控数据看板说明

入口：**`/dashboard`**（顶栏「数据看板」）。

## 能力

| 区块 | 说明 |
|------|------|
| **总览 KPI** | 交易日、平仓盈亏、笔数、浮盈亏、资金合计、实盘持仓 |
| **分户明细** | 四户资金/交易账户、今日盈亏、浮盈亏、备注；未启用显示「未监控」 |
| **平仓明细** | 当日平仓流水（合约、方向、结果、盈亏、时间） |
| **风险预警** | 单户单日平仓亏损 ≥ 资金合计 **5%** 时横幅 + 卡片高亮 |

纯数据聚合，**不调用 AI**。交易日口径与实例一致（`TRADING_DAY_RESET_HOUR`，默认 8 点）。

## 刷新机制（SSE）

与监控区 board 类似，采用 **后台聚合 + SSE 推送版本号**：

1. `hub.py` 启动后 `dashboard_store` 每 **60s**（`DASHBOARD_POLL_INTERVAL_SEC`）聚合四户数据到内存快照。
2. 浏览器打开看板页后连接 `GET /api/dashboard/stream`（`event: dashboard`）。
3. 收到新版本号后拉取 `GET /api/dashboard/daily` 快照并局部渲染，**无整页轮询闪烁**。
4. 监控区触发 board 刷新（全平、撤单等）时，会一并 `request_refresh` 看板，尽量与实盘同步。
5. 「立即刷新」→ `POST /api/dashboard/refresh` 触发下一轮聚合。

可选环境变量：`HUB_DASHBOARD_SSE_HEARTBEAT_SEC`（默认 25，SSE 心跳间隔）。

## 主题与样式

- 跟随中控顶栏 **亮/暗主题**（`theme.js`），使用 `--panel` / `--border` / `--accent` 等变量。
- 卡片采用 **柔光阴影**（非霓虹渐变背景）；亮色主题下为浅灰投影，暗色主题为轻微内高光。
- 盈亏仍用绿/红语义色，与全局一致。

## API

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/dashboard/daily` | 当前交易日快照（含 `dashboard_version`） |
| GET | `/api/dashboard/stream` | SSE 版本推送 |
| POST | `/api/dashboard/refresh` | 请求立即重聚合 |

`GET /api/ping` 含 `dashboard_version`、`dashboard_poll_interval_sec` 等字段。

## 相关文件

- `hub_dashboard.py` — 聚合逻辑
- `hub_dashboard_cache.py` — 后台轮询 + SSE
- `static/dashboard.js` / `dashboard.css` — 前端

部署后 `git pull` 并 `pm2 restart manual-trading-hub`。
