Status: done
En tant que Transformateur, je veux recevoir une notification email à chaque nouvelle idée soumise dans mon workspace, afin de réagir rapidement et de rester informé sans avoir à me connecter constamment à la plateforme.
Given une idée est soumise dans mon workspace via le formulaire web (/submit/[workspaceSlug])
When la soumission est validée (idée créée en base)
Then je reçois un email de notification contenant :
/workspace/[workspaceId]/ideas/[ideaId])Given une idée est soumise dans mon workspace via email (webhook Resend Inbound) When la soumission est validée (idée créée en base) Then je reçois un email de notification identique au cas 1
Given le workspace a un contactEmail configuré
When la notification est envoyée
Then l'email est adressé à contactEmail
Given le workspace n'a pas de contactEmail configuré
When la notification est envoyée
Then l'email est adressé à l'email du compte owner (User.email)
Given ni contactEmail ni owner.email ne sont disponibles
When la notification est envoyée
Then l'envoi est silencieusement ignoré (log côté serveur, pas d'erreur utilisateur)
Given l'envoi de la notification échoue (erreur Resend, réseau, etc.)
When l'échec se produit
Then l'idée est quand même créée — la notification est fire-and-forget (ne bloque jamais la soumission)
And l'erreur est loggée côté serveur : [email] New idea notification failed:
[x] Task 1 : Ajouter sendNewIdeaNotificationEmail dans src/server/services/email.ts (AC: #1, #2, #3, #4, #5, #6)
[x] Subtask 1.1 : Définir l'interface SendNewIdeaNotificationEmailParams :
export interface SendNewIdeaNotificationEmailParams {
transformateurEmail: string;
workspaceName: string;
workspaceId: string;
ideaId: string;
contributorEmail: string;
department: string;
problemDescriptionPreview: string; // tronqué à 200 chars côté appelant
}
[x] Subtask 1.2 : Implémenter sendNewIdeaNotificationEmail avec le pattern établi (Resend + mock dev)
Subject : Nouvelle idée soumise — {workspaceName}
HTML : département, aperçu description, email contributeur, lien dashboard
Lien : ${baseUrl}/workspace/${workspaceId}/ideas/${ideaId}
[x] Subtask 1.3 : Ajouter le mock console.log ([email] New idea notification (mock):) pour dev sans RESEND_API_KEY
[x] Task 2 : Modifier src/server/api/routers/idea.ts — procédure submit (AC: #1, #3, #4, #6)
[x] Subtask 2.1 : Étendre le select du workspace.findUnique pour inclure contactEmail et owner:
select: { id: true, name: true, slug: true, contactEmail: true, owner: { select: { email: true } } }
[x] Subtask 2.2 : Après la création de l'idée (après le fire-and-forget LLM et confirmation email), ajouter :
// Story 3.8 (FR32) : Notification email Transformateur — fire-and-forget
const transformateurEmail = workspace.contactEmail ?? workspace.owner.email;
if (transformateurEmail) {
void sendNewIdeaNotificationEmail({
transformateurEmail,
workspaceName: workspace.name,
workspaceId: workspace.id,
ideaId: idea.id,
contributorEmail: input.contributorEmail.toLowerCase().trim(),
department: input.department,
problemDescriptionPreview: input.problemDescription.slice(0, 200),
}).catch((err: unknown) => {
console.error("[email] New idea notification failed:", err);
});
}
[x] Subtask 2.3 : Importer sendNewIdeaNotificationEmail depuis ~/server/services/email
[x] Task 3 : Modifier src/app/api/webhooks/email/route.ts (AC: #2, #3, #4, #6)
[x] Subtask 3.1 : Étendre le select du workspace.findUnique (ligne ~89) :
select: { id: true, name: true, slug: true, contactEmail: true, owner: { select: { email: true } } }
[x] Subtask 3.2 : Après la transaction (création idée), déclencher la notification via after() ou fire-and-forget — utiliser after() pour cohérence avec l'enrichissement LLM :
// Story 3.8 (FR32) : Notification email Transformateur
const transformateurEmail = workspace.contactEmail ?? workspace.owner.email ?? null;
if (transformateurEmail) {
after(async () => {
try {
await sendNewIdeaNotificationEmail({
transformateurEmail,
workspaceName: workspace.name,
workspaceId: workspace.id,
ideaId: idea.id,
contributorEmail,
department: "email",
problemDescriptionPreview: problemDescription.slice(0, 200),
});
} catch (err) {
console.error("[email] New idea notification failed (webhook):", err);
}
});
}
[x] Subtask 3.3 : Importer sendNewIdeaNotificationEmail depuis ~/server/services/email
[x] Task 4 : Tests (AC: #1–#6)
src/server/services/email.test.ts (Vitest)transformateurEmail valide → resend.emails.send appelé avec le bon to, subject, html contenant le lien /workspace/${workspaceId}/ideas/${ideaId}RESEND_API_KEY absent → console.log mock appelé, pas d'erreurresend.emails.send retourne { error: {...} } → throw new Error avec messagesrc/server/api/routers/idea.submit.test.ts (Vitest)submit avec contactEmail configuré → sendNewIdeaNotificationEmail appelé avec transformateurEmail = contactEmailsubmit avec contactEmail = null → sendNewIdeaNotificationEmail appelé avec transformateurEmail = owner.emailsubmit avec contactEmail = null et owner.email = null → sendNewIdeaNotificationEmail non appelésendNewIdeaNotificationEmail throw → idée quand même retournée (le .catch() absorbe l'erreur)Aucun changement de schéma Prisma requis.
Le modèle Workspace contient déjà :
contactEmail String? — email de contact configuré par le Transformateur à la création du workspace (Story 1.3)owner User (relation) → User.email String? — email du compte propriétaireDestinataire de la notification :
Priorité : workspace.contactEmail → sinon workspace.owner.email → sinon aucun envoi (silencieux).
Justification : contactEmail peut différer de l'email du compte (FR1 — Story 1.3). En B2B, le CDO peut vouloir recevoir les notifications sur un email de service différent de son compte de connexion.
Pattern fire-and-forget (cohérence avec les Stories 2.7 et 3.1) :
// Dans idea.submit (tRPC router)
void sendNewIdeaNotificationEmail({...}).catch((err: unknown) => {
console.error("[email] New idea notification failed:", err);
});
// Dans webhooks/email/route.ts — utiliser after() pour s'exécuter APRÈS la réponse 200
after(async () => {
try {
await sendNewIdeaNotificationEmail({...});
} catch (err) {
console.error("[email] New idea notification failed (webhook):", err);
}
});
Important : La notification ne doit JAMAIS bloquer la création de l'idée. En cas d'échec Resend, l'idée est quand même créée et le formulaire répond correctement.
Contenu de l'email de notification recommandé :
<p>Bonjour,</p>
<p>Une nouvelle idée a été soumise dans votre workspace <strong>{workspaceName}</strong>.</p>
<ul>
<li><strong>Département :</strong> {department}</li>
<li><strong>Contributeur :</strong> {contributorEmail}</li>
<li><strong>Description :</strong> {problemDescriptionPreview}...</li>
</ul>
<p><a href="{ideaUrl}">Voir l'idée dans le dashboard →</a></p>
<p>— AImpact Hub</p>
Pas de notifyNewIdea opt-out : Le PRD (FR32) ne mentionne aucun mécanisme d'opt-out pour cette notification. La notification est envoyée à chaque nouvelle idée, sans condition. (Similaire à autoRelanceEnabled pour la relance J+21 — si un opt-out est demandé, il sera ajouté en correction ou story dédiée.)
| Fichier | Action | Notes |
|---|---|---|
src/server/services/email.ts |
Modifier — ajouter sendNewIdeaNotificationEmail |
Ajouter après sendManualRelanceEmail |
src/server/api/routers/idea.ts |
Modifier — procédure submit : étendre workspace select + appel notification |
Environ ligne 64 (findUnique) et ligne 124 (fire-and-forget email confirmation) |
src/app/api/webhooks/email/route.ts |
Modifier — étendre workspace select + appel notification via after() |
Environ ligne 89 (findUnique) et ligne 183 (after LLM block) |
src/server/services/email.newIdeaNotification.test.ts |
Créer — tests Vitest pour la fonction email | Pattern identique aux tests des autres fonctions email |
src/server/api/routers/idea.submit.notifyTransformateur.test.ts |
Créer — tests Vitest pour l'intégration dans submit | Mock sendNewIdeaNotificationEmail |
void fn().catch(...) dans idea.submit — ne jamais await un email dans une mutation tRPCafter() dans le webhook : déjà utilisé pour l'enrichissement LLM, cohérent d'utiliser le même mécanisme pour la notificationawait dans le webhook après la réponse : after() garantit l'exécution POST réponse 200 (Next.js 15+)submit*.test.ts à côté du fichier testé ou dans __tests__/Story 3.7 (résumé nouvelles activités) :
createWorkspaceProcedure → ctx.workspace contient tous les champs Workspace, y compris contactEmail et owner (si inclus dans le select initial de la procédure)ctx.workspace pour les procédures workspaceStory 2.7 (confirmation email) :
void sendXxxEmail({...}).catch((err: unknown) => { console.error("...", err); });idea.submit, le workspace est fetché avec select — penser à ajouter contactEmail et owner.email sinon TypeScript errorif (!resend) { console.log("[email] ...", {...}); return; }Story 2.10 (relance J+21) :
api/cron/relance/route.ts fetchait déjà workspace.name, workspace.slug pour les emails — même pattern à appliquerafter() dans le webhook email : utilisé pour l'enrichissement LLM (Story 3.1) — réutiliser pour la notificationStory 3.1 (enrichissement LLM) :
webhooks/email/route.ts utilise after() (Next.js 15) pour le fire-and-forget post-réponseafter() est importée depuis next/server : import { after, NextResponse } from "next/server"| Cas | Comportement |
|---|---|
contactEmail configuré |
Notification → contactEmail |
contactEmail = null, owner.email défini |
Notification → owner.email |
contactEmail = null, owner.email = null |
Aucun envoi, pas d'erreur |
| Resend indisponible | Idée créée quand même, erreur loggée, pas de retry |
RESEND_API_KEY absent (dev) |
console.log mock, pas d'envoi réel |
| Description très longue | Tronquée à 200 chars (problemDescription.slice(0, 200)) avant envoi |
| Idée soumise via email (webhook) | Même comportement que via formulaire |
| Soumission simultanées multiples | Une notification par idée, indépendantes |
services/email.ts : invitations, relances, notifications]submit : pattern fire-and-forget LLM + email confirmation (lignes 113–130)]after() pour LLM (lignes 183–195), workspace select (ligne 89)]contactEmail String?, relation owner User, owner.email String?]createWorkspaceProcedure, tests Vitest]{{agent_model_name_version}}
sendNewIdeaNotificationEmail ajoutée dans services/email.ts avec interface, mock dev, et échappement HTMLidea.submit (tRPC) : fire-and-forget avec priorité contactEmail → owner.emailwebhooks/email/route.ts : after() pour notification post-réponseescapeHtml définie avant usage (H2), indicateur … pour troncature (M2)