주석화 진행상황 정리하고 핵심 모듈에 한글 주석 추가

lib/features/masters/group_permission/presentation/controllers/group_permission_controller.dart

@@ -8,6 +8,7 @@ import '../../../menu/domain/repositories/menu_repository.dart';
 import '../../domain/entities/group_permission.dart';
 import '../../domain/repositories/group_permission_repository.dart';
 
+/// 그룹 권한 활성 여부 필터.
 enum GroupPermissionStatusFilter { all, activeOnly, inactiveOnly }
 
 /// 그룹-메뉴 권한 화면용 컨트롤러
@@ -53,6 +54,7 @@ class GroupPermissionController extends ChangeNotifier {
   List<Group> get groups => List.unmodifiable(_groups);
   List<MenuItem> get menus => List.unmodifiable(_menus);
 
+  /// 그룹 목록을 로드해 권한 연결 시 선택할 수 있도록 준비한다.
   Future<void> loadGroups() async {
     _isLoadingGroups = true;
     notifyListeners();
@@ -69,6 +71,7 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 메뉴 목록을 로드해 권한 연결 시 선택할 수 있도록 준비한다.
   Future<void> loadMenus() async {
     _isLoadingMenus = true;
     notifyListeners();
@@ -89,6 +92,7 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 그룹 권한 목록을 조회한다.
   Future<void> fetch({int page = 1}) async {
     _isLoading = true;
     _errorMessage = null;
@@ -116,26 +120,31 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 그룹 필터를 변경한다.
   void updateGroupFilter(int? groupId) {
     _groupFilter = groupId;
     notifyListeners();
   }
 
+  /// 메뉴 필터를 변경한다.
   void updateMenuFilter(int? menuId) {
     _menuFilter = menuId;
     notifyListeners();
   }
 
+  /// 권한 활성 상태 필터를 변경한다.
   void updateStatusFilter(GroupPermissionStatusFilter filter) {
     _statusFilter = filter;
     notifyListeners();
   }
 
+  /// 삭제 포함 여부를 변경한다.
   void updateIncludeDeleted(bool value) {
     _includeDeleted = value;
     notifyListeners();
   }
 
+  /// 그룹 권한을 생성한다.
   Future<GroupPermission?> create(GroupPermissionInput input) async {
     _setSubmitting(true);
     try {
@@ -151,6 +160,7 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 그룹 권한을 수정한다.
   Future<GroupPermission?> update(int id, GroupPermissionInput input) async {
     _setSubmitting(true);
     try {
@@ -166,6 +176,7 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 그룹 권한을 삭제한다.
   Future<bool> delete(int id) async {
     _setSubmitting(true);
     try {
@@ -181,6 +192,7 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 삭제된 그룹 권한을 복구한다.
   Future<GroupPermission?> restore(int id) async {
     _setSubmitting(true);
     try {
@@ -196,11 +208,13 @@ class GroupPermissionController extends ChangeNotifier {
     }
   }
 
+  /// 에러 메시지를 초기화한다.
   void clearError() {
     _errorMessage = null;
     notifyListeners();
   }
 
+  /// 제출 상태 플래그를 갱신하고 리스너에게 알린다.
   void _setSubmitting(bool value) {
     _isSubmitting = value;
     notifyListeners();

lib/features/masters/group_permission/presentation/pages/group_permission_page.dart

@@ -18,6 +18,7 @@ import '../../domain/entities/group_permission.dart';
 import '../../domain/repositories/group_permission_repository.dart';
 import '../controllers/group_permission_controller.dart';
 
+/// 그룹-메뉴 권한 설정 페이지. 기능 플래그에 따라 사양/실제 화면을 전환한다.
 class GroupPermissionPage extends StatelessWidget {
   const GroupPermissionPage({super.key});
 
@@ -99,6 +100,7 @@ class GroupPermissionPage extends StatelessWidget {
   }
 }
 
+/// 그룹 권한 기능이 활성화된 경우 사용하는 실제 화면 위젯.
 class _GroupPermissionEnabledPage extends StatefulWidget {
   const _GroupPermissionEnabledPage();
 
@@ -107,6 +109,7 @@ class _GroupPermissionEnabledPage extends StatefulWidget {
       _GroupPermissionEnabledPageState();
 }
 
+/// 그룹 권한 목록/필터/폼 상태를 관리하는 상태 클래스.
 class _GroupPermissionEnabledPageState
     extends State<_GroupPermissionEnabledPage> {
   late final GroupPermissionController _controller;