# Story 2.11 : Relance manuelle Transformateur (FR11, FR12, FR13) Status: done ## Story En tant que Transformateur, je veux envoyer une relance manuelle à tous les contributeurs de mon workspace avec un message personnalisable, afin de relancer l'engagement et de communiquer directement avec les contributeurs. ## Acceptance Criteria 1. **Given** j'ai au moins 1 contributeur dans mon workspace **When** je clique sur le bouton "Envoyer une relance" depuis la page contributeurs **Then** un dialogue s'ouvre avec un formulaire de personnalisation (objet et corps pré-remplis avec un message par défaut) 2. **Given** j'ai personnalisé le message (objet et corps du mail) **When** je clique sur "Suivant" **Then** une étape de confirmation s'affiche : "Vous allez contacter X contributeurs. Confirmer ?" **And** un aperçu du message est visible **And** le bouton de confirmation libelle l'action exacte : "Envoyer la relance à X contributeurs" **And** un bouton "Modifier" permet de revenir à l'étape de rédaction 3. **Given** j'ai confirmé l'envoi de la relance **When** le système traite l'envoi **Then** un email avec le message personnalisé est envoyé à tous les contributeurs du workspace **And** chaque email inclut un lien direct vers le formulaire de soumission `/submit/[workspaceSlug]` **And** un toast confirme le succès : "Relance envoyée à X contributeurs" 4. **Given** la relance a été envoyée **When** je consulte la page contributeurs **Then** un log d'envoi (date, nombre de destinataires, objet) est visible dans une section "Historique des relances" 5. **Given** je n'ai aucun contributeur dans mon workspace **When** j'essaie d'envoyer une relance **Then** le bouton "Envoyer une relance" est désactivé avec un tooltip explicatif 6. **Given** un ou plusieurs envois échouent **When** la relance est traitée **Then** le système envoie à chaque contributeur individuellement (pas de blocage en cascade) **And** le résumé indique le nombre d'envois réussis et échoués **And** le log enregistre `sentCount` et `failedCount` séparément ## Tasks / Subtasks - [x] Task 1 : Migration Prisma - modèle ManualRelanceLog (AC: #4) - [x] 1.1 : Ajouter le modèle `ManualRelanceLog` dans `schema.prisma` - [x] 1.2 : Ajouter la relation `manualRelanceLogs ManualRelanceLog[]` sur `Workspace` - [x] 1.3 : Générer et appliquer la migration : `npx prisma migrate dev --name add_manual_relance_log` - [x] Task 2 : Service email - `sendManualRelanceEmail()` (AC: #3) - [x] 2.1 : Ajouter l'interface `SendManualRelanceEmailParams` et la fonction `sendManualRelanceEmail` dans `src/server/services/email.ts` - [x] 2.2 : Même pattern que `sendInvitationEmail` - escaping HTML, mock dev, Resend - [x] Task 3 : tRPC - mutation `sendManualRelance` + query `relanceLogs` (AC: #1–#6) - [x] 3.1 : Ajouter le schéma d'input Zod `sendManualRelanceInputSchema` dans `contributor.ts` - [x] 3.2 : Implémenter la mutation `sendManualRelance` : compter les destinataires, boucle d'envoi individuelle avec try/catch, créer le log - [x] 3.3 : Implémenter la query `relanceLogs` : lister les 10 derniers logs triés par date desc - [x] 3.4 : Importer `sendManualRelanceEmail` depuis `email.ts` - [x] Task 4 : UI - composant `ManualRelanceDialog` (AC: #1, #2, #3, #5) - [x] 4.1 : Créer `src/components/workspace/ManualRelanceDialog.tsx` - [x] 4.2 : Étape 1 : formulaire de rédaction (objet + corps) avec valeurs par défaut - [x] 4.3 : Étape 2 : confirmation avec aperçu du message et compteur de destinataires - [x] 4.4 : État loading pendant l'envoi, toast de confirmation, invalidation du cache - [x] Task 5 : UI - composant `RelanceHistory` + intégration page contributeurs (AC: #4) - [x] 5.1 : Créer `src/components/workspace/RelanceHistory.tsx` - table avec date, objet, compteur - [x] 5.2 : Modifier `contributors/page.tsx` - ajouter `ManualRelanceDialog` et `RelanceHistory` - [x] Task 6 : Tests (AC: #1–#6) - [x] 6.1 : Tests unitaires `sendManualRelanceEmail` dans `email.test.ts` (mock Resend, même pattern que tests existants) - [x] 6.2 : Tests unitaires pour la mutation `sendManualRelance` (envoi réussi, envoi partiel avec échecs, 0 contributeurs) - [x] 6.3 : Test composant `ManualRelanceDialog` (rendu, étapes compose/confirm, bouton désactivé si 0 contributeurs) ## Dev Notes ### Analyse de l'état existant - ce qui est DÉJÀ implémenté (NE PAS refaire) **`email.ts` - service email existant (Stories 2.1, 2.7) :** - Provider : **Resend** (`import { Resend } from "resend"`) - Helper `getResend()` : retourne `null` si `RESEND_API_KEY` absent → log console en dev - Helper `getBaseUrl()` : `NEXT_PUBLIC_APP_URL` > `VERCEL_URL` > `localhost:3000` - Fonctions existantes : `sendInvitationEmail()`, `sendSubmissionConfirmationEmail()` - Pattern HTML escaping anti-XSS sur `workspaceName` : ```typescript const escapedName = params.workspaceName .replace(/&/g, "&").replace(//g, ">").replace(/"/g, """); ``` - Variable `EMAIL_FROM` : `process.env.EMAIL_FROM ?? "onboarding@resend.dev"` - **NE PAS** modifier `getResend()` ni `getBaseUrl()` - les réutiliser tels quels **`contributor.ts` (router) - procédures existantes :** - `invite` (mutation) : crée contributeurs, envoie emails, vérifie limites tier, utilise `createWorkspaceProcedure` - `list` (query) : `findMany` avec `include: { _count: { select: { ideas: true } } }`, tri `invitedAt: "desc"` - Import existant : `import { sendInvitationEmail } from "~/server/services/email";` - **Étendre** ce router avec les nouvelles procédures (pas créer un nouveau router) **`ContributorsList.tsx` - composant existant :** - Table : Email | Statut | Invité le - Badges : SUBMITTED (vert `bg-green-100`), NOT_SUBMITTED (ambre `bg-amber-100`), INVITED (secondary) - Compteurs en header : X contributeurs · Y ont soumis · Z en attente - **NE PAS modifier** ce composant - la relance est un composant séparé **Page contributeurs (`contributors/page.tsx`) - structure existante :** - Server component : `auth()` + `db.workspace.findFirst()` + `db.contributor.count()` - Layout : `
` avec `max-w-2xl space-y-6` - Sections actuelles : titre+description → InviteContributorsForm → ContributorsList → bouton retour - **À modifier** pour intégrer le bouton de relance et l'historique **Schéma Prisma actuel - Contributor :** ``` id, workspaceId, email, status (enum INVITED/SUBMITTED/NOT_SUBMITTED), invitedAt, createdAt, ideas[] @@unique([workspaceId, email]) ``` - **NE PAS modifier** le modèle Contributor dans cette story **Schéma Prisma actuel - Workspace :** ``` id, name, slug, sector, companySize, contactEmail, tier, llmCallsThisMonth, llmCallsResetAt, ownerId Relations: owner, contributors[], ideas[] ``` - **À modifier** : ajouter la relation `manualRelanceLogs` ### Modifications précises - Task 1 : Migration Prisma **Ajouter le modèle ManualRelanceLog :** ```prisma model ManualRelanceLog { id String @id @default(cuid()) workspaceId String subject String recipientCount Int sentCount Int failedCount Int @default(0) sentAt DateTime @default(now()) workspace Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade) @@index([workspaceId]) } ``` **Ajouter la relation dans le modèle Workspace :** ```prisma model Workspace { // ... champs existants - NE PAS toucher ... manualRelanceLogs ManualRelanceLog[] // ... relations existantes (owner, contributors, ideas) ... } ``` **Commande migration :** ```bash cd aimpact-hub npx prisma migrate dev --name add_manual_relance_log ``` ### Modifications précises - Task 2 : `sendManualRelanceEmail()` Ajouter dans `src/server/services/email.ts` - MÊME pattern que `sendInvitationEmail` : ```typescript export interface SendManualRelanceEmailParams { email: string; subject: string; body: string; workspaceSlug: string; workspaceName: string; } export async function sendManualRelanceEmail( params: SendManualRelanceEmailParams ): Promise { const baseUrl = getBaseUrl(); const submitUrl = `${baseUrl}/submit/${params.workspaceSlug}`; const from = process.env.EMAIL_FROM ?? "onboarding@resend.dev"; const escapedName = params.workspaceName .replace(/&/g, "&") .replace(//g, ">") .replace(/"/g, """); const escapedBody = params.body .replace(/&/g, "&") .replace(//g, ">") .replace(/"/g, """) .replace(/\n/g, "
"); const html = `

Bonjour,

${escapedBody}

Soumettre une idée →

- L'équipe ${escapedName}

`; const resend = getResend(); if (!resend) { console.log("[email] Manual relance (mock):", { to: params.email, subject: params.subject, submitUrl, }); return; } const { error } = await resend.emails.send({ from, to: params.email, subject: params.subject, html, }); if (error) { throw new Error(`Échec envoi relance manuelle: ${error.message}`); } } ``` **Points critiques :** - Le `body` du CDO est échappé HTML (anti-XSS) puis `\n` → `
` - Le lien formulaire `/submit/[workspaceSlug]` est toujours ajouté automatiquement en fin d'email - Le `subject` vient du CDO tel quel (pas de préfixe automatique) - Le mock dev log le même format que les emails existants ### Modifications précises - Task 3 : tRPC mutation + query **Ajouter dans `contributor.ts` - schéma d'input :** ```typescript const sendManualRelanceInputSchema = z.object({ workspaceId: z.string().cuid(), subject: z.string().min(1, "L'objet est requis").max(200, "Objet trop long"), body: z.string().min(1, "Le corps du message est requis").max(2000, "Message trop long"), }); ``` **Ajouter la mutation dans `contributorRouter` :** ```typescript sendManualRelance: createWorkspaceProcedure .input(sendManualRelanceInputSchema) .mutation(async ({ ctx, input }) => { const workspace = ctx.workspace; const contributors = await db.contributor.findMany({ where: { workspaceId: input.workspaceId }, select: { email: true }, }); if (contributors.length === 0) { throw new TRPCError({ code: "BAD_REQUEST", message: "Aucun contributeur dans ce workspace", }); } let sent = 0; let failed = 0; for (const contributor of contributors) { try { await sendManualRelanceEmail({ email: contributor.email, subject: input.subject, body: input.body, workspaceSlug: workspace.slug, workspaceName: workspace.name, }); sent++; } catch (error) { console.error( `[contributor.sendManualRelance] Échec pour ${contributor.email}:`, error ); failed++; } } await db.manualRelanceLog.create({ data: { workspaceId: input.workspaceId, subject: input.subject, recipientCount: contributors.length, sentCount: sent, failedCount: failed, }, }); return { sent, failed, total: contributors.length }; }), ``` **Ajouter la query dans `contributorRouter` :** ```typescript relanceLogs: createWorkspaceProcedure.query(async ({ ctx }) => { return db.manualRelanceLog.findMany({ where: { workspaceId: ctx.workspace.id }, orderBy: { sentAt: "desc" }, take: 10, }); }), ``` **Import à ajouter en haut de `contributor.ts` :** ```typescript import { sendManualRelanceEmail } from "~/server/services/email"; ``` **Points critiques :** - Le `try/catch` individuel par contributeur empêche qu'un échec bloque les autres (pattern Story 2-10) - Le log est créé APRÈS la boucle d'envoi, avec le décompte réel `sent/failed` - La requête `findMany` cible TOUS les contributeurs sans filtre de statut (FR11) - `relanceLogs` est limité à 10 entrées pour la performance ### Modifications précises - Task 4 : ManualRelanceDialog Créer `src/components/workspace/ManualRelanceDialog.tsx` : Le composant utilise un dialogue shadcn en 2 étapes : 1. **Rédaction** : formulaire avec `Input` (objet) + `Textarea` (corps) pré-remplis 2. **Confirmation** : aperçu du message + compteur de destinataires + bouton d'envoi libellé avec l'action exacte ```typescript "use client"; import { useState } from "react"; import { api } from "~/trpc/react"; import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, } from "~/components/ui/dialog"; import { Button } from "~/components/ui/button"; import { Input } from "~/components/ui/input"; import { Label } from "~/components/ui/label"; import { Textarea } from "~/components/ui/textarea"; import { useToast } from "~/hooks/use-toast"; interface ManualRelanceDialogProps { workspaceId: string; workspaceName: string; contributorsCount: number; } const DEFAULT_SUBJECT_PREFIX = "Rappel : partagez vos idées"; const DEFAULT_BODY = `Nous souhaitons vous rappeler que vous pouvez à tout moment partager vos idées pour la transformation de notre entreprise. Votre expérience terrain est précieuse. Si vous avez un problème récurrent ou une opportunité d'amélioration, n'hésitez pas à le partager. 2 minutes suffisent pour décrire un problème ou une opportunité.`; export function ManualRelanceDialog({ workspaceId, workspaceName, contributorsCount, }: ManualRelanceDialogProps) { const [open, setOpen] = useState(false); const [step, setStep] = useState<"compose" | "confirm">("compose"); const [subject, setSubject] = useState( `${DEFAULT_SUBJECT_PREFIX} - ${workspaceName}` ); const [body, setBody] = useState(DEFAULT_BODY); const { toast } = useToast(); const utils = api.useUtils(); const sendRelance = api.contributor.sendManualRelance.useMutation({ onSuccess: (data) => { const desc = data.failed > 0 ? `${data.sent} envoyé${data.sent > 1 ? "s" : ""}, ${data.failed} échec${data.failed > 1 ? "s" : ""}` : `${data.sent} email${data.sent > 1 ? "s" : ""} envoyé${data.sent > 1 ? "s" : ""}`; toast({ title: "Relance envoyée", description: desc }); void utils.contributor.relanceLogs.invalidate(); setOpen(false); setStep("compose"); }, onError: (error) => { toast({ title: "Erreur", description: error.message, variant: "destructive", }); }, }); const handleSend = () => { sendRelance.mutate({ workspaceId, subject, body }); }; const handleOpenChange = (newOpen: boolean) => { setOpen(newOpen); if (!newOpen) setStep("compose"); }; const plural = contributorsCount > 1 ? "s" : ""; return ( {step === "compose" ? ( <> Relance manuelle Personnalisez le message qui sera envoyé à vos{" "} {contributorsCount} contributeur{plural}.
setSubject(e.target.value)} maxLength={200} />