仓库地址
https://github.com/ceilf6/DayMatetitle: DayMate 产品报告
author: 王景宏
date: \today
pdf-engine: xelatex
documentclass: ctexart
classoption:
- fontset=none
mainfont: Songti SC
monofont: Hiragino Sans GB
fontsize: 12pt
geometry:
- margin=2.5cm
linestretch: 1.5
toc: true
toc-depth: 3
numbersections: true
DayMate 产品报告
日期：2025-12-17
DayMate 是一款跨平台日程管理产品，目标是在 Android 与 React Native 两端提供一致的“查看日历、创建/管理事件、提醒通知”等核心能力，并以可演进的共享业务层（shared/core）承载跨端一致的领域模型与仓库接口。
① 产品功能介绍
1. 日历与日程浏览
- 月视图日历：按天选择日期，查看当天日程列表。
- 日程列表：展示当天所有事件的标题、时间范围、备注等信息。
2. 事件管理
- 新建事件：支持填写标题、开始/结束时间、全天、备注/描述、地点、分类、优先级、状态等（Android 端更完整）。
- 编辑事件：更新事件信息后，自动更新提醒计划。
- 删除事件：删除事件并取消对应提醒。
3. 提醒通知
- 支持“无提醒 / 5 分钟前 / 15 分钟前 / 30 分钟前 / 1 小时前 / 1 天前”等常见提醒策略。
- 事件到达提醒时间后，向用户发送系统通知，并支持点击通知跳转回应用。
4. 本地数据持久化
- Android：基于 Room 的本地数据库存储事件，支持按时间范围查询、分类筛选、搜索等。
- React Native：基于 AsyncStorage 的轻量存储（适合作为 MVP 与原型实现，可按需演进为 SQLite/MMKV）。
② 程序概要设计
本节给出模块划分、关键数据结构与主要业务流程。
1. 模块划分
Android 应用（apps/android-calendar）
- UI：日历视图、事件详情/新增编辑弹窗。
- ViewModel：承载 UI 状态与业务编排（新增/编辑/删除事件后触发提醒重算）。
- Repository + DAO：负责事件的增删改查。
- ReminderManager + Worker：负责提醒调度与通知展示。
React Native 应用（apps/rn-calendar）
- HomeScreen：月历选择 + 当天日程列表。
- EventStorage：事件持久化与查询。
- 事件模型：CalendarEvent（含 date、title、startTime、endTime、notes 等）。
共享业务层（shared/core）
- 领域模型：CalendarEvent。
- 仓库接口：CalendarRepository（create/update/delete/get/search/observe）。
- 目标：提供跨平台一致的业务约束与模型定义，允许未来通过 Native Module 或 KMP 方式让 RN 复用核心逻辑。
2. 关键数据结构（概述）
Android：Event（Room Entity）
- 核心字段：title、startTime、endTime、allDay、reminderMinutes、category、priority、status 等。
React Native：CalendarEvent（TypeScript）
- 核心字段：id、date(yyyy-MM-dd)、title、startTime(HH:mm 可选)、endTime(HH:mm 可选)、notes(可选)。
3. 主要业务流程（概述）
流程 A：新增事件（Android）
- 用户在新增/编辑界面填写信息并保存。
- ViewModel 写入数据库（insert/update）。
- 保存成功后调用 ReminderManager：
- 取消旧提醒（若有）
- 根据 startTime 与 reminderMinutes 计算提醒触发时间
- 使用 WorkManager 安排 OneTimeWorkRequest
流程 B：新增日程（React Native）
- 用户在 HomeScreen 选择日期。
- 点击“添加日程”打开表单，填写标题/时间/备注并保存。
- EventStorage 写入 AsyncStorage。
- HomeScreen 刷新内存态并更新日历标记点与列表展示。
③ 软件架构图
采用 Mermaid 展示 DayMate 的跨端与模块分层关系。
flowchart TB subgraph Client[DayMate 客户端] direction LR subgraph AND[Android: apps/android-calendar] direction TB AND_UI[UI Calendar/Dialogs] --> AND_VM[ViewModel] AND_VM --> AND_REPO[Repository] AND_REPO --> AND_DAO[Room DAO] AND_DAO --> AND_DB[(Room DB)] AND_VM --> AND_REM[ReminderManager] AND_REM --> AND_WM[WorkManager] AND_WM --> AND_WORKER[ReminderWorker] AND_WORKER --> AND_NOTIF[NotificationService] end subgraph RN[React Native: apps/rn-calendar] direction TB RN_UI[HomeScreen Calendar UI] --> RN_STORE[EventStorage] RN_STORE --> RN_AS[(AsyncStorage)] end subgraph CORE[shared/core] direction TB CORE_MODEL[Domain Models CalendarEvent] --> CORE_REPO[CalendarRepository Interface] end AND_REPO -. 参考一致性 .-> CORE_REPO RN_STORE -. 参考一致性 .-> CORE_MODEL end④ 技术亮点及其实现原理
1) 提醒调度：基于 WorkManager 的可靠通知
亮点
- 使用 WorkManager 统一处理延迟任务与系统约束（电量、后台限制等），相对直接使用 AlarmManager 更易维护。
- 调度时先取消旧任务，避免重复提醒。
实现原理（关键点）
- 计算提醒触发时间：
- T r e m i n d = T s t a r t − r e m i n d e r M i n u t e s T_{remind} = T_{start} - reminderMinutesTremind=Tstart−reminderMinutes
- 计算延迟：
- d e l a y = T r e m i n d − n o w delay = T_{remind} - nowdelay=Tremind−now
- 为避免“分钟级向下取整导致 delay=0 立刻触发”的问题，延迟使用毫秒级：
Duration.between(now, reminderTime).toMillis()+TimeUnit.MILLISECONDS
2) Android 本地存储：Room + 索引优化查询
亮点
- 对 startTime/endTime/category/reminderMinutes 建索引，提升按时间范围、分类、提醒事件等查询性能。
实现原理
- Room 基于 SQLite，索引可减少查询扫描范围。
- DAO 以 SQL/注解方式表达查询；Repository 提供更稳定的业务接口。
3) 跨端共享业务层的演进路径（shared/core）
亮点
- shared/core 提供统一领域模型与仓库接口（CalendarRepository），为未来“跨端一致业务规则”和“复用核心逻辑”预留结构。
实现原理
- 以接口定义跨平台能力边界：获取某天/范围事件、创建/更新/删除、按条件搜索、观察事件变化等。
- 当前 Android 侧可对接实际存储实现；React Native 侧可先独立实现，后续可通过 Native Module / KMP 等方式逐步复用。
4) React Native 端 MVP：AsyncStorage 快速闭环
亮点
- 使用 AsyncStorage 快速实现“新增日程-持久化-刷新展示”的最小闭环，迭代成本低。
实现原理
- 将事件按 date 进行分组存储（Key-Value + JSON）：
Record<date, CalendarEvent[]>
- 保存后同步更新内存态，驱动 UI 立即刷新，并用“日期标记点”提示有日程的日期。
