advanced-elicitation-report.md 19 KB

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 ?

Mise à jour 2026-02-27 : Auth Transformateur = email + mot de passe avec confirmation par mail (Story 1.2b). Pas d'OAuth. L'email workspace (Story 1.3) = contact, peut différer du 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 Résolu : email workspace = contact, peut différer du compte. Auth = email/password + confirmation (Story 1.2b)
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.2b - Authentification (nouvelle story, décision 2026-02-27)

Auth Transformateur = email + mot de passe avec confirmation par mail. Voir epics.md et architecture.md pour les AC complets.

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