PD-105 — Plan d'implémentation¶

[App] expo-notifications.getDevicePushTokenAsync()
  │
  ├── Token obtenu
  │     └── POST /api/v1/notifications/device-tokens
  │           Body: { token, deviceId, environment }
  │           Headers: Authorization: Bearer <jwt>
  │
  └── Backend
        ├── Valide JWT
        ├── Upsert token (user_id, device_id, token, active=true)
        ├── Invalide ancien token si existant
        └── 201 Created

[App] Logout explicite
  │
  └── DELETE /api/v1/notifications/device-tokens/:deviceId
        Headers: Authorization: Bearer <jwt>
        │
        └── Backend
              ├── Marque token inactive (revoked_at = now)
              └── 204 No Content

[Backend] Événement probatoire détecté
  │
  ├── EventClassifier.classify(event)
  │     └── Retourne { type, criticite, shouldNotify }
  │
  ├── Si shouldNotify = false → STOP (INV-105-02)
  │
  ├── PayloadBuilder.build(event)
  │     └── Retourne { notificationId: UUID, eventType, targetId }
  │     └── AUCUNE donnée sensible (INV-105-07)
  │
  ├── Si criticité = CRITIQUE | HAUTE-CRITIQUE
  │     └── DispatchService.sendAlert(payload, tokens)
  │
  ├── Si criticité = HAUTE
  │     └── DispatchService.sendSilent(payload, tokens)
  │
  └── Logs: timestamp_event, timestamp_dispatch, delta_ms

[iOS] Notification reçue
  │
  ├── Vérifier déduplication par notificationId (si déjà historisé → STOP)
  │
  ├── Foreground → NotificationHandler.handleForeground()
  │     ├── Si notification.type === alert → Affiche in-app toast
  │     ├── Si notification.type === silent → Aucune alerte (INV-105-05)
  │     ├── Historise localement (avec mutex/queue sérialisé)
  │     └── Met à jour badge (atomique via computeBadge)
  │
  ├── Background → NotificationHandler.handleBackground()
  │     ├── Sync silencieuse si silent
  │     ├── Historise localement (avec mutex/queue sérialisé)
  │     └── Met à jour badge (atomique via computeBadge)
  │
  └── Killed → handleNotificationResponse() au lancement
        ├── Historise localement (avec mutex/queue sérialisé)
        ├── Navigate vers contexte
        └── Met à jour badge (atomique via computeBadge)

Note: Toutes les mises à jour badge sont sérialisées via une queue pour éviter les race conditions.
Déduplication: Avant toute historisation, vérifier si notificationId existe déjà dans le stockage local.

[App] Tap notification
  │
  ├── Extraire targetId du payload
  │
  ├── Resolver.resolve(targetId)
  │     ├── Si document → navigate('DocumentDetail', { id })
  │     ├── Si partage → navigate('ShareDetail', { id })
  │     └── Si event → navigate('EventDetail', { id })
  │
  └── Si contexte introuvable
        └── navigate('NotificationDetail', { notification })
              └── Affiche message d'indisponibilité