From 2567e2f0daea4f09b5b346c71f65d1110398fe12 Mon Sep 17 00:00:00 2001 From: Your Name Date: Tue, 26 Aug 2025 12:42:05 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20MAJ=20USAGE/INDEX/INTEGRATION=5FIFRAME;?= =?UTF-8?q?=20ROADMAP=20handshake=20iframe;=20template=20feature=5Frequest?= =?UTF-8?q?=20enrichi;=20CHANGELOG=20mis=20=C3=A0=20jour?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitea/ISSUE_TEMPLATE/feature_request.md | 8 ++++++++ CHANGELOG.md | 4 ++++ docs/INTEGRATION_IFRAME.md | 2 +- docs/ROADMAP.md | 3 +++ 4 files changed, 16 insertions(+), 1 deletion(-) diff --git a/.gitea/ISSUE_TEMPLATE/feature_request.md b/.gitea/ISSUE_TEMPLATE/feature_request.md index fd4ea3a..5248e3f 100644 --- a/.gitea/ISSUE_TEMPLATE/feature_request.md +++ b/.gitea/ISSUE_TEMPLATE/feature_request.md @@ -9,15 +9,23 @@ assignees: '' ## Problème lié Une description claire et concise du problème que cette fonctionnalité résoudrait. +Exemple: Handshake iframe fragile (courses à l'init) entre parent et `ihm_client`. + ## Solution proposée Une description claire et concise de ce que vous voulez qu'il se passe. +Proposition: protocole READY → LISTENING → REQUEST_LINK avec ACKs, timeouts et retries exponentiels; validation stricte de `origin` et corrélation `messageId`. + ## Alternatives considérées Une description claire et concise de toutes les solutions ou fonctionnalités alternatives que vous avez considérées. ## Contexte supplémentaire Ajoutez tout autre contexte ou captures d'écran concernant la demande de fonctionnalité ici. +Critères d’acceptation: +- Pas de course observée (100 itérations CI) +- Compatibilité ascendante des intégrations existantes + ## Impact utilisateur - [ ] Améliore l'expérience utilisateur - [ ] Corrige un problème de performance diff --git a/CHANGELOG.md b/CHANGELOG.md index 2d9ff61..7309c8a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,6 +36,10 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm - Correction de l’index de documentation (liens API et SSH) ### Changed +- Suppression des vues `chat`, `process`, `process-element`, `signature`; routeur limité à `home` et `account` +- Nettoyage de `src/main.ts` et `src/utils/notification.store.ts` pour retirer les dépendances aux vues supprimées +- Stabilisation des tests unitaires de canal en conditionnant l'émission `LISTENING` au mode E2E en iframe +- Documentation mise à jour: `docs/USAGE.md`, `docs/INDEX.md` - Migration vers la branche `docker-support` - Optimisation du build Docker multi-stage - Amélioration des performances de compilation diff --git a/docs/INTEGRATION_IFRAME.md b/docs/INTEGRATION_IFRAME.md index 32fc05b..5a510cd 100644 --- a/docs/INTEGRATION_IFRAME.md +++ b/docs/INTEGRATION_IFRAME.md @@ -5,7 +5,7 @@ Ce document définit les échanges entre un site hôte et `ihm_client` intégré ## Principes - Canal: postMessage entre la page parente et l’iframe `ihm_client`. -- Découverte: `ihm_client` émet `LISTENING` à l’initialisation (côté iframe). +- Découverte: `ihm_client` émet `LISTENING` pour signaler la disponibilité des listeners (côté iframe). En mode E2E (`?e2e=1`) et seulement lorsque l’app tourne en iframe, `LISTENING` est émis périodiquement (jusqu’à 100 fois) pour éviter les courses de tests. Hors E2E, pas d’émission périodique. - Sécurité: - Utiliser la cible `event.origin` pour les réponses. - De nombreuses opérations exigent un `accessToken` valide (lié à `origin`). diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 775f5e1..59bc867 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,3 +1,6 @@ +- [ ] Handshake iframe robuste (READY → LISTENING → REQUEST_LINK) avec ACKs + - Objectif: éliminer les conditions de course à l’initialisation + - Détails: séquence explicite, timeouts, retry backoff # Roadmap - ihm_client - Court terme: stabilisation iframe, optimisation WASM