PD-284 — Agent Developer : Module seal-navigation¶

1. Module¶

2. Responsabilite¶

Gestion des deep-links de scellement : resolution des liens probatiovault://seal/{uuid} depuis les notifications terminales vers l'ecran SealDetail, avec validation de securite (whitelist scheme interne) et resilience aux liens malformes.

3. Implementation¶

3.1. Exports publics¶

3.2. Dependances internes¶

3.3. Flux de resolution¶

Notification tap
  -> handleNotificationResponse (handlers.ts)
    -> resolveSealNotificationTarget(data)
      -> data.type === "seal_terminal" ?
        -> resolveSealDeepLink(data.deep_link)
          -> scheme whitelist check (SEC-01)
          -> validateSealDeepLink (format + UUID)
          -> NavigationTarget { screen: "SealDetail", params: { sealId } }

4. Couverture des invariants et tests contractuels¶

5. Decisions architecturales¶

D1 — Resolution en deux couches (notification + deep-link)¶

• Decision : Separer resolveSealNotificationTarget (filtre payload notification) de resolveSealDeepLink (validation deep-link pure).
• Rationale : Permet de reutiliser resolveSealDeepLink pour d'autres sources de deep-links (universal links, QR codes) sans couplage aux notifications.
• Alternatives : Fonction monolithique dans handlers.ts.
• Trade-offs : Un fichier supplementaire, mais decouplage propre et testabilite unitaire.

D2 — SEAL_LINKING_CONFIG comme objet statique¶

• Decision : Exporter la config de linking comme constante (as const) plutot que comme fonction.
• Rationale : React Navigation attend un objet stable ; une constante evite les re-renders inutiles du NavigationContainer.
• Alternatives : Factory function avec parametres dynamiques.
• Trade-offs : Pas de configuration dynamique du scheme, mais le scheme est fixe par contrat (SEC-01).

6. Hypotheses¶

1. La route SealDetail sera ajoutee au RootStackParamList de AppNavigator.tsx avec les params { sealId: string }. Ce module ne modifie pas AppNavigator (hors perimetre agent).
2. L'integration dans handlers.ts sera faite par l'orchestrateur : appeler resolveSealNotificationTarget(data) dans handleNotificationResponse quand data.type === "seal_terminal".
3. Le NavigationContainer dans App.tsx recevra linking={SEAL_LINKING_CONFIG} pour activer le routage automatique des deep-links a l'ouverture de l'app.

7. Fichiers modifies / crees¶

8. Matrice de couverture tests¶