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);
}