CheckTheethKids/documentação/01-estrutura-do-projeto.md

Estrutura do Projeto - Check Theeth Kids

Visão Geral

O Check Theeth Kids é um aplicativo Flutter desenvolvido para ajudar crianças e pais a manterem uma boa saúde bucal através de educação interativa, quizzes e acompanhamento.

Estrutura de Pastas

check_theeth_kids/
├── lib/
│   ├── main.dart                    # Ponto de entrada da aplicação
│   ├── logged_home.dart             # Tela principal para usuários logados
│   ├── auth_gate.dart               # Gerenciamento de autenticação
│   ├── home_screen.dart             # Tela inicial para não logados
│   ├── gates/
│   │   └── debug_launch_gate.dart   # Controle de inicialização
│   ├── quiz/                        # Sistema de quiz educativo
│   │   ├── quiz1.dart               # Quiz completo com 20 perguntas
│   │   ├── quiz2.dart               # (obsoleto - integrado ao quiz1.dart)
│   │   ├── quiz3.dart               # (obsoleto - integrado ao quiz1.dart)
│   │   ├── quiz4.dart               # (obsoleto - integrado ao quiz1.dart)
│   │   ├── quiz5.dart               # (obsoleto - integrado ao quiz1.dart)
│   │   ├── quiz_extended.dart      # (obsoleto - integrado ao quiz1.dart)
│   │   ├── quiz_complete.dart      # Backup do sistema completo
│   │   ├── quiz_question_screen.dart # Tela genérica de perguntas
│   │   ├── quiz_result.dart        # Tela de resultados do quiz
│   │   ├── quiz_prefs.dart         # Preferências e configurações
│   │   └── quiz_random.dart         # Sistema de quiz aleatório
│   ├── screens/
│   │   ├── hello_splash_screen.dart # Tela de splash inicial
│   │   ├── curiosidade_screen.dart # Tela de curiosidades
│   │   └── video_screen.dart        # Tela de vídeos educativos
│   └── assets/                      # Recursos estáticos
│       ├── images/
│       ├── animations/
│       └── videos/
├── documentação/                    # Documentação do projeto
├── pubspec.yaml                     # Dependências e configurações
└── README.md                       # Documentação geral

Arquivos Principais

Arquivos de Navegação e Autenticação

main.dart

• Função: Ponto de entrada da aplicação
• Responsabilidade: Inicializa Firebase e define o widget raiz MyApp
• Importância: Essencial para o funcionamento do app

auth_gate.dart

• Função: Gerenciamento de estado de autenticação
• Lógica:
  • Se usuário logado → LoggedHomeScreen
  • Se não logado → HomeScreen
• Dependências: Firebase Auth

gates/debug_launch_gate.dart

• Função: Controle de inicialização e splash screen
• Responsabilidade: Gerencia transição entre splash e autenticação

Tela Principal do Aplicativo

logged_home.dart

• Função: Tela principal para usuários autenticados
• Componentes:
  • AppBar animado com informações do usuário
  • Sistema de perfil com upload de fotos
  • Gerenciamento de crianças
  • Seção de clínicas parceiras
  • Biblioteca de vídeos educativos
  • Sistema de quiz integrado
  • Interface com animações Lottie
• Estado: StatefulWidget com múltiplos gerenciadores de estado

Sistema de Quiz

quiz/quiz1.dart (ARQUIVO PRINCIPAL)

• Função: Sistema completo de quiz com 20 perguntas
• Estrutura: Contém todas as 20 perguntas em um único arquivo
• Fluxo: Quiz1 → Quiz2 → ... → Quiz20 → Resultados
• Pontuação: Máximo de 100 pontos (5 pontos por pergunta)

quiz/quiz_question_screen.dart

• Função: Tela genérica reutilizável para perguntas
• Componentes:
  • Exibição de perguntas e respostas
  • Sistema de navegação (próximo/anterior)
  • Feedback visual para respostas
  • Controle de pontuação

quiz/quiz_result.dart

• Função: Tela de resultados com feedback personalizado
• Recursos:
  • Exibição de pontuação final
  • Mensagens motivacionais baseadas no desempenho
  • Opção de refazer o quiz

Tela de Conteúdo Educativo

screens/curiosidade_screen.dart

• Função: Exibição de curiosidades sobre saúde bucal
• Recursos: Conteúdo educativo com imagens e textos

screens/video_screen.dart

• Função: Reprodução de vídeos educativos
• Integração: YouTube Player para conteúdo em vídeo

Tela Inicial

home_screen.dart

• Função: Tela de boas-vindas para usuários não autenticados
• Componentes: Botões de login e cadastro

screens/hello_splash_screen.dart

• Função: Tela de splash inicial com animações
• Duração: Transição automática para tela principal

Fluxo da Aplicação

1. Inicialização: main.dart → DebugLaunchGate
2. Splash: HelloSplashScreen (2-3 segundos)
3. Autenticação: AuthGate verifica estado do usuário
4. Tela Principal:
   • Não logado → HomeScreen
   • Logado → LoggedHomeScreen
5. Navegação Interna:
   • Quiz → Sistema de 20 perguntas
   • Vídeos → VideoScreen
   • Curiosidades → CuriosidadeScreen
   • Perfil → Sistema de gerenciamento

Dependências Principais

Firebase

• firebase_core: Configuração base
• firebase_auth: Autenticação de usuários
• cloud_firestore: Banco de dados
• firebase_storage: Armazenamento de imagens

UI e Animações

• flutter/material.dart: UI Material Design
• lottie: Animações vetoriais
• youtube_player_flutter: Reprodução de vídeos

Utilitários

• image_picker: Seleção de imagens da galeria/câmera
• shared_preferences: Armazenamento local de preferências

Configurações Importantes

Firebase

• Projeto: check-theeth-kids-db
• Configuração: Necessário arquivo google-services.json (Android) e GoogleService-Info.plist (iOS)

Assets

• Imagens: Configuradas em pubspec.yaml
• Animações: Arquivos Lottie na pasta assets/animations/
• Vídeos: Integrados via YouTube Player

Estado Atual do Projeto

✅ Funcionalidades Completas

• Sistema de autenticação Firebase
• Tela principal com todas as funcionalidades
• Sistema de quiz com 20 perguntas
• Upload e gerenciamento de fotos de perfil
• Sistema de gerenciamento de crianças
• Biblioteca de vídeos educativos
• Sistema de resultados do quiz

⚠️ Pontos de Atenção

• Configuração Firebase Web requer credenciais específicas
• Algumas dependências podem estar desatualizadas (43 packages com versões mais recentes)
• Sistema de quiz completamente integrado em um único arquivo

🔄 Manutenção

• Atualização de dependências: Recomendado revisar packages desatualizados
• Firebase Web: Configurar credenciais para plataforma web
• Testes: Implementar testes unitários e de integração

Próximos Passos Recomendados

1. Atualização de Dependências: Revisar e atualizar packages desatualizados
2. Configuração Firebase Web: Adicionar credenciais para plataforma web
3. Testes Automatizados: Implementar suíte de testes
4. Otimização: Revisar performance e otimizar carregamento
5. Documentação de API: Documentar endpoints e estruturas de dados