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

🌀 P14: Portais Dimensionais (Navigation & Notificações Push)

v1.0 — Android Nativo, Kotlin, Firebase Cloud Messaging (FCM), NotificationCompat, Canais de Notificação e Deep Links

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

• P13: TARDIS Panel com DataStore Preferences
• ➡️ P14 (este): Portais Dimensionais com Notificações Push
• P15: J.A.R.V.I.S. Sync com WorkManager
• P16: Alerta Gotham com Broadcast & Alarmes
• P17: Anime Soundboard com MediaPlayer

🏛️ Visão Geral & Arquitetura Visual

O projeto Portais Dimensionais domina a mecânica de engajamento assíncrono em dispositivos móveis através de Push Notifications e Deep Linking. A aplicação implementa serviços em segundo plano orientados a eventos via Firebase Cloud Messaging (FCM), cria canais categorizados de notificação (NotificationChannel) em conformidade com o Android 8.0+ (API 26+) e Android 13+ (permissão POST_NOTIFICATIONS), e direciona o usuário para fendas dimensionais específicas via PendingIntent e grafo de navegação.

📁 Estrutura de Pastas Anti-Colisão

Todos os serviços de mensageria, receptores e interfaces residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p14_portais_push/
├── assets/
│   ├── mockup_portais_fluxo.svg
│   ├── screenshot_01_lista_portais.svg
│   ├── screenshot_02_detalhe_fenda.svg
│   └── screenshot_03_push_notification.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/portaispush/
│   │   │       │   ├── fcm/
│   │   │       │   │   └── PortalFirebaseService.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: Solicitar permissão POST_NOTIFICATIONS em dispositivos rodando Android 13 (API 33) ou superior.
• RF-02: Estender FirebaseMessagingService implementando os callbacks onMessageReceived e onNewToken.
• RF-03: Criar canal de notificações NotificationChannel com prioridade alta e vibração configurada.
• RF-04: Empacotar dados de navegação em uma PendingIntent apontando para a Activity com flags seguras (FLAG_IMMUTABLE).
• RF-05: Processar os argumentos passados no intent extra ao inicializar a tela de destino.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Compatibilidade de Notificações): Funcionamento integral desde API 24 até API 34.
• RNF-02 (Latência de Entrega): Disparo visual da notificação local em menos de 100ms após recepção do payload FCM.
• RNF-03 (Segurança de Intents): Proteção obrigatória contra injeção de intents usando FLAG_IMMUTABLE ou FLAG_MUTABLE.
• RNF-04 (Design System): Ícones monocromáticos otimizados para a barra de status do Android (smallIcon).
• RNF-05 (Resiliência): Recepção garantida tanto com o app em primeiro plano quanto em segundo plano ou encerrado.

3. Diagrama de Casos de Uso

flowchart TD
    User([fa:fa-user Viajante])
    FCM[(fa:fa-cloud Firebase FCM)]
    OSNotif[(fa:fa-bell NotificationManager)]

    subgraph AppPortais ["🌀 Portais Push (mobile-android-kotlin)"]
        UC01["Registrar Token de Notificação"]
        UC02["Receber Payload de Fenda Dimensional"]
        UC03["Construir Notificação com Canal"]
        UC04["Disparar Alerta na Barra de Status"]
        UC05["Navegar para o Portal via Deep Link"]
    end

    AppPortais --> UC01
    UC01 --> FCM
    FCM -->|Push Event| UC02
    UC02 --> UC03
    UC03 --> OSNotif
    OSNotif --> UC04
    User -->|Toca no Alerta| UC05

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e execute no dispositivo

./gradlew installDebug

🏁 Matriz de Checkpoints de Conclusão