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

lib/features/masters/warehouse/presentation/controllers/warehouse_controller.dart

@@ -4,8 +4,10 @@ import 'package:superport_v2/core/common/models/paginated_result.dart';
 import '../../domain/entities/warehouse.dart';
 import '../../domain/repositories/warehouse_repository.dart';
 
+/// 창고 사용 여부 필터.
 enum WarehouseStatusFilter { all, activeOnly, inactiveOnly }
 
+/// 창고 마스터 화면 상태를 관리하는 컨트롤러.
 class WarehouseController extends ChangeNotifier {
   static const int defaultPageSize = 20;
 
@@ -30,6 +32,7 @@ class WarehouseController extends ChangeNotifier {
   int get pageSize => _pageSize;
   String? get errorMessage => _errorMessage;
 
+  /// 창고 목록을 조회한다.
   Future<void> fetch({int page = 1}) async {
     _isLoading = true;
     _errorMessage = null;
@@ -58,6 +61,7 @@ class WarehouseController extends ChangeNotifier {
     }
   }
 
+  /// 검색어를 변경한다.
   void updateQuery(String value) {
     if (_query == value) {
       return;
@@ -66,6 +70,7 @@ class WarehouseController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 사용 여부 필터를 변경한다.
   void updateStatusFilter(WarehouseStatusFilter filter) {
     if (_statusFilter == filter) {
       return;
@@ -74,6 +79,7 @@ class WarehouseController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 페이지 크기를 변경한다.
   void updatePageSize(int size) {
     if (size <= 0 || _pageSize == size) {
       return;
@@ -82,6 +88,7 @@ class WarehouseController extends ChangeNotifier {
     notifyListeners();
   }
 
+  /// 창고를 생성한다.
   Future<Warehouse?> create(WarehouseInput input) async {
     _setSubmitting(true);
     try {
@@ -97,6 +104,7 @@ class WarehouseController extends ChangeNotifier {
     }
   }
 
+  /// 창고 정보를 수정한다.
   Future<Warehouse?> update(int id, WarehouseInput input) async {
     _setSubmitting(true);
     try {
@@ -112,6 +120,7 @@ class WarehouseController extends ChangeNotifier {
     }
   }
 
+  /// 창고를 삭제한다.
   Future<bool> delete(int id) async {
     _setSubmitting(true);
     try {
@@ -127,6 +136,7 @@ class WarehouseController extends ChangeNotifier {
     }
   }
 
+  /// 삭제된 창고를 복구한다.
   Future<Warehouse?> restore(int id) async {
     _setSubmitting(true);
     try {
@@ -142,11 +152,13 @@ class WarehouseController extends ChangeNotifier {
     }
   }
 
+  /// 에러 메시지를 초기화한다.
   void clearError() {
     _errorMessage = null;
     notifyListeners();
   }
 
+  /// 제출 상태 플래그를 갱신하고 리스너에 알린다.
   void _setSubmitting(bool value) {
     _isSubmitting = value;
     notifyListeners();

lib/features/masters/warehouse/presentation/pages/warehouse_page.dart

@@ -17,6 +17,7 @@ import '../../domain/entities/warehouse.dart';
 import '../../domain/repositories/warehouse_repository.dart';
 import '../controllers/warehouse_controller.dart';
 
+/// 창고 관리 페이지. 기능 플래그에 따라 사양/실제 화면을 전환한다.
 class WarehousePage extends StatelessWidget {
   const WarehousePage({super.key, required this.routeUri});
 
@@ -81,6 +82,7 @@ class WarehousePage extends StatelessWidget {
   }
 }
 
+/// 창고 기능이 활성화된 경우 사용하는 실제 화면 위젯.
 class _WarehouseEnabledPage extends StatefulWidget {
   const _WarehouseEnabledPage({required this.routeUri});
 
@@ -90,6 +92,7 @@ class _WarehouseEnabledPage extends StatefulWidget {
   State<_WarehouseEnabledPage> createState() => _WarehouseEnabledPageState();
 }
 
+/// 창고 목록과 필터 상태를 관리하는 상태 클래스.
 class _WarehouseEnabledPageState extends State<_WarehouseEnabledPage> {
   late final WarehouseController _controller;
   final TextEditingController _searchController = TextEditingController();