feat: 초기 프로젝트 설정 및 LunchPick 앱 구현

LunchPick(오늘 뭐 먹Z?) Flutter 앱의 초기 구현입니다.

주요 기능:
- 네이버 지도 연동 맛집 추가
- 랜덤 메뉴 추천 시스템
- 날씨 기반 거리 조정
- 방문 기록 관리
- Bluetooth 맛집 공유
- 다크모드 지원

기술 스택:
- Flutter 3.8.1+
- Riverpod 상태 관리
- Hive 로컬 DB
- Clean Architecture

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
JiWoong Sul
2025-07-30 19:03:28 +09:00
commit 85fde36157
237 changed files with 30953 additions and 0 deletions

View File

@@ -0,0 +1,178 @@
/// 애플리케이션 전체 예외 클래스들
///
/// 각 레이어별로 명확한 예외 계층 구조를 제공합니다.
/// 앱 예외 기본 클래스
abstract class AppException implements Exception {
final String message;
final String? code;
final dynamic originalError;
const AppException({
required this.message,
this.code,
this.originalError,
});
@override
String toString() => '$runtimeType: $message${code != null ? ' (코드: $code)' : ''}';
}
/// 비즈니스 로직 예외
class BusinessException extends AppException {
const BusinessException({
required String message,
String? code,
dynamic 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();
if (fieldErrors != null && fieldErrors!.isNotEmpty) {
final errors = fieldErrors!.entries
.map((e) => '${e.key}: ${e.value}')
.join(', ');
return '$base [필드 오류: $errors]';
}
return base;
}
}
/// 데이터 예외
class DataException extends AppException {
const DataException({
required String message,
String? code,
dynamic originalError,
}) : super(
message: message,
code: code,
originalError: originalError,
);
}
/// 저장소 예외
class StorageException extends DataException {
const StorageException({
required String message,
String? code,
dynamic 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)';
}
/// 위치 서비스 예외
class LocationException extends AppException {
const LocationException({
required String message,
String? code,
dynamic originalError,
}) : super(
message: message,
code: code,
originalError: originalError,
);
}
/// 설정 예외
class ConfigurationException extends AppException {
const ConfigurationException({
required String message,
String? code,
}) : super(message: message, code: code);
}
/// UI 예외
class UIException extends AppException {
const UIException({
required String message,
String? code,
dynamic 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',
);
}
/// 중복 리소스 예외
class DuplicateException extends AppException {
final String resourceType;
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);
}
/// 알림 예외
class NotificationException extends AppException {
const NotificationException({
required String message,
String? code,
dynamic originalError,
}) : super(
message: message,
code: code,
originalError: originalError,
);
}

View File

@@ -0,0 +1,149 @@
/// 데이터 레이어 예외 클래스들
///
/// API, 데이터베이스, 파싱 관련 예외를 정의합니다.
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,
);
@override
String toString() => '$runtimeType: $message${statusCode != null ? ' (HTTP $statusCode)' : ''}';
}
/// 네이버 API 예외
class NaverApiException extends ApiException {
const NaverApiException({
required String message,
int? statusCode,
String? code,
dynamic originalError,
}) : super(
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,
);
@override
String toString() {
final base = super.toString();
return url != null ? '$base (URL: $url)' : base;
}
}
/// 데이터 변환 예외
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,
);
@override
String toString() => '$runtimeType: $message ($fromType$toType)';
}
/// 캐시 예외
class CacheException extends StorageException {
const CacheException({
required String message,
String? code,
dynamic originalError,
}) : super(
message: message,
code: code ?? 'CACHE_ERROR',
originalError: originalError,
);
}
/// Hive 예외
class HiveException extends StorageException {
const HiveException({
required String message,
String? code,
dynamic originalError,
}) : super(
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,
);
@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',
);
}
/// 지원하지 않는 URL 예외
class UnsupportedUrlException extends UrlProcessingException {
const UnsupportedUrlException({
required String url,
String? message,
}) : super(
message: message ?? '지원하지 않는 URL입니다',
url: url,
code: 'UNSUPPORTED_URL',
);
}

View File

@@ -0,0 +1,108 @@
/// 네트워크 관련 예외 클래스들
///
/// 모든 네트워크 오류를 명확하게 분류하고 처리합니다.
/// 네트워크 예외 기본 클래스
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)' : ''}';
}
/// 연결 타임아웃 예외
class ConnectionTimeoutException extends NetworkException {
const ConnectionTimeoutException({
String message = '서버 연결 시간이 초과되었습니다',
dynamic originalError,
}) : super(message: message, originalError: originalError);
}
/// 네트워크 연결 없음 예외
class NoInternetException extends NetworkException {
const NoInternetException({
String message = '인터넷 연결을 확인해주세요',
dynamic originalError,
}) : super(message: message, originalError: originalError);
}
/// 서버 오류 예외 (5xx)
class ServerException extends NetworkException {
const ServerException({
required String message,
required int statusCode,
dynamic originalError,
}) : super(
message: message,
statusCode: statusCode,
originalError: originalError,
);
}
/// 클라이언트 오류 예외 (4xx)
class ClientException extends NetworkException {
const ClientException({
required String message,
required int statusCode,
dynamic originalError,
}) : super(
message: message,
statusCode: statusCode,
originalError: originalError,
);
}
/// 파싱 오류 예외
class ParseException extends NetworkException {
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);
}
/// 재시도 횟수 초과 예외
class MaxRetriesExceededException extends NetworkException {
const MaxRetriesExceededException({
String message = '최대 재시도 횟수를 초과했습니다',
dynamic originalError,
}) : super(message: message, originalError: originalError);
}
/// 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,
);
@override
String toString() {
final base = super.toString();
if (retryAfter != null) {
return '$base (재시도 가능: $retryAfter초 후)';
}
return base;
}
}