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/repositories/user_repository.dart

@@ -3,94 +3,54 @@ import '../../core/errors/failures.dart';
 import '../../models/user_model.dart';
 import '../../data/models/common/paginated_response.dart';
 
-/// 사용자 관리 Repository 인터페이스
-/// 사용자 계정 생성, 수정, 삭제 및 권한 관리를 담당
+/// 사용자 관리 Repository 인터페이스 (서버 API v0.2.1 대응)
+/// Clean Architecture Domain Layer - Repository 계약
 abstract class UserRepository {
-  /// 사용자 목록 조회
+  /// 사용자 목록 조회 (페이지네이션 지원)
   /// [page] 페이지 번호 (기본값: 1)
-  /// [limit] 페이지당 항목 수 (기본값: 20)
-  /// [search] 검색어 (사용자명, 이메일, 회사명 등)
-  /// [role] 역할 필터 ('S': 관리자, 'M': 멤버)
-  /// [companyId] 회사 ID 필터
+  /// [perPage] 페이지당 항목 수 (기본값: 20)  
+  /// [role] 역할 필터 (admin, manager, staff)
   /// [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,
+    int? perPage,
+    UserRole? role,
     bool? isActive,
-    String? sortBy,
-    String? sortOrder,
   });
 
-  /// 사용자 상세 정보 조회
+  /// 단일 사용자 조회
   /// [id] 사용자 고유 식별자
-  /// Returns: 사용자 상세 정보 (회사, 지점 정보 포함)
+  /// Returns: 사용자 상세 정보
   Future<Either<Failure, User>> getUserById(int id);
 
   /// 사용자 계정 생성
-  /// [user] 생성할 사용자 정보
-  /// [password] 초기 비밀번호
+  /// [user] 생성할 사용자 정보 (username, email, name, role 필수)
+  /// [password] 초기 비밀번호 (필수, 6자 이상)
   /// Returns: 생성된 사용자 정보 (ID 포함)
-  Future<Either<Failure, User>> createUser(User user, String password);
+  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);
+  Future<Either<Failure, User>> updateUser(int id, User user, {String? newPassword});
 
-  /// 사용자 삭제
+  /// 사용자 소프트 삭제 (is_active = false)
   /// [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);
+  /// 사용자명 사용 가능 여부 확인
+  /// [username] 체크할 사용자명
+  /// Returns: 사용 가능 여부 응답
+  Future<Either<Failure, bool>> checkUsernameAvailability(String username);
 }