brunoandClaude
09f1010fb8
✅ 包含完整的Git提交历史 ✅ 详细的性能对比数据 ✅ 5份技术文档索引 ✅ 部署指南和回滚方案 ✅ 后续优化路线图 ✅ ROI分析和经验总结 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
LJWX BigScreen 健康监控大屏系统
🚀 快速开始
LJWX BigScreen 是一个专为工业环境设计的实时健康监控大屏系统，支持多设备健康数据聚合、可视化展示和智能告警。
启动应用
# 进入主目录
cd bigscreen
# 标准启动
python run.py
# 或使用优化启动脚本
python bigScreen/run_bigscreen.py
# 启动所有服务（包括Celery）
./start_all.sh
Docker部署
# 生成Docker Compose配置
cd bigscreen
./generate-docker-compose.sh
# 启动服务
docker-compose up -d
📊 核心功能
- 🔥 CPU自适应批处理系统：动态调整批处理规模，支持高并发数据处理
- ⚡ 三接口智能上传：health_data、device_info、common_event独立处理
- 🛡️ 断点续传机制：网络异常时数据自动缓存，确保零丢失
- 📊 实时监控大屏：ECharts.js驱动的专业数据可视化
- 🚨 智能告警系统：微信推送 + WebSocket实时通知 + 多租户规则配置
- 💬 消息推送系统：群发/个人消息智能区分，支持设备响应追踪
- 🐳 多架构Docker支持：AMD64/ARM64一键部署
🔗 访问地址
- 主大屏：http://localhost:5001/main?customerId=1
- 系统监控：http://localhost:5001/system_monitor
- 性能测试：http://localhost:5001/performance_test_report
- 健康检查：http://localhost:5001/api/health_check
📋 目录结构
ljwx-bigscreen/
├── bigscreen/ # 主应用目录
│ ├── bigScreen/ # Flask应用核心
│ │ ├── bigScreen.py # 主应用文件
│ │ ├── templates/ # HTML模板
│ │ ├── static/ # 静态资源
│ │ └── *_processor.py # 批处理器
│ ├── run.py # 应用入口
│ ├── config.py # 配置文件
│ ├── requirements.txt # Python依赖
│ └── README.md # 详细文档
├── scripts/ # 部署脚本
├── k8s/ # Kubernetes配置
├── tests/ # 测试框架
└── docs/ # 项目文档
🔧 环境要求
- Python 3.8+
- MySQL 5.7+
- Redis 6.0+
- Docker 20.10+ (可选)
📈 性能指标
- 支持设备数：2000+台
- 数据处理能力：1400+ QPS
- 响应时间：<3秒
- 系统稳定性：99.9%+
🆕 最新更新 v1.3.8
Excel导出功能修复与UI体验升级
🔧 Excel导出系统完善
- 导出故障根因解决：修复health_table.html中Excel导出"导出失败，请重试"无错误日志的问题
- XLSX库路径修复：解决Flask静态文件路径配置导致的XLSX库无法加载问题
- 增强错误处理：添加详细调试日志和用户友好错误提示，快速定位问题根因
- CDN备用机制：实现本地XLSX库失败时的CDN自动降级加载策略
🎨 统一UI设计语言
- 自定义弹窗系统：创建统一的
showCustomAlert组件替代原生alert弹窗 - 现代化视觉设计：科技感弹窗界面，支持键盘快捷键（ESC取消、Enter确认）
- 模块化组件：抽离为独立
custom-alert.js文件，支持全系统复用 - 功能增强：支持确认对话框、回调函数处理、流畅动画过渡效果
📁 静态文件架构重构
- 路径问题诊断与修复：发现并解决静态文件错误放置在
/bigScreen/static/导致Flask无法访问的问题 - Flask配置验证：确认
static_folder='../static'正确指向/bigscreen/static/目录 - CDN文件重新组织：将Bootstrap、FontAwesome、ECharts、XLSX等离线CDN文件迁移至正确位置
- 开发环境优化：清理重复文件，建立清晰的静态资源管理结构
# 问题诊断：修复前的错误路径结构
/bigscreen/bigScreen/static/ # ❌ Flask static_folder指向../static，此路径无法访问
├── css/bootstrap-5.1.3.min.css
├── js/echarts.min.js
└── js/xlsx-0.18.5.full.min.js
# 解决方案：修复后的正确路径结构
/bigscreen/static/ # ✅ Flask可以正常访问此路径
├── css/bootstrap-5.1.3.min.css
├── js/echarts.min.js
└── js/xlsx-0.18.5.full.min.js
⚡ 系统体验优化
- 用户管理界面升级：配合前端管理系统，用户操作按钮美化（编辑、健康档案、更多）
- 批量操作简化：隐藏批量导入功能，简化用户操作流程
- 错误诊断增强：Excel导出失败时提供详细错误信息而非通用提示
- 静态资源稳定性：确保所有CDN库文件路径正确，避免功能失效
🆕 历史版本 v1.3.6
多租户告警规则系统与UI优化
- 🎯 多租户告警规则系统：支持不同组织独立配置告警规则，实现精准告警
- 🌐 告警信息全面中文化：告警消息、状态显示、通知推送全中文显示
- 📊 健康基准分析优化：修复多指标模式布局问题，支持完整9宫格图表展示
- ⚡ 消息推送系统优化：群发消息与个人消息智能区分，提升推送准确性
- 🎨 UI交互体验升级：现代化界面设计，提升用户操作体验
v1.3.5 个人大屏UI现代化改造
- 现代化网格布局：采用CSS Grid响应式布局，替代传统左右分栏
- 高科技视觉设计：渐变背景、动画粒子、扫描线效果营造科技感
- 高级仪表盘组件：环形进度条配合数值显示，支持状态色彩变化
- 智能状态指示器：实时健康状态监控，支持正常/警告/危险三级显示
- 流畅动画系统：呼吸灯、脉冲、扫描等多种专业动画效果
- 现代化卡片设计：磨砂玻璃效果、悬停动画、立体阴影
📚 详细文档
完整的技术文档、API接口说明、部署指南等请查看：
👉 详细文档
🤝 技术支持
- 项目主页：GitHub Repository
- 问题反馈：Issues
- 在线演示：http://localhost:5001/main?customerId=1
🔗 相关项目
- ljwx-watch - 智能手表系统
- ljwx-phone - 手机客户端
- ljwx-admin - 管理后台
- ljwx-boot - Spring Boot后端服务
最后更新：2025年8月29日