Files
superport/lib/domain/repositories/user_repository.dart
JiWoong Sul 93bceb8a6c
Some checks failed
Flutter Test & Quality Check / Test on macos-latest (push) Has been cancelled
Flutter Test & Quality Check / Test on ubuntu-latest (push) Has been cancelled
Flutter Test & Quality Check / Build APK (push) Has been cancelled
feat: 사용자 관리 시스템 백엔드 API 호환성 대폭 개선
- UserRemoteDataSource: API v0.2.1 스펙 완전 대응
  • 응답 형식 통일 (success: true 구조)
  • 페이지네이션 처리 개선
  • 에러 핸들링 강화
  • 불필요한 파라미터 제거 (includeInactive 등)

- UserDto 모델 현대화:
  • 서버 응답 구조와 100% 일치
  • 도메인 모델 변환 메서드 추가
  • Freezed 불변성 패턴 완성

- User 도메인 모델 신규 구현:
  • Clean Architecture 원칙 준수
  • UserRole enum 타입 안전성 강화
  • 비즈니스 로직 캡슐화

- 사용자 관련 UseCase 리팩토링:
  • Repository 패턴 완전 적용
  • Either<Failure, Success> 에러 처리
  • 의존성 주입 최적화

- UI 컨트롤러 및 화면 개선:
  • API 응답 변경사항 반영
  • 사용자 권한 표시 정확성 향상
  • 폼 검증 로직 강화

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-15 23:31:51 +09:00

57 lines
2.0 KiB
Dart

import 'package:dartz/dartz.dart';
import '../../core/errors/failures.dart';
import '../../models/user_model.dart';
import '../../data/models/common/paginated_response.dart';
/// 사용자 관리 Repository 인터페이스 (서버 API v0.2.1 대응)
/// Clean Architecture Domain Layer - Repository 계약
abstract class UserRepository {
/// 사용자 목록 조회 (페이지네이션 지원)
/// [page] 페이지 번호 (기본값: 1)
/// [perPage] 페이지당 항목 수 (기본값: 20)
/// [role] 역할 필터 (admin, manager, staff)
/// [isActive] 활성화 상태 필터
/// Returns: 페이지네이션된 사용자 목록
Future<Either<Failure, PaginatedResponse<User>>> getUsers({
int? page,
int? perPage,
UserRole? role,
bool? isActive,
});
/// 단일 사용자 조회
/// [id] 사용자 고유 식별자
/// Returns: 사용자 상세 정보
Future<Either<Failure, User>> getUserById(int id);
/// 사용자 계정 생성
/// [user] 생성할 사용자 정보 (username, email, name, role 필수)
/// [password] 초기 비밀번호 (필수, 6자 이상)
/// Returns: 생성된 사용자 정보 (ID 포함)
Future<Either<Failure, User>> createUser({
required String username,
required String email,
required String password,
required String name,
String? phone,
required UserRole role,
});
/// 사용자 정보 수정
/// [id] 수정할 사용자 고유 식별자
/// [user] 수정할 사용자 정보
/// [newPassword] 새 비밀번호 (선택적)
/// Returns: 수정된 사용자 정보
Future<Either<Failure, User>> updateUser(int id, User user, {String? newPassword});
/// 사용자 소프트 삭제 (is_active = false)
/// [id] 삭제할 사용자 고유 식별자
/// Returns: 삭제 성공/실패 여부
Future<Either<Failure, void>> deleteUser(int id);
/// 사용자명 사용 가능 여부 확인
/// [username] 체크할 사용자명
/// Returns: 사용 가능 여부 응답
Future<Either<Failure, bool>> checkUsernameAvailability(String username);
}