feat: Equipment DTO 호환성 수정 전 백업 커밋

- Equipment DTO 필드명 변경 (name → equipment_number 등) 완료
- Phase 1-7 파생 수정사항 체계적 진행 예정
- 통합 모델 정리, Controller 동기화, UI 업데이트 예정

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
JiWoong Sul
2025-08-21 19:17:43 +09:00
parent ca830063f0
commit c141c0b914
18 changed files with 2132 additions and 3202 deletions

View File

@@ -7,6 +7,7 @@ import 'package:superport/core/errors/failures.dart';
import 'package:superport/core/utils/debug_logger.dart';
import 'package:superport/data/datasources/remote/lookup_remote_datasource.dart';
import 'package:superport/data/models/lookups/lookup_data.dart';
import 'dart:async' show unawaited;
/// 전역 Lookups 캐싱 서비스 (Singleton 패턴)
@LazySingleton()
@@ -133,14 +134,30 @@ class LookupsService {
);
}
/// 장비 카테고리 목록 조회
Either<Failure, List<CategoryItem>> getEquipmentCategories() {
/// 장비 카테고리 조합 목록 조회
Either<Failure, List<CategoryCombinationItem>> getEquipmentCategories() {
return getAllLookups().fold(
(failure) => Left(failure),
(data) => Right(data.equipmentCategories),
);
}
/// 회사 목록 조회
Either<Failure, List<LookupItem>> getCompanies() {
return getAllLookups().fold(
(failure) => Left(failure),
(data) => Right(data.companies),
);
}
/// 창고 목록 조회
Either<Failure, List<LookupItem>> getWarehouses() {
return getAllLookups().fold(
(failure) => Left(failure),
(data) => Right(data.warehouses),
);
}
/// 장비 상태 목록 조회
Either<Failure, List<StatusItem>> getEquipmentStatuses() {
return getAllLookups().fold(
@@ -179,6 +196,62 @@ class LookupsService {
);
}
/// Equipment 폼용 매번 API 호출 메서드 (캐싱 없이)
Future<Either<Failure, LookupData>> getLookupDataForEquipmentForm() async {
DebugLogger.log('Equipment 폼용 Lookups 데이터 API 호출', tag: 'LOOKUPS');
return await _dataSource.getAllLookups();
}
/// 대분류 목록 추출 (Equipment 폼용)
Future<Either<Failure, List<String>>> getCategory1List() async {
final result = await getLookupDataForEquipmentForm();
return result.fold(
(failure) => Left(failure),
(data) {
final category1List = data.equipmentCategories
.map((item) => item.category1)
.toSet()
.toList()
..sort();
return Right(category1List);
},
);
}
/// 중분류 목록 추출 (Equipment 폼용)
Future<Either<Failure, List<String>>> getCategory2List(String category1) async {
final result = await getLookupDataForEquipmentForm();
return result.fold(
(failure) => Left(failure),
(data) {
final category2List = data.equipmentCategories
.where((item) => item.category1 == category1)
.map((item) => item.category2)
.toSet()
.toList()
..sort();
return Right(category2List);
},
);
}
/// 소분류 목록 추출 (Equipment 폼용)
Future<Either<Failure, List<String>>> getCategory3List(String category1, String category2) async {
final result = await getLookupDataForEquipmentForm();
return result.fold(
(failure) => Left(failure),
(data) {
final category3List = data.equipmentCategories
.where((item) => item.category1 == category1 && item.category2 == category2)
.map((item) => item.category3)
.toSet()
.toList()
..sort();
return Right(category3List);
},
);
}
/// 캐시 통계 정보
Map<String, dynamic> getCacheStats() {
return {
@@ -191,6 +264,8 @@ class LookupsService {
'equipment_names_count': _cachedData?.equipmentNames.length ?? 0,
'equipment_categories_count': _cachedData?.equipmentCategories.length ?? 0,
'equipment_statuses_count': _cachedData?.equipmentStatuses.length ?? 0,
'companies_count': _cachedData?.companies.length ?? 0,
'warehouses_count': _cachedData?.warehouses.length ?? 0,
};
}
@@ -212,8 +287,10 @@ extension LookupsServiceExtensions on LookupsService {
(failure) => Left(failure),
(manufacturers) {
final Map<int, String> items = {};
for (final manufacturer in manufacturers) {
items[manufacturer.id] = manufacturer.name;
for (int i = 0; i < manufacturers.length; i++) {
final manufacturer = manufacturers[i];
final id = manufacturer.id ?? (i + 1); // id가 null이면 인덱스 기반 ID 사용
items[id] = manufacturer.name;
}
return Right(items);
},
@@ -233,4 +310,51 @@ extension LookupsServiceExtensions on LookupsService {
},
);
}
/// Equipment 폼용 드롭다운 리스트 생성 (매번 API 호출)
Future<Either<Failure, Map<String, dynamic>>> getEquipmentFormDropdownData() async {
final result = await getLookupDataForEquipmentForm();
return result.fold(
(failure) => Left(failure),
(data) {
// 제조사 리스트 (드롭다운 + 직접입력용)
final List<String> manufacturers = data.manufacturers.map((item) => item.name).toList();
// 장비명 리스트 (드롭다운 + 직접입력용)
final List<String> equipmentNames = data.equipmentNames.map((item) => item.name).toList();
// 회사 리스트 (드롭다운 전용)
final Map<int, String> companies = {};
for (final company in data.companies) {
if (company.id != null) {
companies[company.id!] = company.name;
}
}
// 창고 리스트 (드롭다운 전용)
final Map<int, String> warehouses = {};
for (final warehouse in data.warehouses) {
if (warehouse.id != null) {
warehouses[warehouse.id!] = warehouse.name;
}
}
// 대분류 리스트 (드롭다운 + 직접입력용)
final List<String> category1List = data.equipmentCategories
.map((item) => item.category1)
.toSet()
.toList()
..sort();
return Right({
'manufacturers': manufacturers,
'equipment_names': equipmentNames,
'companies': companies,
'warehouses': warehouses,
'category1_list': category1List,
'category_combinations': data.equipmentCategories,
});
},
);
}
}

View File

@@ -0,0 +1,385 @@
import 'package:flutter/material.dart';
import 'package:superport/core/services/lookups_service.dart';
import 'package:get_it/get_it.dart';
import 'package:superport/core/utils/debug_logger.dart';
/// 3단계 카테고리 연동 선택 위젯
///
/// 대분류 → 중분류 → 소분류 순서로 연동 선택
/// - 상위 선택 시 하위 자동 로딩
/// - 직접입력과 드롭다운 선택 모두 지원
/// - 백엔드 API 조합 데이터 기반
class CategoryCascadeFormField extends StatefulWidget {
final String? category1;
final String? category2;
final String? category3;
final void Function(String?, String?, String?) onChanged;
final bool enabled;
final String? Function(String?)? category1Validator;
final String? Function(String?)? category2Validator;
final String? Function(String?)? category3Validator;
const CategoryCascadeFormField({
super.key,
this.category1,
this.category2,
this.category3,
required this.onChanged,
this.enabled = true,
this.category1Validator,
this.category2Validator,
this.category3Validator,
});
@override
State<CategoryCascadeFormField> createState() => _CategoryCascadeFormFieldState();
}
class _CategoryCascadeFormFieldState extends State<CategoryCascadeFormField> {
final LookupsService _lookupsService = GetIt.instance<LookupsService>();
late TextEditingController _category1Controller;
late TextEditingController _category2Controller;
late TextEditingController _category3Controller;
List<String> _category1Options = [];
List<String> _category2Options = [];
List<String> _category3Options = [];
bool _isLoadingCategory2 = false;
bool _isLoadingCategory3 = false;
@override
void initState() {
super.initState();
_category1Controller = TextEditingController(text: widget.category1 ?? '');
_category2Controller = TextEditingController(text: widget.category2 ?? '');
_category3Controller = TextEditingController(text: widget.category3 ?? '');
_loadCategory1Options();
// 초기값이 있는 경우 하위 카테고리 로딩
if (widget.category1 != null && widget.category1!.isNotEmpty) {
_loadCategory2Options(widget.category1!);
if (widget.category2 != null && widget.category2!.isNotEmpty) {
_loadCategory3Options(widget.category1!, widget.category2!);
}
}
}
@override
void didUpdateWidget(CategoryCascadeFormField oldWidget) {
super.didUpdateWidget(oldWidget);
// 외부에서 값이 변경된 경우 컨트롤러 업데이트
if (widget.category1 != oldWidget.category1) {
_category1Controller.text = widget.category1 ?? '';
}
if (widget.category2 != oldWidget.category2) {
_category2Controller.text = widget.category2 ?? '';
}
if (widget.category3 != oldWidget.category3) {
_category3Controller.text = widget.category3 ?? '';
}
}
@override
void dispose() {
_category1Controller.dispose();
_category2Controller.dispose();
_category3Controller.dispose();
super.dispose();
}
Future<void> _loadCategory1Options() async {
try {
final result = await _lookupsService.getCategory1List();
result.fold(
(failure) {
DebugLogger.logError('대분류 로딩 실패', error: failure.message);
if (mounted) {
setState(() {
_category1Options = [];
});
}
},
(categories) {
if (mounted) {
setState(() {
_category1Options = categories;
});
}
},
);
} catch (e) {
DebugLogger.logError('대분류 로딩 예외', error: e);
if (mounted) {
setState(() {
_category1Options = [];
});
}
}
}
Future<void> _loadCategory2Options(String category1) async {
if (category1.isEmpty) {
setState(() {
_category2Options = [];
});
return;
}
setState(() {
_isLoadingCategory2 = true;
});
try {
final result = await _lookupsService.getCategory2List(category1);
result.fold(
(failure) {
DebugLogger.logError('중분류 로딩 실패', error: failure.message);
if (mounted) {
setState(() {
_category2Options = [];
_isLoadingCategory2 = false;
});
}
},
(categories) {
if (mounted) {
setState(() {
_category2Options = categories;
_isLoadingCategory2 = false;
});
}
},
);
} catch (e) {
DebugLogger.logError('중분류 로딩 예외', error: e);
if (mounted) {
setState(() {
_category2Options = [];
_isLoadingCategory2 = false;
});
}
}
}
Future<void> _loadCategory3Options(String category1, String category2) async {
if (category1.isEmpty || category2.isEmpty) {
setState(() {
_category3Options = [];
});
return;
}
setState(() {
_isLoadingCategory3 = true;
});
try {
final result = await _lookupsService.getCategory3List(category1, category2);
result.fold(
(failure) {
DebugLogger.logError('소분류 로딩 실패', error: failure.message);
if (mounted) {
setState(() {
_category3Options = [];
_isLoadingCategory3 = false;
});
}
},
(categories) {
if (mounted) {
setState(() {
_category3Options = categories;
_isLoadingCategory3 = false;
});
}
},
);
} catch (e) {
DebugLogger.logError('소분류 로딩 예외', error: e);
if (mounted) {
setState(() {
_category3Options = [];
_isLoadingCategory3 = false;
});
}
}
}
void _onCategory1Changed(String? value) {
// 대분류 변경 시 중분류, 소분류 초기화
_category2Controller.clear();
_category3Controller.clear();
_category2Options.clear();
_category3Options.clear();
// 새로운 대분류에 대한 중분류 로딩
if (value != null && value.isNotEmpty) {
_loadCategory2Options(value);
}
// 변경 알림
widget.onChanged(value, null, null);
}
void _onCategory2Changed(String? value) {
// 중분류 변경 시 소분류 초기화
_category3Controller.clear();
_category3Options.clear();
// 새로운 중분류에 대한 소분류 로딩
final category1 = _category1Controller.text;
if (category1.isNotEmpty && value != null && value.isNotEmpty) {
_loadCategory3Options(category1, value);
}
// 변경 알림
widget.onChanged(_category1Controller.text, value, null);
}
void _onCategory3Changed(String? value) {
// 변경 알림
widget.onChanged(
_category1Controller.text,
_category2Controller.text,
value,
);
}
Widget _buildComboBox({
required String labelText,
required TextEditingController controller,
required List<String> options,
required void Function(String?) onChanged,
String? Function(String?)? validator,
bool isLoading = false,
}) {
// 드롭다운 선택 가능한 값 (현재 텍스트가 옵션에 있으면 선택)
String? selectedValue;
if (controller.text.isNotEmpty && options.contains(controller.text)) {
selectedValue = controller.text;
}
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// 드롭다운 선택
if (options.isNotEmpty && !isLoading)
DropdownButtonFormField<String>(
value: selectedValue,
items: options.map((option) {
return DropdownMenuItem<String>(
value: option,
child: Text(option),
);
}).toList(),
onChanged: widget.enabled ? (value) {
if (value != null) {
controller.text = value;
onChanged(value);
}
} : null,
decoration: InputDecoration(
labelText: '$labelText (선택)',
hintText: '$labelText를 선택하세요',
border: const OutlineInputBorder(),
enabledBorder: OutlineInputBorder(
borderSide: BorderSide(color: Colors.grey.shade400),
),
focusedBorder: OutlineInputBorder(
borderSide: BorderSide(color: Theme.of(context).primaryColor),
),
),
validator: validator,
),
// 로딩 표시
if (isLoading)
Container(
height: 56,
decoration: BoxDecoration(
border: Border.all(color: Colors.grey.shade400),
borderRadius: BorderRadius.circular(4),
),
child: const Center(
child: Row(
mainAxisAlignment: MainAxisAlignment.center,
children: [
SizedBox(
width: 20,
height: 20,
child: CircularProgressIndicator(strokeWidth: 2),
),
SizedBox(width: 8),
Text('로딩 중...'),
],
),
),
),
// 옵션이 없을 때
if (options.isEmpty && !isLoading)
TextFormField(
controller: controller,
enabled: widget.enabled,
validator: validator,
onChanged: onChanged,
decoration: InputDecoration(
labelText: '$labelText (직접입력)',
hintText: '$labelText를 직접 입력하세요',
border: const OutlineInputBorder(),
enabledBorder: OutlineInputBorder(
borderSide: BorderSide(color: Colors.grey.shade400),
),
focusedBorder: OutlineInputBorder(
borderSide: BorderSide(color: Theme.of(context).primaryColor),
),
),
),
],
);
}
@override
Widget build(BuildContext context) {
return Column(
children: [
// 대분류
_buildComboBox(
labelText: '대분류',
controller: _category1Controller,
options: _category1Options,
onChanged: _onCategory1Changed,
validator: widget.category1Validator,
),
const SizedBox(height: 16),
// 중분류
_buildComboBox(
labelText: '중분류',
controller: _category2Controller,
options: _category2Options,
onChanged: _onCategory2Changed,
validator: widget.category2Validator,
isLoading: _isLoadingCategory2,
),
const SizedBox(height: 16),
// 소분류
_buildComboBox(
labelText: '소분류',
controller: _category3Controller,
options: _category3Options,
onChanged: _onCategory3Changed,
validator: widget.category3Validator,
isLoading: _isLoadingCategory3,
),
],
);
}
}