一款专为女性设计的健康追踪应用，帮助用户记录和管理月经周期、身体症状和健康数据。
LuminCore是一款注重隐私保护的女性健康管理工具，采用纯本地存储方式，无需联网即可使用。应用提供直观的日历视图、智能周期预测和全面的健康数据记录功能，帮助女性更好地了解自己的身体状况，掌握健康规律。通过科学的数据分析，为用户提供个性化的健康洞察和建议。
- 月经周期追踪：记录月经开始和结束日期，自动计算周期长度和规律性
- 日历视图：直观展示月经期、排卵期和预测的下次月经日期
- 症状记录：追踪身体症状（如头痛、情绪波动、腹痛等）
- 数据统计：分析月经周期规律和症状模式，提供个性化健康洞察
- 快速添加：便捷的界面，快速记录当天的月经状态和症状
- 隐私保护：所有数据本地存储，保障用户隐私安全
- 智能预测：基于历史数据预测下次月经日期和排卵期
- 健康提醒：月经即将来临、排卵期等重要时间点提醒
- 数据备份：支持导出和导入数据，确保数据安全
- 多主题支持：提供浅色、深色和自动主题模式
- 简洁直观的用户界面：采用Material Design设计语言，操作简单易上手
- 多维度健康记录：不仅记录月经周期，还包括身体症状、情绪变化和生活习惯
- 个性化分析报告：根据用户数据生成专属健康报告，帮助了解身体状况
- 灵活的数据管理：支持数据导入导出，方便用户备份和迁移
- 完全离线使用：无需网络连接，保护用户隐私
- 科学的预测算法：结合用户历史数据和统计模型，提供准确的周期预测
- 全面的症状跟踪：支持记录30+种常见身体症状和情绪变化
应用采用现代化的Material Design 3设计语言，提供清晰直观的用户界面和流畅的交互体验。主要界面包括日历视图、记录详情、统计分析、快速添加和设置页面等。
- 一致的设计语言：遵循Material You设计规范，支持动态主题
- 直观的色彩编码：不同颜色标记不同的月经周期阶段
- 简洁的信息层次：重要信息突出显示，次要信息适当弱化
- 流畅的动画过渡：增强用户操作反馈和界面连贯性
- 适应性布局：自适应不同屏幕尺寸和方向
- 无障碍设计：支持屏幕阅读器和其他辅助功能
- 开发语言：Kotlin
- 架构模式：MVVM (Model-View-ViewModel)
- 数据存储：Room 数据库
- UI组件：Material Design 组件
- 导航：Navigation Component
- 异步处理：Kotlin Coroutines
- 依赖注入：Hilt/Dagger
- 响应式编程：LiveData/Flow
- 单元测试：JUnit, Mockito
- UI测试：Espresso
- 图表库：MPAndroidChart
- 日期处理：ThreeTenABP (JSR-310)
┌─────────────────────────────────────────────────────────────┐
│ 表现层 (UI) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Fragment │ │ Activity │ │ Adapter │ │
│ └──────┬──────┘ └──────┬──────┘ └──────────┬──────────┘ │
│ │ │ │ │
│ └────────────────┼────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ViewModel │ │
│ └───────────────────────────┬─────────────────────────┘ │
└───────────────────────────────┼───────────────────────────────┘
│
┌───────────────────────────────┼───────────────────────────────┐
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Repository │ │
│ └───────────────┬───────────────────────┬─────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌───────────────────────┐ ┌───────────────────────────┐ │
│ │ 本地数据源 │ │ 远程数据源(可选) │ │
│ │ (Room Database) │ │ (API Service) │ │
│ └───────────────────────┘ └───────────────────────────┘ │
│ 数据层 (Data) │
└─────────────────────────────────────────────────────────────┘
app/src/main/
├── java/top/mizhoubaobei/womenhealth/
│ ├── data/ # 数据层
│ │ ├── AppDatabase.kt # Room 数据库配置
│ │ ├── DateConverter.kt # 日期类型转换器
│ │ ├── MenstrualDao.kt # 数据访问对象
│ │ ├── MenstrualRecord.kt # 月经记录实体
│ │ ├── SQLiteMenstrualStorage.kt # SQLite存储实现
│ │ └── preference/ # 用户偏好设置
│ │ └── UserPreferences.kt # 用户偏好管理
│ ├── ui/ # 用户界面
│ │ ├── calendar/ # 日历功能
│ │ │ ├── CalendarAdapter.kt # 日历适配器
│ │ │ ├── CalendarDay.kt # 日历日期模型
│ │ │ ├── CalendarFragment.kt # 日历页面
│ │ │ ├── CalendarViewModel.kt # 日历视图模型
│ │ │ └── DateDetailDialog.kt # 日期详情对话框
│ │ ├── list/ # 记录列表功能
│ │ │ ├── AddRecordDialog.kt # 添加记录对话框
│ │ │ ├── ListFragment.kt # 记录列表页面
│ │ │ ├── ListViewModel.kt # 列表视图模型
│ │ │ └── RecordsAdapter.kt # 记录适配器
│ │ ├── quickadd/ # 快速添加功能
│ │ │ ├── QuickAddFragment.kt # 快速添加页面
│ │ │ ├── QuickAddViewModel.kt # 快速添加视图模型
│ │ │ └── SymptomsDialog.kt # 症状选择对话框
│ │ ├── statistics/ # 统计分析功能
│ │ │ ├── StatisticsFragment.kt # 统计页面
│ │ │ ├── StatisticsViewModel.kt # 统计视图模型
│ │ │ └── SymptomStatAdapter.kt # 症状统计适配器
│ │ └── MainActivity.kt # 主活动
│ └── WomenHealthApplication.kt # 应用程序类
└── res/ # 资源文件
├── drawable/ # 图像资源
│ ├── bg_calendar_ovulation.xml # 排卵期背景
│ ├── bg_calendar_period.xml # 月经期背景
│ ├── bg_calendar_predicted.xml # 预测期背景
│ ├── bg_calendar_today.xml # 今日背景
│ ├── bg_input_field.xml # 输入框背景
│ ├── circle_indicator.xml # 圆形指示器
│ ├── ic_add_24.xml # 添加图标
│ ├── ic_analytics_24.xml # 分析图标
│ ├── ic_calendar_24.xml # 日历图标
│ ├── ic_check_24.xml # 勾选图标
│ ├── ic_chevron_left_24.xml # 左箭头图标
│ ├── ic_chevron_right_24.xml # 右箭头图标
│ ├── ic_delete_24.xml # 删除图标
│ ├── ic_error.xml # 错误图标
│ ├── ic_launcher.xml # 应用图标
│ ├── ic_launcher_round.xml # 圆形应用图标
│ ├── ic_list_24.xml # 列表图标
│ └── ic_note_24.xml # 笔记图标
├── layout/ # 布局文件
│ ├── activity_main.xml # 主活动布局
│ ├── dialog_add_record.xml # 添加记录对话框布局
│ ├── dialog_date_detail.xml # 日期详情对话框布局
│ ├── dialog_symptoms.xml # 症状对话框布局
│ ├── fragment_calendar.xml # 日历页面布局
│ ├── fragment_list.xml # 记录列表布局
│ ├── fragment_quick_add.xml # 快速添加布局
│ ├── fragment_statistics.xml # 统计页面布局
│ ├── item_calendar_day.xml # 日历日项布局
│ ├── item_flow_stat.xml # 流量统计项布局
│ ├── item_menstrual_record.xml # 月经记录项布局
│ ├── item_record.xml # 记录项布局
│ └── item_symptom_stat.xml # 症状统计项布局
├── menu/ # 菜单配置
│ └── bottom_nav_menu.xml # 底部导航菜单
├── navigation/ # 导航图
│ └── mobile_navigation.xml # 移动端导航图
├── values/ # 字符串、颜色等资源
│ ├── colors.xml # 颜色定义
│ ├── strings.xml # 字符串资源
│ ├── styles.xml # 样式定义
│ └── themes.xml # 主题定义
└── xml/ # XML配置
├── backup_rules.xml # 备份规则
└── data_extraction_rules.xml # 数据提取规则
- 月视图日历展示，支持月份切换和今日快速定位
- 不同颜色标记月经期、排卵期和预测期
- 点击日期查看/编辑详细信息
- 日期详情对话框支持记录月经状态、症状和备注
- 长按日期可快速标记月经开始/结束
- 支持周视图和月视图切换
- 提供月经周期阶段指示器
- 展示所有月经记录
- 添加、编辑和删除记录
- 按时间排序，支持筛选和搜索
- 详细展示每次月经的开始日期、结束日期、持续天数和周期长度
- 支持按月份分组查看
- 提供记录导出功能
- 一键记录当天状态
- 选择症状和流量等级（轻、中、重）
- 添加备注和情绪记录
- 支持修改日期，补充历史记录
- 常用症状快速选择
- 自定义症状添加
- 月经周期长度统计
- 症状频率分析
- 健康趋势可视化
- 周期规律性评估
- 个性化健康建议
- 月经周期变化趋势图
- 症状关联性分析
- 个人信息设置
- 提醒设置（月经提醒、排卵期提醒等）
- 数据备份与恢复
- 主题和界面定制
- 隐私设置
- 应用锁设置
- 语言选择
日期详情对话框是应用的核心功能之一，允许用户查看和编辑特定日期的月经和症状记录：
- 月经状态切换：一键标记当天是否为月经期
- 流量选择：轻、中、重三级流量选择
- 症状多选：支持选择多种身体症状
- 备注功能：添加文字备注记录特殊情况
- 日期选择：可修改日期，方便补充历史记录
- 情绪记录：记录当天情绪状态
- 活动记录：记录特殊活动（如运动、旅行等）
- Android 8.0 (API 级别 26) 或更高版本
- 约 20MB 存储空间
- 权限需求：
- 存储权限（用于数据备份）
- 通知权限（用于健康提醒）
- 振动权限（用于提醒反馈）
-
直接下载APK安装
- 从GitHub Releases下载最新版本
- 在Android设备上打开APK文件进行安装
- 首次安装需要允许"未知来源"应用安装权限
-
开发者安装
- 克隆仓库：
git clone https://github.com/xiaomizhoubaobei/womenhealth-app.git - 使用Android Studio打开项目
- 点击"Run"按钮在设备或模拟器上安装
- 克隆仓库：
- 输入最近一次月经日期和平均周期长度
- 设置提醒偏好
- 选择界面主题
- 完成个人健康信息问卷（可选）
- 在日历页面查看月经预测和排卵期
- 点击日期记录当天状态
- 使用快速添加功能一键记录
- 查看统计页面了解健康趋势
- 在设置中备份/恢复数据
- 导出健康报告（PDF/CSV格式）
- 查看统计分析了解身体规律
- 定期清理过期数据（可选）
- 设置自定义提醒
- 添加自定义症状
- 配置数据可视化图表
- 启用应用锁保护隐私
本应用高度重视用户隐私保护：
- 所有数据均存储在用户设备本地，不会上传至任何服务器或与第三方共享
- 不收集用户个人身份信息
- 支持数据加密存储
- 可设置应用锁保护隐私
- 备份文件采用加密格式
- 不包含任何第三方分析或广告SDK
- 开发者：祁潇潇 (米粥宝贝)
- 联系方式：
- 问题反馈：https://github.com/xiaomizhoubaobei/womenhealth-app/issues
LuminCore计划在2026年国庆节前完成全平台上架，目前正在进行相关准备工作：
- 华为应用市场：预计2026年8月上架
- 小米应用商店：预计2026年8月上架
- OPPO软件商店：预计2026年9月上架
- vivo应用商店：预计2026年9月上架
- 应用宝：预计2026年9月上架
- 百度手机助手：预计2026年9月上架
- Google Play：预计2026年8月上架
- 三星Galaxy Store：预计2026年9月上架
- 应用商店素材准备：应用图标、截图、宣传图、描述文案等
- 应用商店政策合规：确保应用符合各应用商店的政策要求
- 隐私政策完善：根据各应用商店要求完善隐私政策
- 用户协议制定：制定符合法律法规的用户协议
- 应用内容分级：完成应用内容分级评估
- 核心功能开发
- 完成基础月经周期追踪功能
- 实现日历视图和基本数据记录
- 开发本地数据库存储系统
- 构建MVVM架构基础框架
- 功能扩展与优化
- 添加体重和基础体温记录功能
- 开发症状记录与分析系统
- 优化数据可视化图表
- 实现智能周期预测算法
- 增加多语言支持（中文、英文、日文）
- 高级功能开发
- 集成健康建议和科普文章系统
- 开发多用户切换功能
- 添加健康日记功能
- 实现数据备份与恢复系统
- 开发应用锁与隐私保护功能
- 云端同步系统开发
- 构建安全的云端数据存储架构
- 实现端到端加密数据传输
- 开发可选择性同步机制
- 设计多设备数据合并和冲突解决方案
- 平台扩展与上架准备
- 开发iOS版本
- 构建Web端访问界面
- 完善云端同步生态系统
- 开发数据分析和导出工具
- 增强数据安全和隐私保护措施
- 应用商店上架准备
- 准备应用商店素材
- 完善隐私政策和用户协议
- 进行应用内容分级评估
- 对接各应用商店支付系统（如需）
- 生态系统扩展
- 开发可穿戴设备集成功能
- 添加AI驱动的健康分析系统
- 构建开发者API和插件系统
- 探索与其他健康应用的数据互通
- 研发高级数据可视化和预测模型
- 性能优化
- 优化应用启动时间和响应速度
- 减少内存占用和电池消耗
- 实现高效的数据处理算法
- 用户体验提升
- 进行用户研究和可用性测试
- 优化UI/UX设计
- 实现流畅的动画和交互效果
- 安全与隐私
- 实施高级数据加密方案
- 开发匿名化数据分析系统
- 遵循全球隐私法规标准
欢迎对项目提出建议和改进！如果您想参与贡献，请：
- Fork 本仓库
- 创建您的特性分支 (
git checkout -b feature/AmazingFeature) - 提交您的更改 (
git commit -m '添加某个特性') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开一个 Pull Request
- 感谢所有为项目提供反馈和建议的用户
- 感谢开源社区提供的优秀库和工具
- 特别感谢参与测试的女性健康专家和志愿者
版权所有 © 2025 祁潇潇
本软件已申请软件著作权保护。允许个人用户出于非商业目的使用、查看和学习本软件的源代码。未经版权所有者明确书面许可，禁止将本软件用于任何商业目的，禁止重新分发本软件的原始或修改版本，禁止基于本软件创建衍生作品。
详细许可条款请参阅项目根目录中的LICENSE文件。