# 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**