travel_genie

A new Flutter project.

This project now includes state management using Riverpod.

Project Structure

The project follows a feature-based architecture for better organization and maintainability:

lib/
├── app.dart                 # Main app configuration
├── main.dart               # Entry point
├── router.dart             # App routing configuration
├── core/                   # Core functionality and shared components
│   ├── config/             # Configuration settings
│   ├── extensions/         # Dart extensions
│   ├── models/             # Shared data models (Location, Photo, etc.)
│   ├── pages/              # Core UI screens (home page, etc.)
│   ├── services/           # Core business logic services
│   ├── theme/              # App theming
│   ├── utils/              # Utility functions
│   └── widgets/            # Shared reusable UI components
├── features/               # Feature-specific code organized by domain
│   ├── authentication/     # Authentication feature
│   │   ├── models/         # Authentication-specific models
│   │   ├── pages/          # Authentication UI screens
│   │   └── widgets/        # Authentication-specific widgets
│   ├── challenge/          # Challenges and badges feature
│   │   ├── models/         # Challenge and badge models
│   │   ├── providers/      # Challenge state management
│   │   └── services/       # Challenge business logic
│   ├── place/              # Places and location feature
│   │   ├── models/         # Place-related models
│   │   ├── pages/          # Place detail pages
│   │   ├── services/       # Place services (search, recommendations)
│   │   └── widgets/        # Place-specific widgets
│   ├── search/             # Search functionality
│   │   ├── models/         # Search-related models
│   │   ├── pages/          # Search results pages
│   │   ├── providers/      # Search state management
│   │   ├── services/       # Search business logic
│   │   └── widgets/        # Search-specific widgets
│   ├── social/             # Social features
│   │   ├── models/         # Social-related models
│   │   ├── pages/          # Social pages (groups, etc.)
│   │   ├── services/       # Social business logic
│   │   └── widgets/        # Social-specific widgets
│   ├── trip/               # Trip planning and management
│   │   ├── models/         # Trip, itinerary, and related models
│   │   ├── pages/          # Trip management pages
│   │   ├── providers/      # Trip state management
│   │   ├── services/       # Trip business logic
│   │   └── widgets/        # Trip-specific widgets
│   │       ├── profile_completeness/  # Profile completeness widgets (one per file)
│   │       │   ├── profile_completeness_widget.dart
│   │       │   ├── loading_profile_completeness.dart
│   │       │   ├── error_profile_completeness.dart
│   │       │   └── profile_completeness_content.dart
│   │       └── travel_partner/        # Travel partner widgets (one per file)
│   │           ├── travel_partner_invite_widget.dart
│   │           ├── travel_partner_invite_modal.dart
│   │           ├── tab_button.dart
│   │           ├── friends_list_tab.dart
│   │           ├── friend_list_item.dart
│   │           └── email_invite_tab.dart
│   └── user/               # User management
│       ├── models/         # User data and profile models
│       ├── pages/          # User profile pages
│       ├── providers/      # User state management
│       ├── services/       # User business logic
│       └── widgets/        # User-specific widgets
└── l10n/                   # Localization files

Architecture Guidelines

• Feature-based organization: Each feature has its own models, pages, services, and widgets
• Single Responsibility: Each file contains at most one widget or model class
• SOLID Principles: All code must adhere to SOLID principles
• Internationalization: All user-facing text must use localization keys

For detailed development guidelines, see .junie/guidelines.md and codex-guidelines.md.

Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

• Lab: Write your first Flutter app
• Cookbook: Useful Flutter samples

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Como construir e executar

1. Instale o Flutter.
2. Instale o Android NDK versão 27.0.12077973. Você pode utilizar o SDK Manager do Android Studio ou o comando sdkmanager "ndk;27.0.12077973".
3. Execute flutter pub get para baixar as dependências.
4. Para gerar os arquivos de internacionalização utilize flutter gen-l10n.
5. Defina o Google Client ID utilizando a opção --dart-define ao executar o aplicativo, por exemplo: flutter run --dart-define=GOOGLE_CLIENT_ID=<seu-id>.
6. Para gerar um APK de release use flutter build apk --dart-define=GOOGLE_CLIENT_ID=<seu-id>. Outras plataformas podem ser construídas com comandos equivalentes.

Os arquivos .arb que definem as traduções ficam em lib/l10n e o arquivo l10n.yaml configura a geração automática do código de localização.

Configuração do Google Sign-In no Android

Este projeto utiliza o pacote google_sign_in.

1. Registre seu aplicativo seguindo o guia do Firebase para Android.
2. Habilite as APIs OAuth necessárias no Google Cloud Platform API Manager, como a Google People API.
3. Preencha todos os campos obrigatórios da tela de consentimento OAuth no console do Google Cloud para evitar erros APIException.
4. Inclua o arquivo google-services.json em android/app caso utilize serviços do Google que o exijam.

Armazenamento de preferências com Firestore

O aplicativo utiliza o Cloud Firestore para salvar informações básicas do usuário, como nome, e-mail e idioma preferido. As regras de segurança em firestore.rules garantem que cada usuário acesse apenas seus próprios dados. Para aplicar as regras execute firebase deploy --only firestore:rules após configurar o Firebase CLI.

Monitoramento com Firebase Analytics

O projeto já inclui suporte ao Firebase Analytics e ao Firebase Performance. Os eventos básicos registrados podem ser encontrados em docs/analytics_events.md.

Relatórios de falhas com Firebase Crashlytics

O aplicativo também está configurado para enviar relatórios de falhas para o Firebase Crashlytics. Todas as exceções não tratadas são capturadas automaticamente, permitindo acompanhar erros em produção tanto no Android quanto no iOS.

AdMob

Siga estas instruções:

ANDROID Odsy: AI Travel Assistant

ca-app-pub-3852573623829744~8339600928

Card lista de destinos ca-app-pub-3852573623829744/7647667487

Banner simples lista de resultados ca-app-pub-3852573623829744/7294128476