code-review-2-5-soumission-didee-par-email-fr15.md 3.1 KB

Code Review — Story 2.5: Soumission d'idée par email (FR15)

Reviewer: BMad Master (AI)
Date: 2026-03-02
Story: 2-5-soumission-didee-par-email-fr15
Git vs Story Discrepancies: N/A
Issues Found: 0 High, 0 Medium (1 corrigé), 2 Low


Validation des AC

AC Statut Note
#1 Inbox affichée, format ideas-{slug}@domain, bouton Copier ✅ EmailInboxSection dans settings, getWorkspaceInboxEmail(slug), bouton Copier + toast
#2 Webhook POST /api/webhooks/email, idée créée ✅ Route implémentée, création idée + after() enrichissement LLM + notification (Stories 3.1, 3.8)
#3 Signature Resend vérifiée, 401 si invalide ✅ req.text() puis resend.webhooks.verify(payload, headers, webhookSecret), 401 sur erreur
#4 Slug depuis to, 404 si workspace absent, corps via API Resend ✅ extractWorkspaceSlugFromTo(data.to), findUnique workspace, resend.emails.receiving.get(email_id)
#5 Champs idée : contributorEmail, problemDescription, department=email, estimatedImpact=MODERE, frequency=PONCTUELLE, contributorId + statut SUBMITTED ✅ Tous présents dans tx.idea.create et mise à jour contributeur en transaction
#6 Réponse 200 { success: true, ideaId }, idempotence via message_id ✅ Idempotence par emailMessageId (findUnique avant create)

Corrections appliquées pendant la review

Test AC #5 — Vérification des champs en création

Constat : Le test "crée une idée avec les bons champs" ne vérifiait pas les données passées à idea.create (department, estimatedImpact, frequency, contributorEmail, etc.).

Correction : Assertion ajoutée dans route.test.ts : expect(mockIdeaCreate).toHaveBeenCalledWith(expect.objectContaining({ data: expect.objectContaining({ department: "email", estimatedImpact: "MODERE", frequency: "PONCTUELLE", ... }) })). Tous les tests passent.


🟢 LOW (non bloquants)

1. Variables d'environnement hors schéma env

Fichiers : src/lib/email-inbox.ts (process.env.INBOUND_EMAIL_DOMAIN), route webhook (process.env.RESEND_WEBHOOK_SECRET).

INBOUND_EMAIL_DOMAIN et RESEND_WEBHOOK_SECRET ne sont pas déclarés dans ~/env (zod). Ils sont documentés dans .env.example mais non validés au build. Recommandation : les ajouter au schéma env.js pour cohérence et validation en prod.

2. Idempotence sans message_id

Fichier : src/app/api/webhooks/email/route.ts

Si le payload Resend n’envoie pas message_id, aucun contrôle d’idempotence n’est fait : un rejeu du webhook peut créer plusieurs idées. Comportement acceptable (Resend fournit normalement message_id) ; à documenter ou traiter en cas de replay sans message_id.


Résumé

Sévérité Nombre
HIGH 0
MEDIUM 0 (1 corrigé)
LOW 2

AC : Tous implémentés. Tasks : Toutes couvertes. Tests : 10 tests Vitest (401, 404, création avec bons champs, idempotence, pas d’adresse ideas-, from vide, matching contributeur, notification, résilience).

Statut : ✅ done