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

lib/features/masters/customer/presentation/pages/customer_page.dart

@@ -16,6 +16,7 @@ import '../../domain/entities/customer.dart';
 import '../../domain/repositories/customer_repository.dart';
 import '../controllers/customer_controller.dart';
 
+/// 고객 관리 화면. 기능 플래그에 따라 사양 페이지를 보여주거나 실제 목록을 노출한다.
 class CustomerPage extends StatelessWidget {
   const CustomerPage({super.key, required this.routeUri});
 
@@ -86,6 +87,7 @@ class CustomerPage extends StatelessWidget {
   }
 }
 
+/// 고객 관리 기능이 활성화된 경우 사용하는 실제 화면 위젯.
 class _CustomerEnabledPage extends StatefulWidget {
   const _CustomerEnabledPage({required this.routeUri});
 
@@ -95,6 +97,7 @@ class _CustomerEnabledPage extends StatefulWidget {
   State<_CustomerEnabledPage> createState() => _CustomerEnabledPageState();
 }
 
+/// 고객 목록 UI와 라우트 파라미터 싱크를 담당하는 상태 클래스.
 class _CustomerEnabledPageState extends State<_CustomerEnabledPage> {
   late final CustomerController _controller;
   final TextEditingController _searchController = TextEditingController();
@@ -403,6 +406,7 @@ class _CustomerEnabledPageState extends State<_CustomerEnabledPage> {
     GoRouter.of(context).go(newLocation);
   }
 
+  /// URL 파라미터에서 고객 유형 필터 값을 파싱한다.
   CustomerTypeFilter _typeFromParam(String? value) {
     switch (value) {
       case 'partner':
@@ -414,6 +418,7 @@ class _CustomerEnabledPageState extends State<_CustomerEnabledPage> {
     }
   }
 
+  /// 고객 유형 필터를 URL 파라미터 문자열로 변환한다.
   String? _encodeType(CustomerTypeFilter filter) {
     switch (filter) {
       case CustomerTypeFilter.all:
@@ -425,6 +430,7 @@ class _CustomerEnabledPageState extends State<_CustomerEnabledPage> {
     }
   }
 
+  /// URL 파라미터에서 고객 활성 상태를 파싱한다.
   CustomerStatusFilter _statusFromParam(String? value) {
     switch (value) {
       case 'active':
@@ -436,6 +442,7 @@ class _CustomerEnabledPageState extends State<_CustomerEnabledPage> {
     }
   }
 
+  /// 고객 상태 필터를 URL 파라미터 문자열로 변환한다.
   String? _encodeStatus(CustomerStatusFilter filter) {
     switch (filter) {
       case CustomerStatusFilter.all: