feat(app): add manual entry and sharing flows

2025-11-19 16:36:39 +09:00
parent 5ade584370
commit 947fe59486
110 changed files with 5937 additions and 3781 deletions
--- a/lib/core/errors/app_exceptions.dart
+++ b/lib/core/errors/app_exceptions.dart
@@ -1,5 +1,5 @@
 /// 애플리케이션 전체 예외 클래스들
-/// 
+///
 /// 각 레이어별로 명확한 예외 계층 구조를 제공합니다.

 /// 앱 예외 기본 클래스
@@ -7,15 +7,12 @@ abstract class AppException implements Exception {
  final String message;
  final String? code;
  final dynamic originalError;
-  
-  const AppException({
-    required this.message,
-    this.code,
-    this.originalError,
-  });
-  
+
+  const AppException({required this.message, this.code, this.originalError});
+
  @override
-  String toString() => '$runtimeType: $message${code != null ? ' (코드: $code)' : ''}';
+  String toString() =>
+      '$runtimeType: $message${code != null ? ' (코드: $code)' : ''}';
 }

 /// 비즈니스 로직 예외
@@ -24,23 +21,19 @@ class BusinessException extends AppException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
+  }) : super(message: message, code: code, originalError: originalError);
 }

 /// 검증 예외
 class ValidationException extends AppException {
  final Map<String, String>? fieldErrors;
-  
+
  const ValidationException({
    required String message,
    this.fieldErrors,
    String? code,
  }) : super(message: message, code: code);
-  
+
  @override
  String toString() {
    final base = super.toString();
@@ -60,11 +53,7 @@ class DataException extends AppException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
+  }) : super(message: message, code: code, originalError: originalError);
 }

 /// 저장소 예외
@@ -73,23 +62,19 @@ class StorageException extends DataException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
+  }) : super(message: message, code: code, originalError: originalError);
 }

 /// 권한 예외
 class PermissionException extends AppException {
  final String permission;
-  
+
  const PermissionException({
    required String message,
    required this.permission,
    String? code,
  }) : super(message: message, code: code);
-  
+
  @override
  String toString() => '$runtimeType: $message (권한: $permission)';
 }
@@ -100,19 +85,13 @@ class LocationException extends AppException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
+  }) : super(message: message, code: code, originalError: originalError);
 }

 /// 설정 예외
 class ConfigurationException extends AppException {
-  const ConfigurationException({
-    required String message,
-    String? code,
-  }) : super(message: message, code: code);
+  const ConfigurationException({required String message, String? code})
+    : super(message: message, code: code);
 }

 /// UI 예외
@@ -121,47 +100,36 @@ class UIException extends AppException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
+  }) : super(message: message, code: code, originalError: originalError);
 }

 /// 리소스를 찾을 수 없음 예외
 class NotFoundException extends AppException {
  final String resourceType;
  final dynamic resourceId;
-  
+
  const NotFoundException({
    required this.resourceType,
    required this.resourceId,
    String? message,
  }) : super(
-    message: message ?? '$resourceType을(를) 찾을 수 없습니다 (ID: $resourceId)',
-    code: 'NOT_FOUND',
-  );
+         message: message ?? '$resourceType을(를) 찾을 수 없습니다 (ID: $resourceId)',
+         code: 'NOT_FOUND',
+       );
 }

 /// 중복 리소스 예외
 class DuplicateException extends AppException {
  final String resourceType;
-  
-  const DuplicateException({
-    required this.resourceType,
-    String? message,
-  }) : super(
-    message: message ?? '이미 존재하는 $resourceType입니다',
-    code: 'DUPLICATE',
-  );
+
+  const DuplicateException({required this.resourceType, String? message})
+    : super(message: message ?? '이미 존재하는 $resourceType입니다', code: 'DUPLICATE');
 }

 /// 추천 엔진 예외
 class RecommendationException extends BusinessException {
-  const RecommendationException({
-    required String message,
-    String? code,
-  }) : super(message: message, code: code);
+  const RecommendationException({required String message, String? code})
+    : super(message: message, code: code);
 }

 /// 알림 예외
@@ -170,9 +138,5 @@ class NotificationException extends AppException {
    required String message,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
-}
+  }) : super(message: message, code: code, originalError: originalError);
+}
--- a/lib/core/errors/data_exceptions.dart
+++ b/lib/core/errors/data_exceptions.dart
@@ -1,5 +1,5 @@
 /// 데이터 레이어 예외 클래스들
-/// 
+///
 /// API, 데이터베이스, 파싱 관련 예외를 정의합니다.

 import 'app_exceptions.dart';
@@ -7,20 +7,17 @@ import 'app_exceptions.dart';
 /// API 예외 기본 클래스
 abstract class ApiException extends DataException {
  final int? statusCode;
-  
+
  const ApiException({
    required String message,
    this.statusCode,
    String? code,
    dynamic originalError,
-  }) : super(
-    message: message,
-    code: code,
-    originalError: originalError,
-  );
-  
+  }) : super(message: message, code: code, originalError: originalError);
+
  @override
-  String toString() => '$runtimeType: $message${statusCode != null ? ' (HTTP $statusCode)' : ''}';
+  String toString() =>
+      '$runtimeType: $message${statusCode != null ? ' (HTTP $statusCode)' : ''}';
 }

 /// 네이버 API 예외
@@ -31,27 +28,27 @@ class NaverApiException extends ApiException {
    String? code,
    dynamic originalError,
  }) : super(
-    message: message,
-    statusCode: statusCode,
-    code: code,
-    originalError: originalError,
-  );
+         message: message,
+         statusCode: statusCode,
+         code: code,
+         originalError: originalError,
+       );
 }

 /// HTML 파싱 예외
 class HtmlParsingException extends DataException {
  final String? url;
-  
+
  const HtmlParsingException({
    required String message,
    this.url,
    dynamic originalError,
  }) : super(
-    message: message,
-    code: 'HTML_PARSE_ERROR',
-    originalError: originalError,
-  );
-  
+         message: message,
+         code: 'HTML_PARSE_ERROR',
+         originalError: originalError,
+       );
+
  @override
  String toString() {
    final base = super.toString();
@@ -63,18 +60,18 @@ class HtmlParsingException extends DataException {
 class DataConversionException extends DataException {
  final String fromType;
  final String toType;
-  
+
  const DataConversionException({
    required String message,
    required this.fromType,
    required this.toType,
    dynamic originalError,
  }) : super(
-    message: message,
-    code: 'DATA_CONVERSION_ERROR',
-    originalError: originalError,
-  );
-  
+         message: message,
+         code: 'DATA_CONVERSION_ERROR',
+         originalError: originalError,
+       );
+
  @override
  String toString() => '$runtimeType: $message ($fromType → $toType)';
 }
@@ -86,10 +83,10 @@ class CacheException extends StorageException {
    String? code,
    dynamic originalError,
  }) : super(
-    message: message,
-    code: code ?? 'CACHE_ERROR',
-    originalError: originalError,
-  );
+         message: message,
+         code: code ?? 'CACHE_ERROR',
+         originalError: originalError,
+       );
 }

 /// Hive 예외
@@ -99,51 +96,47 @@ class HiveException extends StorageException {
    String? code,
    dynamic originalError,
  }) : super(
-    message: message,
-    code: code ?? 'HIVE_ERROR',
-    originalError: originalError,
-  );
+         message: message,
+         code: code ?? 'HIVE_ERROR',
+         originalError: originalError,
+       );
 }

 /// URL 처리 예외
 class UrlProcessingException extends DataException {
  final String url;
-  
+
  const UrlProcessingException({
    required String message,
    required this.url,
    String? code,
    dynamic originalError,
  }) : super(
-    message: message,
-    code: code ?? 'URL_PROCESSING_ERROR',
-    originalError: originalError,
-  );
-  
+         message: message,
+         code: code ?? 'URL_PROCESSING_ERROR',
+         originalError: originalError,
+       );
+
  @override
  String toString() => '$runtimeType: $message (URL: $url)';
 }

 /// 잘못된 URL 형식 예외
 class InvalidUrlException extends UrlProcessingException {
-  const InvalidUrlException({
-    required String url,
-    String? message,
-  }) : super(
-    message: message ?? '올바르지 않은 URL 형식입니다',
-    url: url,
-    code: 'INVALID_URL',
-  );
+  const InvalidUrlException({required String url, String? message})
+    : super(
+        message: message ?? '올바르지 않은 URL 형식입니다',
+        url: url,
+        code: 'INVALID_URL',
+      );
 }

 /// 지원하지 않는 URL 예외
 class UnsupportedUrlException extends UrlProcessingException {
-  const UnsupportedUrlException({
-    required String url,
-    String? message,
-  }) : super(
-    message: message ?? '지원하지 않는 URL입니다',
-    url: url,
-    code: 'UNSUPPORTED_URL',
-  );
-}
+  const UnsupportedUrlException({required String url, String? message})
+    : super(
+        message: message ?? '지원하지 않는 URL입니다',
+        url: url,
+        code: 'UNSUPPORTED_URL',
+      );
+}
--- a/lib/core/errors/network_exceptions.dart
+++ b/lib/core/errors/network_exceptions.dart
@@ -1,5 +1,5 @@
 /// 네트워크 관련 예외 클래스들
-/// 
+///
 /// 모든 네트워크 오류를 명확하게 분류하고 처리합니다.

 /// 네트워크 예외 기본 클래스
@@ -7,15 +7,16 @@ abstract class NetworkException implements Exception {
  final String message;
  final int? statusCode;
  final dynamic originalError;
-  
+
  const NetworkException({
    required this.message,
    this.statusCode,
    this.originalError,
  });
-  
+
  @override
-  String toString() => '$runtimeType: $message${statusCode != null ? ' (HTTP $statusCode)' : ''}';
+  String toString() =>
+      '$runtimeType: $message${statusCode != null ? ' (HTTP $statusCode)' : ''}';
 }

 /// 연결 타임아웃 예외
@@ -41,10 +42,10 @@ class ServerException extends NetworkException {
    required int statusCode,
    dynamic originalError,
  }) : super(
-    message: message,
-    statusCode: statusCode,
-    originalError: originalError,
-  );
+         message: message,
+         statusCode: statusCode,
+         originalError: originalError,
+       );
 }

 /// 클라이언트 오류 예외 (4xx)
@@ -54,25 +55,22 @@ class ClientException extends NetworkException {
    required int statusCode,
    dynamic originalError,
  }) : super(
-    message: message,
-    statusCode: statusCode,
-    originalError: originalError,
-  );
+         message: message,
+         statusCode: statusCode,
+         originalError: originalError,
+       );
 }

 /// 파싱 오류 예외
 class ParseException extends NetworkException {
-  const ParseException({
-    required String message,
-    dynamic originalError,
-  }) : super(message: message, originalError: originalError);
+  const ParseException({required String message, dynamic originalError})
+    : super(message: message, originalError: originalError);
 }

 /// API 키 오류 예외
 class ApiKeyException extends NetworkException {
-  const ApiKeyException({
-    String message = 'API 키가 설정되지 않았습니다',
-  }) : super(message: message);
+  const ApiKeyException({String message = 'API 키가 설정되지 않았습니다'})
+    : super(message: message);
 }

 /// 재시도 횟수 초과 예외
@@ -86,17 +84,13 @@ class MaxRetriesExceededException extends NetworkException {
 /// Rate Limit (429) 예외
 class RateLimitException extends NetworkException {
  final String? retryAfter;
-  
+
  const RateLimitException({
    String message = '너무 많은 요청으로 인해 차단되었습니다. 잠시 후 다시 시도해주세요.',
    this.retryAfter,
    dynamic originalError,
-  }) : super(
-    message: message,
-    statusCode: 429,
-    originalError: originalError,
-  );
-  
+  }) : super(message: message, statusCode: 429, originalError: originalError);
+
  @override
  String toString() {
    final base = super.toString();
@@ -105,4 +99,4 @@ class RateLimitException extends NetworkException {
    }
    return base;
  }
-}
+}