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

🤖 P15: J.A.R.V.I.S. Sync (WorkManager)

v1.0 — Android Jetpack WorkManager, Kotlin Coroutines, CoroutineWorker, Restrições de Hardware e Tarefas Assíncronas Persistentes

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

• P14: Portais Dimensionais com Notificações Push
• ➡️ P15 (este): J.A.R.V.I.S. Sync com WorkManager
• P16: Alerta Gotham com Broadcast & Alarmes
• P17: Anime Soundboard com MediaPlayer
• P18: Radar de Habilidades com Canvas 2D

🏛️ Visão Geral & Arquitetura Visual

O projeto J.A.R.V.I.S. Sync implementa o padrão oficial do Google para processamento assíncrono garantido e persistente em segundo plano: o Jetpack WorkManager. A aplicação orquestra rotinas pesadas de telemetria e diagnóstico da armadura do Homem de Ferro, agendando execuções subordinadas a Restrições de Hardware (Constraints): execução exclusiva quando o dispositivo estiver conectado à tomada (carregando) e com conexão de rede Wi-Fi não-tarifada ativa, sobrevivendo a reinicializações completas do sistema operacional.

📁 Estrutura de Pastas Anti-Colisão

Os trabalhadores assíncronos, repositórios de diagnóstico e telas estão contidos na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p15_jarvis_workmanager/
├── assets/
│   ├── mockup_jarvis_fluxo.svg
│   ├── screenshot_01_jarvis_ocioso.svg
│   ├── screenshot_02_jarvis_executando.svg
│   └── screenshot_03_jarvis_concluido.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/jarvissync/
│   │   │       │   ├── worker/
│   │   │       │   │   └── JarvisDiagnosticsWorker.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: Implementar classe trabalhadora estendendo CoroutineWorker.
• RF-02: Configurar Constraints.Builder() com NetworkType.UNMETERED e setRequiresCharging(true).
• RF-03: Enfileirar requisição de trabalho único OneTimeWorkRequestBuilder com tags semânticas.
• RF-04: Emitir progresso em tempo real através do método setProgress(workDataOf(...)).
• RF-05: Notificar a conclusão com sucesso (Result.success()) ou falha recuperável (Result.retry()).

Requisitos Não-Funcionais (RNF)

• RNF-01 (Garantia de Execução): Persistência de tarefas pelo WorkManager através de banco de dados SQLite interno.
• RNF-02 (Eficiência de Bateria): Respeito irrestrito ao Doze Mode e às políticas de economia de energia do Android.
• RNF-03 (Cancelamento Cooperativo): Suspensão graciosa do processamento caso a Coroutine seja cancelada.
• RNF-04 (Compatibilidade de Versão): Suporte nativo desde Android API 21 até Android API 34.
• RNF-05 (Concorrência Segura): Execução isolada em Dispatchers.Default sem bloquear a UI.

3. Diagrama de Casos de Uso

flowchart TD
    Pilot([fa:fa-user Tony Stark])
    WM[(fa:fa-gears WorkManager Engine)]
    Power[(fa:fa-plug Sensor de Energia/Rede)]

    subgraph AppJarvis ["🤖 J.A.R.V.I.S. Sync (mobile-android-kotlin)"]
        UC01["Agendar Sincronização"]
        UC02["Verificar Restrições de Bateria/Wi-Fi"]
        UC03["Executar CoroutineWorker em Background"]
        UC04["Emitir Progresso Percentual"]
        UC05["Finalizar Diagnóstico com Sucesso"]
    end

    Pilot --> UC01
    UC01 --> WM
    WM --> UC02
    Power --> UC02
    UC02 -->|Condições Atendidas| UC03
    UC03 --> UC04
    UC04 --> Pilot
    UC03 --> UC05

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e execute os testes unitários do WorkManager

./gradlew test
./gradlew assembleDebug

🏁 Matriz de Checkpoints de Conclusão