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

🦇 P12: Batcomputer (Injeção com Hilt & Sensores)

v1.0 — Android Nativo, Kotlin, Injeção de Dependências com Dagger Hilt, SensorManager, Acelerômetro, Giroscópio e HUD Futurista

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

• P11: Guilda dos Heróis com Navigation & Biometria
• ➡️ P12 (este): Batcomputer com Injeção Hilt & Sensores
• P13: TARDIS Panel com DataStore Preferences
• P14: Portais Dimensionais com Notificações Push
• P15: Jarvis com WorkManager em Segundo Plano

🏛️ Visão Geral & Arquitetura Visual

O projeto Batcomputer simula o terminal tático do Cavaleiro das Trevas combinando a arquitetura moderna de Injeção de Dependências com Dagger Hilt à telemetria de sensores físicos de hardware do smartphone. A aplicação injeta instâncias desacopladas de SensorManager, processa vetores tridimensionais (eixos X, Y e Z) do Acelerômetro e Giroscópio do aparelho em tempo real e desenha uma interface HUD neon que reage com animações à inclinação, aceleração e impactos físicos.

📁 Estrutura de Pastas Anti-Colisão

Os módulos Hilt, serviços de sensores e telas estão contidos na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p12_batcomputer_sensores/
├── assets/
│   ├── mockup_batcomputer_fluxo.svg
│   ├── screenshot_01_batcomputer_hud.svg
│   ├── screenshot_02_sensor_impacto.svg
│   └── screenshot_03_filtro_arkham.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/batcomputer/
│   │   │       │   ├── di/
│   │   │       │   │   └── SensorModule.kt
│   │   │       │   ├── sensor/
│   │   │       │   │   └── BatSensorManager.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: Configurar módulo Hilt @Module provendo instâncias de SensorManager e Sensor.TYPE_ACCELEROMETER.
• RF-02: Registrar ouvinte SensorEventListener com taxa de amostragem SENSOR_DELAY_GAME.
• RF-03: Calcular aceleração resultante: $\sqrt{X^2 + Y^2 + Z^2}$ para identificar gestos de tremor (shake).
• RF-04: Atualizar os mostradores do HUD visual em tempo real através de StateFlow reativo.
• RF-05: Interromper a escuta de hardware no ciclo onPause() e retomar no onResume().

Requisitos Não-Funcionais (RNF)

• RNF-01 (Injeção Limpa): Adoção estrita de Dagger Hilt com geração KSP sem dependências cíclicas.
• RNF-02 (Filtro Passa-Baixa): Aplicação de algoritmo de suavização matemática (low-pass filter) para atenuar ruídos de leitura.
• RNF-03 (Performance de UI): Atualização dos ponteiros do HUD a 60 FPS sem engasgos.
• RNF-04 (Compatibilidade de Sensores): Fallback gracioso com mensagem amigável caso o hardware não possua acelerômetro.
• RNF-05 (Compatibilidade de Versão): Suporte estável desde Android API 24 até Android API 34.

3. Diagrama de Casos de Uso

flowchart TD
    User([fa:fa-user Batman / Usuário Tático])
    Sensors[(fa:fa-microchip Hardware Sensores)]
    Hilt[(fa:fa-cube Dagger Hilt DI)]

    subgraph AppBatcomputer ["🦇 Batcomputer HUD (mobile-android-kotlin)"]
        UC01["Injetar SensorManager via Hilt"]
        UC02["Registrar Acelerômetro e Giroscópio"]
        UC03["Filtrar Ruído de Leitura (Passa-Baixa)"]
        UC04["Detectar Gesto de Impacto / Agito"]
        UC05["Atualizar Radar Tático Neon"]
    end

    Hilt --> UC01
    UC01 --> UC02
    Sensors --> UC02
    UC02 --> UC03
    UC03 --> UC04
    UC03 --> UC05
    User --> UC04
    UC05 --> User

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e instale em dispositivo físico com acelerômetro

./gradlew installDebug

🏁 Matriz de Checkpoints de Conclusão