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

lib/features/masters/group_permission/data/dtos/group_permission_dto.dart

@@ -2,6 +2,7 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../../domain/entities/group_permission.dart';
 
+/// 그룹별 메뉴 권한을 표현하는 DTO.
 class GroupPermissionDto {
   GroupPermissionDto({
     this.id,
@@ -31,6 +32,7 @@ class GroupPermissionDto {
   final DateTime? createdAt;
   final DateTime? updatedAt;
 
+  /// JSON에서 권한 정보를 파싱한다.
   factory GroupPermissionDto.fromJson(Map<String, dynamic> json) {
     return GroupPermissionDto(
       id: json['id'] as int?,
@@ -52,6 +54,7 @@ class GroupPermissionDto {
     );
   }
 
+  /// DTO를 도메인 [GroupPermission] 엔티티로 변환한다.
   GroupPermission toEntity() => GroupPermission(
     id: id,
     group: group.toEntity(),
@@ -67,6 +70,7 @@ class GroupPermissionDto {
     updatedAt: updatedAt,
   );
 
+  /// 페이징 응답을 [PaginatedResult]로 변환한다.
   static PaginatedResult<GroupPermission> parsePaginated(
     Map<String, dynamic>? json,
   ) {
@@ -84,12 +88,14 @@ class GroupPermissionDto {
   }
 }
 
+/// 권한 설정에 포함된 그룹 정보를 담는 DTO.
 class GroupPermissionGroupDto {
   GroupPermissionGroupDto({required this.id, required this.groupName});
 
   final int id;
   final String groupName;
 
+  /// JSON에서 그룹 정보를 파싱한다.
   factory GroupPermissionGroupDto.fromJson(Map<String, dynamic> json) {
     return GroupPermissionGroupDto(
       id: json['id'] as int? ?? json['group_id'] as int,
@@ -98,16 +104,19 @@ class GroupPermissionGroupDto {
     );
   }
 
+  /// DTO를 [GroupPermissionGroup] 엔티티로 변환한다.
   GroupPermissionGroup toEntity() =>
       GroupPermissionGroup(id: id, groupName: groupName);
 }
 
+/// 권한 대상 메뉴 정보를 담는 DTO.
 class GroupPermissionMenuDto {
   GroupPermissionMenuDto({required this.id, required this.menuName});
 
   final int id;
   final String menuName;
 
+  /// JSON에서 메뉴 정보를 파싱한다.
   factory GroupPermissionMenuDto.fromJson(Map<String, dynamic> json) {
     return GroupPermissionMenuDto(
       id: json['id'] as int? ?? json['menu_id'] as int,
@@ -115,10 +124,12 @@ class GroupPermissionMenuDto {
     );
   }
 
+  /// DTO를 [GroupPermissionMenu] 엔티티로 변환한다.
   GroupPermissionMenu toEntity() =>
       GroupPermissionMenu(id: id, menuName: menuName);
 }
 
+/// 문자열/DateTime 값을 파싱해 [DateTime]으로 변환한다.
 DateTime? _parseDate(Object? value) {
   if (value == null) return null;
   if (value is DateTime) return value;

lib/features/masters/group_permission/data/repositories/group_permission_repository_remote.dart

@@ -6,6 +6,7 @@ import '../../domain/entities/group_permission.dart';
 import '../../domain/repositories/group_permission_repository.dart';
 import '../dtos/group_permission_dto.dart';
 
+/// 그룹-메뉴 권한 API를 호출하는 원격 저장소.
 class GroupPermissionRepositoryRemote implements GroupPermissionRepository {
   GroupPermissionRepositoryRemote({required ApiClient apiClient})
     : _api = apiClient;
@@ -14,6 +15,7 @@ class GroupPermissionRepositoryRemote implements GroupPermissionRepository {
 
   static const _basePath = '/group-menu-permissions';
 
+  /// 그룹 권한 목록을 조회한다.
   @override
   Future<PaginatedResult<GroupPermission>> list({
     int page = 1,
@@ -39,6 +41,7 @@ class GroupPermissionRepositoryRemote implements GroupPermissionRepository {
     return GroupPermissionDto.parsePaginated(response.data ?? const {});
   }
 
+  /// 그룹 권한을 생성한다.
   @override
   Future<GroupPermission> create(GroupPermissionInput input) async {
     final response = await _api.post<Map<String, dynamic>>(
@@ -50,6 +53,7 @@ class GroupPermissionRepositoryRemote implements GroupPermissionRepository {
     return GroupPermissionDto.fromJson(data).toEntity();
   }
 
+  /// 그룹 권한을 수정한다.
   @override
   Future<GroupPermission> update(int id, GroupPermissionInput input) async {
     final response = await _api.patch<Map<String, dynamic>>(
@@ -61,11 +65,13 @@ class GroupPermissionRepositoryRemote implements GroupPermissionRepository {
     return GroupPermissionDto.fromJson(data).toEntity();
   }
 
+  /// 그룹 권한을 삭제한다.
   @override
   Future<void> delete(int id) async {
     await _api.delete<void>('$_basePath/$id');
   }
 
+  /// 삭제된 그룹 권한을 복구한다.
   @override
   Future<GroupPermission> restore(int id) async {
     final response = await _api.post<Map<String, dynamic>>(