Recursos nativos e externos

• dart:io HttpClient para consulta de localização aproximada em https://ipwho.is/
• dart:convert para serialização e desserialização JSON
• imagens remotas carregadas por URL, majoritariamente via Unsplash

Arquitetura atual

O projeto segue uma estrutura simples, orientada por telas, com estado local e um controlador central para autenticação.

Inicialização

• lib/main.dart
  • inicializa o Flutter
  • carrega o estado de autenticação
  • inicializa o serviço de notificações
  • trava a orientação em retrato
  • configura o modo de interface do sistema com base na preferência salva

Estado e autenticação

• lib/auth_controller.dart
  • concentra o estado da conta e da sessão
  • usa ChangeNotifier + InheritedNotifier (AppAuthScope) para disponibilizar autenticação no app
  • persiste os dados da conta em SharedPreferences

Observação técnica:

• a conta é salva como JSON local
• a senha também é mantida localmente
• esse modelo atende ao protótipo atual, mas não é adequado para produção sem backend e armazenamento seguro

Módulos de interface

• lib/home_page.dart: landing page e entrada para o app
• lib/dashboard_page.dart: catálogo, categorias, busca, localização e navegação principal
• lib/pet_detail_page.dart: detalhes do animal e CTA de adoção
• lib/profile_page.dart: fluxo de login/cadastro e resumo do perfil
• lib/profile_sections_page.dart: configurações, ajuda, histórico e páginas auxiliares
• lib/favorites_page.dart: lista demonstrativa de favoritos
• lib/chat_page.dart: lista e detalhe de conversas simuladas
• lib/notification_service.dart: encapsula notificações locais

Fonte de dados

Hoje o app não possui camada de API, repositório ou banco local estruturado. Os dados são distribuídos diretamente em listas estáticas dentro de arquivos como:

• lib/dashboard_page.dart
• lib/favorites_page.dart
• lib/chat_page.dart
• lib/pet_detail_page.dart
• lib/profile_sections_page.dart

Estrutura do projeto

adopet/
|- lib/
|  |- main.dart
|  |- auth_controller.dart
|  |- home_page.dart
|  |- dashboard_page.dart
|  |- pet_detail_page.dart
|  |- favorites_page.dart
|  |- chat_page.dart
|  |- profile_page.dart
|  |- profile_sections_page.dart
|  |- notification_service.dart
|- android/
|- pubspec.yaml
|- README.md

Como executar

Pré-requisitos

• Flutter SDK compatível com Dart ^3.11.4
• Android Studio ou Android SDK configurado
• Java 17
• emulador Android ou dispositivo físico

Instalação

flutter pub get

Execução em modo de desenvolvimento

flutter run

Geração de APK

flutter build apk --release

Permissões e comportamento em tempo de execução

• INTERNET: necessária para carregar imagens remotas e consultar localização aproximada
• notificações: solicitadas em tempo de execução quando o usuário ativa ou recebe eventos do app
• acesso à galeria: usado pelo seletor de imagem para foto de perfil

Dependências de rede

O comportamento atual do app depende de serviços externos para algumas experiências:

• ipwho.is: resolve cidade/região aproximada por IP
• URLs de imagem externas: utilizadas nas listagens e telas de detalhe

Se esses recursos estiverem indisponíveis, o app apresenta fallback visual ou textual em partes da interface.

Limitações técnicas atuais

• não existe backend para autenticação, catálogo, favoritos ou chat em tempo real
• favoritos, mensagens, histórico e "meus animais" são dados demonstrativos
• a conta do usuário fica armazenada localmente no dispositivo
• não há criptografia de credenciais
• o repositório não possui suíte de testes automatizados
• o projeto não inclui, neste estado, estrutura pronta para iOS, web ou desktop

Próximos passos recomendados

• integrar backend real para autenticação e catálogo de pets
• mover credenciais para armazenamento seguro e fluxo autenticado por token
• separar dados mockados em camada de repositório/serviço
• persistir favoritos e conversas por usuário
• adicionar testes de widget e testes de integração
• preparar suporte multiplataforma, se fizer sentido para o produto

Resumo técnico

O AdoPet é um aplicativo Flutter orientado a interface e experiência do usuário, com arquitetura simples e adequada para demonstração de fluxo. Ele já entrega navegação, persistência local de conta, notificações, personalização de perfil e apresentação de pets, servindo como base sólida para evoluir para uma aplicação conectada a serviços reais.