release: 1.1.5 Android 빌드 호환성 수정

AGP 9 환경에서 desktop_drop 플러그인의 Kotlin Gradle Plugin
적용 방식이 깨져 있어 릴리즈 APK 빌드가 실패하던 문제를 해결.
desktop_drop을 0.8.3으로 올리고, :desktop_drop 서브프로젝트에
kotlin-android 플러그인을 명시적으로 적용하도록 root build.gradle.kts에
예외 처리 추가.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.gitignore

@@ -43,3 +43,10 @@ app.*.map.json
 /android/app/debug
 /android/app/profile
 /android/app/release
+
+# Gradle build output (실수로 커밋되면 리포트 HTML 등 큰 파일이 섞여 들어옴)
+android/**/build/
+ios/**/build/
+
+# Firebase CLI 로컬 캐시 (배포 이력 해시 등, 소스 아님)
+.firebase/

android/build.gradle.kts

@@ -26,6 +26,11 @@ subprojects {
 tasks.register<Delete>("clean") {
     delete(rootProject.layout.buildDirectory)
 }
+subprojects {
+    if (project.name == "desktop_drop") {
+        pluginManager.apply("org.jetbrains.kotlin.android")
+    }
+}
 subprojects {
     plugins.withId("com.android.library") {
         extensions.configure<com.android.build.gradle.BaseExtension> {

ios/Runner.xcodeproj/project.pbxproj

@@ -11,6 +11,7 @@
 		331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; };
 		3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; };
 		74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; };
+		5FA389C5018E5592CC402E5C /* ProximityMonitorPlugin.swift in Sources */ = {isa = PBXBuildFile; fileRef = E653BC1DC10E8731479786F7 /* ProximityMonitorPlugin.swift */; };
 		7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */; };
 		78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */ = {isa = PBXBuildFile; productRef = 78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */; };
 		97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; };
@@ -49,6 +50,7 @@
 		3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = "<group>"; };
 		74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = "<group>"; };
 		74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+		E653BC1DC10E8731479786F7 /* ProximityMonitorPlugin.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ProximityMonitorPlugin.swift; sourceTree = "<group>"; };
 		7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = "<group>"; };
 		78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */ = {isa = PBXFileReference; lastKnownFileType = wrapper; name = FlutterGeneratedPluginSwiftPackage; path = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage; sourceTree = "<group>"; };
 		7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = "<group>"; };
@@ -122,6 +124,7 @@
 				1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */,
 				1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */,
 				74858FAE1ED2DC5600515810 /* AppDelegate.swift */,
+				E653BC1DC10E8731479786F7 /* ProximityMonitorPlugin.swift */,
 				7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */,
 				74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */,
 			);
@@ -282,6 +285,7 @@
 			buildActionMask = 2147483647;
 			files = (
 				74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */,
+				5FA389C5018E5592CC402E5C /* ProximityMonitorPlugin.swift in Sources */,
 				1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */,
 				7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */,
 			);

ios/Runner/AppDelegate.swift

@@ -12,5 +12,8 @@ import UIKit
 
   func didInitializeImplicitFlutterEngine(_ engineBridge: FlutterImplicitEngineBridge) {
     GeneratedPluginRegistrant.register(with: engineBridge.pluginRegistry)
+    ProximityMonitorPlugin.register(
+      with: engineBridge.pluginRegistry.registrar(forPlugin: "ProximityMonitorPlugin")
+    )
   }
 }

ios/Runner/ProximityMonitorPlugin.swift

@@ -0,0 +1,63 @@
+// 🛡️ iOS 근접센서로 "주머니 감시"를 흉내내기 위한 네이티브 플러그인.
+// UIDevice의 근접센서를 켜면 통화 중처럼 화면이 자동으로 꺼지고 켜지는데,
+// 그 상태 변화(가까움/멀어짐)를 Dart 쪽 EventChannel로 그대로 흘려보낸다.
+import Flutter
+import UIKit
+
+class ProximityMonitorPlugin: NSObject, FlutterPlugin, FlutterStreamHandler {
+  private var eventSink: FlutterEventSink?
+
+  static func register(with registrar: FlutterPluginRegistrar) {
+    let instance = ProximityMonitorPlugin()
+
+    let methodChannel = FlutterMethodChannel(
+      name: "proximity_monitor",
+      binaryMessenger: registrar.messenger()
+    )
+    methodChannel.setMethodCallHandler(instance.handle)
+
+    let eventChannel = FlutterEventChannel(
+      name: "proximity_monitor/events",
+      binaryMessenger: registrar.messenger()
+    )
+    eventChannel.setStreamHandler(instance)
+  }
+
+  func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
+    switch call.method {
+    case "start":
+      UIDevice.current.isProximityMonitoringEnabled = true
+      result(nil)
+    case "stop":
+      UIDevice.current.isProximityMonitoringEnabled = false
+      result(nil)
+    default:
+      result(FlutterMethodNotImplemented)
+    }
+  }
+
+  func onListen(withArguments arguments: Any?, eventSink events: @escaping FlutterEventSink) -> FlutterError? {
+    eventSink = events
+    NotificationCenter.default.addObserver(
+      self,
+      selector: #selector(proximityStateChanged),
+      name: UIDevice.proximityStateDidChangeNotification,
+      object: nil
+    )
+    return nil
+  }
+
+  func onCancel(withArguments arguments: Any?) -> FlutterError? {
+    NotificationCenter.default.removeObserver(
+      self,
+      name: UIDevice.proximityStateDidChangeNotification,
+      object: nil
+    )
+    eventSink = nil
+    return nil
+  }
+
+  @objc private func proximityStateChanged() {
+    eventSink?(UIDevice.current.proximityState)
+  }
+}

lib/config.dart

@@ -5,13 +5,28 @@ import 'package:device_info_plus/device_info_plus.dart';
 import 'package:firebase_messaging/firebase_messaging.dart';
 import 'package:flutter/foundation.dart' show kIsWeb;
 
-// 🌐 기존에 사용하시던 실제 백엔드 서버 도메인 주소로 통일합니다.
-const String baseUrl = 'https://backsanhi.mcv.kr';
+// 🌐 학교마다 다른 값들. 빌드할 때 --dart-define으로 안 넘기면 지금 쓰는
+// 백산고 값이 그대로 기본값이 된다 (기존 빌드 명령이 안 깨지게 하기 위함).
+// 예: flutter build web --dart-define=BASE_URL=https://다른학교도메인.com
+const String baseUrl = String.fromEnvironment(
+  'BASE_URL',
+  defaultValue: 'https://api.backsanhi.shop',
+);
 
 // 🔑 웹에서 FCM 토큰을 받으려면 필요한 VAPID 키
 // (Firebase Console > 프로젝트 설정 > Cloud Messaging > 웹 구성 > 웹 푸시 인증서에서 발급)
-const String webVapidKey =
-    'BG4LnirukBdW3cXVWxhvY9pcjevBKDhpsaq1SLZdBs2cOEiwLAFyuuZLkMqpEGp9uOuHdPOe_y3FdwdZaz3qdfk';
+// 학교마다 Firebase 프로젝트가 다르므로 VAPID 키도 학교별로 --dart-define=WEB_VAPID_KEY=...로 지정.
+const String webVapidKey = String.fromEnvironment(
+  'WEB_VAPID_KEY',
+  defaultValue:
+      'BG4LnirukBdW3cXVWxhvY9pcjevBKDhpsaq1SLZdBs2cOEiwLAFyuuZLkMqpEGp9uOuHdPOe_y3FdwdZaz3qdfk',
+);
+
+// 🏫 앱/로그인 화면에 표시할 학교 이름. --dart-define=SCHOOL_NAME=...으로 학교별 지정.
+const String schoolName = String.fromEnvironment(
+  'SCHOOL_NAME',
+  defaultValue: '백산고등학교',
+);
 
 // 권한 요청 및 FCM 토큰을 가져와서 콘솔에 출력하는 함수
 Future<void> printFCMToken() async {

lib/debug_pocket_main.dart

@@ -1,5 +1,5 @@
 import 'package:flutter/material.dart';
-import 'nfc_poccket_checkin_screen.dart';
+import 'ui/nfc_poccket_checkin_screen.dart';
 
 // 🧪 디버그 전용 진입점: NFC 주머니 체크인 + 조도 센서 감시 화면을 바로 테스트하기 위한 파일.
 void main() {
@@ -13,10 +13,7 @@ class DebugPocketApp extends StatelessWidget {
   Widget build(BuildContext context) {
     return const MaterialApp(
       debugShowCheckedModeBanner: false,
-      home: NfcPocketCheckInScreen(
-        studentId: "2061",
-        studentName: "디버그테스트",
-      ),
+      home: NfcPocketCheckInScreen(studentId: "2061", studentName: "디버그테스트"),
     );
   }
 }

lib/function/admin_controller.dart

@@ -0,0 +1,31 @@
+// 🛠️ 관리자 대시보드의 기능(서버 통신/상태) 담당 컨트롤러.
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+class AdminController extends ChangeNotifier {
+  bool _isLoading = false;
+  bool get isLoading => _isLoading;
+
+  Future<String> resetDatabase() async {
+    _isLoading = true;
+    notifyListeners();
+
+    // 🆕 백엔드 보안 규칙에 맞추어 초기화 토큰 비밀번호 파라미터(?password=...)를 연동 주소에 매칭했습니다.
+    final url = Uri.parse('$baseUrl/reset-db?password=adminreset2010');
+
+    try {
+      final response = await http.get(url);
+      if (response.statusCode == 200) {
+        return 'DB가 깔끔하게 초기화되었습니다! (출석 번호 1번부터 시작)';
+      } else {
+        return '초기화 실패: 서버 권한 오류 (${response.statusCode})';
+      }
+    } catch (e) {
+      return '네트워크 에러: 서버와 연결할 수 없습니다.';
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+}

lib/function/dashboard_layout_controller.dart

@@ -0,0 +1,158 @@
+// 🧩 대시보드 타일 배치(위치/크기)의 서버 통신/상태 담당 컨트롤러.
+// 캔버스는 6열×4행 고정, 타일 크기는 1x1~4x4. 계정별로 서버(계정=userId)에 저장한다.
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+import '../models/dashboard_tile_layout.dart';
+
+class DashboardLayoutController extends ChangeNotifier {
+  final String userId;
+  DashboardLayoutController(this.userId);
+
+  Map<String, TileRect> _positions = {};
+  bool _isLoading = true;
+  bool _isSaving = false;
+  bool _isEditing = false;
+
+  Map<String, TileRect> get positions => _positions;
+  bool get isLoading => _isLoading;
+  bool get isSaving => _isSaving;
+  bool get isEditing => _isEditing;
+
+  void enterEditMode() {
+    _isEditing = true;
+    notifyListeners();
+  }
+
+  /// 편집 중이던 변경을 서버에 저장하지 않고 그대로 유지한 채 편집 모드만 끈다.
+  /// (저장은 [save]를 명시적으로 불러야 함 — 완료 버튼이 save+exit를 같이 호출한다.)
+  void exitEditMode() {
+    _isEditing = false;
+    notifyListeners();
+  }
+
+  /// 서버에 저장된 배치를 불러오고, 현재 화면에 보여야 할 타일 id 목록([visibleIds]) 중
+  /// 저장된 값이 없는 새 타일은 빈 칸을 찾아 1x1로 자동 배치한다.
+  Future<void> load(List<String> visibleIds) async {
+    _isLoading = true;
+    notifyListeners();
+
+    Map<String, TileRect> loaded = {};
+    try {
+      final response = await http.get(
+        Uri.parse('$baseUrl/api/dashboard/layout?userId=$userId'),
+      );
+      if (response.statusCode == 200) {
+        final data = jsonDecode(utf8.decode(response.bodyBytes));
+        final rawLayout = data['layout'];
+        if (rawLayout is List) {
+          for (final item in rawLayout) {
+            final id = item['id']?.toString();
+            if (id == null) continue;
+            final rect = TileRect.fromJson(item);
+            if (rect.isWithinCanvas) loaded[id] = rect;
+          }
+        }
+      }
+    } catch (_) {
+      // 새로고침 실패는 조용히 무시하고 기본 배치로 대체한다.
+    }
+
+    _positions = _fillDefaults(loaded, visibleIds);
+    _isLoading = false;
+    notifyListeners();
+  }
+
+  Map<String, TileRect> _fillDefaults(
+    Map<String, TileRect> existing,
+    List<String> ids,
+  ) {
+    final Map<String, TileRect> result = {};
+    for (final id in ids) {
+      final saved = existing[id];
+      if (saved != null && !_collidesWithAny(result, saved, null)) {
+        result[id] = saved;
+      }
+    }
+    for (final id in ids) {
+      if (result.containsKey(id)) continue;
+      final spot = _findFirstFit(result, 1, 1);
+      if (spot != null) {
+        result[id] = TileRect(x: spot.$1, y: spot.$2, w: 1, h: 1);
+      }
+      // 캔버스(6x4=24칸)가 꽉 찼으면 자리를 못 찾을 수도 있음 — 그 타일은 화면에 안 보이게 됨.
+    }
+    return result;
+  }
+
+  bool _collidesWithAny(
+    Map<String, TileRect> placed,
+    TileRect candidate,
+    String? ignoreId,
+  ) {
+    for (final entry in placed.entries) {
+      if (entry.key == ignoreId) continue;
+      if (entry.value.overlaps(candidate)) return true;
+    }
+    return false;
+  }
+
+  (int, int)? _findFirstFit(Map<String, TileRect> placed, int w, int h) {
+    for (int y = 0; y <= kGridRows - h; y++) {
+      for (int x = 0; x <= kGridCols - w; x++) {
+        final candidate = TileRect(x: x, y: y, w: w, h: h);
+        if (!_collidesWithAny(placed, candidate, null)) return (x, y);
+      }
+    }
+    return null;
+  }
+
+  bool _fits(String movingId, TileRect candidate) {
+    if (!candidate.isWithinCanvas) return false;
+    return !_collidesWithAny(_positions, candidate, movingId);
+  }
+
+  /// 타일을 (newX, newY)로 옮긴다. 다른 타일과 겹치거나 캔버스를 벗어나면 무시하고 false 반환.
+  bool tryMove(String id, int newX, int newY) {
+    final cur = _positions[id];
+    if (cur == null) return false;
+    final candidate = cur.copyWith(x: newX, y: newY);
+    if (!_fits(id, candidate)) return false;
+    _positions = {..._positions, id: candidate};
+    notifyListeners();
+    return true;
+  }
+
+  /// 타일 크기를 (newW, newH)로 바꾼다. 다른 타일과 겹치거나 4x4/캔버스를 벗어나면 무시.
+  bool tryResize(String id, int newW, int newH) {
+    final cur = _positions[id];
+    if (cur == null) return false;
+    final candidate = cur.copyWith(w: newW, h: newH);
+    if (!_fits(id, candidate)) return false;
+    _positions = {..._positions, id: candidate};
+    notifyListeners();
+    return true;
+  }
+
+  Future<void> save() async {
+    _isSaving = true;
+    notifyListeners();
+    try {
+      final layout = _positions.entries
+          .map((e) => e.value.toJson(e.key))
+          .toList();
+      await http.post(
+        Uri.parse('$baseUrl/api/dashboard/layout'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"userId": userId, "layout": layout}),
+      );
+    } catch (_) {
+      // 저장 실패해도 로컬 배치는 유지 — 다음에 다시 시도 가능.
+    } finally {
+      _isSaving = false;
+      _isEditing = false;
+      notifyListeners();
+    }
+  }
+}

lib/function/device_checkout_controller.dart

@@ -0,0 +1,48 @@
+// 📱 스마트기기(패드) 반출 신청 화면의 기능(서버 통신/상태) 담당 컨트롤러.
+// NFC가 안 되는 패드용 대체 절차 — 시작~종료 시각과 사용 목적을 적어 신청하면
+// 선생님 승인 후 저울(아두이노)이 실제 픽업/반납 여부를 감시한다 (하드웨어는 나중에 붙임).
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+class DeviceCheckoutController extends ChangeNotifier {
+  bool _isSubmitting = false;
+  bool get isSubmitting => _isSubmitting;
+
+  /// ➕ 반출 요청 제출. (성공여부, 메시지)를 반환한다.
+  Future<(bool success, String message)> submitRequest({
+    required String studentId,
+    required String studentName,
+    required String purpose,
+    required String startTime,
+    required String endTime,
+  }) async {
+    _isSubmitting = true;
+    notifyListeners();
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/device-checkout/request'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "studentId": studentId,
+          "studentName": studentName,
+          "purpose": purpose,
+          "startTime": startTime,
+          "endTime": endTime,
+        }),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      if (response.statusCode == 200 && result['status'] == 'success') {
+        return (true, '${result['message'] ?? '요청이 접수되었습니다.'}');
+      } else {
+        return (false, '${result['message'] ?? '요청 실패'}');
+      }
+    } catch (e) {
+      return (false, '네트워크 에러: $e');
+    } finally {
+      _isSubmitting = false;
+      notifyListeners();
+    }
+  }
+}

lib/function/device_checkout_ledger_controller.dart

@@ -0,0 +1,100 @@
+// 📋 선생님용 "스마트기기 반출 대장" 화면의 기능(서버 통신/상태) 담당 컨트롤러.
+import 'dart:async';
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+class DeviceCheckoutLedgerController extends ChangeNotifier {
+  List<dynamic> _requests = [];
+  bool _isLoading = true;
+  bool _isWorking = false;
+  Timer? _timer;
+  bool _disposed = false;
+
+  List<dynamic> get requests => _requests;
+  bool get isLoading => _isLoading;
+  bool get isWorking => _isWorking;
+
+  void _safeNotify() {
+    if (!_disposed) notifyListeners();
+  }
+
+  void init() {
+    fetchAll();
+    _timer = Timer.periodic(const Duration(seconds: 5), (_) => fetchAll());
+  }
+
+  @override
+  void dispose() {
+    _disposed = true;
+    _timer?.cancel();
+    super.dispose();
+  }
+
+  Future<void> fetchAll() async {
+    try {
+      final response = await http.get(
+        Uri.parse('$baseUrl/api/device-checkout/list'),
+      );
+      if (response.statusCode == 200) {
+        final data = jsonDecode(utf8.decode(response.bodyBytes));
+        _requests = data['requests'] ?? [];
+      }
+    } catch (_) {
+      // 새로고침 실패는 조용히 무시하고 마지막으로 받아온 목록을 유지한다.
+    } finally {
+      _isLoading = false;
+      _safeNotify();
+    }
+  }
+
+  // ✅ 승인 시 승인한 선생님 계정을 함께 보낸다 (대장에 "OOO 선생님이 허용했습니다" 표시 +
+  // 미반납 알림을 그 선생님에게만 보내기 위함).
+  Future<(bool success, String message)> approve(
+    int requestId, {
+    required String teacherId,
+    required String teacherName,
+  }) async {
+    return _postAction('/api/device-checkout/approve', {
+      "requestId": requestId,
+      "teacherId": teacherId,
+      "teacherName": teacherName,
+    });
+  }
+
+  Future<(bool success, String message)> reject(int requestId) async {
+    return _postAction('/api/device-checkout/reject', {"requestId": requestId});
+  }
+
+  // 🖐️ [하드웨어 자동 감지 전까지 임시] 선생님이 기기를 실제로 돌려받았을 때 누르는 버튼.
+  Future<(bool success, String message)> confirmReturn(int requestId) async {
+    return _postAction('/api/device-checkout/return', {"requestId": requestId});
+  }
+
+  Future<(bool success, String message)> _postAction(
+    String path,
+    Map<String, dynamic> body,
+  ) async {
+    _isWorking = true;
+    _safeNotify();
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl$path'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode(body),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      if (response.statusCode == 200 && result['status'] == 'success') {
+        await fetchAll();
+        return (true, '${result['message'] ?? '처리되었습니다.'}');
+      }
+      return (false, '${result['message'] ?? '처리 실패'}');
+    } catch (e) {
+      return (false, '네트워크 에러: $e');
+    } finally {
+      _isWorking = false;
+      _safeNotify();
+    }
+  }
+}

lib/function/excel_file_picker.dart

@@ -0,0 +1,4 @@
+// 📄 엑셀 파일 하나를 골라 바이트로 돌려주는 진입점. 실제 구현은 플랫폼별로 갈라진다
+// (web은 file_picker의 웹 구현체에 pickFile(s)가 아직 없어서 dart:html로 직접 처리).
+export 'excel_file_picker_io.dart'
+    if (dart.library.html) 'excel_file_picker_web.dart';

lib/function/excel_file_picker_io.dart

@@ -0,0 +1,13 @@
+// 📄 [비웹 플랫폼] file_picker로 엑셀 파일 하나를 고른다.
+import 'dart:typed_data';
+import 'package:file_picker/file_picker.dart';
+
+/// 사용자가 엑셀(.xlsx) 파일을 고르면 바이트를 돌려준다. 취소하면 null.
+Future<Uint8List?> pickExcelFileBytes() async {
+  final files = await FilePicker.pickFiles(
+    type: FileType.custom,
+    allowedExtensions: ['xlsx'],
+  );
+  if (files.isEmpty) return null;
+  return files.first.readAsBytes();
+}

lib/function/excel_file_picker_web.dart

@@ -0,0 +1,31 @@
+// 📄 [웹 전용] file_picker의 웹 구현체에 pickFile(s)가 아직 없어서(UnimplementedError),
+// 숨겨진 <input type="file">를 직접 만들어 처리한다.
+import 'dart:async';
+import 'dart:js_interop';
+import 'dart:typed_data';
+import 'package:web/web.dart' as web;
+
+/// 사용자가 엑셀(.xlsx) 파일을 고르면 바이트를 돌려준다. 취소하면 null.
+Future<Uint8List?> pickExcelFileBytes() async {
+  final completer = Completer<web.File?>();
+  final input = web.HTMLInputElement()
+    ..type = 'file'
+    ..accept = '.xlsx'
+    ..style.display = 'none';
+  // 문서에 실제로 붙어있지 않으면 일부 브라우저/자동화 환경에서 change 이벤트가
+  // 안정적으로 안 잡힌다 — 그래서 body에 잠깐 붙였다가 끝나면 반드시 제거한다.
+  web.document.body!.append(input);
+
+  input.onchange = (web.Event event) {
+    final file = input.files?.item(0);
+    input.remove();
+    completer.complete(file);
+  }.toJS;
+
+  input.click();
+  final file = await completer.future;
+  if (file == null) return null;
+
+  final buffer = await file.arrayBuffer().toDart;
+  return buffer.toDart.asUint8List();
+}

lib/function/login_controller.dart

@@ -0,0 +1,206 @@
+// 🔑 로그인 화면의 기능(서버 통신/인증 분기 로직) 담당 컨트롤러.
+// 위젯/BuildContext/다이얼로그 코드는 없다 — 전부 UI 파일(lib/screens/login_screen.dart) 몫.
+import 'dart:convert';
+import 'package:flutter/foundation.dart' show ChangeNotifier, kIsWeb;
+import 'package:http/http.dart' as http;
+import 'package:firebase_messaging/firebase_messaging.dart';
+import '../config.dart';
+
+enum LoginOutcome { masterSuccess, needsPasswordChange, success, error }
+
+/// 로그인 시도 결과. UI는 [outcome]만 보고 어떤 화면/다이얼로그를 띄울지 분기한다.
+class LoginResult {
+  final LoginOutcome outcome;
+  final String? role;
+  final String? studentId;
+  final String? name;
+  final bool isDeviceMatched;
+  final String? errorMessage;
+
+  const LoginResult.masterSuccess({required this.studentId, required this.name})
+    : outcome = LoginOutcome.masterSuccess,
+      role = null,
+      isDeviceMatched = true,
+      errorMessage = null;
+
+  const LoginResult.needsPasswordChange({
+    required this.studentId,
+    required this.name,
+    required this.role,
+    required this.isDeviceMatched,
+  }) : outcome = LoginOutcome.needsPasswordChange,
+       errorMessage = null;
+
+  const LoginResult.success({
+    required this.role,
+    required this.studentId,
+    required this.name,
+    required this.isDeviceMatched,
+  }) : outcome = LoginOutcome.success,
+       errorMessage = null;
+
+  const LoginResult.error(this.errorMessage)
+    : outcome = LoginOutcome.error,
+      role = null,
+      studentId = null,
+      name = null,
+      isDeviceMatched = false;
+}
+
+class LoginController extends ChangeNotifier {
+  bool _isLoading = false;
+  bool get isLoading => _isLoading;
+
+  Future<LoginResult> login(String id, String password) async {
+    if (id.isEmpty || password.isEmpty) {
+      return const LoginResult.error('학번과 비밀번호를 모두 입력해 주세요.');
+    }
+
+    // 🔥 [개발자 마스터 계정]
+    if (id == "2061") {
+      if (password == "happy9642!") {
+        return const LoginResult.masterSuccess(studentId: "2061", name: "훗춧가룻");
+      } else {
+        return const LoginResult.error('개발자 계정의 마스터 비밀번호가 올바르지 않습니다.');
+      }
+    }
+
+    _isLoading = true;
+    notifyListeners();
+
+    try {
+      String deviceUuid = await getDeviceUuid();
+      String fcmToken = "";
+
+      try {
+        fcmToken = kIsWeb
+            ? await FirebaseMessaging.instance.getToken(
+                    vapidKey: webVapidKey,
+                  ) ??
+                  ""
+            : await FirebaseMessaging.instance.getToken() ?? "";
+      } catch (e) {
+        // 파이어베이스 미설정 등 - 로그인 자체는 계속 진행
+      }
+
+      final response = await http.post(
+        Uri.parse('$baseUrl/login'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "studentId": id,
+          "password": password,
+          "deviceUuid": deviceUuid,
+          "fcmToken": fcmToken,
+        }),
+      );
+
+      final resData = jsonDecode(utf8.decode(response.bodyBytes));
+
+      if (response.statusCode == 200) {
+        String role = '';
+        String name = '';
+        String studentId = '';
+        int isFirstLogin = 0;
+
+        var userObj = resData['user'];
+        if (userObj != null) {
+          role = userObj['role']?.toString() ?? '';
+          name =
+              userObj['name']?.toString() ??
+              userObj['studentName']?.toString() ??
+              userObj['student_name']?.toString() ??
+              '';
+          studentId =
+              userObj['studentId']?.toString() ??
+              userObj['student_id']?.toString() ??
+              id;
+
+          var rawFirst = userObj['isFirstLogin'] ?? userObj['is_first_login'];
+          isFirstLogin = (rawFirst is bool)
+              ? (rawFirst ? 1 : 0)
+              : (int.tryParse(rawFirst.toString()) ?? 0);
+        } else {
+          role = resData['role']?.toString() ?? '';
+          name =
+              resData['name']?.toString() ??
+              resData['studentName']?.toString() ??
+              '';
+          studentId = resData['studentId']?.toString() ?? id;
+
+          var rawFirst = resData['isFirstLogin'] ?? resData['is_first_login'];
+          isFirstLogin = (rawFirst is bool)
+              ? (rawFirst ? 1 : 0)
+              : (int.tryParse(rawFirst.toString()) ?? 0);
+        }
+
+        if (name.trim().isEmpty) {
+          name = "알수없음";
+        }
+
+        // 🆕 서버 응답 데이터에서 기기 일치 여부 추출하기
+        // (서버가 주는 Key 이름에 맞춰서 데이터를 가져옵니다. 아래 항목 중 맞는 게 알아서 들어감)
+        bool isDeviceMatched =
+            resData['isDeviceMatched'] ??
+            resData['isUuidMatched'] ??
+            resData['is_matched'] ??
+            (userObj != null
+                ? (userObj['isDeviceMatched'] ?? userObj['is_matched'] ?? false)
+                : false);
+
+        if (isFirstLogin == 1) {
+          return LoginResult.needsPasswordChange(
+            studentId: studentId,
+            name: name,
+            role: role,
+            isDeviceMatched: isDeviceMatched,
+          );
+        }
+
+        return LoginResult.success(
+          role: role,
+          studentId: studentId,
+          name: name,
+          isDeviceMatched: isDeviceMatched,
+        );
+      } else {
+        String errorMsg = '로그인에 실패했습니다.';
+        if (resData is Map) {
+          errorMsg =
+              resData['detail']?.toString() ??
+              resData['message']?.toString() ??
+              errorMsg;
+        }
+        return LoginResult.error(errorMsg);
+      }
+    } catch (e) {
+      return LoginResult.error('서버와 연결할 수 없습니다. 서버 상태를 확인하세요!\n($e)');
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+
+  /// 🛠️ 초기 비밀번호 변경. (성공여부, 메시지)를 반환한다.
+  Future<(bool success, String message)> changePassword({
+    required String studentId,
+    required String newPassword,
+  }) async {
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/users/change-password'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"studentId": studentId, "newPassword": newPassword}),
+      );
+
+      final resData = jsonDecode(utf8.decode(response.bodyBytes));
+
+      if (response.statusCode == 200 && resData['status'] == 'success') {
+        return (true, '비밀번호가 변경되었습니다!');
+      } else {
+        return (false, '실패: ${resData['message']}');
+      }
+    } catch (e) {
+      return (false, '서버 에러 발생: $e');
+    }
+  }
+}

lib/function/nfc_pocket_checkin_controller.dart

@@ -0,0 +1,391 @@
+// 📲 자습실 NFC 출석체크 화면의 기능(NFC 세션/서버 통신/백그라운드 감시 연동) 담당 컨트롤러.
+// 다이얼로그/스낵바 등 실제 위젯 표시는 UI 파일(lib/nfc_poccket_checkin_screen.dart)의
+// 콜백을 통해서만 이루어진다 — 이 파일엔 위젯 코드가 없다.
+import 'dart:async';
+import 'dart:convert';
+import 'dart:io' show Platform;
+import 'package:flutter/foundation.dart' show ChangeNotifier, kIsWeb;
+import 'package:flutter/services.dart' show EventChannel, MethodChannel;
+import 'package:flutter_background_service/flutter_background_service.dart';
+import 'package:http/http.dart' as http;
+import 'package:nfc_manager/nfc_manager.dart';
+import 'package:nfc_manager/nfc_manager_android.dart';
+import 'package:nfc_manager_ndef/nfc_manager_ndef.dart';
+import 'package:permission_handler/permission_handler.dart';
+import '../config.dart' show baseUrl;
+
+// 🛡️ iOS 근접센서 감시용 네이티브 채널 (ios/Runner/ProximityMonitorPlugin.swift 참고).
+// 조도 센서 API가 없는 iOS에서, 통화 중 화면이 꺼지는 것과 같은 원리인
+// 근접센서로 "주머니 안/밖" 상태 변화를 감지해 대체한다.
+const MethodChannel _proximityMethodChannel = MethodChannel(
+  'proximity_monitor',
+);
+const EventChannel _proximityEventChannel = EventChannel(
+  'proximity_monitor/events',
+);
+
+enum WatchMessageLevel { info, success, warning, error }
+
+class NfcPocketCheckinController extends ChangeNotifier {
+  final String studentId;
+  final String studentName;
+
+  /// 스낵바로 보여줄 일반 메시지 이벤트. UI가 레벨에 맞는 색상을 정해서 띄운다.
+  final void Function(String text, WatchMessageLevel level) onMessage;
+
+  /// 출석(태깅) 성공 시 축하 팝업을 띄우기 위한 콜백.
+  final void Function(String pocketNumber) onCheckInSuccess;
+
+  /// 무단반출 감지 시 경고 팝업을 띄우기 위한 콜백.
+  final void Function(String? pocketNumber) onViolationDetected;
+
+  /// iOS 출석 성공 직후, "가이드 접근"을 켜달라고 안내하는 팝업을 띄우기 위한 콜백.
+  /// (안드로이드는 화면이 꺼져도 백그라운드 서비스가 동작하니 이 안내가 필요 없다.)
+  final void Function(String pocketNumber) onNeedGuidedAccessSetup;
+
+  NfcPocketCheckinController({
+    required this.studentId,
+    required this.studentName,
+    required this.onMessage,
+    required this.onCheckInSuccess,
+    required this.onViolationDetected,
+    required this.onNeedGuidedAccessSetup,
+  });
+
+  bool _isProcessing = false; // 중복 태깅 및 연타 방지 플래그
+  bool _isWatching = false; // 백그라운드 조도 센서(또는 iOS 근접센서) 감시가 진행 중인지 여부
+  bool _isIosProximityWatch = false; // 지금 진행 중인 감시가 iOS 근접센서 방식인지 여부 (체크아웃 분기용)
+  String _statusMessage = "주머니의 NFC 스티커에 폰 뒷면을 대어주세요.";
+  String? _activePocketNumber;
+
+  StreamSubscription<Map<String, dynamic>?>? _violationSub;
+  StreamSubscription<Map<String, dynamic>?>? _checkedOutSub;
+
+  StreamSubscription<dynamic>? _proximitySub;
+  bool? _proximityBaselineNear; // 감시 시작 직후(주머니에 넣은 직후) 기준 상태
+  bool _proximityViolated = false;
+
+  bool get isProcessing => _isProcessing;
+  bool get isWatching => _isWatching;
+  String get statusMessage => _statusMessage;
+  String? get activePocketNumber => _activePocketNumber;
+
+  bool get watchServiceSupported => !kIsWeb && Platform.isAndroid;
+
+  /// iOS는 진짜 백그라운드 감시가 불가능해서, "가이드 접근" 모드로 화면을 못 잠그게 한 뒤
+  /// 근접센서로 흉내내는 방식만 지원한다 (자세한 이유는 사용자와의 대화 참고).
+  bool get iosProximityWatchSupported => !kIsWeb && Platform.isIOS;
+
+  void init() {
+    _startNfcSession();
+    if (watchServiceSupported) {
+      // 화면이 열려있는 동안은 실시간으로 위반 알림을 받아 팝업을 띄운다.
+      // 무단 반출이 한 번 감지되면 "신뢰된 감시 세션"은 끝난 것으로 보고,
+      // 다음 태깅은 체크아웃이 아니라 새 출석(재출석)으로 처리되도록 감시 상태를 해제한다.
+      _violationSub = FlutterBackgroundService()
+          .on('violation_detected')
+          .listen((event) {
+            _isWatching = false;
+            notifyListeners();
+            onViolationDetected(event?['pocketNumber']?.toString());
+          });
+      // 🏫 하교 처리 등으로 반출이 허용된 상태에서 폰을 꺼내면, 위반이 아니라 정상 회수로 처리된다.
+      _checkedOutSub = FlutterBackgroundService().on('checked_out').listen((
+        event,
+      ) {
+        _isWatching = false;
+        _activePocketNumber = null;
+        _statusMessage = "폰을 회수했습니다. 수고하셨습니다!";
+        notifyListeners();
+        onMessage("폰이 정상적으로 회수되었습니다.", WatchMessageLevel.success);
+      });
+    }
+  }
+
+  @override
+  void dispose() {
+    // 화면을 나갈 때 NFC 감지만 종료. 백그라운드 감시 서비스는 화면과 무관하게 계속 동작해야 하므로 건드리지 않는다.
+    NfcManager.instance.stopSession();
+    _violationSub?.cancel();
+    _checkedOutSub?.cancel();
+    // iOS 근접센서 감시는 (안드로이드와 달리) 이 컨트롤러 안에서 직접 도는 것이라,
+    // 화면을 나가면 같이 정리해야 한다 (안 그러면 dispose된 ChangeNotifier에 notifyListeners 호출로 에러남).
+    _proximitySub?.cancel();
+    if (_isIosProximityWatch) {
+      _proximityMethodChannel.invokeMethod('stop').catchError((_) {});
+    }
+    super.dispose();
+  }
+
+  /// 📡 NFC 감지 세션 시작
+  void _startNfcSession() async {
+    bool isAvailable = await NfcManager.instance.isAvailable();
+    if (!isAvailable) {
+      _statusMessage = "이 스마트폰은 NFC 기능이 꺼져있거나 지원되지 않습니다.";
+      notifyListeners();
+      return;
+    }
+
+    NfcManager.instance.startSession(
+      pollingOptions: {NfcPollingOption.iso14443, NfcPollingOption.iso15693},
+      onDiscovered: (NfcTag tag) async {
+        if (_isProcessing) return; // 이미 처리 중이면 연속 태그 무시 (쿨다운)
+
+        // 이미 감시 중일 때 다시 태깅하면 "폰 회수(체크아웃)"로 처리한다.
+        if (_isWatching) {
+          await _checkOut();
+          return;
+        }
+
+        _isProcessing = true;
+        _statusMessage = "태그 인식 완료! 서버에 출석 전송 중...";
+        notifyListeners();
+
+        try {
+          // 1. NFC 태그에서 주머니 번호 데이터 읽기
+          Ndef? ndef = Ndef.from(tag);
+          String rawPocketData = "";
+
+          if (ndef != null && ndef.cachedMessage != null) {
+            for (var record in ndef.cachedMessage!.records) {
+              rawPocketData += String.fromCharCodes(record.payload);
+            }
+          }
+
+          // 텍스트 헤더 정리 (예: "\x02enPOCKET_17" -> "POCKET_17")
+          String cleanPocketNumber = "POCKET_UNKNOWN";
+          if (rawPocketData.contains("POCKET_")) {
+            int index = rawPocketData.indexOf("POCKET_");
+            cleanPocketNumber = rawPocketData.substring(index).trim();
+          } else if (rawPocketData.isNotEmpty) {
+            cleanPocketNumber = rawPocketData.trim();
+          }
+
+          // 2. 파이썬 서버로 출석 정보 보내기 (복제 방지용 태그 UID도 함께 전송)
+          await _sendAttendanceToBackend(
+            cleanPocketNumber,
+            tagUid: _getTagUid(tag),
+          );
+        } catch (e) {
+          onMessage("태그 읽기 실패: $e", WatchMessageLevel.error);
+        } finally {
+          // 3초 후 연타 방지 해제 (쿨다운)
+          await Future.delayed(const Duration(seconds: 3));
+          _isProcessing = false;
+          notifyListeners();
+        }
+      },
+    );
+  }
+
+  /// 태그의 공장 각인 하드웨어 UID를 16진수 문자열로 반환한다 (쓰기로 바꿀 수 없어 복제 방지 기준으로 씀).
+  String? _getTagUid(NfcTag tag) {
+    final id = NfcTagAndroid.from(tag)?.id;
+    if (id == null || id.isEmpty) return null;
+    return id
+        .map((b) => b.toRadixString(16).padLeft(2, '0'))
+        .join()
+        .toUpperCase();
+  }
+
+  /// 🚚 파이썬 백엔드로 출석 데이터 HTTP POST 전송
+  Future<void> _sendAttendanceToBackend(
+    String pocketNumber, {
+    String? tagUid,
+  }) async {
+    final url = Uri.parse("$baseUrl/attendance");
+
+    try {
+      final response = await http.post(
+        url,
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "studentId": studentId,
+          "studentName": studentName,
+          "pocketNumber": pocketNumber, // 주머니 번호 전달
+          "tagUid": tagUid, // 🔒 서버가 태그 진위를 대조할 하드웨어 UID
+        }),
+      );
+
+      if (response.statusCode == 200) {
+        final result = jsonDecode(utf8.decode(response.bodyBytes));
+        if (result["status"] == "success") {
+          onCheckInSuccess(pocketNumber);
+          if (watchServiceSupported) {
+            await _startBackgroundWatch(pocketNumber);
+          } else if (iosProximityWatchSupported) {
+            // iOS는 바로 감시를 못 켜고, 먼저 "가이드 접근"을 켜달라고 안내해야 한다.
+            onNeedGuidedAccessSetup(pocketNumber);
+          } else {
+            onMessage("ℹ️ 이 기기는 백그라운드 감시를 지원하지 않습니다.", WatchMessageLevel.info);
+          }
+        } else {
+          onMessage("출석 실패: ${result['message']}", WatchMessageLevel.warning);
+        }
+      } else {
+        onMessage(
+          "서버 에러 (코드: ${response.statusCode})",
+          WatchMessageLevel.error,
+        );
+      }
+    } catch (e) {
+      onMessage("서버 연결 실패: $e", WatchMessageLevel.error);
+    }
+  }
+
+  // -----------------------------------------------------------------------
+  // 🛡️ 주머니 제출 모드: 화면이 꺼져도 백그라운드 서비스가 조도 센서로 감시
+  // -----------------------------------------------------------------------
+
+  /// NFC 태깅 성공 직후 호출. 배터리 최적화 예외를 한 번 요청한 뒤 백그라운드 감시 서비스를 시작한다.
+  Future<void> _startBackgroundWatch(String pocketNumber) async {
+    if (!watchServiceSupported) return;
+
+    // 배터리 최적화 예외 요청 (이미 허용되어 있으면 시스템이 알아서 다이얼로그를 건너뜀)
+    final batteryStatus = await Permission.ignoreBatteryOptimizations.status;
+    if (!batteryStatus.isGranted) {
+      await Permission.ignoreBatteryOptimizations.request();
+    }
+
+    final service = FlutterBackgroundService();
+    if (!await service.isRunning()) {
+      await service.startService();
+    }
+    service.invoke('start_watch', {
+      "studentId": studentId,
+      "studentName": studentName,
+      "pocketNumber": pocketNumber,
+    });
+
+    _isWatching = true;
+    _activePocketNumber = pocketNumber;
+    _statusMessage = "백그라운드에서 감시 중입니다. 화면을 꺼도 계속 감시돼요.";
+    notifyListeners();
+  }
+
+  /// 감시 중일 때 다시 태깅하면 폰을 회수한 것으로 보고 감시를 종료한다.
+  Future<void> _checkOut() async {
+    if (_isIosProximityWatch) {
+      await _stopIosProximityWatch();
+    } else {
+      FlutterBackgroundService().invoke('stop_watch');
+    }
+    _isWatching = false;
+    _activePocketNumber = null;
+    _statusMessage = "폰을 회수했습니다. 감시가 종료되었습니다.";
+    notifyListeners();
+    onMessage("감시가 종료되었습니다. 수고하셨습니다!", WatchMessageLevel.success);
+  }
+
+  // -----------------------------------------------------------------------
+  // 🛡️ iOS 전용: 근접센서 + 가이드 접근으로 흉내내는 감시 모드
+  //
+  // iOS는 조도 센서 API가 없고, 앱이 백그라운드로 가면(=화면을 잠그면) 그 즉시
+  // 서스펜드되어 어떤 센서도 못 읽는다. 그래서 학생이 "가이드 접근"(iOS 키오스크 모드)을
+  // 직접 켜서 잠금을 막아야 하고, 그 위에서 근접센서로 화면만 통화 중처럼 껐다 켰다
+  // 하면서(UIDevice.isProximityMonitoringEnabled) 폰이 주머니에서 빠졌는지를 감지한다.
+  // -----------------------------------------------------------------------
+
+  /// UI가 "가이드 접근을 켰다"는 확인을 받은 뒤 호출. 근접센서 감시를 시작한다.
+  Future<void> beginIosProximityWatch(String pocketNumber) async {
+    _proximitySub?.cancel();
+    _proximityBaselineNear = null;
+    _proximityViolated = false;
+    _isIosProximityWatch = true;
+
+    _activePocketNumber = pocketNumber;
+    _isWatching = true;
+    _statusMessage = "주머니에 넣는 중...";
+    notifyListeners();
+
+    try {
+      await _proximityMethodChannel.invokeMethod('start');
+    } catch (e) {
+      onMessage("근접센서 감시 시작 실패: $e", WatchMessageLevel.error);
+      _isWatching = false;
+      _isIosProximityWatch = false;
+      notifyListeners();
+      return;
+    }
+
+    // 학생이 폰을 주머니에 넣을 시간을 준 뒤, 그 시점 상태를 기준값으로 삼는다.
+    await Future.delayed(const Duration(seconds: 4));
+
+    _statusMessage = "감시 중입니다. 화면을 잠그지 말고 주머니에 넣어주세요.";
+    notifyListeners();
+
+    _proximitySub = _proximityEventChannel.receiveBroadcastStream().listen((
+      event,
+    ) {
+      final bool isNear = event as bool;
+      if (_proximityBaselineNear == null) {
+        _proximityBaselineNear = isNear;
+        return;
+      }
+      if (_proximityViolated) return;
+      if (isNear != _proximityBaselineNear) {
+        _proximityViolated = true;
+        _handleIosPhoneRemoved(pocketNumber);
+      }
+    });
+  }
+
+  Future<void> _stopIosProximityWatch() async {
+    await _proximitySub?.cancel();
+    _proximitySub = null;
+    _isIosProximityWatch = false;
+    try {
+      await _proximityMethodChannel.invokeMethod('stop');
+    } catch (_) {
+      // 이미 감시가 꺼져 있어도 상관없으니 조용히 무시.
+    }
+  }
+
+  /// 하교 처리/반출 허용 시간대라면 조용히 감시만 종료하고, 아니면 위반으로 경고한다.
+  /// (안드로이드 백그라운드 서비스의 handlePhoneRemoved와 동일한 판정 로직)
+  Future<void> _handleIosPhoneRemoved(String pocketNumber) async {
+    await _stopIosProximityWatch();
+
+    bool isPermitted = false;
+    try {
+      final res = await http.get(
+        Uri.parse("$baseUrl/api/permissions/check?studentId=$studentId"),
+      );
+      if (res.statusCode == 200) {
+        final data = jsonDecode(utf8.decode(res.bodyBytes));
+        isPermitted = data['permitted'] == true;
+      }
+    } catch (_) {
+      isPermitted = false; // 네트워크 오류 시엔 안전하게 위반으로 처리
+    }
+
+    _isWatching = false;
+
+    if (isPermitted) {
+      _activePocketNumber = null;
+      _statusMessage = "폰을 회수했습니다. 수고하셨습니다!";
+      notifyListeners();
+      onMessage("폰이 정상적으로 회수되었습니다.", WatchMessageLevel.success);
+      return;
+    }
+
+    notifyListeners();
+    onViolationDetected(pocketNumber);
+
+    try {
+      await http.post(
+        Uri.parse("$baseUrl/attendance/violation"),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "studentId": studentId,
+          "studentName": studentName,
+          "pocketNumber": pocketNumber,
+          "type": "PHONE_REMOVED",
+          "timestamp": DateTime.now().toIso8601String(),
+        }),
+      );
+    } catch (_) {
+      // 서버 신고가 실패해도 학생에게는 이미 팝업으로 알렸으니 조용히 무시.
+    }
+  }
+}

lib/function/nfc_tag_writer_controller.dart

@@ -0,0 +1,141 @@
+// 🏷️ (관리자용) NFC 주머니 태그 쓰기 화면의 기능(NFC 세션/서버 통신/상태) 담당 컨트롤러.
+// 실제 스낵바 표시나 텍스트필드 조작은 UI 파일(lib/ui/nfc_tag_writer_screen.dart)의
+// 콜백을 통해서만 이루어진다 — 이 파일엔 위젯 코드가 없다.
+import 'dart:convert';
+import 'dart:typed_data';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import 'package:nfc_manager/nfc_manager.dart';
+import 'package:nfc_manager/nfc_manager_android.dart';
+import 'package:nfc_manager/ndef_record.dart';
+import 'package:nfc_manager_ndef/nfc_manager_ndef.dart';
+import '../config.dart';
+
+class NfcTagWriterController extends ChangeNotifier {
+  /// (메시지, 색상) — 스낵바로 보여줄 이벤트. UI가 정의해서 넘겨준다.
+  final void Function(String message, bool isError) onMessage;
+
+  /// 태그 쓰기에 성공하면 다음 스티커 번호를 제안한다. UI가 텍스트필드를 갱신한다.
+  final void Function(String nextNumber) onNextNumberSuggested;
+
+  NfcTagWriterController({
+    required this.onMessage,
+    required this.onNextNumberSuggested,
+  });
+
+  bool _isWriting = false;
+  String _statusMessage = "주머니 번호를 입력하고 '쓰기 시작'을 눌러주세요.";
+
+  bool get isWriting => _isWriting;
+  String get statusMessage => _statusMessage;
+
+  @override
+  void dispose() {
+    NfcManager.instance.stopSession();
+    super.dispose();
+  }
+
+  Future<void> startWriteSession(String number) async {
+    if (number.isEmpty) {
+      onMessage("주머니 번호를 입력해주세요.", true);
+      return;
+    }
+    final String pocketLabel = "POCKET_$number";
+
+    bool isAvailable = await NfcManager.instance.isAvailable();
+    if (!isAvailable) {
+      onMessage("NFC가 꺼져있거나 지원되지 않습니다.", true);
+      return;
+    }
+
+    _isWriting = true;
+    _statusMessage = "[$pocketLabel] 쓸 준비 완료! 스티커에 폰 뒷면을 대주세요.";
+    notifyListeners();
+
+    NfcManager.instance.startSession(
+      pollingOptions: {NfcPollingOption.iso14443, NfcPollingOption.iso15693},
+      onDiscovered: (NfcTag tag) async {
+        try {
+          final ndef = Ndef.from(tag);
+          if (ndef == null) {
+            onMessage("이 태그는 NDEF 쓰기를 지원하지 않는 종류입니다.", true);
+            return;
+          }
+          if (!ndef.isWritable) {
+            onMessage("이 태그는 쓰기 잠금(read-only) 상태입니다.", true);
+            return;
+          }
+
+          await ndef.write(
+            message: NdefMessage(records: [_createTextRecord(pocketLabel)]),
+          );
+
+          // 🔒 태그 복제 방지: 하드웨어 UID를 서버에 등록해서 이 물리 태그만 [pocketLabel]로 인정되게 한다.
+          final String? tagUid = _getTagUid(tag);
+          if (tagUid != null) {
+            await _registerTagUid(tagUid, pocketLabel);
+          }
+
+          onMessage(
+            tagUid != null
+                ? "[$pocketLabel] 쓰기 + UID 등록 성공!"
+                : "[$pocketLabel] 쓰기는 성공했지만 UID를 못 읽어 등록은 안 됐습니다.",
+            tagUid == null,
+          );
+          // 다음 스티커를 연달아 쓰기 편하도록 번호를 자동으로 1 올려준다.
+          final int? n = int.tryParse(number);
+          if (n != null) onNextNumberSuggested((n + 1).toString());
+          _statusMessage = "다음 번호를 확인하고 '쓰기 시작'을 다시 눌러주세요.";
+          notifyListeners();
+        } catch (e) {
+          onMessage("쓰기 실패: $e", true);
+        } finally {
+          await NfcManager.instance.stopSession();
+          _isWriting = false;
+          notifyListeners();
+        }
+      },
+    );
+  }
+
+  /// 태그의 공장 각인 하드웨어 UID를 16진수 문자열로 반환한다 (쓰기로 바꿀 수 없어 복제 방지 기준으로 씀).
+  String? _getTagUid(NfcTag tag) {
+    final id = NfcTagAndroid.from(tag)?.id;
+    if (id == null || id.isEmpty) return null;
+    return id
+        .map((b) => b.toRadixString(16).padLeft(2, '0'))
+        .join()
+        .toUpperCase();
+  }
+
+  /// 서버에 "이 UID는 이 주머니 번호다"를 등록한다.
+  Future<void> _registerTagUid(String tagUid, String pocketLabel) async {
+    try {
+      await http.post(
+        Uri.parse("$baseUrl/api/pockets/register"),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"tagUid": tagUid, "pocketNumber": pocketLabel}),
+      );
+    } catch (e) {
+      onMessage("서버에 UID 등록 실패: $e", true);
+    }
+  }
+
+  /// NFC Forum Text Record Type Definition에 맞춰 "언어코드+텍스트" 페이로드를 만든다.
+  NdefRecord _createTextRecord(String text) {
+    const languageCode = 'en';
+    final languageBytes = utf8.encode(languageCode);
+    final textBytes = utf8.encode(text);
+    final payload = Uint8List.fromList([
+      languageBytes.length, // 상태 바이트: UTF-8 + 언어코드 길이
+      ...languageBytes,
+      ...textBytes,
+    ]);
+    return NdefRecord(
+      typeNameFormat: TypeNameFormat.wellKnown,
+      type: Uint8List.fromList([0x54]), // 'T' = Text Record
+      identifier: Uint8List(0),
+      payload: payload,
+    );
+  }
+}

lib/function/session_store.dart

@@ -0,0 +1,66 @@
+// 🔐 "로그인 유지" 기능. 로그인 성공 시 계정 정보를 기기에 저장해두고,
+// 다음 실행 때 로그인 화면을 건너뛰고 바로 대시보드로 들어가게 한다.
+// (서버에 별도 세션/토큰 개념이 없어서, 비밀번호는 저장하지 않고 신원 정보만 저장한다.)
+import 'dart:convert';
+import 'package:shared_preferences/shared_preferences.dart';
+
+class SavedSession {
+  final String userId;
+  final String userName;
+  final String role;
+  final bool isDeviceMatched;
+
+  const SavedSession({
+    required this.userId,
+    required this.userName,
+    required this.role,
+    required this.isDeviceMatched,
+  });
+
+  Map<String, dynamic> toJson() => {
+    'userId': userId,
+    'userName': userName,
+    'role': role,
+    'isDeviceMatched': isDeviceMatched,
+  };
+
+  factory SavedSession.fromJson(Map<String, dynamic> json) => SavedSession(
+    userId: json['userId'] as String,
+    userName: json['userName'] as String,
+    role: json['role'] as String,
+    isDeviceMatched: json['isDeviceMatched'] as bool? ?? true,
+  );
+}
+
+class SessionStore {
+  static const _key = 'saved_session_v1';
+
+  static Future<void> save(SavedSession session) async {
+    try {
+      final prefs = await SharedPreferences.getInstance();
+      await prefs.setString(_key, jsonEncode(session.toJson()));
+    } catch (_) {
+      // 저장 실패해도 로그인 자체는 계속 진행 (로그인 유지만 안 될 뿐).
+    }
+  }
+
+  static Future<SavedSession?> load() async {
+    try {
+      final prefs = await SharedPreferences.getInstance();
+      final raw = prefs.getString(_key);
+      if (raw == null) return null;
+      return SavedSession.fromJson(jsonDecode(raw));
+    } catch (_) {
+      return null;
+    }
+  }
+
+  static Future<void> clear() async {
+    try {
+      final prefs = await SharedPreferences.getInstance();
+      await prefs.remove(_key);
+    } catch (_) {
+      // 무시 - 어차피 로그아웃 화면으로는 이동한다.
+    }
+  }
+}

lib/function/student_dashboard_controller.dart

@@ -0,0 +1,33 @@
+// 🎓 학생 대시보드(마스터 계정 전용 계정 강제 삭제)의 기능(서버 통신/상태) 담당 컨트롤러.
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+class StudentDashboardController extends ChangeNotifier {
+  bool _isLoading = false;
+  bool get isLoading => _isLoading;
+
+  /// 👑 마스터 계정 전용 회원 삭제 API 호출.
+  Future<(bool success, String message)> deleteUser(String userId) async {
+    _isLoading = true;
+    notifyListeners();
+    final url = Uri.parse('$baseUrl/api/users/delete/$userId');
+
+    try {
+      final response = await http.delete(url);
+      if (response.statusCode == 200) {
+        final responseData = jsonDecode(response.body);
+        return (true, '${responseData['message']}');
+      } else {
+        final errorData = jsonDecode(response.body);
+        return (false, '삭제 실패: ${errorData['detail'] ?? '알 수 없는 오류'}');
+      }
+    } catch (e) {
+      return (false, '서버와 연결할 수 없습니다. (네트워크 에러)');
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+}

lib/function/teacher_attendance_controller.dart

@@ -0,0 +1,349 @@
+// 📋 실시간 출석 현황 화면의 기능(상태/서버 통신/파생 로직) 담당 컨트롤러.
+// UI(lib/ui/teacher_attendance_page.dart)는 이 컨트롤러를 구독해서 화면만 그린다.
+// 이 파일에는 위젯/BuildContext/다이얼로그 코드가 없어야 한다 — 전부 UI 파일 몫.
+import 'dart:async';
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+// 로그의 'name' 컬럼은 백엔드에서 "학생이름 (주머니정보)" 형태로 합쳐져 저장되어 있어서
+// 이름과 주머니 번호를 분리해서 보여주려면 클라이언트에서 파싱해야 한다.
+final RegExp _logNamePattern = RegExp(r'^(.*?)\s*\(([^)]*)\)$');
+
+class TeacherAttendanceController extends ChangeNotifier {
+  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이면 미설정.
+  String?
+  _globalPermissionUntil; // 하교(12시간)/반출허용시간설정으로 전체 반출이 허용된 경우 그 만료 시각 (/api/permissions/status). null이면 비활성.
+  Timer? _timer;
+  bool _isLoading = true;
+  bool _isRefreshing = false; // 새로고침 버튼 클릭 시 잠깐 도는 표시용
+  String _filterType = "ALL"; // "ALL", "CHECKED_IN", "ABSENT"
+  String _gradeFilter = "ALL"; // "ALL", "1", "2", "3"
+  bool _disposed = false;
+
+  // ----------------------------------------------------------------
+  // UI가 읽는 공개 상태
+  // ----------------------------------------------------------------
+  bool get isLoading => _isLoading;
+  bool get isRefreshing => _isRefreshing;
+  String get filterType => _filterType;
+  String get gradeFilter => _gradeFilter;
+  String? get attendanceTime => _attendanceTime;
+  String? get globalPermissionUntil => _globalPermissionUntil;
+
+  void _safeNotify() {
+    if (!_disposed) notifyListeners();
+  }
+
+  void init() {
+    fetchAll();
+    _timer = Timer.periodic(const Duration(seconds: 3), (timer) => fetchAll());
+  }
+
+  @override
+  void dispose() {
+    _disposed = true;
+    _timer?.cancel();
+    super.dispose();
+  }
+
+  Future<void> manualRefresh() async {
+    _isRefreshing = true;
+    _safeNotify();
+    await fetchAll();
+    _isRefreshing = false;
+    _safeNotify();
+  }
+
+  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')),
+        http.get(Uri.parse('$baseUrl/api/permissions/status')),
+      ]);
+
+      final usersRes = results[0];
+      final logsRes = results[1];
+      final violationsRes = results[2];
+      final dismissalRes = results[3];
+      final attendanceTimeRes = results[4];
+      final permissionStatusRes = results[5];
+
+      if (usersRes.statusCode == 200 && logsRes.statusCode == 200) {
+        final usersData = jsonDecode(utf8.decode(usersRes.bodyBytes));
+        final logsData = jsonDecode(utf8.decode(logsRes.bodyBytes));
+
+        Map<String, dynamic> activeViolations = {};
+        if (violationsRes.statusCode == 200) {
+          final violationsData = jsonDecode(
+            utf8.decode(violationsRes.bodyBytes),
+          );
+          for (final v in (violationsData['violations'] ?? [])) {
+            activeViolations[v['student_id'].toString()] = v;
+          }
+        }
+
+        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'];
+        }
+
+        String? globalPermissionUntil;
+        if (permissionStatusRes.statusCode == 200) {
+          final permissionStatusData = jsonDecode(
+            utf8.decode(permissionStatusRes.bodyBytes),
+          );
+          if (permissionStatusData['active'] == true) {
+            globalPermissionUntil = permissionStatusData['permittedUntil'];
+          }
+        }
+
+        _roster = usersData['users'] ?? [];
+        _logs = logsData['logs'] ?? [];
+        _activeViolationsByStudentId = activeViolations;
+        _dismissedAt = dismissedAt;
+        _attendanceTime = attendanceTime;
+        _globalPermissionUntil = globalPermissionUntil;
+        _isLoading = false;
+        _safeNotify();
+      } else {
+        _isLoading = false;
+        _safeNotify();
+      }
+    } catch (e) {
+      _isLoading = false;
+      _safeNotify();
+    }
+  }
+
+  /// 🏫 하교 처리: 전체 반출 허용 + 오늘 출석 표시 기준선을 지금 시각으로 옮긴다.
+  Future<String> dismissAll() async {
+    try {
+      final response = await http.post(Uri.parse('$baseUrl/api/dismiss'));
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      await fetchAll();
+      return result['message'] ?? '하교 처리되었습니다.';
+    } catch (e) {
+      return '하교 처리 실패: $e';
+    }
+  }
+
+  /// 🚨 선생님이 특정 학생에게 지금부터 N분간 반출을 허용한다.
+  Future<String> allowRemoval(String studentId, int minutes) async {
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/violations/allow'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"studentId": studentId, "minutes": minutes}),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      await fetchAll();
+      return result['message'] ?? '처리되었습니다.';
+    } catch (e) {
+      return '반출 허용 실패: $e';
+    }
+  }
+
+  /// ⏰ 지금부터 N분간 전체 학생의 반출을 자동으로 허용한다 (쉬는시간 등).
+  Future<String> setPermissionWindow(int minutes) async {
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/permissions/window'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"minutes": minutes}),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      await fetchAll();
+      return result['message'] ?? '처리되었습니다.';
+    } catch (e) {
+      return '설정 실패: $e';
+    }
+  }
+
+  /// ⏰ 자습실 출석시간(기준 시각)을 지정한다. 이 시각 이후 태깅한 학생만 "출석 완료"로 강조 표시된다.
+  Future<String> 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));
+      await fetchAll();
+      return result['message'] ?? '처리되었습니다.';
+    } catch (e) {
+      return '출석시간 설정 실패: $e';
+    }
+  }
+
+  /// 🧪 테스트용: 하교(12시간)/반출 허용 시간 설정 등으로 켜져 있는 허용 시간대를 즉시 해제한다.
+  Future<String> resetTestPermissions() async {
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/debug/reset-permissions'),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+      await fetchAll();
+      return result['message'] ?? '처리되었습니다.';
+    } catch (e) {
+      return '초기화 실패: $e';
+    }
+  }
+
+  void setFilter(String type) {
+    _filterType = type;
+    _safeNotify();
+  }
+
+  /// 🏫 학년 필터. "ALL"이면 전체, "1"/"2"/"3"이면 그 학년만 보이게 한다.
+  void setGradeFilter(String grade) {
+    _gradeFilter = grade;
+    _safeNotify();
+  }
+
+  // ----------------------------------------------------------------
+  // 파생 로직 (출석 상태 계산)
+  // ----------------------------------------------------------------
+
+  /// "오늘 출석"의 기준선. 하교 처리를 했다면 그 시각 이후, 안 했다면 오늘 자정부터.
+  Map<String, Map<String, String>> get _todaysCheckInsByStudentId {
+    // "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.isEmpty || time.compareTo(cutoff) <= 0) {
+        continue; // 하교 처리 시각(또는 오늘 자정) 이전 기록이면 무시
+      }
+
+      final String studentId = log['student_id']?.toString() ?? '';
+      if (studentId.isEmpty) continue;
+
+      // 이미 더 최신 기록을 찾았다면(로그는 최신순 정렬) 건너뛴다.
+      if (result.containsKey(studentId)) continue;
+
+      final String rawName = log['name']?.toString() ?? '';
+      final match = _logNamePattern.firstMatch(rawName);
+      result[studentId] = {
+        'name': match != null ? match.group(1)! : rawName,
+        'pocketNumber': match != null ? match.group(2)! : '주머니 미지정',
+        'time': time,
+      };
+    }
+    return result;
+  }
+
+  /// 지금까지(오늘 이전 포함) 단 한 번이라도 태깅한 적 있는 학생 학번 집합.
+  /// (오늘 미제출인 학생 중에서도 "한 번도 태깅 안 해본 애"를 구분하기 위함)
+  Set<String> get _everCheckedInStudentIds {
+    final Set<String> ids = {};
+    for (final log in _logs) {
+      final String studentId = log['student_id']?.toString() ?? '';
+      if (studentId.isNotEmpty) ids.add(studentId);
+    }
+    return ids;
+  }
+
+  /// ⏰ 태깅 시간과 지정된 자습실 출석시간을 비교해 '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;
+    final everCheckedIn = _everCheckedInStudentIds;
+    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() ?? '',
+        'grade': u['grade'] as int?,
+        'isCheckedIn': checkIn != null,
+        'pocketNumber': checkIn?['pocketNumber'],
+        'checkInTime': checkIn?['time'],
+        'attendanceStatus': attendanceStatus,
+        'isAttendanceComplete': attendanceStatus == 'COMPLETE',
+        'hasEverCheckedIn': everCheckedIn.contains(id),
+        'hasActiveViolation': violation != null,
+        'violationPocket': violation?['pocket_number'],
+        'violationTime': violation?['time'],
+      };
+    }).toList();
+  }
+
+  List<Map<String, dynamic>> get filteredStudents {
+    var result = combinedStudentStatus;
+    if (_filterType == "CHECKED_IN") {
+      result = result.where((s) => s['isAttendanceComplete'] == true).toList();
+    } else if (_filterType == "ABSENT") {
+      result = result.where((s) => s['isAttendanceComplete'] == false).toList();
+    }
+    if (_gradeFilter != "ALL") {
+      final int? grade = int.tryParse(_gradeFilter);
+      result = result.where((s) => s['grade'] == grade).toList();
+    }
+    return result;
+  }
+
+  /// 🏫 [학년별 카테고리] filteredStudents를 학년(1~3학년) 순서로 묶는다.
+  /// 학년이 아직 지정 안 된 학생은 맨 뒤 "미배정" 그룹으로 모인다.
+  List<MapEntry<String, List<Map<String, dynamic>>>> get studentsByGrade {
+    final Map<int, List<Map<String, dynamic>>> byGrade = {};
+    final List<Map<String, dynamic>> ungraded = [];
+
+    for (final student in filteredStudents) {
+      final int? grade = student['grade'] as int?;
+      if (grade == null) {
+        ungraded.add(student);
+      } else {
+        byGrade.putIfAbsent(grade, () => []).add(student);
+      }
+    }
+
+    final sortedGrades = byGrade.keys.toList()..sort();
+    final groups = <MapEntry<String, List<Map<String, dynamic>>>>[
+      for (final grade in sortedGrades) MapEntry('$grade학년', byGrade[grade]!),
+    ];
+    if (ungraded.isNotEmpty) {
+      groups.add(MapEntry('미배정', ungraded));
+    }
+    return groups;
+  }
+}

lib/function/teacher_register_controller.dart

@@ -0,0 +1,51 @@
+// 👨‍🏫 교사 회원가입 화면의 기능(서버 통신/상태) 담당 컨트롤러.
+import 'dart:convert';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+class TeacherRegisterController extends ChangeNotifier {
+  bool _isLoading = false;
+  bool get isLoading => _isLoading;
+
+  /// (성공여부, 메시지)를 반환한다 — UI가 성공 시에만 이전 화면으로 돌아간다.
+  Future<(bool success, String message)> registerTeacher({
+    required String id,
+    required String password,
+    required String name,
+    required String secretCode,
+  }) async {
+    // 💡 테스트용 고유값 (실제 디바이스 UUID 연동 로직이 있다면 그걸 넣으세요)
+    final String dummyUuid = "TEACHER_PHONE_$id";
+
+    _isLoading = true;
+    notifyListeners();
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/users/register-teacher'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "teacherId": id,
+          "password": password,
+          "name": name,
+          "secretCode": secretCode,
+          "deviceUuid": dummyUuid,
+        }),
+      );
+
+      final res = jsonDecode(response.body);
+
+      if (response.statusCode == 200 && res['status'] == 'success') {
+        return (true, '${res['message']}');
+      } else {
+        String errorMsg = res['detail'] ?? res['message'] ?? '회원가입에 실패했습니다.';
+        return (false, errorMsg);
+      }
+    } catch (e) {
+      return (false, '서버와 통신에 실패했습니다.');
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+}

lib/function/teacher_student_management_controller.dart

@@ -0,0 +1,280 @@
+// 👥 교사용 학생 계정 관리 화면의 기능(서버 통신/상태/엑셀 일괄등록) 담당 컨트롤러.
+import 'dart:convert';
+import 'package:excel/excel.dart';
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+import '../config.dart';
+
+/// 📄 엑셀 한 줄에서 뽑아낸 학생 정보 (아직 서버에 보내기 전, 미리보기용).
+class BulkStudentRow {
+  final String studentId;
+  final String name;
+  final int? grade;
+
+  const BulkStudentRow({
+    required this.studentId,
+    required this.name,
+    this.grade,
+  });
+}
+
+/// 📊 일괄 등록 결과. [failures]는 "학번 이름: 실패사유" 형태의 문자열 목록.
+class BulkImportResult {
+  final int successCount;
+  final List<String> failures;
+
+  const BulkImportResult({required this.successCount, required this.failures});
+}
+
+class TeacherStudentManagementController extends ChangeNotifier {
+  bool _isWorking = false;
+  bool get isWorking => _isWorking;
+
+  int _bulkTotal = 0;
+  int _bulkDone = 0;
+  int get bulkTotal => _bulkTotal;
+  int get bulkDone => _bulkDone;
+
+  List<dynamic> _students = [];
+  bool _isLoadingStudents = true;
+  List<dynamic> get students => _students;
+  bool get isLoadingStudents => _isLoadingStudents;
+
+  Future<void> init() => fetchStudents();
+
+  /// 🌐 전체 학생 목록 불러오기 (학번/이름/학년/기기등록상태).
+  Future<void> fetchStudents() async {
+    _isLoadingStudents = true;
+    notifyListeners();
+    try {
+      final response = await http.get(Uri.parse('$baseUrl/api/users'));
+      if (response.statusCode == 200) {
+        final data = jsonDecode(utf8.decode(response.bodyBytes));
+        _students = data['users'] ?? [];
+      }
+    } catch (_) {
+      // 목록 새로고침 실패는 조용히 무시 — 화면엔 마지막으로 불러온 목록이 남는다.
+    } finally {
+      _isLoadingStudents = false;
+      notifyListeners();
+    }
+  }
+
+  /// 🌐 학생의 등록된 기기(스마트폰) UUID + 비밀번호(1234)를 초기화한다.
+  /// (학생이 폰을 바꿨을 때 다시 등록할 수 있게 해주는 용도)
+  Future<(bool success, String message)> resetDevice(
+    String studentId,
+    String studentName,
+  ) async {
+    _isWorking = true;
+    notifyListeners();
+    try {
+      final response = await http.post(
+        Uri.parse('$baseUrl/api/users/reset'),
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"studentId": studentId}),
+      );
+      if (response.statusCode == 200) {
+        await fetchStudents();
+        return (true, '$studentName 학생 기기 초기화 완료! (비밀번호도 1234로 초기화됨)');
+      }
+      return (false, '초기화 통신 실패');
+    } catch (e) {
+      return (false, '초기화 통신 실패: $e');
+    } finally {
+      _isWorking = false;
+      notifyListeners();
+    }
+  }
+
+  /// 📄 엑셀 파일 바이트를 파싱한다. 1행은 머리글로 보고 건너뛰며,
+  /// A열=학번, B열=이름, C열=학년(선택, 숫자) 순서를 기대한다.
+  /// 학번이나 이름이 비어있는 줄은 조용히 무시한다.
+  List<BulkStudentRow> parseExcelBytes(Uint8List bytes) {
+    final excel = Excel.decodeBytes(bytes);
+    if (excel.tables.isEmpty) return [];
+
+    final sheet = excel.tables.values.first;
+    final rows = <BulkStudentRow>[];
+
+    for (final row in sheet.rows.skip(1)) {
+      final studentId = _cellText(row.isNotEmpty ? row[0]?.value : null);
+      final name = _cellText(row.length > 1 ? row[1]?.value : null);
+      if (studentId == null || name == null) continue;
+
+      final grade = _cellToGrade(row.length > 2 ? row[2]?.value : null);
+      rows.add(BulkStudentRow(studentId: studentId, name: name, grade: grade));
+    }
+    return rows;
+  }
+
+  String? _cellText(CellValue? value) {
+    if (value == null) return null;
+    String text;
+    if (value is IntCellValue) {
+      text = value.value.toString();
+    } else if (value is DoubleCellValue) {
+      text = value.value == value.value.roundToDouble()
+          ? value.value.toInt().toString()
+          : value.value.toString();
+    } else {
+      text = value.toString().trim();
+    }
+    return text.isEmpty ? null : text;
+  }
+
+  int? _cellToGrade(CellValue? value) {
+    if (value == null) return null;
+    if (value is IntCellValue) return value.value;
+    if (value is DoubleCellValue) return value.value.round();
+    return int.tryParse(value.toString().trim());
+  }
+
+  /// ➕ 엑셀에서 뽑아낸 학생 목록을 한 명씩 순서대로 서버에 등록한다 (기본 비밀번호 1234).
+  /// 한 명 실패해도 나머지는 계속 진행하고, 마지막에 성공/실패를 모아서 돌려준다.
+  Future<BulkImportResult> bulkAddStudents(List<BulkStudentRow> rows) async {
+    _isWorking = true;
+    _bulkTotal = rows.length;
+    _bulkDone = 0;
+    notifyListeners();
+
+    int successCount = 0;
+    final failures = <String>[];
+
+    for (final row in rows) {
+      final (success, message) = await _createStudentRequest(
+        studentId: row.studentId,
+        name: row.name,
+        password: "1234",
+        grade: row.grade,
+      );
+      if (success) {
+        successCount++;
+      } else {
+        failures.add('${row.studentId} ${row.name}: $message');
+      }
+      _bulkDone++;
+      notifyListeners();
+    }
+
+    await fetchStudents();
+    _isWorking = false;
+    notifyListeners();
+    return BulkImportResult(successCount: successCount, failures: failures);
+  }
+
+  /// ➕ 학생 계정 추가. (성공여부, 메시지)를 반환한다 — UI가 성공했을 때만 입력칸을 비운다.
+  Future<(bool success, String message)> addStudentAccount({
+    required String studentId,
+    required String name,
+    required String password,
+    int? grade,
+  }) async {
+    _isWorking = true;
+    notifyListeners();
+    try {
+      final result = await _createStudentRequest(
+        studentId: studentId,
+        name: name,
+        password: password,
+        grade: grade,
+      );
+      if (result.$1) await fetchStudents();
+      return result;
+    } finally {
+      _isWorking = false;
+      notifyListeners();
+    }
+  }
+
+  /// 실제 계정 생성 HTTP 요청. isWorking 상태는 건드리지 않는다 —
+  /// 단건 등록(addStudentAccount)과 일괄 등록(bulkAddStudents) 양쪽에서
+  /// 각자 알맞은 시점에 isWorking을 관리하기 위해 분리했다.
+  Future<(bool success, String message)> _createStudentRequest({
+    required String studentId,
+    required String name,
+    required String password,
+    int? grade,
+  }) async {
+    try {
+      final url = Uri.parse('$baseUrl/api/users/create');
+      final response = await http.post(
+        url,
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({
+          "studentId": studentId,
+          "name": name,
+          "password": password,
+          "grade": grade,
+        }),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+
+      if (response.statusCode == 200 && result['status'] == 'success') {
+        return (true, '${result['message'] ?? '계정이 생성되었습니다.'}');
+      } else {
+        return (false, '생성 실패: ${result['message'] ?? '오류 발생'}');
+      }
+    } catch (e) {
+      return (false, '네트워크 에러: $e');
+    }
+  }
+
+  /// 🏫 이미 만들어진 학생 계정의 학년을 지정/변경한다. grade가 null이면 "미배정"으로 되돌린다.
+  Future<(bool success, String message)> updateStudentGrade({
+    required String studentId,
+    int? grade,
+  }) async {
+    _isWorking = true;
+    notifyListeners();
+    try {
+      final url = Uri.parse('$baseUrl/api/users/update-grade');
+      final response = await http.post(
+        url,
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"studentId": studentId, "grade": grade}),
+      );
+      final result = jsonDecode(utf8.decode(response.bodyBytes));
+
+      if (response.statusCode == 200 && result['status'] == 'success') {
+        await fetchStudents();
+        return (true, '${result['message'] ?? '학년이 지정되었습니다.'}');
+      } else {
+        return (false, '지정 실패: ${result['message'] ?? '오류 발생'}');
+      }
+    } catch (e) {
+      return (false, '네트워크 에러: $e');
+    } finally {
+      _isWorking = false;
+      notifyListeners();
+    }
+  }
+
+  /// ❌ 학생 계정 삭제.
+  Future<(bool success, String message)> deleteStudentAccount(
+    String studentId,
+  ) async {
+    _isWorking = true;
+    notifyListeners();
+    final url = Uri.parse('$baseUrl/api/users/delete');
+    try {
+      final response = await http.delete(
+        url,
+        headers: {"Content-Type": "application/json"},
+        body: jsonEncode({"studentId": studentId}),
+      );
+      if (response.statusCode == 200) {
+        final resData = jsonDecode(utf8.decode(response.bodyBytes));
+        await fetchStudents();
+        return (true, '${resData['message']}');
+      } else {
+        return (false, '삭제 실패하였습니다.');
+      }
+    } catch (e) {
+      return (false, '서버 에러 발생');
+    } finally {
+      _isWorking = false;
+      notifyListeners();
+    }
+  }
+}

lib/main_client_app.dart

@@ -6,8 +6,11 @@ import 'package:flutter/material.dart';
 import 'package:firebase_core/firebase_core.dart';
 import 'firebase_options.dart';
 import 'config.dart';
+import 'function/session_store.dart';
 import 'pocket_watch_service.dart';
-import 'screens/login_screen.dart';
+import 'theme/app_palette.dart';
+import 'ui/login_screen.dart';
+import 'ui/main_dashboard.dart';
 
 void main() async {
   WidgetsFlutterBinding.ensureInitialized();
@@ -26,9 +29,73 @@ class SchoolAttendanceApp extends StatelessWidget {
   Widget build(BuildContext context) {
     return MaterialApp(
       debugShowCheckedModeBanner: false,
-      title: '백산고등학교 학생 도우미',
-      theme: ThemeData(primarySwatch: Colors.indigo, useMaterial3: true),
-      home: const LoginScreen(), // 🚪 앱을 켜면 무조건 로그인 화면이 먼저 등장합니다.
+      title: '$schoolName 학생 도우미',
+      theme: ThemeData(
+        useMaterial3: true,
+        scaffoldBackgroundColor: AppPalette.mist,
+        colorScheme:
+            ColorScheme.fromSeed(
+              seedColor: AppPalette.ink,
+              brightness: Brightness.light,
+            ).copyWith(
+              primary: AppPalette.ink,
+              onPrimary: AppPalette.paper,
+              secondary: AppPalette.ink,
+              onSecondary: AppPalette.paper,
+              surface: AppPalette.paper,
+              onSurface: AppPalette.ink,
+            ),
+      ),
+      home: const _StartupGate(), // 🚪 저장된 로그인이 있으면 대시보드로, 없으면 로그인 화면으로.
     );
   }
 }
+
+/// 🔐 "로그인 유지" 진입점. 기기에 저장된 세션이 있는지 확인하는 동안 잠깐 로딩을 보여주고,
+/// 있으면 로그인 화면 없이 바로 대시보드로, 없으면 로그인 화면으로 보낸다.
+class _StartupGate extends StatefulWidget {
+  const _StartupGate();
+
+  @override
+  State<_StartupGate> createState() => _StartupGateState();
+}
+
+class _StartupGateState extends State<_StartupGate> {
+  SavedSession? _session;
+  bool _checked = false;
+
+  @override
+  void initState() {
+    super.initState();
+    _checkSession();
+  }
+
+  Future<void> _checkSession() async {
+    final session = await SessionStore.load();
+    if (!mounted) return;
+    setState(() {
+      _session = session;
+      _checked = true;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    if (!_checked) {
+      return Scaffold(
+        backgroundColor: AppPalette.mist,
+        body: const Center(child: CircularProgressIndicator()),
+      );
+    }
+    final session = _session;
+    if (session != null) {
+      return MainDashboard(
+        userId: session.userId,
+        userName: session.userName,
+        role: session.role,
+        isDeviceMatched: session.isDeviceMatched,
+      );
+    }
+    return const LoginScreen();
+  }
+}

lib/models/dashboard_tile_layout.dart

@@ -0,0 +1,62 @@
+// 🧩 대시보드 타일의 격자 위치/크기(1x1 ~ 4x4)를 표현하는 값 객체.
+// 전체 배치 캔버스는 가로 6칸 × 세로 4칸으로 고정한다.
+
+// 📱 [기능 보류] 데스크탑에서는 잘 나오지만, 폰처럼 화면이 작은 기기에서는
+// 6칸 고정 격자 때문에 타일이 너무 작아져 레이아웃이 깨진다.
+// 작은 화면 대응 방안을 마련하기 전까지 편집 기능을 임시로 꺼둔다.
+// (다시 켜려면 이 값만 true로 바꾸면 됨 — 관련 코드는 그대로 남겨둠)
+const bool kTileEditingEnabled = false;
+
+const int kGridCols = 6;
+const int kGridRows = 4;
+const int kMinTileSize = 1;
+const int kMaxTileSize = 4;
+
+class TileRect {
+  final int x;
+  final int y;
+  final int w;
+  final int h;
+
+  const TileRect({
+    required this.x,
+    required this.y,
+    required this.w,
+    required this.h,
+  });
+
+  factory TileRect.fromJson(Map<String, dynamic> json) => TileRect(
+    x: (json['x'] as num).toInt(),
+    y: (json['y'] as num).toInt(),
+    w: (json['w'] as num).toInt(),
+    h: (json['h'] as num).toInt(),
+  );
+
+  Map<String, dynamic> toJson(String id) => {
+    'id': id,
+    'x': x,
+    'y': y,
+    'w': w,
+    'h': h,
+  };
+
+  TileRect copyWith({int? x, int? y, int? w, int? h}) =>
+      TileRect(x: x ?? this.x, y: y ?? this.y, w: w ?? this.w, h: h ?? this.h);
+
+  bool overlaps(TileRect other) {
+    return x < other.x + other.w &&
+        x + w > other.x &&
+        y < other.y + other.h &&
+        y + h > other.y;
+  }
+
+  bool get isWithinCanvas =>
+      x >= 0 &&
+      y >= 0 &&
+      x + w <= kGridCols &&
+      y + h <= kGridRows &&
+      w >= kMinTileSize &&
+      h >= kMinTileSize &&
+      w <= kMaxTileSize &&
+      h <= kMaxTileSize;
+}

lib/nfc_poccket_checkin_screen.dart

@@ -1,397 +0,0 @@
-// 📲 자습실 NFC 출석체크 화면. 태그 인식→출석 전송 후, 배터리 최적화 예외를 요청하고
-// pocket_watch_service의 백그라운드 감시를 시작/종료(재태깅 시 체크아웃)하는 역할을 한다.
-import 'dart:async';
-import 'dart:convert';
-import 'dart:io' show Platform;
-import 'package:flutter/foundation.dart' show kIsWeb;
-import 'package:flutter/material.dart';
-import 'package:flutter_background_service/flutter_background_service.dart';
-import 'package:http/http.dart' as http;
-import 'package:nfc_manager/nfc_manager.dart';
-import 'package:nfc_manager/nfc_manager_android.dart';
-import 'package:nfc_manager_ndef/nfc_manager_ndef.dart';
-import 'package:permission_handler/permission_handler.dart';
-import 'config.dart' show baseUrl;
-
-class NfcPocketCheckInScreen extends StatefulWidget {
-  final String studentId; // 로그인된 학생 학번 (예: "2061")
-  final String studentName; // 로그인된 학생 이름 (예: "시후")
-
-  const NfcPocketCheckInScreen({
-    super.key,
-    required this.studentId,
-    required this.studentName,
-  });
-
-  @override
-  State<NfcPocketCheckInScreen> createState() => _NfcPocketCheckInScreenState();
-}
-
-class _NfcPocketCheckInScreenState extends State<NfcPocketCheckInScreen> {
-  bool _isProcessing = false; // 중복 태깅 및 연타 방지 플래그
-  bool _isWatching = false; // 백그라운드 조도 센서 감시가 진행 중인지 여부
-  String _statusMessage = "주머니의 NFC 스티커에 폰 뒷면을 대어주세요.";
-  String? _activePocketNumber;
-
-  StreamSubscription<Map<String, dynamic>?>? _violationSub;
-  StreamSubscription<Map<String, dynamic>?>? _checkedOutSub;
-  bool _isDialogOpen = false; // 출석/위반 팝업이 겹쳐서 뜨는 것을 막기 위한 플래그
-
-  bool get _watchServiceSupported => !kIsWeb && Platform.isAndroid;
-
-  @override
-  void initState() {
-    super.initState();
-    _startNfcSession();
-    if (_watchServiceSupported) {
-      // 화면이 열려있는 동안은 실시간으로 위반 알림을 받아 팝업을 띄운다.
-      // 무단 반출이 한 번 감지되면 "신뢰된 감시 세션"은 끝난 것으로 보고,
-      // 다음 태깅은 체크아웃이 아니라 새 출석(재출석)으로 처리되도록 감시 상태를 해제한다.
-      _violationSub = FlutterBackgroundService().on('violation_detected').listen((
-        event,
-      ) {
-        if (!mounted) return;
-        setState(() => _isWatching = false);
-        _showViolationDialog(event?['pocketNumber']?.toString());
-      });
-      // 🏫 하교 처리 등으로 반출이 허용된 상태에서 폰을 꺼내면, 위반이 아니라 정상 회수로 처리된다.
-      _checkedOutSub = FlutterBackgroundService().on('checked_out').listen((event) {
-        if (!mounted) return;
-        setState(() {
-          _isWatching = false;
-          _activePocketNumber = null;
-          _statusMessage = "✅ 폰을 회수했습니다. 수고하셨습니다!";
-        });
-        _showSnackBar("✅ 폰이 정상적으로 회수되었습니다.", Colors.green);
-      });
-    }
-  }
-
-  @override
-  void dispose() {
-    // 화면을 나갈 때 NFC 감지만 종료. 백그라운드 감시 서비스는 화면과 무관하게 계속 동작해야 하므로 건드리지 않는다.
-    NfcManager.instance.stopSession();
-    _violationSub?.cancel();
-    _checkedOutSub?.cancel();
-    super.dispose();
-  }
-
-  /// 📡 NFC 감지 세션 시작
-  void _startNfcSession() async {
-    bool isAvailable = await NfcManager.instance.isAvailable();
-    if (!isAvailable) {
-      setState(() {
-        _statusMessage = "❌ 이 스마트폰은 NFC 기능이 꺼져있거나 지원되지 않습니다.";
-      });
-      return;
-    }
-
-    NfcManager.instance.startSession(
-      pollingOptions: {NfcPollingOption.iso14443, NfcPollingOption.iso15693},
-      onDiscovered: (NfcTag tag) async {
-        if (_isProcessing) return; // 이미 처리 중이면 연속 태그 무시 (쿨다운)
-
-        // 이미 감시 중일 때 다시 태깅하면 "폰 회수(체크아웃)"로 처리한다.
-        if (_isWatching) {
-          await _checkOut();
-          return;
-        }
-
-        setState(() {
-          _isProcessing = true;
-          _statusMessage = "⏳ 태그 인식 완료! 서버에 출석 전송 중...";
-        });
-
-        try {
-          // 1. NFC 태그에서 주머니 번호 데이터 읽기
-          Ndef? ndef = Ndef.from(tag);
-          String rawPocketData = "";
-
-          if (ndef != null && ndef.cachedMessage != null) {
-            for (var record in ndef.cachedMessage!.records) {
-              rawPocketData += String.fromCharCodes(record.payload);
-            }
-          }
-
-          // 텍스트 헤더 정리 (예: "\x02enPOCKET_17" -> "POCKET_17")
-          String cleanPocketNumber = "POCKET_UNKNOWN";
-          if (rawPocketData.contains("POCKET_")) {
-            int index = rawPocketData.indexOf("POCKET_");
-            cleanPocketNumber = rawPocketData.substring(index).trim();
-          } else if (rawPocketData.isNotEmpty) {
-            cleanPocketNumber = rawPocketData.trim();
-          }
-
-          // 2. 파이썬 서버로 출석 정보 보내기 (복제 방지용 태그 UID도 함께 전송)
-          await _sendAttendanceToBackend(cleanPocketNumber, tagUid: _getTagUid(tag));
-        } catch (e) {
-          _showSnackBar("❌ 태그 읽기 실패: $e", Colors.red);
-        } finally {
-          // 3초 후 연타 방지 해제 (쿨다운)
-          await Future.delayed(const Duration(seconds: 3));
-          if (mounted) {
-            setState(() => _isProcessing = false);
-          }
-        }
-      },
-    );
-  }
-
-  /// 태그의 공장 각인 하드웨어 UID를 16진수 문자열로 반환한다 (쓰기로 바꿀 수 없어 복제 방지 기준으로 씀).
-  String? _getTagUid(NfcTag tag) {
-    final id = NfcTagAndroid.from(tag)?.id;
-    if (id == null || id.isEmpty) return null;
-    return id.map((b) => b.toRadixString(16).padLeft(2, '0')).join().toUpperCase();
-  }
-
-  /// 🚚 파이썬 백엔드로 출석 데이터 HTTP POST 전송
-  Future<void> _sendAttendanceToBackend(
-    String pocketNumber, {
-    String? tagUid,
-  }) async {
-    final url = Uri.parse("$baseUrl/attendance");
-
-    try {
-      final response = await http.post(
-        url,
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({
-          "studentId": widget.studentId,
-          "studentName": widget.studentName,
-          "pocketNumber": pocketNumber, // 주머니 번호 전달
-          "tagUid": tagUid, // 🔒 서버가 태그 진위를 대조할 하드웨어 UID
-        }),
-      );
-
-      if (response.statusCode == 200) {
-        final result = jsonDecode(utf8.decode(response.bodyBytes));
-        if (result["status"] == "success") {
-          _showSuccessDialog(pocketNumber);
-          await _startBackgroundWatch(pocketNumber);
-        } else {
-          _showSnackBar("⚠️ 출석 실패: ${result['message']}", Colors.orange);
-        }
-      } else {
-        _showSnackBar("🚨 서버 에러 (코드: ${response.statusCode})", Colors.red);
-      }
-    } catch (e) {
-      _showSnackBar("❌ 서버 연결 실패: $e", Colors.red);
-    }
-  }
-
-  // -----------------------------------------------------------------------
-  // 🛡️ 주머니 제출 모드: 화면이 꺼져도 백그라운드 서비스가 조도 센서로 감시
-  // -----------------------------------------------------------------------
-
-  /// NFC 태깅 성공 직후 호출. 배터리 최적화 예외를 한 번 요청한 뒤 백그라운드 감시 서비스를 시작한다.
-  Future<void> _startBackgroundWatch(String pocketNumber) async {
-    if (!_watchServiceSupported) {
-      _showSnackBar("ℹ️ 이 기기(iOS)는 백그라운드 감시를 지원하지 않습니다.", Colors.blueGrey);
-      return;
-    }
-
-    // 배터리 최적화 예외 요청 (이미 허용되어 있으면 시스템이 알아서 다이얼로그를 건너뜀)
-    final batteryStatus = await Permission.ignoreBatteryOptimizations.status;
-    if (!batteryStatus.isGranted) {
-      await Permission.ignoreBatteryOptimizations.request();
-    }
-
-    final service = FlutterBackgroundService();
-    if (!await service.isRunning()) {
-      await service.startService();
-    }
-    service.invoke('start_watch', {
-      "studentId": widget.studentId,
-      "studentName": widget.studentName,
-      "pocketNumber": pocketNumber,
-    });
-
-    setState(() {
-      _isWatching = true;
-      _activePocketNumber = pocketNumber;
-      _statusMessage = "🛡️ 백그라운드에서 감시 중입니다. 화면을 꺼도 계속 감시돼요.";
-    });
-  }
-
-  /// 감시 중일 때 다시 태깅하면 폰을 회수한 것으로 보고 감시를 종료한다.
-  Future<void> _checkOut() async {
-    FlutterBackgroundService().invoke('stop_watch');
-    setState(() {
-      _isWatching = false;
-      _activePocketNumber = null;
-      _statusMessage = "✅ 폰을 회수했습니다. 감시가 종료되었습니다.";
-    });
-    _showSnackBar("✅ 감시가 종료되었습니다. 수고하셨습니다!", Colors.green);
-  }
-
-  /// 이미 떠 있는 팝업(출석 완료/무단반출 감지)이 있으면 새 팝업을 띄우기 전에 먼저 닫는다.
-  /// (태깅→반출→재태깅이 빠르게 반복되면 팝업이 여러 개 겹쳐 쌓이는 것을 방지)
-  void _closeAnyOpenDialog() {
-    if (_isDialogOpen && mounted) {
-      Navigator.of(context, rootNavigator: true).pop();
-    }
-    _isDialogOpen = false;
-  }
-
-  void _showViolationDialog(String? pocketNumber) {
-    _closeAnyOpenDialog();
-    _isDialogOpen = true;
-    showDialog(
-      context: context,
-      builder: (context) => AlertDialog(
-        backgroundColor: Colors.red[50],
-        title: const Text(
-          "🚨 무단 반출 감지",
-          style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold),
-        ),
-        content: Text(
-          "[${pocketNumber ?? _activePocketNumber}] 주머니에서 휴대폰이 꺼내진 것으로 감지되었습니다.\n담당 선생님께 알림이 전송되었습니다.",
-        ),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(context),
-            child: const Text("확인"),
-          ),
-        ],
-      ),
-    ).then((_) => _isDialogOpen = false);
-  }
-
-  /// 🎊 출석 성공 알림창
-  void _showSuccessDialog(String pocketNumber) {
-    _closeAnyOpenDialog();
-    _isDialogOpen = true;
-    showDialog(
-      context: context,
-      builder: (context) => AlertDialog(
-        title: const Text("🎉 자습실 출석 완료!"),
-        content: Text(
-          "${widget.studentName} 학생!\n[$pocketNumber] 주머니 출석이 확인되었습니다.\n\n폰을 주머니에 쏙 넣고 자습에 집중해 주세요! ✏️",
-        ),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(context),
-            child: const Text("확인"),
-          ),
-        ],
-      ),
-    ).then((_) => _isDialogOpen = false);
-  }
-
-  void _showSnackBar(String text, Color color) {
-    ScaffoldMessenger.of(
-      context,
-    ).showSnackBar(SnackBar(content: Text(text), backgroundColor: color));
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    if (_isWatching) {
-      return _buildPocketWatchScreen();
-    }
-
-    return Scaffold(
-      appBar: AppBar(
-        title: const Text(
-          "자습실 NFC 출석체크",
-          style: TextStyle(color: Colors.white, fontWeight: FontWeight.bold),
-        ),
-        backgroundColor: const Color.fromARGB(255, 48, 48, 52),
-      ),
-      body: Center(
-        child: Padding(
-          padding: const EdgeInsets.all(24.0),
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.center,
-            children: [
-              // NFC 애니메이션 아이콘
-              Icon(
-                _isProcessing ? Icons.sync : Icons.nfc,
-                size: 100,
-                color: _isProcessing ? Colors.orange : Colors.blueAccent,
-              ),
-              const SizedBox(height: 30),
-
-              // 상태 메시지 표시
-              Text(
-                _statusMessage,
-                textAlign: TextAlign.center,
-                style: TextStyle(
-                  fontSize: 18,
-                  fontWeight: FontWeight.bold,
-                  color: _isProcessing ? Colors.orange : Colors.black87,
-                ),
-              ),
-              const SizedBox(height: 15),
-
-              const Text(
-                "자기 주머니 번호 숫자에 폰 뒷면을 '톡' 대면\n자동으로 출석 처리됩니다.",
-                textAlign: TextAlign.center,
-                style: TextStyle(color: Colors.grey, fontSize: 14),
-              ),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-
-  /// 💳 삼성페이 결제창 느낌의 전체화면 "주머니 제출 모드" 안내 UI
-  /// (실제 감시 로직은 pocket_watch_service.dart의 백그라운드 서비스가 담당하므로,
-  ///  이 화면은 상태를 보여주고 화면을 꺼도 된다는 것만 안내한다.)
-  Widget _buildPocketWatchScreen() {
-    return Scaffold(
-      backgroundColor: const Color(0xFF0B1120),
-      body: SafeArea(
-        child: Padding(
-          padding: const EdgeInsets.all(32.0),
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.center,
-            children: [
-              Container(
-                width: 160,
-                height: 160,
-                decoration: BoxDecoration(
-                  shape: BoxShape.circle,
-                  color: Colors.greenAccent.withValues(alpha: 0.15),
-                  border: Border.all(color: Colors.greenAccent, width: 3),
-                ),
-                child: const Icon(
-                  Icons.shield_rounded,
-                  size: 72,
-                  color: Colors.greenAccent,
-                ),
-              ),
-              const SizedBox(height: 40),
-              Text(
-                _activePocketNumber ?? "",
-                style: const TextStyle(
-                  color: Colors.white54,
-                  fontSize: 14,
-                  letterSpacing: 2,
-                ),
-              ),
-              const SizedBox(height: 12),
-              Text(
-                _statusMessage,
-                textAlign: TextAlign.center,
-                style: const TextStyle(
-                  color: Colors.white,
-                  fontSize: 20,
-                  fontWeight: FontWeight.bold,
-                  height: 1.4,
-                ),
-              ),
-              const SizedBox(height: 8),
-              const Text(
-                "📴 화면을 꺼도 감시는 계속됩니다.\n알림바에서 상태를 확인할 수 있어요.\n(폰을 꺼내 다시 태깅하면 반출 처리됩니다)",
-                textAlign: TextAlign.center,
-                style: TextStyle(color: Colors.white38, fontSize: 13),
-              ),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-}

lib/pocket_watch_service.dart

@@ -44,7 +44,7 @@ Future<void> initializePocketWatchService() async {
       autoStartOnBoot: false,
       isForegroundMode: true,
       notificationChannelId: pocketWatchNotificationChannelId,
-      initialNotificationTitle: '🛡️ 주머니 감시 대기 중',
+      initialNotificationTitle: '주머니 감시 대기 중',
       initialNotificationContent: '출석 태깅을 기다리는 중입니다.',
       foregroundServiceNotificationId: pocketWatchNotificationId,
       foregroundServiceTypes: [AndroidForegroundType.specialUse],
@@ -88,7 +88,7 @@ void onPocketWatchServiceStart(ServiceInstance service) {
   Future<void> reportViolation() async {
     // 진동 3연타로 강하게 경고 (백그라운드 서비스에서는 HapticFeedback이 아닌 vibration 패키지를 써야 동작함)
     Vibration.vibrate(pattern: [0, 400, 150, 400, 150, 400]);
-    updateNotification("🚨 무단 반출 감지!", "[$pocketNumber] 주머니에서 폰이 감지되지 않습니다.");
+    updateNotification("무단 반출 감지!", "[$pocketNumber] 주머니에서 폰이 감지되지 않습니다.");
     service.invoke('violation_detected', {
       "pocketNumber": pocketNumber,
       "timestamp": DateTime.now().toIso8601String(),
@@ -128,7 +128,7 @@ void onPocketWatchServiceStart(ServiceInstance service) {
     }
 
     if (isPermitted) {
-      updateNotification("✅ 폰 회수 완료", "[$pocketNumber] 주머니에서 정상적으로 회수되었습니다.");
+      updateNotification("폰 회수 완료", "[$pocketNumber] 주머니에서 정상적으로 회수되었습니다.");
       service.invoke('checked_out', {"pocketNumber": pocketNumber});
       service.stopSelf();
     } else {
@@ -145,7 +145,7 @@ void onPocketWatchServiceStart(ServiceInstance service) {
         baselineLux =
             calibrationSamples.reduce((a, b) => a + b) ~/
             calibrationSamples.length;
-        updateNotification("🛡️ 감시 중", "[$pocketNumber] 폰이 주머니 안에 있는지 감시 중");
+        updateNotification("감시 중", "[$pocketNumber] 폰이 주머니 안에 있는지 감시 중");
       }
       return;
     }
@@ -163,22 +163,22 @@ void onPocketWatchServiceStart(ServiceInstance service) {
     baselineLux = null;
     violated = false;
 
-    updateNotification("📥 주머니에 넣는 중...", "잠시 후 감시가 시작됩니다.");
+    updateNotification("주머니에 넣는 중...", "잠시 후 감시가 시작됩니다.");
 
     await Future.delayed(_placePhoneDelay);
 
-    updateNotification("🔎 밝기 측정 중...", "주머니 속 밝기를 기준값으로 설정하는 중입니다.");
+    updateNotification("밝기 측정 중...", "주머니 속 밝기를 기준값으로 설정하는 중입니다.");
 
     try {
       await Light().requestAuthorization();
       lightSub = Light().lightSensorStream.listen(
         onLightReading,
         onError: (Object error) {
-          updateNotification("❌ 조도 센서 오류", "$error");
+          updateNotification("조도 센서 오류", "$error");
         },
       );
     } catch (e) {
-      updateNotification("❌ 조도 센서 시작 실패", "$e");
+      updateNotification("조도 센서 시작 실패", "$e");
     }
   }
 

lib/screens/admin_dashboard.dart

@@ -1,154 +0,0 @@
-// 🛠️ 시스템 관리자 대시보드. 출석 DB 전체 초기화 기능만 담당한다.
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import '../config.dart';
-import 'login_screen.dart';
-
-// ==========================================
-// 🛠️ 5. 관리자 대시보드 (DB 초기화 암호 파라미터 보정 완료)
-// ==========================================
-class AdminDashboard extends StatefulWidget {
-  const AdminDashboard({super.key});
-
-  @override
-  State<AdminDashboard> createState() => _AdminDashboardState();
-}
-
-class _AdminDashboardState extends State<AdminDashboard> {
-  bool _isLoading = false;
-
-  Future<void> resetDatabase() async {
-    setState(() => _isLoading = true);
-
-    // 🆕 백엔드 보안 규칙에 맞추어 초기화 토큰 비밀번호 파라미터(?password=...)를 연동 주소에 매칭했습니다.
-    final url = Uri.parse('$baseUrl/reset-db?password=adminreset2010');
-
-    try {
-      final response = await http.get(url);
-
-      if (response.statusCode == 200) {
-        if (!mounted) return;
-        ScaffoldMessenger.of(context).showSnackBar(
-          const SnackBar(
-            content: Text('💥 DB가 깔끔하게 초기화되었습니다! (출석 번호 1번부터 시작)'),
-          ),
-        );
-      } else {
-        if (!mounted) return;
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(
-            content: Text('❌ 초기화 실패: 서버 권한 오류 (${response.statusCode})'),
-          ),
-        );
-      }
-    } catch (e) {
-      if (!mounted) return;
-      ScaffoldMessenger.of(context).showSnackBar(
-        const SnackBar(content: Text('❌ 네트워크 에러: 서버와 연결할 수 없습니다.')),
-      );
-    } finally {
-      if (mounted) setState(() => _isLoading = false);
-    }
-  }
-
-  void _showResetConfirmDialog() {
-    showDialog(
-      context: context,
-      builder: (BuildContext dialogContext) {
-        return AlertDialog(
-          title: const Text(
-            '⚠️ DB 초기화 경고',
-            style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold),
-          ),
-          content: const Text(
-            '모든 학생의 출석 및 휴대폰 제출 데이터가 영구적으로 삭제됩니다.\n\n정말 초기화하시겠습니까?',
-          ),
-          actions: [
-            TextButton(
-              onPressed: () => Navigator.pop(dialogContext),
-              child: const Text('취소', style: TextStyle(color: Colors.grey)),
-            ),
-            ElevatedButton(
-              style: ElevatedButton.styleFrom(backgroundColor: Colors.red),
-              onPressed: () {
-                Navigator.pop(dialogContext);
-                resetDatabase();
-              },
-              child: const Text(
-                '초기화 실행',
-                style: TextStyle(color: Colors.white),
-              ),
-            ),
-          ],
-        );
-      },
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(
-        title: const Text('🛠️ 관리자 시스템'),
-        backgroundColor: Colors.orange,
-        foregroundColor: Colors.white,
-        actions: [
-          IconButton(
-            icon: const Icon(Icons.logout),
-            onPressed: () => Navigator.pushReplacement(
-              context,
-              MaterialPageRoute(builder: (context) => const LoginScreen()),
-            ),
-          ),
-        ],
-      ),
-      body: Center(
-        child: Padding(
-          padding: const EdgeInsets.all(24.0),
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.center,
-            children: [
-              const Icon(
-                Icons.admin_panel_settings,
-                size: 100,
-                color: Colors.orange,
-              ),
-              const SizedBox(height: 20),
-              const Text(
-                '데이터베이스 관리',
-                style: TextStyle(fontSize: 22, fontWeight: FontWeight.bold),
-              ),
-              const SizedBox(height: 40),
-
-              _isLoading
-                  ? const CircularProgressIndicator(color: Colors.red)
-                  : SizedBox(
-                      width: double.infinity,
-                      height: 60,
-                      child: ElevatedButton.icon(
-                        style: ElevatedButton.styleFrom(
-                          backgroundColor: Colors.red[50],
-                          foregroundColor: Colors.red,
-                          side: const BorderSide(color: Colors.red, width: 2),
-                          shape: RoundedRectangleBorder(
-                            borderRadius: BorderRadius.circular(12),
-                          ),
-                        ),
-                        icon: const Icon(Icons.delete_forever, size: 28),
-                        label: const Text(
-                          '모든 출석 데이터 초기화',
-                          style: TextStyle(
-                            fontSize: 18,
-                            fontWeight: FontWeight.bold,
-                          ),
-                        ),
-                        onPressed: _showResetConfirmDialog,
-                      ),
-                    ),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-}

lib/screens/change_password_screen.dart

@@ -3,7 +3,8 @@ import 'dart:convert';
 import 'package:flutter/material.dart';
 import 'package:http/http.dart' as http;
 import '../config.dart';
-import 'login_screen.dart';
+import '../theme/app_palette.dart';
+import '../ui/login_screen.dart';
 
 // 💡 main.dart 파일의 최하단(다른 클래스 중괄호 밖)에 붙여넣으세요.
 class ChangePasswordScreen extends StatefulWidget {
@@ -22,7 +23,7 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
     String newPw = _pwController.text.trim();
     if (newPw.isEmpty || newPw == "1234") {
       ScaffoldMessenger.of(context).showSnackBar(
-        const SnackBar(content: Text('⚠️ 초기 비밀번호와 다른 안전한 비밀번호를 입력하세요.')),
+        const SnackBar(content: Text('초기 비밀번호와 다른 안전한 비밀번호를 입력하세요.')),
       );
       return;
     }
@@ -38,7 +39,7 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
       final res = jsonDecode(response.body);
       if (response.statusCode == 200 && res['status'] == 'success') {
         ScaffoldMessenger.of(context).showSnackBar(
-          const SnackBar(content: Text('🔒 비밀번호 변경 완료! 다시 로그인해 주세요.')),
+          const SnackBar(content: Text('비밀번호 변경 완료! 다시 로그인해 주세요.')),
         );
         // 비밀번호를 바꿨으니 다시 로그인 화면으로 강제 이동
         Navigator.pushReplacement(
@@ -49,7 +50,7 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
     } catch (e) {
       ScaffoldMessenger.of(
         context,
-      ).showSnackBar(const SnackBar(content: Text('❌ 통신 실패')));
+      ).showSnackBar(const SnackBar(content: Text('통신 실패')));
     } finally {
       setState(() => _isLoading = false);
     }
@@ -58,6 +59,7 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
   @override
   Widget build(BuildContext context) {
     return Scaffold(
+      backgroundColor: AppPalette.mist,
       body: Padding(
         padding: const EdgeInsets.all(32.0),
         child: Column(
@@ -65,7 +67,7 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
           crossAxisAlignment: CrossAxisAlignment.start,
           children: [
             const Text(
-              '🔒 보안을 위해\n비밀번호를 변경해 주세요',
+              '보안을 위해\n비밀번호를 변경해 주세요',
               style: TextStyle(
                 fontSize: 24,
                 fontWeight: FontWeight.bold,
@@ -92,8 +94,8 @@ class _ChangePasswordScreenState extends State<ChangePasswordScreen> {
               height: 50,
               child: ElevatedButton(
                 style: ElevatedButton.styleFrom(
-                  backgroundColor: Colors.indigo,
-                  foregroundColor: Colors.white,
+                  backgroundColor: AppPalette.ink,
+                  foregroundColor: AppPalette.paper,
                 ),
                 onPressed: _isLoading ? null : _updatePassword,
                 child: _isLoading

lib/screens/login_screen.dart

@@ -1,541 +0,0 @@
-// 🔑 로그인 화면. 학번/비밀번호 인증, 최초 로그인 비밀번호 변경, 권한(학생/교사/관리자)별 화면 분기를 담당한다.
-import 'dart:convert';
-import 'package:flutter/foundation.dart' show kIsWeb;
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import 'package:firebase_messaging/firebase_messaging.dart';
-import '../config.dart';
-import 'student_dashboard.dart';
-import 'teacher_dashboard.dart';
-import 'admin_dashboard.dart';
-import 'teacher_register_screen.dart';
-
-// -------------------------------------------------------------
-// 1. 로그인 화면 (LoginScreen)
-// -------------------------------------------------------------
-
-class LoginScreen extends StatefulWidget {
-  const LoginScreen({super.key});
-
-  @override
-  State<LoginScreen> createState() => _LoginScreenState();
-}
-
-class _LoginScreenState extends State<LoginScreen> {
-  final TextEditingController _idController = TextEditingController();
-  final TextEditingController _pwController = TextEditingController();
-  bool _isLoading = false;
-
-  Future<void> _login() async {
-    String currentInputId = _idController.text.trim();
-    String currentInputPw = _pwController.text.trim();
-
-    if (currentInputId.isEmpty || currentInputPw.isEmpty) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(const SnackBar(content: Text('⚠️ 학번과 비밀번호를 모두 입력해 주세요.')));
-      return;
-    }
-
-    // 🔥 [개발자 마스터 계정]
-    if (currentInputId == "2061") {
-      if (currentInputPw == "happy9642!") {
-        ScaffoldMessenger.of(context).showSnackBar(
-          const SnackBar(content: Text('👑 개발자 최고 권한으로 로그인되었습니다.')),
-        );
-        Navigator.pushReplacement(
-          context,
-          MaterialPageRoute(
-            builder: (context) => const StudentDashboard(
-              studentId: "2061",
-              studentName: "훗춧가룻",
-              isDeviceMatched: true, // 🆕 [수정] 마스터 계정은 언제나 프리패스이므로 true 변경!
-            ),
-          ),
-        );
-        return;
-      } else {
-        _showErrorDialog('개발자 계정의 마스터 비밀번호가 올바르지 않습니다.');
-        return;
-      }
-    }
-
-    setState(() => _isLoading = true);
-
-    try {
-      String deviceUuid = await getDeviceUuid();
-      String fcmToken = "";
-
-      try {
-        fcmToken = kIsWeb
-            ? await FirebaseMessaging.instance.getToken(
-                    vapidKey: webVapidKey,
-                  ) ??
-                  ""
-            : await FirebaseMessaging.instance.getToken() ?? "";
-        print("발급된 FCM 토큰: $fcmToken");
-      } catch (e) {
-        print("FCM 토큰 가져오기 실패 (파이어베이스 미설정): $e");
-      }
-
-      final response = await http.post(
-        Uri.parse('$baseUrl/login'),
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({
-          "studentId": currentInputId,
-          "password": currentInputPw,
-          "deviceUuid": deviceUuid,
-          "fcmToken": fcmToken,
-        }),
-      );
-
-      final resData = jsonDecode(utf8.decode(response.bodyBytes));
-
-      if (response.statusCode == 200) {
-        print("🚨 서버 응답 데이터: $resData");
-
-        String role = '';
-        String name = '';
-        String studentId = '';
-        int isFirstLogin = 0;
-
-        var userObj = resData['user'];
-        if (userObj != null) {
-          role = userObj['role']?.toString() ?? '';
-          name =
-              userObj['name']?.toString() ??
-              userObj['studentName']?.toString() ??
-              userObj['student_name']?.toString() ??
-              '';
-          studentId =
-              userObj['studentId']?.toString() ??
-              userObj['student_id']?.toString() ??
-              currentInputId;
-
-          var rawFirst = userObj['isFirstLogin'] ?? userObj['is_first_login'];
-          isFirstLogin = (rawFirst is bool)
-              ? (rawFirst ? 1 : 0)
-              : (int.tryParse(rawFirst.toString()) ?? 0);
-        } else {
-          role = resData['role']?.toString() ?? '';
-          name =
-              resData['name']?.toString() ??
-              resData['studentName']?.toString() ??
-              '';
-          studentId = resData['studentId']?.toString() ?? currentInputId;
-
-          var rawFirst = resData['isFirstLogin'] ?? resData['is_first_login'];
-          isFirstLogin = (rawFirst is bool)
-              ? (rawFirst ? 1 : 0)
-              : (int.tryParse(rawFirst.toString()) ?? 0);
-        }
-
-        if (name.trim().isEmpty) {
-          name = "알수없음";
-        }
-
-        // 🆕 [추가] 서버 응답 데이터에서 기기 일치 여부 추출하기
-        // (서버가 주는 Key 이름에 맞춰서 데이터를 가져옵니다. 아래 항목 중 맞는 게 알아서 들어감)
-        bool isDeviceMatched =
-            resData['isDeviceMatched'] ??
-            resData['isUuidMatched'] ??
-            resData['is_matched'] ??
-            (userObj != null
-                ? (userObj['isDeviceMatched'] ?? userObj['is_matched'] ?? false)
-                : false);
-
-        if (isFirstLogin == 1) {
-          _showFirstLoginPasswordDialog(
-            studentId,
-            name,
-            role,
-            isDeviceMatched,
-          ); // 🆕 매개변수 추가
-          return;
-        }
-
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(SnackBar(content: Text('✅ $name님 환영합니다!')));
-        _navigateBasedOnRole(
-          role,
-          studentId,
-          name,
-          isDeviceMatched,
-        ); // 🆕 [수정] 기기 인증 결과 전달
-      } else {
-        String errorMsg = '로그인에 실패했습니다.';
-        if (resData is Map) {
-          errorMsg =
-              resData['detail']?.toString() ??
-              resData['message']?.toString() ??
-              errorMsg;
-        }
-        _showErrorDialog(errorMsg);
-      }
-    } catch (e) {
-      _showErrorDialog('서버와 연결할 수 없습니다. 서버 상태를 확인하세요!\n($e)');
-    } finally {
-      setState(() => _isLoading = false);
-    }
-  }
-
-  // 🛠️ 초기 비밀번호 변경 팝업창 (기기 매칭 데이터 파라미터 추가)
-  void _showFirstLoginPasswordDialog(
-    String studentId,
-    String name,
-    String role,
-    bool isDeviceMatched, // 🆕 추가
-  ) {
-    final TextEditingController newPwController = TextEditingController();
-
-    showDialog(
-      context: context,
-      barrierDismissible: false,
-      builder: (BuildContext dialogContext) {
-        bool isUpdating = false;
-
-        return StatefulBuilder(
-          builder: (context, setDialogState) {
-            return AlertDialog(
-              title: const Text(
-                '🔒 초기 비밀번호 변경',
-                style: TextStyle(fontWeight: FontWeight.bold),
-              ),
-              content: Column(
-                mainAxisSize: MainAxisSize.min,
-                children: [
-                  const Text(
-                    '보안을 위해 새로운 비밀번호를 설정해 주세요.',
-                    style: TextStyle(color: Colors.redAccent),
-                  ),
-                  const SizedBox(height: 16),
-                  TextField(
-                    controller: newPwController,
-                    obscureText: true,
-                    decoration: const InputDecoration(
-                      labelText: '새 비밀번호',
-                      border: OutlineInputBorder(),
-                      prefixIcon: Icon(Icons.lock_reset),
-                    ),
-                  ),
-                ],
-              ),
-              actions: [
-                isUpdating
-                    ? const Padding(
-                        padding: EdgeInsets.only(right: 20.0),
-                        child: CircularProgressIndicator(),
-                      )
-                    : ElevatedButton(
-                        style: ElevatedButton.styleFrom(
-                          backgroundColor: Colors.indigo,
-                          foregroundColor: Colors.white,
-                        ),
-                        onPressed: () async {
-                          String newPassword = newPwController.text.trim();
-                          if (newPassword.isEmpty) {
-                            ScaffoldMessenger.of(context).showSnackBar(
-                              const SnackBar(
-                                content: Text('⚠️ 새 비밀번호를 입력해 주세요.'),
-                              ),
-                            );
-                            return;
-                          }
-
-                          setDialogState(() => isUpdating = true);
-
-                          try {
-                            final response = await http.post(
-                              Uri.parse('$baseUrl/api/users/change-password'),
-                              headers: {"Content-Type": "application/json"},
-                              body: jsonEncode({
-                                "studentId": studentId,
-                                "newPassword": newPassword,
-                              }),
-                            );
-
-                            final resData = jsonDecode(
-                              utf8.decode(response.bodyBytes),
-                            );
-                            setDialogState(() => isUpdating = false);
-
-                            if (response.statusCode == 200 &&
-                                resData['status'] == 'success') {
-                              Navigator.pop(dialogContext);
-                              ScaffoldMessenger.of(context).showSnackBar(
-                                const SnackBar(
-                                  content: Text('✅ 비밀번호가 변경되었습니다!'),
-                                ),
-                              );
-                              _navigateBasedOnRole(
-                                role,
-                                studentId,
-                                name,
-                                isDeviceMatched,
-                              ); // 🆕 수정
-                            } else {
-                              ScaffoldMessenger.of(context).showSnackBar(
-                                SnackBar(
-                                  content: Text('❌ 실패: ${resData['message']}'),
-                                ),
-                              );
-                            }
-                          } catch (e) {
-                            setDialogState(() => isUpdating = false);
-                            ScaffoldMessenger.of(context).showSnackBar(
-                              SnackBar(content: Text('서버 에러 발생: $e')),
-                            );
-                          }
-                        },
-                        child: const Text('변경하고 시작하기'),
-                      ),
-              ],
-            );
-          },
-        );
-      },
-    );
-  }
-
-  // 🆕 [수정] 권한별 화면 이동시 기기 일치 여부 파라미터(`isDeviceMatched`) 수신 및 대시보드 전달
-  void _navigateBasedOnRole(
-    String role,
-    String studentId,
-    String name,
-    bool isDeviceMatched,
-  ) {
-    if (role == 'teacher') {
-      Navigator.pushReplacement(
-        context,
-        MaterialPageRoute(builder: (context) => const TeacherDashboard()),
-      );
-    } else if (role == 'admin') {
-      Navigator.pushReplacement(
-        context,
-        MaterialPageRoute(builder: (context) => const AdminDashboard()),
-      );
-    } else {
-      Navigator.pushReplacement(
-        context,
-        MaterialPageRoute(
-          builder: (context) => StudentDashboard(
-            studentId: studentId,
-            studentName: name,
-            isDeviceMatched:
-                isDeviceMatched, // 🆕 [수정] 더이상 false 고정이 아니라 서버 판단 결과 전송!
-          ),
-        ),
-      );
-    }
-  }
-
-  void _showErrorDialog(String message) {
-    showDialog(
-      context: context,
-      builder: (ctx) => AlertDialog(
-        title: const Text(
-          '⚠️ 인증 실패',
-          style: TextStyle(fontWeight: FontWeight.bold),
-        ),
-        content: Text(message),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(ctx),
-            child: const Text('확인'),
-          ),
-        ],
-      ),
-    );
-  }
-
-  void _showLegacyPasswordDialog(
-    String title,
-    String correctPassword,
-    Widget nextPage,
-  ) {
-    final TextEditingController passwordController = TextEditingController();
-    showDialog(
-      context: context,
-      barrierDismissible: false,
-      builder: (BuildContext dialogContext) {
-        return AlertDialog(
-          title: Text('🔒 $title 권한 인증 (기존 방식)'),
-          content: TextField(
-            controller: passwordController,
-            obscureText: true,
-            keyboardType: TextInputType.number,
-            textInputAction: TextInputAction.done,
-            onSubmitted: (value) {
-              if (value == correctPassword) {
-                Navigator.pop(dialogContext);
-                Navigator.push(
-                  context,
-                  MaterialPageRoute(builder: (context) => nextPage),
-                );
-              } else {
-                ScaffoldMessenger.of(context).showSnackBar(
-                  const SnackBar(content: Text('❌ 비밀번호가 올바르지 않습니다.')),
-                );
-              }
-            },
-            decoration: const InputDecoration(
-              hintText: '비밀번호 4자리를 입력하세요',
-              border: OutlineInputBorder(),
-            ),
-          ),
-          actions: [
-            TextButton(
-              onPressed: () => Navigator.pop(dialogContext),
-              child: const Text('취소', style: TextStyle(color: Colors.grey)),
-            ),
-            ElevatedButton(
-              onPressed: () {
-                if (passwordController.text == correctPassword) {
-                  Navigator.pop(dialogContext);
-                  Navigator.push(
-                    context,
-                    MaterialPageRoute(builder: (context) => nextPage),
-                  );
-                } else {
-                  ScaffoldMessenger.of(context).showSnackBar(
-                    const SnackBar(content: Text('❌ 비밀번호가 올바르지 않습니다.')),
-                  );
-                }
-              },
-              child: const Text('인증하기'),
-            ),
-          ],
-        );
-      },
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      backgroundColor: Colors.grey[50],
-      body: Center(
-        child: SingleChildScrollView(
-          padding: const EdgeInsets.all(24.0),
-          child: Column(
-            mainAxisAlignment: MainAxisAlignment.center,
-            children: [
-              const Icon(Icons.school, size: 80, color: Colors.indigo),
-              const SizedBox(height: 16),
-              const Text(
-                '백산고등학교 모니터',
-                style: TextStyle(
-                  fontSize: 26,
-                  fontWeight: FontWeight.bold,
-                  color: Colors.indigo,
-                ),
-              ),
-              const SizedBox(height: 8),
-              const Text(
-                '학생 편의 및 학교생활 도우미',
-                style: TextStyle(color: Colors.grey, fontSize: 15),
-              ),
-              const SizedBox(height: 40),
-              TextField(
-                controller: _idController,
-                textInputAction: TextInputAction.next,
-                decoration: const InputDecoration(
-                  labelText: '학번 또는 교직원 번호',
-                  border: OutlineInputBorder(),
-                  prefixIcon: Icon(Icons.person),
-                ),
-              ),
-              const SizedBox(height: 16),
-              TextField(
-                controller: _pwController,
-                obscureText: true,
-                textInputAction: TextInputAction.done,
-                onSubmitted: (_) => _login(),
-                decoration: const InputDecoration(
-                  labelText: '비밀번호',
-                  border: OutlineInputBorder(),
-                  prefixIcon: Icon(Icons.lock),
-                ),
-              ),
-              const SizedBox(height: 24),
-              _isLoading
-                  ? const CircularProgressIndicator()
-                  : SizedBox(
-                      width: double.infinity,
-                      height: 55,
-                      child: ElevatedButton(
-                        style: ElevatedButton.styleFrom(
-                          backgroundColor: Colors.indigo,
-                          foregroundColor: Colors.white,
-                          shape: RoundedRectangleBorder(
-                            borderRadius: BorderRadius.circular(12),
-                          ),
-                        ),
-                        onPressed: _login,
-                        child: const Text(
-                          '로그인',
-                          style: TextStyle(
-                            fontSize: 18,
-                            fontWeight: FontWeight.bold,
-                          ),
-                        ),
-                      ),
-                    ),
-              const SizedBox(height: 4),
-              TextButton(
-                onPressed: () => Navigator.push(
-                  context,
-                  MaterialPageRoute(
-                    builder: (context) => const TeacherRegisterScreen(),
-                  ),
-                ),
-                child: const Text(
-                  '👨‍🏫 선생님이신가요? 교사 회원가입 하기',
-                  style: TextStyle(
-                    color: Colors.indigo,
-                    fontWeight: FontWeight.bold,
-                  ),
-                ),
-              ),
-              const Divider(height: 40),
-              Row(
-                mainAxisAlignment: MainAxisAlignment.spaceEvenly,
-                children: [
-                  TextButton.icon(
-                    icon: const Icon(Icons.gavel, size: 18, color: Colors.grey),
-                    label: const Text(
-                      '교사 간편인증',
-                      style: TextStyle(color: Colors.grey),
-                    ),
-                    onPressed: () => _showLegacyPasswordDialog(
-                      '선생님',
-                      '1234',
-                      const TeacherDashboard(),
-                    ),
-                  ),
-                  TextButton.icon(
-                    icon: const Icon(
-                      Icons.settings,
-                      size: 18,
-                      color: Colors.grey,
-                    ),
-                    label: const Text(
-                      '관리자 간편인증',
-                      style: TextStyle(color: Colors.grey),
-                    ),
-                    onPressed: () => _showLegacyPasswordDialog(
-                      '시스템 관리자',
-                      '4936',
-                      const AdminDashboard(),
-                    ),
-                  ),
-                ],
-              ),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-}

lib/screens/nfc_tag_writer_screen.dart

@@ -1,204 +0,0 @@
-// 🏷️ (관리자용) 주머니 NFC 스티커 초기 설정 화면. 빈 태그에 "POCKET_번호" 텍스트를 써넣는다.
-import 'dart:convert';
-import 'dart:typed_data';
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import 'package:nfc_manager/nfc_manager.dart';
-import 'package:nfc_manager/nfc_manager_android.dart';
-import 'package:nfc_manager/ndef_record.dart';
-import 'package:nfc_manager_ndef/nfc_manager_ndef.dart';
-import '../config.dart';
-
-class NfcTagWriterScreen extends StatefulWidget {
-  const NfcTagWriterScreen({super.key});
-
-  @override
-  State<NfcTagWriterScreen> createState() => _NfcTagWriterScreenState();
-}
-
-class _NfcTagWriterScreenState extends State<NfcTagWriterScreen> {
-  final TextEditingController _numberController = TextEditingController(
-    text: "1",
-  );
-  bool _isWriting = false;
-  String _statusMessage = "주머니 번호를 입력하고 '쓰기 시작'을 눌러주세요.";
-
-  @override
-  void dispose() {
-    NfcManager.instance.stopSession();
-    _numberController.dispose();
-    super.dispose();
-  }
-
-  void _startWriteSession() async {
-    final String number = _numberController.text.trim();
-    if (number.isEmpty) {
-      _showSnackBar("⚠️ 주머니 번호를 입력해주세요.", Colors.orange);
-      return;
-    }
-    final String pocketLabel = "POCKET_$number";
-
-    bool isAvailable = await NfcManager.instance.isAvailable();
-    if (!isAvailable) {
-      _showSnackBar("❌ NFC가 꺼져있거나 지원되지 않습니다.", Colors.red);
-      return;
-    }
-
-    setState(() {
-      _isWriting = true;
-      _statusMessage = "📡 [$pocketLabel] 쓸 준비 완료! 스티커에 폰 뒷면을 대주세요.";
-    });
-
-    NfcManager.instance.startSession(
-      pollingOptions: {NfcPollingOption.iso14443, NfcPollingOption.iso15693},
-      onDiscovered: (NfcTag tag) async {
-        try {
-          final ndef = Ndef.from(tag);
-          if (ndef == null) {
-            _showSnackBar("❌ 이 태그는 NDEF 쓰기를 지원하지 않는 종류입니다.", Colors.red);
-            return;
-          }
-          if (!ndef.isWritable) {
-            _showSnackBar("❌ 이 태그는 쓰기 잠금(read-only) 상태입니다.", Colors.red);
-            return;
-          }
-
-          await ndef.write(
-            message: NdefMessage(records: [_createTextRecord(pocketLabel)]),
-          );
-
-          // 🔒 태그 복제 방지: 하드웨어 UID를 서버에 등록해서 이 물리 태그만 [pocketLabel]로 인정되게 한다.
-          final String? tagUid = _getTagUid(tag);
-          if (tagUid != null) {
-            await _registerTagUid(tagUid, pocketLabel);
-          }
-
-          if (mounted) {
-            _showSnackBar(
-              tagUid != null
-                  ? "✅ [$pocketLabel] 쓰기 + UID 등록 성공!"
-                  : "⚠️ [$pocketLabel] 쓰기는 성공했지만 UID를 못 읽어 등록은 안 됐습니다.",
-              tagUid != null ? Colors.green : Colors.orange,
-            );
-            // 다음 스티커를 연달아 쓰기 편하도록 번호를 자동으로 1 올려준다.
-            final int? n = int.tryParse(number);
-            setState(() {
-              if (n != null) _numberController.text = (n + 1).toString();
-              _statusMessage = "다음 번호를 확인하고 '쓰기 시작'을 다시 눌러주세요.";
-            });
-          }
-        } catch (e) {
-          _showSnackBar("❌ 쓰기 실패: $e", Colors.red);
-        } finally {
-          await NfcManager.instance.stopSession();
-          if (mounted) setState(() => _isWriting = false);
-        }
-      },
-    );
-  }
-
-  /// 태그의 공장 각인 하드웨어 UID를 16진수 문자열로 반환한다 (쓰기로 바꿀 수 없어 복제 방지 기준으로 씀).
-  String? _getTagUid(NfcTag tag) {
-    final id = NfcTagAndroid.from(tag)?.id;
-    if (id == null || id.isEmpty) return null;
-    return id.map((b) => b.toRadixString(16).padLeft(2, '0')).join().toUpperCase();
-  }
-
-  /// 서버에 "이 UID는 이 주머니 번호다"를 등록한다.
-  Future<void> _registerTagUid(String tagUid, String pocketLabel) async {
-    try {
-      await http.post(
-        Uri.parse("$baseUrl/api/pockets/register"),
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({"tagUid": tagUid, "pocketNumber": pocketLabel}),
-      );
-    } catch (e) {
-      _showSnackBar("❌ 서버에 UID 등록 실패: $e", Colors.red);
-    }
-  }
-
-  /// NFC Forum Text Record Type Definition에 맞춰 "언어코드+텍스트" 페이로드를 만든다.
-  NdefRecord _createTextRecord(String text) {
-    const languageCode = 'en';
-    final languageBytes = utf8.encode(languageCode);
-    final textBytes = utf8.encode(text);
-    final payload = Uint8List.fromList([
-      languageBytes.length, // 상태 바이트: UTF-8 + 언어코드 길이
-      ...languageBytes,
-      ...textBytes,
-    ]);
-    return NdefRecord(
-      typeNameFormat: TypeNameFormat.wellKnown,
-      type: Uint8List.fromList([0x54]), // 'T' = Text Record
-      identifier: Uint8List(0),
-      payload: payload,
-    );
-  }
-
-  void _showSnackBar(String text, Color color) {
-    if (!mounted) return;
-    ScaffoldMessenger.of(
-      context,
-    ).showSnackBar(SnackBar(content: Text(text), backgroundColor: color));
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(
-        title: const Text("🏷️ NFC 주머니 태그 쓰기"),
-        backgroundColor: Colors.deepPurple,
-        foregroundColor: Colors.white,
-      ),
-      body: Padding(
-        padding: const EdgeInsets.all(24.0),
-        child: Column(
-          mainAxisAlignment: MainAxisAlignment.center,
-          children: [
-            TextField(
-              controller: _numberController,
-              keyboardType: TextInputType.number,
-              enabled: !_isWriting,
-              decoration: const InputDecoration(
-                labelText: "주머니 번호",
-                prefixText: "POCKET_",
-                border: OutlineInputBorder(),
-              ),
-            ),
-            const SizedBox(height: 32),
-            Icon(
-              _isWriting ? Icons.nfc : Icons.edit_note_rounded,
-              size: 80,
-              color: _isWriting ? Colors.orange : Colors.deepPurple,
-            ),
-            const SizedBox(height: 16),
-            Text(
-              _statusMessage,
-              textAlign: TextAlign.center,
-              style: const TextStyle(fontSize: 15),
-            ),
-            const SizedBox(height: 32),
-            SizedBox(
-              width: double.infinity,
-              height: 55,
-              child: ElevatedButton(
-                style: ElevatedButton.styleFrom(
-                  backgroundColor: Colors.deepPurple,
-                  foregroundColor: Colors.white,
-                ),
-                onPressed: _isWriting ? null : _startWriteSession,
-                child: Text(
-                  _isWriting ? "태그를 기다리는 중..." : "쓰기 시작",
-                  style: const TextStyle(
-                    fontSize: 16,
-                    fontWeight: FontWeight.bold,
-                  ),
-                ),
-              ),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/screens/student_dashboard.dart

@@ -1,496 +0,0 @@
-// 🎓 학생 대시보드. NFC 주머니 체크인 진입, 실시간 학교 상황 안내,
-// 개발자 마스터 계정 전용 관리 메뉴(현황/DB제어/계정관리/삭제)를 담당한다.
-import 'dart:convert';
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import '../config.dart';
-import '../nfc_poccket_checkin_screen.dart';
-import 'login_screen.dart';
-import 'teacher_attendance_page.dart';
-import 'admin_dashboard.dart';
-import 'student_management_screen.dart';
-import 'nfc_tag_writer_screen.dart';
-
-// -------------------------------------------------------------
-// 2. 학생 대시보드 (StudentDashboard)
-// -------------------------------------------------------------
-
-class StudentDashboard extends StatefulWidget {
-  final String studentId;
-  final String studentName;
-  final bool isDeviceMatched; // 🆕 [변경] 기기 UUID가 매칭되었는지 확인하는 변수 추가
-
-  const StudentDashboard({
-    super.key,
-    required this.studentId,
-    required this.studentName,
-    required this.isDeviceMatched, // 🆕 [변경] 필수 매개변수로 등록
-  });
-
-  @override
-  State<StudentDashboard> createState() => _StudentDashboardState();
-}
-
-class _StudentDashboardState extends State<StudentDashboard> {
-  bool _isLoading = false;
-
-  // 1️⃣ NFC 태그 카드 → 실제 NFC 주머니 체크인 화면으로 이동
-  void _openPocketCheckIn(BuildContext context) {
-    Navigator.push(
-      context,
-      MaterialPageRoute(
-        builder: (context) => NfcPocketCheckInScreen(
-          studentId: widget.studentId,
-          studentName: widget.studentName,
-        ),
-      ),
-    );
-  }
-
-  // 2️⃣ [기존 동일] 마스터 계정 전용 회원 삭제 API 호출 함수
-  Future<void> _deleteUser(BuildContext context, String userId) async {
-    setState(() => _isLoading = true);
-    final url = Uri.parse('$baseUrl/api/users/delete/$userId');
-
-    try {
-      final response = await http.delete(url);
-
-      if (response.statusCode == 200) {
-        final responseData = jsonDecode(response.body);
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(SnackBar(content: Text('✅ ${responseData['message']}')));
-      } else {
-        final errorData = jsonDecode(response.body);
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(
-            content: Text('❌ 삭제 실패: ${errorData['detail'] ?? '알 수 없는 오류'}'),
-          ),
-        );
-      }
-    } catch (e) {
-      ScaffoldMessenger.of(context).showSnackBar(
-        const SnackBar(content: Text('❌ 서버와 연결할 수 없습니다. (네트워크 에러)')),
-      );
-    } finally {
-      setState(() => _isLoading = false);
-    }
-  }
-
-  // 3️⃣ [기존 동일] 학번/교직원 번호를 입력받는 모던 팝업창(Dialog)
-  void _showDeleteUserDialog(BuildContext context) {
-    final TextEditingController idController = TextEditingController();
-
-    showDialog(
-      context: context,
-      builder: (context) {
-        return AlertDialog(
-          shape: RoundedRectangleBorder(
-            borderRadius: BorderRadius.circular(24),
-          ),
-          title: const Row(
-            children: [
-              Icon(Icons.warning_amber_rounded, color: Colors.redAccent),
-              SizedBox(width: 10),
-              Text(
-                '계정 강제 삭제',
-                style: TextStyle(fontWeight: FontWeight.bold, fontSize: 18),
-              ),
-            ],
-          ),
-          content: Column(
-            mainAxisSize: MainAxisSize.min,
-            crossAxisAlignment: CrossAxisAlignment.start,
-            children: [
-              const Text(
-                '학생의 학번 또는 교사의 교직원 번호를 입력하세요.\nDB에서 해당 계정과 토큰이 즉시 삭제됩니다.',
-                style: TextStyle(
-                  color: Colors.black54,
-                  fontSize: 13,
-                  height: 1.4,
-                ),
-              ),
-              const SizedBox(height: 16),
-              TextField(
-                controller: idController,
-                decoration: InputDecoration(
-                  labelText: '학번 또는 교직원 번호',
-                  hintText: '예: 201101 또는 T1001',
-                  labelStyle: TextStyle(color: Colors.red[400]),
-                  focusedBorder: OutlineInputBorder(
-                    borderRadius: BorderRadius.circular(16),
-                    borderSide: BorderSide(color: Colors.red[400]!, width: 2),
-                  ),
-                  border: OutlineInputBorder(
-                    borderRadius: BorderRadius.circular(16),
-                  ),
-                  prefixIcon: const Icon(Icons.person_remove_alt_1_rounded),
-                ),
-              ),
-            ],
-          ),
-          actions: [
-            TextButton(
-              onPressed: () => Navigator.pop(context),
-              child: const Text(
-                '취소',
-                style: TextStyle(
-                  color: Colors.grey,
-                  fontWeight: FontWeight.bold,
-                ),
-              ),
-            ),
-            ElevatedButton(
-              onPressed: () {
-                final inputId = idController.text.trim();
-                if (inputId.isNotEmpty) {
-                  Navigator.pop(context);
-                  _deleteUser(context, inputId);
-                }
-              },
-              style: ElevatedButton.styleFrom(
-                backgroundColor: Colors.redAccent,
-                foregroundColor: Colors.white,
-                shape: RoundedRectangleBorder(
-                  borderRadius: BorderRadius.circular(12),
-                ),
-                elevation: 0,
-              ),
-              child: const Text(
-                '삭제 실행',
-                style: TextStyle(fontWeight: FontWeight.bold),
-              ),
-            ),
-          ],
-        );
-      },
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final bool isDeveloper = widget.studentId == "2061";
-
-    return Scaffold(
-      backgroundColor: Colors.grey[100],
-      appBar: AppBar(
-        title: Text(
-          isDeveloper ? '👑 MASTER CONTROL' : '🎓 STUDENT PORTAL',
-          style: const TextStyle(
-            fontWeight: FontWeight.bold,
-            letterSpacing: 1.2,
-          ),
-        ),
-        centerTitle: true,
-        backgroundColor: isDeveloper
-            ? Colors.deepPurple[700]
-            : Colors.indigo[700],
-        foregroundColor: Colors.white,
-        elevation: 0,
-        actions: [
-          IconButton(
-            icon: const Icon(Icons.logout_rounded),
-            onPressed: () => Navigator.pushReplacement(
-              context,
-              MaterialPageRoute(builder: (context) => const LoginScreen()),
-            ),
-          ),
-        ],
-      ),
-      body: SingleChildScrollView(
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            Container(
-              width: double.infinity,
-              padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 28),
-              decoration: BoxDecoration(
-                color: isDeveloper
-                    ? Colors.deepPurple[700]
-                    : Colors.indigo[700],
-                borderRadius: const BorderRadius.only(
-                  bottomLeft: Radius.circular(32),
-                  bottomRight: Radius.circular(32),
-                ),
-              ),
-              child: Row(
-                children: [
-                  Container(
-                    padding: const EdgeInsets.all(4),
-                    decoration: const BoxDecoration(
-                      color: Colors.white,
-                      shape: BoxShape.circle,
-                    ),
-                    child: CircleAvatar(
-                      radius: 30,
-                      backgroundColor: isDeveloper
-                          ? Colors.deepPurple[50]
-                          : Colors.indigo[50],
-                      child: Icon(
-                        isDeveloper
-                            ? Icons.admin_panel_settings_rounded
-                            : Icons.school_rounded,
-                        size: 32,
-                        color: isDeveloper ? Colors.deepPurple : Colors.indigo,
-                      ),
-                    ),
-                  ),
-                  const SizedBox(width: 18),
-                  Column(
-                    crossAxisAlignment: CrossAxisAlignment.start,
-                    children: [
-                      Text(
-                        '${widget.studentName} 님',
-                        style: const TextStyle(
-                          fontSize: 22,
-                          fontWeight: FontWeight.bold,
-                          color: Colors.white,
-                        ),
-                      ),
-                      const SizedBox(height: 4),
-                      Text(
-                        isDeveloper
-                            ? '최고 관리 권한 활성화됨'
-                            : '학번: ${widget.studentId} | 인증 완료',
-                        style: TextStyle(
-                          color: Colors.white.withValues(alpha: 0.8),
-                          fontSize: 14,
-                        ),
-                      ),
-                    ],
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 32),
-            Padding(
-              padding: const EdgeInsets.symmetric(horizontal: 24.0),
-              child: Row(
-                children: [
-                  Container(
-                    width: 4,
-                    height: 18,
-                    decoration: BoxDecoration(
-                      color: isDeveloper ? Colors.deepPurple : Colors.indigo,
-                      borderRadius: BorderRadius.circular(2),
-                    ),
-                  ),
-                  const SizedBox(width: 10),
-                  const Text(
-                    '스마트 관리 시스템 메뉴',
-                    style: TextStyle(
-                      fontSize: 18,
-                      fontWeight: FontWeight.bold,
-                      color: Colors.black87,
-                    ),
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 16),
-            Padding(
-              padding: const EdgeInsets.symmetric(horizontal: 24.0),
-              child: GridView.count(
-                shrinkWrap: true,
-                physics: const NeverScrollableScrollPhysics(),
-                crossAxisCount: 2,
-                crossAxisSpacing: 16,
-                mainAxisSpacing: 16,
-                childAspectRatio: 0.95,
-                children: [
-                  // 🆕 [변경 지점] 기기가 일치하면 정상 활성화, 일치하지 않으면 자물쇠Lock 처리
-                  if (isDeveloper || widget.studentId != "2061")
-                    _buildModernCard(
-                      icon: widget.isDeviceMatched
-                          ? Icons.contactless_rounded
-                          : Icons.lock_rounded,
-                      title: 'NFC 태그',
-                      subtitle: widget.isDeviceMatched
-                          ? '출석 및 폰 수거 완료'
-                          : '⚠️ 본인 인증 기기 전용',
-                      color: widget.isDeviceMatched
-                          ? Colors.blue
-                          : Colors.grey[400]!,
-                      onTap: widget.isDeviceMatched
-                          ? () => _openPocketCheckIn(context)
-                          : () {
-                              ScaffoldMessenger.of(context).showSnackBar(
-                                const SnackBar(
-                                  content: Text(
-                                    '🚨 대리 출석 방지를 위해 등록된 본인 스마트폰에서만 출석 가능합니다.',
-                                  ),
-                                ),
-                              );
-                            },
-                      isActionButton: widget.isDeviceMatched,
-                      isLoading: _isLoading,
-                    ),
-
-                  // 🆕 [추가 지점] 기기 일치 여부 상관없이 태블릿에서도 누구나 확인 가능한 학교 상황판 카드
-                  _buildModernCard(
-                    icon: Icons.fastfood_rounded,
-                    title: '실시간 학교 상황',
-                    subtitle: '급식실 줄 & 매점 재고 확인',
-                    color: Colors.orange[700]!,
-                    onTap: () {
-                      ScaffoldMessenger.of(context).showSnackBar(
-                        const SnackBar(
-                          content: Text('🍔 실시간 학교 상황 페이지로 이동합니다.'),
-                        ),
-                      );
-                    },
-                  ),
-
-                  if (isDeveloper)
-                    _buildModernCard(
-                      icon: Icons.monitor_heart_rounded,
-                      title: '실시간 현황',
-                      subtitle: '교사용 수거 모니터링',
-                      color: Colors.teal,
-                      onTap: () => Navigator.push(
-                        context,
-                        MaterialPageRoute(
-                          builder: (context) => const TeacherAttendancePage(),
-                        ),
-                      ),
-                    ),
-                  if (isDeveloper)
-                    _buildModernCard(
-                      icon: Icons.terminal_rounded,
-                      title: '서버 DB 제어',
-                      subtitle: '시스템 원격 초기화',
-                      color: Colors.amber[800]!,
-                      onTap: () => Navigator.push(
-                        context,
-                        MaterialPageRoute(
-                          builder: (context) => const AdminDashboard(),
-                        ),
-                      ),
-                    ),
-                  if (isDeveloper)
-                    _buildModernCard(
-                      icon: Icons.add_moderator_rounded,
-                      title: '학생 계정 관리',
-                      subtitle: 'UUID 리셋 및 승인',
-                      color: Colors.purple,
-                      onTap: () => Navigator.push(
-                        context,
-                        MaterialPageRoute(
-                          builder: (context) => const StudentManagementScreen(),
-                        ),
-                      ),
-                    ),
-                  if (isDeveloper)
-                    _buildModernCard(
-                      icon: Icons.delete_sweep_rounded,
-                      title: '계정 강제 삭제',
-                      subtitle: '학생 및 교사 DB 삭제',
-                      color: Colors.red[600]!,
-                      onTap: () => _showDeleteUserDialog(context),
-                    ),
-                  if (isDeveloper)
-                    _buildModernCard(
-                      icon: Icons.edit_note_rounded,
-                      title: 'NFC 태그 쓰기',
-                      subtitle: '주머니 스티커 초기 설정',
-                      color: Colors.deepPurple,
-                      onTap: () => Navigator.push(
-                        context,
-                        MaterialPageRoute(
-                          builder: (context) => const NfcTagWriterScreen(),
-                        ),
-                      ),
-                    ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 32),
-          ],
-        ),
-      ),
-    );
-  }
-
-  // 5️⃣ [카드 디자인 위젯] - 기존 형태 완전 보존
-  Widget _buildModernCard({
-    required IconData icon,
-    required String title,
-    required String subtitle,
-    required Color color,
-    required VoidCallback onTap,
-    bool isActionButton = false,
-    bool isLoading = false,
-  }) {
-    return InkWell(
-      onTap: isLoading ? null : onTap,
-      borderRadius: BorderRadius.circular(24),
-      child: Ink(
-        padding: const EdgeInsets.all(20),
-        decoration: BoxDecoration(
-          color: Colors.white,
-          borderRadius: BorderRadius.circular(24),
-          boxShadow: [
-            BoxShadow(
-              color: Colors.black.withValues(alpha: 0.04),
-              blurRadius: 16,
-              offset: const Offset(0, 4),
-            ),
-          ],
-        ),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          mainAxisAlignment: MainAxisAlignment.spaceBetween,
-          children: [
-            Container(
-              padding: const EdgeInsets.all(12),
-              decoration: BoxDecoration(
-                color: color.withValues(alpha: 0.1),
-                borderRadius: BorderRadius.circular(16),
-              ),
-              child: Icon(icon, color: color, size: 28),
-            ),
-            Column(
-              crossAxisAlignment: CrossAxisAlignment.start,
-              children: [
-                Row(
-                  mainAxisAlignment: MainAxisAlignment.spaceBetween,
-                  children: [
-                    Text(
-                      title,
-                      style: const TextStyle(
-                        fontSize: 16,
-                        fontWeight: FontWeight.bold,
-                        color: Colors.black87,
-                      ),
-                    ),
-                    if (isLoading)
-                      const SizedBox(
-                        width: 16,
-                        height: 16,
-                        child: CircularProgressIndicator(strokeWidth: 2),
-                      )
-                    else if (isActionButton)
-                      Icon(
-                        Icons.touch_app_rounded,
-                        size: 16,
-                        color: color.withValues(alpha: 0.5),
-                      ),
-                  ],
-                ),
-                const SizedBox(height: 4),
-                Text(
-                  subtitle,
-                  style: TextStyle(
-                    fontSize: 12,
-                    color: Colors.grey[500],
-                    height: 1.2,
-                  ),
-                ),
-              ],
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/screens/student_management_screen.dart

@@ -1,338 +0,0 @@
-// 🔐 (마스터 계정용) 학생 계정 및 기기 관리 화면. 기기 UUID 초기화와 계정 삭제를 담당한다.
-import 'dart:convert';
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import '../config.dart';
-
-// ==========================================
-// 🔐 6. 학생 계정 및 기기 관리 화면 (기기 리셋 + 계정 삭제 완본)
-// ==========================================
-class StudentManagementScreen extends StatefulWidget {
-  const StudentManagementScreen({super.key});
-
-  @override
-  State<StudentManagementScreen> createState() =>
-      _StudentManagementScreenState();
-}
-
-class _StudentManagementScreenState extends State<StudentManagementScreen> {
-  List<dynamic> realStudents = [];
-  bool _isLoading = true;
-
-  @override
-  void initState() {
-    super.initState();
-    _fetchStudents();
-  }
-
-  // 🌐 서버에서 전체 학생 목록 불러오기
-  Future<void> _fetchStudents() async {
-    setState(() => _isLoading = true);
-    try {
-      final response = await http.get(Uri.parse('$baseUrl/api/users'));
-      if (response.statusCode == 200) {
-        final data = jsonDecode(utf8.decode(response.bodyBytes));
-        setState(() {
-          realStudents = data['users'] ?? [];
-          _isLoading = false;
-        });
-      }
-    } catch (e) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(SnackBar(content: Text('데이터 불러오기 실패: $e')));
-      setState(() => _isLoading = false);
-    }
-  }
-
-  // 🌐 서버로 기기 초기화(리셋) 명령 보내기
-  Future<void> _resetDevice(String studentId, String studentName) async {
-    showDialog(
-      context: context,
-      builder: (ctx) => AlertDialog(
-        title: const Text(
-          '⚠️ 기기 잠금 해제',
-          style: TextStyle(fontWeight: FontWeight.bold, color: Colors.purple),
-        ),
-        content: Text('$studentName 학생의 스마트폰 기기 등록을 초기화하시겠습니까?'),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(ctx),
-            child: const Text('취소', style: TextStyle(color: Colors.grey)),
-          ),
-          ElevatedButton(
-            style: ElevatedButton.styleFrom(
-              backgroundColor: Colors.purple,
-              foregroundColor: Colors.white,
-            ),
-            onPressed: () async {
-              Navigator.pop(ctx);
-              try {
-                final response = await http.post(
-                  Uri.parse('$baseUrl/api/users/reset'),
-                  headers: {"Content-Type": "application/json"},
-                  body: jsonEncode({"studentId": studentId}),
-                );
-                if (response.statusCode == 200) {
-                  ScaffoldMessenger.of(context).showSnackBar(
-                    SnackBar(content: Text('✅ $studentName 학생 기기 초기화 완료!')),
-                  );
-                  _fetchStudents();
-                }
-              } catch (e) {
-                ScaffoldMessenger.of(
-                  context,
-                ).showSnackBar(const SnackBar(content: Text('❌ 초기화 통신 실패')));
-              }
-            },
-            child: const Text('초기화 승인'),
-          ),
-        ],
-      ),
-    );
-  }
-
-  // 🌐 [새 기능] 서버로 계정 완전 삭제 명령 보내기 함수
-  Future<void> _deleteUser(String studentId, String studentName) async {
-    showDialog(
-      context: context,
-      builder: (ctx) => AlertDialog(
-        title: const Text(
-          '🚨 계정 완전 삭제 경고',
-          style: TextStyle(fontWeight: FontWeight.bold, color: Colors.red),
-        ),
-        content: Text(
-          '정말로 $studentName ($studentId) 학생의 계정을 시스템에서 탈퇴(삭제)시키겠습니까?\n\n이 작업은 되돌릴 수 없으며, 해당 학생은 다시 회원가입을 진행해야 합니다.',
-        ),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(ctx),
-            child: const Text('취소', style: TextStyle(color: Colors.grey)),
-          ),
-          ElevatedButton(
-            style: ElevatedButton.styleFrom(
-              backgroundColor: Colors.red,
-              foregroundColor: Colors.white,
-            ),
-            onPressed: () async {
-              Navigator.pop(ctx);
-              try {
-                // 💡 http.delete 함수를 사용하여 서버에 계정 삭제 요청 발송!
-                final response = await http.delete(
-                  Uri.parse('$baseUrl/api/users/delete'),
-                  headers: {"Content-Type": "application/json"},
-                  body: jsonEncode({"studentId": studentId}),
-                );
-
-                if (response.statusCode == 200) {
-                  ScaffoldMessenger.of(context).showSnackBar(
-                    SnackBar(
-                      content: Text('💥 $studentName 학생의 계정이 영구 삭제되었습니다.'),
-                    ),
-                  );
-                  _fetchStudents(); // 성공하면 목록 새로고침!
-                }
-              } catch (e) {
-                ScaffoldMessenger.of(
-                  context,
-                ).showSnackBar(const SnackBar(content: Text('❌ 계정 삭제 통신 실패')));
-              }
-            },
-            child: const Text('영구 삭제'),
-          ),
-        ],
-      ),
-    );
-  }
-
-  // 💡 _StudentManagementScreenState 클래스 내부에 붙여넣으세요.
-  void _showCreateUserDialog() {
-    final idController = TextEditingController();
-    final nameController = TextEditingController();
-
-    showDialog(
-      context: context,
-      builder: (context) => AlertDialog(
-        title: const Text('👤 신규 학생 계정 추가'),
-        content: Column(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            TextField(
-              controller: idController,
-              decoration: const InputDecoration(labelText: '학번 입력 (예: 20101)'),
-              keyboardType: TextInputType.number,
-            ),
-            const SizedBox(height: 8),
-            TextField(
-              controller: nameController,
-              decoration: const InputDecoration(labelText: '학생 이름 입력'),
-            ),
-          ],
-        ),
-        actions: [
-          TextButton(
-            onPressed: () => Navigator.pop(context),
-            child: const Text('취소'),
-          ),
-          ElevatedButton(
-            onPressed: () async {
-              String studentId = idController.text.trim();
-              String name = nameController.text.trim();
-
-              if (studentId.isEmpty || name.isEmpty) {
-                ScaffoldMessenger.of(context).showSnackBar(
-                  const SnackBar(content: Text('⚠️ 학번과 이름을 모두 입력하세요.')),
-                );
-                return;
-              }
-
-              try {
-                // ⚠️ 여기도 훗춧가룻님의 프로젝트 전역 baseUrl 변수명으로 맞춰주세요!
-                final response = await http.post(
-                  Uri.parse('$baseUrl/api/users/create'),
-                  headers: {"Content-Type": "application/json"},
-                  body: jsonEncode({"studentId": studentId, "name": name}),
-                );
-
-                final res = jsonDecode(response.body);
-                if (res['status'] == 'success') {
-                  Navigator.pop(context); // 팝업 닫기
-                  ScaffoldMessenger.of(context).showSnackBar(
-                    SnackBar(content: Text('✅ ${res['message']}')),
-                  );
-                  _fetchStudents(); // 🔄 추가 완료 후 목록 새로고침 (기존 함수명 확인 필요)
-                } else {
-                  ScaffoldMessenger.of(context).showSnackBar(
-                    SnackBar(content: Text('❌ ${res['message']}')),
-                  );
-                }
-              } catch (e) {
-                ScaffoldMessenger.of(context).showSnackBar(
-                  const SnackBar(content: Text('❌ 학생 등록 실패 (통신 에러)')),
-                );
-              }
-            },
-            child: const Text('생성'),
-          ),
-        ],
-      ),
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      backgroundColor: Colors.grey[50],
-      appBar: AppBar(
-        title: const Text(
-          '학생 계정 및 기기 관리',
-          style: TextStyle(fontWeight: FontWeight.bold),
-        ),
-        backgroundColor: Colors.purple,
-        foregroundColor: Colors.white,
-        actions: [
-          IconButton(
-            icon: const Icon(Icons.person_add_alt_1_rounded),
-            onPressed: () => _showCreateUserDialog(), // 팝업 띄우는 함수 제작하여 연결
-          ),
-          IconButton(
-            icon: const Icon(Icons.refresh),
-            onPressed: _fetchStudents,
-          ),
-        ],
-      ),
-      body: _isLoading
-          ? const Center(child: CircularProgressIndicator(color: Colors.purple))
-          : realStudents.isEmpty
-          ? const Center(
-              child: Text(
-                '가입된 학생 계정이 없습니다.',
-                style: TextStyle(color: Colors.grey, fontSize: 16),
-              ),
-            )
-          : ListView.builder(
-              padding: const EdgeInsets.all(16),
-              itemCount: realStudents.length,
-              itemBuilder: (context, index) {
-                final student = realStudents[index];
-                final bool needsReset = student['device'] == "초기화 필요";
-
-                return Card(
-                  elevation: 2,
-                  margin: const EdgeInsets.only(bottom: 12),
-                  shape: RoundedRectangleBorder(
-                    borderRadius: BorderRadius.circular(16),
-                  ),
-                  child: ListTile(
-                    contentPadding: const EdgeInsets.symmetric(
-                      horizontal: 16,
-                      vertical: 12,
-                    ),
-                    leading: CircleAvatar(
-                      backgroundColor: needsReset
-                          ? Colors.red[50]
-                          : Colors.purple[50],
-                      child: Icon(
-                        needsReset ? Icons.lock_reset : Icons.person,
-                        color: needsReset ? Colors.red : Colors.purple,
-                      ),
-                    ),
-                    title: Text(
-                      '${student['name']} (${student['id']})',
-                      style: const TextStyle(
-                        fontWeight: FontWeight.bold,
-                        fontSize: 16,
-                      ),
-                    ),
-                    subtitle: Text(
-                      needsReset ? '기기 초기화 승인 대기중' : '정상 등록 상태',
-                      style: TextStyle(
-                        color: needsReset ? Colors.red : Colors.grey,
-                        fontWeight: needsReset
-                            ? FontWeight.bold
-                            : FontWeight.normal,
-                      ),
-                    ),
-                    // 🕹️ 오른쪽 끝에 [기기 리셋] 버튼과 [쓰레기통(삭제)] 버튼을 나란히 배치하는 Row 레이아웃 기획
-                    trailing: Row(
-                      mainAxisSize: MainAxisSize.min, // 콤팩트하게 뭉치기
-                      children: [
-                        if (!needsReset)
-                          OutlinedButton(
-                            style: OutlinedButton.styleFrom(
-                              foregroundColor: Colors.purple,
-                              side: BorderSide(
-                                color: Colors.purple.withValues(alpha: 0.5),
-                              ),
-                              shape: RoundedRectangleBorder(
-                                borderRadius: BorderRadius.circular(8),
-                              ),
-                            ),
-                            onPressed: () =>
-                                _resetDevice(student['id'], student['name']),
-                            child: const Text('기기 리셋'),
-                          )
-                        else
-                          const Icon(Icons.check_circle, color: Colors.green),
-
-                        const SizedBox(width: 8),
-
-                        // 🔴 [새 버튼] 최고권한 마스터 전용 계정 영구 삭제 쓰레기통 버튼!
-                        IconButton(
-                          icon: const Icon(
-                            Icons.delete_forever_rounded,
-                            color: Colors.redAccent,
-                          ),
-                          tooltip: '계정 영구 삭제',
-                          onPressed: () =>
-                              _deleteUser(student['id'], student['name']),
-                        ),
-                      ],
-                    ),
-                  ),
-                );
-              },
-            ),
-    );
-  }
-}

lib/screens/teacher_dashboard.dart

@@ -1,273 +0,0 @@
-// 👨‍🏫 교사 대시보드. 실시간 출석 확인, 학생 계정 관리 화면으로 가는 메뉴만 담당한다.
-import 'package:flutter/material.dart';
-import 'login_screen.dart';
-import 'teacher_attendance_page.dart';
-import 'teacher_student_management_page.dart';
-
-// ==========================================
-// 👨‍🏫 4. 선생님 대시보드 (기존 3초 타이머 완벽 유지)
-// ==========================================
-class TeacherDashboard extends StatefulWidget {
-  final String? teacherId;
-  final String? teacherName;
-
-  const TeacherDashboard({super.key, this.teacherId, this.teacherName});
-
-  @override
-  State<TeacherDashboard> createState() => _TeacherDashboardState();
-}
-
-class _TeacherDashboardState extends State<TeacherDashboard> {
-  // 🧼 [수정] 사용하지 않던 _isLoading 변수를 삭제하여 경고를 완벽히 해결했습니다!
-
-  @override
-  Widget build(BuildContext context) {
-    // 다른 화면에서 null이 넘어왔을 때를 대비한 안전망 방탄 코드
-    final String displayName = widget.teacherName ?? "간편인증 선생";
-    final String displayId = widget.teacherId ?? "간편인증";
-
-    return Scaffold(
-      backgroundColor: Colors.grey[100],
-      appBar: AppBar(
-        title: const Text(
-          '👨‍🏫 TEACHER PORTAL',
-          style: TextStyle(fontWeight: FontWeight.bold, letterSpacing: 1.2),
-        ),
-        centerTitle: true,
-        backgroundColor: Colors.green[700], // 교사 전용 그린 테마 컬러
-        foregroundColor: Colors.white,
-        elevation: 0,
-        actions: [
-          IconButton(
-            icon: const Icon(Icons.logout_rounded),
-            onPressed: () => Navigator.pushReplacement(
-              context,
-              MaterialPageRoute(builder: (context) => const LoginScreen()),
-            ),
-          ),
-        ],
-      ),
-      body: SingleChildScrollView(
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            // 💳 [상단 배너 가이드] StudentDashboard와 100% 일치하는 프로필 카드 레이아웃
-            Container(
-              width: double.infinity,
-              padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 28),
-              decoration: BoxDecoration(
-                color: Colors.green[700],
-                borderRadius: const BorderRadius.only(
-                  bottomLeft: Radius.circular(32),
-                  bottomRight: Radius.circular(32),
-                ),
-              ),
-              child: Row(
-                children: [
-                  Container(
-                    padding: const EdgeInsets.all(4),
-                    decoration: const BoxDecoration(
-                      color: Colors.white,
-                      shape: BoxShape.circle,
-                    ),
-                    child: CircleAvatar(
-                      radius: 30,
-                      backgroundColor: Colors.green[50],
-                      child: Icon(
-                        Icons.admin_panel_settings_rounded,
-                        size: 32,
-                        color: Colors.green[700],
-                      ),
-                    ),
-                  ),
-                  const SizedBox(width: 18),
-                  Column(
-                    crossAxisAlignment: CrossAxisAlignment.start,
-                    children: [
-                      Text(
-                        '$displayName 님',
-                        style: const TextStyle(
-                          fontSize: 22,
-                          fontWeight: FontWeight.bold,
-                          color: Colors.white,
-                        ),
-                      ),
-                      const SizedBox(height: 4),
-                      Text(
-                        '교직원 번호: $displayId | 교사 권한 활성화됨',
-                        style: TextStyle(
-                          color: Colors.white.withValues(alpha: 0.8),
-                          fontSize: 14,
-                        ),
-                      ),
-                    ],
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 32),
-
-            // 🏷️ [세로 바 타이틀 인디케이터] 구조 일치화
-            Padding(
-              padding: const EdgeInsets.symmetric(horizontal: 24.0),
-              child: Row(
-                children: [
-                  Container(
-                    width: 4,
-                    height: 18,
-                    decoration: BoxDecoration(
-                      color: Colors.green[700],
-                      borderRadius: BorderRadius.circular(2),
-                    ),
-                  ),
-                  const SizedBox(width: 10),
-                  const Text(
-                    '스마트 교사용 관리 메뉴',
-                    style: TextStyle(
-                      fontSize: 18,
-                      fontWeight: FontWeight.bold,
-                      color: Colors.black87,
-                    ),
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 16),
-
-            // 📊 [그리드 레이아웃 메뉴] 시후의 카드 컴포넌트 스타일 적용
-            // 🖥️ 데스크톱 브라우저에서 카드가 지나치게 커지지 않도록 최대 너비를 제한한다.
-            Center(
-              child: ConstrainedBox(
-                constraints: const BoxConstraints(maxWidth: 700),
-                child: Padding(
-                  padding: const EdgeInsets.symmetric(horizontal: 24.0),
-                  child: GridView.count(
-                    shrinkWrap: true,
-                    physics: const NeverScrollableScrollPhysics(),
-                    crossAxisCount: 2,
-                    crossAxisSpacing: 16,
-                    mainAxisSpacing: 16,
-                    childAspectRatio: 0.95,
-                    children: [
-                  _buildModernCard(
-                    icon: Icons.assignment_turned_in_rounded,
-                    title: '실시간 출석 확인',
-                    subtitle: '학생 제출 로그 모니터링',
-                    color: Colors.blue,
-                    onTap: () => Navigator.push(
-                      context,
-                      MaterialPageRoute(
-                        builder: (context) => const TeacherAttendancePage(),
-                      ),
-                    ),
-                  ),
-                  _buildModernCard(
-                    icon: Icons.manage_accounts_rounded,
-                    title: '학생 계정 관리',
-                    subtitle: '계정 추가 및 강제 리셋',
-                    color: Colors.orange,
-                    onTap: () => Navigator.push(
-                      context,
-                      MaterialPageRoute(
-                        builder: (context) =>
-                            const TeacherStudentManagementPage(),
-                      ),
-                    ),
-                  ),
-                    ],
-                  ),
-                ),
-              ),
-            ),
-            const SizedBox(height: 32),
-          ],
-        ),
-      ),
-    );
-  }
-
-  // 💎 [시후 대시보드 전용 카드 위젯 이식 완료]
-  Widget _buildModernCard({
-    required IconData icon,
-    required String title,
-    required String subtitle,
-    required Color color,
-    required VoidCallback onTap,
-    bool isActionButton = false,
-    bool isLoading = false,
-  }) {
-    return InkWell(
-      onTap: isLoading ? null : onTap,
-      borderRadius: BorderRadius.circular(24),
-      child: Ink(
-        padding: const EdgeInsets.all(20),
-        decoration: BoxDecoration(
-          color: Colors.white,
-          borderRadius: BorderRadius.circular(24),
-          boxShadow: [
-            BoxShadow(
-              color: Colors.black.withValues(alpha: 0.04),
-              blurRadius: 16,
-              offset: const Offset(0, 4),
-            ),
-          ],
-        ),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          mainAxisAlignment: MainAxisAlignment.spaceBetween,
-          children: [
-            Container(
-              padding: const EdgeInsets.all(12),
-              decoration: BoxDecoration(
-                color: color.withValues(alpha: 0.1),
-                borderRadius: BorderRadius.circular(16),
-              ),
-              child: Icon(icon, color: color, size: 28),
-            ),
-            Column(
-              crossAxisAlignment: CrossAxisAlignment.start,
-              children: [
-                Row(
-                  mainAxisAlignment: MainAxisAlignment.spaceBetween,
-                  children: [
-                    Expanded(
-                      child: Text(
-                        title,
-                        style: const TextStyle(
-                          fontSize: 15,
-                          fontWeight: FontWeight.bold,
-                          color: Colors.black87,
-                        ),
-                      ),
-                    ),
-                    if (isLoading)
-                      const SizedBox(
-                        width: 16,
-                        height: 16,
-                        child: CircularProgressIndicator(strokeWidth: 2),
-                      )
-                    else if (isActionButton)
-                      Icon(
-                        Icons.touch_app_rounded,
-                        size: 16,
-                        color: color.withValues(alpha: 0.5),
-                      ),
-                  ],
-                ),
-                const SizedBox(height: 4),
-                Text(
-                  subtitle,
-                  style: TextStyle(
-                    fontSize: 12,
-                    color: Colors.grey[500],
-                    height: 1.2,
-                  ),
-                ),
-              ],
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/screens/teacher_register_screen.dart

@@ -1,152 +0,0 @@
-// 👨‍🏫 교사 회원가입 화면. 교사 인증 코드 확인 후 신규 교사 계정을 생성한다.
-import 'dart:convert';
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import '../config.dart';
-
-class TeacherRegisterScreen extends StatefulWidget {
-  const TeacherRegisterScreen({super.key});
-
-  @override
-  State<TeacherRegisterScreen> createState() => _TeacherRegisterScreenState();
-}
-
-class _TeacherRegisterScreenState extends State<TeacherRegisterScreen> {
-  final _idController = TextEditingController();
-  final _pwController = TextEditingController();
-  final _nameController = TextEditingController();
-  final _secretController = TextEditingController();
-  bool _isLoading = false;
-
-  Future<void> _registerTeacher() async {
-    String id = _idController.text.trim();
-    String pw = _pwController.text.trim();
-    String name = _nameController.text.trim();
-    String secret = _secretController.text.trim();
-
-    // 💡 테스트용 고유값 (실제 디바이스 UUID 연동 로직이 있다면 그걸 넣으세요)
-    String dummyUuid = "TEACHER_PHONE_$id";
-
-    if (id.isEmpty || pw.isEmpty || name.isEmpty || secret.isEmpty) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(const SnackBar(content: Text('⚠️ 모든 빈칸을 입력해 주세요.')));
-      return;
-    }
-
-    setState(() => _isLoading = true);
-    try {
-      final response = await http.post(
-        Uri.parse('$baseUrl/api/users/register-teacher'),
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({
-          "teacherId": id,
-          "password": pw,
-          "name": name,
-          "secretCode": secret,
-          "deviceUuid": dummyUuid,
-        }),
-      );
-
-      final res = jsonDecode(response.body);
-
-      if (response.statusCode == 200 && res['status'] == 'success') {
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(SnackBar(content: Text('✅ ${res['message']}')));
-        Navigator.pop(context); // 가입 성공 시 로그인 화면으로 복귀
-      } else {
-        // 백엔드에서 보낸 에러 메시지(detail 혹은 message) 출력
-        String errorMsg = res['detail'] ?? res['message'] ?? '회원가입에 실패했습니다.';
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(SnackBar(content: Text('❌ $errorMsg')));
-      }
-    } catch (e) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(const SnackBar(content: Text('❌ 서버와 통신에 실패했습니다.')));
-    } finally {
-      setState(() => _isLoading = false);
-    }
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(
-        title: const Text('교사 회원가입'),
-        backgroundColor: Colors.indigo,
-        foregroundColor: Colors.white,
-      ),
-      body: SingleChildScrollView(
-        padding: const EdgeInsets.all(24.0),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            const Text(
-              '👨‍🏫 교직원 전용 인증',
-              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
-            ),
-            const SizedBox(height: 4),
-            const Text(
-              '학교에서 발급한 교사 가입 비밀코드가 필요합니다.',
-              style: TextStyle(color: Colors.grey),
-            ),
-            const SizedBox(height: 24),
-            TextField(
-              controller: _secretController,
-              obscureText: true,
-              decoration: const InputDecoration(
-                labelText: '🔑 교사 인증 비밀코드 입력',
-                border: OutlineInputBorder(),
-              ),
-            ),
-            const SizedBox(height: 16),
-            const Divider(),
-            const SizedBox(height: 16),
-            TextField(
-              controller: _idController,
-              decoration: const InputDecoration(
-                labelText: '교직원 번호 (ID로 사용)',
-                border: OutlineInputBorder(),
-              ),
-            ),
-            const SizedBox(height: 12),
-            TextField(
-              controller: _nameController,
-              decoration: const InputDecoration(
-                labelText: '선생님 성함',
-                border: OutlineInputBorder(),
-              ),
-            ),
-            const SizedBox(height: 12),
-            TextField(
-              controller: _pwController,
-              obscureText: true,
-              decoration: const InputDecoration(
-                labelText: '사용할 비밀번호 입력',
-                border: OutlineInputBorder(),
-              ),
-            ),
-            const SizedBox(height: 24),
-            SizedBox(
-              width: double.infinity,
-              height: 50,
-              child: ElevatedButton(
-                style: ElevatedButton.styleFrom(
-                  backgroundColor: Colors.indigo,
-                  foregroundColor: Colors.white,
-                ),
-                onPressed: _isLoading ? null : _registerTeacher,
-                child: _isLoading
-                    ? const CircularProgressIndicator(color: Colors.white)
-                    : const Text('교사 계정 생성하기'),
-              ),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/screens/teacher_student_management_page.dart

@@ -1,363 +0,0 @@
-// 👥 교사용 학생 계정 관리 화면. 신규 학생 계정 추가와 계정 강제 삭제를 담당한다.
-import 'dart:convert';
-import 'package:flutter/material.dart';
-import 'package:http/http.dart' as http;
-import '../config.dart';
-
-// -----------------------------------------------------------------------------
-// 👥 [서브 화면 2] 학생 계정 관리 란 (추가 양식 폼 + 강제 삭제 다이얼로그 완전 내장)
-// -----------------------------------------------------------------------------
-class TeacherStudentManagementPage extends StatefulWidget {
-  const TeacherStudentManagementPage({super.key});
-
-  @override
-  State<TeacherStudentManagementPage> createState() =>
-      _TeacherStudentManagementPageState();
-}
-
-class _TeacherStudentManagementPageState
-    extends State<TeacherStudentManagementPage> {
-  final TextEditingController _addIdController = TextEditingController();
-  final TextEditingController _addNameController = TextEditingController();
-  final TextEditingController _addPwController = TextEditingController();
-  bool _isWorking = false;
-
-  // ➕ [학생 추가 API 연동용 함수]
-  
-  Future<void> _addStudentAccount() async {
-    final sId = _addIdController.text.trim();
-    final sName = _addNameController.text.trim();
-    final sPw = _addPwController.text.trim();
-
-    if (sId.isEmpty || sName.isEmpty || sPw.isEmpty) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(const SnackBar(content: Text('⚠️ 모든 입력란을 채워주세요.')));
-      return;
-    }
-
-    setState(() => _isWorking = true);
-    try {
-      final url = Uri.parse('$baseUrl/api/users/register-student');
-      final response = await http.post(
-        url,
-        headers: {"Content-Type": "application/json"},
-        body: jsonEncode({"studentId": sId, "name": sName, "password": sPw}),
-      );
-      final result = jsonDecode(utf8.decode(response.bodyBytes));
-
-      if (response.statusCode == 200 || response.statusCode == 201) {
-        _addIdController.clear();
-        _addNameController.clear();
-        _addPwController.clear();
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(content: Text('✅ 계정 생성 완료: ${result['message'] ?? '성공'}')),
-        );
-      } else {
-        ScaffoldMessenger.of(context).showSnackBar(
-          SnackBar(content: Text('❌ 생성 실패: ${result['message'] ?? '오류 발생'}')),
-        );
-      }
-    } catch (e) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(SnackBar(content: Text('🚨 네트워크 에러: $e')));
-    } finally {
-      setState(() => _isWorking = false);
-    }
-  }
-  
-  // ❌ [학생 삭제 API 연동용 함수]
-  Future<void> _deleteStudentAccount(String studentId) async {
-    setState(() => _isWorking = true);
-    final url = Uri.parse('$baseUrl/api/users/delete/$studentId');
-
-    try {
-      final response = await http.delete(url);
-      if (response.statusCode == 200) {
-        final resData = jsonDecode(utf8.decode(response.bodyBytes));
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(SnackBar(content: Text('✅ ${resData['message']}')));
-      } else {
-        ScaffoldMessenger.of(
-          context,
-        ).showSnackBar(const SnackBar(content: Text('❌ 삭제 실패하였습니다.')));
-      }
-    } catch (e) {
-      ScaffoldMessenger.of(
-        context,
-      ).showSnackBar(const SnackBar(content: Text('❌ 서버 에러 발생')));
-    } finally {
-      setState(() => _isWorking = false);
-    }
-  }
-
-  // 🚨 계정 삭제 확인 팝업창 모달
-  void _showDeleteDialog() {
-    final TextEditingController deleteIdController = TextEditingController();
-    showDialog(
-      context: context,
-      builder: (context) {
-        return AlertDialog(
-          shape: RoundedRectangleBorder(
-            borderRadius: BorderRadius.circular(24),
-          ),
-          title: Row(
-            children: [
-              Icon(Icons.warning_amber_rounded, color: Colors.orange[700]),
-              const SizedBox(width: 10),
-              const Text(
-                '학생 계정 강제 삭제',
-                style: TextStyle(fontWeight: FontWeight.bold, fontSize: 18),
-              ),
-            ],
-          ),
-          content: Column(
-            mainAxisSize: MainAxisSize.min,
-            children: [
-              const Text(
-                '영구 삭제할 학생의 학번을 정확하게 입력하세요.',
-                style: TextStyle(color: Colors.black54, fontSize: 13),
-              ),
-              const SizedBox(height: 16),
-              TextField(
-                controller: deleteIdController,
-                keyboardType: TextInputType.number,
-                decoration: InputDecoration(
-                  labelText: '학번 입력',
-                  labelStyle: TextStyle(color: Colors.orange[700]),
-                  focusedBorder: OutlineInputBorder(
-                    borderRadius: BorderRadius.circular(16),
-                    borderSide: BorderSide(
-                      color: Colors.orange[700]!,
-                      width: 2,
-                    ),
-                  ),
-                  border: OutlineInputBorder(
-                    borderRadius: BorderRadius.circular(16),
-                  ),
-                  prefixIcon: const Icon(Icons.no_accounts_rounded),
-                ),
-              ),
-            ],
-          ),
-          actions: [
-            TextButton(
-              onPressed: () => Navigator.pop(context),
-              child: const Text('취소', style: TextStyle(color: Colors.grey)),
-            ),
-            ElevatedButton(
-              onPressed: () {
-                final inputId = deleteIdController.text.trim();
-                if (inputId.isNotEmpty) {
-                  Navigator.pop(context);
-                  _deleteStudentAccount(inputId);
-                }
-              },
-              style: ElevatedButton.styleFrom(
-                backgroundColor: Colors.orange[700],
-                foregroundColor: Colors.white,
-                shape: RoundedRectangleBorder(
-                  borderRadius: BorderRadius.circular(12),
-                ),
-              ),
-              child: const Text(
-                '삭제 확정',
-                style: TextStyle(fontWeight: FontWeight.bold),
-              ),
-            ),
-          ],
-        );
-      },
-    );
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      backgroundColor: Colors.grey[100],
-      appBar: AppBar(
-        title: const Text(
-          '⚙️ 학생 통합 관리 센터',
-          style: TextStyle(fontWeight: FontWeight.bold),
-        ),
-        backgroundColor: Colors.orange,
-        foregroundColor: Colors.white,
-        elevation: 0,
-      ),
-      body: SingleChildScrollView(
-        padding: const EdgeInsets.all(24.0),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            // 🏷️ 인디케이터 바 1 (추가 메뉴)
-            Row(
-              children: [
-                Container(
-                  width: 4,
-                  height: 16,
-                  decoration: BoxDecoration(
-                    color: Colors.orange,
-                    borderRadius: BorderRadius.circular(2),
-                  ),
-                ),
-                const SizedBox(width: 8),
-                const Text(
-                  '신규 학생 계정 추가',
-                  style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
-                ),
-              ],
-            ),
-            const SizedBox(height: 16),
-
-            // 📝 학생 추가 컨테이너 폼
-            Container(
-              padding: const EdgeInsets.all(20),
-              decoration: BoxDecoration(
-                color: Colors.white,
-                borderRadius: BorderRadius.circular(24),
-                boxShadow: [
-                  BoxShadow(
-                    color: Colors.black.withValues(alpha: 0.04),
-                    blurRadius: 16,
-                  ),
-                ],
-              ),
-              child: Column(
-                children: [
-                  TextField(
-                    controller: _addIdController,
-                    keyboardType: TextInputType.number,
-                    decoration: const InputDecoration(
-                      labelText: '학번',
-                      prefixIcon: Icon(Icons.badge),
-                    ),
-                  ),
-                  const SizedBox(height: 12),
-                  TextField(
-                    controller: _addNameController,
-                    decoration: const InputDecoration(
-                      labelText: '이름',
-                      prefixIcon: Icon(Icons.person),
-                    ),
-                  ),
-                  const SizedBox(height: 12),
-                  TextField(
-                    controller: _addPwController,
-                    obscureText: true,
-                    decoration: const InputDecoration(
-                      labelText: '초기 비밀번호',
-                      prefixIcon: Icon(Icons.lock),
-                    ),
-                  ),
-                  const SizedBox(height: 20),
-                  SizedBox(
-                    width: double.infinity,
-                    height: 50,
-                    child: ElevatedButton(
-                      onPressed: _isWorking ? null : _addStudentAccount,
-                      style: ElevatedButton.styleFrom(
-                        backgroundColor: Colors.orange,
-                        foregroundColor: Colors.white,
-                        shape: RoundedRectangleBorder(
-                          borderRadius: BorderRadius.circular(12),
-                        ),
-                      ),
-                      child: _isWorking
-                          ? const CircularProgressIndicator(color: Colors.white)
-                          : const Text(
-                              '학생 등록 완료',
-                              style: TextStyle(
-                                fontWeight: FontWeight.bold,
-                                fontSize: 15,
-                              ),
-                            ),
-                    ),
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: 36),
-
-            // 🏷️ 인디케이터 바 2 (삭제 권한 제어메뉴)
-            Row(
-              children: [
-                Container(
-                  width: 4,
-                  height: 16,
-                  decoration: BoxDecoration(
-                    color: Colors.red,
-                    borderRadius: BorderRadius.circular(2),
-                  ),
-                ),
-                const SizedBox(width: 8),
-                const Text(
-                  '위험 구역 (Account Reset)',
-                  style: TextStyle(
-                    fontSize: 18,
-                    fontWeight: FontWeight.bold,
-                    color: Colors.redAccent,
-                  ),
-                ),
-              ],
-            ),
-            const SizedBox(height: 16),
-
-            // 🚨 학생 삭제 트리거 카드
-            InkWell(
-              onTap: _showDeleteDialog,
-              borderRadius: BorderRadius.circular(24),
-              child: Container(
-                padding: const EdgeInsets.all(20),
-                decoration: BoxDecoration(
-                  color: Colors.red[50],
-                  borderRadius: BorderRadius.circular(24),
-                  border: Border.all(color: Colors.red.shade200),
-                ),
-                child: const Row(
-                  children: [
-                    Icon(
-                      Icons.delete_sweep_rounded,
-                      color: Colors.red,
-                      size: 32,
-                    ),
-                    SizedBox(width: 16),
-                    Expanded(
-                      child: Column(
-                        crossAxisAlignment: CrossAxisAlignment.start,
-                        children: [
-                          Text(
-                            '학생 계정 강제 원격 삭제',
-                            style: TextStyle(
-                              fontSize: 16,
-                              fontWeight: FontWeight.bold,
-                              color: Colors.red,
-                            ),
-                          ),
-                          SizedBox(height: 2),
-                          Text(
-                            '인증 초기화 및 DB 제거용',
-                            style: TextStyle(
-                              fontSize: 12,
-                              color: Colors.redAccent,
-                            ),
-                          ),
-                        ],
-                      ),
-                    ),
-                    Icon(
-                      Icons.arrow_forward_ios_rounded,
-                      color: Colors.red,
-                      size: 16,
-                    ),
-                  ],
-                ),
-              ),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}

lib/theme/app_palette.dart

@@ -0,0 +1,14 @@
+// 🎨 앱 전역 무채색 팔레트 (coolors.co: 1c1c1c-daddd8-ecebe4-eef0f2-fafaff).
+// 배경/카드/배너 같은 구조적 색상은 전부 이 5색으로 통일한다.
+// 삭제/위반/거절처럼 사용자가 즉시 알아채야 하는 경고성 색상(빨강 등)만 예외로 유지한다.
+import 'package:flutter/material.dart';
+
+class AppPalette {
+  AppPalette._();
+
+  static const Color ink = Color(0xFF1C1C1C); // 가장 어두운 톤 — 배너/주요 텍스트/버튼
+  static const Color sage = Color(0xFFDADDD8); // 보더/구분선/보조 표면
+  static const Color linen = Color(0xFFECEBE4); // 은은한 카드/배지 배경
+  static const Color mist = Color(0xFFEEF0F2); // 페이지 배경
+  static const Color paper = Color(0xFFFAFAFF); // 카드 표면(거의 흰색)
+}

lib/ui/admin_dashboard.dart

@@ -0,0 +1,144 @@
+// 🛠️ 시스템 관리자 대시보드 (UI 전용). 출석 DB 전체 초기화 버튼을 그린다.
+// 서버 통신/상태는 lib/function/admin_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/admin_controller.dart';
+import '../theme/app_palette.dart';
+import 'login_screen.dart';
+
+// ==========================================
+// 🛠️ 5. 관리자 대시보드 (DB 초기화 암호 파라미터 보정 완료)
+// ==========================================
+class AdminDashboard extends StatefulWidget {
+  const AdminDashboard({super.key});
+
+  @override
+  State<AdminDashboard> createState() => _AdminDashboardState();
+}
+
+class _AdminDashboardState extends State<AdminDashboard> {
+  final AdminController _controller = AdminController();
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  Future<void> _resetDatabase() async {
+    final message = await _controller.resetDatabase();
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  void _showResetConfirmDialog() {
+    showDialog(
+      context: context,
+      builder: (BuildContext dialogContext) {
+        return AlertDialog(
+          title: const Text(
+            'DB 초기화 경고',
+            style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold),
+          ),
+          content: const Text(
+            '모든 학생의 출석 및 휴대폰 제출 데이터가 영구적으로 삭제됩니다.\n\n정말 초기화하시겠습니까?',
+          ),
+          actions: [
+            TextButton(
+              onPressed: () => Navigator.pop(dialogContext),
+              child: const Text('취소', style: TextStyle(color: Colors.grey)),
+            ),
+            ElevatedButton(
+              style: ElevatedButton.styleFrom(backgroundColor: Colors.red),
+              onPressed: () {
+                Navigator.pop(dialogContext);
+                _resetDatabase();
+              },
+              child: const Text(
+                '초기화 실행',
+                style: TextStyle(color: Colors.white),
+              ),
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text('관리자 시스템'),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: AppPalette.paper,
+            actions: [
+              IconButton(
+                icon: const Icon(Icons.logout),
+                onPressed: () => Navigator.pushReplacement(
+                  context,
+                  MaterialPageRoute(builder: (context) => const LoginScreen()),
+                ),
+              ),
+            ],
+          ),
+          body: Center(
+            child: Padding(
+              padding: const EdgeInsets.all(24.0),
+              child: Column(
+                mainAxisAlignment: MainAxisAlignment.center,
+                children: [
+                  const Icon(
+                    Icons.admin_panel_settings,
+                    size: 100,
+                    color: AppPalette.ink,
+                  ),
+                  const SizedBox(height: 20),
+                  const Text(
+                    '데이터베이스 관리',
+                    style: TextStyle(fontSize: 22, fontWeight: FontWeight.bold),
+                  ),
+                  const SizedBox(height: 40),
+
+                  _controller.isLoading
+                      ? const CircularProgressIndicator(color: Colors.red)
+                      : SizedBox(
+                          width: double.infinity,
+                          height: 60,
+                          child: ElevatedButton.icon(
+                            style: ElevatedButton.styleFrom(
+                              backgroundColor: Colors.red[50],
+                              foregroundColor: Colors.red,
+                              side: const BorderSide(
+                                color: Colors.red,
+                                width: 2,
+                              ),
+                              shape: RoundedRectangleBorder(
+                                borderRadius: BorderRadius.circular(12),
+                              ),
+                            ),
+                            icon: const Icon(Icons.delete_forever, size: 28),
+                            label: const Text(
+                              '모든 출석 데이터 초기화',
+                              style: TextStyle(
+                                fontSize: 18,
+                                fontWeight: FontWeight.bold,
+                              ),
+                            ),
+                            onPressed: _showResetConfirmDialog,
+                          ),
+                        ),
+                ],
+              ),
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

lib/ui/app_notice.dart

@@ -0,0 +1,162 @@
+// 🔔 스낵바 대신 쓰는 알약(pill) 모양 알림. 기능 타일을 누를 때 뜨는
+// "OO로 이동합니다" 같은 짧은 안내용. 푸시 알림(FCM)과는 무관 — 그건 그대로 동작한다.
+// 웹에서는 왼쪽 위(알림창 자리)에, 폰 앱에서는 기존 스낵바처럼 아래쪽에 뜬다.
+import 'package:flutter/foundation.dart' show kIsWeb;
+import 'package:flutter/material.dart';
+import '../theme/app_palette.dart';
+
+class AppNotice {
+  static final List<_QueuedNotice> _queue = [];
+  static bool _showing = false;
+
+  static void show(BuildContext context, String message, {IconData? icon}) {
+    _queue.add(_QueuedNotice(context, message, icon));
+    _tryShowNext();
+  }
+
+  static void _tryShowNext() {
+    if (_showing || _queue.isEmpty) return;
+    final next = _queue.removeAt(0);
+    if (!next.context.mounted) {
+      _tryShowNext();
+      return;
+    }
+    _showing = true;
+    final overlay = Overlay.of(next.context);
+    late OverlayEntry entry;
+    entry = OverlayEntry(
+      builder: (context) => _NoticeBanner(
+        message: next.message,
+        icon: next.icon,
+        onDone: () {
+          entry.remove();
+          _showing = false;
+          _tryShowNext();
+        },
+      ),
+    );
+    overlay.insert(entry);
+  }
+}
+
+class _QueuedNotice {
+  final BuildContext context;
+  final String message;
+  final IconData? icon;
+  _QueuedNotice(this.context, this.message, this.icon);
+}
+
+class _NoticeBanner extends StatefulWidget {
+  final String message;
+  final IconData? icon;
+  final VoidCallback onDone;
+
+  const _NoticeBanner({
+    required this.message,
+    required this.icon,
+    required this.onDone,
+  });
+
+  @override
+  State<_NoticeBanner> createState() => _NoticeBannerState();
+}
+
+class _NoticeBannerState extends State<_NoticeBanner>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController _controller;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 220),
+      reverseDuration: const Duration(milliseconds: 180),
+    );
+    _controller.forward();
+    Future.delayed(const Duration(milliseconds: 2600), () async {
+      if (!mounted) return;
+      await _controller.reverse();
+      widget.onDone();
+    });
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final curved = CurvedAnimation(
+      parent: _controller,
+      curve: Curves.easeOutCubic,
+      reverseCurve: Curves.easeInCubic,
+    );
+    final media = MediaQuery.of(context);
+
+    final pill = Material(
+      color: Colors.transparent,
+      child: Container(
+        constraints: const BoxConstraints(maxWidth: 360),
+        padding: const EdgeInsets.symmetric(horizontal: 18, vertical: 14),
+        decoration: BoxDecoration(
+          color: AppPalette.ink,
+          borderRadius: BorderRadius.circular(999),
+          boxShadow: [
+            BoxShadow(
+              color: Colors.black.withValues(alpha: 0.25),
+              blurRadius: 16,
+              offset: const Offset(0, 6),
+            ),
+          ],
+        ),
+        child: Row(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            if (widget.icon != null) ...[
+              Icon(widget.icon, color: AppPalette.paper, size: 18),
+              const SizedBox(width: 8),
+            ],
+            Flexible(
+              child: Text(
+                widget.message,
+                style: const TextStyle(
+                  color: AppPalette.paper,
+                  fontSize: 13.5,
+                  fontWeight: FontWeight.w600,
+                ),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+
+    final animatedPill = FadeTransition(
+      opacity: curved,
+      child: SlideTransition(
+        position: Tween<Offset>(
+          begin: kIsWeb ? const Offset(0, -0.3) : const Offset(0, 0.3),
+          end: Offset.zero,
+        ).animate(curved),
+        child: pill,
+      ),
+    );
+
+    if (kIsWeb) {
+      return Positioned(
+        top: media.padding.top + 16,
+        left: 16,
+        child: IgnorePointer(child: animatedPill),
+      );
+    }
+    return Positioned(
+      left: 16,
+      right: 16,
+      bottom: media.padding.bottom + 24,
+      child: IgnorePointer(child: Center(child: animatedPill)),
+    );
+  }
+}

lib/ui/dashboard_settings_page.dart

@@ -0,0 +1,60 @@
+// ⚙️ 대시보드 설정 화면 (UI 전용). 지금은 "UI 편집" 진입점 하나만 있다.
+// "UI 편집"을 누르면 이 화면을 pop('edit_ui')로 닫고, 대시보드가 그 결과를 받아 편집 모드로 들어간다.
+import 'package:flutter/material.dart';
+import '../models/dashboard_tile_layout.dart';
+import '../theme/app_palette.dart';
+
+class DashboardSettingsPage extends StatelessWidget {
+  const DashboardSettingsPage({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      backgroundColor: AppPalette.mist,
+      appBar: AppBar(
+        title: const Text('설정'),
+        backgroundColor: AppPalette.ink,
+        foregroundColor: AppPalette.paper,
+        elevation: 0,
+      ),
+      body: ListView(
+        padding: const EdgeInsets.all(16),
+        children: [
+          Container(
+            decoration: BoxDecoration(
+              color: AppPalette.paper,
+              borderRadius: BorderRadius.circular(16),
+              border: Border.all(color: AppPalette.sage),
+            ),
+            child: ListTile(
+              shape: RoundedRectangleBorder(
+                borderRadius: BorderRadius.circular(16),
+              ),
+              enabled: kTileEditingEnabled,
+              leading: const Icon(
+                Icons.grid_view_rounded,
+                color: AppPalette.ink,
+              ),
+              title: const Text(
+                'UI 편집',
+                style: TextStyle(fontWeight: FontWeight.bold),
+              ),
+              // 📱 [기능 보류] 작은 화면에서 레이아웃이 깨지는 문제로 잠시 막아둠.
+              subtitle: Text(
+                kTileEditingEnabled
+                    ? '타일을 드래그해서 옮기고 크기를 바꿀 수 있어요.'
+                    : '작은 화면 대응을 준비 중이라 잠시 사용할 수 없어요.',
+              ),
+              trailing: kTileEditingEnabled
+                  ? const Icon(Icons.chevron_right_rounded)
+                  : null,
+              onTap: kTileEditingEnabled
+                  ? () => Navigator.pop(context, 'edit_ui')
+                  : null,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

lib/ui/device_checkout_ledger_page.dart

@@ -0,0 +1,319 @@
+// 📋 선생님용 "스마트기기 반출 대장" 화면 (UI 전용). 오늘 신청된 반출 요청을 보여주고 승인/거절한다.
+// 서버 통신/상태는 lib/function/device_checkout_ledger_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/device_checkout_ledger_controller.dart';
+import '../theme/app_palette.dart';
+
+class DeviceCheckoutLedgerPage extends StatefulWidget {
+  final String? teacherId;
+  final String? teacherName;
+
+  const DeviceCheckoutLedgerPage({super.key, this.teacherId, this.teacherName});
+
+  @override
+  State<DeviceCheckoutLedgerPage> createState() =>
+      _DeviceCheckoutLedgerPageState();
+}
+
+class _DeviceCheckoutLedgerPageState extends State<DeviceCheckoutLedgerPage> {
+  final DeviceCheckoutLedgerController _controller =
+      DeviceCheckoutLedgerController();
+
+  @override
+  void initState() {
+    super.initState();
+    _controller.init();
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  Future<void> _approve(int id) async {
+    final (_, message) = await _controller.approve(
+      id,
+      teacherId: widget.teacherId ?? '간편인증',
+      teacherName: widget.teacherName ?? '간편인증 선생',
+    );
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  Future<void> _reject(int id) async {
+    final (_, message) = await _controller.reject(id);
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  // 🖐️ [하드웨어 자동 감지 전까지 임시] 기기를 실제로 돌려받았을 때 누르는 버튼.
+  Future<void> _confirmReturn(int id) async {
+    final (_, message) = await _controller.confirmReturn(id);
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  ({Color color, String label}) _statusInfo(String status) {
+    switch (status) {
+      case 'PENDING':
+        return (color: Colors.orange, label: '대기중');
+      case 'APPROVED':
+        return (color: Colors.blue, label: '승인됨');
+      case 'RETURNED':
+        return (color: Colors.grey, label: '반납완료');
+      case 'REJECTED':
+        return (color: Colors.red, label: '거절됨');
+      default:
+        return (color: Colors.grey, label: status);
+    }
+  }
+
+  String _timeRange(String start, String end) {
+    // "YYYY-MM-DD HH:MM:SS" -> "HH:MM"
+    String hm(String full) => full.length >= 16 ? full.substring(11, 16) : full;
+    return '${hm(start)} ~ ${hm(end)}';
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        final requests = _controller.requests;
+        final pendingCount = requests
+            .where((r) => r['status'] == 'PENDING')
+            .length;
+
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text(
+              '스마트기기 반출 대장',
+              style: TextStyle(fontWeight: FontWeight.bold),
+            ),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: Colors.white,
+            elevation: 0,
+            actions: [
+              IconButton(
+                icon: const Icon(Icons.refresh_rounded),
+                onPressed: _controller.fetchAll,
+                tooltip: '새로고침',
+              ),
+            ],
+          ),
+          body: _controller.isLoading
+              ? const Center(child: CircularProgressIndicator())
+              : Column(
+                  children: [
+                    if (pendingCount > 0)
+                      Container(
+                        width: double.infinity,
+                        margin: const EdgeInsets.all(16),
+                        padding: const EdgeInsets.symmetric(
+                          horizontal: 16,
+                          vertical: 10,
+                        ),
+                        decoration: BoxDecoration(
+                          color: Colors.orange[100],
+                          borderRadius: BorderRadius.circular(12),
+                          border: Border.all(color: Colors.orange[400]!),
+                        ),
+                        child: Text(
+                          '승인 대기 중인 요청이 $pendingCount건 있습니다.',
+                          style: TextStyle(
+                            color: Colors.orange[900],
+                            fontWeight: FontWeight.bold,
+                          ),
+                        ),
+                      ),
+                    Expanded(
+                      child: requests.isEmpty
+                          ? const Center(
+                              child: Text(
+                                '오늘 신청된 반출 요청이 없습니다.',
+                                style: TextStyle(color: Colors.grey),
+                              ),
+                            )
+                          : ListView.builder(
+                              padding: const EdgeInsets.symmetric(
+                                horizontal: 16,
+                                vertical: 8,
+                              ),
+                              itemCount: requests.length,
+                              itemBuilder: (context, index) {
+                                final r = requests[index];
+                                final String status = r['status'];
+                                final info = _statusInfo(status);
+                                final bool isPending = status == 'PENDING';
+
+                                return Card(
+                                  elevation: 0,
+                                  color: AppPalette.paper,
+                                  margin: const EdgeInsets.only(bottom: 10),
+                                  shape: RoundedRectangleBorder(
+                                    borderRadius: BorderRadius.circular(16),
+                                    side: isPending
+                                        ? BorderSide(color: Colors.orange[300]!)
+                                        : BorderSide(color: AppPalette.sage),
+                                  ),
+                                  child: Padding(
+                                    padding: const EdgeInsets.all(16),
+                                    child: Column(
+                                      crossAxisAlignment:
+                                          CrossAxisAlignment.start,
+                                      children: [
+                                        Row(
+                                          children: [
+                                            Expanded(
+                                              child: Text(
+                                                '${r['studentName']} (${r['studentId']})',
+                                                style: const TextStyle(
+                                                  fontWeight: FontWeight.bold,
+                                                  fontSize: 15,
+                                                ),
+                                              ),
+                                            ),
+                                            Container(
+                                              padding:
+                                                  const EdgeInsets.symmetric(
+                                                    horizontal: 10,
+                                                    vertical: 4,
+                                                  ),
+                                              decoration: BoxDecoration(
+                                                color: info.color.withValues(
+                                                  alpha: 0.12,
+                                                ),
+                                                borderRadius:
+                                                    BorderRadius.circular(20),
+                                              ),
+                                              child: Text(
+                                                info.label,
+                                                style: TextStyle(
+                                                  color: info.color,
+                                                  fontWeight: FontWeight.bold,
+                                                  fontSize: 12,
+                                                ),
+                                              ),
+                                            ),
+                                          ],
+                                        ),
+                                        const SizedBox(height: 6),
+                                        Text(
+                                          _timeRange(
+                                            r['requestedStart'],
+                                            r['requestedEnd'],
+                                          ),
+                                          style: TextStyle(
+                                            color: Colors.grey[700],
+                                            fontSize: 13,
+                                          ),
+                                        ),
+                                        const SizedBox(height: 2),
+                                        Text(
+                                          r['purpose'],
+                                          style: TextStyle(
+                                            color: Colors.grey[700],
+                                            fontSize: 13,
+                                          ),
+                                        ),
+                                        if (status == 'APPROVED' &&
+                                            r['approvedByTeacherName'] !=
+                                                null) ...[
+                                          const SizedBox(height: 2),
+                                          Text(
+                                            '${r['approvedByTeacherName']} 선생님이 허용했습니다',
+                                            style: TextStyle(
+                                              color: Colors.blue[700],
+                                              fontSize: 12,
+                                              fontWeight: FontWeight.w600,
+                                            ),
+                                          ),
+                                        ],
+                                        if (isPending) ...[
+                                          const SizedBox(height: 12),
+                                          Row(
+                                            children: [
+                                              Expanded(
+                                                child: OutlinedButton(
+                                                  onPressed:
+                                                      _controller.isWorking
+                                                      ? null
+                                                      : () => _reject(r['id']),
+                                                  style:
+                                                      OutlinedButton.styleFrom(
+                                                        foregroundColor:
+                                                            Colors.red,
+                                                        side: const BorderSide(
+                                                          color: Colors.red,
+                                                        ),
+                                                      ),
+                                                  child: const Text('거절'),
+                                                ),
+                                              ),
+                                              const SizedBox(width: 8),
+                                              Expanded(
+                                                child: ElevatedButton(
+                                                  onPressed:
+                                                      _controller.isWorking
+                                                      ? null
+                                                      : () => _approve(r['id']),
+                                                  style:
+                                                      ElevatedButton.styleFrom(
+                                                        backgroundColor:
+                                                            AppPalette.ink,
+                                                        foregroundColor:
+                                                            AppPalette.paper,
+                                                      ),
+                                                  child: const Text('승인'),
+                                                ),
+                                              ),
+                                            ],
+                                          ),
+                                        ],
+                                        if (status == 'APPROVED') ...[
+                                          const SizedBox(height: 12),
+                                          SizedBox(
+                                            width: double.infinity,
+                                            child: OutlinedButton.icon(
+                                              onPressed: _controller.isWorking
+                                                  ? null
+                                                  : () =>
+                                                        _confirmReturn(r['id']),
+                                              style: OutlinedButton.styleFrom(
+                                                foregroundColor:
+                                                    Colors.grey[800],
+                                                side: BorderSide(
+                                                  color: Colors.grey[400]!,
+                                                ),
+                                              ),
+                                              icon: const Icon(
+                                                Icons
+                                                    .assignment_turned_in_outlined,
+                                                size: 18,
+                                              ),
+                                              label: const Text('기기 반납 확인'),
+                                            ),
+                                          ),
+                                        ],
+                                      ],
+                                    ),
+                                  ),
+                                );
+                              },
+                            ),
+                    ),
+                  ],
+                ),
+        );
+      },
+    );
+  }
+}

lib/ui/device_checkout_request_screen.dart

@@ -0,0 +1,194 @@
+// 📱 스마트기기(패드) 반출 신청 화면 (UI 전용). 시작~종료 시각과 사용 목적을 입력받는다.
+// 서버 통신/상태는 lib/function/device_checkout_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/device_checkout_controller.dart';
+import '../theme/app_palette.dart';
+
+class DeviceCheckoutRequestScreen extends StatefulWidget {
+  final String studentId;
+  final String studentName;
+
+  const DeviceCheckoutRequestScreen({
+    super.key,
+    required this.studentId,
+    required this.studentName,
+  });
+
+  @override
+  State<DeviceCheckoutRequestScreen> createState() =>
+      _DeviceCheckoutRequestScreenState();
+}
+
+class _DeviceCheckoutRequestScreenState
+    extends State<DeviceCheckoutRequestScreen> {
+  final DeviceCheckoutController _controller = DeviceCheckoutController();
+  final TextEditingController _purposeController = TextEditingController();
+  TimeOfDay? _startTime;
+  TimeOfDay? _endTime;
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _purposeController.dispose();
+    super.dispose();
+  }
+
+  String _formatTime(TimeOfDay time) =>
+      '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}';
+
+  Future<void> _pickStartTime() async {
+    final picked = await showTimePicker(
+      context: context,
+      initialTime: _startTime ?? TimeOfDay.now(),
+      helpText: '사용 시작 시각',
+    );
+    if (picked != null) setState(() => _startTime = picked);
+  }
+
+  Future<void> _pickEndTime() async {
+    final picked = await showTimePicker(
+      context: context,
+      initialTime: _endTime ?? TimeOfDay.now(),
+      helpText: '사용 종료 시각',
+    );
+    if (picked != null) setState(() => _endTime = picked);
+  }
+
+  Future<void> _submit() async {
+    final purpose = _purposeController.text.trim();
+    if (_startTime == null || _endTime == null || purpose.isEmpty) {
+      ScaffoldMessenger.of(context).showSnackBar(
+        const SnackBar(content: Text('시작/종료 시각과 사용 목적을 모두 입력해주세요.')),
+      );
+      return;
+    }
+
+    final (success, message) = await _controller.submitRequest(
+      studentId: widget.studentId,
+      studentName: widget.studentName,
+      purpose: purpose,
+      startTime: _formatTime(_startTime!),
+      endTime: _formatTime(_endTime!),
+    );
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+    if (success) Navigator.pop(context);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text(
+              '스마트기기 반출 신청',
+              style: TextStyle(fontWeight: FontWeight.bold),
+            ),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: Colors.white,
+            elevation: 0,
+          ),
+          body: SingleChildScrollView(
+            padding: const EdgeInsets.all(24.0),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                const Text(
+                  '패드는 NFC 태그가 안 되니, 사용 시간과 목적을 적어 신청하면\n'
+                  '선생님이 확인하고 승인해줍니다. 승인되면 반납 바구니에서 꺼내 쓰세요.',
+                  style: TextStyle(
+                    color: Colors.black54,
+                    fontSize: 13,
+                    height: 1.4,
+                  ),
+                ),
+                const SizedBox(height: 24),
+                Container(
+                  padding: const EdgeInsets.all(20),
+                  decoration: BoxDecoration(
+                    color: AppPalette.paper,
+                    borderRadius: BorderRadius.circular(24),
+                    border: Border.all(color: AppPalette.sage),
+                  ),
+                  child: Column(
+                    children: [
+                      Row(
+                        children: [
+                          Expanded(
+                            child: OutlinedButton.icon(
+                              onPressed: _pickStartTime,
+                              icon: const Icon(Icons.play_arrow_rounded),
+                              label: Text(
+                                _startTime == null
+                                    ? '시작 시각'
+                                    : _formatTime(_startTime!),
+                              ),
+                            ),
+                          ),
+                          const SizedBox(width: 12),
+                          Expanded(
+                            child: OutlinedButton.icon(
+                              onPressed: _pickEndTime,
+                              icon: const Icon(Icons.stop_rounded),
+                              label: Text(
+                                _endTime == null
+                                    ? '종료 시각'
+                                    : _formatTime(_endTime!),
+                              ),
+                            ),
+                          ),
+                        ],
+                      ),
+                      const SizedBox(height: 16),
+                      TextField(
+                        controller: _purposeController,
+                        maxLines: 3,
+                        decoration: const InputDecoration(
+                          labelText: '사용 목적',
+                          hintText: '예: 수행평가 자료조사',
+                          alignLabelWithHint: true,
+                          border: OutlineInputBorder(),
+                        ),
+                      ),
+                      const SizedBox(height: 20),
+                      SizedBox(
+                        width: double.infinity,
+                        height: 50,
+                        child: ElevatedButton(
+                          onPressed: _controller.isSubmitting ? null : _submit,
+                          style: ElevatedButton.styleFrom(
+                            backgroundColor: AppPalette.ink,
+                            foregroundColor: AppPalette.paper,
+                            shape: RoundedRectangleBorder(
+                              borderRadius: BorderRadius.circular(12),
+                            ),
+                          ),
+                          child: _controller.isSubmitting
+                              ? const CircularProgressIndicator(
+                                  color: Colors.white,
+                                )
+                              : const Text(
+                                  '반출 신청하기',
+                                  style: TextStyle(
+                                    fontWeight: FontWeight.bold,
+                                    fontSize: 15,
+                                  ),
+                                ),
+                        ),
+                      ),
+                    ],
+                  ),
+                ),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

lib/ui/launchpad_transition.dart

@@ -0,0 +1,115 @@
+// 🚀 맥북 런치패드처럼 "앞에서 확대되며 나타나고, 뒤는 블러 처리되는" 전환 효과.
+// 기존의 좌우 슬라이드 전환을 대체한다. 두 가지 쓰임새가 있다:
+// 1) launchpadPageRoute  — 전체 화면 이동(다른 기능 타일 진입)용. 전환 중에만 블러가 보이고,
+//    화면이 다 뜨면 원래 화면(대시보드)은 완전히 가려진다.
+// 2) showLaunchpadMenu   — 설정/로그아웃 같은 작은 메뉴 오버레이용. 메뉴가 떠 있는 동안
+//    뒤에 있는 대시보드가 계속 뿌옇게 보인다. 바깥을 탭하면 닫힌다.
+import 'dart:ui';
+import 'package:flutter/material.dart';
+
+class LaunchpadPageRoute<T> extends PageRouteBuilder<T> {
+  LaunchpadPageRoute({required WidgetBuilder builder})
+    : super(
+        transitionDuration: const Duration(milliseconds: 320),
+        reverseTransitionDuration: const Duration(milliseconds: 240),
+        pageBuilder: (context, animation, secondaryAnimation) =>
+            builder(context),
+        transitionsBuilder: (context, animation, secondaryAnimation, child) {
+          final curved = CurvedAnimation(
+            parent: animation,
+            curve: Curves.easeOutCubic,
+            reverseCurve: Curves.easeInCubic,
+          );
+          return AnimatedBuilder(
+            animation: curved,
+            child: child,
+            builder: (context, child) {
+              final t = curved.value;
+              return Stack(
+                children: [
+                  // 뒤에 있던 화면(대시보드)을 전환하는 동안만 뿌옇게 보여준다.
+                  Positioned.fill(
+                    child: IgnorePointer(
+                      child: BackdropFilter(
+                        filter: ImageFilter.blur(
+                          sigmaX: 22 * t,
+                          sigmaY: 22 * t,
+                        ),
+                        child: Container(
+                          color: Colors.black.withValues(alpha: 0.12 * t),
+                        ),
+                      ),
+                    ),
+                  ),
+                  Opacity(
+                    opacity: t,
+                    child: Transform.scale(
+                      scale: 0.94 + 0.06 * t,
+                      child: child,
+                    ),
+                  ),
+                ],
+              );
+            },
+          );
+        },
+      );
+}
+
+/// 화면 전체 이동에 런치패드 전환 효과를 적용한다. MaterialPageRoute 대신 이걸 쓰면 됨.
+Future<T?> pushLaunchpad<T>(BuildContext context, WidgetBuilder builder) {
+  return Navigator.push<T>(context, LaunchpadPageRoute<T>(builder: builder));
+}
+
+/// 설정/로그아웃 같은 작은 메뉴를 런치패드 스타일(확대+페이드, 배경은 계속 블러 유지)로 띄운다.
+/// 바깥을 탭하면 닫힌다. builder는 화면 전체를 채우는 Align 등으로 메뉴 위치를 직접 잡아야 한다.
+Future<T?> showLaunchpadMenu<T>({
+  required BuildContext context,
+  required WidgetBuilder builder,
+}) {
+  return showGeneralDialog<T>(
+    context: context,
+    barrierDismissible: true,
+    barrierLabel: 'menu',
+    barrierColor: Colors.transparent,
+    transitionDuration: const Duration(milliseconds: 260),
+    pageBuilder: (context, animation, secondaryAnimation) => builder(context),
+    transitionBuilder: (context, animation, secondaryAnimation, child) {
+      final curved = CurvedAnimation(
+        parent: animation,
+        curve: Curves.easeOutCubic,
+        reverseCurve: Curves.easeInCubic,
+      );
+      return AnimatedBuilder(
+        animation: curved,
+        child: child,
+        builder: (context, child) {
+          final t = curved.value;
+          return Stack(
+            children: [
+              // 메뉴가 떠 있는 동안 계속 뿌옇게 — 기능 화면이랑 헷갈리지 않게 진하게.
+              Positioned.fill(
+                child: IgnorePointer(
+                  child: BackdropFilter(
+                    filter: ImageFilter.blur(sigmaX: 32 * t, sigmaY: 32 * t),
+                    child: Container(
+                      color: Colors.black.withValues(alpha: 0.28 * t),
+                    ),
+                  ),
+                ),
+              ),
+              Opacity(
+                opacity: t,
+                child: Transform.scale(
+                  alignment: Alignment.topRight,
+                  scale: 0.85 + 0.15 * t,
+                  child: child,
+                ),
+              ),
+            ],
+          );
+        },
+      );
+    },
+  );
+}

lib/ui/login_screen.dart

@@ -0,0 +1,472 @@
+// 🔑 로그인 화면 (UI 전용). 입력폼/다이얼로그/화면 이동만 담당한다.
+// 인증 로직/서버 통신은 lib/function/login_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../config.dart' show schoolName;
+import '../function/login_controller.dart';
+import '../function/session_store.dart';
+import '../theme/app_palette.dart';
+import 'main_dashboard.dart';
+import 'teacher_register_screen.dart';
+
+// -------------------------------------------------------------
+// 1. 로그인 화면 (LoginScreen)
+// -------------------------------------------------------------
+
+class LoginScreen extends StatefulWidget {
+  const LoginScreen({super.key});
+
+  @override
+  State<LoginScreen> createState() => _LoginScreenState();
+}
+
+class _LoginScreenState extends State<LoginScreen> {
+  final LoginController _controller = LoginController();
+  final TextEditingController _idController = TextEditingController();
+  final TextEditingController _pwController = TextEditingController();
+  bool _keepLoggedIn = true;
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _idController.dispose();
+    _pwController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _login() async {
+    final result = await _controller.login(
+      _idController.text.trim(),
+      _pwController.text.trim(),
+    );
+    if (!mounted) return;
+
+    switch (result.outcome) {
+      case LoginOutcome.error:
+        _showErrorDialog(result.errorMessage!);
+        break;
+      case LoginOutcome.masterSuccess:
+        if (_keepLoggedIn) {
+          await SessionStore.save(
+            SavedSession(
+              userId: result.studentId!,
+              userName: result.name!,
+              role: 'student',
+              isDeviceMatched: true,
+            ),
+          );
+        } else {
+          await SessionStore.clear();
+        }
+        if (!mounted) return;
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(const SnackBar(content: Text('개발자 최고 권한으로 로그인되었습니다.')));
+        Navigator.pushReplacement(
+          context,
+          MaterialPageRoute(
+            builder: (context) => MainDashboard(
+              userId: result.studentId!,
+              userName: result.name!,
+              role: 'student',
+              isDeviceMatched: true,
+            ),
+          ),
+        );
+        break;
+      case LoginOutcome.needsPasswordChange:
+        _showFirstLoginPasswordDialog(
+          result.studentId!,
+          result.name!,
+          result.role!,
+          result.isDeviceMatched,
+        );
+        break;
+      case LoginOutcome.success:
+        ScaffoldMessenger.of(
+          context,
+        ).showSnackBar(SnackBar(content: Text('${result.name}님 환영합니다!')));
+        _navigateBasedOnRole(
+          result.role!,
+          result.studentId!,
+          result.name!,
+          result.isDeviceMatched,
+        );
+        break;
+    }
+  }
+
+  // 🛠️ 초기 비밀번호 변경 팝업창 (기기 매칭 데이터 파라미터 추가)
+  void _showFirstLoginPasswordDialog(
+    String studentId,
+    String name,
+    String role,
+    bool isDeviceMatched,
+  ) {
+    final TextEditingController newPwController = TextEditingController();
+
+    showDialog(
+      context: context,
+      barrierDismissible: false,
+      builder: (BuildContext dialogContext) {
+        bool isUpdating = false;
+
+        return StatefulBuilder(
+          builder: (context, setDialogState) {
+            return AlertDialog(
+              title: const Text(
+                '초기 비밀번호 변경',
+                style: TextStyle(fontWeight: FontWeight.bold),
+              ),
+              content: Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  const Text(
+                    '보안을 위해 새로운 비밀번호를 설정해 주세요.',
+                    style: TextStyle(color: Colors.redAccent),
+                  ),
+                  const SizedBox(height: 16),
+                  TextField(
+                    controller: newPwController,
+                    obscureText: true,
+                    decoration: const InputDecoration(
+                      labelText: '새 비밀번호',
+                      border: OutlineInputBorder(),
+                      prefixIcon: Icon(Icons.lock_reset),
+                    ),
+                  ),
+                ],
+              ),
+              actions: [
+                isUpdating
+                    ? const Padding(
+                        padding: EdgeInsets.only(right: 20.0),
+                        child: CircularProgressIndicator(),
+                      )
+                    : ElevatedButton(
+                        style: ElevatedButton.styleFrom(
+                          backgroundColor: AppPalette.ink,
+                          foregroundColor: Colors.white,
+                        ),
+                        onPressed: () async {
+                          String newPassword = newPwController.text.trim();
+                          if (newPassword.isEmpty) {
+                            ScaffoldMessenger.of(context).showSnackBar(
+                              const SnackBar(content: Text('새 비밀번호를 입력해 주세요.')),
+                            );
+                            return;
+                          }
+
+                          setDialogState(() => isUpdating = true);
+
+                          final (success, message) = await _controller
+                              .changePassword(
+                                studentId: studentId,
+                                newPassword: newPassword,
+                              );
+                          setDialogState(() => isUpdating = false);
+
+                          if (success) {
+                            Navigator.pop(dialogContext);
+                            ScaffoldMessenger.of(
+                              context,
+                            ).showSnackBar(SnackBar(content: Text(message)));
+                            _navigateBasedOnRole(
+                              role,
+                              studentId,
+                              name,
+                              isDeviceMatched,
+                            );
+                          } else {
+                            ScaffoldMessenger.of(
+                              context,
+                            ).showSnackBar(SnackBar(content: Text(message)));
+                          }
+                        },
+                        child: const Text('변경하고 시작하기'),
+                      ),
+              ],
+            );
+          },
+        );
+      },
+    );
+  }
+
+  // 🆕 권한별 화면 이동시 기기 일치 여부 파라미터(`isDeviceMatched`) 수신 및 대시보드 전달
+  Future<void> _navigateBasedOnRole(
+    String role,
+    String studentId,
+    String name,
+    bool isDeviceMatched,
+  ) async {
+    if (_keepLoggedIn) {
+      await SessionStore.save(
+        SavedSession(
+          userId: studentId,
+          userName: name,
+          role: role,
+          isDeviceMatched: isDeviceMatched,
+        ),
+      );
+    } else {
+      await SessionStore.clear();
+    }
+    if (!mounted) return;
+    Navigator.pushReplacement(
+      context,
+      MaterialPageRoute(
+        builder: (context) => MainDashboard(
+          userId: studentId,
+          userName: name,
+          role: role,
+          isDeviceMatched: isDeviceMatched,
+        ),
+      ),
+    );
+  }
+
+  void _showErrorDialog(String message) {
+    showDialog(
+      context: context,
+      builder: (ctx) => AlertDialog(
+        title: const Text(
+          '인증 실패',
+          style: TextStyle(fontWeight: FontWeight.bold),
+        ),
+        content: Text(message),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(ctx),
+            child: const Text('확인'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  void _showLegacyPasswordDialog(
+    String title,
+    String correctPassword,
+    Widget nextPage,
+  ) {
+    final TextEditingController passwordController = TextEditingController();
+    showDialog(
+      context: context,
+      barrierDismissible: false,
+      builder: (BuildContext dialogContext) {
+        return AlertDialog(
+          title: Text('$title 권한 인증 (기존 방식)'),
+          content: TextField(
+            controller: passwordController,
+            obscureText: true,
+            keyboardType: TextInputType.number,
+            textInputAction: TextInputAction.done,
+            onSubmitted: (value) {
+              if (value == correctPassword) {
+                Navigator.pop(dialogContext);
+                Navigator.push(
+                  context,
+                  MaterialPageRoute(builder: (context) => nextPage),
+                );
+              } else {
+                ScaffoldMessenger.of(context).showSnackBar(
+                  const SnackBar(content: Text('비밀번호가 올바르지 않습니다.')),
+                );
+              }
+            },
+            decoration: const InputDecoration(
+              hintText: '비밀번호 4자리를 입력하세요',
+              border: OutlineInputBorder(),
+            ),
+          ),
+          actions: [
+            TextButton(
+              onPressed: () => Navigator.pop(dialogContext),
+              child: const Text('취소', style: TextStyle(color: Colors.grey)),
+            ),
+            ElevatedButton(
+              onPressed: () {
+                if (passwordController.text == correctPassword) {
+                  Navigator.pop(dialogContext);
+                  Navigator.push(
+                    context,
+                    MaterialPageRoute(builder: (context) => nextPage),
+                  );
+                } else {
+                  ScaffoldMessenger.of(context).showSnackBar(
+                    const SnackBar(content: Text('비밀번호가 올바르지 않습니다.')),
+                  );
+                }
+              },
+              child: const Text('인증하기'),
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          body: Center(
+            child: SingleChildScrollView(
+              padding: const EdgeInsets.all(24.0),
+              child: ConstrainedBox(
+                constraints: const BoxConstraints(maxWidth: 420),
+                child: Column(
+                  mainAxisAlignment: MainAxisAlignment.center,
+                  children: [
+                    const Icon(Icons.school, size: 80, color: AppPalette.ink),
+                    const SizedBox(height: 16),
+                    Text(
+                      '$schoolName 모니터',
+                      style: const TextStyle(
+                        fontSize: 26,
+                        fontWeight: FontWeight.bold,
+                        color: AppPalette.ink,
+                      ),
+                    ),
+                    const SizedBox(height: 8),
+                    const Text(
+                      '학생 편의 및 학교생활 도우미',
+                      style: TextStyle(color: Colors.grey, fontSize: 15),
+                    ),
+                    const SizedBox(height: 40),
+                    TextField(
+                      controller: _idController,
+                      textInputAction: TextInputAction.next,
+                      decoration: const InputDecoration(
+                        labelText: '학번 또는 교직원 번호',
+                        border: OutlineInputBorder(),
+                        prefixIcon: Icon(Icons.person),
+                      ),
+                    ),
+                    const SizedBox(height: 16),
+                    TextField(
+                      controller: _pwController,
+                      obscureText: true,
+                      textInputAction: TextInputAction.done,
+                      onSubmitted: (_) => _login(),
+                      decoration: const InputDecoration(
+                        labelText: '비밀번호',
+                        border: OutlineInputBorder(),
+                        prefixIcon: Icon(Icons.lock),
+                      ),
+                    ),
+                    const SizedBox(height: 8),
+                    InkWell(
+                      onTap: () =>
+                          setState(() => _keepLoggedIn = !_keepLoggedIn),
+                      borderRadius: BorderRadius.circular(8),
+                      child: Padding(
+                        padding: const EdgeInsets.symmetric(vertical: 4),
+                        child: Row(
+                          mainAxisSize: MainAxisSize.min,
+                          children: [
+                            Checkbox(
+                              value: _keepLoggedIn,
+                              activeColor: AppPalette.ink,
+                              onChanged: (value) =>
+                                  setState(() => _keepLoggedIn = value ?? true),
+                            ),
+                            const Text(
+                              '로그인 상태 유지',
+                              style: TextStyle(color: AppPalette.ink),
+                            ),
+                          ],
+                        ),
+                      ),
+                    ),
+                    const SizedBox(height: 16),
+                    _controller.isLoading
+                        ? const CircularProgressIndicator()
+                        : SizedBox(
+                            width: double.infinity,
+                            height: 55,
+                            child: ElevatedButton(
+                              style: ElevatedButton.styleFrom(
+                                backgroundColor: AppPalette.ink,
+                                foregroundColor: Colors.white,
+                                shape: RoundedRectangleBorder(
+                                  borderRadius: BorderRadius.circular(12),
+                                ),
+                              ),
+                              onPressed: _login,
+                              child: const Text(
+                                '로그인',
+                                style: TextStyle(
+                                  fontSize: 18,
+                                  fontWeight: FontWeight.bold,
+                                ),
+                              ),
+                            ),
+                          ),
+                    const SizedBox(height: 4),
+                    TextButton(
+                      onPressed: () => Navigator.push(
+                        context,
+                        MaterialPageRoute(
+                          builder: (context) => const TeacherRegisterScreen(),
+                        ),
+                      ),
+                      child: const Text(
+                        '선생님이신가요? 교사 회원가입 하기',
+                        style: TextStyle(
+                          color: AppPalette.ink,
+                          fontWeight: FontWeight.bold,
+                        ),
+                      ),
+                    ),
+                    const Divider(height: 40),
+                    Row(
+                      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
+                      children: [
+                        TextButton.icon(
+                          icon: const Icon(
+                            Icons.gavel,
+                            size: 18,
+                            color: Colors.grey,
+                          ),
+                          label: const Text(
+                            '교사 간편인증',
+                            style: TextStyle(color: Colors.grey),
+                          ),
+                          onPressed: () => _showLegacyPasswordDialog(
+                            '선생님',
+                            '1234',
+                            const MainDashboard(role: 'teacher'),
+                          ),
+                        ),
+                        TextButton.icon(
+                          icon: const Icon(
+                            Icons.settings,
+                            size: 18,
+                            color: Colors.grey,
+                          ),
+                          label: const Text(
+                            '관리자 간편인증',
+                            style: TextStyle(color: Colors.grey),
+                          ),
+                          onPressed: () => _showLegacyPasswordDialog(
+                            '시스템 관리자',
+                            '4936',
+                            const MainDashboard(role: 'admin'),
+                          ),
+                        ),
+                      ],
+                    ),
+                  ],
+                ),
+              ),
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

lib/ui/main_dashboard.dart

@@ -0,0 +1,948 @@
+// 🏠 통합 대시보드 (UI 전용). 학생/교사/관리자가 전부 이 화면 하나를 공유하고,
+// 권한(role)에 따라 배너 색상/문구와 보이는 타일만 달라진다.
+// 타일 배치(위치/크기)는 사용자가 직접 편집할 수 있고, 계정별로 서버에 저장된다
+// (lib/function/dashboard_layout_controller.dart). 캔버스는 가로 6칸×세로 4칸,
+// 타일 크기는 1x1~4x4.
+import 'package:flutter/material.dart';
+import 'package:flutter_staggered_grid_view/flutter_staggered_grid_view.dart';
+import '../function/dashboard_layout_controller.dart';
+import '../function/session_store.dart';
+import '../function/student_dashboard_controller.dart';
+import '../models/dashboard_tile_layout.dart';
+import '../theme/app_palette.dart';
+import 'admin_dashboard.dart';
+import 'app_notice.dart';
+import 'dashboard_settings_page.dart';
+import 'device_checkout_ledger_page.dart';
+import 'device_checkout_request_screen.dart';
+import 'launchpad_transition.dart';
+import 'login_screen.dart';
+import 'nfc_poccket_checkin_screen.dart';
+import 'nfc_tag_writer_screen.dart';
+import 'teacher_attendance_page.dart';
+import 'teacher_student_management_page.dart';
+
+class MainDashboard extends StatefulWidget {
+  final String? userId;
+  final String? userName;
+  final String role; // 'student' | 'teacher' | 'admin'
+  final bool isDeviceMatched;
+
+  const MainDashboard({
+    super.key,
+    this.userId,
+    this.userName,
+    required this.role,
+    this.isDeviceMatched = true,
+  });
+
+  @override
+  State<MainDashboard> createState() => _MainDashboardState();
+}
+
+class _MainDashboardState extends State<MainDashboard> {
+  final StudentDashboardController _controller = StudentDashboardController();
+  late final DashboardLayoutController _layout;
+
+  // 🎯 타일 이동/크기조절 드래그 중 기준값(드래그 시작 시점의 좌표)을 담아둔다.
+  Offset? _dragStartGlobal;
+  TileRect? _dragStartRect;
+
+  // 🔑 [권한 판정] 2061은 role이 'student'로 저장돼 있지만 실질적으로 최고 권한을 가진다.
+  bool get _isDeveloper => widget.userId == '2061';
+  bool get _isAdmin => widget.role == 'admin' || _isDeveloper;
+  bool get _isTeacherOrAbove => widget.role == 'teacher' || _isAdmin;
+  bool get _isStudent => widget.role == 'student';
+
+  String get _displayId =>
+      widget.userId ?? (widget.role == 'admin' ? '관리자' : '간편인증');
+  String get _displayName =>
+      widget.userName ?? (widget.role == 'admin' ? '시스템 관리자' : '간편인증 선생');
+
+  @override
+  void initState() {
+    super.initState();
+    _layout = DashboardLayoutController(_displayId);
+    // 📱 [기능 보류] kTileEditingEnabled가 false인 동안은 서버에서 배치를 불러올 필요가 없다.
+    if (kTileEditingEnabled) {
+      _layout.load(_tileSpecs().map((t) => t.id).toList());
+    }
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _layout.dispose();
+    super.dispose();
+  }
+
+  void _openPocketCheckIn(BuildContext context) {
+    pushLaunchpad(
+      context,
+      (context) => NfcPocketCheckInScreen(
+        studentId: _displayId,
+        studentName: _displayName,
+      ),
+    );
+  }
+
+  Future<void> _deleteUser(String userId) async {
+    final (_, message) = await _controller.deleteUser(userId);
+    if (!mounted) return;
+    AppNotice.show(context, message);
+  }
+
+  void _showDeleteUserDialog(BuildContext context) {
+    final TextEditingController idController = TextEditingController();
+
+    showDialog(
+      context: context,
+      builder: (context) {
+        return AlertDialog(
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(24),
+          ),
+          title: const Row(
+            children: [
+              Icon(Icons.warning_amber_rounded, color: Colors.redAccent),
+              SizedBox(width: 10),
+              Text(
+                '계정 강제 삭제',
+                style: TextStyle(fontWeight: FontWeight.bold, fontSize: 18),
+              ),
+            ],
+          ),
+          content: Column(
+            mainAxisSize: MainAxisSize.min,
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              const Text(
+                '학생의 학번 또는 교사의 교직원 번호를 입력하세요.\nDB에서 해당 계정과 토큰이 즉시 삭제됩니다.',
+                style: TextStyle(
+                  color: Colors.black54,
+                  fontSize: 13,
+                  height: 1.4,
+                ),
+              ),
+              const SizedBox(height: 16),
+              TextField(
+                controller: idController,
+                decoration: InputDecoration(
+                  labelText: '학번 또는 교직원 번호',
+                  hintText: '예: 201101 또는 T1001',
+                  labelStyle: TextStyle(color: Colors.red[400]),
+                  focusedBorder: OutlineInputBorder(
+                    borderRadius: BorderRadius.circular(16),
+                    borderSide: BorderSide(color: Colors.red[400]!, width: 2),
+                  ),
+                  border: OutlineInputBorder(
+                    borderRadius: BorderRadius.circular(16),
+                  ),
+                  prefixIcon: const Icon(Icons.person_remove_alt_1_rounded),
+                ),
+              ),
+            ],
+          ),
+          actions: [
+            TextButton(
+              onPressed: () => Navigator.pop(context),
+              child: const Text(
+                '취소',
+                style: TextStyle(
+                  color: Colors.grey,
+                  fontWeight: FontWeight.bold,
+                ),
+              ),
+            ),
+            ElevatedButton(
+              onPressed: () {
+                final inputId = idController.text.trim();
+                if (inputId.isNotEmpty) {
+                  Navigator.pop(context);
+                  _deleteUser(inputId);
+                }
+              },
+              style: ElevatedButton.styleFrom(
+                backgroundColor: Colors.redAccent,
+                foregroundColor: Colors.white,
+                shape: RoundedRectangleBorder(
+                  borderRadius: BorderRadius.circular(12),
+                ),
+                elevation: 0,
+              ),
+              child: const Text(
+                '삭제 실행',
+                style: TextStyle(fontWeight: FontWeight.bold),
+              ),
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  Future<void> _logout(BuildContext context) async {
+    await SessionStore.clear();
+    if (!context.mounted) return;
+    Navigator.pushReplacement(
+      context,
+      MaterialPageRoute(builder: (context) => const LoginScreen()),
+    );
+  }
+
+  // 🚀 오른쪽 위 ">" 버튼 — 로그아웃/설정을 런치패드 스타일 메뉴로 띄운다.
+  Future<void> _openMenu(BuildContext context) async {
+    final action = await showLaunchpadMenu<String>(
+      context: context,
+      builder: (context) => Align(
+        alignment: Alignment.topRight,
+        child: SafeArea(
+          child: Padding(
+            padding: const EdgeInsets.only(top: 8, right: 12),
+            child: _DashboardMenuCard(
+              onLogout: () => Navigator.pop(context, 'logout'),
+              onSettings: () => Navigator.pop(context, 'settings'),
+            ),
+          ),
+        ),
+      ),
+    );
+    if (!context.mounted) return;
+    if (action == 'logout') {
+      _logout(context);
+    } else if (action == 'settings') {
+      _openSettings(context);
+    }
+  }
+
+  Future<void> _openSettings(BuildContext context) async {
+    final result = await pushLaunchpad<String>(
+      context,
+      (context) => const DashboardSettingsPage(),
+    );
+    if (result == 'edit_ui' && kTileEditingEnabled) {
+      _layout.enterEditMode();
+    }
+  }
+
+  // 🎨 [역할별 테마] 배너 색상은 팔레트로 통일하고, 제목/문구/아이콘만 역할에 따라 다르게.
+  ({String title, String subtitle, Color color, IconData icon}) _theme() {
+    if (_isDeveloper) {
+      return (
+        title: 'MASTER CONTROL',
+        subtitle: '최고 관리 권한 활성화됨',
+        color: AppPalette.ink,
+        icon: Icons.admin_panel_settings_rounded,
+      );
+    } else if (widget.role == 'admin') {
+      return (
+        title: 'ADMIN CONTROL',
+        subtitle: '시스템 관리자 권한 활성화됨',
+        color: AppPalette.ink,
+        icon: Icons.admin_panel_settings_rounded,
+      );
+    } else if (widget.role == 'teacher') {
+      return (
+        title: 'TEACHER PORTAL',
+        subtitle: '교직원 번호: $_displayId | 교사 권한 활성화됨',
+        color: AppPalette.ink,
+        icon: Icons.admin_panel_settings_rounded,
+      );
+    }
+    return (
+      title: 'STUDENT PORTAL',
+      subtitle: '학번: $_displayId | 인증 완료',
+      color: AppPalette.ink,
+      icon: Icons.school_rounded,
+    );
+  }
+
+  // 🧩 역할에 따라 보이는 타일 목록. id는 서버 레이아웃 저장의 키로 쓰이므로 절대 바뀌면 안 된다.
+  List<({String id, Widget child})> _tileSpecs() {
+    final List<({String id, Widget child})> tiles = [];
+
+    if (_isStudent) {
+      tiles.add((
+        id: 'nfc_tag',
+        child: _buildModernCard(
+          icon: widget.isDeviceMatched
+              ? Icons.contactless_rounded
+              : Icons.lock_rounded,
+          title: 'NFC 태그',
+          subtitle: widget.isDeviceMatched ? '출석 및 폰 수거 완료' : '본인 인증 기기 전용',
+          color: widget.isDeviceMatched ? AppPalette.ink : AppPalette.sage,
+          onTap: widget.isDeviceMatched
+              ? () => _openPocketCheckIn(context)
+              : () => AppNotice.show(
+                  context,
+                  '대리 출석 방지를 위해 등록된 본인 스마트폰에서만 출석 가능합니다.',
+                  icon: Icons.lock_rounded,
+                ),
+          isActionButton: widget.isDeviceMatched,
+          isLoading: _controller.isLoading,
+        ),
+      ));
+      tiles.add((
+        id: 'school_status',
+        child: _buildModernCard(
+          icon: Icons.fastfood_rounded,
+          title: '실시간 학교 상황',
+          subtitle: '급식실 줄 & 매점 재고 확인',
+          color: AppPalette.ink,
+          onTap: () => AppNotice.show(
+            context,
+            '실시간 학교 상황 페이지로 이동합니다.',
+            icon: Icons.fastfood_rounded,
+          ),
+        ),
+      ));
+      tiles.add((
+        id: 'device_checkout_request',
+        child: _buildModernCard(
+          icon: Icons.tablet_mac_rounded,
+          title: '스마트기기 반출',
+          subtitle: '패드 사용 신청 (시간/목적)',
+          color: AppPalette.ink,
+          onTap: () => pushLaunchpad(
+            context,
+            (context) => DeviceCheckoutRequestScreen(
+              studentId: _displayId,
+              studentName: _displayName,
+            ),
+          ),
+        ),
+      ));
+    }
+
+    if (_isTeacherOrAbove) {
+      tiles.add((
+        id: 'attendance_check',
+        child: _buildModernCard(
+          icon: Icons.assignment_turned_in_rounded,
+          title: '실시간 출석 확인',
+          subtitle: '학생 제출 로그 모니터링',
+          color: AppPalette.ink,
+          onTap: () => pushLaunchpad(
+            context,
+            (context) => const TeacherAttendancePage(),
+          ),
+        ),
+      ));
+      tiles.add((
+        id: 'student_management',
+        child: _buildModernCard(
+          icon: Icons.manage_accounts_rounded,
+          title: '학생 계정 관리',
+          subtitle: '계정 추가 및 강제 리셋',
+          color: AppPalette.ink,
+          onTap: () => pushLaunchpad(
+            context,
+            (context) => const TeacherStudentManagementPage(),
+          ),
+        ),
+      ));
+      tiles.add((
+        id: 'device_checkout_ledger',
+        child: _buildModernCard(
+          icon: Icons.tablet_mac_rounded,
+          title: '스마트기기 반출 대장',
+          subtitle: '패드 반출 신청 승인/거절',
+          color: AppPalette.ink,
+          onTap: () => pushLaunchpad(
+            context,
+            (context) => DeviceCheckoutLedgerPage(
+              teacherId: widget.userId,
+              teacherName: widget.userName,
+            ),
+          ),
+        ),
+      ));
+    }
+
+    if (_isAdmin) {
+      tiles.add((
+        id: 'admin_db',
+        child: _buildModernCard(
+          icon: Icons.terminal_rounded,
+          title: '서버 DB 제어',
+          subtitle: '시스템 원격 초기화',
+          color: AppPalette.ink,
+          onTap: () =>
+              pushLaunchpad(context, (context) => const AdminDashboard()),
+        ),
+      ));
+      tiles.add((
+        id: 'delete_account',
+        child: _buildModernCard(
+          icon: Icons.delete_sweep_rounded,
+          title: '계정 강제 삭제',
+          subtitle: '학생 및 교사 DB 삭제',
+          color: AppPalette.ink,
+          onTap: () => _showDeleteUserDialog(context),
+        ),
+      ));
+      tiles.add((
+        id: 'nfc_tag_writer',
+        child: _buildModernCard(
+          icon: Icons.edit_note_rounded,
+          title: 'NFC 태그 쓰기',
+          subtitle: '주머니 스티커 초기 설정',
+          color: AppPalette.ink,
+          onTap: () =>
+              pushLaunchpad(context, (context) => const NfcTagWriterScreen()),
+        ),
+      ));
+    }
+
+    return tiles;
+  }
+
+  // ─────────────────────────────────────────────────────────
+  // 🖐️ 편집 모드: 드래그로 이동, 모서리 손잡이로 크기 조절 (1x1~4x4).
+  // ─────────────────────────────────────────────────────────
+  void _onMovePanStart(String id, DragStartDetails details) {
+    _dragStartGlobal = details.globalPosition;
+    _dragStartRect = _layout.positions[id];
+  }
+
+  void _onMovePanUpdate(String id, double cellSize, DragUpdateDetails details) {
+    if (_dragStartGlobal == null || _dragStartRect == null) return;
+    final delta = details.globalPosition - _dragStartGlobal!;
+    final dx = (delta.dx / cellSize).round();
+    final dy = (delta.dy / cellSize).round();
+    _layout.tryMove(id, _dragStartRect!.x + dx, _dragStartRect!.y + dy);
+  }
+
+  void _onMovePanEnd(DragEndDetails details) {
+    _dragStartGlobal = null;
+    _dragStartRect = null;
+  }
+
+  void _onResizePanStart(String id, DragStartDetails details) {
+    _dragStartGlobal = details.globalPosition;
+    _dragStartRect = _layout.positions[id];
+  }
+
+  void _onResizePanUpdate(
+    String id,
+    double cellSize,
+    DragUpdateDetails details,
+  ) {
+    if (_dragStartGlobal == null || _dragStartRect == null) return;
+    final delta = details.globalPosition - _dragStartGlobal!;
+    final dw = (delta.dx / cellSize).round();
+    final dh = (delta.dy / cellSize).round();
+    _layout.tryResize(id, _dragStartRect!.w + dw, _dragStartRect!.h + dh);
+  }
+
+  Future<void> _saveAndExitEdit() async {
+    await _layout.save();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: Listenable.merge([_controller, _layout]),
+      builder: (context, _) {
+        final theme = _theme();
+        final tiles = _tileSpecs();
+        final bool isEditing = _layout.isEditing;
+
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          // 🪶 큰 색상 배너 대신 작은 프로필 카드를 본문에 두므로, 앱바는 ">" 메뉴
+          // 버튼(또는 편집 중 "완료" 버튼)만 올려두는 투명한 얇은 바로 둔다.
+          appBar: AppBar(
+            backgroundColor: Colors.transparent,
+            foregroundColor: AppPalette.ink,
+            elevation: 0,
+            actions: isEditing
+                ? [
+                    TextButton.icon(
+                      onPressed: _layout.isSaving ? null : _saveAndExitEdit,
+                      icon: _layout.isSaving
+                          ? const SizedBox(
+                              width: 16,
+                              height: 16,
+                              child: CircularProgressIndicator(strokeWidth: 2),
+                            )
+                          : const Icon(Icons.check_rounded),
+                      label: const Text('완료'),
+                    ),
+                  ]
+                : [
+                    IconButton(
+                      icon: const Icon(Icons.chevron_right_rounded),
+                      tooltip: '메뉴',
+                      onPressed: () => _openMenu(context),
+                    ),
+                  ],
+          ),
+          body: SingleChildScrollView(
+            physics: isEditing
+                ? const NeverScrollableScrollPhysics()
+                : const AlwaysScrollableScrollPhysics(),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                const SizedBox(height: 8),
+                // 🪪 작은 프로필 카드로 배치 — 화면 전체를 차지하던 배너 대신
+                // 가운데에 떠 있는 카드 하나만 둔다.
+                Center(
+                  child: Container(
+                    padding: const EdgeInsets.symmetric(
+                      horizontal: 28,
+                      vertical: 18,
+                    ),
+                    decoration: BoxDecoration(
+                      color: theme.color,
+                      borderRadius: BorderRadius.circular(24),
+                      boxShadow: [
+                        BoxShadow(
+                          color: theme.color.withValues(alpha: 0.25),
+                          blurRadius: 16,
+                          offset: const Offset(0, 6),
+                        ),
+                      ],
+                    ),
+                    child: Column(
+                      mainAxisSize: MainAxisSize.min,
+                      children: [
+                        Text(
+                          theme.title,
+                          style: const TextStyle(
+                            fontWeight: FontWeight.bold,
+                            letterSpacing: 1.2,
+                            color: Colors.white,
+                            fontSize: 13,
+                          ),
+                        ),
+                        const SizedBox(height: 10),
+                        Container(
+                          padding: const EdgeInsets.all(4),
+                          decoration: const BoxDecoration(
+                            color: Colors.white,
+                            shape: BoxShape.circle,
+                          ),
+                          child: CircleAvatar(
+                            radius: 22,
+                            backgroundColor: AppPalette.linen,
+                            child: Icon(
+                              theme.icon,
+                              size: 22,
+                              color: theme.color,
+                            ),
+                          ),
+                        ),
+                        const SizedBox(height: 10),
+                        Text(
+                          '$_displayName 님',
+                          textAlign: TextAlign.center,
+                          style: const TextStyle(
+                            fontSize: 17,
+                            fontWeight: FontWeight.bold,
+                            color: Colors.white,
+                          ),
+                        ),
+                        const SizedBox(height: 3),
+                        Text(
+                          theme.subtitle,
+                          textAlign: TextAlign.center,
+                          style: TextStyle(
+                            color: Colors.white.withValues(alpha: 0.8),
+                            fontSize: 12,
+                          ),
+                        ),
+                      ],
+                    ),
+                  ),
+                ),
+                const SizedBox(height: 28),
+                Padding(
+                  padding: const EdgeInsets.symmetric(horizontal: 24.0),
+                  child: Row(
+                    mainAxisAlignment: MainAxisAlignment.center,
+                    children: [
+                      Container(
+                        width: 4,
+                        height: 18,
+                        decoration: BoxDecoration(
+                          color: theme.color,
+                          borderRadius: BorderRadius.circular(2),
+                        ),
+                      ),
+                      const SizedBox(width: 10),
+                      const Text(
+                        '스마트 관리 시스템 메뉴',
+                        style: TextStyle(
+                          fontSize: 18,
+                          fontWeight: FontWeight.bold,
+                          color: AppPalette.ink,
+                        ),
+                      ),
+                    ],
+                  ),
+                ),
+                if (isEditing)
+                  const Padding(
+                    padding: EdgeInsets.only(top: 8, left: 24, right: 24),
+                    child: Text(
+                      '타일을 드래그해서 옮기고, 오른쪽 아래 손잡이로 크기를 바꿔보세요.',
+                      textAlign: TextAlign.center,
+                      style: TextStyle(color: AppPalette.sage, fontSize: 12),
+                    ),
+                  ),
+                const SizedBox(height: 16),
+                // 📱 [기능 보류] kTileEditingEnabled가 꺼져 있는 동안은 화면 크기에 맞춰
+                // 알아서 줄서는 기본 그리드를 쓰고, 드래그 편집용 캔버스는 쓰지 않는다.
+                kTileEditingEnabled
+                    ? (_layout.isLoading
+                          ? const Padding(
+                              padding: EdgeInsets.symmetric(vertical: 40),
+                              child: Center(child: CircularProgressIndicator()),
+                            )
+                          : _buildGridCanvas(tiles, isEditing))
+                    : _buildSimpleGrid(tiles),
+                const SizedBox(height: 32),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+
+  // 🧱 타일마다 크기(가로/세로 칸 수)가 다른 매이슨리(벽돌쌓기) 그리드.
+  // 화면 폭에 맞춰 열 개수가 자동으로 바뀌기 때문에 폰에서도 안 깨진다.
+  // id는 서버 레이아웃 저장용 키와 같지만, 여기서는 그냥 "이 타일이 몇 칸짜리인지" 찾는 데만 쓴다.
+  static const Map<String, (int w, int h)> _tileSpans = {
+    'nfc_tag': (1, 2),
+    'attendance_check': (2, 1),
+    'admin_db': (2, 1),
+  };
+
+  (int, int) _spanFor(String id) => _tileSpans[id] ?? (1, 1);
+
+  Widget _buildSimpleGrid(List<({String id, Widget child})> tiles) {
+    return Padding(
+      padding: const EdgeInsets.symmetric(horizontal: 24.0),
+      child: LayoutBuilder(
+        builder: (context, constraints) {
+          final double width = constraints.maxWidth;
+          // 🔲 정사각형 1칸 기준 4×3 배치 — 화면이 넓어도 6칸까지 늘리지 않고 4칸에서 멈춘다.
+          final int crossAxisCount = width < 420
+              ? 2
+              : width < 700
+              ? 3
+              : 4;
+          // 📏 1칸(1x1) 크기가 대략 계정 프로필 카드만 해지도록 목표 크기를 잡고,
+          // 화면이 그보다 넓으면 가운데로 모아서 여백을 준다(좁으면 화면 폭에 맞춤).
+          const double targetCellSize = 184;
+          const double gap = 12;
+          final double idealGridWidth =
+              crossAxisCount * targetCellSize + (crossAxisCount - 1) * gap;
+          final double gridWidth = width < idealGridWidth
+              ? width
+              : idealGridWidth;
+
+          return Center(
+            child: SizedBox(
+              width: gridWidth,
+              child: StaggeredGrid.count(
+                crossAxisCount: crossAxisCount,
+                mainAxisSpacing: gap,
+                crossAxisSpacing: gap,
+                children: [
+                  for (final tile in tiles)
+                    StaggeredGridTile.count(
+                      crossAxisCellCount: _spanFor(
+                        tile.id,
+                      ).$1.clamp(1, crossAxisCount),
+                      mainAxisCellCount: _spanFor(tile.id).$2,
+                      child: tile.child,
+                    ),
+                ],
+              ),
+            ),
+          );
+        },
+      ),
+    );
+  }
+
+  Widget _buildGridCanvas(
+    List<({String id, Widget child})> tiles,
+    bool isEditing,
+  ) {
+    const double gap = 10;
+    const double maxCanvasWidth = 720;
+
+    return LayoutBuilder(
+      builder: (context, constraints) {
+        final double canvasWidth = constraints.maxWidth < maxCanvasWidth
+            ? constraints.maxWidth - 24
+            : maxCanvasWidth;
+        final double cellSize = canvasWidth / kGridCols;
+        final double canvasHeight = cellSize * kGridRows;
+
+        final List<Widget> positioned = [];
+        for (final tile in tiles) {
+          final rect = _layout.positions[tile.id];
+          if (rect == null) continue; // 캔버스가 꽉 차서 자리를 못 찾은 타일
+
+          final double left = rect.x * cellSize;
+          final double top = rect.y * cellSize;
+          final double w = rect.w * cellSize - gap;
+          final double h = rect.h * cellSize - gap;
+
+          positioned.add(
+            Positioned(
+              key: ValueKey(tile.id),
+              left: left,
+              top: top,
+              width: w,
+              height: h,
+              child: Stack(
+                clipBehavior: Clip.none,
+                children: [
+                  Positioned.fill(
+                    child: IgnorePointer(
+                      ignoring: isEditing,
+                      child: tile.child,
+                    ),
+                  ),
+                  if (isEditing)
+                    Positioned.fill(
+                      child: GestureDetector(
+                        behavior: HitTestBehavior.translucent,
+                        onPanStart: (d) => _onMovePanStart(tile.id, d),
+                        onPanUpdate: (d) =>
+                            _onMovePanUpdate(tile.id, cellSize, d),
+                        onPanEnd: _onMovePanEnd,
+                      ),
+                    ),
+                  if (isEditing)
+                    Positioned(
+                      right: 2,
+                      bottom: 2,
+                      child: GestureDetector(
+                        onPanStart: (d) => _onResizePanStart(tile.id, d),
+                        onPanUpdate: (d) =>
+                            _onResizePanUpdate(tile.id, cellSize, d),
+                        onPanEnd: _onMovePanEnd,
+                        child: Container(
+                          width: 26,
+                          height: 26,
+                          decoration: BoxDecoration(
+                            color: AppPalette.ink,
+                            borderRadius: BorderRadius.circular(8),
+                            border: Border.all(
+                              color: AppPalette.paper,
+                              width: 2,
+                            ),
+                          ),
+                          child: const Icon(
+                            Icons.open_in_full_rounded,
+                            size: 14,
+                            color: AppPalette.paper,
+                          ),
+                        ),
+                      ),
+                    ),
+                ],
+              ),
+            ),
+          );
+        }
+
+        return Center(
+          child: SizedBox(
+            width: canvasWidth,
+            height: canvasHeight,
+            child: Stack(children: positioned),
+          ),
+        );
+      },
+    );
+  }
+
+  // 💎 [카드 디자인 위젯] 타일 크기가 커지면 아이콘/글자도 비례해서 커진다.
+  Widget _buildModernCard({
+    required IconData icon,
+    required String title,
+    required String subtitle,
+    required Color color,
+    required VoidCallback onTap,
+    bool isActionButton = false,
+    bool isLoading = false,
+  }) {
+    return LayoutBuilder(
+      builder: (context, constraints) {
+        // 📏 타일의 실제 픽셀 크기를 기준으로 배율을 계산 (1x1 기준 ≈ 1.0).
+        // 가로/세로 중 더 작은 쪽을 기준으로 삼아야, 가로로 넓지만 낮은 타일에서
+        // 배율이 과하게 커져 내용이 넘치는 걸 막을 수 있다.
+        final double referenceSize = constraints.hasBoundedHeight
+            ? constraints.maxWidth < constraints.maxHeight
+                  ? constraints.maxWidth
+                  : constraints.maxHeight
+            : constraints.maxWidth;
+        final double scale = (referenceSize / 110).clamp(1.0, 3.4);
+        final double iconBoxPadding = 6 + 6 * (scale - 1);
+        final double iconSize = 16 + 10 * (scale - 1);
+        final double iconRadius = 10 + 6 * (scale - 1);
+        final double cardPadding = 8 + 8 * (scale - 1);
+        final double cardRadius = 16 + 6 * (scale - 1);
+        final double titleFontSize = (10 + 3 * (scale - 1)).clamp(10, 18);
+        final double subtitleFontSize = (8 + 2 * (scale - 1)).clamp(8, 14);
+
+        return InkWell(
+          onTap: isLoading ? null : onTap,
+          borderRadius: BorderRadius.circular(cardRadius),
+          child: Ink(
+            padding: EdgeInsets.all(cardPadding),
+            decoration: BoxDecoration(
+              color: AppPalette.paper,
+              borderRadius: BorderRadius.circular(cardRadius),
+              border: Border.all(color: AppPalette.sage, width: 1),
+            ),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              mainAxisAlignment: MainAxisAlignment.spaceBetween,
+              children: [
+                Container(
+                  padding: EdgeInsets.all(iconBoxPadding),
+                  decoration: BoxDecoration(
+                    color: AppPalette.linen,
+                    borderRadius: BorderRadius.circular(iconRadius),
+                  ),
+                  child: Icon(icon, color: color, size: iconSize),
+                ),
+                Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Row(
+                      mainAxisAlignment: MainAxisAlignment.spaceBetween,
+                      children: [
+                        Expanded(
+                          child: Text(
+                            title,
+                            maxLines: 2,
+                            overflow: TextOverflow.ellipsis,
+                            style: TextStyle(
+                              fontSize: titleFontSize,
+                              fontWeight: FontWeight.bold,
+                              color: AppPalette.ink,
+                            ),
+                          ),
+                        ),
+                        if (isLoading)
+                          const SizedBox(
+                            width: 14,
+                            height: 14,
+                            child: CircularProgressIndicator(strokeWidth: 2),
+                          )
+                        else if (isActionButton)
+                          Icon(
+                            Icons.touch_app_rounded,
+                            size: 14,
+                            color: color.withValues(alpha: 0.5),
+                          ),
+                      ],
+                    ),
+                    SizedBox(height: 1 + 2 * (scale - 1)),
+                    Text(
+                      subtitle,
+                      maxLines: 2,
+                      overflow: TextOverflow.ellipsis,
+                      style: TextStyle(
+                        fontSize: subtitleFontSize,
+                        color: AppPalette.ink.withValues(alpha: 0.55),
+                        height: 1.15,
+                      ),
+                    ),
+                  ],
+                ),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+}
+
+// 🚀 오른쪽 위 ">" 버튼을 누르면 뜨는 런치패드 스타일 메뉴 카드.
+class _DashboardMenuCard extends StatelessWidget {
+  final VoidCallback onLogout;
+  final VoidCallback onSettings;
+
+  const _DashboardMenuCard({required this.onLogout, required this.onSettings});
+
+  @override
+  Widget build(BuildContext context) {
+    return Material(
+      color: AppPalette.paper,
+      elevation: 8,
+      shadowColor: Colors.black.withValues(alpha: 0.3),
+      borderRadius: BorderRadius.circular(20),
+      child: IntrinsicWidth(
+        child: ConstrainedBox(
+          constraints: const BoxConstraints(minWidth: 180),
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            crossAxisAlignment: CrossAxisAlignment.stretch,
+            children: [
+              _MenuRow(
+                icon: Icons.logout_rounded,
+                label: '로그아웃',
+                onTap: onLogout,
+              ),
+              const Divider(height: 1, color: AppPalette.sage),
+              _MenuRow(
+                icon: Icons.settings_outlined,
+                label: '설정',
+                onTap: onSettings,
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _MenuRow extends StatelessWidget {
+  final IconData icon;
+  final String label;
+  final VoidCallback onTap;
+
+  const _MenuRow({
+    required this.icon,
+    required this.label,
+    required this.onTap,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return InkWell(
+      onTap: onTap,
+      child: Padding(
+        padding: const EdgeInsets.symmetric(horizontal: 18, vertical: 14),
+        child: Row(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Icon(icon, size: 20, color: AppPalette.ink),
+            const SizedBox(width: 12),
+            Text(
+              label,
+              style: const TextStyle(
+                fontWeight: FontWeight.w600,
+                color: AppPalette.ink,
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

lib/ui/nfc_poccket_checkin_screen.dart

@@ -0,0 +1,275 @@
+// 📲 자습실 NFC 출석체크 화면 (UI 전용). 태깅 상태 화면/팝업/스낵바만 그린다.
+// NFC 세션, 서버 통신, 백그라운드 감시 연동은
+// lib/function/nfc_pocket_checkin_controller.dart가 담당한다.
+import 'dart:io' show Platform;
+import 'package:flutter/foundation.dart' show kIsWeb;
+import 'package:flutter/material.dart';
+import '../function/nfc_pocket_checkin_controller.dart';
+
+class NfcPocketCheckInScreen extends StatefulWidget {
+  final String studentId; // 로그인된 학생 학번 (예: "2061")
+  final String studentName; // 로그인된 학생 이름 (예: "시후")
+
+  const NfcPocketCheckInScreen({
+    super.key,
+    required this.studentId,
+    required this.studentName,
+  });
+
+  @override
+  State<NfcPocketCheckInScreen> createState() => _NfcPocketCheckInScreenState();
+}
+
+class _NfcPocketCheckInScreenState extends State<NfcPocketCheckInScreen> {
+  late final NfcPocketCheckinController _controller;
+  bool _isDialogOpen = false; // 출석/위반 팝업이 겹쳐서 뜨는 것을 막기 위한 플래그
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = NfcPocketCheckinController(
+      studentId: widget.studentId,
+      studentName: widget.studentName,
+      onMessage: _handleMessage,
+      onCheckInSuccess: _showSuccessDialog,
+      onViolationDetected: _showViolationDialog,
+      onNeedGuidedAccessSetup: _showGuidedAccessDialog,
+    );
+    _controller.init();
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  void _handleMessage(String text, WatchMessageLevel level) {
+    final Color color = switch (level) {
+      WatchMessageLevel.info => Colors.blueGrey,
+      WatchMessageLevel.success => Colors.green,
+      WatchMessageLevel.warning => Colors.orange,
+      WatchMessageLevel.error => Colors.red,
+    };
+    _showSnackBar(text, color);
+  }
+
+  /// 이미 떠 있는 팝업(출석 완료/무단반출 감지)이 있으면 새 팝업을 띄우기 전에 먼저 닫는다.
+  /// (태깅→반출→재태깅이 빠르게 반복되면 팝업이 여러 개 겹쳐 쌓이는 것을 방지)
+  void _closeAnyOpenDialog() {
+    if (_isDialogOpen && mounted) {
+      Navigator.of(context, rootNavigator: true).pop();
+    }
+    _isDialogOpen = false;
+  }
+
+  void _showViolationDialog(String? pocketNumber) {
+    if (!mounted) return;
+    _closeAnyOpenDialog();
+    _isDialogOpen = true;
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        backgroundColor: Colors.red[50],
+        title: const Text(
+          "무단 반출 감지",
+          style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold),
+        ),
+        content: Text(
+          "[${pocketNumber ?? _controller.activePocketNumber}] 주머니에서 휴대폰이 꺼내진 것으로 감지되었습니다.\n담당 선생님께 알림이 전송되었습니다.",
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text("확인"),
+          ),
+        ],
+      ),
+    ).then((_) => _isDialogOpen = false);
+  }
+
+  /// 🛡️ iOS 전용: 근접센서 감시가 화면 잠금으로 끊기지 않도록, "가이드 접근"을
+  /// 직접 켜달라고 안내하는 팝업. 학생이 켰다고 확인해야 실제 감시가 시작된다.
+  void _showGuidedAccessDialog(String pocketNumber) {
+    if (!mounted) return;
+    _closeAnyOpenDialog();
+    _isDialogOpen = true;
+    showDialog(
+      context: context,
+      barrierDismissible: false,
+      builder: (context) => AlertDialog(
+        title: const Text("감시 모드 켜기 전에"),
+        content: const Text(
+          "iOS는 화면을 잠그면 감시가 끊겨요. 아래 순서로 '가이드 접근'을 먼저 켜주세요.\n\n"
+          "1. 사이드(또는 홈) 버튼 3번 빠르게 누르기\n"
+          "2. 목록에서 '가이드 접근' 선택 → 화면 오른쪽 아래 '시작' 누르기\n\n"
+          "다 켜셨으면 아래 버튼을 눌러 감시를 시작하세요.\n"
+          "(감시를 끝낼 땐 먼저 사이드 버튼 3번으로 가이드 접근을 끈 다음 다시 태깅하세요.)",
+        ),
+        actions: [
+          TextButton(
+            onPressed: () {
+              Navigator.pop(context);
+              _controller.beginIosProximityWatch(pocketNumber);
+            },
+            child: const Text("가이드 접근 켰어요"),
+          ),
+        ],
+      ),
+    ).then((_) => _isDialogOpen = false);
+  }
+
+  /// 🎊 출석 성공 알림창
+  void _showSuccessDialog(String pocketNumber) {
+    if (!mounted) return;
+    _closeAnyOpenDialog();
+    _isDialogOpen = true;
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        title: const Text("자습실 출석 완료!"),
+        content: Text(
+          "${widget.studentName} 학생!\n[$pocketNumber] 주머니 출석이 확인되었습니다.\n\n폰을 주머니에 쏙 넣고 자습에 집중해 주세요!",
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text("확인"),
+          ),
+        ],
+      ),
+    ).then((_) => _isDialogOpen = false);
+  }
+
+  void _showSnackBar(String text, Color color) {
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(text), backgroundColor: color));
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        if (_controller.isWatching) {
+          return _buildPocketWatchScreen();
+        }
+
+        return Scaffold(
+          appBar: AppBar(
+            title: const Text(
+              "자습실 NFC 출석체크",
+              style: TextStyle(
+                color: Colors.white,
+                fontWeight: FontWeight.bold,
+              ),
+            ),
+            backgroundColor: const Color.fromARGB(255, 48, 48, 52),
+          ),
+          body: Center(
+            child: Padding(
+              padding: const EdgeInsets.all(24.0),
+              child: Column(
+                mainAxisAlignment: MainAxisAlignment.center,
+                children: [
+                  // NFC 애니메이션 아이콘
+                  Icon(
+                    _controller.isProcessing ? Icons.sync : Icons.nfc,
+                    size: 100,
+                    color: _controller.isProcessing
+                        ? Colors.orange
+                        : Colors.blueAccent,
+                  ),
+                  const SizedBox(height: 30),
+
+                  // 상태 메시지 표시
+                  Text(
+                    _controller.statusMessage,
+                    textAlign: TextAlign.center,
+                    style: TextStyle(
+                      fontSize: 18,
+                      fontWeight: FontWeight.bold,
+                      color: _controller.isProcessing
+                          ? Colors.orange
+                          : Colors.black87,
+                    ),
+                  ),
+                  const SizedBox(height: 15),
+
+                  const Text(
+                    "자기 주머니 번호 숫자에 폰 뒷면을 '톡' 대면\n자동으로 출석 처리됩니다.",
+                    textAlign: TextAlign.center,
+                    style: TextStyle(color: Colors.grey, fontSize: 14),
+                  ),
+                ],
+              ),
+            ),
+          ),
+        );
+      },
+    );
+  }
+
+  /// 💳 삼성페이 결제창 느낌의 전체화면 "주머니 제출 모드" 안내 UI
+  /// (실제 감시 로직은 pocket_watch_service.dart의 백그라운드 서비스가 담당하므로,
+  ///  이 화면은 상태를 보여주고 화면을 꺼도 된다는 것만 안내한다.)
+  Widget _buildPocketWatchScreen() {
+    return Scaffold(
+      backgroundColor: const Color(0xFF0B1120),
+      body: SafeArea(
+        child: Padding(
+          padding: const EdgeInsets.all(32.0),
+          child: Column(
+            mainAxisAlignment: MainAxisAlignment.center,
+            children: [
+              Container(
+                width: 160,
+                height: 160,
+                decoration: BoxDecoration(
+                  shape: BoxShape.circle,
+                  color: Colors.greenAccent.withValues(alpha: 0.15),
+                  border: Border.all(color: Colors.greenAccent, width: 3),
+                ),
+                child: const Icon(
+                  Icons.shield_rounded,
+                  size: 72,
+                  color: Colors.greenAccent,
+                ),
+              ),
+              const SizedBox(height: 40),
+              Text(
+                _controller.activePocketNumber ?? "",
+                style: const TextStyle(
+                  color: Colors.white54,
+                  fontSize: 14,
+                  letterSpacing: 2,
+                ),
+              ),
+              const SizedBox(height: 12),
+              Text(
+                _controller.statusMessage,
+                textAlign: TextAlign.center,
+                style: const TextStyle(
+                  color: Colors.white,
+                  fontSize: 20,
+                  fontWeight: FontWeight.bold,
+                  height: 1.4,
+                ),
+              ),
+              const SizedBox(height: 8),
+              Text(
+                !kIsWeb && Platform.isIOS
+                    ? "가이드 접근을 켠 채로 화면만 잠기도록 두세요.\n(임의로 앱을 나가면 감시가 끊깁니다)\n감시를 끝내려면 가이드 접근을 먼저 끄고 다시 태깅하세요."
+                    : "화면을 꺼도 감시는 계속됩니다.\n알림바에서 상태를 확인할 수 있어요.\n(폰을 꺼내 다시 태깅하면 반출 처리됩니다)",
+                textAlign: TextAlign.center,
+                style: const TextStyle(color: Colors.white38, fontSize: 13),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/ui/nfc_tag_writer_screen.dart

@@ -0,0 +1,116 @@
+// 🏷️ (관리자용) 주머니 NFC 스티커 초기 설정 화면 (UI 전용). 빈 태그에 "POCKET_번호"를 쓰는
+// 버튼/입력폼을 그린다. NFC 세션/서버 통신은 lib/function/nfc_tag_writer_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/nfc_tag_writer_controller.dart';
+import '../theme/app_palette.dart';
+
+class NfcTagWriterScreen extends StatefulWidget {
+  const NfcTagWriterScreen({super.key});
+
+  @override
+  State<NfcTagWriterScreen> createState() => _NfcTagWriterScreenState();
+}
+
+class _NfcTagWriterScreenState extends State<NfcTagWriterScreen> {
+  final TextEditingController _numberController = TextEditingController(
+    text: "1",
+  );
+  late final NfcTagWriterController _controller;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = NfcTagWriterController(
+      onMessage: _showSnackBar,
+      onNextNumberSuggested: (next) => _numberController.text = next,
+    );
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _numberController.dispose();
+    super.dispose();
+  }
+
+  void _showSnackBar(String text, bool isError) {
+    if (!mounted) return;
+    ScaffoldMessenger.of(context).showSnackBar(
+      SnackBar(
+        content: Text(text),
+        backgroundColor: isError ? Colors.red : Colors.green,
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        final bool isWriting = _controller.isWriting;
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text("NFC 주머니 태그 쓰기"),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: AppPalette.paper,
+          ),
+          body: Padding(
+            padding: const EdgeInsets.all(24.0),
+            child: Column(
+              mainAxisAlignment: MainAxisAlignment.center,
+              children: [
+                TextField(
+                  controller: _numberController,
+                  keyboardType: TextInputType.number,
+                  enabled: !isWriting,
+                  decoration: const InputDecoration(
+                    labelText: "주머니 번호",
+                    prefixText: "POCKET_",
+                    border: OutlineInputBorder(),
+                  ),
+                ),
+                const SizedBox(height: 32),
+                Icon(
+                  isWriting ? Icons.nfc : Icons.edit_note_rounded,
+                  size: 80,
+                  color: isWriting ? Colors.orange : AppPalette.ink,
+                ),
+                const SizedBox(height: 16),
+                Text(
+                  _controller.statusMessage,
+                  textAlign: TextAlign.center,
+                  style: const TextStyle(fontSize: 15),
+                ),
+                const SizedBox(height: 32),
+                SizedBox(
+                  width: double.infinity,
+                  height: 55,
+                  child: ElevatedButton(
+                    style: ElevatedButton.styleFrom(
+                      backgroundColor: AppPalette.ink,
+                      foregroundColor: AppPalette.paper,
+                    ),
+                    onPressed: isWriting
+                        ? null
+                        : () => _controller.startWriteSession(
+                            _numberController.text.trim(),
+                          ),
+                    child: Text(
+                      isWriting ? "태그를 기다리는 중..." : "쓰기 시작",
+                      style: const TextStyle(
+                        fontSize: 16,
+                        fontWeight: FontWeight.bold,
+                      ),
+                    ),
+                  ),
+                ),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

lib/ui/teacher_attendance_page.dart

@@ -0,0 +1,766 @@
+// 📋 실시간 출석 현황 화면 (UI 전용). 위젯 빌드/레이아웃/스타일만 담당하고,
+// 서버 통신·상태·파생 로직은 lib/function/teacher_attendance_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/teacher_attendance_controller.dart';
+import '../theme/app_palette.dart';
+
+// -----------------------------------------------------------------------------
+// 📅 [서브 화면 1] 실시간 출석 확인 란 (StudentDashboard 카드 스타일 리스트화)
+// -----------------------------------------------------------------------------
+class TeacherAttendancePage extends StatefulWidget {
+  const TeacherAttendancePage({super.key});
+
+  @override
+  State<TeacherAttendancePage> createState() => _TeacherAttendancePageState();
+}
+
+class _TeacherAttendancePageState extends State<TeacherAttendancePage> {
+  final TeacherAttendanceController _controller = TeacherAttendanceController();
+
+  @override
+  void initState() {
+    super.initState();
+    _controller.init();
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
+  /// 컨트롤러 액션을 실행하고, 결과 메시지를 스낵바로 보여준다.
+  Future<void> _runAction(Future<String> Function() action) async {
+    final message = await action();
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  Future<void> _showAttendanceTimeDialog() async {
+    final String? current = _controller.attendanceTime;
+    final TimeOfDay initial = current != null
+        ? TimeOfDay(
+            hour: int.parse(current.split(':')[0]),
+            minute: int.parse(current.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')}';
+    await _runAction(() => _controller.setAttendanceTime(formatted));
+  }
+
+  void _showTestResetConfirmDialog() {
+    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);
+              _runAction(() => _controller.resetTestPermissions());
+            },
+            style: ElevatedButton.styleFrom(
+              backgroundColor: Colors.grey[700],
+              foregroundColor: Colors.white,
+            ),
+            child: const Text('초기화'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  void _showAllowDialog(String studentId, String studentName) {
+    final controller = TextEditingController(text: "5");
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        title: Text('$studentName 학생 반출 허용'),
+        content: TextField(
+          controller: controller,
+          keyboardType: TextInputType.number,
+          decoration: const InputDecoration(
+            labelText: '허용 시간 (분)',
+            border: OutlineInputBorder(),
+          ),
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text('취소'),
+          ),
+          ElevatedButton(
+            onPressed: () {
+              final minutes = int.tryParse(controller.text.trim()) ?? 5;
+              Navigator.pop(context);
+              _runAction(() => _controller.allowRemoval(studentId, minutes));
+            },
+            child: const Text('허용하기'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  void _showPermissionWindowDialog() {
+    final controller = TextEditingController(text: "10");
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        title: const Text('전체 학생 반출 허용 시간 설정'),
+        content: Column(
+          mainAxisSize: MainAxisSize.min,
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            const Text(
+              '쉬는시간처럼 지금부터 일정 시간 동안 모든 학생의 반출을 자동으로 허용합니다.',
+              style: TextStyle(fontSize: 13, color: Colors.grey),
+            ),
+            const SizedBox(height: 16),
+            TextField(
+              controller: controller,
+              keyboardType: TextInputType.number,
+              decoration: const InputDecoration(
+                labelText: '지금부터 허용 시간 (분)',
+                border: OutlineInputBorder(),
+              ),
+            ),
+          ],
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text('취소'),
+          ),
+          ElevatedButton(
+            onPressed: () {
+              final minutes = int.tryParse(controller.text.trim()) ?? 10;
+              Navigator.pop(context);
+              _runAction(() => _controller.setPermissionWindow(minutes));
+            },
+            child: const Text('설정하기'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// 🏫 하교 처리: 시간 입력 없이 바로 전체 학생의 반출을 (사실상 무기한) 허용한다.
+  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);
+              _runAction(() => _controller.dismissAll());
+            },
+            child: const Text('하교 처리'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        final all = _controller.combinedStudentStatus;
+        final int totalCount = all.length;
+        final int checkedInCount = all
+            .where((s) => s['isAttendanceComplete'] == true)
+            .length;
+        final int absentCount = totalCount - checkedInCount;
+
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text(
+              '실시간 출석 현황',
+              style: TextStyle(fontWeight: FontWeight.bold),
+            ),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: Colors.white,
+            elevation: 0,
+            actions: [
+              IconButton(
+                onPressed: (_controller.isLoading || _controller.isRefreshing)
+                    ? null
+                    : _controller.manualRefresh,
+                icon: _controller.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(
+                  _controller.attendanceTime != null
+                      ? '출석시간 ${_controller.attendanceTime}'
+                      : '자습실 출석시간 설정',
+                  style: const TextStyle(color: Colors.white),
+                ),
+              ),
+              TextButton.icon(
+                onPressed: _showPermissionWindowDialog,
+                icon: const Icon(Icons.timer_outlined, color: Colors.white),
+                label: const Text(
+                  '반출 허용 시간 설정',
+                  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)),
+              ),
+              IconButton(
+                onPressed: _showTestResetConfirmDialog,
+                icon: const Icon(
+                  Icons.bug_report_outlined,
+                  color: Colors.white70,
+                ),
+                tooltip: '테스트용: 허용시간 초기화',
+              ),
+              const SizedBox(width: 8),
+            ],
+          ),
+          body: _controller.isLoading
+              ? const Center(child: CircularProgressIndicator())
+              : LayoutBuilder(
+                  builder: (context, constraints) {
+                    final bool isWide = constraints.maxWidth >= 800;
+                    return isWide
+                        ? _buildDesktopBody(
+                            totalCount,
+                            checkedInCount,
+                            absentCount,
+                          )
+                        : _buildMobileBody(
+                            totalCount,
+                            checkedInCount,
+                            absentCount,
+                          );
+                  },
+                ),
+        );
+      },
+    );
+  }
+
+  // -----------------------------------------------------------------------
+  // 📱 모바일 레이아웃 (기존 카드 리스트)
+  // -----------------------------------------------------------------------
+  Widget _buildMobileBody(int total, int checkedIn, int absent) {
+    final groups = _controller.studentsByGrade;
+    return Column(
+      children: [
+        _buildSummaryCards(total, checkedIn, absent),
+        _buildPermissionBanner(),
+        _buildFilterChips(),
+        Expanded(
+          child: groups.isEmpty
+              ? const Center(
+                  child: Text(
+                    '해당하는 학생이 없습니다.',
+                    style: TextStyle(color: Colors.grey),
+                  ),
+                )
+              : _buildGradeGroupedList(
+                  groups,
+                  padding: const EdgeInsets.fromLTRB(16, 12, 16, 16),
+                ),
+        ),
+      ],
+    );
+  }
+
+  /// 🏫 학년별로 섹션 제목을 붙여 그리드를 이어붙인 목록. 모바일/데스크톱 공용.
+  Widget _buildGradeGroupedList(
+    List<MapEntry<String, List<Map<String, dynamic>>>> groups, {
+    required EdgeInsets padding,
+  }) {
+    return ListView.builder(
+      padding: padding,
+      itemCount: groups.length,
+      itemBuilder: (context, index) {
+        final group = groups[index];
+        return Padding(
+          padding: EdgeInsets.only(bottom: index == groups.length - 1 ? 0 : 24),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Row(
+                children: [
+                  Container(
+                    width: 4,
+                    height: 16,
+                    decoration: BoxDecoration(
+                      color: AppPalette.ink,
+                      borderRadius: BorderRadius.circular(2),
+                    ),
+                  ),
+                  const SizedBox(width: 8),
+                  Text(
+                    group.key,
+                    style: const TextStyle(
+                      fontSize: 16,
+                      fontWeight: FontWeight.bold,
+                      color: AppPalette.ink,
+                    ),
+                  ),
+                  const SizedBox(width: 6),
+                  Text(
+                    '${group.value.length}명',
+                    style: TextStyle(fontSize: 13, color: Colors.grey[500]),
+                  ),
+                ],
+              ),
+              const SizedBox(height: 10),
+              GridView.builder(
+                shrinkWrap: true,
+                physics: const NeverScrollableScrollPhysics(),
+                gridDelegate: const SliverGridDelegateWithMaxCrossAxisExtent(
+                  maxCrossAxisExtent: 220,
+                  mainAxisSpacing: 12,
+                  crossAxisSpacing: 12,
+                  mainAxisExtent: 148,
+                ),
+                itemCount: group.value.length,
+                itemBuilder: (context, i) => _buildStudentTile(group.value[i]),
+              ),
+            ],
+          ),
+        );
+      },
+    );
+  }
+
+  /// 🀄 학생 한 명을 "한눈에 보기" 타일로 그린다. 모바일/데스크톱 그리드에서 공용으로 쓴다.
+  Widget _buildStudentTile(Map<String, dynamic> student) {
+    final bool isCheckedIn = student['isCheckedIn'];
+    final bool hasViolation = student['hasActiveViolation'] == true;
+    final bool isPending = student['attendanceStatus'] == 'PENDING';
+    final bool isComplete = student['attendanceStatus'] == 'COMPLETE';
+    final Color statusColor = hasViolation
+        ? Colors.red
+        : (isPending ? Colors.orange : (isComplete ? Colors.blue : Colors.red));
+    final String statusLine = hasViolation
+        ? '무단반출 (${student['violationTime']})'
+        : (isPending
+              ? '미완료 (${student['checkInTime']})'
+              : (isComplete
+                    ? '${student['checkInTime']}'
+                    : (student['hasEverCheckedIn'] == true ? '미제출' : '미등록')));
+
+    return Container(
+      padding: const EdgeInsets.all(14),
+      decoration: BoxDecoration(
+        color: hasViolation ? Colors.red[50] : AppPalette.paper,
+        borderRadius: BorderRadius.circular(20),
+        border: Border.all(
+          color: hasViolation ? Colors.red[300]! : AppPalette.sage,
+          width: hasViolation ? 1.5 : 1,
+        ),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.03),
+            blurRadius: 12,
+            offset: const Offset(0, 4),
+          ),
+        ],
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Row(
+            children: [
+              Container(
+                padding: const EdgeInsets.all(8),
+                decoration: BoxDecoration(
+                  color: statusColor.withValues(alpha: 0.1),
+                  shape: BoxShape.circle,
+                ),
+                child: Icon(
+                  hasViolation
+                      ? Icons.warning_amber_rounded
+                      : (isPending
+                            ? Icons.hourglass_bottom_rounded
+                            : (isComplete
+                                  ? Icons.check_circle_rounded
+                                  : Icons.error_rounded)),
+                  color: statusColor,
+                  size: 18,
+                ),
+              ),
+              const Spacer(),
+              if (isCheckedIn && student['pocketNumber'] != null)
+                Container(
+                  padding: const EdgeInsets.symmetric(
+                    horizontal: 8,
+                    vertical: 3,
+                  ),
+                  decoration: BoxDecoration(
+                    color: AppPalette.linen,
+                    borderRadius: BorderRadius.circular(20),
+                    border: Border.all(color: AppPalette.sage),
+                  ),
+                  child: Text(
+                    student['pocketNumber'],
+                    style: const TextStyle(
+                      fontWeight: FontWeight.bold,
+                      color: AppPalette.ink,
+                      fontSize: 11,
+                    ),
+                  ),
+                ),
+            ],
+          ),
+          const SizedBox(height: 8),
+          Text(
+            '${student['studentName']}',
+            maxLines: 1,
+            overflow: TextOverflow.ellipsis,
+            style: const TextStyle(fontWeight: FontWeight.bold, fontSize: 15),
+          ),
+          Text(
+            '학번 ${student['studentId']}',
+            style: TextStyle(color: Colors.grey[500], fontSize: 11),
+          ),
+          const SizedBox(height: 4),
+          Text(
+            statusLine,
+            maxLines: 2,
+            overflow: TextOverflow.ellipsis,
+            style: TextStyle(
+              color: hasViolation
+                  ? Colors.red[700]
+                  : (isPending
+                        ? Colors.orange[800]
+                        : (isComplete ? Colors.grey[600] : Colors.red[400])),
+              fontSize: 11.5,
+              fontWeight: hasViolation ? FontWeight.bold : FontWeight.normal,
+            ),
+          ),
+          if (hasViolation) ...[
+            const Spacer(),
+            SizedBox(
+              width: double.infinity,
+              height: 30,
+              child: ElevatedButton(
+                onPressed: () => _showAllowDialog(
+                  student['studentId'],
+                  student['studentName'],
+                ),
+                style: ElevatedButton.styleFrom(
+                  backgroundColor: Colors.red[600],
+                  foregroundColor: Colors.white,
+                  padding: EdgeInsets.zero,
+                ),
+                child: const Text('반출 허용', style: TextStyle(fontSize: 12)),
+              ),
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+
+  // -----------------------------------------------------------------------
+  // 🖥️ 데스크톱 레이아웃 (선생님이 교실 컴퓨터 브라우저로 접속했을 때)
+  // -----------------------------------------------------------------------
+  Widget _buildDesktopBody(int total, int checkedIn, int absent) {
+    final groups = _controller.studentsByGrade;
+    return Center(
+      child: ConstrainedBox(
+        constraints: const BoxConstraints(maxWidth: 1100),
+        child: Padding(
+          padding: const EdgeInsets.all(24.0),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Row(
+                children: [
+                  Expanded(
+                    child: _statTile(
+                      "전체 학생",
+                      "$total명",
+                      Icons.groups_rounded,
+                      Colors.blueGrey,
+                    ),
+                  ),
+                  const SizedBox(width: 16),
+                  Expanded(
+                    child: _statTile(
+                      "출석 완료",
+                      "$checkedIn명",
+                      Icons.check_circle_rounded,
+                      Colors.green,
+                    ),
+                  ),
+                  const SizedBox(width: 16),
+                  Expanded(
+                    child: _statTile(
+                      "미출석",
+                      "$absent명",
+                      Icons.error_rounded,
+                      Colors.red,
+                    ),
+                  ),
+                ],
+              ),
+              const SizedBox(height: 20),
+              _buildPermissionBanner(),
+              _buildFilterChips(),
+              const SizedBox(height: 12),
+              Expanded(
+                child: Container(
+                  width: double.infinity,
+                  decoration: BoxDecoration(
+                    color: Colors.white,
+                    borderRadius: BorderRadius.circular(16),
+                    boxShadow: [
+                      BoxShadow(
+                        color: Colors.black.withValues(alpha: 0.04),
+                        blurRadius: 16,
+                        offset: const Offset(0, 4),
+                      ),
+                    ],
+                  ),
+                  child: groups.isEmpty
+                      ? const Center(
+                          child: Text(
+                            '해당하는 학생이 없습니다.',
+                            style: TextStyle(color: Colors.grey),
+                          ),
+                        )
+                      : _buildGradeGroupedList(
+                          groups,
+                          padding: const EdgeInsets.all(20),
+                        ),
+                ),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  Widget _statTile(String label, String value, IconData icon, Color color) {
+    return Container(
+      padding: const EdgeInsets.all(20),
+      decoration: BoxDecoration(
+        color: AppPalette.paper,
+        borderRadius: BorderRadius.circular(16),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.04),
+            blurRadius: 12,
+            offset: const Offset(0, 4),
+          ),
+        ],
+      ),
+      child: Row(
+        children: [
+          Container(
+            padding: const EdgeInsets.all(12),
+            decoration: BoxDecoration(
+              color: color.withValues(alpha: 0.1),
+              borderRadius: BorderRadius.circular(12),
+            ),
+            child: Icon(icon, color: color, size: 26),
+          ),
+          const SizedBox(width: 14),
+          Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Text(
+                label,
+                style: TextStyle(color: Colors.grey[600], fontSize: 13),
+              ),
+              const SizedBox(height: 2),
+              Text(
+                value,
+                style: TextStyle(
+                  color: color,
+                  fontSize: 22,
+                  fontWeight: FontWeight.bold,
+                ),
+              ),
+            ],
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// 📊 상단 요약 카드 뷰 (전체 / 출석 완료 / 미출석)
+  Widget _buildSummaryCards(int total, int checkedIn, int absent) {
+    return Container(
+      width: double.infinity,
+      padding: const EdgeInsets.all(16),
+      color: AppPalette.ink,
+      child: Row(
+        mainAxisAlignment: MainAxisAlignment.spaceAround,
+        children: [
+          _summaryCard("전체", "$total명", Colors.white70),
+          _summaryCard("출석 완료", "$checkedIn명", Colors.greenAccent),
+          _summaryCard("미출석", "$absent명", Colors.redAccent),
+        ],
+      ),
+    );
+  }
+
+  Widget _summaryCard(String title, String count, Color color) {
+    return Column(
+      children: [
+        Text(title, style: const TextStyle(color: Colors.grey, fontSize: 12)),
+        const SizedBox(height: 4),
+        Text(
+          count,
+          style: TextStyle(
+            color: color,
+            fontSize: 20,
+            fontWeight: FontWeight.bold,
+          ),
+        ),
+      ],
+    );
+  }
+
+  /// 🔓 하교(12시간)/반출 허용 시간 설정으로 지금 전체 반출이 허용 중이면 눈에 띄게 배너로 알려준다.
+  /// (허용 중일 땐 무단반출을 감지해도 대시보드에 뜨지 않기 때문에, 왜 안 뜨는지 헷갈리지 않게 하기 위함)
+  Widget _buildPermissionBanner() {
+    final String? until = _controller.globalPermissionUntil;
+    if (until == null) return const SizedBox.shrink();
+
+    return Container(
+      width: double.infinity,
+      margin: const EdgeInsets.fromLTRB(16, 8, 16, 0),
+      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 10),
+      decoration: BoxDecoration(
+        color: Colors.amber[100],
+        borderRadius: BorderRadius.circular(12),
+        border: Border.all(color: Colors.amber[400]!),
+      ),
+      child: Row(
+        children: [
+          Icon(Icons.lock_open_rounded, color: Colors.amber[800], size: 20),
+          const SizedBox(width: 8),
+          Expanded(
+            child: Text(
+              '지금 전체 반출 허용 중입니다 ($until 까지) — 이 시간 동안은 무단반출 경고가 뜨지 않아요.',
+              style: TextStyle(
+                color: Colors.amber[900],
+                fontWeight: FontWeight.bold,
+                fontSize: 12.5,
+              ),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// 🔘 필터 칩버튼 (전체 / 출석자 / 미출석자)
+  Widget _buildFilterChips() {
+    return Padding(
+      padding: const EdgeInsets.symmetric(vertical: 8, horizontal: 16),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Wrap(
+            spacing: 8,
+            runSpacing: 8,
+            children: [
+              FilterChip(
+                label: const Text("전체"),
+                selected: _controller.filterType == "ALL",
+                onSelected: (_) => _controller.setFilter("ALL"),
+              ),
+              FilterChip(
+                label: const Text("출석자"),
+                selected: _controller.filterType == "CHECKED_IN",
+                onSelected: (_) => _controller.setFilter("CHECKED_IN"),
+              ),
+              FilterChip(
+                label: const Text("미출석자"),
+                selected: _controller.filterType == "ABSENT",
+                onSelected: (_) => _controller.setFilter("ABSENT"),
+              ),
+            ],
+          ),
+          const SizedBox(height: 8),
+          Wrap(
+            spacing: 8,
+            runSpacing: 8,
+            children: [
+              ChoiceChip(
+                label: const Text("학년 전체"),
+                selected: _controller.gradeFilter == "ALL",
+                onSelected: (_) => _controller.setGradeFilter("ALL"),
+              ),
+              ChoiceChip(
+                label: const Text("1학년"),
+                selected: _controller.gradeFilter == "1",
+                onSelected: (_) => _controller.setGradeFilter("1"),
+              ),
+              ChoiceChip(
+                label: const Text("2학년"),
+                selected: _controller.gradeFilter == "2",
+                onSelected: (_) => _controller.setGradeFilter("2"),
+              ),
+              ChoiceChip(
+                label: const Text("3학년"),
+                selected: _controller.gradeFilter == "3",
+                onSelected: (_) => _controller.setGradeFilter("3"),
+              ),
+            ],
+          ),
+        ],
+      ),
+    );
+  }
+}

lib/ui/teacher_register_screen.dart

@@ -0,0 +1,143 @@
+// 👨‍🏫 교사 회원가입 화면 (UI 전용). 서버 통신/상태는
+// lib/function/teacher_register_controller.dart가 담당한다.
+import 'package:flutter/material.dart';
+import '../function/teacher_register_controller.dart';
+import '../theme/app_palette.dart';
+
+class TeacherRegisterScreen extends StatefulWidget {
+  const TeacherRegisterScreen({super.key});
+
+  @override
+  State<TeacherRegisterScreen> createState() => _TeacherRegisterScreenState();
+}
+
+class _TeacherRegisterScreenState extends State<TeacherRegisterScreen> {
+  final TeacherRegisterController _controller = TeacherRegisterController();
+  final _idController = TextEditingController();
+  final _pwController = TextEditingController();
+  final _nameController = TextEditingController();
+  final _secretController = TextEditingController();
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _idController.dispose();
+    _pwController.dispose();
+    _nameController.dispose();
+    _secretController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _registerTeacher() async {
+    String id = _idController.text.trim();
+    String pw = _pwController.text.trim();
+    String name = _nameController.text.trim();
+    String secret = _secretController.text.trim();
+
+    if (id.isEmpty || pw.isEmpty || name.isEmpty || secret.isEmpty) {
+      ScaffoldMessenger.of(
+        context,
+      ).showSnackBar(const SnackBar(content: Text('모든 빈칸을 입력해 주세요.')));
+      return;
+    }
+
+    final (success, message) = await _controller.registerTeacher(
+      id: id,
+      password: pw,
+      name: name,
+      secretCode: secret,
+    );
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+    if (success) {
+      Navigator.pop(context); // 가입 성공 시 로그인 화면으로 복귀
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text('교사 회원가입'),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: AppPalette.paper,
+          ),
+          body: SingleChildScrollView(
+            padding: const EdgeInsets.all(24.0),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                const Text(
+                  '교직원 전용 인증',
+                  style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+                ),
+                const SizedBox(height: 4),
+                const Text(
+                  '학교에서 발급한 교사 가입 비밀코드가 필요합니다.',
+                  style: TextStyle(color: Colors.grey),
+                ),
+                const SizedBox(height: 24),
+                TextField(
+                  controller: _secretController,
+                  obscureText: true,
+                  decoration: const InputDecoration(
+                    labelText: '교사 인증 비밀코드 입력',
+                    border: OutlineInputBorder(),
+                  ),
+                ),
+                const SizedBox(height: 16),
+                const Divider(),
+                const SizedBox(height: 16),
+                TextField(
+                  controller: _idController,
+                  decoration: const InputDecoration(
+                    labelText: '교직원 번호 (ID로 사용)',
+                    border: OutlineInputBorder(),
+                  ),
+                ),
+                const SizedBox(height: 12),
+                TextField(
+                  controller: _nameController,
+                  decoration: const InputDecoration(
+                    labelText: '선생님 성함',
+                    border: OutlineInputBorder(),
+                  ),
+                ),
+                const SizedBox(height: 12),
+                TextField(
+                  controller: _pwController,
+                  obscureText: true,
+                  decoration: const InputDecoration(
+                    labelText: '사용할 비밀번호 입력',
+                    border: OutlineInputBorder(),
+                  ),
+                ),
+                const SizedBox(height: 24),
+                SizedBox(
+                  width: double.infinity,
+                  height: 50,
+                  child: ElevatedButton(
+                    style: ElevatedButton.styleFrom(
+                      backgroundColor: AppPalette.ink,
+                      foregroundColor: AppPalette.paper,
+                    ),
+                    onPressed: _controller.isLoading ? null : _registerTeacher,
+                    child: _controller.isLoading
+                        ? const CircularProgressIndicator(color: Colors.white)
+                        : const Text('교사 계정 생성하기'),
+                  ),
+                ),
+              ],
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

lib/ui/teacher_student_management_page.dart

@@ -0,0 +1,816 @@
+// 👥 교사용 학생 계정 관리 화면 (UI 전용). 신규 학생 계정 추가 폼과 강제 삭제 다이얼로그를 그린다.
+// 서버 통신/상태는 lib/function/teacher_student_management_controller.dart가 담당한다.
+import 'dart:typed_data';
+import 'package:desktop_drop/desktop_drop.dart';
+import 'package:flutter/material.dart';
+import '../function/excel_file_picker.dart';
+import '../function/teacher_student_management_controller.dart';
+import '../theme/app_palette.dart';
+
+// 📐 "실시간 출석 확인" 목록(teacher_attendance_page.dart)의 타일 규격과 동일하게 맞춘다.
+const double kAttendanceTileWidth = 220;
+const double kAttendanceTileHeight = 148;
+
+// -----------------------------------------------------------------------------
+// 👥 [서브 화면 2] 학생 계정 관리 란 (추가 양식 폼 + 강제 삭제 다이얼로그 완전 내장)
+// -----------------------------------------------------------------------------
+class TeacherStudentManagementPage extends StatefulWidget {
+  const TeacherStudentManagementPage({super.key});
+
+  @override
+  State<TeacherStudentManagementPage> createState() =>
+      _TeacherStudentManagementPageState();
+}
+
+class _TeacherStudentManagementPageState
+    extends State<TeacherStudentManagementPage> {
+  final TeacherStudentManagementController _controller =
+      TeacherStudentManagementController();
+  final TextEditingController _addIdController = TextEditingController();
+  final TextEditingController _addNameController = TextEditingController();
+  int? _selectedGrade;
+  bool _isDragging = false;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller.init();
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _addIdController.dispose();
+    _addNameController.dispose();
+    super.dispose();
+  }
+
+  // ➕ [학생 추가 버튼 동작] 기본 비밀번호는 항상 1234로 고정.
+  Future<void> _addStudentAccount() async {
+    final sId = _addIdController.text.trim();
+    final sName = _addNameController.text.trim();
+
+    if (sId.isEmpty || sName.isEmpty) {
+      ScaffoldMessenger.of(
+        context,
+      ).showSnackBar(const SnackBar(content: Text('모든 입력란을 채워주세요.')));
+      return;
+    }
+
+    final (success, message) = await _controller.addStudentAccount(
+      studentId: sId,
+      name: sName,
+      password: '1234',
+      grade: _selectedGrade,
+    );
+    if (!mounted) return;
+    if (success) {
+      _addIdController.clear();
+      _addNameController.clear();
+      setState(() => _selectedGrade = null);
+    }
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  // 📄 [파일 선택 버튼 동작] "파일 선택"으로 엑셀 고르기
+  Future<void> _pickExcelFile() async {
+    final bytes = await pickExcelFileBytes();
+    if (bytes == null) return;
+    if (!mounted) return;
+    await _handleExcelBytes(bytes);
+  }
+
+  // 📄 엑셀 바이트를 파싱해서 미리보기 다이얼로그를 띄운다 (드래그/파일선택 공용).
+  Future<void> _handleExcelBytes(Uint8List bytes) async {
+    List<BulkStudentRow> rows;
+    try {
+      rows = _controller.parseExcelBytes(bytes);
+    } catch (e) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(
+        context,
+      ).showSnackBar(SnackBar(content: Text('엑셀 파일을 읽는 데 실패했습니다: $e')));
+      return;
+    }
+    if (rows.isEmpty) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        const SnackBar(content: Text('유효한 학생 데이터를 찾지 못했습니다. (1행은 머리글로 건너뜁니다)')),
+      );
+      return;
+    }
+    _showBulkPreviewDialog(rows);
+  }
+
+  // 📋 [일괄 등록 확인 팝업] 엑셀에서 뽑아낸 명단을 미리 보여주고 확정받는다.
+  void _showBulkPreviewDialog(List<BulkStudentRow> rows) {
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(24)),
+        title: Text('${rows.length}명 확인됨'),
+        content: SizedBox(
+          width: 400,
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              const Text(
+                '아래 명단으로 계정을 일괄 생성합니다 (초기 비밀번호: 1234).',
+                style: TextStyle(color: Colors.black54, fontSize: 13),
+              ),
+              const SizedBox(height: 12),
+              ConstrainedBox(
+                constraints: const BoxConstraints(maxHeight: 300),
+                child: ListView.builder(
+                  shrinkWrap: true,
+                  itemCount: rows.length,
+                  itemBuilder: (context, i) {
+                    final row = rows[i];
+                    return ListTile(
+                      dense: true,
+                      leading: CircleAvatar(
+                        radius: 14,
+                        child: Text(
+                          '${i + 1}',
+                          style: const TextStyle(fontSize: 11),
+                        ),
+                      ),
+                      title: Text('${row.name} (${row.studentId})'),
+                      trailing: Text(
+                        row.grade != null ? '${row.grade}학년' : '미배정',
+                        style: TextStyle(color: Colors.grey[600]),
+                      ),
+                    );
+                  },
+                ),
+              ),
+            ],
+          ),
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text('취소', style: TextStyle(color: Colors.grey)),
+          ),
+          ElevatedButton(
+            onPressed: () {
+              Navigator.pop(context);
+              _runBulkImport(rows);
+            },
+            style: ElevatedButton.styleFrom(
+              backgroundColor: AppPalette.ink,
+              foregroundColor: AppPalette.paper,
+              shape: RoundedRectangleBorder(
+                borderRadius: BorderRadius.circular(12),
+              ),
+            ),
+            child: Text('${rows.length}명 일괄 등록'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  // 🚀 실제 일괄 등록 실행 + 진행 상황 표시 + 결과 요약 팝업.
+  Future<void> _runBulkImport(List<BulkStudentRow> rows) async {
+    showDialog(
+      context: context,
+      barrierDismissible: false,
+      builder: (context) => ListenableBuilder(
+        listenable: _controller,
+        builder: (context, _) => AlertDialog(
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(24),
+          ),
+          content: Row(
+            children: [
+              const CircularProgressIndicator(),
+              const SizedBox(width: 20),
+              Text(
+                '등록 중... (${_controller.bulkDone}/${_controller.bulkTotal})',
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+
+    final result = await _controller.bulkAddStudents(rows);
+
+    if (!mounted) return;
+    Navigator.pop(context); // 진행 팝업 닫기
+
+    showDialog(
+      context: context,
+      builder: (context) => AlertDialog(
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(24)),
+        title: Text(result.failures.isEmpty ? '일괄 등록 완료' : '일괄 등록 완료 (일부 실패)'),
+        content: SizedBox(
+          width: 400,
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Text(
+                '성공 ${result.successCount}명 / 실패 ${result.failures.length}명',
+              ),
+              if (result.failures.isNotEmpty) ...[
+                const SizedBox(height: 12),
+                const Text(
+                  '실패 목록',
+                  style: TextStyle(fontWeight: FontWeight.bold),
+                ),
+                const SizedBox(height: 6),
+                ConstrainedBox(
+                  constraints: const BoxConstraints(maxHeight: 200),
+                  child: SingleChildScrollView(
+                    child: Text(
+                      result.failures.join('\n'),
+                      style: const TextStyle(fontSize: 12, color: Colors.red),
+                    ),
+                  ),
+                ),
+              ],
+            ],
+          ),
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(context),
+            child: const Text('확인'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  // 🏫 [목록 행의 "학년" 칩] 눌러서 바로 학년 변경 (미배정/1/2/3학년 중 선택).
+  Future<void> _showGradeMenu(
+    BuildContext tileContext,
+    String studentId,
+    String studentName,
+    int? currentGrade,
+  ) async {
+    final RenderBox box = tileContext.findRenderObject() as RenderBox;
+    final Offset position = box.localToGlobal(Offset.zero);
+
+    final selected = await showMenu<int?>(
+      context: tileContext,
+      position: RelativeRect.fromLTRB(
+        position.dx,
+        position.dy + box.size.height,
+        position.dx,
+        0,
+      ),
+      items: const [
+        PopupMenuItem(value: null, child: Text('미배정')),
+        PopupMenuItem(value: 1, child: Text('1학년')),
+        PopupMenuItem(value: 2, child: Text('2학년')),
+        PopupMenuItem(value: 3, child: Text('3학년')),
+      ],
+    );
+    if (selected == currentGrade) return; // 취소했거나 같은 값 선택
+    if (!mounted) return;
+
+    final (_, message) = await _controller.updateStudentGrade(
+      studentId: studentId,
+      grade: selected,
+    );
+    if (!mounted) return;
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
+  }
+
+  // 🔓 [목록 행의 "기기 리셋" 버튼] 학생이 폰을 바꿨을 때 등록 초기화.
+  void _confirmResetDevice(String studentId, String studentName) {
+    showDialog(
+      context: context,
+      builder: (ctx) => AlertDialog(
+        title: const Text(
+          '기기 등록 초기화',
+          style: TextStyle(fontWeight: FontWeight.bold, color: AppPalette.ink),
+        ),
+        content: Text('$studentName 학생의 스마트폰 기기 등록과 비밀번호(1234)를 초기화하시겠습니까?'),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(ctx),
+            child: const Text('취소', style: TextStyle(color: Colors.grey)),
+          ),
+          ElevatedButton(
+            style: ElevatedButton.styleFrom(
+              backgroundColor: AppPalette.ink,
+              foregroundColor: AppPalette.paper,
+            ),
+            onPressed: () async {
+              Navigator.pop(ctx);
+              final (_, message) = await _controller.resetDevice(
+                studentId,
+                studentName,
+              );
+              if (!mounted) return;
+              ScaffoldMessenger.of(
+                context,
+              ).showSnackBar(SnackBar(content: Text(message)));
+            },
+            child: const Text('초기화 승인'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  // 🚨 [목록 행의 삭제 버튼] 계정 완전 삭제 확인 팝업.
+  void _confirmDeleteStudent(String studentId, String studentName) {
+    showDialog(
+      context: context,
+      builder: (ctx) => AlertDialog(
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(24)),
+        title: Row(
+          children: [
+            Icon(Icons.warning_amber_rounded, color: Colors.red[700]),
+            const SizedBox(width: 10),
+            const Text(
+              '계정 완전 삭제',
+              style: TextStyle(fontWeight: FontWeight.bold, fontSize: 18),
+            ),
+          ],
+        ),
+        content: Text(
+          '정말로 $studentName ($studentId) 학생의 계정을 영구 삭제하시겠습니까?\n이 작업은 되돌릴 수 없습니다.',
+        ),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.pop(ctx),
+            child: const Text('취소', style: TextStyle(color: Colors.grey)),
+          ),
+          ElevatedButton(
+            style: ElevatedButton.styleFrom(
+              backgroundColor: Colors.red[600],
+              foregroundColor: Colors.white,
+            ),
+            onPressed: () async {
+              Navigator.pop(ctx);
+              final (_, message) = await _controller.deleteStudentAccount(
+                studentId,
+              );
+              if (!mounted) return;
+              ScaffoldMessenger.of(
+                context,
+              ).showSnackBar(SnackBar(content: Text(message)));
+            },
+            child: const Text('영구 삭제'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  // 🏷️ 섹션 제목 (색 인디케이터 바 + 텍스트).
+  Widget _sectionTitle(String text, {Color color = AppPalette.ink}) {
+    return Row(
+      children: [
+        Container(
+          width: 4,
+          height: 16,
+          decoration: BoxDecoration(
+            color: color,
+            borderRadius: BorderRadius.circular(2),
+          ),
+        ),
+        const SizedBox(width: 8),
+        Text(
+          text,
+          style: const TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
+        ),
+      ],
+    );
+  }
+
+  // 📝 [정사각형 박스 1] 신규 학생 계정 추가 폼. 박스가 작아도 버튼까지 다 보이도록 촘촘하게 배치.
+  Widget _buildAddAccountBox() {
+    const InputDecoration Function(String, IconData) fieldDecoration =
+        _compactFieldDecoration;
+    return Container(
+      padding: const EdgeInsets.all(10),
+      decoration: BoxDecoration(
+        color: AppPalette.paper,
+        borderRadius: BorderRadius.circular(24),
+        border: Border.all(color: AppPalette.sage),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.04),
+            blurRadius: 16,
+          ),
+        ],
+      ),
+      child: SingleChildScrollView(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            TextField(
+              controller: _addIdController,
+              keyboardType: TextInputType.number,
+              style: const TextStyle(fontSize: 12),
+              decoration: fieldDecoration('학번', Icons.badge),
+            ),
+            const SizedBox(height: 4),
+            TextField(
+              controller: _addNameController,
+              style: const TextStyle(fontSize: 12),
+              decoration: fieldDecoration('이름', Icons.person),
+            ),
+            const SizedBox(height: 4),
+            const Padding(
+              padding: EdgeInsets.symmetric(horizontal: 4),
+              child: Row(
+                children: [
+                  Icon(Icons.lock, size: 14, color: Colors.grey),
+                  SizedBox(width: 6),
+                  Text(
+                    '초기 비밀번호: 1234 (고정)',
+                    style: TextStyle(fontSize: 11, color: Colors.grey),
+                  ),
+                ],
+              ),
+            ),
+            const SizedBox(height: 4),
+            DropdownButtonFormField<int>(
+              initialValue: _selectedGrade,
+              style: const TextStyle(fontSize: 12, color: Colors.black87),
+              decoration: fieldDecoration('학년 (선택)', Icons.class_),
+              items: const [
+                DropdownMenuItem(value: 1, child: Text('1학년')),
+                DropdownMenuItem(value: 2, child: Text('2학년')),
+                DropdownMenuItem(value: 3, child: Text('3학년')),
+              ],
+              onChanged: (value) => setState(() => _selectedGrade = value),
+            ),
+            const SizedBox(height: 6),
+            SizedBox(
+              width: double.infinity,
+              height: 30,
+              child: ElevatedButton(
+                onPressed: _controller.isWorking ? null : _addStudentAccount,
+                style: ElevatedButton.styleFrom(
+                  backgroundColor: AppPalette.ink,
+                  foregroundColor: AppPalette.paper,
+                  padding: EdgeInsets.zero,
+                  shape: RoundedRectangleBorder(
+                    borderRadius: BorderRadius.circular(10),
+                  ),
+                ),
+                child: _controller.isWorking
+                    ? const SizedBox(
+                        width: 16,
+                        height: 16,
+                        child: CircularProgressIndicator(
+                          color: Colors.white,
+                          strokeWidth: 2,
+                        ),
+                      )
+                    : const Text(
+                        '학생 등록 완료',
+                        style: TextStyle(
+                          fontWeight: FontWeight.bold,
+                          fontSize: 12,
+                        ),
+                      ),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  static InputDecoration _compactFieldDecoration(String label, IconData icon) {
+    return InputDecoration(
+      labelText: label,
+      labelStyle: const TextStyle(fontSize: 12),
+      prefixIcon: Icon(icon, size: 16),
+      isDense: true,
+      contentPadding: const EdgeInsets.symmetric(vertical: 4, horizontal: 8),
+    );
+  }
+
+  // 📤 [정사각형 박스 2] 엑셀 일괄 등록 드롭존.
+  Widget _buildExcelBox() {
+    return DropTarget(
+      onDragEntered: (_) => setState(() => _isDragging = true),
+      onDragExited: (_) => setState(() => _isDragging = false),
+      onDragDone: (details) async {
+        setState(() => _isDragging = false);
+        if (details.files.isEmpty) return;
+        final bytes = await details.files.first.readAsBytes();
+        if (!mounted) return;
+        await _handleExcelBytes(bytes);
+      },
+      child: InkWell(
+        onTap: _pickExcelFile,
+        borderRadius: BorderRadius.circular(24),
+        child: Container(
+          width: double.infinity,
+          height: double.infinity,
+          padding: const EdgeInsets.all(20),
+          decoration: BoxDecoration(
+            color: _isDragging ? Colors.orange[50] : AppPalette.paper,
+            borderRadius: BorderRadius.circular(24),
+            border: Border.all(
+              color: _isDragging ? Colors.orange : AppPalette.sage,
+              width: _isDragging ? 2 : 1,
+            ),
+          ),
+          child: Column(
+            mainAxisAlignment: MainAxisAlignment.center,
+            children: [
+              Icon(
+                Icons.upload_file_rounded,
+                size: 40,
+                color: _isDragging ? Colors.orange : AppPalette.sage,
+              ),
+              const SizedBox(height: 12),
+              Text(
+                _isDragging ? '여기에 놓으세요' : '엑셀 파일을 드래그하거나 눌러서 선택',
+                textAlign: TextAlign.center,
+                style: TextStyle(
+                  fontWeight: FontWeight.bold,
+                  color: _isDragging ? Colors.orange[800] : AppPalette.ink,
+                ),
+              ),
+              const SizedBox(height: 4),
+              Text(
+                '.xlsx · 1행은 머리글, A열=학번 B열=이름 C열=학년(선택)',
+                style: TextStyle(fontSize: 12, color: Colors.grey[500]),
+                textAlign: TextAlign.center,
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  // 🧑‍🎓 [학생 목록 타일] 아이콘/이름/상태/액션을 모두 중앙 정렬한 정사각 타일.
+  Widget _buildStudentTile(Map<String, dynamic> student) {
+    final String studentId = student['id'].toString();
+    final String studentName = student['name'].toString();
+    final int? grade = student['grade'] as int?;
+    final bool needsReset = student['device'] == '초기화 필요';
+
+    return Container(
+      padding: const EdgeInsets.all(14),
+      decoration: BoxDecoration(
+        color: AppPalette.paper,
+        borderRadius: BorderRadius.circular(20),
+        border: Border.all(color: AppPalette.sage),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.03),
+            blurRadius: 12,
+            offset: const Offset(0, 4),
+          ),
+        ],
+      ),
+      child: Column(
+        mainAxisAlignment: MainAxisAlignment.center,
+        crossAxisAlignment: CrossAxisAlignment.center,
+        children: [
+          Container(
+            padding: const EdgeInsets.all(8),
+            decoration: BoxDecoration(
+              color: needsReset
+                  ? Colors.red.withValues(alpha: 0.1)
+                  : AppPalette.linen,
+              shape: BoxShape.circle,
+            ),
+            child: Icon(
+              needsReset ? Icons.lock_reset : Icons.person,
+              size: 18,
+              color: needsReset ? Colors.red : AppPalette.ink,
+            ),
+          ),
+          const SizedBox(height: 8),
+          Text(
+            '$studentName ($studentId)',
+            textAlign: TextAlign.center,
+            maxLines: 1,
+            overflow: TextOverflow.ellipsis,
+            style: const TextStyle(fontWeight: FontWeight.bold, fontSize: 15),
+          ),
+          const SizedBox(height: 4),
+          Text(
+            needsReset ? '초기화 대기중' : '정상 등록',
+            textAlign: TextAlign.center,
+            style: TextStyle(
+              fontSize: 11.5,
+              color: needsReset ? Colors.red[700] : Colors.grey[600],
+              fontWeight: needsReset ? FontWeight.bold : FontWeight.normal,
+            ),
+          ),
+          const SizedBox(height: 6),
+          Wrap(
+            alignment: WrapAlignment.center,
+            spacing: 2,
+            runSpacing: 2,
+            children: [
+              Builder(
+                builder: (chipContext) => ActionChip(
+                  visualDensity: VisualDensity.compact,
+                  materialTapTargetSize: MaterialTapTargetSize.shrinkWrap,
+                  labelPadding: const EdgeInsets.symmetric(horizontal: 6),
+                  label: Text(
+                    grade != null ? '$grade학년' : '미배정',
+                    style: const TextStyle(fontSize: 11),
+                  ),
+                  onPressed: () => _showGradeMenu(
+                    chipContext,
+                    studentId,
+                    studentName,
+                    grade,
+                  ),
+                ),
+              ),
+              IconButton(
+                icon: const Icon(
+                  Icons.lock_reset,
+                  color: AppPalette.ink,
+                  size: 18,
+                ),
+                tooltip: '기기 리셋',
+                padding: EdgeInsets.zero,
+                constraints: const BoxConstraints(minWidth: 28, minHeight: 28),
+                onPressed: () => _confirmResetDevice(studentId, studentName),
+              ),
+              IconButton(
+                icon: const Icon(
+                  Icons.delete_forever_rounded,
+                  color: Colors.redAccent,
+                  size: 18,
+                ),
+                tooltip: '계정 영구 삭제',
+                padding: EdgeInsets.zero,
+                constraints: const BoxConstraints(minWidth: 28, minHeight: 28),
+                onPressed: () => _confirmDeleteStudent(studentId, studentName),
+              ),
+            ],
+          ),
+        ],
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return ListenableBuilder(
+      listenable: _controller,
+      builder: (context, _) {
+        return Scaffold(
+          backgroundColor: AppPalette.mist,
+          appBar: AppBar(
+            title: const Text(
+              '학생 통합 관리 센터',
+              style: TextStyle(fontWeight: FontWeight.bold),
+            ),
+            backgroundColor: AppPalette.ink,
+            foregroundColor: AppPalette.paper,
+            elevation: 0,
+          ),
+          body: SingleChildScrollView(
+            padding: const EdgeInsets.all(24.0),
+            child: LayoutBuilder(
+              builder: (context, constraints) {
+                // 🖥️ 웹(넓은 화면)은 계정 추가/엑셀 등록을 정사각형 2칸으로 나란히, 폰은 기존처럼 세로로 쌓는다.
+                // 📐 학생 목록 타일은 "실시간 출석 확인" 목록의 타일(220x148)과 동일하게 맞춘다.
+                final bool isWide = constraints.maxWidth >= 800;
+                final double listWidth = constraints.maxWidth;
+                // 📉 계정 추가 / 엑셀 등록 칸: 정사각형 기본 크기의 25%(+ 버튼까지 다 보이도록 확대).
+                final double formSquareSize =
+                    ((constraints.maxWidth - 20) / 2) * 0.25 * 1.45;
+
+                final Widget addBoxColumn = Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    _sectionTitle('신규 학생 계정 추가'),
+                    const SizedBox(height: 16),
+                    SizedBox(
+                      width: isWide ? formSquareSize : double.infinity,
+                      height: isWide ? formSquareSize : null,
+                      child: _buildAddAccountBox(),
+                    ),
+                  ],
+                );
+
+                final Widget excelBoxColumn = Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    _sectionTitle('엑셀로 한번에 추가 (신입생 등)'),
+                    const SizedBox(height: 16),
+                    SizedBox(
+                      width: isWide ? formSquareSize : double.infinity,
+                      height: isWide ? formSquareSize : 240,
+                      child: _buildExcelBox(),
+                    ),
+                  ],
+                );
+
+                return Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    isWide
+                        ? Row(
+                            crossAxisAlignment: CrossAxisAlignment.start,
+                            children: [
+                              addBoxColumn,
+                              const SizedBox(width: 20),
+                              excelBoxColumn,
+                            ],
+                          )
+                        : Column(
+                            crossAxisAlignment: CrossAxisAlignment.start,
+                            children: [
+                              addBoxColumn,
+                              const SizedBox(height: 24),
+                              excelBoxColumn,
+                            ],
+                          ),
+                    const SizedBox(height: 36),
+
+                    // 🏷️ 인디케이터 바 (전체 학생 목록) — 위 두 칸을 합친 폭에 맞춘다.
+                    SizedBox(
+                      width: listWidth,
+                      child: Column(
+                        crossAxisAlignment: CrossAxisAlignment.start,
+                        children: [
+                          Row(
+                            children: [
+                              _sectionTitle('전체 학생 목록'),
+                              const Spacer(),
+                              IconButton(
+                                icon: const Icon(Icons.refresh_rounded),
+                                onPressed: _controller.isLoadingStudents
+                                    ? null
+                                    : _controller.fetchStudents,
+                                tooltip: '새로고침',
+                              ),
+                            ],
+                          ),
+                          const SizedBox(height: 8),
+                          const Text(
+                            '학년 칩을 눌러 학년을 바꾸고, 기기 리셋은 학생이 폰을 바꿨을 때 사용하세요.',
+                            style: TextStyle(
+                              color: Colors.black54,
+                              fontSize: 12,
+                            ),
+                          ),
+                          const SizedBox(height: 12),
+                          _controller.isLoadingStudents
+                              ? const Padding(
+                                  padding: EdgeInsets.symmetric(vertical: 40),
+                                  child: Center(
+                                    child: CircularProgressIndicator(),
+                                  ),
+                                )
+                              : _controller.students.isEmpty
+                              ? const Padding(
+                                  padding: EdgeInsets.symmetric(vertical: 24),
+                                  child: Center(
+                                    child: Text(
+                                      '가입된 학생 계정이 없습니다.',
+                                      style: TextStyle(color: Colors.grey),
+                                    ),
+                                  ),
+                                )
+                              : GridView.builder(
+                                  shrinkWrap: true,
+                                  physics: const NeverScrollableScrollPhysics(),
+                                  gridDelegate:
+                                      const SliverGridDelegateWithMaxCrossAxisExtent(
+                                        maxCrossAxisExtent:
+                                            kAttendanceTileWidth,
+                                        mainAxisExtent: kAttendanceTileHeight,
+                                        crossAxisSpacing: 12,
+                                        mainAxisSpacing: 12,
+                                      ),
+                                  itemCount: _controller.students.length,
+                                  itemBuilder: (context, index) =>
+                                      _buildStudentTile(
+                                        _controller.students[index],
+                                      ),
+                                ),
+                        ],
+                      ),
+                    ),
+                  ],
+                );
+              },
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

linux/flutter/generated_plugin_registrant.cc

@@ -6,6 +6,10 @@
 
 #include "generated_plugin_registrant.h"
 
+#include <desktop_drop/desktop_drop_plugin.h>
 
 void fl_register_plugins(FlPluginRegistry* registry) {
+  g_autoptr(FlPluginRegistrar) desktop_drop_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "DesktopDropPlugin");
+  desktop_drop_plugin_register_with_registrar(desktop_drop_registrar);
 }

linux/flutter/generated_plugins.cmake

@@ -3,6 +3,7 @@
 #
 
 list(APPEND FLUTTER_PLUGIN_LIST
+  desktop_drop
 )
 
 list(APPEND FLUTTER_FFI_PLUGIN_LIST

macos/Flutter/GeneratedPluginRegistrant.swift

@@ -5,14 +5,20 @@
 import FlutterMacOS
 import Foundation
 
+import desktop_drop
 import device_info_plus
+import file_picker_darwin
 import firebase_core
 import firebase_messaging
 import flutter_local_notifications
+import shared_preferences_foundation
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
+  DesktopDropPlugin.register(with: registry.registrar(forPlugin: "DesktopDropPlugin"))
   DeviceInfoPlusMacosPlugin.register(with: registry.registrar(forPlugin: "DeviceInfoPlusMacosPlugin"))
+  FilePickerPlugin.register(with: registry.registrar(forPlugin: "FilePickerPlugin"))
   FLTFirebaseCorePlugin.register(with: registry.registrar(forPlugin: "FLTFirebaseCorePlugin"))
   FLTFirebaseMessagingPlugin.register(with: registry.registrar(forPlugin: "FLTFirebaseMessagingPlugin"))
   FlutterLocalNotificationsPlugin.register(with: registry.registrar(forPlugin: "FlutterLocalNotificationsPlugin"))
+  SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))
 }

pubspec.lock

@@ -9,6 +9,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.3.75"
+  android_file_picker:
+    dependency: transitive
+    description:
+      name: android_file_picker
+      sha256: "1f111ed6bb33724ba782cc86357e3fd97f57051d55fc61adf33dcfc5049a1581"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.3"
+  archive:
+    dependency: transitive
+    description:
+      name: archive
+      sha256: cb6a278ef2dbb298455e1a713bda08524a175630ec643a242c399c932a0a1f7d
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.6.1"
   args:
     dependency: transitive
     description:
@@ -57,6 +73,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.19.1"
+  cross_file:
+    dependency: transitive
+    description:
+      name: cross_file
+      sha256: f141ea4f277af142a0356955707f6556f37b03947d39d55585981a06ca437bd6
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.3.5+5"
+  crypto:
+    dependency: transitive
+    description:
+      name: crypto
+      sha256: c8ea0233063ba03258fbcf2ca4d6dadfefe14f02fab57702265467a19f27fadf
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.7"
   cupertino_icons:
     dependency: "direct main"
     description:
@@ -73,6 +105,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.7.14"
+  desktop_drop:
+    dependency: "direct main"
+    description:
+      name: desktop_drop
+      sha256: "4c639b4cb80780d1cb94c3252309772e5e68522372181497bc9cd2fbd973aec1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.8.3"
   device_info_plus:
     dependency: "direct main"
     description:
@@ -89,6 +129,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "8.1.0"
+  equatable:
+    dependency: transitive
+    description:
+      name: equatable
+      sha256: "3bce007a596ff8b3119c45d68aaef631272537c03d30e5d4534dd24bf4c5eaa2"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.0"
+  excel:
+    dependency: "direct main"
+    description:
+      name: excel
+      sha256: "1a15327dcad260d5db21d1f6e04f04838109b39a2f6a84ea486ceda36e468780"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.0.6"
   fake_async:
     dependency: transitive
     description:
@@ -121,6 +177,46 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "7.0.1"
+  file_picker:
+    dependency: "direct main"
+    description:
+      name: file_picker
+      sha256: b7acb5d123cb398f6b4a8a38e43777545254f8fc1fabef3ee11cbbb56aece9c8
+      url: "https://pub.dev"
+    source: hosted
+    version: "12.1.2"
+  file_picker_darwin:
+    dependency: transitive
+    description:
+      name: file_picker_darwin
+      sha256: "6e7cae501d48fd57a27911608db718ebd898e6ccf934bf09e33a8c0d0365bec0"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.4"
+  file_picker_linux:
+    dependency: transitive
+    description:
+      name: file_picker_linux
+      sha256: f0f01ed42967b7355f6f25c8b121ea531d1948e2a9b4b44f4b4de8489d7b04ae
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.0.2"
+  file_picker_platform_interface:
+    dependency: transitive
+    description:
+      name: file_picker_platform_interface
+      sha256: "11ef1b5c14d9186b4788cc273dd8d5cb81bca847145060991a28234ff7916fc1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.2.0"
+  file_picker_web:
+    dependency: transitive
+    description:
+      name: file_picker_web
+      sha256: df472142f63c4557fdfbb375c81454ca1c251491069eefcdc6a866bc12f8750b
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.3"
   firebase_core:
     dependency: "direct main"
     description:
@@ -254,6 +350,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.1.1"
+  flutter_staggered_grid_view:
+    dependency: "direct main"
+    description:
+      name: flutter_staggered_grid_view
+      sha256: "19e7abb550c96fbfeb546b23f3ff356ee7c59a019a651f8f102a4ba9b7349395"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.7.0"
   flutter_test:
     dependency: "direct dev"
     description: flutter
@@ -376,6 +480,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.9.1"
+  path_provider_linux:
+    dependency: transitive
+    description:
+      name: path_provider_linux
+      sha256: "58c2005f147315b11e9b4a7bc889cd5203e250cba8e3f012dae259b4972b5c16"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.2"
+  path_provider_platform_interface:
+    dependency: transitive
+    description:
+      name: path_provider_platform_interface
+      sha256: "484838772624c3a4b94f1e44a3e19897fee738f2d5c4ce448443b0417f7c9dda"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.1.3"
+  path_provider_windows:
+    dependency: transitive
+    description:
+      name: path_provider_windows
+      sha256: bd6f00dbd873bfb70d0761682da2b3a2c2fccc2b9e84c495821639601d81afe7
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.3.0"
   permission_handler:
     dependency: "direct main"
     description:
@@ -448,6 +576,62 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.1.8"
+  shared_preferences:
+    dependency: "direct main"
+    description:
+      name: shared_preferences
+      sha256: c3025c5534b01739267eb7d76959bbc25a6d10f6988e1c2a3036940133dd10bf
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.5.5"
+  shared_preferences_android:
+    dependency: transitive
+    description:
+      name: shared_preferences_android
+      sha256: "1e12aafe408aa50da80edfd679a2a6bf63ba7ab37c7fa98286da459a757b3399"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.28"
+  shared_preferences_foundation:
+    dependency: transitive
+    description:
+      name: shared_preferences_foundation
+      sha256: "2ec3934efa51e46117f23031cc141b8fc878e8525b94ec1ea4f7f586cf1b47ea"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.5.7"
+  shared_preferences_linux:
+    dependency: transitive
+    description:
+      name: shared_preferences_linux
+      sha256: "580abfd40f415611503cae30adf626e6656dfb2f0cee8f465ece7b6defb40f2f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
+  shared_preferences_platform_interface:
+    dependency: transitive
+    description:
+      name: shared_preferences_platform_interface
+      sha256: "649dc798a33931919ea356c4305c2d1f81619ea6e92244070b520187b5140ef9"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.2"
+  shared_preferences_web:
+    dependency: transitive
+    description:
+      name: shared_preferences_web
+      sha256: c49bd060261c9a3f0ff445892695d6212ff603ef3115edbb448509d407600019
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.3"
+  shared_preferences_windows:
+    dependency: transitive
+    description:
+      name: shared_preferences_windows
+      sha256: "94ef0f72b2d71bc3e700e025db3710911bd51a71cefb65cc609dd0d9a982e3c1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.4.1"
   sky_engine:
     dependency: transitive
     description: flutter
@@ -517,6 +701,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.4.0"
+  universal_platform:
+    dependency: transitive
+    description:
+      name: universal_platform
+      sha256: "64e16458a0ea9b99260ceb5467a214c1f298d647c659af1bff6d3bf82536b1ec"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.0"
   vector_math:
     dependency: transitive
     description:
@@ -550,7 +742,7 @@ packages:
     source: hosted
     version: "15.2.0"
   web:
-    dependency: transitive
+    dependency: "direct main"
     description:
       name: web
       sha256: "868d88a33d8a87b18ffc05f9f030ba328ffefba92d6c127917a2ba740f9cfe4a"
@@ -573,6 +765,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.0.3"
+  windows_file_picker:
+    dependency: transitive
+    description:
+      name: windows_file_picker
+      sha256: "225f58e64c15c2d7b34fb8faf3ca188831967f26b5a723d7c3a7969e41c9b5a5"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.0"
   xdg_directories:
     dependency: transitive
     description:
@@ -591,4 +791,4 @@ packages:
     version: "6.6.1"
 sdks:
   dart: ">=3.12.2 <4.0.0"
-  flutter: ">=3.41.0"
+  flutter: ">=3.44.0"

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.1.3+4
+version: 1.3.0+7
 
 environment:
   sdk: ^3.12.2
@@ -41,6 +41,7 @@ dependencies:
   nfc_manager: ^4.2.1
   nfc_manager_ndef: ^1.1.0
   http: ^1.1.0
+  shared_preferences: ^2.3.3
 
   # 🔦 주머니 제출 모드 무단 반출 감지용 조도 센서 (Android 전용, iOS는 SensorKit 엔타이틀먼트 필요)
   light: ^5.0.0
@@ -52,6 +53,11 @@ dependencies:
 
   # 📳 무단 반출 감지 시 진동 (백그라운드 서비스에서도 동작하도록 HapticFeedback 대신 사용)
   vibration: ^3.2.0
+  excel: ^4.0.6
+  file_picker: ^12.1.2
+  desktop_drop: ^0.8.3
+  web: ^1.1.1
+  flutter_staggered_grid_view: ^0.7.0
 
 dev_dependencies:
   flutter_test:
@@ -63,11 +69,6 @@ dev_dependencies:
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
   flutter_lints: ^6.0.0
-
-# For information on the generic Dart part of this file, see the
-# following page: https://dart.dev/tools/pub/pubspec
-
-# The following section is specific to Flutter packages.
 flutter:
 
   # The following line ensures that the Material Icons font is

windows/flutter/generated_plugin_registrant.cc

@@ -6,10 +6,13 @@
 
 #include "generated_plugin_registrant.h"
 
+#include <desktop_drop/desktop_drop_plugin.h>
 #include <firebase_core/firebase_core_plugin_c_api.h>
 #include <permission_handler_windows/permission_handler_windows_plugin.h>
 
 void RegisterPlugins(flutter::PluginRegistry* registry) {
+  DesktopDropPluginRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("DesktopDropPlugin"));
   FirebaseCorePluginCApiRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("FirebaseCorePluginCApi"));
   PermissionHandlerWindowsPluginRegisterWithRegistrar(

windows/flutter/generated_plugins.cmake

@@ -3,6 +3,7 @@
 #
 
 list(APPEND FLUTTER_PLUGIN_LIST
+  desktop_drop
   firebase_core
   permission_handler_windows
 )