- 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>
1.8 KiB
1.8 KiB
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.md 和 DEVELOPMENT.md
核心功能
- 仪表板 - 健康数据概览和最近数据展示
- 数据同步 - 从 Garmin 同步最新健康数据
- 数据分析 - 趋势分析和数据可视化
- 健康建议 - 基于数据的个性化建议
- 设置 - 用户配置和偏好设置
关键特性
- ✅ Garmin API 集成
- ✅ 多维度数据分析(步数、心率、睡眠等)
- ✅ 实时数据同步
- ✅ 交互式数据可视化
- ✅ JWT 认证安全
- ✅ 本地数据存储
开发指南
- 详见 DEVELOPMENT.md
- API 文档见 README.md
常用命令
npm run dev # 开发模式
npm run build # 构建项目
npm run typecheck # 类型检查
npm start # 生产模式
下一步任务
- 实现 Garmin OAuth 认证
- 完成 Garmin API 数据获取
- 实现仪表板可视化
- 添加数据分析算法
- 部署和优化
联系方式
项目维护: ericwyuan.g@gmail.com