Status: done
En tant que Contributeur, je veux soumettre une idée par email à une adresse dédiée au workspace, afin de contribuer sans passer par le formulaire web.
Given le workspace a une inbox email dédiée dont l'adresse est affichée dans le dashboard (section Settings ou Contributors)
When je consulte le dashboard en tant que Transformateur
Then je vois l'adresse email dédiée du workspace au format ideas-{workspaceSlug}@{INBOUND_EMAIL_DOMAIN}
And un bouton "Copier l'adresse" permet de copier cette adresse facilement
Given le contributeur envoie un email à l'adresse inbox dédiée
When l'email arrive chez Resend Inbound
Then Resend appelle le webhook POST /api/webhooks/email avec le payload email.received
And une idée est créée dans le backlog du workspace en moins de 15 minutes (NFR6)
Given le webhook reçoit un payload Resend email.received
When le handler traite l'email
Then la signature Resend est vérifiée via resend.webhooks.verify() avant tout traitement (headers svix-id, svix-timestamp, svix-signature)
And si la signature est invalide → réponse 401 Unauthorized, aucune idée créée
Given la signature est valide
When le handler extrait les données de l'email
Then le slug du workspace est extrait du champ to (format ideas-{workspaceSlug}@{domain})
And si le workspace n'est pas trouvé en base → réponse 404, aucune idée créée
And si le workspace est trouvé → le corps de l'email est récupéré via l'API Resend (resend.emails.receiving.get({ emailId }))
Given le corps de l'email est récupéré When l'idée est créée en base Then les champs sont remplis comme suit :
contributorEmail : adresse email de l'expéditeur (champ from, parsé pour extraire l'email seul)problemDescription : corps de l'email en texte brut (text)department : "email" (valeur fixe pour distinguer les soumissions email)estimatedImpact : MODERE (défaut pour soumissions email)frequency : PONCTUELLE (défaut pour soumissions email)workspaceId : résolu depuis le slug du workspace
And si un Contributor existe dans ce workspace avec le même email → contributorId est défini et son statut passe à SUBMITTEDGiven l'idée est créée avec succès
When le webhook répond
Then réponse 200 OK avec { success: true, ideaId: "..." }
And aucune idée en doublon n'est créée si le même webhook est rejoué (idempotence via message_id Resend)
[x] Task 1 : Affichage de l'inbox email dans le dashboard (AC: #1)
INBOUND_EMAIL_DOMAIN dans .env.example avec une valeur de test (ex. cool-hedgehog.resend.app)getWorkspaceInboxEmail(slug: string): string dans src/lib/utils.ts (ou src/lib/email-inbox.ts) : return \ideas-\${slug}@\${process.env.INBOUND_EMAIL_DOMAIN ?? 'resend.app'}``src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx) une section "Recevoir des idées par email" avec l'adresse inbox affichée et un bouton "Copier" (toast de confirmation)[x] Task 2 : Route webhook POST /api/webhooks/email (AC: #2, #3, #4, #5, #6)
src/app/api/webhooks/email/route.ts — route POST Next.js App Router[x] Subtask 2.2 : Vérification de la signature Resend dans le handler :
const payload = await req.text(); // lire le corps brut AVANT json()
const headers = {
id: req.headers.get('svix-id') ?? '',
timestamp: req.headers.get('svix-timestamp') ?? '',
signature: req.headers.get('svix-signature') ?? '',
};
const event = resend.webhooks.verify({ payload, headers, webhookSecret: process.env.RESEND_WEBHOOK_SECRET! });
[x] Subtask 2.3 : Filtrer uniquement event.type === 'email.received' — ignorer les autres types (répondre 200 sans traitement)
[x] Subtask 2.4 : Extraire le slug depuis le champ to — parser data.to[0] pour obtenir la partie locale avant @, puis retirer le préfixe ideas- : slug = to.split('@')[0].replace('ideas-', '')
[x] Subtask 2.5 : Chercher le workspace par slug avec ctx.db.workspace.findUnique({ where: { slug } }) — si non trouvé → NextResponse.json({ error: 'Workspace not found' }, { status: 404 })
[x] Subtask 2.6 : Idempotence — vérifier si une idée avec messageId = data.message_id existe déjà en base avant création (voir Task 3 pour le champ messageId)
[x] Subtask 2.7 : Appel API Resend pour récupérer le corps de l'email :
const emailContent = await resend.emails.receiving.get({ emailId: data.email_id });
const bodyText = emailContent.data?.text ?? emailContent.data?.html ?? data.subject ?? '';
[x] Subtask 2.8 : Créer l'idée en base (transaction Prisma) — voir champs AC #5 ; matching contributeur par email comme dans idea.router.submit
[x] Subtask 2.9 : Retourner NextResponse.json({ success: true, ideaId: idea.id }, { status: 200 })
[x] Task 3 : Migration Prisma pour idempotence email (AC: #6)
emailMessageId String? @unique sur le modèle Idea dans prisma/schema.prisma — pour stocker le message_id Resend et éviter les doublons sur replay webhookprisma migrate dev --name add_idea_email_message_id[x] Task 4 : Variables d'environnement (AC: #2, #3)
RESEND_WEBHOOK_SECRET dans .env.example (obligatoire en production)RESEND_API_KEY est déjà documenté dans .env.example (déjà présent depuis Story 2.1)[x] Task 5 : Tests (AC: #2, #3, #4, #5, #6)
src/app/api/webhooks/email/route.test.ts (ou __tests__/api/webhooks/email.test.ts) avec Vitest — mocker resend.webhooks.verify, resend.emails.receiving.get, et ctx.dbmessage_id → 200 sans doubloncontributorId défini, statut SUBMITTEDResend Inbound — comportement critique à connaître :
email.received ne contient PAS le corps de l'email — uniquement les métadonnées (from, to, subject, message_id, liste des pièces jointes)resend.emails.receiving.get({ emailId }) après réception du webhookSécurité webhook — NE PAS OUBLIER :
req.text()) AVANT de le parser en JSON pour la vérification — sinon la signature sera invalideRESEND_WEBHOOK_SECRET est configuré dans le dashboard Resend lors de la création du webhookRoutage workspace par email :
ideas-{workspaceSlug}@{INBOUND_EMAIL_DOMAIN}to pour identifier le workspaceto, prendre data.to[0] et chercher celle qui commence par ideas-ideas-acme-corp@cool-hedgehog.resend.app → slug = acme-corpIdempotence — champ emailMessageId :
message_id du payload (data.message_id) est unique par emailawait db.idea.findFirst({ where: { emailMessageId: data.message_id } })200 { success: true, ideaId: existing.id } sans recréerValeurs par défaut pour soumissions email :
| Champ | Valeur | Raison |
|-------|--------|--------|
| department | "email" | Distingue soumissions email des soumissions formulaire |
| estimatedImpact | MODERE | Défaut raisonnable, le Transformateur ajustera |
| frequency | PONCTUELLE | Défaut conservateur |
| status | SUBMITTED | Statut initial standard |
Récupération du corps email — fallback :
const emailContent = await resend.emails.receiving.get({ emailId: data.email_id });
const bodyText = (
emailContent.data?.text ?? // texte brut (préféré)
emailContent.data?.html?.replace(/<[^>]*>/g, ' ').trim() ?? // HTML → texte
data.subject ?? // sujet comme fallback
'Idée soumise par email' // dernier recours
).trim();
Parsing du champ from :
from peut être au format "Prénom Nom <email@domain.com>" ou "email@domain.com"from.match(/<([^>]+)>/)?.[1] ?? from.trim()| Fichier | Action |
|---|---|
src/app/api/webhooks/email/route.ts |
Créer — handler webhook Resend Inbound |
src/lib/email-inbox.ts (ou utils.ts) |
Modifier — ajouter getWorkspaceInboxEmail() |
src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx |
Modifier — afficher inbox email |
prisma/schema.prisma |
Modifier — ajouter emailMessageId String? @unique sur Idea |
prisma/migrations/YYYYMMDD_add_idea_email_message_id/migration.sql |
Créer — migration Prisma |
.env.example |
Modifier — ajouter INBOUND_EMAIL_DOMAIN, RESEND_WEBHOOK_SECRET |
src/app/api/webhooks/email/route.test.ts |
Créer — tests Vitest |
~/server/db (instance singleton), pas de new PrismaClient() directement dans la routeResend est instancié dans src/server/services/email.ts — créer une instance séparée dans la route webhook OU exporter l'instance resend depuis le service email existantNextResponse.json() avec les bons codes HTTPworkspaceId lors des requêtes Prisma — ne jamais chercher des idées sans filtre workspace"type": "module" — pas d'import CommonJS sans .cjsroute.ts, pas de default export nommé (export POST)Ajouter sur le modèle Idea :
emailMessageId String? @unique // idempotence webhook Resend — Story 2.5
Cela permet db.idea.findUnique({ where: { emailMessageId: messageId } }) pour l'idempotence.
tsx est en devDependency, script db:seed configuréimport { PrismaClient } from "../generated/prisma" pour les scripts standalone ; dans les routes Next.js, utiliser import { db } from "~/server/db"vi.mock("~/server/db", () => ({ db: { idea: { create: mockCreate } } }))services/email.ts utilise le SDK Resend — pattern de mock à réutiliser dans les testsLibraryCase est en base, seed exécuté (25 cas disponibles)library.ts avec getAll et getById est fonctionnelLibraryBrowser, LibraryModal, LibraryCaseCard existent dans src/components/library/IdeaSubmissionForm supporte initialPrefillText, autoOpenLibrary, initialLibraryFiltershttps://{app-domain}/api/webhooks/email, sélectionner l'événement email.receivedRESEND_WEBHOOK_SECRET généré → variable d'environnement.resend.app fourni par défaut)INBOUND_EMAIL_DOMAIN.resend.appto garantit le routage correct ; validation workspace en DB avant créationarchitecture.md : src/app/api/webhooks/email/route.ts est déjà prévu dans l'arborescence cibleroute.ts doit exporter une fonction POST nommée (App Router)src/server/db.ts expose export const db = prisma — utiliser import { db } from "~/server/db"{{agent_model_name_version}}
getWorkspaceInboxEmail dans src/lib/email-inbox.ts, section "Recevoir des idées par email" dans EmailInboxSection (client component) avec bouton Copier + toastPOST /api/webhooks/email avec vérification Resend Svix, extraction slug depuis to, idempotence via emailMessageId, appel API Resend pour contenu email, création idée + matching contributeuremailMessageId sur Idea, migration 20260227120000_add_idea_email_message_idINBOUND_EMAIL_DOMAIN et RESEND_WEBHOOK_SECRET dans .env.example