crypto_monitor/manual_trading_hub/数据看板说明.md

中控数据看板说明

入口:/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 看板;常规轮询二者各自按间隔跑,避免连锁打满 CPU.
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.