사용하지 않는 파일 정리 전 백업 (Phase 10 완료 후 상태)
This commit is contained in:
JiWoong Sul
59
lib/domain/repositories/administrator_repository.dart
Normal file
59
lib/domain/repositories/administrator_repository.dart
Normal file
@@ -0,0 +1,59 @@
|
||||
import 'package:dartz/dartz.dart';
|
||||
import '../../core/errors/failures.dart';
|
||||
import '../../data/models/administrator_dto.dart';
|
||||
|
||||
/// 관리자 관리 Repository 인터페이스 (백엔드 API Administrator 테이블)
|
||||
/// Clean Architecture Domain Layer - Repository 계약
|
||||
abstract class AdministratorRepository {
|
||||
/// 관리자 목록 조회 (페이지네이션 지원)
|
||||
/// [page] 페이지 번호 (기본값: 1)
|
||||
/// [pageSize] 페이지당 항목 수 (기본값: 20)
|
||||
/// [search] 검색어 (이름, 이메일, 전화번호)
|
||||
/// Returns: 페이지네이션된 관리자 목록
|
||||
Future<Either<Failure, AdministratorListResponse>> getAdministrators({
|
||||
int? page,
|
||||
int? pageSize,
|
||||
String? search,
|
||||
});
|
||||
|
||||
/// 단일 관리자 조회
|
||||
/// [id] 관리자 고유 식별자
|
||||
/// Returns: 관리자 상세 정보
|
||||
Future<Either<Failure, AdministratorDto>> getAdministratorById(int id);
|
||||
|
||||
/// 관리자 계정 생성
|
||||
/// [administrator] 생성할 관리자 정보
|
||||
/// Returns: 생성된 관리자 정보 (ID 포함)
|
||||
Future<Either<Failure, AdministratorDto>> createAdministrator(
|
||||
AdministratorRequestDto administrator,
|
||||
);
|
||||
|
||||
/// 관리자 정보 수정
|
||||
/// [id] 수정할 관리자 고유 식별자
|
||||
/// [administrator] 수정할 관리자 정보
|
||||
/// Returns: 수정된 관리자 정보
|
||||
Future<Either<Failure, AdministratorDto>> updateAdministrator(
|
||||
int id,
|
||||
AdministratorUpdateRequestDto administrator,
|
||||
);
|
||||
|
||||
/// 관리자 계정 삭제
|
||||
/// [id] 삭제할 관리자 고유 식별자
|
||||
/// Returns: 삭제 성공/실패 여부
|
||||
Future<Either<Failure, void>> deleteAdministrator(int id);
|
||||
|
||||
/// 이메일 중복 확인
|
||||
/// [email] 체크할 이메일 주소
|
||||
/// [excludeId] 체크에서 제외할 관리자 ID (수정 시 현재 관리자 제외용)
|
||||
/// Returns: 중복 여부 (true: 중복됨, false: 중복되지 않음)
|
||||
Future<Either<Failure, bool>> isDuplicateEmail(String email, {int? excludeId});
|
||||
|
||||
/// 관리자 인증 (로그인용)
|
||||
/// [email] 이메일 주소
|
||||
/// [password] 비밀번호
|
||||
/// Returns: 인증된 관리자 정보
|
||||
Future<Either<Failure, AdministratorDto>> authenticateAdministrator(
|
||||
String email,
|
||||
String password,
|
||||
);
|
||||
}
|
||||
@@ -93,4 +93,50 @@ abstract class CompanyRepository {
|
||||
/// [excludeId] 체크에서 제외할 회사 ID (수정 시 현재 회사 제외용)
|
||||
/// Returns: 중복 여부 (true: 중복됨, false: 중복되지 않음)
|
||||
Future<Either<Failure, bool>> isDuplicateCompanyName(String name, {int? excludeId});
|
||||
|
||||
// 계층 구조 관련 메서드들
|
||||
|
||||
/// 전체 회사 계층 구조 조회
|
||||
/// [includeInactive] 비활성 회사 포함 여부
|
||||
/// Returns: 전체 계층 구조 트리
|
||||
Future<Either<Failure, List<Company>>> getCompanyHierarchy({
|
||||
bool includeInactive = false,
|
||||
});
|
||||
|
||||
/// 특정 회사의 자식 회사 목록 조회
|
||||
/// [companyId] 부모 회사 ID
|
||||
/// [recursive] 재귀적으로 모든 자손 포함 여부
|
||||
/// Returns: 자식 회사 목록
|
||||
Future<Either<Failure, List<Company>>> getChildrenCompanies(
|
||||
int companyId, {
|
||||
bool recursive = false,
|
||||
});
|
||||
|
||||
/// 특정 회사의 부모 경로 조회
|
||||
/// [companyId] 회사 ID
|
||||
/// Returns: 루트부터 현재 회사까지의 경로
|
||||
Future<Either<Failure, List<Company>>> getAncestorPath(int companyId);
|
||||
|
||||
/// 회사의 부모 변경
|
||||
/// [companyId] 변경할 회사 ID
|
||||
/// [newParentId] 새로운 부모 회사 ID (null이면 루트로 변경)
|
||||
/// Returns: 업데이트된 회사 정보
|
||||
Future<Either<Failure, Company>> updateParentCompany(
|
||||
int companyId,
|
||||
int? newParentId,
|
||||
);
|
||||
|
||||
/// 회사가 자식을 가지고 있는지 확인
|
||||
/// [companyId] 확인할 회사 ID
|
||||
/// Returns: 자식 회사 존재 여부
|
||||
Future<Either<Failure, bool>> hasChildrenCompanies(int companyId);
|
||||
|
||||
/// 계층 구조 유효성 검증
|
||||
/// [companyId] 검증할 회사 ID
|
||||
/// [newParentId] 새로운 부모 회사 ID
|
||||
/// Returns: 유효성 검증 결과 (순환 참조, 깊이 제한 등)
|
||||
Future<Either<Failure, bool>> validateHierarchyChange(
|
||||
int companyId,
|
||||
int? newParentId,
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,68 +1,26 @@
|
||||
import 'package:dartz/dartz.dart';
|
||||
import '../../core/errors/failures.dart';
|
||||
import '../../models/equipment_unified_model.dart';
|
||||
import '../../data/models/equipment/equipment_dto.dart';
|
||||
import '../../data/models/common/paginated_response.dart';
|
||||
|
||||
/// 장비 관리 Repository 인터페이스
|
||||
abstract class EquipmentRepository {
|
||||
/// 장비 입고 목록 조회
|
||||
Future<Either<Failure, List<EquipmentIn>>> getEquipmentIns({
|
||||
/// 장비 목록 조회 (페이지네이션 지원)
|
||||
Future<Either<Failure, PaginatedResponse<EquipmentDto>>> getEquipments({
|
||||
int? page,
|
||||
int? limit,
|
||||
String? search,
|
||||
String? sortBy,
|
||||
String? sortOrder,
|
||||
});
|
||||
|
||||
/// 장비 입고 상세 조회
|
||||
Future<Either<Failure, EquipmentIn>> getEquipmentInById(int id);
|
||||
/// 장비 상세 조회
|
||||
Future<Either<Failure, EquipmentDto>> getEquipmentDetail(int id);
|
||||
|
||||
/// 장비 입고 생성
|
||||
Future<Either<Failure, EquipmentIn>> createEquipmentIn(EquipmentIn equipmentIn);
|
||||
/// 장비 생성
|
||||
Future<Either<Failure, EquipmentDto>> createEquipment(EquipmentRequestDto request);
|
||||
|
||||
/// 장비 입고 수정
|
||||
Future<Either<Failure, EquipmentIn>> updateEquipmentIn(int id, EquipmentIn equipmentIn);
|
||||
/// 장비 수정
|
||||
Future<Either<Failure, EquipmentDto>> updateEquipment(int id, EquipmentUpdateRequestDto request);
|
||||
|
||||
/// 장비 입고 삭제
|
||||
Future<Either<Failure, void>> deleteEquipmentIn(int id);
|
||||
|
||||
/// 장비 출고 목록 조회
|
||||
Future<Either<Failure, List<EquipmentOut>>> getEquipmentOuts({
|
||||
int? page,
|
||||
int? limit,
|
||||
String? search,
|
||||
String? sortBy,
|
||||
String? sortOrder,
|
||||
});
|
||||
|
||||
/// 장비 출고 상세 조회
|
||||
Future<Either<Failure, EquipmentOut>> getEquipmentOutById(int id);
|
||||
|
||||
/// 장비 출고 생성
|
||||
Future<Either<Failure, EquipmentOut>> createEquipmentOut(EquipmentOut equipmentOut);
|
||||
|
||||
/// 장비 출고 수정
|
||||
Future<Either<Failure, EquipmentOut>> updateEquipmentOut(int id, EquipmentOut equipmentOut);
|
||||
|
||||
/// 장비 출고 삭제
|
||||
Future<Either<Failure, void>> deleteEquipmentOut(int id);
|
||||
|
||||
/// 장비 일괄 출고
|
||||
Future<Either<Failure, List<EquipmentOut>>> createBatchEquipmentOut(List<EquipmentOut> equipmentOuts);
|
||||
|
||||
/// 제조사 목록 조회
|
||||
Future<Either<Failure, List<String>>> getManufacturers();
|
||||
|
||||
/// 장비명 목록 조회
|
||||
Future<Either<Failure, List<String>>> getEquipmentNames();
|
||||
|
||||
/// 장비 이력 조회
|
||||
Future<Either<Failure, List<dynamic>>> getEquipmentHistory(int equipmentId);
|
||||
|
||||
/// 장비 검색
|
||||
Future<Either<Failure, List<Equipment>>> searchEquipment({
|
||||
String? manufacturer,
|
||||
String? name,
|
||||
String? category,
|
||||
String? serialNumber,
|
||||
});
|
||||
/// 장비 삭제 (소프트 삭제)
|
||||
Future<Either<Failure, void>> deleteEquipment(int id);
|
||||
}
|
||||
@@ -1,101 +0,0 @@
|
||||
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});
|
||||
}
|
||||
42
lib/domain/repositories/rent_repository.dart
Normal file
42
lib/domain/repositories/rent_repository.dart
Normal file
@@ -0,0 +1,42 @@
|
||||
import '../../data/models/rent_dto.dart';
|
||||
|
||||
abstract class RentRepository {
|
||||
/// 임대 목록 조회
|
||||
Future<RentListResponse> getRents({
|
||||
int page = 1,
|
||||
int pageSize = 10,
|
||||
String? search,
|
||||
String? status,
|
||||
int? equipmentHistoryId,
|
||||
});
|
||||
|
||||
/// 임대 상세 조회
|
||||
Future<RentDto> getRent(int id);
|
||||
|
||||
/// 임대 생성
|
||||
Future<RentDto> createRent(RentRequestDto request);
|
||||
|
||||
/// 임대 수정
|
||||
Future<RentDto> updateRent(int id, RentUpdateRequestDto request);
|
||||
|
||||
/// 임대 삭제
|
||||
Future<void> deleteRent(int id);
|
||||
|
||||
/// 진행 중인 임대 목록
|
||||
Future<RentListResponse> getActiveRents({
|
||||
int page = 1,
|
||||
int pageSize = 10,
|
||||
});
|
||||
|
||||
/// 연체된 임대 목록
|
||||
Future<RentListResponse> getOverdueRents({
|
||||
int page = 1,
|
||||
int pageSize = 10,
|
||||
});
|
||||
|
||||
/// 임대 통계
|
||||
Future<Map<String, dynamic>> getRentStats();
|
||||
|
||||
/// 장비 반납 처리
|
||||
Future<RentDto> returnRent(int id, String returnDate);
|
||||
}
|
||||
@@ -24,17 +24,17 @@ abstract class UserRepository {
|
||||
/// Returns: 사용자 상세 정보
|
||||
Future<Either<Failure, User>> getUserById(int id);
|
||||
|
||||
/// 사용자 계정 생성
|
||||
/// [user] 생성할 사용자 정보 (username, email, name, role 필수)
|
||||
/// [password] 초기 비밀번호 (필수, 6자 이상)
|
||||
/// 사용자 계정 생성 (백엔드 API v1 준수)
|
||||
/// [name] 사용자 이름 (필수)
|
||||
/// [email] 이메일 (선택적)
|
||||
/// [phone] 전화번호 (선택적)
|
||||
/// [companiesId] 회사 ID (필수)
|
||||
/// Returns: 생성된 사용자 정보 (ID 포함)
|
||||
Future<Either<Failure, User>> createUser({
|
||||
required String username,
|
||||
required String email,
|
||||
required String password,
|
||||
required String name,
|
||||
String? email,
|
||||
String? phone,
|
||||
required UserRole role,
|
||||
required int companiesId,
|
||||
});
|
||||
|
||||
/// 사용자 정보 수정
|
||||
@@ -49,8 +49,8 @@ abstract class UserRepository {
|
||||
/// Returns: 삭제 성공/실패 여부
|
||||
Future<Either<Failure, void>> deleteUser(int id);
|
||||
|
||||
/// 사용자명 사용 가능 여부 확인
|
||||
/// [username] 체크할 사용자명
|
||||
/// Returns: 사용 가능 여부 응답
|
||||
Future<Either<Failure, bool>> checkUsernameAvailability(String username);
|
||||
/// 사용자 이름 중복 확인 (백엔드 API v1에서는 미지원)
|
||||
/// [name] 체크할 사용자 이름
|
||||
/// Returns: 사용 가능 여부 응답 (항상 true 반환)
|
||||
Future<Either<Failure, bool>> checkUsernameAvailability(String name);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user