refactor: 重构提醒通知系统

This commit is contained in:
zl-q
2026-04-01 00:42:34 +08:00
parent 9a231dae9e
commit 6722f3d74b
21 changed files with 375 additions and 171 deletions
Vendored
BIN
View File
Binary file not shown.
-12
View File
@@ -18,16 +18,4 @@ import UserNotifications
}
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
override func userNotificationCenter(
_ center: UNUserNotificationCenter,
didReceive response: UNNotificationResponse,
withCompletionHandler completionHandler: @escaping () -> Void
) {
let userInfo = response.notification.request.content.userInfo
if let payloadString = userInfo["payload"] as? String {
UserDefaults.standard.set(payloadString, forKey: "pending_notification_payload")
}
completionHandler()
}
}
+1 -1
View File
@@ -64,8 +64,8 @@ class _LinksyAppState extends State<LinksyApp> {
Future<void> _bootstrapReminderNotification() async {
await sl<ReminderPermissionService>().initializeAtBoot();
final router = sl<ReminderNotificationRouter>();
await router.start();
_reminderTapSubscription ??= router.taps.listen(_onReminderTap);
await router.start();
}
void _onReminderTap(ReminderNotificationTap tap) {
@@ -14,9 +14,15 @@ class ReminderNotificationRouter {
Stream<ReminderNotificationTap> get taps => _controller.stream;
Future<void> start() async {
await _scheduler.initialize(onTap: _controller.add);
await _scheduler.initialize(
onTap: (tap) {
_scheduler.cancelReminder(tap);
_controller.add(tap);
},
);
final launchTap = await _scheduler.consumeLaunchTap();
if (launchTap != null) {
await _scheduler.cancelReminder(launchTap);
_controller.add(launchTap);
}
}
@@ -2,20 +2,37 @@ import '../models/reminder_alarm.dart';
import 'reminder_scheduler_service.dart';
class ReminderReconcileService {
const ReminderReconcileService({required ReminderSchedulerService scheduler})
: _scheduler = scheduler;
ReminderReconcileService({
required ReminderSchedulerService scheduler,
DateTime Function()? nowProvider,
}) : _scheduler = scheduler,
_now = nowProvider ?? DateTime.now;
final ReminderSchedulerService _scheduler;
final DateTime Function() _now;
final Map<String, DateTime> _snoozeSuppressUntilByEventId =
<String, DateTime>{};
Future<void> reconcileEvent(
ReminderEventSnapshot event, {
DateTime? now,
}) async {
final current = now ?? _now();
if (event.isArchived || event.reminderMinutes == null) {
_snoozeSuppressUntilByEventId.remove(event.eventId);
await _scheduler.cancelEventReminders(event.eventId);
return;
}
await _scheduler.upsertEventReminders(event, now: now);
final suppressUntil = _snoozeSuppressUntilByEventId[event.eventId];
if (suppressUntil != null) {
if (current.isBefore(suppressUntil)) {
return;
}
_snoozeSuppressUntilByEventId.remove(event.eventId);
}
await _scheduler.upsertEventReminders(event, now: current);
}
Future<void> reconcileEvents(
@@ -28,11 +45,19 @@ class ReminderReconcileService {
}
Future<void> archiveAndCancel(String eventId) {
_snoozeSuppressUntilByEventId.remove(eventId);
return _scheduler.cancelEventReminders(eventId);
}
Future<void> snooze10m(ReminderEventSnapshot event) async {
await _scheduler.cancelEventReminders(event.eventId);
await _scheduler.scheduleSingleSnooze(event);
final firstFireAt = _now().add(const Duration(minutes: 10));
final alarms = ReminderSchedulerService.buildAlarmSeries(
event: event,
firstFireAt: firstFireAt,
interval: const Duration(minutes: 10),
);
await _scheduler.scheduleAlarms(alarms);
_snoozeSuppressUntilByEventId[event.eventId] = firstFireAt;
}
}
@@ -18,6 +18,8 @@ class ReminderSchedulerService {
'Alarm-style notifications for scheduled events';
static const String _androidSoundResource = 'reminder_1';
static const String _iosSoundFile = 'reminder_1.wav';
static const int _maxAlarmIntervals = 144; // 24 hours at 10-minute intervals
static const Duration _scheduleLeadTime = Duration(seconds: 2);
final FlutterLocalNotificationsPlugin _plugin;
final List<void Function(ReminderNotificationTap tap)> _tapCallbacks = [];
@@ -140,32 +142,6 @@ class ReminderSchedulerService {
}
}
Future<void> scheduleSingleSnooze(
ReminderEventSnapshot event, {
Duration delay = const Duration(minutes: 10),
DateTime? now,
}) async {
await _ensureInitialized();
final current = now ?? DateTime.now();
final fireAt = current.add(delay);
if (event.endAt != null && fireAt.isAfter(event.endAt!)) {
return;
}
final alarm = ReminderAlarm(
eventId: event.eventId,
title: event.title,
startAt: event.startAt,
endAt: event.endAt,
timezone: event.timezone,
reminderMinutes: event.reminderMinutes ?? 0,
fireAt: fireAt,
fireTimeBucket: _toBucket(fireAt),
location: event.location,
notes: event.notes,
);
await _scheduleAlarm(alarm);
}
Future<void> cancelEventReminders(String eventId) async {
await _ensureInitialized();
final pending = await _plugin.pendingNotificationRequests();
@@ -185,6 +161,12 @@ class ReminderSchedulerService {
return _ensureInitialized().then((_) => _plugin.cancelAll());
}
Future<void> cancelReminder(ReminderNotificationTap tap) async {
await _ensureInitialized();
final id = _notificationId(tap.eventId, tap.fireTimeBucket);
await _plugin.cancel(id);
}
Future<void> _ensureInitialized() {
if (_initialized) {
return Future<void>.value();
@@ -212,17 +194,53 @@ class ReminderSchedulerService {
return const [];
}
final List<ReminderAlarm> alarms = [];
DateTime fireAt;
final firstFireAt = _nextFireTimeAfter(
current: current,
remindAt: remindAt,
endAt: endAt,
);
if (current.isBefore(remindAt)) {
fireAt = remindAt;
} else {
fireAt = current.add(const Duration(seconds: 5));
if (firstFireAt == null) {
return const [];
}
return buildAlarmSeries(
event: event,
firstFireAt: firstFireAt,
interval: const Duration(minutes: 10),
);
}
static DateTime? _nextFireTimeAfter({
required DateTime current,
required DateTime remindAt,
required DateTime? endAt,
}) {
final earliest = current.add(_scheduleLeadTime);
final next = remindAt.isAfter(earliest) ? remindAt : earliest;
if (endAt != null && next.isAfter(endAt)) {
return null;
}
return next;
}
static List<ReminderAlarm> buildAlarmSeries({
required ReminderEventSnapshot event,
required DateTime firstFireAt,
Duration interval = const Duration(minutes: 10),
}) {
final endAt = event.endAt;
if (endAt != null && firstFireAt.isAfter(endAt)) {
return const [];
}
final alarms = <ReminderAlarm>[];
var fireAt = firstFireAt;
var iterations = 0;
while (iterations < 144) {
while (iterations < _maxAlarmIntervals) {
if (endAt != null && fireAt.isAfter(endAt)) {
break;
}
@@ -233,7 +251,7 @@ class ReminderSchedulerService {
startAt: event.startAt,
endAt: endAt,
timezone: event.timezone,
reminderMinutes: reminderMinutes,
reminderMinutes: event.reminderMinutes ?? 0,
fireAt: fireAt,
fireTimeBucket: _toBucket(fireAt),
location: event.location,
@@ -244,15 +262,30 @@ class ReminderSchedulerService {
if (endAt == null) {
break;
}
fireAt = fireAt.add(const Duration(minutes: 10));
fireAt = fireAt.add(interval);
iterations += 1;
}
return alarms;
}
Future<void> scheduleAlarms(List<ReminderAlarm> alarms) async {
for (final alarm in alarms) {
await _scheduleAlarm(alarm);
}
}
Future<void> _scheduleAlarm(ReminderAlarm alarm) async {
final location = _safeLocation(alarm.timezone);
final fireAt = tz.TZDateTime.from(alarm.fireAt, location);
final nowInTz = tz.TZDateTime.now(location);
var fireAt = tz.TZDateTime.from(alarm.fireAt, location);
final minAllowed = nowInTz.add(_scheduleLeadTime);
if (!fireAt.isAfter(minAllowed)) {
fireAt = minAllowed;
}
if (alarm.endAt != null &&
fireAt.isAfter(tz.TZDateTime.from(alarm.endAt!, location))) {
return;
}
final payload = jsonEncode(alarm.toJson());
final id = _notificationId(alarm.eventId, alarm.fireTimeBucket);
@@ -340,7 +373,7 @@ class ReminderSchedulerService {
return Map<String, dynamic>.from(decoded);
}
} catch (_) {
return const {};
// ignore malformed payload
}
return const {};
}
@@ -50,14 +50,21 @@ class CalendarService {
return events;
}
Future<ScheduleItemModel> getEventById(String id) async {
Future<ScheduleItemModel> getEventById(
String id, {
bool reconcileReminder = true,
}) async {
final response = await _apiClient.get<Map<String, dynamic>>('$_prefix/$id');
final data = response.data;
if (data == null) {
throw StateError('Invalid getEventById response: empty payload');
}
final event = ScheduleItemModel.fromJson(data);
await _reminderReconcileService?.reconcileEvent(_toReminderSnapshot(event));
if (reconcileReminder) {
await _reminderReconcileService?.reconcileEvent(
_toReminderSnapshot(event),
);
}
return event;
}
@@ -106,12 +106,20 @@ class DayEventLayoutEngine {
final clusterColumnCount =
cluster.map((item) => item.column).reduce((a, b) => a > b ? a : b) +
1;
final totalGap = (clusterColumnCount - 1) * columnGap;
final columnWidth = clusterColumnCount > 0
? ((eventAreaWidth - totalGap) / clusterColumnCount).toDouble()
final maxVisibleColumns =
((eventAreaWidth + columnGap) /
(DayTimelineMetrics.minEventCardWidth + columnGap))
.floor()
.clamp(1, clusterColumnCount);
final totalGap = (maxVisibleColumns - 1) * columnGap;
final columnWidth = maxVisibleColumns > 0
? (eventAreaWidth - totalGap) / maxVisibleColumns
: eventAreaWidth;
for (final item in cluster) {
if (item.column >= maxVisibleColumns) {
continue;
}
final top = scale.pixelsForMinutes(item.startMinutes);
final geometryHeight = scale.pixelsForMinutes(
item.endMinutes - item.startMinutes,
@@ -125,7 +133,7 @@ class DayEventLayoutEngine {
startMinutes: item.startMinutes,
endMinutes: item.endMinutes,
column: item.column,
columnCount: clusterColumnCount,
columnCount: maxVisibleColumns,
top: top,
geometryHeight: geometryHeight,
visualHeight: visualHeight,
@@ -9,6 +9,7 @@ class DayTimelineMetrics {
static const double timeLabelGap = 8;
static const double eventRightInset = 4;
static const double eventColumnGap = 4;
static const double minEventCardWidth = 30;
static double timelineHeight(DayViewScale scale) {
return scale.pixelsForMinutes(minutesInDay);
@@ -20,10 +21,10 @@ class DayTimelineMetrics {
static double eventAreaWidth(double boardWidth) {
final width = boardWidth - eventAreaLeft() - eventRightInset;
return width > 0 ? width : 0;
return width < 0 ? 0 : width;
}
static int clampMinuteOfDay(int minute) {
return minute.clamp(0, minutesInDay).toInt();
return minute.clamp(0, minutesInDay);
}
}
@@ -718,32 +718,57 @@ class _CalendarDayWeekScreenState extends State<CalendarDayWeekScreen>
borderRadius: BorderRadius.circular(4),
border: Border.all(color: eventColor, width: 1),
),
child: Row(
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Container(
width: 6,
height: 6,
decoration: BoxDecoration(
color: eventColor,
shape: BoxShape.circle,
),
),
if (!isCompact) const SizedBox(width: 4),
if (!isCompact)
Expanded(
child: Text(
layout.event.title,
style: TextStyle(
fontSize: 11,
fontWeight: FontWeight.w500,
color: eventColor,
child: LayoutBuilder(
builder: (context, constraints) {
const markerSize = 6.0;
const markerTitleGap = 4.0;
final canShowMarker = constraints.maxWidth >= markerSize;
final canShowTitle =
!isCompact &&
constraints.maxWidth >= markerSize + markerTitleGap + 8;
if (!canShowMarker) {
return const SizedBox.shrink();
}
return Stack(
children: [
Align(
alignment: Alignment.centerLeft,
child: SizedBox(
width: markerSize,
height: markerSize,
child: DecoratedBox(
decoration: BoxDecoration(
color: eventColor,
shape: BoxShape.circle,
),
),
),
maxLines: 1,
overflow: TextOverflow.ellipsis,
),
),
],
if (canShowTitle)
Positioned(
left: markerSize + markerTitleGap,
right: 0,
top: 0,
bottom: 0,
child: Align(
alignment: Alignment.centerLeft,
child: Text(
layout.event.title,
style: TextStyle(
fontSize: 11,
fontWeight: FontWeight.w500,
color: eventColor,
),
maxLines: 1,
overflow: TextOverflow.ellipsis,
),
),
),
],
);
},
),
),
),
@@ -58,7 +58,9 @@ class _CalendarMonthScreenState extends State<CalendarMonthScreen>
return;
}
_eventsByDay.clear();
for (final event in events) {
for (final event in events.where(
(e) => e.status != ScheduleStatus.archived,
)) {
final key = formatYmd(event.startAt);
_eventsByDay[key] = [...(_eventsByDay[key] ?? const []), event];
}
@@ -28,12 +28,18 @@ class CalendarReminderAlarmScreen extends StatefulWidget {
class _CalendarReminderAlarmScreenState
extends State<CalendarReminderAlarmScreen> {
late final Future<ScheduleItemModel> _eventFuture;
bool _isSubmitting = false;
bool _isArchiving = false;
bool _isSnoozing = false;
bool get _isProcessing => _isArchiving || _isSnoozing;
@override
void initState() {
super.initState();
_eventFuture = sl<CalendarService>().getEventById(widget.eventId);
_eventFuture = sl<CalendarService>().getEventById(
widget.eventId,
reconcileReminder: false,
);
}
@override
@@ -78,8 +84,8 @@ class _CalendarReminderAlarmScreenState
child: AppButton(
text: context.l10n.notificationSnoozeLater,
isOutlined: true,
isLoading: _isSubmitting,
onPressed: _isSubmitting
isLoading: _isSnoozing,
onPressed: _isProcessing
? null
: () => _snoozeEvent(event),
),
@@ -88,8 +94,8 @@ class _CalendarReminderAlarmScreenState
Expanded(
child: AppButton(
text: context.l10n.calendarDetailArchiveConfirm,
isLoading: _isSubmitting,
onPressed: _isSubmitting
isLoading: _isArchiving,
onPressed: _isProcessing
? null
: () => _archiveEvent(event),
),
@@ -107,15 +113,16 @@ class _CalendarReminderAlarmScreenState
Future<void> _archiveEvent(ScheduleItemModel event) async {
setState(() {
_isSubmitting = true;
_isArchiving = true;
});
try {
await sl<CalendarService>().archiveEvent(event.id);
if (!mounted) {
return;
}
context.go(AppRoutes.calendarEventDetail(event.id));
} catch (_) {
context.go(AppRoutes.homeMain);
} catch (e, st) {
debugPrint('[_archiveEvent] error: $e\n$st');
if (mounted) {
Toast.show(
context,
@@ -126,7 +133,7 @@ class _CalendarReminderAlarmScreenState
} finally {
if (mounted) {
setState(() {
_isSubmitting = false;
_isArchiving = false;
});
}
}
@@ -134,7 +141,7 @@ class _CalendarReminderAlarmScreenState
Future<void> _snoozeEvent(ScheduleItemModel event) async {
setState(() {
_isSubmitting = true;
_isSnoozing = true;
});
try {
await sl<ReminderReconcileService>().snooze10m(_snapshotFromEvent(event));
@@ -142,19 +149,20 @@ class _CalendarReminderAlarmScreenState
return;
}
Toast.show(context, context.l10n.notificationSnoozeMinutes(10));
context.go(AppRoutes.calendarEventDetail(event.id));
} catch (_) {
context.go(AppRoutes.homeMain);
} catch (e, st) {
debugPrint('[_snoozeEvent] error: $e\n$st');
if (mounted) {
Toast.show(
context,
context.l10n.todoSaveFailed('snooze failed'),
context.l10n.todoSaveFailed(e.toString()),
type: ToastType.error,
);
}
} finally {
if (mounted) {
setState(() {
_isSubmitting = false;
_isSnoozing = false;
});
}
}
@@ -378,24 +378,11 @@ class _CreateEventSheetState extends State<CreateEventSheet>
_startDate = date;
_startTime = time;
if (_endDate != null && _endTime != null) {
final endDateTime = DateTime(
_endDate!.year,
_endDate!.month,
_endDate!.day,
_endTime!.hour,
_endTime!.minute,
);
final startDateTime = DateTime(
date.year,
date.month,
date.day,
time.hour,
time.minute,
);
final endDateTime = _composeDateTime(_endDate!, _endTime!);
final startDateTime = _composeDateTime(date, time);
if (endDateTime.isBefore(startDateTime) ||
endDateTime.isAtSameMomentAs(startDateTime)) {
_endDate = date;
_endTime = time.add(const Duration(hours: 1));
_setEndDateTime(_defaultEndDateTime(startDateTime));
}
}
});
@@ -408,44 +395,47 @@ class _CreateEventSheetState extends State<CreateEventSheet>
_endTime ?? _startTime,
(date, time) {
setState(() {
final startDateTime = DateTime(
_startDate.year,
_startDate.month,
_startDate.day,
_startTime.hour,
_startTime.minute,
);
final endDateTime = DateTime(
date.year,
date.month,
date.day,
time.hour,
time.minute,
);
final startDateTime = _composeDateTime(_startDate, _startTime);
final endDateTime = _composeDateTime(date, time);
if (endDateTime.isBefore(startDateTime) ||
endDateTime.isAtSameMomentAs(startDateTime)) {
_endDate = _startDate;
_endTime = _startTime.add(const Duration(hours: 1));
Toast.show(
context,
context.l10n.calendarCreateInvalidTimeRange,
type: ToastType.error,
);
_setEndDateTime(_defaultEndDateTime(startDateTime));
} else {
_endDate = date;
_endTime = time;
_setEndDateTime(endDateTime);
}
});
},
isOptional: true,
minTime: DateTime(
_startDate.year,
_startDate.month,
_startDate.day,
_startTime.hour,
_startTime.minute,
),
),
],
),
);
}
DateTime _composeDateTime(DateTime date, DateTime time) {
return DateTime(date.year, date.month, date.day, time.hour, time.minute);
}
DateTime _defaultEndDateTime(DateTime startDateTime) {
return startDateTime.add(const Duration(hours: 1));
}
void _setEndDateTime(DateTime value) {
_endDate = DateTime(value.year, value.month, value.day);
_endTime = DateTime(
value.year,
value.month,
value.day,
value.hour,
value.minute,
);
}
Widget _buildAdvancedTab() {
return SingleChildScrollView(
keyboardDismissBehavior: ScrollViewKeyboardDismissBehavior.onDrag,
+2 -1
View File
@@ -171,7 +171,7 @@
"uiSchemaUrlOpenFailed": "Unable to open URL",
"uiSchemaNavigationInvalidParams": "Invalid navigation params",
"uiSchemaNavigationInvalidPath": "Invalid navigation path",
"notificationSnoozeMinutes": "{minutes} min",
"notificationSnoozeMinutes": "Reminder snoozed for {minutes} min",
"@notificationSnoozeMinutes": {
"placeholders": {
"minutes": {
@@ -705,6 +705,7 @@
"calendarCreateReminderNone": "No reminder",
"calendarCreateReminderTime": "Reminder Time",
"calendarCreatePickReminderTime": "Select Reminder Time",
"calendarCreateInvalidTimeRange": "End time must be after start time",
"calendarCreateReminderPermissionFailed": "Failed to create reminder, check notification permission",
"settingsEditProfileLoadFailed": "Failed to load user profile",
"settingsEditProfileAvatarUploadSuccess": "Avatar uploaded successfully",
+7 -1
View File
@@ -911,7 +911,7 @@ abstract class AppLocalizations {
/// No description provided for @notificationSnoozeMinutes.
///
/// In zh, this message translates to:
/// **'{minutes} 分钟'**
/// **'提醒已推迟 {minutes} 分钟'**
String notificationSnoozeMinutes(int minutes);
/// No description provided for @notificationSnoozeLater.
@@ -3265,6 +3265,12 @@ abstract class AppLocalizations {
/// **'选择提醒时间'**
String get calendarCreatePickReminderTime;
/// No description provided for @calendarCreateInvalidTimeRange.
///
/// In zh, this message translates to:
/// **'结束时间必须晚于开始时间'**
String get calendarCreateInvalidTimeRange;
/// No description provided for @calendarCreateReminderPermissionFailed.
///
/// In zh, this message translates to:
+5 -1
View File
@@ -449,7 +449,7 @@ class AppLocalizationsEn extends AppLocalizations {
@override
String notificationSnoozeMinutes(int minutes) {
return '$minutes min';
return 'Reminder snoozed for $minutes min';
}
@override
@@ -1750,6 +1750,10 @@ class AppLocalizationsEn extends AppLocalizations {
@override
String get calendarCreatePickReminderTime => 'Select Reminder Time';
@override
String get calendarCreateInvalidTimeRange =>
'End time must be after start time';
@override
String get calendarCreateReminderPermissionFailed =>
'Failed to create reminder, check notification permission';
+4 -1
View File
@@ -435,7 +435,7 @@ class AppLocalizationsZh extends AppLocalizations {
@override
String notificationSnoozeMinutes(int minutes) {
return '$minutes 分钟';
return '提醒已推迟 $minutes 分钟';
}
@override
@@ -1707,6 +1707,9 @@ class AppLocalizationsZh extends AppLocalizations {
@override
String get calendarCreatePickReminderTime => '选择提醒时间';
@override
String get calendarCreateInvalidTimeRange => '结束时间必须晚于开始时间';
@override
String get calendarCreateReminderPermissionFailed => '提醒创建失败,请检查通知权限';
+2 -1
View File
@@ -171,7 +171,7 @@
"uiSchemaUrlOpenFailed": "无法打开链接",
"uiSchemaNavigationInvalidParams": "导航参数无效",
"uiSchemaNavigationInvalidPath": "导航路径无效",
"notificationSnoozeMinutes": "{minutes} 分钟",
"notificationSnoozeMinutes": "提醒已推迟 {minutes} 分钟",
"@notificationSnoozeMinutes": {
"placeholders": {
"minutes": {
@@ -705,6 +705,7 @@
"calendarCreateReminderNone": "无提醒",
"calendarCreateReminderTime": "提醒时间",
"calendarCreatePickReminderTime": "选择提醒时间",
"calendarCreateInvalidTimeRange": "结束时间必须晚于开始时间",
"calendarCreateReminderPermissionFailed": "提醒创建失败,请检查通知权限",
"settingsEditProfileLoadFailed": "加载用户信息失败",
"settingsEditProfileAvatarUploadSuccess": "头像上传成功",
@@ -0,0 +1,80 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:social_app/core/notification/models/reminder_alarm.dart';
import 'package:social_app/core/notification/services/reminder_reconcile_service.dart';
import 'package:social_app/core/notification/services/reminder_scheduler_service.dart';
class _FakeReminderSchedulerService extends ReminderSchedulerService {
int upsertCount = 0;
int cancelCount = 0;
List<ReminderAlarm> lastScheduled = const <ReminderAlarm>[];
@override
Future<void> upsertEventReminders(
ReminderEventSnapshot event, {
DateTime? now,
}) async {
upsertCount += 1;
}
@override
Future<void> cancelEventReminders(String eventId) async {
cancelCount += 1;
}
@override
Future<void> scheduleAlarms(List<ReminderAlarm> alarms) async {
lastScheduled = alarms;
}
}
ReminderEventSnapshot _event({bool isArchived = false}) {
return ReminderEventSnapshot(
eventId: 'evt_lock',
title: 'Review',
startAt: DateTime(2026, 3, 30, 10, 0),
endAt: DateTime(2026, 3, 30, 11, 0),
timezone: 'Asia/Shanghai',
reminderMinutes: 15,
isArchived: isArchived,
);
}
void main() {
test('snooze suppresses reconcile before first snooze fire time', () async {
final now = DateTime(2026, 3, 30, 9, 50);
final scheduler = _FakeReminderSchedulerService();
final service = ReminderReconcileService(
scheduler: scheduler,
nowProvider: () => now,
);
await service.snooze10m(_event());
expect(scheduler.cancelCount, 1);
expect(scheduler.lastScheduled, isNotEmpty);
expect(scheduler.lastScheduled.first.fireAt, DateTime(2026, 3, 30, 10, 0));
await service.reconcileEvent(_event(), now: DateTime(2026, 3, 30, 9, 59));
expect(scheduler.upsertCount, 0);
await service.reconcileEvent(_event(), now: DateTime(2026, 3, 30, 10, 0));
expect(scheduler.upsertCount, 1);
});
test('archived event cancels reminder and clears suppress state', () async {
final now = DateTime(2026, 3, 30, 9, 50);
final scheduler = _FakeReminderSchedulerService();
final service = ReminderReconcileService(
scheduler: scheduler,
nowProvider: () => now,
);
await service.snooze10m(_event());
expect(scheduler.cancelCount, 1);
await service.reconcileEvent(_event(isArchived: true), now: now);
expect(scheduler.cancelCount, 2);
await service.reconcileEvent(_event(), now: DateTime(2026, 3, 30, 9, 55));
expect(scheduler.upsertCount, 1);
});
}
@@ -26,28 +26,44 @@ void main() {
expect(alarms.last.fireAt, DateTime(2026, 3, 30, 10, 35));
});
test(
'buildAlarms compensates by scheduling near-now when remindAt passed',
() {
final event = ReminderEventSnapshot(
eventId: 'evt_3',
title: 'Review',
startAt: DateTime(2026, 3, 30, 10, 0),
endAt: DateTime(2026, 3, 30, 10, 20),
timezone: 'Asia/Shanghai',
reminderMinutes: 30,
);
final now = DateTime(2026, 3, 30, 10, 5, 0);
test('buildAlarms starts from near-now when remindAt passed', () {
final event = ReminderEventSnapshot(
eventId: 'evt_3',
title: 'Review',
startAt: DateTime(2026, 3, 30, 10, 0),
endAt: DateTime(2026, 3, 30, 10, 20),
timezone: 'Asia/Shanghai',
reminderMinutes: 30,
);
final now = DateTime(2026, 3, 30, 10, 5, 0);
final alarms = ReminderSchedulerService.buildAlarmsForEvent(
event,
now: now,
);
final alarms = ReminderSchedulerService.buildAlarmsForEvent(
event,
now: now,
);
expect(alarms, isNotEmpty);
expect(alarms.first.fireAt, now.add(const Duration(seconds: 5)));
},
);
expect(alarms, isNotEmpty);
expect(alarms.first.fireAt, DateTime(2026, 3, 30, 10, 5, 2));
expect(alarms.last.fireAt, DateTime(2026, 3, 30, 10, 15, 2));
});
test('buildAlarms returns empty when next cadence is after endAt', () {
final event = ReminderEventSnapshot(
eventId: 'evt_3b',
title: 'Review',
startAt: DateTime(2026, 3, 30, 10, 0),
endAt: DateTime(2026, 3, 30, 10, 5),
timezone: 'Asia/Shanghai',
reminderMinutes: 30,
);
final alarms = ReminderSchedulerService.buildAlarmsForEvent(
event,
now: DateTime(2026, 3, 30, 10, 5, 30),
);
expect(alarms, isEmpty);
});
test('buildAlarms returns empty when event already ended', () {
final event = ReminderEventSnapshot(
@@ -83,10 +83,10 @@ class CalendarWriteOperation(BaseModel):
location: str | None = Field(default=None, description="Event location.")
color: str | None = Field(default=None, description="Event color.")
reminder_minutes: int | None = Field(
default=None,
default=5,
ge=0,
le=10080,
description="Reminder minutes before event start.",
description="Reminder minutes before event start. Defaults to 5 minutes if not specified.",
)
status: Literal["active", "archived"] | None = Field(
default=None,