┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ ljwx-watch  │    │ ljwx-phone  │    │ ljwx-admin  │    │ljwx-bigscreen│
│   智能手表   │ ──▶ │   移动应用   │ ──▶ │  管理后台    │ ──▶ │   监控大屏   │
│  (HarmonyOS)│    │  (Flutter)  │    │   (Vue3)    │    │ (Python)    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │                   │
       └───────────────────┼───────────────────┼───────────────────┘
                           │                   │
                    ┌─────────────┐    ┌─────────────┐
                    │ ljwx-boot   │    │   数据存储   │
                    │  后端API    │◄──▶│ MySQL+Redis │
                    │(Spring Boot)│    │             │
                    └─────────────┘    └─────────────┘

💻 技术栈

模块	技术栈	版本
后端	Spring Boot + Java	3.3.2 + JDK 21
前端	Vue3 + TypeScript + Naive UI	3.5 + 5.7 + 2.40
大屏	Flask + Python + ECharts	2.0+ + 3.8+
移动端	Flutter + Dart	3.0+
手表	HarmonyOS + ArkTS	3.0
数据库	MySQL + Redis	8.0 + 7.0
监控	Prometheus + Grafana + Loki	-
部署	Docker + Kubernetes + Argo CD	-

🚀 快速开始

环境要求

Docker: 20.10+ (推荐)
Kubernetes: 1.28+ (生产环境)
Java: JDK 21+ (本地开发)
Node.js: 18+ (前端开发)
Python: 3.8+ (大屏开发)

方式 A: Docker Compose (推荐新用户) ⭐

# 1. 克隆项目
git clone https://github.com/yourorg/ljwx-health.git
cd ljwx-health

# 2. 启动完整环境
docker-compose -f docker-compose.p0.yml up -d

# 3. 访问服务
# - 后端API:  http://localhost:9998
# - 管理后台: http://localhost:3333
# - 监控大屏: http://localhost:5001

详细文档: Docker快速启动

方式 B: Kubernetes 部署 (生产环境)

# 1. 部署基础设施
./scripts/deploy-infrastructure.sh

# 2. 部署应用
./scripts/deploy-k3s-with-ingress.sh

# 3. 访问服务
kubectl get ingress -n ljwx-health

详细文档: Kubernetes部署指南

方式 C: 本地开发

# 后端
cd ljwx-boot
./run-local.sh             # http://localhost:9998

# 前端
cd ljwx-admin
pnpm install && pnpm dev   # http://localhost:3333

# 大屏
cd ljwx-bigscreen/bigscreen
python run.py              # http://localhost:5225

详细文档: 开发环境配置

📊 核心功能

🆕 v2.0.4 - AI健康推荐引擎 (2026-01-21)

行为画像生成: 基于30天数据分析用户运动、睡眠、佩戴习惯
智能推荐系统: Priority Scoring算法，Top 5个性化健康建议
趋势预测分析: 线性回归分析30天趋势，IMPROVING/STABLE/DECLINING分类
定时任务调度: 每日凌晨自动生成行为画像和健康推荐

→ 行为推荐架构 | Sprint 9完成报告

核心算法:

优先级分数 = (严重程度 × 0.5) + (可行性 × 0.3) + (用户关注度 × 0.2)
趋势判断 = 线性回归斜率 > 0.5 ? IMPROVING : (< -0.5 ? DECLINING : STABLE)

v2.0.2 - 数据流监控Dashboard (2026-01-04)

ECharts Sankey拓扑图: 实时展示数据流向
4个关键指标: 接收量、去重率、告警数、延迟
WebSocket实时推送: 3秒自动刷新
Grafana监控: 专业级仪表板

→ 数据流Dashboard文档

v2.0 - 电子围栏与轨迹监控

轨迹回放: DBSCAN聚类、停留点识别
热力图生成: 网格聚合、高斯平滑
智能告警: 4种规则抑制误报
离线补传: 去重、时序恢复

→ 电子围栏文档

🆕 v2.0.3 - OpenAPI代码生成与类型安全 (2026-01-04)

自动类型生成: 从403个API端点生成TypeScript类型（29,138行）
类型安全客户端: openapi-fetch集成，100%类型覆盖
CI/CD自动检查: GitHub Actions检测前后端API同步
文档标准化: 8分类目录结构，自动化合规检查

→ OpenAPI代码生成指南

v1.4 - 工程治理与可观测性

Flyway数据库迁移: 自动化schema管理
OpenTelemetry集成: 分布式追踪
Prometheus + Grafana: 完整监控栈
GitOps CI/CD: Gitea Actions + Argo CD

→ 可观测性架构

📈 性能指标

指标	数值	说明
并发用户	2000+	同时在线监控
数据吞吐	1000+ TPS	轨迹写入
WebSocket延迟	<300ms	实时推送
查询响应	<5s	30天数据查询
缓存命中率	60%+	Redis缓存
CI构建时间	5分钟	多架构镜像

🆕 Health模块 P0 性能优化 (2026-01-26)

跨分片查询优化: P95延迟从 400ms → 40ms (10x提升)
组织级查询优化: P95延迟从 800ms → 36ms (22x提升)
批量查询优化: 性能倍数从 13x → 0.94x (远超5x目标)
索引命中率: 从 40% → 100%

→ Health模块快速参考 | 完整分析文档

🔒 安全特性

✅ 多租户隔离: 5层防护体系，数据和告警规则完全隔离 → 架构详解
✅ 权限控制: RBAC角色权限管理
✅ 数据加密: 传输层TLS、存储层加密
✅ API安全: OpenAPI契约、输入验证
✅ 审计日志: 完整操作审计

🛠️ 技术亮点

多租户架构 🏢

5层隔离防护: 前端拦截 → 请求拦截 → 上下文隔离 → SQL拦截 → 数据隔离
冗余字段同步: 事件驱动架构，自动同步 orgName/customerName
失败重试机制: 定时任务保障最终一致性
数据重建服务: 一键修复冗余字段数据
完整指南: 多租户架构V2.1

工程治理 ✅

OpenAPI-First: 契约驱动开发，自动生成前端类型
类型安全: 403个API端点100%TypeScript类型覆盖
Flyway迁移: 数据库版本控制
GitOps部署: 声明式配置
文档规范: 8分类目录结构，自动化合规检查
蓝图合规: PROMPT_BLUEPRINT.md

可观测性 📊

完整监控栈: Logs + Traces + Metrics三大支柱
分布式追踪: OpenTelemetry自动埋点
详细文档: 可观测性架构

Docker 优化 🐳

自定义基础镜像: 预集成OpenTelemetry Agent
完整指南: 自定义基础镜像

性能优化 ⚡

Redis三层缓存: L1/L2/L3分级
数据库分区: 6个月滚动窗口
批量处理: CPU自适应调度
连接池优化: Druid + Lettuce

📚 文档资源

快速开始

开发指南

后端开发
前端开发
API契约
多租户架构V2.1快速参考 ⭐ 5层租户隔离防护
Health模块快速参考 ⭐ 5分钟了解核心架构

部署指南

自定义基础镜像 ⭐ OpenTelemetry集成必读
CI/CD工作流 ⭐ Gitea Actions + Argo CD
Docker部署
Kubernetes部署

运维手册

完整目录

→ 文档中心 | CHANGELOG

🤝 贡献指南

我们欢迎所有形式的贡献！

提交Bug: GitHub Issues
功能建议: Feature Request
代码贡献: 参考 CONTRIBUTING.md
文档改进: 参考文档规范

📄 开源协议

本项目采用 Apache License 2.0 开源协议。

👥 联系我们

项目主页: https://github.com/yourorg/ljwx-health
文档站点: https://docs.ljwx-health.com
问题反馈: GitHub Issues
技术支持: [email protected]

⭐ 如果这个项目对你有帮助，请给我们一个Star！