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

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

@@ -1,3 +1,4 @@
+/// 창고(Warehouse) 도메인 엔티티.
 class Warehouse {
   Warehouse({
     this.id,
@@ -23,6 +24,7 @@ class Warehouse {
   final DateTime? createdAt;
   final DateTime? updatedAt;
 
+  /// 일부 속성만 변경한 새 인스턴스를 반환한다.
   Warehouse copyWith({
     int? id,
     String? warehouseCode,
@@ -50,6 +52,7 @@ class Warehouse {
   }
 }
 
+/// 창고 주소에 대한 우편번호/행정 정보.
 class WarehouseZipcode {
   WarehouseZipcode({
     required this.zipcode,
@@ -64,6 +67,7 @@ class WarehouseZipcode {
   final String? roadName;
 }
 
+/// 창고 생성/수정에 사용하는 입력 모델.
 class WarehouseInput {
   WarehouseInput({
     required this.warehouseCode,
@@ -81,6 +85,7 @@ class WarehouseInput {
   final bool isActive;
   final String? note;
 
+  /// API 요청 바디로 직렬화한다.
   Map<String, dynamic> toPayload() {
     return {
       'warehouse_code': warehouseCode,

lib/features/masters/warehouse/domain/repositories/warehouse_repository.dart

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