프로젝트 최초 커밋

2025-07-02 17:45:44 +09:00
commit e346f83c97
235 changed files with 23139 additions and 0 deletions
--- a/lib/utils/phone_utils.dart
+++ b/lib/utils/phone_utils.dart
@@ -0,0 +1,127 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+/// 전화번호 관련 유틸리티 클래스 (SRP, 재사용성, 테스트 용이성 중심)
+class PhoneUtils {
+  /// 전화번호 입력 형식 지정용 InputFormatter
+  static final TextInputFormatter phoneInputFormatter =
+      _PhoneTextInputFormatter();
+
+  /// 전화번호 포맷팅 (뒤 4자리 하이픈)
+  static String formatPhoneNumber(String phoneNumber) {
+    final digitsOnly = phoneNumber.replaceAll(RegExp(r'[^\d]'), '');
+    if (digitsOnly.isEmpty) return '';
+    if (digitsOnly.length > 8) {
+      return formatPhoneNumber(digitsOnly.substring(0, 8));
+    }
+    if (digitsOnly.length > 4) {
+      final frontPart = digitsOnly.substring(0, digitsOnly.length - 4);
+      final backPart = digitsOnly.substring(digitsOnly.length - 4);
+      return '$frontPart-$backPart';
+    }
+    return digitsOnly;
+  }
+
+  /// 포맷된 전화번호에서 숫자만 추출
+  static String extractDigitsOnly(String formattedPhoneNumber) {
+    return formattedPhoneNumber.replaceAll(RegExp(r'[^\d]'), '');
+  }
+
+  /// 전체 전화번호에서 접두사 추출 (없으면 기본값)
+  static String extractPhonePrefix(
+    String fullNumber,
+    List<String> phonePrefixes,
+  ) {
+    if (fullNumber.isEmpty) return '010';
+    String digitsOnly = fullNumber.replaceAll(RegExp(r'[^\d]'), '');
+    for (String prefix in phonePrefixes) {
+      if (digitsOnly.startsWith(prefix)) {
+        return prefix;
+      }
+    }
+    return '010';
+  }
+
+  /// 접두사 제외한 번호 추출
+  static String extractPhoneNumberWithoutPrefix(
+    String fullNumber,
+    List<String> phonePrefixes,
+  ) {
+    if (fullNumber.isEmpty) return '';
+    String digitsOnly = fullNumber.replaceAll(RegExp(r'[^\d]'), '');
+    for (String prefix in phonePrefixes) {
+      if (digitsOnly.startsWith(prefix)) {
+        return digitsOnly.substring(prefix.length);
+      }
+    }
+    return digitsOnly;
+  }
+
+  /// 접두사와 번호를 합쳐 전체 전화번호 생성
+  static String getFullPhoneNumber(String prefix, String number) {
+    final remainingNumber = number.replaceAll(RegExp(r'[^\d]'), '');
+    if (remainingNumber.isEmpty) return '';
+    return '$prefix-$remainingNumber';
+  }
+
+  /// 자주 사용되는 전화번호 접두사 목록 반환
+  static List<String> getCommonPhonePrefixes() {
+    return [
+      '010',
+      '011',
+      '016',
+      '017',
+      '018',
+      '019',
+      '070',
+      '080',
+      '02',
+      '031',
+      '032',
+      '033',
+      '041',
+      '042',
+      '043',
+      '044',
+      '051',
+      '052',
+      '053',
+      '054',
+      '055',
+      '061',
+      '062',
+      '063',
+      '064',
+    ];
+  }
+}
+
+/// 전화번호 입력 형식 지정용 TextInputFormatter (내부 전용)
+class _PhoneTextInputFormatter extends TextInputFormatter {
+  @override
+  TextEditingValue formatEditUpdate(
+    TextEditingValue oldValue,
+    TextEditingValue newValue,
+  ) {
+    final digitsOnly = newValue.text.replaceAll(RegExp(r'[^\d]+'), '');
+    final trimmed =
+        digitsOnly.length > 11 ? digitsOnly.substring(0, 11) : digitsOnly;
+    String formatted = '';
+    if (trimmed.length > 7) {
+      formatted =
+          '${trimmed.substring(0, 3)}-${trimmed.substring(3, 7)}-${trimmed.substring(7)}';
+    } else if (trimmed.length > 3) {
+      formatted = '${trimmed.substring(0, 3)}-${trimmed.substring(3)}';
+    } else {
+      formatted = trimmed;
+    }
+    int selectionIndex =
+        newValue.selection.end + (formatted.length - newValue.text.length);
+    if (selectionIndex < 0) selectionIndex = 0;
+    if (selectionIndex > formatted.length) selectionIndex = formatted.length;
+    return TextEditingValue(
+      text: formatted,
+      selection: TextSelection.collapsed(offset: selectionIndex),
+    );
+  }
+}