자습실 출석시간 지정 기능 추가 + 앱 버전 1.1.1

- 대시보드에서 자습실 출석시간(HH:MM) 지정 가능, 하교 시 자동 초기화
- 지정 시간 이전 태깅은 "출석 미완료", 이후는 시간 강조 표시로 구분

firebase.json

@@ -1 +1 @@
-{"flutter":{"platforms":{"android":{"default":{"projectId":"school-display-ff28f","appId":"1:137322214849:android:2595999513206bdeb16b40","fileOutput":"android/app/google-services.json"}},"dart":{"lib/firebase_options.dart":{"projectId":"school-display-ff28f","configurations":{"android":"1:137322214849:android:2595999513206bdeb16b40","web":"1:137322214849:web:0423e5c788d95761b16b40"}}}}},"hosting":{"public":"build/web","ignore":["firebase.json","**/.*"],"rewrites":[{"source":"**","destination":"/index.html"}]}}
+{"flutter":{"platforms":{"android":{"default":{"projectId":"school-display-ff28f","appId":"1:137322214849:android:2595999513206bdeb16b40","fileOutput":"android/app/google-services.json"}},"dart":{"lib/firebase_options.dart":{"projectId":"school-display-ff28f","configurations":{"android":"1:137322214849:android:2595999513206bdeb16b40","web":"1:137322214849:web:0423e5c788d95761b16b40"}}}}},"hosting":{"public":"build/web","ignore":["firebase.json","**/.*"],"rewrites":[{"source":"**","destination":"/index.html"}],"headers":[{"source":"/index.html","headers":[{"key":"Cache-Control","value":"no-cache, no-store, must-revalidate"}]},{"source":"/flutter_service_worker.js","headers":[{"key":"Cache-Control","value":"no-cache, no-store, must-revalidate"}]},{"source":"/version.json","headers":[{"key":"Cache-Control","value":"no-cache, no-store, must-revalidate"}]}]}}

lib/nfc_poccket_checkin_screen.dart

@@ -43,10 +43,14 @@ class _NfcPocketCheckInScreenState extends State<NfcPocketCheckInScreen> {
     _startNfcSession();
     if (_watchServiceSupported) {
       // 화면이 열려있는 동안은 실시간으로 위반 알림을 받아 팝업을 띄운다.
+      // 무단 반출이 한 번 감지되면 "신뢰된 감시 세션"은 끝난 것으로 보고,
+      // 다음 태깅은 체크아웃이 아니라 새 출석(재출석)으로 처리되도록 감시 상태를 해제한다.
       _violationSub = FlutterBackgroundService().on('violation_detected').listen((
         event,
       ) {
-        if (mounted) _showViolationDialog(event?['pocketNumber']?.toString());
+        if (!mounted) return;
+        setState(() => _isWatching = false);
+        _showViolationDialog(event?['pocketNumber']?.toString());
       });
     }
   }
@@ -354,22 +358,10 @@ class _NfcPocketCheckInScreenState extends State<NfcPocketCheckInScreen> {
               ),
               const SizedBox(height: 8),
               const Text(
-                "📴 화면을 꺼도 감시는 계속됩니다.\n알림바에서 상태를 확인할 수 있어요.",
+                "📴 화면을 꺼도 감시는 계속됩니다.\n알림바에서 상태를 확인할 수 있어요.\n(폰을 꺼내 다시 태깅하면 반출 처리됩니다)",
                 textAlign: TextAlign.center,
                 style: TextStyle(color: Colors.white38, fontSize: 13),
               ),
-              const SizedBox(height: 40),
-              OutlinedButton.icon(
-                onPressed: _checkOut,
-                icon: const Icon(Icons.logout_rounded, color: Colors.white70),
-                label: const Text(
-                  "폰 회수하고 감시 종료 (테스트용)",
-                  style: TextStyle(color: Colors.white70),
-                ),
-                style: OutlinedButton.styleFrom(
-                  side: const BorderSide(color: Colors.white30),
-                ),
-              ),
             ],
           ),
         ),

lib/screens/teacher_attendance_page.dart

@@ -24,8 +24,11 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
   List<dynamic> _roster = []; // 전체 학생 명단 (/api/users)
   List<dynamic> _logs = []; // 출석 로그 (/api/logs)
   Map<String, dynamic> _activeViolationsByStudentId = {}; // 무단반출 중인 학생 (/api/violations/active)
+  String? _dismissedAt; // 오늘 가장 최근 하교 처리 시각 (/api/dismissal/latest). 이 시각 이후 기록만 "오늘 출석"으로 표시.
+  String? _attendanceTime; // 선생님이 지정한 자습실 출석시간 "HH:MM" (/api/settings/attendance-time). null이면 미설정.
   Timer? _timer;
   bool _isLoading = true;
+  bool _isRefreshing = false; // 새로고침 버튼 클릭 시 잠깐 도는 표시용
   String _filterType = "ALL"; // "ALL", "CHECKED_IN", "ABSENT"
 
   @override
@@ -41,17 +44,27 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
     super.dispose();
   }
 
+  Future<void> _manualRefresh() async {
+    setState(() => _isRefreshing = true);
+    await _fetchAll();
+    if (mounted) setState(() => _isRefreshing = false);
+  }
+
   Future<void> _fetchAll() async {
     try {
       final results = await Future.wait([
         http.get(Uri.parse('$baseUrl/api/users')),
         http.get(Uri.parse('$baseUrl/api/logs')),
         http.get(Uri.parse('$baseUrl/api/violations/active')),
+        http.get(Uri.parse('$baseUrl/api/dismissal/latest')),
+        http.get(Uri.parse('$baseUrl/api/settings/attendance-time')),
       ]);
 
       final usersRes = results[0];
       final logsRes = results[1];
       final violationsRes = results[2];
+      final dismissalRes = results[3];
+      final attendanceTimeRes = results[4];
 
       if (usersRes.statusCode == 200 && logsRes.statusCode == 200) {
         final usersData = jsonDecode(utf8.decode(usersRes.bodyBytes));
@@ -65,10 +78,25 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
           }
         }
 
+        String? dismissedAt;
+        if (dismissalRes.statusCode == 200) {
+          final dismissalData = jsonDecode(utf8.decode(dismissalRes.bodyBytes));
+          dismissedAt = dismissalData['dismissedAt'];
+        }
+
+        String? attendanceTime;
+        if (attendanceTimeRes.statusCode == 200) {
+          final attendanceTimeData =
+              jsonDecode(utf8.decode(attendanceTimeRes.bodyBytes));
+          attendanceTime = attendanceTimeData['attendanceTime'];
+        }
+
         setState(() {
           _roster = usersData['users'] ?? [];
           _logs = logsData['logs'] ?? [];
           _activeViolationsByStudentId = activeViolations;
+          _dismissedAt = dismissedAt;
+          _attendanceTime = attendanceTime;
           _isLoading = false;
         });
       } else {
@@ -79,6 +107,24 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
     }
   }
 
+  /// 🏫 하교 처리: 전체 반출 허용 + 오늘 출석 표시 기준선을 지금 시각으로 옮긴다.
+  Future<void> _dismissAll() async {
+    try {
+      final response = await http.post(Uri.parse('$baseUrl/api/dismiss'));
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(content: Text(result['message'] ?? '하교 처리되었습니다.')),
+      );
+      _fetchAll();
+    } catch (e) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(content: Text('❌ 하교 처리 실패: $e')),
+      );
+    }
+  }
+
   /// 🚨 선생님이 특정 학생에게 지금부터 N분간 반출을 허용한다.
   Future<void> _allowRemoval(String studentId, int minutes) async {
     try {
@@ -123,6 +169,48 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
     }
   }
 
+  /// ⏰ 자습실 출석시간(기준 시각)을 지정한다. 이 시각 이후 태깅한 학생만 "출석 완료"로 강조 표시된다.
+  Future<void> _setAttendanceTime(String time) async {
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/settings/attendance-time'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"time": time}),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(content: Text(result['message'] ?? '처리되었습니다.')),
+      );
+      _fetchAll();
+    } catch (e) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(content: Text('❌ 출석시간 설정 실패: $e')),
+      );
+    }
+  }
+
+  Future<void> _showAttendanceTimeDialog() async {
+    final TimeOfDay initial = _attendanceTime != null
+        ? TimeOfDay(
+            hour: int.parse(_attendanceTime!.split(':')[0]),
+            minute: int.parse(_attendanceTime!.split(':')[1]),
+          )
+        : const TimeOfDay(hour: 19, minute: 0);
+
+    final TimeOfDay? picked = await showTimePicker(
+      context: context,
+      initialTime: initial,
+      helpText: '자습실 출석시간 지정',
+    );
+    if (picked == null) return;
+
+    final String formatted =
+        '${picked.hour.toString().padLeft(2, '0')}:${picked.minute.toString().padLeft(2, '0')}';
+    _setAttendanceTime(formatted);
+  }
+
   void _showAllowDialog(String studentId, String studentName) {
     final controller = TextEditingController(text: "5");
     showDialog(
@@ -198,17 +286,45 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
     );
   }
 
-  /// 오늘 날짜 기준으로 학번별 "가장 최근 출석 기록"만 남긴 맵을 만든다.
+  /// 🏫 하교 처리: 시간 입력 없이 바로 전체 학생의 반출을 (사실상 무기한) 허용한다.
+  void _showDismissalConfirmDialog() {
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        title: const Text('🏫 하교 처리'),
+        content: const Text(
+          '지금부터 모든 학생의 반출이 자동으로 허용되며, 더 이상 무단반출 경고가 뜨지 않습니다.\n하교 처리하시겠습니까?',
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text('취소'),
+          ),
+          ElevatedButton(
+            onPressed: () {
+              Navigator.pop(context);
+              _dismissAll();
+            },
+            child: const Text('하교 처리'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// "오늘 출석"의 기준선. 하교 처리를 했다면 그 시각 이후, 안 했다면 오늘 자정부터.
   Map<String, Map<String, String>> get _todaysCheckInsByStudentId {
-    final String todayPrefix = DateTime.now().toIso8601String().substring(
-      0,
-      10,
-    ); // "YYYY-MM-DD"
+    // "YYYY-MM-DD HH:MM:SS" 형태의 문자열끼리는 그대로 비교해도 시간 순서가 맞는다.
+    final String cutoff =
+        _dismissedAt ??
+        '${DateTime.now().toIso8601String().substring(0, 10)} 00:00:00';
     final Map<String, Map<String, String>> result = {};
 
     for (final log in _logs) {
       final String time = log['time']?.toString() ?? '';
-      if (!time.startsWith(todayPrefix)) continue; // 오늘 기록이 아니면 무시
+      if (time.isEmpty || time.compareTo(cutoff) <= 0) {
+        continue; // 하교 처리 시각(또는 오늘 자정) 이전 기록이면 무시
+      }
 
       final String studentId = log['student_id']?.toString() ?? '';
       if (studentId.isEmpty) continue;
@@ -227,18 +343,34 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
     return result;
   }
 
+  /// ⏰ 태깅 시간과 지정된 자습실 출석시간을 비교해 'NONE' / 'PENDING' / 'COMPLETE'를 반환한다.
+  /// - NONE: 아직 태깅 안 함
+  /// - PENDING: 태깅은 했지만 지정된 출석시간 이전이라 아직 "출석 완료"로 안 침
+  /// - COMPLETE: 출석시간 미지정이거나, 지정된 출석시간 이후에 태깅함
+  String _computeAttendanceStatus(String? checkInTime) {
+    if (checkInTime == null) return 'NONE';
+    if (_attendanceTime == null) return 'COMPLETE';
+
+    final String todayStr = DateTime.now().toIso8601String().substring(0, 10);
+    final String cutoff = '$todayStr $_attendanceTime:00';
+    return checkInTime.compareTo(cutoff) >= 0 ? 'COMPLETE' : 'PENDING';
+  }
+
   List<Map<String, dynamic>> get _combinedStudentStatus {
     final checkIns = _todaysCheckInsByStudentId;
     return _roster.map((u) {
       final String id = u['id']?.toString() ?? '';
       final checkIn = checkIns[id];
       final violation = _activeViolationsByStudentId[id];
+      final String attendanceStatus = _computeAttendanceStatus(checkIn?['time']);
       return {
         'studentId': id,
         'studentName': u['name']?.toString() ?? '',
         'isCheckedIn': checkIn != null,
         'pocketNumber': checkIn?['pocketNumber'],
         'checkInTime': checkIn?['time'],
+        'attendanceStatus': attendanceStatus,
+        'isAttendanceComplete': attendanceStatus == 'COMPLETE',
         'hasActiveViolation': violation != null,
         'violationPocket': violation?['pocket_number'],
         'violationTime': violation?['time'],
@@ -249,9 +381,9 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
   List<Map<String, dynamic>> get _filteredStudents {
     final all = _combinedStudentStatus;
     if (_filterType == "CHECKED_IN") {
-      return all.where((s) => s['isCheckedIn'] == true).toList();
+      return all.where((s) => s['isAttendanceComplete'] == true).toList();
     } else if (_filterType == "ABSENT") {
-      return all.where((s) => s['isCheckedIn'] == false).toList();
+      return all.where((s) => s['isAttendanceComplete'] == false).toList();
     }
     return all;
   }
@@ -260,7 +392,8 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
   Widget build(BuildContext context) {
     final all = _combinedStudentStatus;
     final int totalCount = all.length;
-    final int checkedInCount = all.where((s) => s['isCheckedIn'] == true).length;
+    final int checkedInCount =
+        all.where((s) => s['isAttendanceComplete'] == true).length;
     final int absentCount = totalCount - checkedInCount;
 
     return Scaffold(
@@ -274,6 +407,28 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
         foregroundColor: Colors.white,
         elevation: 0,
         actions: [
+          IconButton(
+            onPressed: (_isLoading || _isRefreshing) ? null : _manualRefresh,
+            icon: _isRefreshing
+                ? const SizedBox(
+                    width: 20,
+                    height: 20,
+                    child: CircularProgressIndicator(
+                      strokeWidth: 2,
+                      color: Colors.white,
+                    ),
+                  )
+                : const Icon(Icons.refresh_rounded),
+            tooltip: '새로고침',
+          ),
+          TextButton.icon(
+            onPressed: _showAttendanceTimeDialog,
+            icon: const Icon(Icons.access_time_rounded, color: Colors.white),
+            label: Text(
+              _attendanceTime != null ? '출석시간 $_attendanceTime' : '자습실 출석시간 설정',
+              style: const TextStyle(color: Colors.white),
+            ),
+          ),
           TextButton.icon(
             onPressed: _showPermissionWindowDialog,
             icon: const Icon(Icons.timer_outlined, color: Colors.white),
@@ -282,6 +437,14 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
               style: TextStyle(color: Colors.white),
             ),
           ),
+          TextButton.icon(
+            onPressed: _showDismissalConfirmDialog,
+            icon: const Icon(Icons.school_rounded, color: Colors.white),
+            label: const Text(
+              '하교',
+              style: TextStyle(color: Colors.white),
+            ),
+          ),
           const SizedBox(width: 8),
         ],
       ),
@@ -321,6 +484,14 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
                     final student = _filteredStudents[index];
                     final bool isCheckedIn = student['isCheckedIn'];
                     final bool hasViolation = student['hasActiveViolation'] == true;
+                    final bool isPending = student['attendanceStatus'] == 'PENDING';
+                    final bool isComplete = student['attendanceStatus'] == 'COMPLETE';
+                    final bool emphasizeTime = isComplete && _attendanceTime != null;
+                    final Color statusColor = hasViolation
+                        ? Colors.red
+                        : (isPending
+                            ? Colors.orange
+                            : (isComplete ? Colors.blue : Colors.red));
                     return Container(
                       margin: const EdgeInsets.symmetric(
                         horizontal: 24,
@@ -349,21 +520,18 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
                               Container(
                                 padding: const EdgeInsets.all(10),
                                 decoration: BoxDecoration(
-                                  color: (hasViolation
-                                          ? Colors.red
-                                          : (isCheckedIn ? Colors.blue : Colors.red))
-                                      .withValues(alpha: 0.1),
+                                  color: statusColor.withValues(alpha: 0.1),
                                   shape: BoxShape.circle,
                                 ),
                                 child: Icon(
                                   hasViolation
                                       ? Icons.warning_amber_rounded
-                                      : (isCheckedIn
+                                      : (isPending
+                                          ? Icons.hourglass_bottom_rounded
+                                          : (isComplete
                                               ? Icons.check_circle_rounded
-                                          : Icons.error_rounded),
-                                  color: hasViolation
-                                      ? Colors.red
-                                      : (isCheckedIn ? Colors.blue : Colors.red),
+                                              : Icons.error_rounded)),
+                                  color: statusColor,
                                   size: 24,
                                 ),
                               ),
@@ -383,17 +551,21 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
                                     Text(
                                       hasViolation
                                           ? '🚨 무단반출 감지! (${student['violationTime']})'
-                                          : (isCheckedIn
+                                          : (isPending
+                                              ? '학번: ${student['studentId']} | ⏳ 출석 미완료 (제출: ${student['checkInTime']})'
+                                              : (isComplete
                                                   ? '학번: ${student['studentId']} | 제출시간: ${student['checkInTime']}'
-                                              : '학번: ${student['studentId']} | 미제출'),
+                                                  : '학번: ${student['studentId']} | 미제출')),
                                       style: TextStyle(
                                         color: hasViolation
                                             ? Colors.red[700]
-                                            : (isCheckedIn
+                                            : (isPending
+                                                ? Colors.orange[800]
+                                                : (isComplete
                                                     ? Colors.grey[600]
-                                                : Colors.red[400]),
-                                        fontSize: 12,
-                                        fontWeight: hasViolation
+                                                    : Colors.red[400])),
+                                        fontSize: emphasizeTime ? 14 : 12,
+                                        fontWeight: (hasViolation || emphasizeTime)
                                             ? FontWeight.bold
                                             : FontWeight.normal,
                                       ),
@@ -536,23 +708,34 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
                               final bool isCheckedIn = student['isCheckedIn'];
                               final bool hasViolation =
                                   student['hasActiveViolation'] == true;
+                              final bool isPending =
+                                  student['attendanceStatus'] == 'PENDING';
+                              final bool isComplete =
+                                  student['attendanceStatus'] == 'COMPLETE';
+                              final bool emphasizeTime =
+                                  isComplete && _attendanceTime != null;
+                              final Color statusColor = hasViolation
+                                  ? Colors.red
+                                  : (isPending
+                                      ? Colors.orange
+                                      : (isComplete ? Colors.blue : Colors.red));
                               return DataRow(
                                 color: hasViolation
                                     ? WidgetStateProperty.all(Colors.red[50])
-                                    : null,
+                                    : (isPending
+                                        ? WidgetStateProperty.all(Colors.orange[50])
+                                        : null),
                                 cells: [
                                   DataCell(
                                     Icon(
                                       hasViolation
                                           ? Icons.warning_amber_rounded
-                                          : (isCheckedIn
+                                          : (isPending
+                                              ? Icons.hourglass_bottom_rounded
+                                              : (isComplete
                                                   ? Icons.check_circle_rounded
-                                              : Icons.error_rounded),
-                                      color: hasViolation
-                                          ? Colors.red
-                                          : (isCheckedIn
-                                              ? Colors.blue
-                                              : Colors.red),
+                                                  : Icons.error_rounded)),
+                                      color: statusColor,
                                       size: 20,
                                     ),
                                   ),
@@ -569,16 +752,21 @@ class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
                                     Text(
                                       hasViolation
                                           ? '🚨 무단반출 (${student['violationTime']})'
-                                          : (isCheckedIn
+                                          : (isPending
+                                              ? '⏳ 출석 미완료 (제출: ${student['checkInTime']})'
+                                              : (isComplete
                                                   ? '${student['checkInTime']}'
-                                              : '미제출'),
+                                                  : '미제출')),
                                       style: TextStyle(
                                         color: hasViolation
                                             ? Colors.red[700]
-                                            : (isCheckedIn
+                                            : (isPending
+                                                ? Colors.orange[800]
+                                                : (isComplete
                                                     ? Colors.grey[700]
-                                                : Colors.red[400]),
-                                        fontWeight: hasViolation
+                                                    : Colors.red[400])),
+                                        fontSize: emphasizeTime ? 15 : 14,
+                                        fontWeight: (hasViolation || emphasizeTime)
                                             ? FontWeight.bold
                                             : FontWeight.normal,
                                       ),

pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.0+1
+version: 1.1.1+2
 
 environment:
   sdk: ^3.12.2