📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Especialização em Android Nativo. Recomendado revisar antes de iniciar.

⏱️ P05: Quiz Game com Cronômetro Decrescente em Kotlin

v1.0 — Android Nativo, Kotlin, CountDownTimer, Barra de Progresso Circular e Gestão de Tempo Real

Série Prática Android Clássico — Projeto 5 de 21

• P01: Dados RPG (2D, 3D & Ciclo de Vida)
• P02: Jogo da Memória (PNG & POC)
• P03: Genius / Simon Says Clássico & Demo de Áudio
• P04: Cartão de Visitas Digital em ConstraintLayout
• ➡️ P05 (este): Quiz Game com Cronômetro Decrescente

🏛️ Visão Geral & Arquitetura Visual

O Quiz Game com Cronômetro Decrescente introduz a mecânica de contagem regressiva em tempo real com alta precisão temporal no Android. Utilizando a classe utilitária CountDownTimer, o aplicativo gerencia o tempo limite por pergunta (ex: 15 segundos), sincroniza o avanço visual em um componente ProgressBar circular com transição dinâmica de cores (verde para tempo seguro, amarelo para alerta e vermelho para iminência de estouro) e pontua os acertos com bônus de agilidade.

📁 Estrutura de Pastas Anti-Colisão

Todos os artefatos de código, modelos de questão e arquivos XML estão na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p05_quiz_timer/
├── assets/
│   ├── arquitetura_quiz_timer.svg
│   └── screenshot_p05_start.png
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/quiztimer/
│   │   │       │   ├── model/Questao.kt
│   │   │       │   └── MainActivity.kt
│   │   │       ├── res/
│   │   │       │   ├── drawable/
│   │   │       │   └── layout/activity_main.xml
│   │   │       └── AndroidManifest.xml
│   │   └── build.gradle
│   ├── gradle/
│   ├── build.gradle
│   ├── gradlew
│   ├── settings.gradle
│   └── README.md
└── index.md

🧑‍💼 Engenharia de Software & Especificação Formal

1. Histórias de Usuário (User Stories)

2. Requisitos do Sistema

Requisitos Funcionais (RF)

• RF-01: Exibir enunciado da questão e 4 alternativas com botões customizados.
• RF-02: Inicializar temporizador CountDownTimer com duração de 15000ms e tique de 1000ms.
• RF-03: Sincronizar o progresso decrescente da ProgressBar no callback onTick(millisUntilFinished).
• RF-04: Bloquear os botões de resposta após a escolha do usuário ou no estouro do tempo (timeout).
• RF-05: Computar o placar acumulado e exibir relatório de aproveitamento no término da rodada de perguntas.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Precisão Temporal): Desvio temporal máximo inferior a 50ms entre os tiques do cronômetro.
• RNF-02 (Prevenção de Leaks): Cancelamento explícito do timer durante eventos de ciclo de vida da Activity.
• RNF-03 (Performance Gráfica): Animações suaves de progresso mantendo taxa constante de 60 FPS.
• RNF-04 (Compatibilidade de Plataforma): Suporte nativo completo a partir de Android API 21 até API 34.
• RNF-05 (Segurança de Estado): Imutabilidade na coleção de questões e isolamento no modelo de dados Questao.

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador de Quiz])
    Timer[(fa:fa-clock CountDownTimer)]

    subgraph AppQuiz ["⏱️ Quiz Game (mobile-android-kotlin)"]
        UC01["Carregar Nova Pergunta"]
        UC02["Iniciar Cronômetro Regressivo"]
        UC03["Submeter Alternativa Escolhida"]
        UC04["Tratar Estouro de Tempo (Timeout)"]
        UC05["Exibir Placar com Bônus de Tempo"]
    end

    Player --> UC01
    UC01 --> UC02
    UC02 --> Timer
    Timer -.->|onTick| UC02
    Timer -.->|onFinish| UC04
    Player --> UC03
    UC03 --> UC05
    UC04 --> UC05

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (MainActivity.kt)

ℹ️ O trecho de código que ficava aqui não correspondia ao código do projeto e foi retirado. Consulte os arquivos em mobile-android-kotlin.

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p05_quiz_timer/mobile-android-kotlin

2. Compile e execute no emulador ou dispositivo físico

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão