# 咕咚水记：喝水提醒（uni-app）

**Repository Path**: qx-team/drink-water-app

## Basic Information

- **Project Name**: 咕咚水记：喝水提醒（uni-app）
- **Description**: 咕咚水记是一款基于uni-app开发的跨平台移动应用，致力于帮助用户养成健康的饮水习惯。通过简单直观的界面，用户可以轻松记录每日饮水量、设置饮水目标、查看饮水报告，并接收智能饮水提醒，让健康饮水成为日常习惯。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-09-16
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 咕咚水记

<div align="center">
  <img src="static/login/logo.png" alt="咕咚水记" width="180">
  <h3>智能饮水管理助手，让健康饮水成为习惯</h3>
</div>

## 📱 项目介绍
咕咚水记是一款基于uni-app开发的跨平台移动应用，致力于帮助用户养成健康的饮水习惯。通过简单直观的界面，用户可以轻松记录每日饮水量、设置饮水目标、查看饮水报告，并接收智能饮水提醒，让健康饮水成为日常习惯。

## ✨ 核心功能

### 🚰 便捷饮水记录
- 支持多种饮品类型：纯净水、咖啡、牛奶、茶、果汁等
- 一键快速记录，操作简单便捷
- 自定义饮水量，灵活满足不同需求

### 📊 数据可视化
- 环形图表直观展示每日饮水进度
- 详细的历史数据分析和趋势图表
- 支持按日、周、月查看饮水统计报告

### 🎯 个性化目标设置
- 根据用户性别、体重、活动量智能推荐每日饮水量
- 支持自定义每日饮水目标
- 实时显示目标完成进度

### 🔔 智能提醒
- 定时提醒饮水，避免忘记喝水
- 自定义提醒时间和频率
- 支持静默提醒和声音提醒

### 🌐 多语言支持
- 支持中文简体、中文繁体、英语、日语等多语言切换
- 自动识别系统语言，提供本地化体验

### 📱 多设备适配
- 完美适配手机和平板设备
- 自适应不同屏幕尺寸，提供最佳显示效果

## 🛠️ 技术栈

- **前端框架**：uni-app (Vue.js)
- **UI组件库**：uView UI
- **图表库**：ECharts
- **数据存储**：SQLite
- **国际化**：Vue I18n
- **开发工具**：HBuilderX

## 🚀 快速开始

### 前提条件
- 安装 [HBuilderX](https://www.dcloud.io/hbuilderx.html) 开发工具
- 安装 [Node.js](https://nodejs.org/)
- 暂不支持配置微信小程序开发

### 项目设置

1. **克隆项目**
```bash
git clone [https://gitee.com/qx-team/drink-water-app.git]
cd 咕咚水记
```

2. **安装依赖**
```bash
npm install
```

3. **运行项目**
   - 在HBuilderX中打开项目
   - 选择目标平台（APP）
   - 点击运行按钮，即可在模拟器或真机上查看效果

### 构建部署

- **APP打包**：在HBuilderX中选择"发行"->"原生APP-云打包"，配置相应参数后进行打包

## 📁 项目结构

```
├── api/               # API接口定义
├── common/            # 公共工具和样式
│   ├── js/            # JavaScript工具函数
│   ├── request/       # 网络请求配置
│   ├── sqlite/        # 数据库操作
│   └── time/          # 时间处理工具
├── components/        # 自定义组件
├── locale/            # 国际化语言文件
├── pages/             # 页面文件
│   ├── basePage/      # 基础页面（登录、引导页等）
│   └── tabbar/        # 底部导航页面
├── static/            # 静态资源（图片、图标等）
├── uni_modules/       # 第三方模块
├── App.vue            # 应用入口文件
├── main.js            # 程序入口文件
├── manifest.json      # 应用配置文件
└── pages.json         # 页面路由配置
```

### 效果展示
![](README_files/1.png)
![](README_files/2.png)
![](README_files/3.png)
![](README_files/4.png)
![](README_files/5.png)
![](README_files/6.png)
![](README_files/7.png)

## 🤝 贡献指南
我们欢迎任何形式的贡献！如果你有任何想法或建议，欢迎提交Issue或Pull Request。

## 📝 许可证
本项目采用MIT许可证，详情请查看[LICENSE](LICENSE)文件。

## 💬 联系我们
如有任何问题或建议，请随时联系我们：
- 邮箱：1090890220@qq.com
- QQ群:530532516
- 微信WX：QxWx_001

## 捐赠咕咚水记的研发

![](README_files/1.jpg)


## 🎉 致谢
感谢所有为项目做出贡献的开发者和用户！

> 健康生活，从良好的饮水习惯开始 💧