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>

lib/domain/usecases/user/get_users_usecase.dart

@@ -1,67 +1,41 @@
 import 'package:dartz/dartz.dart';
-import '../../../services/user_service.dart';
-import '../../../models/user_model.dart' as model;
+import 'package:injectable/injectable.dart';
+import '../../../models/user_model.dart';
 import '../../../core/errors/failures.dart';
+import '../../repositories/user_repository.dart';
+import '../../../data/models/common/paginated_response.dart';
 import '../base_usecase.dart';
 
-/// 사용자 목록 조회 파라미터
+/// 사용자 목록 조회 파라미터 (서버 API v0.2.1 대응)
 class GetUsersParams {
   final int page;
   final int perPage;
+  final UserRole? role;
   final bool? isActive;
-  final int? companyId;
-  final String? role;
 
   const GetUsersParams({
     this.page = 1,
     this.perPage = 20,
-    this.isActive,
-    this.companyId,
     this.role,
+    this.isActive,
   });
 }
 
-/// 사용자 목록 조회 UseCase
-/// 필터링 및 페이지네이션 지원
-class GetUsersUseCase extends UseCase<List<model.User>, GetUsersParams> {
-  final UserService _userService;
+/// 사용자 목록 조회 UseCase (Clean Architecture Domain Layer)
+/// 페이지네이션과 필터링을 지원하는 사용자 목록 조회
+@injectable
+class GetUsersUseCase extends UseCase<PaginatedResponse<User>, GetUsersParams> {
+  final UserRepository _userRepository;
 
-  GetUsersUseCase(this._userService);
+  GetUsersUseCase(this._userRepository);
 
   @override
-  Future<Either<Failure, List<model.User>>> call(GetUsersParams params) async {
-    try {
-      // 권한 검증 (관리자, 매니저만 사용자 목록 조회 가능)
-      // 실제 구현에서는 현재 사용자 권한 체크 필요
-      
-      final response = await _userService.getUsers(
-        page: params.page,
-        perPage: params.perPage,
-        isActive: params.isActive,
-        companyId: params.companyId,
-        role: params.role,
-      );
-      
-      // PaginatedResponse에서 items만 추출
-      return Right(response.items);
-    } catch (e) {
-      if (e.toString().contains('권한')) {
-        return Left(PermissionFailure(
-          message: '사용자 목록을 조회할 권한이 없습니다.',
-          code: 'PERMISSION_DENIED',
-          originalError: e,
-        ));
-      } else if (e.toString().contains('네트워크')) {
-        return Left(NetworkFailure(
-          message: '네트워크 연결을 확인해주세요.',
-          originalError: e,
-        ));
-      } else {
-        return Left(ServerFailure(
-          message: '사용자 목록을 불러오는 중 오류가 발생했습니다.',
-          originalError: e,
-        ));
-      }
-    }
+  Future<Either<Failure, PaginatedResponse<User>>> call(GetUsersParams params) async {
+    return await _userRepository.getUsers(
+      page: params.page,
+      perPage: params.perPage,
+      role: params.role,
+      isActive: params.isActive,
+    );
   }
 }