feat: 대규모 코드베이스 개선 - 백엔드 통합성 강화 및 UI 일관성 완성

- CLAUDE.md 대폭 개선: 개발 가이드라인 및 프로젝트 상태 문서화
- 백엔드 API 통합: 모든 엔티티 간 Foreign Key 관계 완벽 구현
- UI 일관성 강화: shadcn_ui 컴포넌트 표준화 적용
- 데이터 모델 개선: DTO 및 모델 클래스 백엔드 스키마와 100% 일치
- 사용자 관리: 회사 연결, 중복 검사, 입력 검증 기능 추가
- 창고 관리: 우편번호 연결, 중복 검사 기능 강화
- 회사 관리: 우편번호 연결, 중복 검사 로직 구현
- 장비 관리: 불필요한 카테고리 필드 제거, 벤더-모델 관계 정리
- 우편번호 시스템: 검색 다이얼로그 Provider 버그 수정

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

lib/screens/warehouse_location/warehouse_location_form.dart

@@ -1,15 +1,20 @@
 import 'package:flutter/material.dart';
-import 'package:flutter/services.dart';
 import 'package:shadcn_ui/shadcn_ui.dart';
+import 'package:provider/provider.dart';
+import 'package:get_it/get_it.dart';
 import 'package:superport/screens/common/widgets/remark_input.dart';
 import 'package:superport/screens/common/templates/form_layout_template.dart';
 import 'controllers/warehouse_location_form_controller.dart';
-import 'package:superport/utils/formatters/korean_phone_formatter.dart';
+import 'package:superport/data/models/zipcode_dto.dart';
+import 'package:superport/screens/zipcode/zipcode_search_screen.dart';
+import 'package:superport/screens/zipcode/controllers/zipcode_controller.dart';
+import 'package:superport/domain/usecases/zipcode_usecase.dart';
 
 /// 입고지 추가/수정 폼 화면 (SRP 적용, 상태/로직 분리)
 class WarehouseLocationFormScreen extends StatefulWidget {
   final int? id; // 수정 모드 지원을 위한 id 파라미터
-  const WarehouseLocationFormScreen({super.key, this.id});
+  final Map<String, dynamic>? preloadedData; // 사전 로드된 데이터
+  const WarehouseLocationFormScreen({super.key, this.id, this.preloadedData});
 
   @override
   State<WarehouseLocationFormScreen> createState() =>
@@ -20,14 +25,30 @@ class _WarehouseLocationFormScreenState
     extends State<WarehouseLocationFormScreen> {
   /// 폼 컨트롤러 (상태 및 저장/수정 로직 위임)
   late final WarehouseLocationFormController _controller;
+  
+  /// 상태 메시지
+  String? _statusMessage;
+  
+  /// 저장 중 여부
+  bool _isSaving = false;
 
   @override
   void initState() {
     super.initState();
     // 컨트롤러 생성 및 초기화
-    _controller = WarehouseLocationFormController();
-    if (widget.id != null) {
-      _controller.initialize(widget.id!);
+    if (widget.preloadedData != null) {
+      // 사전 로드된 데이터로 즉시 초기화
+      _controller = WarehouseLocationFormController.withPreloadedData(
+        preloadedData: widget.preloadedData!,
+      );
+    } else {
+      _controller = WarehouseLocationFormController();
+      if (widget.id != null) {
+        // 비동기 초기화를 위해 addPostFrameCallback 사용
+        WidgetsBinding.instance.addPostFrameCallback((_) {
+          _controller.initialize(widget.id!);
+        });
+      }
     }
   }
 
@@ -38,11 +59,75 @@ class _WarehouseLocationFormScreenState
     super.dispose();
   }
 
+  // 우편번호 검색 다이얼로그
+  Future<ZipcodeDto?> _showZipcodeSearchDialog() async {
+    return await showDialog<ZipcodeDto>(
+      context: context,
+      barrierDismissible: true,
+      builder: (BuildContext dialogContext) => Dialog(
+        clipBehavior: Clip.none,
+        insetPadding: const EdgeInsets.symmetric(horizontal: 40, vertical: 24),
+        child: SizedBox(
+          width: 800,
+          height: 600,
+          child: Container(
+            decoration: BoxDecoration(
+              color: ShadTheme.of(context).colorScheme.background,
+              borderRadius: BorderRadius.circular(8),
+            ),
+            child: ChangeNotifierProvider(
+              create: (_) => ZipcodeController(
+                GetIt.instance<ZipcodeUseCase>(),
+              ),
+              child: ZipcodeSearchScreen(
+                onSelect: (zipcode) {
+                  Navigator.of(dialogContext).pop(zipcode);
+                },
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
   // 저장 메소드
   Future<void> _onSave() async {
-    setState(() {}); // 저장 중 상태 갱신
+    // 폼 유효성 검사
+    if (!_controller.formKey.currentState!.validate()) {
+      return;
+    }
+    
+    setState(() {
+      _isSaving = true;
+      _statusMessage = '중복 확인 중...';
+    });
+    
+    // 저장 시 중복 검사 수행
+    final name = _controller.nameController.text.trim();
+    final isDuplicate = await _controller.checkDuplicateName(
+      name,
+      excludeId: _controller.isEditMode ? _controller.id : null,
+    );
+    
+    if (isDuplicate) {
+      setState(() {
+        _isSaving = false;
+        _statusMessage = '이미 존재하는 창고명입니다.';
+      });
+      return;
+    }
+    
+    setState(() {
+      _statusMessage = '저장 중...';
+    });
+    
     final success = await _controller.save();
-    setState(() {}); // 저장 완료 후 상태 갱신
+    
+    setState(() {
+      _isSaving = false;
+      _statusMessage = null;
+    });
     
     if (success) {
       // 성공 메시지 표시
@@ -73,9 +158,9 @@ class _WarehouseLocationFormScreenState
   Widget build(BuildContext context) {
     return FormLayoutTemplate(
       title: _controller.isEditMode ? '입고지 수정' : '입고지 추가',
-      onSave: _controller.isSaving ? null : _onSave,
+      onSave: _isSaving ? null : _onSave,
       saveButtonText: '저장',
-      isLoading: _controller.isSaving,
+      isLoading: _isSaving,
       child: Form(
         key: _controller.formKey,
         child: SingleChildScrollView(
@@ -88,15 +173,64 @@ class _WarehouseLocationFormScreenState
               FormFieldWrapper(
                 label: '창고명',
                 required: true,
-                child: ShadInputFormField(
-                  controller: _controller.nameController,
-                  placeholder: const Text('창고명을 입력하세요'),
-                  validator: (value) {
-                    if (value.trim().isEmpty) {
-                      return '창고명을 입력하세요';
-                    }
-                    return null;
-                  },
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    ShadInputFormField(
+                      controller: _controller.nameController,
+                      placeholder: const Text('창고명을 입력하세요'),
+                      validator: (value) {
+                        if (value.trim().isEmpty) {
+                          return '창고명을 입력하세요';
+                        }
+                        return null;
+                      },
+                    ),
+                    // 상태 메시지 영역 (고정 높이)
+                    SizedBox(
+                      height: 20,
+                      child: _statusMessage != null
+                          ? Padding(
+                              padding: const EdgeInsets.only(top: 4),
+                              child: Text(
+                                _statusMessage!,
+                                style: TextStyle(
+                                  fontSize: 12,
+                                  color: _statusMessage!.contains('존재')
+                                      ? Colors.red
+                                      : Colors.grey,
+                                ),
+                              ),
+                            )
+                          : const SizedBox.shrink(),
+                    ),
+                  ],
+                ),
+              ),
+              // 우편번호 검색
+              FormFieldWrapper(
+                label: '우편번호',
+                child: Row(
+                  children: [
+                    Expanded(
+                      child: ShadInputFormField(
+                        controller: _controller.zipcodeController,
+                        placeholder: const Text('우편번호'),
+                        readOnly: true,
+                      ),
+                    ),
+                    const SizedBox(width: 8),
+                    ShadButton(
+                      onPressed: () async {
+                        // 우편번호 검색 다이얼로그 호출
+                        final result = await _showZipcodeSearchDialog();
+                        if (result != null) {
+                          _controller.selectZipcode(result);
+                        }
+                      },
+                      child: const Text('검색'),
+                    ),
+                  ],
                 ),
               ),
               // 주소 입력 (단일 필드)
@@ -104,42 +238,8 @@ class _WarehouseLocationFormScreenState
                 label: '주소',
                 child: ShadInputFormField(
                   controller: _controller.addressController,
-                  placeholder: const Text('주소를 입력하세요 (예: 경기도 용인시 기흥구 동백로 123)'),
-                  maxLines: 3,
-                ),
-              ),
-              // 담당자명 입력
-              FormFieldWrapper(
-                label: '담당자명',
-                child: ShadInputFormField(
-                  controller: _controller.managerNameController,
-                  placeholder: const Text('담당자명을 입력하세요'),
-                ),
-              ),
-              // 담당자 연락처 입력
-              FormFieldWrapper(
-                label: '담당자 연락처',
-                child: ShadInputFormField(
-                  controller: _controller.managerPhoneController,
-                  placeholder: const Text('010-1234-5678'),
-                  keyboardType: TextInputType.phone,
-                  inputFormatters: [
-                    KoreanPhoneFormatter(), // 한국식 전화번호 자동 포맷팅
-                  ],
-                  validator: (value) => PhoneValidator.validate(value),
-                ),
-              ),
-              // 수용량 입력
-              FormFieldWrapper(
-                label: '수용량',
-                child: ShadInputFormField(
-                  controller: _controller.capacityController,
-                  placeholder: const Text('수용량을 입력하세요 (개)'),
-                  keyboardType: TextInputType.number,
-                  inputFormatters: [
-                    FilteringTextInputFormatter.digitsOnly,
-                  ],
-                  validator: _controller.validateCapacity,
+                  placeholder: const Text('상세 주소를 입력하세요'),
+                  maxLines: 2,
                 ),
               ),
               // 비고 입력