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>
This commit is contained in:
JiWoong Sul
@@ -1,100 +1,175 @@
|
||||
class User {
|
||||
final int? id;
|
||||
final int companyId;
|
||||
final int? branchId; // 지점 ID
|
||||
final String name;
|
||||
final String role; // 관리등급: S(관리자), M(멤버)
|
||||
final String? position; // 직급
|
||||
final String? email; // 이메일
|
||||
final List<Map<String, String>> phoneNumbers; // 전화번호 목록 (유형과 번호)
|
||||
final String? username; // 사용자명 (API 연동용)
|
||||
final bool isActive; // 활성화 상태
|
||||
final DateTime? createdAt; // 생성일
|
||||
final DateTime? updatedAt; // 수정일
|
||||
import 'package:freezed_annotation/freezed_annotation.dart';
|
||||
|
||||
User({
|
||||
this.id,
|
||||
required this.companyId,
|
||||
this.branchId,
|
||||
required this.name,
|
||||
required this.role,
|
||||
this.position,
|
||||
this.email,
|
||||
this.phoneNumbers = const [],
|
||||
this.username,
|
||||
this.isActive = true,
|
||||
this.createdAt,
|
||||
this.updatedAt,
|
||||
});
|
||||
part 'user_model.freezed.dart';
|
||||
part 'user_model.g.dart';
|
||||
|
||||
Map<String, dynamic> toJson() {
|
||||
return {
|
||||
'id': id,
|
||||
'companyId': companyId,
|
||||
'branchId': branchId,
|
||||
'name': name,
|
||||
'role': role,
|
||||
'position': position,
|
||||
'email': email,
|
||||
'phoneNumbers': phoneNumbers,
|
||||
'username': username,
|
||||
'isActive': isActive,
|
||||
'createdAt': createdAt?.toIso8601String(),
|
||||
'updatedAt': updatedAt?.toIso8601String(),
|
||||
};
|
||||
}
|
||||
|
||||
factory User.fromJson(Map<String, dynamic> json) {
|
||||
return User(
|
||||
id: json['id'],
|
||||
companyId: json['companyId'],
|
||||
branchId: json['branchId'],
|
||||
name: json['name'],
|
||||
role: json['role'],
|
||||
position: json['position'],
|
||||
email: json['email'],
|
||||
phoneNumbers:
|
||||
json['phoneNumbers'] != null
|
||||
? List<Map<String, String>>.from(json['phoneNumbers'])
|
||||
: [],
|
||||
username: json['username'],
|
||||
isActive: json['isActive'] ?? true,
|
||||
createdAt: json['createdAt'] != null
|
||||
? DateTime.parse(json['createdAt'])
|
||||
: null,
|
||||
updatedAt: json['updatedAt'] != null
|
||||
? DateTime.parse(json['updatedAt'])
|
||||
: null,
|
||||
);
|
||||
}
|
||||
|
||||
User copyWith({
|
||||
/// 사용자 도메인 엔티티 (서버 API v0.2.1 스키마 대응)
|
||||
/// 권한: admin(관리자), manager(매니저), staff(직원)
|
||||
@freezed
|
||||
class User with _$User {
|
||||
const factory User({
|
||||
/// 사용자 ID (자동 생성)
|
||||
int? id,
|
||||
int? companyId,
|
||||
int? branchId,
|
||||
String? name,
|
||||
String? role,
|
||||
String? position,
|
||||
String? email,
|
||||
List<Map<String, String>>? phoneNumbers,
|
||||
String? username,
|
||||
bool? isActive,
|
||||
|
||||
/// 사용자명 (로그인용, 필수, 유니크, 3자 이상)
|
||||
required String username,
|
||||
|
||||
/// 이메일 (필수, 유니크)
|
||||
required String email,
|
||||
|
||||
/// 이름 (필수)
|
||||
required String name,
|
||||
|
||||
/// 전화번호 (선택, "010-1234-5678" 형태)
|
||||
String? phone,
|
||||
|
||||
/// 권한 (필수: admin, manager, staff)
|
||||
required UserRole role,
|
||||
|
||||
/// 활성화 상태 (기본값: true)
|
||||
@Default(true) bool isActive,
|
||||
|
||||
/// 생성일시 (자동 입력)
|
||||
DateTime? createdAt,
|
||||
|
||||
/// 수정일시 (자동 갱신)
|
||||
DateTime? updatedAt,
|
||||
}) {
|
||||
return User(
|
||||
id: id ?? this.id,
|
||||
companyId: companyId ?? this.companyId,
|
||||
branchId: branchId ?? this.branchId,
|
||||
name: name ?? this.name,
|
||||
role: role ?? this.role,
|
||||
position: position ?? this.position,
|
||||
email: email ?? this.email,
|
||||
phoneNumbers: phoneNumbers ?? this.phoneNumbers,
|
||||
username: username ?? this.username,
|
||||
isActive: isActive ?? this.isActive,
|
||||
createdAt: createdAt ?? this.createdAt,
|
||||
updatedAt: updatedAt ?? this.updatedAt,
|
||||
);
|
||||
}) = _User;
|
||||
|
||||
factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);
|
||||
}
|
||||
|
||||
/// 사용자 권한 열거형 (서버 API 스키마 대응)
|
||||
@JsonEnum()
|
||||
enum UserRole {
|
||||
/// 관리자 - 전체 시스템 관리 권한
|
||||
@JsonValue('admin')
|
||||
admin,
|
||||
|
||||
/// 매니저 - 중간 관리 권한
|
||||
@JsonValue('manager')
|
||||
manager,
|
||||
|
||||
/// 직원 - 기본 사용 권한
|
||||
@JsonValue('staff')
|
||||
staff;
|
||||
|
||||
/// 권한 한글명 반환
|
||||
String get displayName {
|
||||
switch (this) {
|
||||
case UserRole.admin:
|
||||
return '관리자';
|
||||
case UserRole.manager:
|
||||
return '매니저';
|
||||
case UserRole.staff:
|
||||
return '직원';
|
||||
}
|
||||
}
|
||||
|
||||
/// 권한 레벨 반환 (높을수록 상위 권한)
|
||||
int get level {
|
||||
switch (this) {
|
||||
case UserRole.admin:
|
||||
return 3;
|
||||
case UserRole.manager:
|
||||
return 2;
|
||||
case UserRole.staff:
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
/// 문자열로부터 UserRole 생성
|
||||
static UserRole fromString(String value) {
|
||||
switch (value.toLowerCase()) {
|
||||
case 'admin':
|
||||
return UserRole.admin;
|
||||
case 'manager':
|
||||
return UserRole.manager;
|
||||
case 'staff':
|
||||
return UserRole.staff;
|
||||
default:
|
||||
throw ArgumentError('Unknown user role: $value');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 레거시 권한 시스템 호환성 유틸리티
|
||||
/// 기존 S/M 코드와의 호환성을 위해 임시 유지
|
||||
class LegacyUserRoles {
|
||||
static const String admin = 'S'; // 관리자 (삭제 예정)
|
||||
static const String member = 'M'; // 멤버 (삭제 예정)
|
||||
|
||||
/// 레거시 권한을 새 권한으로 변환
|
||||
static UserRole toLegacyRole(String legacyRole) {
|
||||
switch (legacyRole) {
|
||||
case 'S':
|
||||
return UserRole.admin;
|
||||
case 'M':
|
||||
return UserRole.staff;
|
||||
default:
|
||||
return UserRole.staff;
|
||||
}
|
||||
}
|
||||
|
||||
/// 새 권한을 레거시 권한으로 변환 (임시)
|
||||
static String fromLegacyRole(UserRole role) {
|
||||
switch (role) {
|
||||
case UserRole.admin:
|
||||
return 'S';
|
||||
case UserRole.manager:
|
||||
case UserRole.staff:
|
||||
return 'M';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 전화번호 유틸리티
|
||||
class PhoneNumberUtil {
|
||||
/// 전화번호 형식 검증 (010-1234-5678)
|
||||
static bool isValidFormat(String phone) {
|
||||
final regex = RegExp(r'^\d{3}-\d{3,4}-\d{4}$');
|
||||
return regex.hasMatch(phone);
|
||||
}
|
||||
|
||||
/// 전화번호 포맷팅 (01012345678 → 010-1234-5678)
|
||||
static String format(String phone) {
|
||||
final cleanPhone = phone.replaceAll(RegExp(r'[^\d]'), '');
|
||||
if (cleanPhone.length == 10) {
|
||||
return '${cleanPhone.substring(0, 3)}-${cleanPhone.substring(3, 6)}-${cleanPhone.substring(6)}';
|
||||
} else if (cleanPhone.length == 11) {
|
||||
return '${cleanPhone.substring(0, 3)}-${cleanPhone.substring(3, 7)}-${cleanPhone.substring(7)}';
|
||||
}
|
||||
return phone; // 형식이 맞지 않으면 원본 반환
|
||||
}
|
||||
|
||||
/// UI용 전화번호 분리 (010-1234-5678 → {prefix: "010", number: "12345678"})
|
||||
static Map<String, String> splitForUI(String? phone) {
|
||||
if (phone == null || phone.isEmpty) {
|
||||
return {'prefix': '010', 'number': ''};
|
||||
}
|
||||
|
||||
final parts = phone.split('-');
|
||||
if (parts.length >= 2) {
|
||||
return {
|
||||
'prefix': parts[0],
|
||||
'number': parts.sublist(1).join(''),
|
||||
};
|
||||
}
|
||||
|
||||
return {'prefix': '010', 'number': phone};
|
||||
}
|
||||
|
||||
/// UI에서 서버용 전화번호 조합 ({prefix: "010", number: "12345678"} → "010-1234-5678")
|
||||
static String combineFromUI(String prefix, String number) {
|
||||
if (number.isEmpty) return '';
|
||||
|
||||
final cleanNumber = number.replaceAll(RegExp(r'[^\d]'), '');
|
||||
if (cleanNumber.length == 7) {
|
||||
return '$prefix-${cleanNumber.substring(0, 3)}-${cleanNumber.substring(3)}';
|
||||
} else if (cleanNumber.length == 8) {
|
||||
return '$prefix-${cleanNumber.substring(0, 4)}-${cleanNumber.substring(4)}';
|
||||
}
|
||||
|
||||
return '$prefix-$cleanNumber';
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user