731dcd816b
## 주요 변경사항 ### 🏗️ 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. 성능 최적화
102 lines
4.1 KiB
Dart
102 lines
4.1 KiB
Dart
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});
|
|
}
|