refactor: Repository 패턴 적용 및 Clean Architecture 완성

## 주요 변경사항

### 🏗️ Architecture
- Repository 패턴 전면 도입 (인터페이스/구현체 분리)
- Domain Layer에 Repository 인터페이스 정의
- Data Layer에 Repository 구현체 배치
- UseCase 의존성을 Service에서 Repository로 전환

### 📦 Dependency Injection
- GetIt 기반 DI Container 재구성 (lib/injection_container.dart)
- Repository 인터페이스와 구현체 등록
- Service와 Repository 공존 (마이그레이션 기간)

### 🔄 Migration Status
완료:
- License 모듈 (6개 UseCase)
- Warehouse Location 모듈 (5개 UseCase)

진행중:
- Auth 모듈 (2/5 UseCase)
- Company 모듈 (1/6 UseCase)

대기:
- User 모듈 (7개 UseCase)
- Equipment 모듈 (4개 UseCase)

### 🎯 Controller 통합
- 중복 Controller 제거 (with_usecase 버전)
- 단일 Controller로 통합
- UseCase 패턴 직접 적용

### 🧹 코드 정리
- 임시 파일 제거 (test_*.md, task.md)
- Node.js 아티팩트 제거 (package.json)
- 불필요한 테스트 파일 정리

### ✅ 테스트 개선
- Real API 중심 테스트 구조
- Mock 제거, 실제 API 엔드포인트 사용
- 통합 테스트 프레임워크 강화

## 기술적 영향
- 의존성 역전 원칙 적용
- 레이어 간 결합도 감소
- 테스트 용이성 향상
- 확장성 및 유지보수성 개선

## 다음 단계
1. User/Equipment 모듈 Repository 마이그레이션
2. Service Layer 점진적 제거
3. 캐싱 전략 구현
4. 성능 최적화

lib/domain/repositories/auth_repository.dart

@@ -0,0 +1,51 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../data/models/auth/auth_user.dart';
+import '../../data/models/auth/login_request.dart';
+import '../../data/models/auth/login_response.dart';
+import '../../data/models/auth/token_response.dart';
+import '../../data/models/auth/refresh_token_request.dart';
+
+/// 인증 Repository 인터페이스
+/// 사용자 로그인, 로그아웃, 토큰 관리 등 인증 관련 기능을 담당
+abstract class AuthRepository {
+  /// 사용자 로그인
+  /// [loginRequest] 로그인 요청 데이터 (사용자명, 비밀번호)
+  /// Returns: 로그인 응답 (토큰, 사용자 정보)
+  Future<Either<Failure, LoginResponse>> login(LoginRequest loginRequest);
+
+  /// 사용자 로그아웃
+  /// 서버에 로그아웃 요청을 보내고 세션을 종료
+  /// Returns: 로그아웃 성공/실패 여부
+  Future<Either<Failure, void>> logout();
+
+  /// 액세스 토큰 갱신
+  /// [refreshRequest] 리프레시 토큰 요청 데이터
+  /// Returns: 새로운 토큰 정보
+  Future<Either<Failure, TokenResponse>> refreshToken(RefreshTokenRequest refreshRequest);
+
+  /// 현재 인증된 사용자 정보 조회
+  /// Returns: 현재 사용자 정보
+  Future<Either<Failure, AuthUser>> getCurrentUser();
+
+  /// 인증 상태 확인
+  /// 현재 사용자가 인증되어 있는지 확인
+  /// Returns: 인증 여부 (true: 인증됨, false: 미인증)
+  Future<Either<Failure, bool>> isAuthenticated();
+
+  /// 비밀번호 변경
+  /// [currentPassword] 현재 비밀번호
+  /// [newPassword] 새 비밀번호
+  /// Returns: 비밀번호 변경 성공/실패 여부
+  Future<Either<Failure, void>> changePassword(String currentPassword, String newPassword);
+
+  /// 비밀번호 재설정 요청
+  /// [email] 비밀번호 재설정을 요청할 이메일 주소
+  /// Returns: 비밀번호 재설정 요청 성공/실패 여부
+  Future<Either<Failure, void>> requestPasswordReset(String email);
+
+  /// 세션 유효성 검증
+  /// 현재 저장된 토큰이 유효한지 서버에서 검증
+  /// Returns: 세션 유효성 여부
+  Future<Either<Failure, bool>> validateSession();
+}

lib/domain/repositories/company_repository.dart

@@ -0,0 +1,96 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../models/company_model.dart';
+import '../../data/models/common/paginated_response.dart';
+
+/// 회사 관리 Repository 인터페이스
+/// 회사 및 지점 정보 관리를 위한 CRUD 기능을 담당
+abstract class CompanyRepository {
+  /// 회사 목록 조회
+  /// [page] 페이지 번호 (기본값: 1)
+  /// [limit] 페이지당 항목 수 (기본값: 20)
+  /// [search] 검색어 (회사명, 담당자명 등)
+  /// [companyType] 회사 유형 필터 (고객사, 파트너사)
+  /// [sortBy] 정렬 기준 ('name', 'createdAt' 등)
+  /// [sortOrder] 정렬 순서 ('asc', 'desc')
+  /// Returns: 페이지네이션된 회사 목록
+  Future<Either<Failure, PaginatedResponse<Company>>> getCompanies({
+    int? page,
+    int? limit,
+    String? search,
+    CompanyType? companyType,
+    String? sortBy,
+    String? sortOrder,
+  });
+
+  /// 회사 상세 정보 조회
+  /// [id] 회사 고유 식별자
+  /// Returns: 지점 정보를 포함한 회사 상세 정보
+  Future<Either<Failure, Company>> getCompanyById(int id);
+
+  /// 회사 생성
+  /// [company] 생성할 회사 정보
+  /// Returns: 생성된 회사 정보 (ID 포함)
+  Future<Either<Failure, Company>> createCompany(Company company);
+
+  /// 회사 정보 수정
+  /// [id] 수정할 회사 고유 식별자
+  /// [company] 수정할 회사 정보
+  /// Returns: 수정된 회사 정보
+  Future<Either<Failure, Company>> updateCompany(int id, Company company);
+
+  /// 회사 삭제
+  /// [id] 삭제할 회사 고유 식별자
+  /// Returns: 삭제 성공/실패 여부
+  Future<Either<Failure, void>> deleteCompany(int id);
+
+  /// 회사 상태 토글 (활성화/비활성화)
+  /// [id] 상태를 변경할 회사 고유 식별자
+  /// Returns: 상태 변경된 회사 정보
+  Future<Either<Failure, Company>> toggleCompanyStatus(int id);
+
+  /// 지점 생성
+  /// [companyId] 지점을 추가할 회사 ID
+  /// [branch] 생성할 지점 정보
+  /// Returns: 생성된 지점 정보 (ID 포함)
+  Future<Either<Failure, Branch>> createBranch(int companyId, Branch branch);
+
+  /// 지점 정보 수정
+  /// [companyId] 회사 ID
+  /// [branchId] 수정할 지점 ID
+  /// [branch] 수정할 지점 정보
+  /// Returns: 수정된 지점 정보
+  Future<Either<Failure, Branch>> updateBranch(int companyId, int branchId, Branch branch);
+
+  /// 지점 삭제
+  /// [companyId] 회사 ID
+  /// [branchId] 삭제할 지점 ID
+  /// Returns: 삭제 성공/실패 여부
+  Future<Either<Failure, void>> deleteBranch(int companyId, int branchId);
+
+  /// 회사명으로 검색 (자동완성용)
+  /// [query] 검색 쿼리
+  /// [limit] 결과 제한 수 (기본값: 10)
+  /// Returns: 일치하는 회사명 목록
+  Future<Either<Failure, List<String>>> searchCompanyNames(String query, {int? limit});
+
+  /// 회사 유형별 개수 통계
+  /// Returns: 회사 유형별 개수 (고객사, 파트너사)
+  Future<Either<Failure, Map<CompanyType, int>>> getCompanyCountByType();
+
+  /// 회사에 연결된 사용자 존재 여부 확인
+  /// [companyId] 확인할 회사 ID
+  /// Returns: 연결된 사용자 존재 여부 (삭제 가능 여부 판단용)
+  Future<Either<Failure, bool>> hasLinkedUsers(int companyId);
+
+  /// 회사에 연결된 장비 존재 여부 확인
+  /// [companyId] 확인할 회사 ID
+  /// Returns: 연결된 장비 존재 여부 (삭제 가능 여부 판단용)
+  Future<Either<Failure, bool>> hasLinkedEquipment(int companyId);
+
+  /// 중복 회사명 체크
+  /// [name] 체크할 회사명
+  /// [excludeId] 체크에서 제외할 회사 ID (수정 시 현재 회사 제외용)
+  /// Returns: 중복 여부 (true: 중복됨, false: 중복되지 않음)
+  Future<Either<Failure, bool>> isDuplicateCompanyName(String name, {int? excludeId});
+}

lib/domain/repositories/license_repository.dart

@@ -0,0 +1,101 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../models/license_model.dart';
+import '../../data/models/common/paginated_response.dart';
+import '../../data/models/dashboard/license_expiry_summary.dart';
+
+/// 라이선스 관리 Repository 인터페이스
+/// 장비 라이선스 및 유지보수 계약 정보 관리를 담당
+abstract class LicenseRepository {
+  /// 라이선스 목록 조회
+  /// [page] 페이지 번호 (기본값: 1)
+  /// [limit] 페이지당 항목 수 (기본값: 20)
+  /// [search] 검색어 (라이선스명, 회사명, 장비명 등)
+  /// [companyId] 회사 ID 필터
+  /// [equipmentType] 장비 유형 필터
+  /// [expiryStatus] 만료 상태 필터 ('expired', 'expiring', 'active')
+  /// [sortBy] 정렬 기준 ('name', 'expiryDate', 'createdAt' 등)
+  /// [sortOrder] 정렬 순서 ('asc', 'desc')
+  /// Returns: 페이지네이션된 라이선스 목록
+  Future<Either<Failure, PaginatedResponse<License>>> getLicenses({
+    int? page,
+    int? limit,
+    String? search,
+    int? companyId,
+    String? equipmentType,
+    String? expiryStatus,
+    String? sortBy,
+    String? sortOrder,
+  });
+
+  /// 라이선스 상세 정보 조회
+  /// [id] 라이선스 고유 식별자
+  /// Returns: 라이선스 상세 정보 (회사, 장비 정보 포함)
+  Future<Either<Failure, License>> getLicenseById(int id);
+
+  /// 라이선스 생성
+  /// [license] 생성할 라이선스 정보
+  /// Returns: 생성된 라이선스 정보 (ID 포함)
+  Future<Either<Failure, License>> createLicense(License license);
+
+  /// 라이선스 정보 수정
+  /// [id] 수정할 라이선스 고유 식별자
+  /// [license] 수정할 라이선스 정보
+  /// Returns: 수정된 라이선스 정보
+  Future<Either<Failure, License>> updateLicense(int id, License license);
+
+  /// 라이선스 삭제
+  /// [id] 삭제할 라이선스 고유 식별자
+  /// Returns: 삭제 성공/실패 여부
+  Future<Either<Failure, void>> deleteLicense(int id);
+
+  /// 만료 예정 라이선스 조회
+  /// [days] 앞으로 N일 내 만료 예정 (기본값: 30일)
+  /// [companyId] 회사 ID 필터 (선택적)
+  /// Returns: 만료 예정 라이선스 목록
+  Future<Either<Failure, List<License>>> getExpiringLicenses({int days = 30, int? companyId});
+
+  /// 만료된 라이선스 조회
+  /// [companyId] 회사 ID 필터 (선택적)
+  /// Returns: 이미 만료된 라이선스 목록
+  Future<Either<Failure, List<License>>> getExpiredLicenses({int? companyId});
+
+  /// 라이선스 만료 요약 정보 조회
+  /// 대시보드용 30일/60일/90일 내 만료 예정 요약 정보
+  /// Returns: 만료 예정 요약 정보
+  Future<Either<Failure, LicenseExpirySummary>> getLicenseExpirySummary();
+
+  /// 라이선스 갱신
+  /// [id] 갱신할 라이선스 ID
+  /// [newExpiryDate] 새로운 만료일
+  /// [renewalCost] 갱신 비용 (선택적)
+  /// [renewalNote] 갱신 비고 (선택적)
+  /// Returns: 갱신된 라이선스 정보
+  Future<Either<Failure, License>> renewLicense(
+    int id, 
+    DateTime newExpiryDate, 
+    {double? renewalCost, String? renewalNote}
+  );
+
+  /// 회사별 라이선스 통계
+  /// [companyId] 회사 ID
+  /// Returns: 해당 회사의 라이선스 통계 정보 (전체, 활성, 만료, 만료예정)
+  Future<Either<Failure, Map<String, int>>> getLicenseStatsByCompany(int companyId);
+
+  /// 라이선스 유형별 통계
+  /// Returns: 라이선스 유형별 개수 (소프트웨어, 하드웨어 등)
+  Future<Either<Failure, Map<String, int>>> getLicenseCountByType();
+
+  /// 라이선스 만료일 사전 알림 설정
+  /// [licenseId] 라이선스 ID
+  /// [notifyDays] 만료 N일 전 알림 (기본값: 30일)
+  /// Returns: 알림 설정 성공/실패 여부
+  Future<Either<Failure, void>> setExpiryNotification(int licenseId, {int notifyDays = 30});
+
+  /// 라이선스 검색 (자동완성용)
+  /// [query] 검색 쿼리
+  /// [companyId] 회사 ID 필터 (선택적)
+  /// [limit] 결과 제한 수 (기본값: 10)
+  /// Returns: 일치하는 라이선스 목록
+  Future<Either<Failure, List<License>>> searchLicenses(String query, {int? companyId, int? limit});
+}

lib/domain/repositories/user_repository.dart

@@ -0,0 +1,96 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../models/user_model.dart';
+import '../../data/models/common/paginated_response.dart';
+
+/// 사용자 관리 Repository 인터페이스
+/// 사용자 계정 생성, 수정, 삭제 및 권한 관리를 담당
+abstract class UserRepository {
+  /// 사용자 목록 조회
+  /// [page] 페이지 번호 (기본값: 1)
+  /// [limit] 페이지당 항목 수 (기본값: 20)
+  /// [search] 검색어 (사용자명, 이메일, 회사명 등)
+  /// [role] 역할 필터 ('S': 관리자, 'M': 멤버)
+  /// [companyId] 회사 ID 필터
+  /// [isActive] 활성화 상태 필터
+  /// [sortBy] 정렬 기준 ('name', 'createdAt', 'role' 등)
+  /// [sortOrder] 정렬 순서 ('asc', 'desc')
+  /// Returns: 페이지네이션된 사용자 목록
+  Future<Either<Failure, PaginatedResponse<User>>> getUsers({
+    int? page,
+    int? limit,
+    String? search,
+    String? role,
+    int? companyId,
+    bool? isActive,
+    String? sortBy,
+    String? sortOrder,
+  });
+
+  /// 사용자 상세 정보 조회
+  /// [id] 사용자 고유 식별자
+  /// Returns: 사용자 상세 정보 (회사, 지점 정보 포함)
+  Future<Either<Failure, User>> getUserById(int id);
+
+  /// 사용자 계정 생성
+  /// [user] 생성할 사용자 정보
+  /// [password] 초기 비밀번호
+  /// Returns: 생성된 사용자 정보 (ID 포함)
+  Future<Either<Failure, User>> createUser(User user, String password);
+
+  /// 사용자 정보 수정
+  /// [id] 수정할 사용자 고유 식별자
+  /// [user] 수정할 사용자 정보
+  /// Returns: 수정된 사용자 정보
+  Future<Either<Failure, User>> updateUser(int id, User user);
+
+  /// 사용자 삭제
+  /// [id] 삭제할 사용자 고유 식별자
+  /// Returns: 삭제 성공/실패 여부
+  Future<Either<Failure, void>> deleteUser(int id);
+
+  /// 사용자 상태 토글 (활성화/비활성화)
+  /// [id] 상태를 변경할 사용자 고유 식별자
+  /// Returns: 상태 변경된 사용자 정보
+  Future<Either<Failure, User>> toggleUserStatus(int id);
+
+  /// 사용자 비밀번호 재설정
+  /// [id] 비밀번호를 재설정할 사용자 ID
+  /// [newPassword] 새 비밀번호
+  /// Returns: 재설정 성공/실패 여부
+  Future<Either<Failure, void>> resetPassword(int id, String newPassword);
+
+  /// 사용자 역할 변경
+  /// [id] 역할을 변경할 사용자 ID
+  /// [newRole] 새 역할 ('S': 관리자, 'M': 멤버)
+  /// Returns: 역할 변경된 사용자 정보
+  Future<Either<Failure, User>> changeUserRole(int id, String newRole);
+
+  /// 사용자명(이메일) 중복 체크
+  /// [username] 체크할 사용자명(이메일)
+  /// [excludeId] 체크에서 제외할 사용자 ID (수정 시 현재 사용자 제외용)
+  /// Returns: 중복 여부 (true: 중복됨, false: 중복되지 않음)
+  Future<Either<Failure, bool>> isDuplicateUsername(String username, {int? excludeId});
+
+  /// 회사별 사용자 목록 조회
+  /// [companyId] 회사 ID
+  /// [includeInactive] 비활성화 사용자 포함 여부
+  /// Returns: 해당 회사의 사용자 목록
+  Future<Either<Failure, List<User>>> getUsersByCompany(int companyId, {bool includeInactive = false});
+
+  /// 역할별 사용자 수 통계
+  /// Returns: 역할별 사용자 수 (관리자, 멤버)
+  Future<Either<Failure, Map<String, int>>> getUserCountByRole();
+
+  /// 사용자 검색 (자동완성용)
+  /// [query] 검색 쿼리
+  /// [companyId] 회사 ID 필터 (선택적)
+  /// [limit] 결과 제한 수 (기본값: 10)
+  /// Returns: 일치하는 사용자 정보 목록
+  Future<Either<Failure, List<User>>> searchUsers(String query, {int? companyId, int? limit});
+
+  /// 사용자 마지막 로그인 시간 업데이트
+  /// [id] 사용자 ID
+  /// Returns: 업데이트 성공/실패 여부
+  Future<Either<Failure, void>> updateLastLoginTime(int id);
+}

lib/domain/repositories/warehouse_location_repository.dart

@@ -0,0 +1,112 @@
+import 'package:dartz/dartz.dart';
+import '../../core/errors/failures.dart';
+import '../../models/warehouse_location_model.dart';
+import '../../data/models/common/paginated_response.dart';
+
+/// 창고 위치 관리 Repository 인터페이스
+/// 장비 입고지 및 창고 위치 정보 관리를 담당
+abstract class WarehouseLocationRepository {
+  /// 창고 위치 목록 조회
+  /// [page] 페이지 번호 (기본값: 1)
+  /// [limit] 페이지당 항목 수 (기본값: 20)
+  /// [search] 검색어 (창고명, 주소, 담당자명 등)
+  /// [locationType] 위치 유형 필터 ('창고', '사무실', '출고지' 등)
+  /// [isActive] 활성화 상태 필터
+  /// [hasEquipment] 장비 보유 여부 필터
+  /// [sortBy] 정렬 기준 ('name', 'createdAt', 'locationType' 등)
+  /// [sortOrder] 정렬 순서 ('asc', 'desc')
+  /// Returns: 페이지네이션된 창고 위치 목록
+  Future<Either<Failure, PaginatedResponse<WarehouseLocation>>> getWarehouseLocations({
+    int? page,
+    int? limit,
+    String? search,
+    String? locationType,
+    bool? isActive,
+    bool? hasEquipment,
+    String? sortBy,
+    String? sortOrder,
+  });
+
+  /// 창고 위치 상세 정보 조회
+  /// [id] 창고 위치 고유 식별자
+  /// Returns: 창고 위치 상세 정보 (보관 중인 장비 정보 포함)
+  Future<Either<Failure, WarehouseLocation>> getWarehouseLocationById(int id);
+
+  /// 창고 위치 생성
+  /// [warehouseLocation] 생성할 창고 위치 정보
+  /// Returns: 생성된 창고 위치 정보 (ID 포함)
+  Future<Either<Failure, WarehouseLocation>> createWarehouseLocation(WarehouseLocation warehouseLocation);
+
+  /// 창고 위치 정보 수정
+  /// [id] 수정할 창고 위치 고유 식별자
+  /// [warehouseLocation] 수정할 창고 위치 정보
+  /// Returns: 수정된 창고 위치 정보
+  Future<Either<Failure, WarehouseLocation>> updateWarehouseLocation(int id, WarehouseLocation warehouseLocation);
+
+  /// 창고 위치 삭제
+  /// [id] 삭제할 창고 위치 고유 식별자
+  /// Returns: 삭제 성공/실패 여부
+  Future<Either<Failure, void>> deleteWarehouseLocation(int id);
+
+  /// 창고 위치 상태 토글 (활성화/비활성화)
+  /// [id] 상태를 변경할 창고 위치 고유 식별자
+  /// Returns: 상태 변경된 창고 위치 정보
+  Future<Either<Failure, WarehouseLocation>> toggleWarehouseLocationStatus(int id);
+
+  /// 창고에 장비가 있는지 확인
+  /// [id] 확인할 창고 위치 ID
+  /// Returns: 장비 보유 여부 (삭제 가능 여부 판단용)
+  Future<Either<Failure, bool>> hasEquipment(int id);
+
+  /// 창고별 장비 수량 조회
+  /// [id] 창고 위치 ID
+  /// Returns: 해당 창고에 보관 중인 장비 수량
+  Future<Either<Failure, int>> getEquipmentCount(int id);
+
+  /// 창고별 장비 목록 조회
+  /// [warehouseId] 창고 위치 ID
+  /// [page] 페이지 번호
+  /// [limit] 페이지당 항목 수
+  /// Returns: 해당 창고에 보관 중인 장비 목록
+  Future<Either<Failure, PaginatedResponse<dynamic>>> getEquipmentByWarehouse(
+    int warehouseId, {
+    int? page,
+    int? limit,
+  });
+
+  /// 창고 사용률 통계
+  /// Returns: 창고별 사용률 (전체 용량 대비 사용 중인 용량)
+  Future<Either<Failure, Map<int, double>>> getWarehouseUtilization();
+
+  /// 창고 유형별 통계
+  /// Returns: 창고 유형별 개수 ('창고', '사무실', '출고지' 등)
+  Future<Either<Failure, Map<String, int>>> getWarehouseCountByType();
+
+  /// 창고명 중복 체크
+  /// [name] 체크할 창고명
+  /// [excludeId] 체크에서 제외할 창고 ID (수정 시 현재 창고 제외용)
+  /// Returns: 중복 여부 (true: 중복됨, false: 중복되지 않음)
+  Future<Either<Failure, bool>> isDuplicateWarehouseName(String name, {int? excludeId});
+
+  /// 창고 검색 (자동완성용)
+  /// [query] 검색 쿼리
+  /// [limit] 결과 제한 수 (기본값: 10)
+  /// Returns: 일치하는 창고 위치 목록
+  Future<Either<Failure, List<WarehouseLocation>>> searchWarehouseLocations(String query, {int? limit});
+
+  /// 활성 창고 위치 목록 조회 (드롭다운용)
+  /// 장비 등록 시 선택 가능한 활성 상태의 창고 위치만 조회
+  /// Returns: 활성화된 창고 위치 목록
+  Future<Either<Failure, List<WarehouseLocation>>> getActiveWarehouseLocations();
+
+  /// 창고 용량 및 사용량 업데이트
+  /// [id] 창고 위치 ID
+  /// [totalCapacity] 전체 용량
+  /// [usedCapacity] 사용 중인 용량
+  /// Returns: 업데이트된 창고 위치 정보
+  Future<Either<Failure, WarehouseLocation>> updateWarehouseCapacity(
+    int id, 
+    int totalCapacity, 
+    int usedCapacity,
+  );
+}