brunoandClaude
8f76690e8a
- 新增蓝牙健康数据上传修复功能描述 - 移除ljwx-phone数据最外层data结构的修复说明 - 优化BLE传输稳定性和数据同步效率的文档说明 - 更新README.md最新功能版本记录 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
灵境万象健康管理系统 (LJWX)
📋 项目概述
灵境万象健康管理系统（LJWX）是一套完整的企业级健康监测解决方案，专为工业环境下的可穿戴设备健康数据监控而设计。系统集成了数据采集、实时分析、智能告警、可视化大屏等功能模块，为企业提供全方位的员工健康安全保障。
🎯 核心特性
- 🏥 健康数据监控: 实时采集心率、血压、体温、运动数据等多维度健康指标
- 🚨 智能告警系统: 多渠道告警通知，支持微信、消息、大屏推送
- 📊 可视化大屏: 专业级监控大屏，实时展示健康状态和告警信息
- 📱 移动端应用: Flutter开发的移动APP，支持数据查看和设备管理
- ⌚ 智能手表集成: 支持华为Watch4等智能穿戴设备数据采集
- 🏢 多租户架构: 企业级权限管理，支持租户隔离和部门管理
🏗️ 系统架构
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ ljwx-watch │ │ ljwx-phone │ │ ljwx-admin │ │ljwx-bigscreen│
│ 智能手表 │ ──▶ │ 移动应用 │ ──▶ │ 管理后台 │ ──▶ │ 监控大屏 │
│ (HarmonyOS)│ │ (Flutter) │ │ (Vue3) │ │ (Python) │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│ │ │ │
└───────────────────┼───────────────────┼───────────────────┘
│ │
┌─────────────┐ ┌─────────────┐
│ ljwx-boot │ │ 数据存储 │
│ 后端API │◄──▶│ MySQL+Redis │
│(Spring Boot)│ │ │
└─────────────┘ └─────────────┘
📂 项目结构
🔧 后端服务 (ljwx-boot)
- Spring Boot 3.3.2 + Java 21 - 现代化微服务架构
- 健康管理模块: 10+健康指标实时监控、睡眠分析、运动追踪
- 系统管理模块: 多租户架构、RBAC权限控制、组织管理
- 设备管理模块: IoT设备生命周期管理、状态监控
- 告警系统: 智能阈值监控、多级告警处理
- 地理围栏: 虚拟边界监控、位置告警
🖥️ 前端管理 (ljwx-admin)
- Vue3 + TypeScript + Naive UI - 现代化管理界面
- 健康数据管理: ECharts可视化、Excel导出、时间序列分析
- 设备管理: 电池监控、佩戴状态、设备配置
- 告警管理: 实时告警监控、规则配置、微信集成
- 用户组织管理: 分层权限、角色管理、部门架构
- 系统监控: 性能指标、日志管理、缓存监控
📊 监控大屏 (ljwx-bigscreen)
- Python Flask + Socket.IO - 高性能实时监控
- 实时数据处理: 支持1000+设备并发、QPS>1400
- 告警处理引擎: 多渠道通知、层级分发、WebSocket推送
- 健康分析系统: AI健康画像、个人基线、Z-score异常检测
- 地图可视化: 实时位置追踪、告警地点标记
- 性能优化: Redis缓存、批量查询、连接池管理
📱 移动应用 (ljwx-phone)
- Flutter 3.0+ 跨平台 - 统一iOS/Android体验
- 蓝牙BLE集成: 自动设备发现、二进制协议、实时同步
- 健康数据可视化: FL Chart图表、雷达图健康评分
- 管理员模式: 嵌入式Web界面、SHA认证、角色切换
- 数据同步: 蓝牙/WiFi双模式、本地缓存、批量上传
- 告警通知: 实时推送、声音提醒、状态指示
⌚ 智能手表 (ljwx-watch)
- HarmonyOS 3.0 原生应用 - 深度系统集成
- 健康传感器: 心率、血氧、体温、压力、步数监测
- 电源优化: 统一定时器、15-18小时续航、智能调度
- 通信协议: 高级TLV二进制格式、50%数据压缩
- 紧急功能: SOS按钮、跌倒检测、一键告警
- 实时同步: 蓝牙BLE/WiFi双通道、离线缓存
🚀 最新功能 v1.3.3
🔧 蓝牙健康数据上传修复 (2025-08-19)
移动端数据传输优化
- 数据结构简化: 移除ljwx-phone上传健康数据最外层的data结构，直接传输核心数据
- 蓝牙传输稳定性: 优化BLE数据包格式，提高传输成功率和稳定性
- 数据同步效率: 简化数据封装层次，减少传输开销，提升同步速度
- 兼容性增强: 确保手表端和服务端数据格式完全匹配，避免解析错误
📋 代码分析与文档完善 (2025-08-16)
完整系统分析
- 深度模块分析: 完成所有5个模块的详细代码分析
- 技术架构文档: 新增完整的系统功能模块清单文档
- API接口梳理: 详细整理各模块核心API和功能特性
- 性能指标确认: 验证系统性能数据和技术参数
技术文档体系
- 系统功能模块清单: 109KB综合技术文档
- 模块功能清单: ljwx-boot、ljwx-admin、ljwx-bigscreen、ljwx-phone、ljwx-watch
- 架构设计说明: 详细的技术栈和系统架构分析
- 部署运维指南: 完整的部署和监控方案
🚀 历史版本 v1.3.2
✨ 告警通知系统完整升级
多渠道通知
- 企业微信: 支持企业微信应用消息推送
- 公众号微信: 支持微信公众号模板消息
- 系统消息: 内置消息系统，层级分发通知
- 大屏推送: Critical级别告警实时推送到监控大屏
智能层级通知
设备告警事件
↓
告警规则匹配
↓
┌─────────────┐
│ 通知分发策略 │
└─────────────┘
↓ ↓ ↓
用户通知 部门主管 租户管理员
↓ ↓
(无主管时) (最终兜底)
实时大屏集成
- WebSocket实时推送: Socket.IO支持秒级告警推送
- 专业告警界面: 科技感弹窗设计，包含告警详情
- 交互功能: 支持告警确认、音效提醒、ESC关闭
- 地图标记: 可选的告警位置地图标记功能
🛠️ 技术亮点
- 多架构支持: Docker支持AMD64/ARM64多架构部署
- 性能优化: 解决N+1查询问题，响应时间从181s优化到<5s
- 高并发处理: QPS >1400，支持2000+设备并发
- 容错设计: 微信通知失败自动降级，确保告警可达性
- 智能手表集成: HarmonyOS原生应用，支持15+小时续航
- 二进制协议: TLV格式数据传输，压缩率达50%
- AI健康分析: 集成DeepSeek R1模型，智能健康建议
📋 快速开始
环境要求
| 组件 | 版本要求 | 说明 |
|---|---|---|
| Java | ≥ JDK 21 | 后端运行环境 |
| Node.js | ≥ 18.0 | 前端构建环境 |
| Python | ≥ 3.8 | 大屏系统环境 |
| MySQL | ≥ 8.0 | 数据存储 |
| Redis | ≥ 6.0 | 缓存存储 |
| Docker | ≥ 20.10 | 容器化部署(可选) |
🐳 快速部署 (推荐)
# 1. 克隆项目
git clone https://github.com/your-org/ljwx-system.git
cd ljwx-system
# 2. 一键启动所有服务
docker-compose up -d
# 3. 初始化数据库
mysql -u root -p123456 < client-deployment/client-data.sql
# 4. 访问系统
# 管理后台: http://localhost:3000
# 监控大屏: http://localhost:5001
# API文档: http://localhost:9998/doc.html
🔧 开发环境部署
后端服务
cd ljwx-boot
./run-local.sh
前端管理
cd ljwx-admin
npm install
npm run dev
监控大屏
cd ljwx-bigscreen/bigscreen
python run_bigscreen.py
📊 系统展示
管理后台
- 健康数据总览、实时设备状态监控
- 告警配置管理、用户权限控制
- 数据可视化图表、统计分析报表
监控大屏
- 实时健康数据地图、告警状态展示
- Critical告警弹窗、WebSocket实时推送
- 系统性能监控、设备在线状态
移动应用
- 个人健康档案、历史数据查询
- 设备绑定管理、消息通知中心
- 健康评分分析、趋势图表展示
🔧 配置说明
数据库配置
# application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/test
username: root
password: 123456
告警通知配置
# 企业微信配置
WECHAT_CORP_ID = "your_corp_id"
WECHAT_AGENT_ID = "your_agent_id"
WECHAT_SECRET = "your_secret"
# 公众号配置
WECHAT_APPID = "your_appid"
WECHAT_APPSECRET = "your_appsecret"
WECHAT_TEMPLATE_ID = "your_template_id"
📈 性能指标
- 响应时间: <3秒 (1000设备规模)
- 并发处理: QPS >1400
- 系统可用性: 99.9%
- 告警及时性: <5秒 (Critical级别)
🔒 安全特性
- 多租户隔离: 数据完全隔离，权限严格控制
- API安全: Sa-Token鉴权，接口权限细化
- 数据加密: 敏感数据AES加密存储
- SQL注入防护: MyBatis-Plus参数化查询
📚 技术文档
核心文档
- 系统功能模块清单 - 完整的系统功能和技术架构说明
- 告警通知功能完整实现方案 - 告警通知系统技术方案
部署文档
开发文档
移动端文档
- 数据监控解决方案使用指南 - 移动端使用说明
- 手表开发和使用指南 - 智能手表开发指南
🤝 贡献指南
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
📄 开源协议
本项目基于 Apache License 2.0 开源协议，仅供学习参考使用。
👥 联系我们
- 项目主页: GitHub
- 问题反馈: Issues
- 技术支持: [email protected]
© 2024 灵境万象健康管理系统 (LJWX). All rights reserved.