refactor: 회사 폼 UI 개선 및 코드 정리
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

- 담당자 연락처 필드를 드롭다운 + 입력 방식으로 분리
- 사용자 폼과 동일한 전화번호 UI 패턴 적용
- 미사용 위젯 파일 4개 정리 (branch_card, contact_info_* 등)
- 파일명 통일성 확보 (branch_edit_screen → branch_form, company_form_simplified → company_form)
- 네이밍 일관성 개선으로 유지보수성 향상
This commit is contained in:
JiWoong Sul
2025-08-18 17:57:16 +09:00
parent 93bceb8a6c
commit 6d745051b5
37 changed files with 2743 additions and 2446 deletions

View File

@@ -1,299 +1,116 @@
/// 회사 등록 및 수정 화면
///
/// SRP(단일 책임 원칙)에 따라 컴포넌트를 분리하여 구현한 리팩토링 버전
/// - 컨트롤러: CompanyFormController - 비즈니스 로직 담당
/// - 위젯:
/// - CompanyFormHeader: 회사명 및 주소 입력
/// - ContactInfoForm: 담당자 정보 입력
/// - BranchCard: 지점 정보 카드
/// - CompanyNameAutocomplete: 회사명 자동완성
/// - MapDialog: 지도 다이얼로그
/// - DuplicateCompanyDialog: 중복 회사 확인 다이얼로그
/// - CompanyTypeSelector: 회사 유형 선택 라디오 버튼
/// - 유틸리티:
/// - PhoneUtils: 전화번호 관련 유틸리티
import 'package:flutter/material.dart';
// import 'package:superport/models/address_model.dart'; // 사용되지 않는 import
import 'package:flutter/services.dart';
import 'package:provider/provider.dart';
import 'package:superport/models/company_model.dart';
// import 'package:superport/screens/common/custom_widgets.dart'; // 사용되지 않는 import
import 'package:superport/models/address_model.dart';
import 'package:superport/screens/common/theme_shadcn.dart';
import 'package:superport/screens/common/templates/form_layout_template.dart';
import 'package:superport/screens/company/controllers/company_form_controller.dart';
// import 'package:superport/screens/company/widgets/branch_card.dart'; // 사용되지 않는 import
import 'package:superport/screens/company/widgets/company_form_header.dart';
import 'package:superport/screens/company/widgets/contact_info_form.dart';
import 'package:superport/screens/company/widgets/duplicate_company_dialog.dart';
import 'package:superport/screens/company/widgets/map_dialog.dart';
import 'package:superport/screens/company/widgets/branch_form_widget.dart';
// import 'package:superport/services/mock_data_service.dart'; // Mock 서비스 제거
import 'dart:async';
import 'dart:math' as math;
import 'package:superport/screens/company/controllers/branch_form_controller.dart';
import 'package:superport/core/config/environment.dart' as env;
/// 회사 유형 선택 위젯 (체크박스)
class CompanyTypeSelector extends StatelessWidget {
final List<CompanyType> selectedTypes;
final Function(CompanyType, bool) onTypeChanged;
const CompanyTypeSelector({
Key? key,
required this.selectedTypes,
required this.onTypeChanged,
}) : super(key: key);
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.only(bottom: 16.0),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text('회사 유형', style: ShadcnTheme.labelMedium),
const SizedBox(height: 8),
Row(
children: [
// 고객사 체크박스
Checkbox(
value: selectedTypes.contains(CompanyType.customer),
onChanged: (checked) {
onTypeChanged(CompanyType.customer, checked ?? false);
},
),
const Text('고객사'),
const SizedBox(width: 24),
// 파트너사 체크박스
Checkbox(
value: selectedTypes.contains(CompanyType.partner),
onChanged: (checked) {
onTypeChanged(CompanyType.partner, checked ?? false);
},
),
const Text('파트너사'),
],
),
],
),
);
}
}
import 'package:superport/utils/validators.dart';
import 'package:superport/utils/phone_utils.dart';
/// 회사 등록/수정 화면
/// User/Warehouse Location 화면과 동일한 FormFieldWrapper 패턴 사용
class CompanyFormScreen extends StatefulWidget {
final Map? args;
const CompanyFormScreen({Key? key, this.args}) : super(key: key);
@override
_CompanyFormScreenState createState() => _CompanyFormScreenState();
State<CompanyFormScreen> createState() => _CompanyFormScreenState();
}
class _CompanyFormScreenState extends State<CompanyFormScreen> {
late CompanyFormController _controller;
bool isBranch = false;
String? mainCompanyName;
final TextEditingController _addressController = TextEditingController();
final TextEditingController _phoneNumberController = TextEditingController();
int? companyId;
int? branchId;
bool isBranch = false;
// 전화번호 관련 변수
String _selectedPhonePrefix = '010';
List<String> _phonePrefixes = PhoneUtils.getCommonPhonePrefixes();
@override
void initState() {
super.initState();
// controller는 didChangeDependencies에서 초기화
}
@override
void didChangeDependencies() {
super.didChangeDependencies();
// arguments 처리
final args = widget.args;
if (args != null) {
isBranch = args['isBranch'] ?? false;
mainCompanyName = args['mainCompanyName'];
companyId = args['companyId'];
branchId = args['branchId'];
isBranch = args['isBranch'] ?? false;
}
// API 모드 확인
final useApi = env.Environment.useApi;
debugPrint('📌 회사 폼 초기화 - API 모드: $useApi, companyId: $companyId');
_controller = CompanyFormController(
companyId: companyId,
useApi: true, // 항상 API 사용
useApi: true,
);
// 일반 회사 수정 모드일 때 데이터 로드
if (!isBranch && companyId != null) {
debugPrint('📌 회사 데이터 로드 시작...');
// 수정 모드일 때 데이터 로드
if (companyId != null && !isBranch) {
WidgetsBinding.instance.addPostFrameCallback((_) {
_controller.loadCompanyData().then((_) {
debugPrint('📌 회사 데이터 로드 완료, UI 갱신');
if (mounted) {
setState(() {
debugPrint('📌 setState 호출됨');
debugPrint('📌 nameController.text: "${_controller.nameController.text}"');
debugPrint('📌 contactNameController.text: "${_controller.contactNameController.text}"');
});
// 주소 필드 초기화
_addressController.text = _controller.companyAddress.toString();
// 전화번호 분리 초기화
final fullPhone = _controller.contactPhoneController.text;
if (fullPhone.isNotEmpty) {
_selectedPhonePrefix = PhoneUtils.extractPhonePrefix(fullPhone, _phonePrefixes);
_phoneNumberController.text = PhoneUtils.extractPhoneNumberWithoutPrefix(fullPhone, _phonePrefixes);
}
setState(() {});
}
}).catchError((error) {
debugPrint('❌ 회사 데이터 로드 실패: $error');
});
});
}
// 지점 수정 모드일 때 branchId로 branch 정보 세팅
if (isBranch && branchId != null) {
// Mock 서비스 제거 - API를 통해 데이터 로드
// 디버그: 진입 시 companyId, branchId 정보 출력
print('[DEBUG] 지점 수정 진입: companyId=$companyId, branchId=$branchId');
// TODO: API를 통해 회사 데이터 로드 필요
// 아래 코드는 Mock 서비스 제거로 인해 주석 처리됨
/*
if (false) { // 임시로 비활성화
print(
'[DEBUG] 불러온 company.name=${company.name}, branches=${company.branches!.map((b) => 'id:${b.id}, name:${b.name}, remark:${b.remark}').toList()}',
);
final branch = company.branches!.firstWhere(
(b) => b.id == branchId,
orElse: () => company.branches!.first,
);
print(
'[DEBUG] 선택된 branch: id=${branch.id}, name=${branch.name}, remark=${branch.remark}',
);
// 폼 컨트롤러의 각 필드에 branch 정보 세팅
_controller.nameController.text = branch.name;
_controller.companyAddress = branch.address;
_controller.contactNameController.text = branch.contactName ?? '';
_controller.contactPositionController.text =
branch.contactPosition ?? '';
_controller.selectedPhonePrefix = extractPhonePrefix(
branch.contactPhone ?? '',
_controller.phonePrefixes,
);
_controller
.contactPhoneController
.text = extractPhoneNumberWithoutPrefix(
branch.contactPhone ?? '',
_controller.phonePrefixes,
);
_controller.contactEmailController.text = branch.contactEmail ?? '';
// 지점 단일 입력만 허용 (branchControllers 초기화)
_controller.branchControllers.clear();
_controller.branchControllers.add(
BranchFormController(
branch: branch,
positions: _controller.positions,
phonePrefixes: _controller.phonePrefixes,
),
);
}
*/
}
}
@override
void dispose() {
_addressController.dispose();
_phoneNumberController.dispose();
_controller.dispose();
super.dispose();
}
// 지점 추가 후 스크롤 처리 (branchControllers 기반)
void _scrollToAddedBranchCard() {
if (_controller.branchControllers.isEmpty ||
!_controller.scrollController.hasClients) {
return;
}
// 추가 버튼 위치까지 스크롤 - 지점 추가 버튼이 있는 위치를 계산하여 그 위치로 스크롤
final double additionalOffset = 80.0;
final maxPos = _controller.scrollController.position.maxScrollExtent;
final currentPos = _controller.scrollController.position.pixels;
final targetPos = math.min(currentPos + additionalOffset, maxPos - 20.0);
_controller.scrollController.animateTo(
targetPos,
duration: const Duration(milliseconds: 300),
curve: Curves.easeOutQuad,
);
}
// 지점 추가
void _addBranch() {
setState(() {
_controller.addBranch();
});
WidgetsBinding.instance.addPostFrameCallback((_) {
Future.delayed(const Duration(milliseconds: 100), () {
_scrollToAddedBranchCard();
Future.delayed(const Duration(milliseconds: 300), () {
// 마지막 지점의 포커스 노드로 포커스 이동
if (_controller.branchControllers.isNotEmpty) {
_controller.branchControllers.last.focusNode.requestFocus();
}
});
});
});
}
// 회사 저장
/// 회사 저장
Future<void> _saveCompany() async {
// 지점 수정 모드일 때의 처리
if (isBranch && branchId != null) {
// 로딩 표시
showDialog(
context: context,
barrierDismissible: false,
builder: (context) => const Center(
child: CircularProgressIndicator(),
),
);
try {
final success = await _controller.saveBranch(branchId!);
if (mounted) {
Navigator.pop(context); // 로딩 다이얼로그 닫기
if (success) {
Navigator.pop(context, true);
} else {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('지점 저장에 실패했습니다.')),
);
}
}
} catch (e) {
if (mounted) {
Navigator.pop(context); // 로딩 다이얼로그 닫기
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(content: Text('오류가 발생했습니다: $e')),
);
}
}
if (!_controller.formKey.currentState!.validate()) {
return;
}
// 기존 회사 저장 로직
final duplicateCompany = await _controller.checkDuplicateCompany();
if (duplicateCompany != null) {
DuplicateCompanyDialog.show(context, duplicateCompany);
return;
}
// 주소 업데이트
_controller.updateCompanyAddress(
Address.fromFullAddress(_addressController.text)
);
// 전화번호 합치기
final fullPhoneNumber = PhoneUtils.getFullPhoneNumber(_selectedPhonePrefix, _phoneNumberController.text);
_controller.contactPhoneController.text = fullPhoneNumber;
// 로딩 표시
showDialog(
context: context,
barrierDismissible: false,
builder: (context) => const Center(
child: CircularProgressIndicator(),
),
builder: (context) => const Center(child: CircularProgressIndicator()),
);
try {
final success = await _controller.saveCompany();
if (mounted) {
Navigator.pop(context); // 로딩 다이얼로그 닫기
if (success) {
// 성공 메시지 표시
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text(companyId != null ? '회사 정보가 수정되었습니다.' : '회사가 등록되었습니다.'),
backgroundColor: Colors.green,
),
);
// 리스트 화면으로 돌아가기
Navigator.pop(context, true);
} else {
ScaffoldMessenger.of(context).showSnackBar(
@@ -320,215 +137,264 @@ class _CompanyFormScreenState extends State<CompanyFormScreen> {
@override
Widget build(BuildContext context) {
final isEditMode = companyId != null;
final String title =
isBranch
? '${mainCompanyName ?? ''} 지점 정보 수정'
: (isEditMode ? '회사 정보 수정' : '회사 등록');
final String nameLabel = isBranch ? '지점명' : '회사명';
final String nameHint = isBranch ? '지점명을 입력하세요' : '회사명을 입력하세요';
final title = isEditMode ? '회사 정보 수정' : '회사 등록';
// 지점 수정 모드일 때는 BranchFormWidget만 단독 노출
if (isBranch && branchId != null) {
return Scaffold(
appBar: AppBar(title: Text(title)),
body: Padding(
padding: const EdgeInsets.all(16.0),
child: Form(
key: _controller.formKey,
return Scaffold(
appBar: AppBar(title: Text(title)),
body: Padding(
padding: const EdgeInsets.all(16.0),
child: Form(
key: _controller.formKey,
child: SingleChildScrollView(
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Expanded(
child: SingleChildScrollView(
child: BranchFormWidget(
controller: _controller.branchControllers[0],
index: 0,
onRemove: null,
onAddressChanged: (address) {
setState(() {
_controller.updateBranchAddress(0, address);
});
},
),
// 회사 유형 선택
FormFieldWrapper(
label: "회사 유형",
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
CheckboxListTile(
title: const Text('고객사'),
value: _controller.selectedCompanyTypes.contains(CompanyType.customer),
onChanged: (checked) {
setState(() {
_controller.toggleCompanyType(CompanyType.customer, checked ?? false);
});
},
contentPadding: EdgeInsets.zero,
),
CheckboxListTile(
title: const Text('파트너사'),
value: _controller.selectedCompanyTypes.contains(CompanyType.partner),
onChanged: (checked) {
setState(() {
_controller.toggleCompanyType(CompanyType.partner, checked ?? false);
});
},
contentPadding: EdgeInsets.zero,
),
],
),
),
// 저장 버튼
Padding(
padding: const EdgeInsets.only(top: 16.0),
child: ElevatedButton(
onPressed: _saveCompany,
style: ElevatedButton.styleFrom(
backgroundColor: ShadcnTheme.primary,
minimumSize: const Size.fromHeight(48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
),
),
child: const Text(
'수정 완료',
style: TextStyle(
fontSize: 16,
fontWeight: FontWeight.bold,
),
const SizedBox(height: 16),
// 회사명 (필수)
FormFieldWrapper(
label: "회사명 *",
child: TextFormField(
controller: _controller.nameController,
decoration: const InputDecoration(
hintText: '회사명을 입력하세요',
border: OutlineInputBorder(),
),
validator: (value) {
if (value == null || value.trim().isEmpty) {
return '회사명을 입력하세요';
}
if (value.trim().length < 2) {
return '회사명은 2자 이상 입력하세요';
}
return null;
},
textInputAction: TextInputAction.next,
),
),
],
),
),
),
);
}
// ... 기존 본사/신규 등록 모드 렌더링
return GestureDetector(
onTap: () {
setState(() {
if (_controller.showCompanyNameDropdown) {
_controller.showCompanyNameDropdown = false;
}
});
FocusScope.of(context).unfocus();
},
child: Scaffold(
appBar: AppBar(title: Text(title)),
body: Padding(
padding: const EdgeInsets.all(16.0),
child: Form(
key: _controller.formKey,
child: SingleChildScrollView(
controller: _controller.scrollController,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// 회사 유형 선택 (체크박스)
CompanyTypeSelector(
selectedTypes: _controller.selectedCompanyTypes,
onTypeChanged: (type, checked) {
setState(() {
_controller.toggleCompanyType(type, checked);
});
},
const SizedBox(height: 16),
// 주소 (선택)
FormFieldWrapper(
label: "주소",
child: TextFormField(
controller: _addressController,
decoration: const InputDecoration(
hintText: '회사 주소를 입력하세요',
border: OutlineInputBorder(),
),
maxLines: 2,
textInputAction: TextInputAction.next,
),
// 회사 기본 정보 헤더 (회사명/지점명 + 주소)
CompanyFormHeader(
nameController: _controller.nameController,
nameFocusNode: _controller.nameFocusNode,
companyNames: _controller.companyNames,
filteredCompanyNames: _controller.filteredCompanyNames,
showCompanyNameDropdown:
_controller.showCompanyNameDropdown,
onCompanyNameSelected: (name) {
setState(() {
_controller.selectCompanyName(name);
});
),
const SizedBox(height: 16),
// 담당자명 (필수)
FormFieldWrapper(
label: "담당자명 *",
child: TextFormField(
controller: _controller.contactNameController,
decoration: const InputDecoration(
hintText: '담당자명을 입력하세요',
border: OutlineInputBorder(),
),
validator: (value) {
if (value == null || value.trim().isEmpty) {
return '담당자명을 입력하세요';
}
return null;
},
onShowMapPressed: () {
final fullAddress = _controller.companyAddress.toString();
MapDialog.show(context, fullAddress);
},
onNameSaved: (value) {},
onAddressChanged: (address) {
setState(() {
_controller.updateCompanyAddress(address);
});
},
initialAddress: _controller.companyAddress,
nameLabel: nameLabel,
nameHint: nameHint,
remarkController: _controller.remarkController,
textInputAction: TextInputAction.next,
),
// 담당자 정보
ContactInfoForm(
contactNameController: _controller.contactNameController,
contactPositionController:
_controller.contactPositionController,
contactPhoneController: _controller.contactPhoneController,
contactEmailController: _controller.contactEmailController,
positions: _controller.positions,
selectedPhonePrefix: _controller.selectedPhonePrefix,
phonePrefixes: _controller.phonePrefixes,
onPhonePrefixChanged: (value) {
setState(() {
_controller.selectedPhonePrefix = value;
});
},
onNameSaved: (value) {},
onPositionSaved: (value) {},
onPhoneSaved: (value) {},
onEmailSaved: (value) {},
),
const SizedBox(height: 16),
// 담당자 직급 (선택)
FormFieldWrapper(
label: "담당자 직급",
child: TextFormField(
controller: _controller.contactPositionController,
decoration: const InputDecoration(
hintText: '담당자 직급을 입력하세요',
border: OutlineInputBorder(),
),
textInputAction: TextInputAction.next,
),
// 지점 정보(하단) 및 +지점추가 버튼은 본사/신규 등록일 때만 노출
if (!(isBranch && branchId != null)) ...[
if (_controller.branchControllers.isNotEmpty)
Padding(
padding: const EdgeInsets.only(top: 16.0, bottom: 8.0),
child: Text(
'지점 정보',
style: ShadcnTheme.headingH6,
),
const SizedBox(height: 16),
// 담당자 연락처 (필수) - 사용자 폼과 동일한 패턴
FormFieldWrapper(
label: "담당자 연락처 *",
child: Row(
children: [
// 접두사 드롭다운 (010, 02, 031 등)
Container(
padding: const EdgeInsets.symmetric(horizontal: 12),
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
borderRadius: BorderRadius.circular(4),
),
child: DropdownButton<String>(
value: _selectedPhonePrefix,
items: _phonePrefixes.map((prefix) {
return DropdownMenuItem(
value: prefix,
child: Text(prefix),
);
}).toList(),
onChanged: (value) {
if (value != null) {
setState(() {
_selectedPhonePrefix = value;
});
}
},
underline: Container(), // 밑줄 제거
),
),
if (_controller.branchControllers.isNotEmpty)
for (
int i = 0;
i < _controller.branchControllers.length;
i++
)
BranchFormWidget(
controller: _controller.branchControllers[i],
index: i,
onRemove: () {
setState(() {
_controller.removeBranch(i);
});
},
onAddressChanged: (address) {
setState(() {
_controller.updateBranchAddress(i, address);
});
},
),
Padding(
padding: const EdgeInsets.only(top: 16.0),
child: ElevatedButton.icon(
onPressed: _addBranch,
icon: const Icon(Icons.add),
label: const Text('지점 추가'),
style: ElevatedButton.styleFrom(
minimumSize: const Size.fromHeight(48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
const SizedBox(width: 8),
const Text('-', style: TextStyle(fontSize: 16)),
const SizedBox(width: 8),
// 전화번호 입력 (7-8자리)
Expanded(
child: TextFormField(
controller: _phoneNumberController,
decoration: const InputDecoration(
hintText: '1234-5678',
border: OutlineInputBorder(),
),
keyboardType: TextInputType.phone,
inputFormatters: [
FilteringTextInputFormatter.digitsOnly,
TextInputFormatter.withFunction((oldValue, newValue) {
final formatted = PhoneUtils.formatPhoneNumberByPrefix(
_selectedPhonePrefix,
newValue.text,
);
return TextEditingValue(
text: formatted,
selection: TextSelection.collapsed(offset: formatted.length),
);
}),
],
validator: (value) {
if (value == null || value.trim().isEmpty) {
return '전화번호를 입력하세요';
}
final digitsOnly = value.replaceAll(RegExp(r'[^\d]'), '');
if (digitsOnly.length < 7) {
return '전화번호는 7-8자리 숫자를 입력해주세요';
}
return null;
},
textInputAction: TextInputAction.next,
),
),
],
),
),
const SizedBox(height: 16),
// 담당자 이메일 (필수)
FormFieldWrapper(
label: "담당자 이메일 *",
child: TextFormField(
controller: _controller.contactEmailController,
decoration: const InputDecoration(
hintText: 'example@company.com',
border: OutlineInputBorder(),
),
],
// 저장 버튼 추가
Padding(
padding: const EdgeInsets.only(top: 24.0, bottom: 16.0),
child: ElevatedButton(
onPressed: _saveCompany,
style: ElevatedButton.styleFrom(
backgroundColor: ShadcnTheme.primary,
minimumSize: const Size.fromHeight(48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
),
),
child: Text(
isEditMode ? '수정 완료' : '등록 완료',
style: const TextStyle(
fontSize: 16,
fontWeight: FontWeight.bold,
color: Colors.white,
),
),
keyboardType: TextInputType.emailAddress,
validator: (value) {
if (value == null || value.trim().isEmpty) {
return '담당자 이메일을 입력하세요';
}
return validateEmail(value);
},
textInputAction: TextInputAction.next,
),
),
const SizedBox(height: 16),
// 비고 (선택)
FormFieldWrapper(
label: "비고",
child: TextFormField(
controller: _controller.remarkController,
decoration: const InputDecoration(
hintText: '추가 정보나 메모를 입력하세요',
border: OutlineInputBorder(),
),
maxLines: 3,
textInputAction: TextInputAction.done,
),
),
const SizedBox(height: 32),
// 저장 버튼
ElevatedButton(
onPressed: _saveCompany,
style: ElevatedButton.styleFrom(
backgroundColor: ShadcnTheme.primary,
foregroundColor: Colors.white,
minimumSize: const Size.fromHeight(48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
),
),
],
),
child: Text(
isEditMode ? '수정 완료' : '등록 완료',
style: const TextStyle(
fontSize: 16,
fontWeight: FontWeight.bold,
),
),
),
const SizedBox(height: 16),
],
),
),
),
),
);
}
}
}