Files
superport/lib/screens/common/widgets/address_input.dart
JiWoong Sul 162fe08618
Some checks failed
Flutter Test & Quality Check / Test on macos-latest (push) Has been cancelled
Flutter Test & Quality Check / Test on ubuntu-latest (push) Has been cancelled
Flutter Test & Quality Check / Build APK (push) Has been cancelled
refactor: Clean Architecture 적용 및 코드베이스 전면 리팩토링
## 주요 변경사항

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

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

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

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

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

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

## 향후 계획
- 단위 테스트 커버리지 확대
- 통합 테스트 시나리오 추가
- 성능 모니터링 도구 통합
2025-08-11 00:04:28 +09:00

278 lines
9.2 KiB
Dart

import 'package:flutter/material.dart';
import 'package:superport/screens/common/custom_widgets.dart';
import 'package:superport/screens/common/theme_tailwind.dart';
import 'package:superport/utils/address_constants.dart';
import 'package:superport/models/address_model.dart';
/// 주소 입력 컴포넌트
///
/// 우편번호, 시/도 드롭다운, 상세주소로 구성된 주소 입력 폼입니다.
/// 1행 3열 구조로 배치되어 있으며, 각 필드는 SRP 원칙에 따라 개별적으로 관리됩니다.
class AddressInput extends StatefulWidget {
/// 최초 우편번호 값
final String initialZipCode;
/// 최초 시/도 값
final String initialRegion;
/// 최초 상세 주소 값
final String initialDetailAddress;
/// 주소가 변경될 때 호출되는 콜백 함수
/// zipCode, region, detailAddress를 매개변수로 전달합니다.
final Function(String zipCode, String region, String detailAddress)
onAddressChanged;
/// 필수 입력 여부
final bool isRequired;
const AddressInput({
Key? key,
this.initialZipCode = '',
this.initialRegion = '',
this.initialDetailAddress = '',
required this.onAddressChanged,
this.isRequired = false,
}) : super(key: key);
@override
State<AddressInput> createState() => _AddressInputState();
/// Address 객체를 받아 읽기 전용으로 표시하는 위젯
static Widget readonly({required Address address}) {
// 회사 리스트와 동일하게 address.toString() 사용, 스타일도 bodyStyle로 통일
return Text(address.toString(), style: AppThemeTailwind.bodyStyle);
}
}
class _AddressInputState extends State<AddressInput> {
// 텍스트 컨트롤러
late TextEditingController _zipCodeController;
late TextEditingController _detailAddressController;
// 드롭다운 관련 변수
String _selectedRegion = '';
bool _showRegionDropdown = false;
// 레이어 링크 (드롭다운 위치 조정용)
final LayerLink _regionLayerLink = LayerLink();
// 오버레이 엔트리 (드롭다운 메뉴)
OverlayEntry? _regionOverlayEntry;
// 포커스 노드
final FocusNode _regionFocusNode = FocusNode();
@override
void initState() {
super.initState();
_zipCodeController = TextEditingController(text: widget.initialZipCode);
_selectedRegion = widget.initialRegion;
_detailAddressController = TextEditingController(
text: widget.initialDetailAddress,
);
// 컨트롤러 변경 리스너 등록
_zipCodeController.addListener(_notifyAddressChanged);
_detailAddressController.addListener(_notifyAddressChanged);
}
@override
void dispose() {
_zipCodeController.dispose();
_detailAddressController.dispose();
_removeRegionOverlay();
_regionFocusNode.dispose();
super.dispose();
}
/// 주소 변경을 상위 위젯에 알립니다.
void _notifyAddressChanged() {
widget.onAddressChanged(
_zipCodeController.text,
_selectedRegion,
_detailAddressController.text,
);
}
/// 시/도 드롭다운을 토글합니다.
void _toggleRegionDropdown() {
setState(() {
if (_showRegionDropdown) {
_removeRegionOverlay();
} else {
_showRegionDropdown = true;
_showRegionOverlay();
}
});
}
/// 시/도 드롭다운 오버레이를 제거합니다.
void _removeRegionOverlay() {
_regionOverlayEntry?.remove();
_regionOverlayEntry = null;
_showRegionDropdown = false;
}
/// 시/도 드롭다운 오버레이를 표시합니다.
void _showRegionOverlay() {
final RenderBox renderBox = context.findRenderObject() as RenderBox;
final offset = renderBox.localToGlobal(Offset.zero);
final availableHeight =
MediaQuery.of(context).size.height - offset.dy - 100;
final maxHeight = 300.0 < availableHeight ? 300.0 : availableHeight;
_regionOverlayEntry = OverlayEntry(
builder:
(context) => Positioned(
width: 200,
child: CompositedTransformFollower(
link: _regionLayerLink,
showWhenUnlinked: false,
offset: const Offset(0, 45),
child: Material(
elevation: 4,
borderRadius: BorderRadius.circular(4),
child: Container(
decoration: BoxDecoration(
color: Colors.white,
border: Border.all(color: Colors.grey.shade300),
borderRadius: BorderRadius.circular(4),
boxShadow: [
BoxShadow(
color: Colors.grey.withValues(alpha: 0.3),
spreadRadius: 1,
blurRadius: 3,
offset: const Offset(0, 1),
),
],
),
constraints: BoxConstraints(maxHeight: maxHeight),
child: SingleChildScrollView(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
...KoreanRegions.topLevel.map(
(region) => InkWell(
onTap: () {
setState(() {
_selectedRegion = region;
_removeRegionOverlay();
_notifyAddressChanged();
});
},
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 16,
vertical: 12,
),
width: double.infinity,
height: 48,
child: Text(
region,
style: AppThemeTailwind.bodyStyle.copyWith(
fontSize: 16,
),
),
),
),
),
],
),
),
),
),
),
),
);
Overlay.of(context).insert(_regionOverlayEntry!);
}
@override
Widget build(BuildContext context) {
return FormFieldWrapper(
label: '주소',
isRequired: widget.isRequired,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// 우편번호 입력 필드 (1열)
Expanded(
flex: 2,
child: TextField(
controller: _zipCodeController,
decoration: InputDecoration(
hintText: AddressLabels.zipCodeHint,
labelText: AddressLabels.zipCode,
border: const OutlineInputBorder(),
),
),
),
const SizedBox(width: 8),
// 시/도 선택 드롭다운 (2열)
Expanded(
flex: 3,
child: CompositedTransformTarget(
link: _regionLayerLink,
child: InkWell(
onTap: _toggleRegionDropdown,
child: Container(
padding: const EdgeInsets.symmetric(
horizontal: 12,
vertical: 0,
),
height: 48,
decoration: BoxDecoration(
border: Border.all(color: Colors.grey.shade400),
borderRadius: BorderRadius.circular(4),
),
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Text(
_selectedRegion.isEmpty
? AddressLabels.regionHint
: _selectedRegion,
style: TextStyle(
fontSize: 16,
color:
_selectedRegion.isEmpty
? Colors.grey.shade600
: Colors.black,
),
),
const Icon(Icons.arrow_drop_down),
],
),
),
),
),
),
const SizedBox(width: 8),
// 상세 주소 입력 필드 (3열)
Expanded(
flex: 7,
child: TextField(
controller: _detailAddressController,
decoration: InputDecoration(
hintText: AddressLabels.detailHint,
labelText: AddressLabels.detail,
border: const OutlineInputBorder(),
),
),
),
],
),
],
),
);
}
}