Show-da-Qualificacao

# 🏆 Show da Qualificação **Aplicativo de estudo gamificado para a prova IS-N1 de Inspeção de Soldagem** [![Flutter](https://img.shields.io/badge/Flutter-3.x-02569B?style=for-the-badge&logo=flutter&logoColor=white)](https://flutter.dev) [![Dart](https://img.shields.io/badge/Dart-3.x-0175C2?style=for-the-badge&logo=dart&logoColor=white)](https://dart.dev) [![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE) [![Platform](https://img.shields.io/badge/Platform-Android%20%7C%20iOS-green?style=for-the-badge)](https://flutter.dev)

📖 Sobre o Projeto

O Show da Qualificação é um aplicativo mobile de estudo gamificado, inspirado no programa “Show do Milhão”, voltado para candidatos à certificação IS-N1 (Inspetor de Soldagem Nível 1). O app transforma o processo de estudo em uma experiência interativa e motivadora, com sistema de pontuação, conquistas, progressão de nível e efeitos sonoros.

Por que este app?

A prova IS-N1 cobre 14 áreas de conhecimento e exige domínio de normas técnicas (AWS, ASME), processos de soldagem, ensaios mecânicos e não destrutivos, entre outros. O Show da Qualificação torna esse estudo mais eficiente e engajante.


✨ Funcionalidades

Funcionalidade Descrição
🎯 4 Modalidades de Prova Teórica Geral, Documentos Técnicos, Tratamento Térmico e Dureza
⏱️ Timer por Questão 40 segundos para responder cada questão, com indicador visual colorido
🃏 Lifelines Dica (elimina 2 alternativas) e Pular (volta a questão no final) — 3 de cada
🏅 12 Conquistas Desbloqueie conquistas com animação de partículas e som
📈 8 Níveis de Progressão De Novato a Mestre, baseado em XP acumulado
💾 Salvar Progresso Pause e continue a prova de onde parou
📊 Estatísticas Detalhadas Histórico de acertos, erros e precisão por sessão
🔊 Efeitos Sonoros Sons de acerto, erro, conquista, vitória, derrota e música de tensão
🔒 Modalidades Bloqueadas Desbloqueie provas avançadas ao atingir 80% na anterior
📱 Responsivo Layout adaptado a qualquer tamanho de tela

🎮 Mecânica do Jogo

Estrutura da Prova — Teórica Geral

A prova Teórica Geral gera 50 questões aleatórias respeitando a distribuição oficial do IS-N1:

Código Área Questões
CONS Consumíveis de Soldagem 4
DOCS Documentos Técnicos de Soldagem 3
ENSM Ensaios Mecânicos 4
ENSND Ensaios Não Destrutivos 4
INST Instrumental e Técnicas de Medidas 3
INTR Introdução 2
MATB Materiais de Base 4
META Metalurgia da Soldagem 4
PROC Processos de Soldagem 5
PROT Proteção na Soldagem 2
QUAL Qualificações 4
SIMB Simbologia de Soldagem 5
TENS Tensões e Deformações na Soldagem 3
TERM Terminologia de Soldagem 3
Total   50

Critério de Aprovação

Sistema de XP e Níveis

Nível Título XP Necessário
1 Novato 0
2 Aprendiz 15
3 Técnico 40
4 Inspetor Jr. 80
5 Inspetor 150
6 Inspetor Sr. 280
7 Especialista 500
8 Mestre 800

XP = número total de questões respondidas corretamente

Conquistas

Conquista Critério
1ª Prova Completar 1 prova
5 Provas Completar 5 provas
20 Provas Completar 20 provas
Veterano Completar 50 provas
10 Acertos 10 respostas corretas
50 Acertos 50 respostas corretas
100 Acertos 100 respostas corretas
Aprovado! Atingir 80%+ em qualquer modalidade
Precisão 80% Precisão geral ≥ 80% (mín. 3 provas)
Precisão 90% Precisão geral ≥ 90% (mín. 5 provas)
Explorador Aprovar em Documentos Técnicos
Mestre 800 XP acumulados

🛠️ Tecnologias Utilizadas


📁 Estrutura do Projeto

lib/
├── main.dart                  # Ponto de entrada
├── splash_screen.dart         # Tela de splash animada
├── loading_screen.dart        # Tela de carregamento
├── player_name_screen.dart    # Cadastro de nome do jogador
├── home_screen.dart           # Tela inicial (seleção de modalidade)
├── quiz_screen.dart           # Tela da prova (timer, lifelines, questões)
├── result_screen.dart         # Tela de resultado
├── rules_screen.dart          # Regras da prova
├── statistics_screen.dart     # Estatísticas do jogador
├── achievement_overlay.dart   # Overlay animado de conquista
├── ambient_sparks.dart        # Efeito visual de partículas ambiente
├── models/
│   └── question.dart          # Modelo de questão
├── services/
│   └── exam_service.dart      # Geração e carregamento de provas
└── data/
    └── exam_config.dart       # Configuração de grupos de questões

assets/
├── images/
│   └── logo.png
├── questions/
│   └── teorica_geral.json     # Banco de 247 questões (IS-N1)
└── sounds/
    ├── acertou.mp3
    ├── errou.mp3
    ├── achievement.mp3
    ├── time.mp3
    ├── victory.mp3
    └── defeat.mp3

🚀 Como Executar

Pré-requisitos

Instalação

# Clone o repositório
git clone https://github.com/lucaasxz/Show-da-Qualificacao.git

# Entre no diretório
cd Show-da-Qualificacao

# Instale as dependências
flutter pub get

# Execute o app
flutter run

Build para produção

# Android APK
flutter build apk --release

# Android App Bundle (recomendado para Play Store)
flutter build appbundle --release

# iOS
flutter build ios --release

🏗️ Arquitetura

O app segue uma arquitetura simples baseada em StatefulWidget com separação em:

O estado do jogo é persistido localmente via SharedPreferences (XP, nível, histórico, provas salvas).


🤝 Contribuindo

Contribuições são bem-vindas! Siga os passos:

  1. Faça um fork do projeto
  2. Crie uma branch para sua feature: git checkout -b feature/nova-funcionalidade
  3. Commit suas mudanças: git commit -m 'feat: adiciona nova funcionalidade'
  4. Faça push para a branch: git push origin feature/nova-funcionalidade
  5. Abra um Pull Request

Consulte o arquivo CONTRIBUTING.md para mais detalhes.


📋 Roadmap


📄 Licença

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


Desenvolvido por **Lucas Vinicius** — estudo para IS-N1 nunca foi tão divertido 🎯