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

lib/features/approvals/domain/repositories/approval_repository.dart

@@ -2,7 +2,11 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../entities/approval.dart';
 
+/// 결재 도메인에서 사용하는 저장소 인터페이스.
+///
+/// - presentation 레이어는 이 인터페이스만 의존하며, 실제 구현은 data 레이어가 담당한다.
 abstract class ApprovalRepository {
+  /// 결재 목록을 조회한다. 필터/페이지 조건을 지원한다.
   Future<PaginatedResult<Approval>> list({
     int page = 1,
     int pageSize = 20,
@@ -14,6 +18,7 @@ abstract class ApprovalRepository {
     bool includeSteps = false,
   });
 
+  /// 결재 상세 정보를 조회한다.
   Future<Approval> fetchDetail(
     int id, {
     bool includeSteps = true,
@@ -29,11 +34,15 @@ abstract class ApprovalRepository {
   /// 결재 단계 일괄 생성/재배치
   Future<Approval> assignSteps(ApprovalStepAssignmentInput input);
 
+  /// 결재를 생성한다.
   Future<Approval> create(ApprovalInput input);
 
+  /// 결재를 수정한다.
   Future<Approval> update(int id, ApprovalInput input);
 
+  /// 결재를 삭제한다.
   Future<void> delete(int id);
 
+  /// 삭제된 결재를 복구한다.
   Future<Approval> restore(int id);
 }

lib/features/approvals/domain/repositories/approval_template_repository.dart

@@ -2,7 +2,9 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../entities/approval_template.dart';
 
+/// 결재 템플릿 도메인 저장소 인터페이스.
 abstract class ApprovalTemplateRepository {
+  /// 템플릿 목록을 조회한다.
   Future<PaginatedResult<ApprovalTemplate>> list({
     int page = 1,
     int pageSize = 20,
@@ -10,20 +12,25 @@ abstract class ApprovalTemplateRepository {
     bool? isActive,
   });
 
+  /// 템플릿 상세를 조회한다.
   Future<ApprovalTemplate> fetchDetail(int id, {bool includeSteps = true});
 
+  /// 템플릿을 생성한다. 단계 입력은 옵션이다.
   Future<ApprovalTemplate> create(
     ApprovalTemplateInput input, {
     List<ApprovalTemplateStepInput> steps = const [],
   });
 
+  /// 템플릿 기본 정보와 단계 구성을 수정한다.
   Future<ApprovalTemplate> update(
     int id,
     ApprovalTemplateInput input, {
     List<ApprovalTemplateStepInput>? steps,
   });
 
+  /// 템플릿을 삭제한다.
   Future<void> delete(int id);
 
+  /// 삭제된 템플릿을 복구한다.
   Future<ApprovalTemplate> restore(int id);
 }