프로젝트 소개

Fiestaaa Front는 친구 및 가족과 함께하는 개인 이벤트를 조직하기 위한 Flutter 3.44 / Dart 3.11 프론트엔드 애플리케이션입니다. MPL-2.0 라이선스 하에 제공되며 Firebase와 통합됩니다. 주요 기능은 다음과 같습니다: - Google Sign-In, Sign in with Apple 및 이메일/비밀번호를 통한 인증 - 맞춤형 세부 정보를 포함한 이벤트 생성 및 전체 이벤트 관리 - 이메일을 통해 전송 및 관리되는 초대장 - 협업 가능한 항목/쇼핑 리스트 - 참가자가 포함된 카풀 조직 - 참석자 간의 공유 비용 추적 및 분할 - 입장 관리를 위한 액세스 QR 코드 - Firebase Cloud Messaging (FCM)을 통한 푸시 알림 - 사용자 기본 설정 사용자 정의 이 앱은 웹, Android 및 iOS를 대상으로 합니다. 로컬 개발을 위해서는 .env 파일에 환경 변수(API URL, OAuth 클라이언트 ID, Firebase 설정, FCM VAPID 키)를 구성해야 합니다. Firebase 웹 서비스 워커는 Dart 도구를 통해 템플릿과 환경 변수로부터 생성됩니다. 개발 도구로는 dart format, flutter analyze, 그리고 커버리지 보고가 포함된 flutter test가 사용됩니다. CI는 22%의 라인 커버리지 하한선을 강제합니다. CI의 보안 스캔에는 워크플로 린팅, Dockerfile 확인 및 전체 이력 Gitleaks 스캔이 포함됩니다. 프로덕션 웹 빌드는 Nginx 서빙이 포함된 Dockerfile을 사용합니다. Android 릴리스 빌드는 로컬 서명 파일이 있는 경우 이를 사용합니다. 서명된 IPA 빌드 및 공식 웹 이미지 게시물은 비공개 운영 리포지토리에서 처리되며, 이 공개 리포지토리는 소스 코드, 로컬 빌드 지침 및 공개 CI만 제공합니다. 별도의 Rust 백엔드 리포지토리(fiestaaa_back)가 존재합니다. 프로젝트 문서에는 아키텍처, 첫 기여 방법, 로드맵, 제3자 고지 사항, 거버넌스 및 상표 가이드라인이 포함되어 있습니다.