ljwx-health/backup_docs_20260104_182653/DATA_FLOW_DASHBOARD_QUICKSTART.md

健康数据流Dashboard快速开始

5分钟快速部署指南 ⚡

---

🚀 一键启动

前置条件检查（30秒）

# 检查Java版本
java -version  # 需要 21+

# 检查Node版本
node -v  # 需要 18+

# 检查服务
redis-cli ping  # 应返回 PONG
mysql --version # 应正常显示版本

启动后端（1分钟）

# 1. 进入后端目录
cd ljwx-boot

# 2. 启动服务
./run-local.sh

# 3. 等待启动完成，看到以下日志即为成功：
# ✅ WebSocket配置完成
# 🔌 注册WebSocket处理器: /ws/data-flow

启动前端（1分钟）

# 1. 进入前端目录
cd ljwx-admin

# 2. 安装依赖（首次）
pnpm install

# 3. 启动开发服务器
pnpm dev

# 4. 看到以下输出即为成功：
# ➜  Local:   http://localhost:3333/

访问Dashboard（30秒）

# 浏览器访问
http://localhost:3333/monitor/data-flow

# 应该看到：
# ✅ 数据流桑基图
# ✅ 4个关键指标卡片
# ✅ WebSocket已连接状态
# ✅ 数据详细表格

---

✅ 验证部署

一键验证

# 运行自动化验证脚本
./scripts/verify-data-flow-dashboard.sh

# 预期输出：
# ✅ 通过: 18
# ❌ 失败: 0
# ✅ 数据流Dashboard部署验证成功！

手动测试

# 1. 测试WebSocket连接
curl -i -H "Connection: Upgrade" \
  -H "Upgrade: websocket" \
  http://localhost:9998/ws/data-flow
# 应返回: HTTP/1.1 101 Switching Protocols

# 2. 查看Redis统计
redis-cli -a 123456 KEYS "health:stats:*"
# 应显示 6 个统计键

# 3. 模拟数据上传
curl -X POST http://localhost:9998/api/health/upload \
  -H "Content-Type: application/json" \
  -d '[{"deviceSn":"test-001","userId":1,"heart_rate":75}]'
# 应返回成功响应

# 4. 验证统计更新
redis-cli -a 123456 GET "health:stats:total_received"
# 应显示数值（如 125）

---

📊 Grafana Dashboard（可选）

部署Grafana（K8s环境）

# 1. 部署完整监控栈
./scripts/deploy-observability.sh

# 2. 端口转发Grafana
kubectl port-forward -n infra svc/grafana 3000:3000

# 3. 访问Grafana
# http://localhost:3000
# 用户名: admin
# 密码: admin123

# 4. 导入Dashboard
# Dashboards → Import → 上传文件
# deploy/monitoring/grafana/dashboards/ljwx-health-data-flow.json

---

🔧 常见问题

Q1: WebSocket连接失败？

# 检查后端是否启动
./ljwx-boot/run-local.sh status

# 检查端口是否监听
netstat -tuln | grep 9998

# 查看错误日志
tail -f ljwx-boot/logs/ljwx-boot-admin_error.log

Q2: 前端显示空白？

# 检查前端是否启动
ps aux | grep vite

# 清除缓存重新安装
cd ljwx-admin
rm -rf node_modules
pnpm install
pnpm dev

Q3: 数据不更新？

# 检查Redis连接
redis-cli -a 123456 ping

# 检查统计键
redis-cli -a 123456 KEYS "health:stats:*"

# 模拟数据上传测试
curl -X POST http://localhost:9998/api/health/upload \
  -H "Content-Type: application/json" \
  -d '[{"deviceSn":"test","userId":1,"heart_rate":75}]'

---

📚 详细文档

需要更多信息？查看完整文档：

1. 完整部署指南 - 详细步骤和故障排查
2. 实施总结 - 架构和技术细节
3. 数据流分析 - 系统架构分析

---

🎯 下一步

✅ 部署完成后，你可以：

1. 实时监控数据流

   • 访问 http://localhost:3333/monitor/data-flow
   • 查看实时吞吐量、去重率、告警数

2. 查看Grafana仪表板（如已部署）

   • 访问 http://localhost:3000
   • 浏览 "LJWX Health - 数据流监控" Dashboard

3. 集成到生产环境

   • 参考 DATA_FLOW_DASHBOARD_DEPLOYMENT.md 第9章
   • 配置Nginx反向代理
   • 部署到K8s集群

---

部署时间: 约 5 分钟 ⚡ 验证时间: 约 2 分钟 ✅ 总计: 7 分钟即可完成完整部署！

立即开始 → ./scripts/verify-data-flow-dashboard.sh 🚀