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

🌌 P13: TARDIS Panel (DataStore Preferences & Coroutines Flow)

v1.0 — Android Jetpack DataStore Preferences, Kotlin Coroutines Flow, Migração do SharedPreferences e Painel Quântico Temporal

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

• P11: Guilda dos Heróis com Navigation & Biometria
• P12: Batcomputer com Injeção Hilt & Sensores
• ➡️ P13 (este): 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 TARDIS Panel implementa a moderna biblioteca Jetpack DataStore Preferences como substituta oficial e assíncrona do legado SharedPreferences no Android. Inspirado no console de navegação temporal do Doctor Who, o aplicativo gerencia parâmetros críticos da nave (coordenadas do vórtice do tempo, modo de camuflagem camaleônica e nível de energia dos cristais Artron) de forma estritamente reativa através de fluxos imutáveis Flow<Preferences> e Kotlin Coroutines.

📁 Estrutura de Pastas Anti-Colisão

Os gerenciadores de DataStore, contratos de preferências e componentes de interface estão centralizados na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p13_tardis_services/
├── assets/
│   ├── mockup_tardis_fluxo.svg
│   ├── screenshot_01_tardis_azul.svg
│   ├── screenshot_02_tardis_neon.svg
│   └── screenshot_03_tardis_salto.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/tardispanel/
│   │   │       │   ├── datastore/
│   │   │       │   │   └── TardisPreferences.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: Instanciar o DataStore<Preferences> utilizando o delegado Kotlin preferencesDataStore(name = "tardis_prefs").
• RF-02: Definir chaves tipadas (stringPreferencesKey, booleanPreferencesKey, intPreferencesKey).
• RF-03: Expor fluxo reativo Flow<ConfiguracaoTardis> para consumo na camada de apresentação.
• RF-04: Gravar alterações de parâmetros de navegação temporal através da função suspensa edit { }.
• RF-05: Capturar exceções de I/O durante leitura/escrita emitindo emptyPreferences() como fallback seguro.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Segurança de Thread): Eliminação completa de operações síncronas de I/O de disco na Main Thread.
• RNF-02 (Consistência Transacional): Operações de escrita atômica gerenciadas sob o capô pelo protocolo Protobuf/Preferences.
• RNF-03 (Performance Reativa): Latência de propagação de mudanças de preferência inferior a 15 milissegundos.
• RNF-04 (Compatibilidade de Versão): Suporte estável desde Android API 21 até Android API 34.
• RNF-05 (Tipagem Forte): Eliminação de erros de chave em String através de chaves fortemente tipadas.

3. Diagrama de Casos de Uso

flowchart TD
    Pilot([fa:fa-user Lorde do Tempo])
    DS[(fa:fa-database Jetpack DataStore)]

    subgraph AppTardis ["🌌 TARDIS Panel (mobile-android-kotlin)"]
        UC01["Configurar Coordenadas Temporais"]
        UC02["Persistir com dataStore.edit"]
        UC03["Consumir Fluxo Reativo (Flow)"]
        UC04["Alternar Tema Visual (Azul/Neon)"]
        UC05["Restaurar Configurações de Fábrica"]
    end

    Pilot --> UC01
    UC01 --> UC02
    UC02 --> DS
    DS -.->|Flow| UC03
    UC03 --> Pilot
    Pilot --> UC04
    UC04 --> UC02
    Pilot --> UC05
    UC05 --> UC02

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e execute os testes de unidade

./gradlew test
./gradlew assembleDebug

🏁 Matriz de Checkpoints de Conclusão