Files
GarminHealthLab/CLAUDE.md
ericwyuan d73405decb Initial commit: Set up Garmin Health Lab project structure
- Initialize monorepo with root workspace configuration
- Set up Express.js backend with TypeScript
- Set up React 18 frontend with TypeScript
- Create database schema with SQLite
- Implement project architecture and documentation
- Add development and deployment guidelines

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-23 11:11:29 +08:00

1.8 KiB
Raw Blame History

Garmin Health Lab - 项目指南

项目简介

Garmin Health Lab 是一个完整的健康数据分析平台,用于:

  • 获取和同步佳明Garmin设备数据
  • 进行多维度的健康数据分析
  • 提供个性化的健康建议
  • 可视化健康趋势

技术栈

  • 前端: React 18 + TypeScript + Recharts
  • 后端: Node.js + Express + TypeScript
  • 数据库: SQLite3
  • API 集成: Garmin Connect API

快速开始

安装

npm install

配置

cp server/.env.example server/.env
# 编辑 server/.env 填入 Garmin 凭证

开发

npm run dev

项目结构

  • client/ - React 前端应用
  • server/ - Node.js 后端服务
  • docs/ - 文档

详见 ARCHITECTURE.mdDEVELOPMENT.md

核心功能

  1. 仪表板 - 健康数据概览和最近数据展示
  2. 数据同步 - 从 Garmin 同步最新健康数据
  3. 数据分析 - 趋势分析和数据可视化
  4. 健康建议 - 基于数据的个性化建议
  5. 设置 - 用户配置和偏好设置

关键特性

  • Garmin API 集成
  • 多维度数据分析(步数、心率、睡眠等)
  • 实时数据同步
  • 交互式数据可视化
  • JWT 认证安全
  • 本地数据存储

开发指南

常用命令

npm run dev          # 开发模式
npm run build        # 构建项目
npm run typecheck    # 类型检查
npm start            # 生产模式

下一步任务

  • 实现 Garmin OAuth 认证
  • 完成 Garmin API 数据获取
  • 实现仪表板可视化
  • 添加数据分析算法
  • 部署和优化

联系方式

项目维护: ericwyuan.g@gmail.com