# health-master

**Repository Path**: bug---engineer/health-master

## Basic Information

- **Project Name**: health-master
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-09
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Health Master

![img](data:image/svg+xml,%3csvg%20xmlns=%27http://www.w3.org/2000/svg%27%20version=%271.1%27%20width=%2739%27%20height=%2710%27/%3e)![image](https://img.shields.io/badge/license-MIT-blue.svg)

![img](data:image/svg+xml,%3csvg%20xmlns=%27http://www.w3.org/2000/svg%27%20version=%271.1%27%20width=%2730%27%20height=%2710%27/%3e)![image](https://img.shields.io/badge/Java-8+-green.svg)

![img](data:image/svg+xml,%3csvg%20xmlns=%27http://www.w3.org/2000/svg%27%20version=%271.1%27%20width=%2756%27%20height=%2710%27/%3e)![image](https://img.shields.io/badge/Spring%20Boot-2.7+-orange.svg)

Health Master 是一款基于 Java 开发的个人健康数据管理系统，旨在帮助用户便捷记录、分析和追踪各类健康指标（如体重、血压、运动时长、饮食摄入等），通过数据可视化与本地 / 云端存储结合的方式，让健康管理更专业、更便捷。

## 核心功能

✅ **多维度健康数据记录**：支持体重、血压、心率、运动、饮食等核心健康指标的录入、编辑与删除

✅ **数据可视化分析**：通过折线图、柱状图等展示健康指标变化趋势，支持按日 / 周 / 月维度筛选

✅ **灵活的数据存储**：支持本地 SQLite 数据库存储，可选云端同步（基于云函数 / 云数据库）

✅ **自定义健康提醒**：可设置定时提醒（如每日体重记录、运动打卡、服药提醒）

✅ **数据导出与备份**：支持将健康数据导出为 Excel/CSV 格式，支持一键备份到云端

✅ **多端适配**：后端提供 RESTful API，可对接 Web / 移动端前端

## 快速开始

### 环境要求

- JDK 8 及以上版本
- Maven 3.6+
- Spring Boot 2.7+
- SQLite（本地存储）/ 云数据库（可选）

### 安装步骤

1. 克隆项目到本地

```
git clone https://gitee.com/bug---engineer/health-master.git
cd health-master
```

2. 编译并安装依赖

```
mvn clean install
```

3. 配置数据库

- 本地模式：无需额外配置，项目默认使用 SQLite 本地数据库，启动后自动初始化表结构
- 云端模式：修改 `application.yml` 中云数据库 / 云函数相关配置（如接口地址、密钥等）

4. 运行项目

```
# 方式1：Maven 直接运行
mvn spring-boot:run

# 方式2：打包后运行
mvn package
java -jar target/health-master-1.0.0.jar
```

5. 访问系统

- 后端 API 地址：`http://localhost:8080/api`
- 前端页面（若有）：`http://localhost:8080`

## 使用指南

### 1. 数据录入

- 调用 `/api/health/record/add` 接口，或通过前端页面选择「新增记录」
- 填写健康指标类型（如血压）、数值、记录时间、备注等信息
- 提交后系统自动校验数据并存储

### 2. 数据查询与分析

- 基础查询：调用 `/api/health/record/list` 接口，支持按指标类型、时间范围筛选
- 趋势分析：访问 `/api/health/analysis/trend` 接口，获取指定指标的趋势数据与图表渲染参数
- 可视化查看：前端页面「数据统计」模块自动加载图表展示分析结果

### 3. 数据导出与备份

- 导出本地：调用 `/api/health/record/export` 接口，指定格式（Excel/CSV）导出数据
- 云端备份：开启配置后，调用 `/api/health/record/sync` 接口一键同步到云端

### 4. 提醒设置

- 调用 `/api/health/reminder/add` 接口，设置提醒类型、触发时间、重复规则
- 系统定时任务自动检测提醒，支持邮件 / APP 推送提醒通知

## 项目结构

```
health-master/
├── src/main/java/com/healthmaster/
│   ├── controller/       # 接口控制器
│   │   ├── HealthRecordController.java  # 健康记录接口
│   │   ├── AnalysisController.java      # 数据分析接口
│   │   └── ReminderController.java      # 提醒管理接口
│   ├── service/          # 业务逻辑层
│   │   ├── HealthRecordService.java     # 记录核心业务
│   │   ├── AnalysisService.java         # 数据分析业务
│   │   ├── ReminderService.java         # 提醒业务
│   │   └── CloudSyncService.java        # 云端同步业务
│   ├── mapper/           # 数据访问层
│   │   ├── HealthRecordMapper.java      # 记录数据库操作
│   │   └── ReminderMapper.java          # 提醒数据库操作
│   ├── model/            # 数据模型
│   │   ├── entity/       # 数据库实体
│   │   ├── dto/          # 接口入参/出参
│   │   └── vo/           # 前端展示模型
│   ├── util/             # 工具类
│   │   ├── DateUtils.java               # 时间工具
│   │   ├── ExportUtils.java             # 导出工具
│   │   └── CloudFunctionUtils.java      # 云函数调用工具
│   └── HealthMasterApplication.java     # 程序入口
├── src/main/resources/
│   ├── application.yml   # 配置文件
│   ├── db/               # 数据库脚本
│   └── static/           # 前端静态资源（若有）
├── pom.xml               # Maven 依赖
└── README.md             # 项目说明
```

## 核心接口示例

### 1. 新增健康记录

```
POST /api/health/record/add
Content-Type: application/json

{
  "type": "BLOOD_PRESSURE", // 指标类型：体重/血压/心率等
  "value": "120/80",        // 指标数值
  "recordTime": "2024-05-20 08:30:00",
  "remark": "晨起测量"
}
```

### 2. 查询健康记录

```
GET /api/health/record/list?type=BLOOD_PRESSURE&startTime=2024-05-01&endTime=2024-05-20
```

### 3. 同步数据到云端

```
POST /api/health/record/sync
Content-Type: application/json

{
  "recordIds": [1,2,3], // 要同步的记录ID
  "syncType": "UPLOAD"  // UPLOAD-上传 / DOWNLOAD-下载
}
```

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交代码 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 致谢

- 感谢 Spring Boot、MyBatis 等开源框架提供的技术支持
- 本项目设计思路参考 [Recordthings](https://github.com/ckxkx/Recordthings)，致敬原作者的优秀设计
- 感谢云服务提供商提供的云端存储 / 函数能力支持

## 问题反馈

如果在使用过程中遇到问题或有功能建议，可通过以下方式反馈：

- 提交 Gitee Issue
- 联系作者：[微信: zyc15624157136]