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

lib/features/approvals/history/data/dtos/approval_history_record_dto.dart

@@ -5,6 +5,7 @@ import 'package:superport_v2/features/approvals/domain/entities/approval.dart';
 
 import '../../domain/entities/approval_history_record.dart';
 
+/// 결재 이력(History) API 응답을 표현하는 DTO.
 class ApprovalHistoryRecordDto {
   ApprovalHistoryRecordDto({
     required this.id,
@@ -30,6 +31,7 @@ class ApprovalHistoryRecordDto {
   final DateTime actionAt;
   final String? note;
 
+  /// 원본 JSON에서 필드를 파싱해 DTO를 생성한다.
   factory ApprovalHistoryRecordDto.fromJson(Map<String, dynamic> json) {
     final approvalData = json['approval'] as Map<String, dynamic>?;
     final id = json['id'] as int? ?? 0;
@@ -74,6 +76,7 @@ class ApprovalHistoryRecordDto {
     );
   }
 
+  /// DTO를 도메인 [ApprovalHistoryRecord] 엔티티로 변환한다.
   ApprovalHistoryRecord toEntity() {
     return ApprovalHistoryRecord(
       id: id,
@@ -89,6 +92,7 @@ class ApprovalHistoryRecordDto {
     );
   }
 
+  /// 페이징 응답을 읽어 [PaginatedResult] 형태로 변환한다.
   static PaginatedResult<ApprovalHistoryRecord> parsePaginated(
     Map<String, dynamic>? json,
   ) {
@@ -107,6 +111,7 @@ class ApprovalHistoryRecordDto {
   }
 }
 
+/// 다양한 형식으로 전달될 수 있는 날짜 값을 파싱한다.
 DateTime? _parseDate(Object? value) {
   if (value == null) return null;
   if (value is DateTime) return value;

lib/features/approvals/history/data/repositories/approval_history_repository_remote.dart

@@ -6,6 +6,7 @@ import '../../domain/entities/approval_history_record.dart';
 import '../../domain/repositories/approval_history_repository.dart';
 import '../dtos/approval_history_record_dto.dart';
 
+/// 결재 이력 API를 호출하는 원격 저장소 구현체.
 class ApprovalHistoryRepositoryRemote implements ApprovalHistoryRepository {
   ApprovalHistoryRepositoryRemote({required ApiClient apiClient})
     : _api = apiClient;
@@ -14,6 +15,7 @@ class ApprovalHistoryRepositoryRemote implements ApprovalHistoryRepository {
 
   static const _basePath = '/approval-histories';
 
+  /// 결재 이력 목록을 조회한다.
   @override
   Future<PaginatedResult<ApprovalHistoryRecord>> list({
     int page = 1,

lib/features/approvals/history/domain/repositories/approval_history_repository.dart

@@ -2,7 +2,9 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../entities/approval_history_record.dart';
 
+/// 결재 이력 데이터를 조회하는 도메인 저장소 인터페이스.
 abstract class ApprovalHistoryRepository {
+  /// 이력 목록을 조회한다.
   Future<PaginatedResult<ApprovalHistoryRecord>> list({
     int page = 1,
     int pageSize = 20,