# Advanced Elicitation — Rapport agentMarketing **Projet:** AImpact Hub (agentMarketing) **Document source:** epics.md **Date:** 27 février 2025 **Méthodes appliquées:** User Persona Focus Group, Cross-Functional War Room, Critique and Refine, Mentor and Apprentice --- ## 1. User Persona Focus Group ### Participants - **Transformateur (CDO)** — Responsable transformation IA, pilote la collecte et la priorisation - **Contributeur métier** — Opérationnel invité à soumettre des idées sans compte ### Réactions du Transformateur (CDO) | Zone | Frustrations | Besoins non couverts | Priorités | |------|--------------|----------------------|-----------| | **Epic 1** | L'onboarding "attendre 48h" peut bloquer si aucun contributeur n'est disponible rapidement | Pouvoir inviter des contributeurs AVANT d'avoir soumis une 1ère idée (ordre onboarding rigide) | Story 1.5 : rendre l'ordre des étapes plus flexible | | **Epic 2** | Pas de vue sur le taux d'ouverture des emails d'invitation | Métriques d'engagement : qui a ouvert ? qui n'a jamais cliqué ? | Story additionnelle : analytics d'ouverture (optionnel MVP) | | **Epic 2** | Relance J+21 : "une seule occurrence" — et si le contributeur ne répond toujours pas ? | Relance J+35 ou J+45 ? Escalade ? | Story 2.10 : AC manquant sur comportement post-relance | | **Epic 3** | "Résumé des nouvelles activités" — depuis quelle date ? Dernière visite = dernière connexion ? | Définition claire de "dernière visite" (session ? jour ?) | Story 3.7 : AC à préciser | | **Epic 3** | Vue kanban : mapping statuts → colonnes flou (Envoyé, En traitement, etc. vs Idée/À qualifier/Prioritaire/En cours) | Alignement explicite statuts ↔ colonnes kanban | Story 3.3 : AC manquant | | **Epic 4** | Suppression "manuellement en MVP" — processus RGPD flou | Procédure claire : qui peut demander ? délai ? audit trail ? | Story 4.6 : AC à enrichir | ### Réactions du Contributeur métier | Zone | Frustrations | Besoins non couverts | Priorités | |------|--------------|----------------------|-----------| | **Epic 2** | "Soumettre sans créer de compte (email requis)" — contradiction ? L'email est-il stocké ? | Clarifier : email = identifiant pour suivi, pas de compte = pas de mot de passe | Story 2.2 : AC à préciser | | **Epic 2** | Exemples IA "2 à 3" — si 2, c'est suffisant ? Si 3, ça prend de la place | Nombre exact ou "au moins 2" ? | Story 2.3 : AC à préciser | | **Epic 2** | Bibliothèque : "pré-remplir titre et description partiels" — qu'est-ce qui reste à remplir ? | Liste des champs pré-remplis vs à compléter | Story 2.4 : AC manquant | | **Epic 2** | Soumission par email : format attendu ? Objet ? Pièces jointes ? | Spécification du format email (objet, structure corps) | Story 2.5 : AC manquant | | **Epic 4** | "Répondre depuis email ou plateforme" — comment répondre depuis l'email ? Lien magique ? | Flux de réponse par email (lien, reply-to, token) | Story 4.2 : AC manquant | ### Synthèse Focus Group - **Priorité haute :** Aligner statuts ↔ colonnes kanban (Epic 3), clarifier flux réponse contributeur (Epic 4) - **Priorité moyenne :** Flexibiliser onboarding (Epic 1), préciser format email soumission (Epic 2) - **Priorité basse :** Analytics ouverture (post-MVP) --- ## 2. Cross-Functional War Room ### Participants - **PM** — Product Manager - **Développeur** — Tech lead - **Designer** — UX/UI ### Analyse par dimension #### Faisabilité technique (Développeur) | Story | Faisabilité | Risques / Trade-offs | Ajustements proposés | |-------|-------------|----------------------|----------------------| | 2.5 Soumission par email | **Moyenne** | Inbox dédiée = service externe (Resend Inbound, SendGrid, etc.) ou parsing manuel. Webhook dépend du fournisseur. | Spécifier le provider (ex. Resend Inbound) ou prévoir fallback manuel (import CSV) | | 2.10 Relance J+21 | **Haute** | Cron Vercel = limite 1/jour par défaut. Vérifier fréquence requise. | AC : "cron exécuté quotidiennement ; relances batchées" | | 3.1 Enrichissement LLM | **Haute** | 10s pour 90% — dépend du modèle. Coût 0,05€/idée à monitorer. | Ajouter AC : "fallback modèle léger si timeout" | | 4.2 Réponse depuis email | **Moyenne** | Reply-to + parsing email = complexité. Alternative : lien dans email vers formulaire pré-rempli. | Préférer lien vers plateforme ; reply-to en v2 | | 4.5 Lien partageable | **Haute** | Token unique, table ShareLink, expiration ? | AC : "durée de validité du lien (optionnel : 7j, 30j, illimité)" | #### Désirabilité utilisateur (Designer) | Story | Désirabilité | Points d'attention | Ajustements proposés | |-------|--------------|--------------------|----------------------| | 1.5 Onboarding | **Haute** | "Étapes skipables sauf config" — risque de skip de l'invitation | Rendre "inviter contributeurs" obligatoire avant "attendre" | | 2.3 Exemples IA | **Haute** | Skeleton 3s — éviter flash de contenu | AC : "skeleton pendant chargement, pas de layout shift" | | 2.4 Bibliothèque | **Moyenne** | 5 cas × 5 secteurs × 5 fonctions = 125 cas minimum. Gestion contenu ? | Clarifier : 5 par combinaison ou 5 par dimension ? | | 3.3 Kanban | **Haute** | 4 colonnes fixes — statuts FR26 sont 5. Mapping ? | Définir mapping : Envoyé→Idée, En traitement→À qualifier, etc. | | 4.1 Question qualification | **Haute** | Où se pose la question ? Dans la fiche, champ texte + bouton ? | AC : "zone dédiée dans la fiche avec historique des Q/R" | #### Viabilité produit (PM) | Story | Viabilité | Trade-offs | Ajustements proposés | |-------|-----------|------------|----------------------| | 1.6 Limites Free | **Haute** | 30 idées, 5 contributeurs, 1 export — cohérent pour acquisition | OK | | 2.10 Relance auto | **Moyenne** | Risque spam si mal configuré | AC : "désactivable par workspace" | | 4.4 Export PDF | **Haute** | 1 export/mois Free — limite claire | OK | | 4.6 Suppression | **Haute** | RGPD obligatoire — "manuellement" = risque opérationnel | AC : "délai maximal de traitement 30 jours" | ### Synthèse War Room - **Trade-off majeur :** Réponse par email (4.2) → simplifier en "lien vers plateforme" pour MVP - **Clarification urgente :** Mapping statuts ↔ colonnes kanban (3.3) - **Dépendance :** Story 2.5 (email) bloque sur choix provider --- ## 3. Critique and Refine ### Forces des stories actuelles 1. **Couverture FR complète** — Chaque FR est tracé dans au moins une story 2. **AC au format Given/When/Then** — Cohérent et testable 3. **Références NFR** — Performances et limites explicites (NFR2, NFR3, NFR5, etc.) 4. **Fallback LLM** — Bien pris en compte (exemples génériques, enrichissement différé) 5. **Multi-tenant** — Workspace_id, slug, isolation présents dès Epic 1 ### Faiblesses identifiées | # | Faiblesse | Stories concernées | |---|-----------|--------------------| | 1 | **Mapping statuts ↔ kanban** non défini | 3.3, 3.5 | | 2 | **AC manquants** sur plusieurs stories | 2.4, 2.5, 4.2, 4.5, 4.6 | | 3 | **Story 2.4 trop grosse** — 4 FR (IA3 à IA6) + bibliothèque + partage lien | 2.4 | | 4 | **Ordre des stories** — 2.7 (confirmation) après 2.6 (pièces jointes) — la confirmation est plus critique que les PJ | 2.6, 2.7 | | 5 | **Epic 2** — FR9 (liste contributeurs) placé après relances (2.10, 2.11) — logique : voir les contributeurs avant de les relancer | 2.9, 2.10, 2.11 | | 6 | **"Dernière visite"** non défini | 3.7 | | 7 | **Réponse contributeur** — "depuis email" ambigu | 4.2 | ### Améliorations concrètes #### A. AC manquants à ajouter | Story | AC à ajouter | |-------|--------------| | 2.4 | **And** les champs pré-remplis sont : titre et description ; les champs département, impact, fréquence restent à renseigner | | 2.5 | **Given** l'email contient un sujet (optionnel) et un corps avec la description de l'idée **When** le webhook reçoit l'email **Then** le corps est parsé pour extraire description, département si mentionné | | 3.3 | **And** le mapping statuts→colonnes est : Envoyé→Idée ; En traitement→À qualifier ; Mis à l'ordre du jour→Prioritaire ; En cours→En cours ; Non prioritaire→exclu | | 3.7 | **And** "dernière visite" = dernière connexion authentifiée au workspace (timestamp stocké) | | 4.2 | **And** le contributeur répond via un lien dans l'email vers une page pré-remplie avec la question affichée | | 4.5 | **And** le lien peut avoir une durée de validité configurable (7j, 30j, illimité) — défaut 30j | | 4.6 | **And** le délai maximal de traitement d'une demande de suppression est de 30 jours | #### B. Stories à découper | Story actuelle | Découpage proposé | |----------------|-------------------| | 2.4 Bibliothèque | **2.4a** Parcours bibliothèque (organisation secteur/fonction, 5 cas min) + **2.4b** Pré-remplissage formulaire + **2.4c** Partage lien CDO (ou garder 2.4 avec sous-tâches) | #### C. Ordre à revoir | Epic | Ordre actuel | Ordre proposé | Raison | |------|--------------|---------------|--------| | Epic 2 | 2.9 après 2.8 | 2.9 avant 2.10 | Voir les contributeurs avant de configurer les relances | | Epic 2 | 2.7 après 2.6 | 2.7 avant 2.6 | Confirmation = feedback immédiat, plus critique UX | #### D. Suppressions / report | Élément | Action | Raison | |---------|--------|--------| | Réponse par email (FR31) | Simplifier en "lien vers plateforme" uniquement pour MVP | Complexité parsing email | | Analytics ouverture | Report post-MVP | Pas dans scope actuel | --- ## 4. Mentor and Apprentice ### Dialogue **Junior :** "Dans la Story 1.3, on crée un workspace avec nom d'entreprise et email. Mais le Transformateur est déjà authentifié (NextAuth). Pourquoi redemander l'email ?" **Senior :** Bonne question. L'email en Story 1.3 pourrait être l'email de contact du workspace (différent du compte perso), ou une redondance. **Hypothèse implicite :** l'email saisi = email du propriétaire du workspace, utilisé pour les notifications. À clarifier : est-ce le même que User.email ? --- **Junior :** "Story 2.2 — 'email requis pour identification'. Si pas de compte, comment on identifie ?" **Senior :** Le contributeur doit fournir un email (champ du formulaire) pour qu'on puisse lui envoyer la confirmation et les questions de qualification. Pas de compte = pas de mot de passe, pas de login. **Zone d'ambiguïté :** ce même email est-il utilisé pour matcher "invité" dans la liste contributeurs ? Oui, si l'invitation a été faite à cet email. --- **Junior :** "Story 2.5 — soumission par email. Le contributeur envoie à quel email ? C'est quoi l'adresse ?" **Senior :** Chaque workspace a une inbox dédiée — typiquement `workspace-{slug}@inbound.agentmarketing.com` ou via un provider. **Hypothèse implicite :** l'adresse est générée et affichée quelque part (dashboard, invite). Pas dans les AC actuels ! --- **Junior :** "Story 3.3 — les colonnes sont Idée, À qualifier, Prioritaire, En cours. Mais les statuts FR26 sont Envoyé, En traitement, etc. C'est quoi le lien ?" **Senior :** Exactement le problème. On a deux taxonomies : statuts métier (Envoyé, En traitement...) et colonnes kanban. Il faut un mapping. **Hypothèse implicite :** une colonne = un ou plusieurs statuts. Non documenté. --- **Junior :** "Story 4.2 — 'répondre depuis email ou plateforme'. Si je réponds par email, ça va où ?" **Senior :** Reply-to avec un token dans l'adresse, ou lien "Répondre" dans l'email qui ouvre la plateforme. **Zone d'ambiguïté :** le parsing d'une réponse email directe est complexe (citations, signatures). Pour le MVP, on privilégie le lien. --- **Junior :** "Story 4.6 — supprimer 'sur demande'. Qui demande ? Le contributeur ? Le CDO ? Un admin ?" **Senior :** RGPD : le contributeur peut demander l'effacement de ses données. Le CDO peut aussi supprimer des idées (modération). **Hypothèse implicite :** "sur demande" = demande du contributeur ou décision interne. Le processus (formulaire ? email ?) n'est pas défini. --- ### Hypothèses implicites et zones d'ambiguïté émergées | # | Hypothèse / ambiguïté | Story(s) | Action | |---|------------------------|----------|--------| | 1 | Email workspace = email User ? | 1.3 | Clarifier : email workspace = contact, peut différer du compte | | 2 | Email contributeur = clé de matching invitation | 2.2 | Ajouter AC | | 3 | Adresse inbox workspace affichée au CDO et/ou aux contributeurs | 2.5 | Ajouter AC | | 4 | Mapping statuts ↔ colonnes kanban | 3.3, 3.5 | Ajouter AC (voir section 3) | | 5 | Réponse contributeur = lien prioritaire, pas reply email | 4.2 | Simplifier AC | | 6 | Demande suppression = processus (qui, comment) | 4.6 | Enrichir AC | --- ## Synthèse des insights par méthode | Méthode | Insight principal | |---------|-------------------| | **Focus Group** | CDO et Contributeur demandent des clarifications sur le flux (réponse, email, statuts) et une flexibilité de l'onboarding | | **War Room** | Faisabilité : soumission email et réponse email sont les points les plus risqués. Désirabilité : mapping kanban et UX de la qualification à préciser. Viabilité : limites Free OK | | **Critique** | Forces : couverture FR, format AC. Faiblesses : mapping statuts, AC manquants, story 2.4 trop grosse, ordre à ajuster | | **Mentor/Apprentice** | 6 hypothèses implicites identifiées (email, inbox, mapping, réponse, suppression) | --- ## Liste des améliorations proposées ### Ajouts 1. **AC Story 1.3** — Préciser si l'email saisi = email du workspace (contact) ou du User 2. **AC Story 2.2** — L'email saisi est utilisé pour matcher l'invitation si le contributeur a été invité à cette adresse 3. **AC Story 2.4** — Champs pré-remplis vs à compléter ; clarifier "5 cas par secteur et fonction" (5 par combinaison ou 5 par dimension) 4. **AC Story 2.5** — Format email attendu ; adresse inbox affichée dans le dashboard et/ou communiquée aux contributeurs 5. **AC Story 2.10** — Relance désactivable par workspace ; comportement si contributeur ne répond pas (une seule relance documenté) 6. **AC Story 3.3** — Mapping statuts → colonnes kanban (tableau explicite) 7. **AC Story 3.7** — Définition "dernière visite" = timestamp dernière connexion workspace 8. **AC Story 4.2** — Réponse via lien dans l'email vers plateforme (pas reply email pour MVP) 9. **AC Story 4.5** — Durée de validité du lien (7j, 30j, illimité) 10. **AC Story 4.6** — Délai 30 jours max ; qui peut demander (contributeur, CDO) ### Modifications 1. **Story 1.5** — Rendre l'ordre des étapes onboarding plus flexible (inviter avant "1ère idée" possible) 2. **Story 2.4** — Découper en 2.4a/2.4b/2.4c ou ajouter sous-tâches 3. **Story 2.5** — Spécifier le provider email (Resend Inbound ou équivalent) ou fallback 4. **Ordre Epic 2** — 2.9 avant 2.10 ; 2.7 avant 2.6 (optionnel) ### Suppressions / reports 1. **Réponse par email direct** — Simplifier en "lien uniquement" pour MVP 2. **Analytics ouverture** — Report post-MVP --- ## Contenu enrichi prêt pour epics.md Les sections suivantes peuvent être intégrées au document `epics.md` pour enrichir les stories concernées. L'utilisateur peut accepter tout ou partie de ces modifications. ### Story 1.3 — AC enrichi ``` **And** l'email saisi est enregistré comme email de contact du workspace (peut différer de l'email du compte User) ``` ### Story 1.5 — AC enrichi ``` **And** l'ordre des étapes peut être adapté : "inviter des contributeurs" peut précéder "soumettre une 1ère idée" si le Transformateur le souhaite ``` ### Story 2.2 — AC enrichi ``` **And** l'email saisi est utilisé pour identifier le contributeur et matcher une invitation existante si l'invitation a été envoyée à cette adresse ``` ### Story 2.4 — AC enrichis ``` **And** les champs pré-remplis par la bibliothèque sont : titre et description ; département, impact estimé et fréquence restent à renseigner par le contributeur **And** "5 cas par secteur et fonction" signifie au minimum 5 cas par secteur principal ET 5 cas par fonction principale (pas nécessairement toutes les combinaisons) ``` ### Story 2.5 — AC enrichis ``` **Given** le workspace a une inbox email dédiée dont l'adresse est affichée dans le dashboard et peut être communiquée aux contributeurs **When** j'envoie un email à cette adresse avec le corps contenant la description de mon idée (sujet optionnel) **Then** une idée est créée dans le backlog du workspace en moins de 15 minutes (NFR6) **And** le webhook valide le token/secret workspace avant création **And** le provider d'inbound email (ex. Resend Inbound) est configuré pour router vers le webhook ``` ### Story 2.10 — AC enrichi ``` **And** la relance automatique peut être désactivée par le Transformateur dans les paramètres du workspace ``` ### Story 3.3 — AC enrichi ``` **And** le mapping des statuts vers les colonnes est : Envoyé → Idée ; En traitement → À qualifier ; Mis à l'ordre du jour → Prioritaire ; En cours → En cours ; Non prioritaire → exclu de la vue (accessible via filtre) ``` ### Story 3.7 — AC enrichi ``` **And** "dernière visite" correspond à la dernière connexion authentifiée au workspace (timestamp enregistré à chaque accès) ``` ### Story 4.2 — AC enrichis (version simplifiée MVP) ``` **Given** j'ai reçu une question de qualification par email contenant un lien vers la plateforme **When** je clique sur le lien et saisis ma réponse dans le formulaire pré-rempli **Then** ma réponse est enregistrée et visible dans la fiche de l'idée **And** le Transformateur est notifié par email **And** (MVP) la réponse se fait uniquement via la plateforme ; la réponse par reply-email est reportée en v2 ``` ### Story 4.5 — AC enrichi ``` **And** le lien peut avoir une durée de validité configurable : 7 jours, 30 jours (défaut), ou illimitée ``` ### Story 4.6 — AC enrichis ``` **Given** un contributeur demande l'effacement de ses données (RGPD) ou le Transformateur décide de supprimer des idées **When** je procède à la suppression (manuellement en MVP) **Then** les idées et données du contributeur sont supprimées **And** le délai maximal de traitement d'une demande d'effacement RGPD est de 30 jours **And** une trace de la demande et de l'exécution est conservée à des fins d'audit (durée conforme RGPD) ``` --- **Fin du rapport Advanced Elicitation**