Desenvolvimento de Aplicativo Mobile de Competição Fitness Gamificado

Projeto - fitness challenge app
1) objetivo do produto
construir um aplicativo de gamificação de atividade física entre amigos, com foco em simplicidade (mvp), código limpo/modular e backend escalável.
2) Princípios obrigatórios
- Simplicidade (MVP first)
- Código limpo e modular
- Evitar overengineering
- Escalabilidade progressiva
3) Escopo do MVP
- Autenticação (login, cadastro, recuperação)
- Perfil básico
- Criação e participação em desafios
- Check-in manual com foto e comentário
- Sistema de pontuação
- Ranking por desafio
4) Sistema de pontuação
Leve: 50 pontos
Moderado: 100 pontos
Intenso: 200 pontos
Longão: 200 pontos
Folga: 100 pontos
Falta: ZERO pontos
5) Regras de desafios
- Usuário cria desafio
- Define período e folgas
- Entrada por convite ou solicitação
- Aprovação obrigatória
6) Check-in
- Manual
- Foto obrigatória
- Comentário obrigatório
- Timestamp
- Sem duplicidade
7) Ranking
- Soma de pontos
- Dentro do período
- Desempate por timestamp
8) Arquitetura técnica esperada
- Backend REST modular
- Separação por domínios: auth, user, challenge, checkin, ranking
- Estrutura preparada para evolução futura
9) Diretrizes técnicas para FlutterFlow
- Utilizar componentes reutilizáveis
- Criar Custom Actions em Dart
- Evitar lógica crítica em widgets
- Garantir reutilização e organização
10) Integração com APIs
- Mapear endpoints via Swagger/Postman
- Padronizar requests/responses
- Validar contratos antes da implementação
- Tratar erros
- Usar Bearer Token
11) Performance e sincronização
- Manter dados atualizados
- Evitar chamadas desnecessárias
- Estratégia de refresh eficiente
12) Estrutura de dados
- User
- Challenge
- CheckIn
- ScoreEntry
13) Regras críticas
- Idempotência
- Sem duplicidade
- Versionamento
14) Fora do escopo MVP
- Integrações
- IA
- Marketplace
- Chat
15) Entregáveis
- Código versionado
- Documentação API
- Setup local
- Testes básicos
16) Observação final
Foco em MVP simples, funcional e validável rapidamente.
 
Plano de Entregas
Entrega 1: Base Técnica e Autenticação (Dias 1-2)
Objetivo: Garantir fundação sólida do app
Escopo:
- Configuração de APIs no FlutterFlow (API Group, headers, auth)
- Persistência de token (App State)
- Telas:
  • Login
  • Cadastro
  • Esqueci senha
- Estrutura de Data Types e parsing de JSON
- Validação de e-mail e senha
- Exibição de snackbar para erro (email/senha incorretos)
- Funcionalidade de criação de usuário na tela de Login
- Funcionalidade de reset de senha na tela de Login
Critério de aceite:
Usuário consegue:
- Criar conta
- Logar
- Receber feedback visual em caso de erro (snackbar)
- Resetar senha
- Acessar área protegida
Token persistido corretamente
Entrega 2.1: Criação de Desafio
Objetivo: Permitir criação estruturada de desafios
Escopo:
- Qualquer usuário pode criar desafio
- Definir duração (data início e fim)
- Definir quantidade de folgas por usuário
- Nome do desafio
- Privado / público
- Limite de participantes
Critério de aceite:
- Usuário cria desafio com parâmetros definidos
- Desafio disponível para entrada de outros usuários
Entrega 2.2: Entrada e Configuração do Usuário no Desafio
Objetivo: Definir regras individuais antes da competição
Escopo:
- Usuário entra em desafio existente
- Definir tipos de treino:
  • Leve
  • Moderado
  • Intenso
  • Longão
- Definir modalidade (ex: corrida, yoga, musculação)
- Definir forma de metrificação:
  • Tempo (minutos)
  • Quantidade (repetições)
  • Distância (km)
  • (Sugestão) sessões/treinos concluídos
Critério de aceite:
- Usuário entra no desafio
- Configura seus parâmetros de treino corretamente
Entrega 2.3: Check-in e Regras de Engajamento
Objetivo: Implementar lógica de participação diária e gamificação
Escopo:
- Usuário registra 1 atividade por dia (limite máximo)
- Tipos possíveis no check-in:
  • Leve
  • Moderado
  • Intenso
  • Longão
  • Folga

- Sistema valida se usuário possui folga disponível
- Caso não tenha folga:
  • Exibir erro: 'Você não possui folga disponível'
  • Registrar como falta
- Regra de falta:
  • 3 dias sem registro → considerado falta automática
-
Regra de streak:
  • A cada 6 dias consecutivos → ganha 1 folga
- Pontuação:
  • Falta → 0 pontos
  • Folga → equivalente a treino moderado (sem impacto competitivo – 100 pontos)

Critério de aceite:
- Sistema impede mais de 1 check-in por dia
- Sistema valida corretamente uso de folga
- Streak gera folga automaticamente
- Falta e folga aplicadas corretamente
Entrega 3: Refinamento e Finalização (Dias 6-7)
Objetivo: Deixar pronto para teste real
Escopo:
- Tela de perfil (edição básica)
- Ajustes de UX/UI
- Otimização de chamadas de API
- Tratamento de erros global
Critério de aceite:
- App fluido
- Sem bugs críticos
- Pronto para testes com usuários