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

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;