🧠 StopBet Flutter

Aplicativo móvel para controle comportamental e gamificação desenvolvido em Flutter.

📋 Pré-requisitos

• Flutter 3.0+
• Dart 3.0+
• Android Studio / VS Code
• API Laravel rodando (ver stopbet-api)

🚀 Instalação e Configuração

1. Clone o repositório

git clone <repository-url>
cd stopbet-flutter

2. Instale as dependências

flutter pub get

3. Configure a API

Certifique-se de que a API Laravel está rodando (ver stopbet-api) e configure a URL base no arquivo:

// lib/config/environment_config.dart
class EnvironmentConfig {
  static const String apiBaseUrl = 'http://localhost:8000/api';
}

4. Execute o aplicativo

flutter run

📱 Funcionalidades

🔐 Autenticação

• Registro de usuário
• Login/Logout
• Perfil do usuário
• Alteração de senha

🎯 Metas de Compromisso

• Criação de metas personalizadas
• Check-ins diários
• Acompanhamento de sequências
• Histórico de progresso

📊 Eventos de Comportamento

• Registro de eventos positivos e negativos
• Análise de padrões
• Estatísticas de progresso

🏆 Sistema de Badges

• Badges automáticas baseadas em conquistas
• Visualização de badges conquistadas
• Progresso para próximas badges

📝 Blog e Conteúdo

• Artigos educativos
• Dicas de controle comportamental
• Conteúdo personalizado

🏗️ Arquitetura

Estrutura de Pastas

lib/
├── config/           # Configurações do app
├── models/           # Modelos de dados
├── providers/        # Gerenciamento de estado
├── screens/          # Telas do aplicativo
├── services/         # Serviços (API, etc.)
├── utils/            # Utilitários
└── widgets/          # Widgets reutilizáveis

Tecnologias Utilizadas

• Flutter: Framework de desenvolvimento
• Provider: Gerenciamento de estado
• HTTP: Comunicação com API
• Shared Preferences: Armazenamento local
• JWT: Autenticação

🔧 Configuração de Desenvolvimento

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto:

API_BASE_URL=http://localhost:8000/api
DEBUG_MODE=true

Configuração da API

O aplicativo se conecta à API Laravel. Certifique-se de que:

1. A API está rodando em http://localhost:8000
2. As rotas da API estão configuradas corretamente
3. O CORS está habilitado na API

📱 Executando em Diferentes Plataformas

Android

flutter run -d android

iOS

flutter run -d ios

Web

flutter run -d chrome

🧪 Testes

# Executar todos os testes
flutter test

# Executar testes específicos
flutter test test/widget_test.dart

📦 Build

Android APK

flutter build apk --release

Android App Bundle

flutter build appbundle --release

iOS

flutter build ios --release

🔄 Integração com API

O aplicativo se integra com a API Laravel através do ApiService. Principais endpoints:

• Autenticação: /api/login, /api/register, /api/logout
• Metas: /api/commitment-goals
• Eventos: /api/behavior-events
• Badges: /api/badges
• Perfil: /api/profile

🐛 Debugging

Logs

flutter logs

DevTools

flutter run --debug

Hot Reload

Pressione r no terminal para hot reload ou R para hot restart.

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📞 Suporte

Para suporte, envie um email para [seu-email@exemplo.com] ou abra uma issue no repositório.

🔗 Links Relacionados

• API Laravel - Backend da aplicação
• Documentação Flutter
• Documentação Provider