master
一款专为女性设计的健康追踪应用，帮助用户记录和管理月经周期、身体症状和健康数据。
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)
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
本项目配置了以下GitHub Actions工作流：
- 触发条件: Push到master分支或手动触发
- 功能:
- 构建Release版本APK
- 使用签名配置
- 自动创建GitHub Release
- 上传APK到Release页面
- 自动同步代码到多个代码托管平台
在仓库设置中配置以下Secrets（如果未配置，将使用默认值）：
| Secret名称 | 描述 | 默认值 |
|---|---|---|
| RELEASE_STORE_PASSWORD | Keystore密码 | 无 |
| RELEASE_KEY_ALIAS | 密钥别名 | 无 |
| RELEASE_KEY_PASSWORD | 密钥密码 | 无 |
安全建议: 建议在GitHub Secrets中配置新的密码，不要使用默认值。
项目使用以下配置：
- 编译SDK: 35
- 最低SDK: 30
- 目标SDK: 35
- Java版本: 11
- Kotlin版本: 与Android Gradle插件兼容
Release版本使用以下签名配置（通过GitHub Secrets管理）：
- Keystore文件:
release.keystore - 密钥别名:
womenhealth - 启用V1-V4签名
- JDK 11
- Android SDK 35
- Gradle 8.0+
- 克隆项目
- 配置签名信息到GitHub Secrets
- Push到master分支触发自动构建
- 在GitHub Releases页面下载APK
- Debug APK:
app/build/outputs/apk/debug/ - Release APK:
app/build/outputs/apk/release/ - GitHub Release: 自动创建并上传APK
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文件。
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
