StudyStopwatch - タイマー機能

概要

科目別の学習時間を計測する中核機能。バックグラウンド・アプリ再起動でも正確に経過時間を保持。ポモドーロモード（集中25分/休憩5分）対応。

関連画面

永続化の仕組み

開始時 saveTimerState(subjectID, isPomodoroMode) → UserDefaults に開始日時・科目ID保存
バックグラウンド遷移 handleBackground() → Timer.invalidate(), 時刻記録
フォアグラウンド復帰 handleForeground() → 背景中の経過時間を加算、Timer 再開
アプリ再起動時 restoreIfNeeded(context) → 24時間内なら自動復元
停止時 clearTimerState() → UserDefaults クリア

ポモドーロモード

pomodoroPhase: .focus（集中25分） ↔ .shortBreak（休憩5分）
pomodoroCount: 完了サイクル数
集中フェーズのみ duration に計上（休憩は記録なし）
フェーズ切替時に通知＋ハプティクス

24時間境界

アプリ再起動時、保存済み startTime と現在時刻の差が 24時間以内のみ復元。朝をまたいだ場合は自動リセットして誤った長時間記録を防ぐ。

外部連携

連携先	用途
UserDefaults	タイマー状態永続化
LiveActivityService	1秒ごとに ContentState 更新
WidgetSyncService	セッション保存後に Widget 同期
SwiftData	StudySession として保存

変更履歴

バージョン	日付	変更内容
1.0	2026-05-09	初版作成