# loveMinder

**Repository Path**: zedcat/love-minder

## Basic Information

- **Project Name**: loveMinder
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LoveMinder - 女性健康管理助手

一款专为女性设计的健康管理应用，支持 Android 和鸿蒙 (OpenHarmony) 双平台。

## 功能特性

### 📊 体重记录与可视化
- 支持手动记录每日体重
- 周/月/年三种时间跨度的数据展示
- 使用 fl_chart 绘制精美的体重变化曲线
- 记录最高/最低/平均体重等统计数据

### 🩸 智能生理期追踪
- 记录生理期开始日期、持续天数和周期长度
- 基于历史数据智能推算下次生理期、排卵期和易孕期
- 人文关怀提醒：生理期前7天、前3天及当天的温馨提示
- 可视化日历，清晰展示生理周期

### 📈 数据统计分析
- 体重变化趋势分析
- 生理周期规律统计
- 综合数据展示面板

### ☁️ WebDAV 数据同步
- 支持配置自定义 WebDAV 服务器
- 加密备份数据到云端
- 支持多设备间数据迁移
- 纯 Dart 实现，兼容性好

## 技术架构

### 状态管理
- 使用 Provider 进行状态管理
- 模块化设计，数据逻辑分离

### 本地存储
- SQLite 结构化数据存储
- 支持事务处理和批量操作

### UI 设计
- Material Design 3 设计风格
- 柔和温馨的莫兰迪色系
- 圆润卡片式布局

## 项目结构

```
lib/
├── main.dart                  # 应用入口
├── models/                   # 数据模型
│   ├── weight_record.dart    # 体重记录模型
│   ├── period_record.dart    # 生理期记录模型
│   ├── period_prediction.dart # 预测模型
│   ├── webdav_config.dart    # WebDAV配置模型
│   └── app_data.dart         # 应用数据模型
├── providers/                # 状态管理
│   ├── weight_provider.dart  # 体重数据提供者
│   ├── period_provider.dart  # 生理期数据提供者
│   └── sync_provider.dart    # 同步状态提供者
├── screens/                  # UI页面
│   ├── weight_screen.dart    # 体重记录页面
│   ├── period_screen.dart    # 生理期追踪页面
│   ├── stats_screen.dart     # 数据统计页面
│   └── settings_screen.dart  # 设置页面
├── services/                 # 业务服务
│   ├── database_service.dart # 数据库服务
│   ├── period_calculator.dart # 生理期计算服务
│   ├── webdav_service.dart   # WebDAV服务
│   └── notification_service.dart # 通知服务
└── theme/                    # 主题配置
    └── app_theme.dart        # 应用主题
```

## 开发环境配置

### Android 平台
```bash
# 获取依赖
flutter pub get

# 运行 Android 版本
flutter run
```

### 鸿蒙平台
请参考鸿蒙官方 Flutter 适配文档进行配置。

## WebDAV 配置说明

支持各类兼容 WebDAV 协议的云存储服务：
- Nextcloud
- 坚果云
- 群晖 WebDAV
- 其他标准 WebDAV 服务

配置步骤：
1. 进入「设置」-「WebDAV 同步」
2. 填写服务器地址、用户名、密码
3. 可自定义远程存储路径（默认：/loveminder_backup）
4. 点击「测试连接」验证配置
5. 保存后即可使用备份/恢复功能

## 生理期预测算法

- 使用历史数据计算平均周期长度
- 排卵日推算：下次生理期前14天
- 易孕期：排卵日前5天至后1天
- 预测可信度：基于历史记录数量

## 隐私说明

- 所有数据默认存储在本地
- 不会上传到任何第三方服务器
- WebDAV 同步为用户自主配置，数据流向完全可控
- 本地存储使用 SQLite，无额外加密（后续版本计划添加）

## 许可证

MIT License