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

🏛️ P19: Banco de Wakanda (MVVM & Room)

v1.0 — Android Jetpack, Kotlin, Arquitetura MVVM em Camadas, Injeção com Dagger Hilt, Room Database, Padrão Repository e StateFlow Reativo

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

• P18: Radar de Habilidades com Canvas 2D
• ➡️ P19 (este): Banco de Wakanda com MVVM & Room
• P20: Alliance Battle com Finite State Machine
• P21: Duelo Jedi com Física 2D & Colisão

🏛️ Visão Geral & Arquitetura Visual

O projeto Banco de Wakanda consolida a arquitetura corporativa recomendada pelo Google para engenharia de aplicativos móveis no Android: Model-View-ViewModel (MVVM) aliada à injeção de dependências com Dagger Hilt, desacoplamento da camada de dados via Repository Pattern, persistência local transacional com Room Database e exposição de estados de tela imutáveis através de StateFlow. O app gerencia a conta do tesouro real de Vibranium com histórico de transações e saldo consolidado.

📁 Estrutura de Pastas Anti-Colisão

Todas as camadas arquiteturais, módulos Hilt e telas residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p19_banco_mvvm_hilt/
├── assets/
│   ├── mockup_banco_fluxo.svg
│   ├── screenshot_01_banco_vazio.svg
│   ├── screenshot_02_banco_sincronizado.svg
│   └── screenshot_03_banco_dialog.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/bancowakanda/
│   │   │       │   ├── di/
│   │   │       │   │   └── DatabaseModule.kt
│   │   │       │   ├── data/
│   │   │       │   │   ├── TransacaoEntity.kt
│   │   │       │   │   └── TransacaoDao.kt
│   │   │       │   ├── repository/
│   │   │       │   │   └── ContaRepository.kt
│   │   │       │   ├── ui/
│   │   │       │   │   ├── ContaViewModel.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: Mapear entidade TransacaoEntity com valor, tipo (Crédito/Débito) e timestamp.
• RF-02: Definir DAO com operações suspensas para inserção e consulta ordenada por data.
• RF-03: Implementar classe ContaRepository mediando o acesso entre DAO e ViewModel.
• RF-04: Configurar ContaViewModel expondo StateFlow<ContaUiState> imutável.
• RF-05: Disponibilizar injeção de dependências em todo o grafo com Dagger Hilt.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Separação de Responsabilidades): Zero lógica de negócios ou consultas SQL dentro da Activity.
• RNF-02 (Fluxo Unidirecional de Dados - UDF): A UI emite intenções e reage a estados atômicos imutáveis.
• RNF-03 (Segurança de Thread): Escritas e leituras de banco obrigatoriamente no despachante Dispatchers.IO.
• RNF-04 (Compatibilidade de Versão): Suporte estável desde Android API 21 até Android API 34.
• RNF-05 (Testabilidade): Suporte a substituição fácil de dependências para testes de unidade automatizados.

3. Diagrama de Casos de Uso

flowchart TD
    User([fa:fa-user Cidadão / Usuário])
    VM[(fa:fa-layer-group ContaViewModel)]
    Repo[(fa:fa-boxes-packing ContaRepository)]
    DB[(fa:fa-database Room Database)]

    subgraph AppWakanda ["🏛️ Banco de Wakanda (mobile-android-kotlin)"]
        UC01["Consultar Saldo Consolidado"]
        UC02["Efetuar Lançamento de Transação"]
        UC03["Recalcular Saldo Atômico"]
        UC04["Atualizar Lista no RecyclerView"]
        UC05["Injetar Dependências com Hilt"]
    end

    User --> UC01
    User --> UC02
    UC01 --> VM
    UC02 --> VM
    VM --> Repo
    Repo --> DB
    DB -.->|Flow| Repo
    Repo -.->|StateFlow| VM
    VM -.->|StateFlow| UC04

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e execute os testes de unidade

./gradlew test
./gradlew assembleDebug

🏁 Matriz de Checkpoints de Conclusão