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

lib/features/masters/customer/presentation/controllers/customer_controller.dart

@@ -4,10 +4,13 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 import '../../domain/entities/customer.dart';
 import '../../domain/repositories/customer_repository.dart';
 
+/// 고객 유형 필터 옵션.
 enum CustomerTypeFilter { all, partner, general }
 
+/// 고객 활성 상태 필터 옵션.
 enum CustomerStatusFilter { all, activeOnly, inactiveOnly }
 
+/// 고객 목록 조회/등록/수정을 담당하는 프레젠테이션 컨트롤러.
 class CustomerController extends ChangeNotifier {
   static const int defaultPageSize = 20;
 
@@ -34,6 +37,7 @@ class CustomerController extends ChangeNotifier {
   int get pageSize => _pageSize;
   String? get errorMessage => _errorMessage;
 
+  /// 고객 목록을 조회한다. 필터/페이지 상태는 내부에서 유지된다.
   Future<void> fetch({int page = 1}) async {
     _isLoading = true;
     _errorMessage = null;
@@ -82,6 +86,7 @@ class CustomerController extends ChangeNotifier {
     }
   }
 
+  /// 검색어를 변경한다.
   void updateQuery(String value) {
     if (_query == value) {
       return;
@@ -90,6 +95,7 @@ class CustomerController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 고객 유형 필터를 변경한다.
   void updateTypeFilter(CustomerTypeFilter filter) {
     if (_typeFilter == filter) {
       return;
@@ -98,6 +104,7 @@ class CustomerController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 고객 활성 상태 필터를 변경한다.
   void updateStatusFilter(CustomerStatusFilter filter) {
     if (_statusFilter == filter) {
       return;
@@ -106,6 +113,7 @@ class CustomerController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 페이지 크기를 변경한다.
   void updatePageSize(int size) {
     if (size <= 0 || _pageSize == size) {
       return;
@@ -114,6 +122,7 @@ class CustomerController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 신규 고객을 생성한다.
   Future<Customer?> create(CustomerInput input) async {
     _setSubmitting(true);
     try {
@@ -129,6 +138,7 @@ class CustomerController extends ChangeNotifier {
     }
   }
 
+  /// 기존 고객을 수정한다.
   Future<Customer?> update(int id, CustomerInput input) async {
     _setSubmitting(true);
     try {
@@ -144,6 +154,7 @@ class CustomerController extends ChangeNotifier {
     }
   }
 
+  /// 고객을 삭제한다.
   Future<bool> delete(int id) async {
     _setSubmitting(true);
     try {
@@ -159,6 +170,7 @@ class CustomerController extends ChangeNotifier {
     }
   }
 
+  /// 삭제된 고객을 복구한다.
   Future<Customer?> restore(int id) async {
     _setSubmitting(true);
     try {
@@ -174,6 +186,7 @@ class CustomerController extends ChangeNotifier {
     }
   }
 
+  /// 에러 메시지를 초기화한다.
   void clearError() {
     _errorMessage = null;
     notifyListeners();