refactor: Clean Architecture 적용 및 코드베이스 전면 리팩토링

## 주요 변경사항

### 아키텍처 개선
- Clean Architecture 패턴 적용 (Domain, Data, Presentation 레이어 분리)
- Use Case 패턴 도입으로 비즈니스 로직 캡슐화
- Repository 패턴으로 데이터 접근 추상화
- 의존성 주입 구조 개선

### 상태 관리 최적화
- 모든 Controller에서 불필요한 상태 관리 로직 제거
- 페이지네이션 로직 통일 및 간소화
- 에러 처리 로직 개선 (에러 메시지 한글화)
- 로딩 상태 관리 최적화

### Mock 서비스 제거
- MockDataService 완전 제거
- 모든 화면을 실제 API 전용으로 전환
- 불필요한 Mock 관련 코드 정리

### UI/UX 개선
- Overview 화면 대시보드 기능 강화
- 라이선스 만료 알림 위젯 추가
- 사이드바 네비게이션 개선
- 일관된 UI 컴포넌트 사용

### 코드 품질
- 중복 코드 제거 및 함수 추출
- 파일별 책임 분리 명확화
- 테스트 코드 업데이트

## 영향 범위
- 모든 화면의 Controller 리팩토링
- API 통신 레이어 구조 개선
- 에러 처리 및 로깅 시스템 개선

## 향후 계획
- 단위 테스트 커버리지 확대
- 통합 테스트 시나리오 추가
- 성능 모니터링 도구 통합

lib/domain/usecases/user/create_user_usecase.dart

@@ -0,0 +1,135 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../models/user_model.dart' as model;
+import '../../../core/constants/app_constants.dart';
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 생성 파라미터
+class CreateUserParams {
+  final String username;
+  final String email;
+  final String password;
+  final String name;
+  final String role;
+  final int companyId;
+  final String? phone;
+  final String? position;
+
+  const CreateUserParams({
+    required this.username,
+    required this.email,
+    required this.password,
+    required this.name,
+    required this.role,
+    required this.companyId,
+    this.phone,
+    this.position,
+  });
+}
+
+/// 사용자 생성 UseCase
+/// 유효성 검증 및 중복 체크 포함
+class CreateUserUseCase extends UseCase<model.User, CreateUserParams> {
+  final UserService _userService;
+
+  CreateUserUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, model.User>> call(CreateUserParams params) async {
+    try {
+      // 유효성 검증
+      final validationResult = _validateUserInput(params);
+      if (validationResult != null) {
+        return Left(validationResult);
+      }
+
+      final user = await _userService.createUser(
+        username: params.username,
+        email: params.email,
+        password: params.password,
+        name: params.name,
+        role: params.role,
+        companyId: params.companyId,
+        phone: params.phone,
+        position: params.position,
+      );
+      
+      return Right(user);
+    } catch (e) {
+      if (e.toString().contains('이미 존재')) {
+        return Left(ValidationFailure(
+          message: '이미 존재하는 사용자입니다.',
+          code: 'USER_EXISTS',
+          errors: {
+            'username': '이미 사용중인 사용자명입니다.',
+            'email': '이미 등록된 이메일입니다.',
+          },
+          originalError: e,
+        ));
+      } else if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '사용자를 생성할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '사용자 생성 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+
+  ValidationFailure? _validateUserInput(CreateUserParams params) {
+    final errors = <String, String>{};
+
+    // 사용자명 검증
+    if (params.username.length < 3) {
+      errors['username'] = '사용자명은 3자 이상이어야 합니다.';
+    }
+    if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(params.username)) {
+      errors['username'] = '사용자명은 영문, 숫자, 언더스코어만 사용 가능합니다.';
+    }
+
+    // 이메일 검증
+    if (!AppConstants.emailRegex.hasMatch(params.email)) {
+      errors['email'] = '올바른 이메일 형식이 아닙니다.';
+    }
+
+    // 비밀번호 검증
+    if (params.password.length < 8) {
+      errors['password'] = '비밀번호는 8자 이상이어야 합니다.';
+    }
+    if (!RegExp(r'^(?=.*[A-Za-z])(?=.*\d)(?=.*[@$!%*#?&])[A-Za-z\d@$!%*#?&]').hasMatch(params.password)) {
+      errors['password'] = '비밀번호는 영문, 숫자, 특수문자를 포함해야 합니다.';
+    }
+
+    // 이름 검증
+    if (params.name.isEmpty) {
+      errors['name'] = '이름을 입력해주세요.';
+    }
+
+    // 역할 검증
+    if (!['S', 'M', 'U', 'V'].contains(params.role)) {
+      errors['role'] = '올바른 역할을 선택해주세요.';
+    }
+
+    // 전화번호 검증 (선택사항)
+    if (params.phone != null && params.phone!.isNotEmpty) {
+      if (!AppConstants.phoneRegex.hasMatch(params.phone!)) {
+        errors['phone'] = '올바른 전화번호 형식이 아닙니다.';
+      }
+    }
+
+    if (errors.isNotEmpty) {
+      return ValidationFailure(
+        message: '입력값을 확인해주세요.',
+        errors: errors,
+      );
+    }
+
+    return null;
+  }
+}

lib/domain/usecases/user/delete_user_usecase.dart

@@ -0,0 +1,56 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 삭제 파라미터
+class DeleteUserParams {
+  final int id;
+
+  const DeleteUserParams({
+    required this.id,
+  });
+}
+
+/// 사용자 삭제 UseCase
+class DeleteUserUseCase extends UseCase<void, DeleteUserParams> {
+  final UserService _userService;
+
+  DeleteUserUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, void>> call(DeleteUserParams params) async {
+    try {
+      // 자기 자신 삭제 방지 로직 필요
+      // 실제 구현에서는 현재 로그인한 사용자 ID와 비교
+      
+      await _userService.deleteUser(params.id);
+      return const Right(null);
+    } catch (e) {
+      if (e.toString().contains('찾을 수 없')) {
+        return Left(ValidationFailure(
+          message: '사용자를 찾을 수 없습니다.',
+          code: 'USER_NOT_FOUND',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('삭제할 수 없')) {
+        return Left(ValidationFailure(
+          message: '해당 사용자는 삭제할 수 없습니다.',
+          code: 'CANNOT_DELETE',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '사용자를 삭제할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '사용자 삭제 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+}

lib/domain/usecases/user/get_user_detail_usecase.dart

@@ -0,0 +1,48 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../models/user_model.dart' as model;
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 상세 조회 파라미터
+class GetUserDetailParams {
+  final int id;
+
+  const GetUserDetailParams({
+    required this.id,
+  });
+}
+
+/// 사용자 상세 조회 UseCase
+class GetUserDetailUseCase extends UseCase<model.User, GetUserDetailParams> {
+  final UserService _userService;
+
+  GetUserDetailUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, model.User>> call(GetUserDetailParams params) async {
+    try {
+      final user = await _userService.getUser(params.id);
+      return Right(user);
+    } catch (e) {
+      if (e.toString().contains('찾을 수 없')) {
+        return Left(ValidationFailure(
+          message: '사용자를 찾을 수 없습니다.',
+          code: 'USER_NOT_FOUND',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '사용자 정보를 조회할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '사용자 정보를 불러오는 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+}

lib/domain/usecases/user/get_users_usecase.dart

@@ -0,0 +1,66 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../models/user_model.dart' as model;
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 목록 조회 파라미터
+class GetUsersParams {
+  final int page;
+  final int perPage;
+  final bool? isActive;
+  final int? companyId;
+  final String? role;
+
+  const GetUsersParams({
+    this.page = 1,
+    this.perPage = 20,
+    this.isActive,
+    this.companyId,
+    this.role,
+  });
+}
+
+/// 사용자 목록 조회 UseCase
+/// 필터링 및 페이지네이션 지원
+class GetUsersUseCase extends UseCase<List<model.User>, GetUsersParams> {
+  final UserService _userService;
+
+  GetUsersUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, List<model.User>>> call(GetUsersParams params) async {
+    try {
+      // 권한 검증 (관리자, 매니저만 사용자 목록 조회 가능)
+      // 실제 구현에서는 현재 사용자 권한 체크 필요
+      
+      final users = await _userService.getUsers(
+        page: params.page,
+        perPage: params.perPage,
+        isActive: params.isActive,
+        companyId: params.companyId,
+        role: params.role,
+      );
+      
+      return Right(users);
+    } 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,
+        ));
+      }
+    }
+  }
+}

lib/domain/usecases/user/reset_password_usecase.dart

@@ -0,0 +1,94 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 비밀번호 재설정 파라미터
+class ResetPasswordParams {
+  final int userId;
+  final String newPassword;
+  final String? currentPassword; // 자기 자신의 비밀번호 변경 시 필요
+
+  const ResetPasswordParams({
+    required this.userId,
+    required this.newPassword,
+    this.currentPassword,
+  });
+}
+
+/// 비밀번호 재설정 UseCase
+/// 관리자는 다른 사용자 비밀번호 재설정 가능
+/// 일반 사용자는 자신의 비밀번호만 변경 가능 (현재 비밀번호 필요)
+class ResetPasswordUseCase extends UseCase<bool, ResetPasswordParams> {
+  final UserService _userService;
+
+  ResetPasswordUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, bool>> call(ResetPasswordParams params) async {
+    try {
+      // 비밀번호 유효성 검증
+      final validationResult = _validatePassword(params.newPassword);
+      if (validationResult != null) {
+        return Left(validationResult);
+      }
+
+      final success = await _userService.resetPassword(
+        userId: params.userId,
+        newPassword: params.newPassword,
+      );
+      
+      return Right(success);
+    } catch (e) {
+      if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '비밀번호를 재설정할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('일치하지 않')) {
+        return Left(AuthFailure(
+          message: '현재 비밀번호가 일치하지 않습니다.',
+          code: 'INVALID_CURRENT_PASSWORD',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('찾을 수 없')) {
+        return Left(ValidationFailure(
+          message: '사용자를 찾을 수 없습니다.',
+          code: 'USER_NOT_FOUND',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '비밀번호 재설정 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+
+  ValidationFailure? _validatePassword(String password) {
+    final errors = <String, String>{};
+
+    if (password.length < 8) {
+      errors['password'] = '비밀번호는 8자 이상이어야 합니다.';
+    }
+
+    if (!RegExp(r'^(?=.*[A-Za-z])(?=.*\d)').hasMatch(password)) {
+      errors['password'] = '비밀번호는 영문과 숫자를 포함해야 합니다.';
+    }
+
+    if (!RegExp(r'[!@#$%^&*(),.?":{}|<>]').hasMatch(password)) {
+      errors['password'] = '비밀번호는 특수문자를 포함해야 합니다.';
+    }
+
+    if (errors.isNotEmpty) {
+      return ValidationFailure(
+        message: '비밀번호가 보안 요구사항을 충족하지 않습니다.',
+        errors: errors,
+      );
+    }
+
+    return null;
+  }
+}

lib/domain/usecases/user/toggle_user_status_usecase.dart

@@ -0,0 +1,57 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../models/user_model.dart' as model;
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 상태 토글 파라미터
+class ToggleUserStatusParams {
+  final int id;
+
+  const ToggleUserStatusParams({
+    required this.id,
+  });
+}
+
+/// 사용자 활성화/비활성화 UseCase
+class ToggleUserStatusUseCase extends UseCase<model.User, ToggleUserStatusParams> {
+  final UserService _userService;
+
+  ToggleUserStatusUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, model.User>> call(ToggleUserStatusParams params) async {
+    try {
+      // 자기 자신 비활성화 방지
+      // 실제 구현에서는 현재 로그인한 사용자 ID와 비교
+      
+      final user = await _userService.toggleUserStatus(params.id);
+      return Right(user);
+    } catch (e) {
+      if (e.toString().contains('자신')) {
+        return Left(ValidationFailure(
+          message: '자기 자신은 비활성화할 수 없습니다.',
+          code: 'CANNOT_DEACTIVATE_SELF',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('찾을 수 없')) {
+        return Left(ValidationFailure(
+          message: '사용자를 찾을 수 없습니다.',
+          code: 'USER_NOT_FOUND',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '사용자 상태를 변경할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '사용자 상태 변경 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+}

lib/domain/usecases/user/update_user_usecase.dart

@@ -0,0 +1,110 @@
+import 'package:dartz/dartz.dart';
+import '../../../services/user_service.dart';
+import '../../../models/user_model.dart' as model;
+import '../../../core/constants/app_constants.dart';
+import '../../../core/errors/failures.dart';
+import '../base_usecase.dart';
+
+/// 사용자 수정 파라미터
+class UpdateUserParams {
+  final int id;
+  final String? email;
+  final String? name;
+  final String? role;
+  final int? companyId;
+  final String? phone;
+  final String? position;
+  final bool? isActive;
+
+  const UpdateUserParams({
+    required this.id,
+    this.email,
+    this.name,
+    this.role,
+    this.companyId,
+    this.phone,
+    this.position,
+    this.isActive,
+  });
+}
+
+/// 사용자 정보 수정 UseCase
+class UpdateUserUseCase extends UseCase<model.User, UpdateUserParams> {
+  final UserService _userService;
+
+  UpdateUserUseCase(this._userService);
+
+  @override
+  Future<Either<Failure, model.User>> call(UpdateUserParams params) async {
+    try {
+      // 유효성 검증
+      final validationResult = _validateUpdateInput(params);
+      if (validationResult != null) {
+        return Left(validationResult);
+      }
+
+      final user = await _userService.updateUser(
+        params.id,
+        email: params.email,
+        name: params.name,
+        role: params.role,
+        companyId: params.companyId,
+        phone: params.phone,
+        position: params.position,
+      );
+      
+      return Right(user);
+    } catch (e) {
+      if (e.toString().contains('찾을 수 없')) {
+        return Left(ValidationFailure(
+          message: '사용자를 찾을 수 없습니다.',
+          code: 'USER_NOT_FOUND',
+          originalError: e,
+        ));
+      } else if (e.toString().contains('권한')) {
+        return Left(PermissionFailure(
+          message: '사용자 정보를 수정할 권한이 없습니다.',
+          code: 'PERMISSION_DENIED',
+          originalError: e,
+        ));
+      } else {
+        return Left(ServerFailure(
+          message: '사용자 정보 수정 중 오류가 발생했습니다.',
+          originalError: e,
+        ));
+      }
+    }
+  }
+
+  ValidationFailure? _validateUpdateInput(UpdateUserParams params) {
+    final errors = <String, String>{};
+
+    // 이메일 검증 (제공된 경우)
+    if (params.email != null && params.email!.isNotEmpty) {
+      if (!AppConstants.emailRegex.hasMatch(params.email!)) {
+        errors['email'] = '올바른 이메일 형식이 아닙니다.';
+      }
+    }
+
+    // 역할 검증 (제공된 경우)
+    if (params.role != null && !['S', 'M', 'U', 'V'].contains(params.role)) {
+      errors['role'] = '올바른 역할을 선택해주세요.';
+    }
+
+    // 전화번호 검증 (제공된 경우)
+    if (params.phone != null && params.phone!.isNotEmpty) {
+      if (!AppConstants.phoneRegex.hasMatch(params.phone!)) {
+        errors['phone'] = '올바른 전화번호 형식이 아닙니다.';
+      }
+    }
+
+    if (errors.isNotEmpty) {
+      return ValidationFailure(
+        message: '입력값을 확인해주세요.',
+        errors: errors,
+      );
+    }
+
+    return null;
+  }
+}

lib/domain/usecases/user/user_usecases.dart

@@ -0,0 +1,8 @@
+/// User 도메인 UseCase 모음
+export 'get_users_usecase.dart';
+export 'create_user_usecase.dart';
+export 'update_user_usecase.dart';
+export 'delete_user_usecase.dart';
+export 'get_user_detail_usecase.dart';
+export 'reset_password_usecase.dart';
+export 'toggle_user_status_usecase.dart';