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

lib/features/masters/customer/domain/entities/customer.dart

@@ -1,3 +1,4 @@
+/// 고객(Customer) 도메인 엔티티.
 class Customer {
   Customer({
     this.id,
@@ -31,6 +32,7 @@ class Customer {
   final DateTime? createdAt;
   final DateTime? updatedAt;
 
+  /// 선택한 속성만 변경한 새 인스턴스를 반환한다.
   Customer copyWith({
     int? id,
     String? customerCode,
@@ -66,6 +68,7 @@ class Customer {
   }
 }
 
+/// 고객 주소의 우편번호/행정구역 정보를 표현한다.
 class CustomerZipcode {
   CustomerZipcode({
     required this.zipcode,
@@ -80,6 +83,7 @@ class CustomerZipcode {
   final String? roadName;
 }
 
+/// 고객 생성/수정 시 사용하는 입력 모델.
 class CustomerInput {
   CustomerInput({
     required this.customerCode,
@@ -105,6 +109,7 @@ class CustomerInput {
   final bool isActive;
   final String? note;
 
+  /// API 요청 바디에 사용하기 위한 맵으로 직렬화한다.
   Map<String, dynamic> toPayload() {
     return {
       'customer_code': customerCode,

lib/features/masters/customer/domain/repositories/customer_repository.dart

@@ -2,7 +2,9 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 
 import '../entities/customer.dart';
 
+/// 고객 데이터를 다루는 도메인 저장소 인터페이스.
 abstract class CustomerRepository {
+  /// 고객 목록을 조회한다.
   Future<PaginatedResult<Customer>> list({
     int page = 1,
     int pageSize = 20,
@@ -12,11 +14,15 @@ abstract class CustomerRepository {
     bool? isActive,
   });
 
+  /// 고객을 생성한다.
   Future<Customer> create(CustomerInput input);
 
+  /// 고객을 수정한다.
   Future<Customer> update(int id, CustomerInput input);
 
+  /// 고객을 삭제한다.
   Future<void> delete(int id);
 
+  /// 삭제된 고객을 복구한다.
   Future<Customer> restore(int id);
 }