백품타에 일시정지/재개 기능 추가

진행 중일 때 일시정지하면 그 구간은 누적 시간에서 빠지고, 재개하면 다시 이어서 잰다. 상태를 idle/running/paused 3가지로 나눠서 관리. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-16 14:49:48 +09:00
parent 93104362be
commit 094ce2292c
2 changed files with 178 additions and 108 deletions
@@ -5,6 +5,8 @@ import 'package:flutter/foundation.dart';
 import 'package:http/http.dart' as http;
 import '../config.dart';

+enum StudyTimerState { idle, running, paused }
+
 class StudyTimerController extends ChangeNotifier {
  final String studentId;
  final String studentName;
@@ -12,9 +14,10 @@ class StudyTimerController extends ChangeNotifier {
  StudyTimerController({required this.studentId, required this.studentName});

  bool _isLoading = true;
-  bool _isBusy = false; // 시작/종료 버튼 눌러서 서버 응답 기다리는 중
-  bool _isRunning = false;
-  DateTime? _startTime;
+  bool _isBusy = false; // 시작/일시정지/재개/종료 버튼 눌러서 서버 응답 기다리는 중
+  StudyTimerState _state = StudyTimerState.idle;
+  int _elapsedSeconds = 0; // 지금 세션에서 "정지 상태"일 때 확정된 누적 초 (일시정지 구간 제외)
+  DateTime? _lastResumedAt; // running일 때만 의미 있음 - 여기서부터 실시간으로 흐른다
  int _todaySeconds = 0;
  int _weekSeconds = 0;
  int _totalSeconds = 0;
@@ -23,24 +26,25 @@ class StudyTimerController extends ChangeNotifier {

  bool get isLoading => _isLoading;
  bool get isBusy => _isBusy;
-  bool get isRunning => _isRunning;
+  bool get isRunning => _state == StudyTimerState.running;
+  bool get isPaused => _state == StudyTimerState.paused;
+  bool get isIdle => _state == StudyTimerState.idle;

-  /// 지금 진행 중인 세션까지 포함한 "오늘" 누적 초. 실시간으로 똑딱거린다.
-  int get todaySecondsLive =>
-      _todaySeconds + (_isRunning ? _liveElapsedSeconds : 0);
-  int get weekSecondsLive =>
-      _weekSeconds + (_isRunning ? _liveElapsedSeconds : 0);
-  int get totalSecondsLive =>
-      _totalSeconds + (_isRunning ? _liveElapsedSeconds : 0);
-
-  /// 지금 세션 하나만의 경과 시간(타이머 화면 큰 숫자용).
-  int get _liveElapsedSeconds {
-    if (_startTime == null) return 0;
-    final diff = DateTime.now().difference(_startTime!).inSeconds;
-    return diff > 0 ? diff : 0;
+  /// 지금 세션 하나만의 경과 시간(타이머 화면 큰 숫자용). 일시정지 중엔 멈춰 있다.
+  int get liveElapsedSeconds {
+    if (_state != StudyTimerState.running || _lastResumedAt == null) {
+      return _elapsedSeconds;
+    }
+    final diff = DateTime.now().difference(_lastResumedAt!).inSeconds;
+    return _elapsedSeconds + (diff > 0 ? diff : 0);
  }

-  int get liveElapsedSeconds => _liveElapsedSeconds;
+  /// 지금 진행 중인 세션까지 포함한 "오늘" 누적 초. running일 때만 실시간으로 늘어난다.
+  int get todaySecondsLive => _todaySeconds + _liveDelta;
+  int get weekSecondsLive => _weekSeconds + _liveDelta;
+  int get totalSecondsLive => _totalSeconds + _liveDelta;
+
+  int get _liveDelta => _state == StudyTimerState.idle ? 0 : liveElapsedSeconds;

  void _safeNotify() {
    if (!_disposed) notifyListeners();
@@ -64,9 +68,10 @@ class StudyTimerController extends ChangeNotifier {
      );
      if (response.statusCode == 200) {
        final data = jsonDecode(utf8.decode(response.bodyBytes));
-        _isRunning = data['isRunning'] == true;
-        _startTime = data['startTime'] != null
-            ? DateTime.tryParse(data['startTime'])
+        _state = _parseState(data['state']);
+        _elapsedSeconds = (data['elapsedSeconds'] as num?)?.toInt() ?? 0;
+        _lastResumedAt = data['lastResumedAt'] != null
+            ? DateTime.tryParse(data['lastResumedAt'])
            : null;
        _todaySeconds = (data['todaySeconds'] as num?)?.toInt() ?? 0;
        _weekSeconds = (data['weekSeconds'] as num?)?.toInt() ?? 0;
@@ -81,9 +86,20 @@ class StudyTimerController extends ChangeNotifier {
    }
  }

+  StudyTimerState _parseState(dynamic raw) {
+    switch (raw) {
+      case 'running':
+        return StudyTimerState.running;
+      case 'paused':
+        return StudyTimerState.paused;
+      default:
+        return StudyTimerState.idle;
+    }
+  }
+
  void _restartTickerIfNeeded() {
    _ticker?.cancel();
-    if (_isRunning) {
+    if (_state == StudyTimerState.running) {
      _ticker = Timer.periodic(
        const Duration(seconds: 1),
        (_) => _safeNotify(),
@@ -92,50 +108,67 @@ class StudyTimerController extends ChangeNotifier {
  }

  Future<(bool success, String message)> start() async {
-    _isBusy = true;
-    _safeNotify();
-    try {
-      final response = await http.post(
-        Uri.parse('$baseUrl/api/study/start'),
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({"studentId": studentId, "studentName": studentName}),
-      );
-      final result = jsonDecode(utf8.decode(response.bodyBytes));
-      if (response.statusCode == 200 && result['status'] == 'success') {
-        _isRunning = true;
-        _startTime = DateTime.tryParse(result['startTime']);
-        _restartTickerIfNeeded();
-        return (true, '공부를 시작했습니다.');
-      }
-      return (false, '${result['message'] ?? '공부 시작 실패'}');
-    } catch (e) {
-      return (false, '네트워크 에러: $e');
-    } finally {
-      _isBusy = false;
-      _safeNotify();
-    }
+    return _action(
+      '/api/study/start',
+      body: {"studentId": studentId, "studentName": studentName},
+      onSuccess: (_) async {
+        await _fetchStatus();
+        return '공부를 시작했습니다.';
+      },
+    );
+  }
+
+  Future<(bool success, String message)> pause() async {
+    return _action(
+      '/api/study/pause',
+      onSuccess: (_) async {
+        await _fetchStatus();
+        return '일시정지했습니다.';
+      },
+    );
+  }
+
+  Future<(bool success, String message)> resume() async {
+    return _action(
+      '/api/study/resume',
+      onSuccess: (_) async {
+        await _fetchStatus();
+        return '다시 시작했습니다.';
+      },
+    );
  }

  Future<(bool success, String message)> stop() async {
+    return _action(
+      '/api/study/stop',
+      onSuccess: (result) async {
+        await _fetchStatus(); // 오늘/이번주/전체 합계를 서버 값으로 다시 맞춘다.
+        final minutes =
+            ((result['durationSeconds'] as num?)?.toInt() ?? 0) ~/ 60;
+        return '이번 공부 시간: $minutes분 기록 완료!';
+      },
+    );
+  }
+
+  Future<(bool success, String message)> _action(
+    String path, {
+    Map<String, dynamic> body = const {},
+    required Future<String> Function(Map<String, dynamic> result) onSuccess,
+  }) async {
    _isBusy = true;
    _safeNotify();
    try {
      final response = await http.post(
-        Uri.parse('$baseUrl/api/study/stop'),
+        Uri.parse('$baseUrl$path'),
        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({"studentId": studentId}),
+        body: jsonEncode({"studentId": studentId, ...body}),
      );
      final result = jsonDecode(utf8.decode(response.bodyBytes));
      if (response.statusCode == 200 && result['status'] == 'success') {
-        _isRunning = false;
-        _startTime = null;
-        _ticker?.cancel();
-        await _fetchStatus(); // 오늘/이번주/전체 합계를 서버 값으로 다시 맞춘다.
-        final minutes =
-            ((result['durationSeconds'] as num?)?.toInt() ?? 0) ~/ 60;
-        return (true, '이번 공부 시간: $minutes분 기록 완료!');
+        final message = await onSuccess(result);
+        return (true, message);
      }
-      return (false, '${result['message'] ?? '공부 종료 실패'}');
+      return (false, '${result['message'] ?? '처리 실패'}');
    } catch (e) {
      return (false, '네트워크 에러: $e');
    } finally {