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] 역할 필터 (UI 호환용)
  /// [isActive] 활성화 상태 필터 (UI 호환용)
  /// Returns: 페이지네이션된 사용자 목록
  Future<Either<Failure, PaginatedResponse<User>>> getUsers({
    int? page,
    int? perPage,
    UserRole? role,
    bool? isActive,
  });

  /// 단일 사용자 조회
  /// [id] 사용자 고유 식별자
  /// Returns: 사용자 상세 정보
  Future<Either<Failure, User>> getUserById(int id);

  /// 사용자 계정 생성 (백엔드 API v1 준수)
  /// [name] 사용자 이름 (필수)
  /// [email] 이메일 (선택적)  
  /// [phone] 전화번호 (선택적)
  /// [companiesId] 회사 ID (필수)
  /// Returns: 생성된 사용자 정보 (ID 포함)
  Future<Either<Failure, User>> createUser({
    required String name,
    String? email,
    String? phone,
    required int companiesId,
  });

  /// 사용자 정보 수정
  /// [id] 수정할 사용자 고유 식별자
  /// [user] 수정할 사용자 정보
  /// [newPassword] 새 비밀번호 (UI 호환용)
  /// Returns: 수정된 사용자 정보
  Future<Either<Failure, User>> updateUser(int id, User user, {String? newPassword});

  /// 사용자 소프트 삭제 (is_active = false)
  /// [id] 삭제할 사용자 고유 식별자
  /// Returns: 삭제 성공/실패 여부
  Future<Either<Failure, void>> deleteUser(int id);

  /// 사용자명 중복 확인 (UI 호환용)
  /// [name] 체크할 사용자명
  /// Returns: 사용 가능 여부 (항상 true 반환)
  Future<Either<Failure, bool>> checkUsernameAvailability(String name);
}
