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

🏰 P11: Guilda dos Heróis (Navigation Compose & Biometria)

v1.0 — Android Nativo, Kotlin, Jetpack Compose Declarativo, Navigation Compose, BiometricPrompt e Android Keystore de Hardware

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

• P10: Arena Social com Firebase Suite
• ➡️ P11 (este): Guilda dos Heróis com Navigation & Biometria
• P12: Batcomputer com Injeção Hilt & Sensores
• P13: TARDIS Panel com DataStore Preferences
• P14: Portais Dimensionais com Notificações Push

🏛️ Visão Geral & Arquitetura Visual

O projeto Guilda dos Heróis une a modernidade visual do Jetpack Compose à segurança biométrica de nível bancário no Android. A aplicação utiliza o Navigation Compose para estruturar um grafo de navegação modular entre Lista de Heróis, Ficha Detalhada e a cobiçada “Sala dos Tesouros”. O acesso a essa área restrita exige validação biométrica rigorosa via BiometricPrompt com fallback para credenciais do dispositivo, integrada a chaves criptográficas geradas no hardware seguro Android Keystore.

📁 Estrutura de Pastas Anti-Colisão

Todos os composables, gráficos de navegação e serviços de segurança estão contidos na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p11_herois_biometria/
├── assets/
│   ├── mockup_guilda_fluxo.svg
│   ├── screenshot_01_lista_herois.svg
│   ├── screenshot_02_detalhe_heroi.svg
│   ├── screenshot_03_biometria_prompt.svg
│   └── screenshot_04_sala_tesouros.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/guildaherois/
│   │   │       │   ├── security/
│   │   │       │   │   └── BiometriaManager.kt
│   │   │       │   ├── ui/
│   │   │       │   │   └── NavGraph.kt
│   │   │       │   └── MainActivity.kt
│   │   │       └── res/
│   │   └── 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: Construir grafo de navegação (NavHost) com rotas tipadas para Lista, Detalhe e Sala dos Tesouros.
• RF-02: Verificar disponibilidade de hardware biométrico através de BiometricManager.canAuthenticate().
• RF-03: Configurar diálogo nativo BiometricPrompt.PromptInfo com título, subtítulo e cancelamento.
• RF-04: Bloquear a recomposição da tela de tesouros até o recebimento do callback onAuthenticationSucceeded.
• RF-05: Criptografar dados sensíveis de recompensa utilizando chave AES-256 gerada no Android Keystore.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Segurança de Hardware): Execução no Trusted Execution Environment (TEE) ou Secure Element quando suportado.
• RNF-02 (Fluidez Declarativa): Interface em Jetpack Compose com taxa estável de 60/120 FPS.
• RNF-03 (Modularidade de Rotas): Desacoplamento entre telas e controlador de navegação (NavController).
• RNF-04 (Compatibilidade de API): Suporte nativo desde Android 6.0 (API 23) até Android 14 (API 34).
• RNF-05 (Privacidade): Nenhuma informação biométrica física acessível diretamente pelo código Kotlin.

3. Diagrama de Casos de Uso

flowchart TD
    Leader([fa:fa-user Líder de Guilda])
    Bio[(fa:fa-fingerprint Sensor Biométrico)]
    Vault[(fa:fa-gem Sala dos Tesouros)]

    subgraph AppGuilda ["🏰 Guilda dos Heróis (mobile-android-kotlin)"]
        UC01["Explorar Lista de Heróis"]
        UC02["Solicitar Acesso ao Cofre"]
        UC03["Disparar BiometricPrompt"]
        UC04["Validar Impressão Digital"]
        UC05["Liberar Sala dos Tesouros"]
    end

    Leader --> UC01
    Leader --> UC02
    UC02 --> UC03
    UC03 --> Bio
    Bio --> UC04
    UC04 -->|Sucesso| UC05
    UC05 --> Vault

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (BiometriaManager.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_p11_herois_biometria/mobile-android-kotlin

2. Compile e instale em dispositivo com leitor de digital configurado

./gradlew installDebug

🏁 Matriz de Checkpoints de Conclusão