Status: done
En tant que Contributeur, je veux recevoir une confirmation visuelle immédiate et un email après soumission, afin de savoir que mon idée a bien été enregistrée et pouvoir en soumettre une autre.
Given je viens de soumettre une idée avec succès When la soumission est validée par le serveur Then la confirmation visuelle s'affiche en moins de 1 seconde (NFR2) And l'écran de confirmation remplace le formulaire (pas de redirection, pas de saut de page) And un message m'indique que je peux suivre le statut de mon idée
Given l'écran de confirmation est affiché When je lis le message Then le message mentionne explicitement qu'un email de confirmation m'a été envoyé And un CTA "Soumettre une autre idée" est disponible pour remettre le formulaire à zéro
Given la soumission est validée
When le serveur traite la mutation idea.submit
Then un email de confirmation est envoyé à l'adresse contributorEmail de la soumission
And l'email contient un CTA "Soumettre une autre idée" avec lien direct vers /submit/[workspaceSlug]
And l'email est envoyé en fire-and-forget (ne bloque pas la réponse au contributeur)
And en cas d'échec d'envoi email, la soumission reste validée — le contributeur voit la confirmation visuelle
Given le service email (Resend) n'est pas configuré en développement
When la soumission est effectuée
Then l'email est loggé en console ([email] Submission confirmation (mock): ...) au lieu d'être envoyé
And la confirmation visuelle s'affiche normalement
Given le composant SubmissionConfirmation est affiché
When je clique sur "Soumettre une autre idée"
Then le formulaire est remis à zéro et je peux saisir une nouvelle idée
[x] Task 1 : Ajouter sendSubmissionConfirmationEmail() dans src/server/services/email.ts (AC: #3, #4)
SendSubmissionConfirmationEmailParams avec : contributorEmail: string, workspaceSlug: string, workspaceName: string"Votre idée a bien été transmise — {workspaceName}", corps HTML avec le CTA pointant vers ${baseUrl}/submit/${workspaceSlug}if (!resend) → console.log mock avec label [email] Submission confirmation (mock):throw new Error(...) si Resend retourne une erreur (l'appelant gère via catch)[x] Task 2 : Déclencher l'email depuis la mutation idea.submit dans src/server/api/routers/idea.ts (AC: #3, #4)
sendSubmissionConfirmationEmail depuis ~/server/services/email[x] Subtask 2.2 : Après la transaction (const idea = await ctx.db.$transaction(...)) et après le fire-and-forget LLM enrich, ajouter l'appel email en fire-and-forget :
void sendSubmissionConfirmationEmail({
contributorEmail: input.contributorEmail.toLowerCase().trim(),
workspaceSlug: workspace.slug,
workspaceName: workspace.name,
}).catch((err: unknown) => {
console.error("[email] Submission confirmation failed:", err);
});
[x] Subtask 2.3 : S'assurer que workspace.slug et workspace.name sont inclus dans le select de workspace.findUnique (actuellement slug ✓ ; name ✓ dans la sélection existante)
[x] Subtask 2.4 : Vérifier que le retour { ideaId: idea.id } est inchangé
[x] Task 3 : Mettre à jour SubmissionConfirmation.tsx pour mentionner l'email (AC: #1, #2)
role="status", aria-live="polite" et le focus automatique sur le titre (accessibilité WCAG 2.1 AA)[x] Task 4 : Tests (AC: #3, #4)
src/server/services/email.test.ts (ou ajouter à un fichier test existant si présent)sendSubmissionConfirmationEmail sans RESEND_API_KEY → log console, pas d'erreur levéesendSubmissionConfirmationEmail avec Resend mocké → resend.emails.send appelé avec les bons params (to, subject, corps contenant le submitUrl)sendSubmissionConfirmationEmail avec Resend retournant une erreur → throw new Error(...) levéeidea.submit existant (s'il existe) n'est pas cassé par l'ajout du fire-and-forget emailSubmissionConfirmation.tsx (Story 2.2) :
Le composant de confirmation visuelle est déjà implémenté et fonctionnel :
onReset() → remet le formulaire à zérorole="status" + aria-live="polite" (WCAG 2.1 AA ✓)< 1s via setSubmitted(true) dans le onSuccess de la mutation (NFR2 ✓)Ce qui manque pour FR16 :
sendSubmissionConfirmationEmail() dans email.tsidea.submitPourquoi fire-and-forget ?
void fetch(...).catch(...)) — cohérence architecturalePattern exact à reproduire (depuis idea.ts) :
// Existant (LLM enrich) :
void fetch(`${baseUrl}/api/llm/enrich`, { ... }).catch(() => { /* silencieux */ });
// À ajouter (email confirmation) :
void sendSubmissionConfirmationEmail({
contributorEmail: input.contributorEmail.toLowerCase().trim(),
workspaceSlug: workspace.slug,
workspaceName: workspace.name,
}).catch((err: unknown) => {
console.error("[email] Submission confirmation failed:", err);
});
const subject = `Votre idée a bien été transmise — ${params.workspaceName}`;
const submitUrl = `${baseUrl}/submit/${params.workspaceSlug}`;
const html = `
<p>Bonjour,</p>
<p>Votre idée a bien été transmise à l'équipe de <strong>${escapedName}</strong>. Elle sera examinée et vous serez informé(e) de son avancement.</p>
<p>Vous souhaitez partager une autre idée ? Cliquez sur le lien ci-dessous :</p>
<p><a href="${submitUrl}">Soumettre une autre idée →</a></p>
<p>Merci pour votre contribution.</p>
<p>— L'équipe ${escapedName}</p>
`;
Escaper workspaceName pour éviter les injections HTML — même pattern que sendInvitationEmail :
const escapedName = params.workspaceName
.replace(/&/g, "&")
.replace(/</g, "<")
.replace(/>/g, ">")
.replace(/"/g, """);
Aucune variable d'environnement nouvelle — réutilisation de :
RESEND_API_KEY (déjà dans .env.example)EMAIL_FROM (déjà dans .env.example ou fallback "onboarding@resend.dev")NEXT_PUBLIC_APP_URL (déjà utilisé dans idea.ts)idea.submitLa sélection actuelle dans idea.submit est :
select: { id: true, name: true, slug: true }
name et slug sont déjà sélectionnés — aucune modification du select requise.
| Fichier | Action |
|---|---|
aimpact-hub/src/server/services/email.ts |
Modifier — ajouter sendSubmissionConfirmationEmail + son interface |
aimpact-hub/src/server/api/routers/idea.ts |
Modifier — import + fire-and-forget email dans submit |
aimpact-hub/src/components/form/SubmissionConfirmation.tsx |
Modifier — ajouter ligne "Un email de confirmation vous a été envoyé." |
aimpact-hub/src/server/services/email.test.ts |
Créer — tests Vitest pour la nouvelle fonction |
sendSubmissionConfirmationEmail (camelCase, verbe send + domaine, aligné avec sendInvitationEmail)SendSubmissionConfirmationEmailParams (PascalCase)if (!resend) → console.log("[email] ...") (pattern existant dans email.ts)throw new Error(...) si Resend retourne une erreur — l'appelant gère via .catch()void fn().catch((err: unknown) => { console.error(...) }) — pas de awaitvi.mock('resend', () => ({ Resend: vi.fn().mockImplementation(() => ({ emails: { send: vi.fn() } })) }))import { db } from "~/server/db" pour PrismaClientconsole.error("[email] ...") pour les logs d'erreur (convention préfixe [email]).catch((err: unknown) => { ... }) pour les fire-and-forget (TypeScript strict)SubmissionConfirmation composant et IdeaSubmissionForm existent et fonctionnent — cette story les étendsendInvitationEmail pattern dans email.ts — sert de référence directe pour la nouvelle fonctionsetSubmitted(true))src/server/services/email.ts est le service email centralisé (architecture.md § Services)src/server/api/routers/idea.ts est le router tRPC existant — modification minimaliste (import + 4 lignes)src/components/form/SubmissionConfirmation.tsx est dans components/form/ (feature-based, aligné architecture)src/server/services/email.test.ts co-localisé avec le service (convention *.test.ts).catch((err: unknown) => {...})]{{agent_model_name_version}}
séparés)
Date : 2026-02-28 Outcome : Changes Requested → Applied ✅
idea.submit.test.ts créé avec 3 tests couvrant le comportement fire-and-forgetsendSubmissionConfirmationEmail — test ajouté dans email.test.tsemail.ts obsolète (Story 2.1 seulement) — mis à jour avec Story 2.7<br /> dans <p> → accessibilité WCAG 2.1 AA — remplacé par deux <p> séparés dans SubmissionConfirmation.tsx