Clean capitalisation inbox and integrate frontend link-out pattern

This commit is contained in:
openclaw
2026-03-19 13:25:36 +01:00
parent bbfc037e88
commit c1331dff72
4 changed files with 62 additions and 294 deletions

View File

@@ -12,7 +12,7 @@ Il sert de **mémoire durable** pour éviter :
- de redélibérer éternellement sur des sujets déjà tranchés,
- de propager des “bonnes pratiques” théoriques non éprouvées.
Dernière mise à jour : 16-03-2026
Dernière mise à jour : 19-03-2026
---
@@ -24,6 +24,7 @@ Dernière mise à jour : 16-03-2026
- [Navigation réactive post-action async (React / Expo Router)](#pattern-navigation-reactive-post-action-async)
- [Refresh idempotent sur store de liste paginée](#pattern-refresh-idempotent-liste-paginee)
- [UI admin légère sur domaine existant](#pattern-ui-admin-legere-domaine-existant)
- [Intégration tierce en mode link-out — préférer une page locale canonique](#pattern-link-out-page-locale-canonique)
---
@@ -383,6 +384,49 @@ const handleOAuth = async () => {
---
---
<a id="pattern-link-out-page-locale-canonique"></a>
## Pattern : Intégration tierce en mode link-out — préférer une page locale canonique
### Synthèse
- **Objectif** : éviter les parcours concurrents et centraliser les garde-fous UX quand une fonctionnalité publique dépend dun service tiers externe.
- **Contexte** : site ou webapp avec CTA publics menant vers un tiers de réservation, paiement, prise de rendez-vous ou formulaire externe.
- **Quand lutiliser** : dès quune fonctionnalité externe dispose dune page locale dédiée côté produit (`/reservation`, `/booking`, etc.).
- **Quand léviter** : si le produit assume volontairement une sortie directe unique vers le tiers, sans page locale intermédiaire ni besoin de contextualisation.
### Analyse
- **Avantages** :
- UX plus cohérente entre home, navigation et pages dédiées
- garde-fous, wording et fallbacks centralisés au même endroit
- facilite lévolution future vers embed, click-to-load ou variantes de parcours
- **Limites / vigilance** :
- ajoute une étape intermédiaire si la page locale napporte aucune valeur
- demande de maintenir lalignement entre les CTA internes et le parcours canonique
### Validation
- Validé le : 19-03-2026
- Contexte technique : site web public / intégration tierce en mode lien externe
### Implémentation (exemple minimal)
```txt
- faire pointer les CTA internes (home, nav, landing) vers une page locale dédiée
- faire de cette page locale le point canonique vers le service tiers externe
- centraliser sur cette page le contexte utile, les garde-fous et les fallbacks
- éviter les sorties directes concurrentes vers le tiers depuis plusieurs endroits du site
```
### Checklist
- [ ] Un parcours canonique unique est défini
- [ ] Les CTA internes convergent vers la page locale dédiée
- [ ] Les garde-fous et fallbacks sont centralisés
- [ ] Les sorties directes concurrentes vers le tiers sont évitées ou justifiées
### Principes transverses
- Un pattern = une responsabilité claire