Status: done
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.
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)
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
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"
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"
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
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
[x] Task 1 : Migration Prisma - modèle ManualRelanceLog (AC: #4)
ManualRelanceLog dans schema.prismamanualRelanceLogs ManualRelanceLog[] sur Workspacenpx prisma migrate dev --name add_manual_relance_log[x] Task 2 : Service email - sendManualRelanceEmail() (AC: #3)
SendManualRelanceEmailParams et la fonction sendManualRelanceEmail dans src/server/services/email.tssendInvitationEmail - escaping HTML, mock dev, Resend[x] Task 3 : tRPC - mutation sendManualRelance + query relanceLogs (AC: #1–#6)
sendManualRelanceInputSchema dans contributor.tssendManualRelance : compter les destinataires, boucle d'envoi individuelle avec try/catch, créer le logrelanceLogs : lister les 10 derniers logs triés par date descsendManualRelanceEmail depuis email.ts[x] Task 4 : UI - composant ManualRelanceDialog (AC: #1, #2, #3, #5)
src/components/workspace/ManualRelanceDialog.tsx[x] Task 5 : UI - composant RelanceHistory + intégration page contributeurs (AC: #4)
src/components/workspace/RelanceHistory.tsx - table avec date, objet, compteurcontributors/page.tsx - ajouter ManualRelanceDialog et RelanceHistory[x] Task 6 : Tests (AC: #1–#6)
sendManualRelanceEmail dans email.test.ts (mock Resend, même pattern que tests existants)sendManualRelance (envoi réussi, envoi partiel avec échecs, 0 contributeurs)ManualRelanceDialog (rendu, étapes compose/confirm, bouton désactivé si 0 contributeurs)email.ts - service email existant (Stories 2.1, 2.7) :
import { Resend } from "resend")getResend() : retourne null si RESEND_API_KEY absent → log console en devgetBaseUrl() : NEXT_PUBLIC_APP_URL > VERCEL_URL > localhost:3000sendInvitationEmail(), sendSubmissionConfirmationEmail()Pattern HTML escaping anti-XSS sur workspaceName :
const escapedName = params.workspaceName
.replace(/&/g, "&").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 createWorkspaceProcedurelist (query) : findMany avec include: { _count: { select: { ideas: true } } }, tri invitedAt: "desc"import { sendInvitationEmail } from "~/server/services/email";ContributorsList.tsx - composant existant :
bg-green-100), NOT_SUBMITTED (ambre bg-amber-100), INVITED (secondary)Page contributeurs (contributors/page.tsx) - structure existante :
auth() + db.workspace.findFirst() + db.contributor.count()<main> avec max-w-2xl space-y-6Schéma Prisma actuel - Contributor :
id, workspaceId, email, status (enum INVITED/SUBMITTED/NOT_SUBMITTED), invitedAt, createdAt, ideas[]
@@unique([workspaceId, email])
Schéma Prisma actuel - Workspace :
id, name, slug, sector, companySize, contactEmail, tier, llmCallsThisMonth, llmCallsResetAt, ownerId
Relations: owner, contributors[], ideas[]
manualRelanceLogsAjouter le modèle ManualRelanceLog :
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 :
model Workspace {
// ... champs existants - NE PAS toucher ...
manualRelanceLogs ManualRelanceLog[]
// ... relations existantes (owner, contributors, ideas) ...
}
Commande migration :
cd aimpact-hub
npx prisma migrate dev --name add_manual_relance_log
sendManualRelanceEmail()Ajouter dans src/server/services/email.ts - MÊME pattern que sendInvitationEmail :
export interface SendManualRelanceEmailParams {
email: string;
subject: string;
body: string;
workspaceSlug: string;
workspaceName: string;
}
export async function sendManualRelanceEmail(
params: SendManualRelanceEmailParams
): Promise<void> {
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, ">")
.replace(/"/g, """);
const escapedBody = params.body
.replace(/&/g, "&")
.replace(/</g, "<")
.replace(/>/g, ">")
.replace(/"/g, """)
.replace(/\n/g, "<br>");
const html = `
<p>Bonjour,</p>
<p>${escapedBody}</p>
<p><a href="${submitUrl}">Soumettre une idée →</a></p>
<p>- L'équipe ${escapedName}</p>
`;
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 :
body du CDO est échappé HTML (anti-XSS) puis \n → <br>/submit/[workspaceSlug] est toujours ajouté automatiquement en fin d'emailsubject vient du CDO tel quel (pas de préfixe automatique)Ajouter dans contributor.ts - schéma d'input :
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 :
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 :
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 :
import { sendManualRelanceEmail } from "~/server/services/email";
Points critiques :
try/catch individuel par contributeur empêche qu'un échec bloque les autres (pattern Story 2-10)sent/failedfindMany cible TOUS les contributeurs sans filtre de statut (FR11)relanceLogs est limité à 10 entrées pour la performanceCréer src/components/workspace/ManualRelanceDialog.tsx :
Le composant utilise un dialogue shadcn en 2 étapes :
Input (objet) + Textarea (corps) pré-remplisConfirmation : aperçu du message + compteur de destinataires + bouton d'envoi libellé avec l'action exacte
"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 (
<Dialog open={open} onOpenChange={handleOpenChange}>
<DialogTrigger asChild>
<Button
variant="outline"
disabled={contributorsCount === 0}
title={
contributorsCount === 0
? "Aucun contributeur à contacter"
: undefined
}
>
Envoyer une relance
</Button>
</DialogTrigger>
<DialogContent className="sm:max-w-lg">
{step === "compose" ? (
<>
<DialogHeader>
<DialogTitle>Relance manuelle</DialogTitle>
<DialogDescription>
Personnalisez le message qui sera envoyé à vos{" "}
{contributorsCount} contributeur{plural}.
</DialogDescription>
</DialogHeader>
<div className="space-y-4">
<div>
<Label htmlFor="relance-subject">Objet</Label>
<Input
id="relance-subject"
value={subject}
onChange={(e) => setSubject(e.target.value)}
maxLength={200}
/>
</div>
<div>
<Label htmlFor="relance-body">Message</Label>
<Textarea
id="relance-body"
value={body}
onChange={(e) => setBody(e.target.value)}
rows={8}
maxLength={2000}
/>
<p className="mt-1 text-xs text-muted-foreground">
Un lien vers le formulaire de soumission sera automatiquement
ajouté en fin de message.
</p>
</div>
</div>
<DialogFooter>
<Button variant="outline" onClick={() => setOpen(false)}>
Annuler
</Button>
<Button
onClick={() => setStep("confirm")}
disabled={!subject.trim() || !body.trim()}
>
Suivant
</Button>
</DialogFooter>
</>
) : (
<>
<DialogHeader>
<DialogTitle>Confirmer l'envoi</DialogTitle>
<DialogDescription>
Vous allez contacter {contributorsCount} contributeur{plural}.
Confirmer ?
</DialogDescription>
</DialogHeader>
<div className="rounded-md border bg-muted/30 p-3 text-sm">
<p className="font-medium">Objet : {subject}</p>
<p className="mt-2 whitespace-pre-wrap text-muted-foreground">
{body}
</p>
</div>
<DialogFooter>
<Button variant="outline" onClick={() => setStep("compose")}>
Modifier
</Button>
<Button onClick={handleSend} disabled={sendRelance.isPending}>
{sendRelance.isPending
? "Envoi en cours…"
: `Envoyer la relance à ${contributorsCount} contributeur${plural}`}
</Button>
</DialogFooter>
</>
)}
</DialogContent>
</Dialog>
);
}
Vérification import useToast : Le hook useToast peut être à ~/hooks/use-toast ou ~/components/ui/use-toast selon la version de shadcn installée. Vérifier le chemin exact dans le projet avant d'implémenter. Si le hook n'existe pas, installer le composant Toast : npx shadcn@latest add toast.
Patterns UX critiques :
disabled pendant l'envoi avec texte "Envoi en cours…"disabled + tooltip si 0 contributeursCréer src/components/workspace/RelanceHistory.tsx :
"use client";
import { api } from "~/trpc/react";
export function RelanceHistory({ workspaceId }: { workspaceId: string }) {
const { data: logs, isLoading } = api.contributor.relanceLogs.useQuery({
workspaceId,
});
if (isLoading) {
return (
<div className="rounded-md border p-4">
<p className="text-sm text-muted-foreground">Chargement…</p>
</div>
);
}
if (!logs || logs.length === 0) {
return (
<div className="rounded-md border p-4">
<p className="text-sm text-muted-foreground">
Aucune relance envoyée pour le moment.
</p>
</div>
);
}
return (
<div className="rounded-md border">
<table className="w-full text-sm">
<thead>
<tr className="border-b bg-muted/50">
<th className="px-4 py-2 text-left font-medium">Date</th>
<th className="px-4 py-2 text-left font-medium">Objet</th>
<th className="px-4 py-2 text-left font-medium">Envoyés</th>
</tr>
</thead>
<tbody>
{logs.map((log) => (
<tr key={log.id} className="border-b last:border-0">
<td className="px-4 py-2 text-muted-foreground">
{new Date(log.sentAt).toLocaleDateString("fr-FR", {
day: "numeric",
month: "short",
year: "numeric",
hour: "2-digit",
minute: "2-digit",
})}
</td>
<td className="px-4 py-2">{log.subject}</td>
<td className="px-4 py-2">
{log.sentCount}/{log.recipientCount}
{log.failedCount > 0 && (
<span className="ml-1 text-destructive">
({log.failedCount} échec
{log.failedCount > 1 ? "s" : ""})
</span>
)}
</td>
</tr>
))}
</tbody>
</table>
</div>
);
}
Modifier src/app/(dashboard)/workspace/[workspaceId]/contributors/page.tsx :
Ajouter les imports :
import { ManualRelanceDialog } from "~/components/workspace/ManualRelanceDialog";
import { RelanceHistory } from "~/components/workspace/RelanceHistory";
Modifier le JSX - remplacer la section actuelle "Liste des contributeurs" par :
<div className="flex items-center justify-between">
<h2 className="font-semibold">Liste des contributeurs</h2>
<ManualRelanceDialog
workspaceId={workspace.id}
workspaceName={workspace.name}
contributorsCount={contributorsCount}
/>
</div>
<ContributorsList workspaceId={workspace.id} />
<div>
<h2 className="mb-3 font-semibold">Historique des relances</h2>
<RelanceHistory workspaceId={workspace.id} />
</div>
Structure résultante de la page :
InviteContributorsFormContributorsList - table des contributeursRelanceHistory| Fichier | Action |
|---|---|
aimpact-hub/prisma/schema.prisma |
Modifier - ajouter modèle ManualRelanceLog + relation Workspace |
aimpact-hub/prisma/migrations/YYYYMMDDHHMMSS_add_manual_relance_log/migration.sql |
Créer - migration auto-générée |
aimpact-hub/src/server/services/email.ts |
Modifier - ajouter SendManualRelanceEmailParams + sendManualRelanceEmail() |
aimpact-hub/src/server/api/routers/contributor.ts |
Modifier - ajouter sendManualRelance mutation + relanceLogs query + import |
aimpact-hub/src/components/workspace/ManualRelanceDialog.tsx |
Créer - dialogue 2 étapes (compose → confirm) |
aimpact-hub/src/components/workspace/RelanceHistory.tsx |
Créer - table historique des relances |
aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/contributors/page.tsx |
Modifier - intégrer ManualRelanceDialog + RelanceHistory |
aimpact-hub/src/server/services/email.test.ts |
Modifier - tests sendManualRelanceEmail |
aimpact-hub/src/components/workspace/ManualRelanceDialog.test.tsx |
Créer - tests composant |
FR11 spécifie "tous les contributeurs du workspace". La relance manuelle est un outil de communication CDO → contributeurs. Le CDO personnalise le message (FR12), donc le contenu peut être pertinent pour tous les contributeurs - pas seulement ceux qui n'ont pas soumis.
Implémentation retenue : envoi à TOUS les contributeurs du workspace, sans filtre de statut. La requête Prisma utilise where: { workspaceId } sans filtre sur status.
contributorRouter existant (pas créer un nouveau router)createWorkspaceProcedure : obligatoire pour toutes les procédures accédant à des données workspacesendManualRelanceEmail (camelCase), ManualRelanceLog (PascalCase Prisma), ManualRelanceDialog (PascalCase composant)src/components/workspace/TRPCError côté tRPC, console.error côté serveur pour logs - jamais d'erreur brute exposée au CDOemail.test.tssubject et body avec min/maxContributor, sendInvitationEmail (pattern email), contributorRouter, createWorkspaceProceduresendSubmissionConfirmationEmail (pattern email à suivre)contributors/page.tsx), ContributorsListlastRemindedAt et autoRelanceEnabled existeront dans le schéma - aucun conflitcreateWorkspaceProcedure assure que seul le propriétaire du workspace peut déclencher la relancesendInvitationEmail → COPIER exactement ce pattern pour sendManualRelanceEmail (même structure, même escaping HTML, même fallback mock en dev)sendSubmissionConfirmationEmail → même structure avec CTA "Soumettre une idée →"ContributorsList.tsx - table avec badges et compteurs → réutiliser ce pattern pour RelanceHistory{ sent, failed, total } → COPIER ce patternResend avec vi.mock("resend", ...) - pattern dans email.test.ts/submit/[workspaceSlug] est ajouté automatiquement en fin d'email - le CDO n'a pas à le saisirVérifier la présence des composants suivants avant de créer ManualRelanceDialog.tsx. Si un composant manque, l'installer avec npx shadcn@latest add [nom] :
| Composant | Import depuis |
|---|---|
Dialog (+ DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, DialogTrigger) |
~/components/ui/dialog |
Button |
~/components/ui/button |
Input |
~/components/ui/input |
Label |
~/components/ui/label |
Textarea |
~/components/ui/textarea |
Toast / useToast |
~/hooks/use-toast ou ~/components/ui/use-toast - vérifier le chemin |
Aucune nouvelle variable requise. Les variables existantes sont suffisantes :
| Variable | Déjà configurée | Utilisée par |
|---|---|---|
RESEND_API_KEY |
Oui (Stories 2.1, 2.7) | sendManualRelanceEmail via getResend() |
EMAIL_FROM |
Oui | Adresse d'envoi (fallback onboarding@resend.dev) |
NEXT_PUBLIC_APP_URL |
Oui | Construction du lien formulaire |
La relance manuelle n'est PAS soumise aux limites du tier Free (pas un appel LLM, pas une soumission d'idée). Aucune vérification checkWorkspaceLimits n'est nécessaire pour cette fonctionnalité.
resend.batch.send)src/components/workspace/ pour les composants workspace, src/server/api/routers/ pour les routers tRPC, src/server/services/ pour les services*.test.ts / *.test.tsx)claude-4.6-sonnet-medium-thinking
Outcome : Approuvé avec corrections appliquées
Issues trouvés et corrigés automatiquement :
| Sévérité | Issue | Fichier | Fix |
|---|---|---|---|
| 🔴 HIGH | Aucune migration SQL pour ManualRelanceLog - db push utilisé, déploiement production cassé |
- | Créé 20260228110000_add_manual_relance_log/migration.sql |
| 🔴 HIGH | AC#1 violé : dialogue ne remet pas subject/body aux valeurs par défaut à la réouverture | ManualRelanceDialog.tsx |
Ajout resetForm() appelé dans handleOpenChange et onSuccess |
| 🟡 MEDIUM | toast.success() même si data.sent === 0 (échec total - toast vert trompeur) |
ManualRelanceDialog.tsx |
toast.error() si data.sent === 0 |
| 🟡 MEDIUM | Mutation utilise input.workspaceId au lieu de ctx.workspace.id (incohérence avec pattern établi) |
contributor.ts |
Remplacé par workspace.id dans findMany et create |
| 🟡 MEDIUM | RelanceHistory sans état d'erreur - affiche "Aucune relance" si la query échoue |
RelanceHistory.tsx |
Ajout bloc isError avec message d'erreur |
Issues LOW documentés (non corrigés, non bloquants) :
title uniquement (accessibilité)relanceLogsprisma db push (drift existant). Migration SQL créée manuellement dans 20260228110000_add_manual_relance_log/migration.sql. ⚠️ Sur le DB dev existant, marquer la migration comme déjà appliquée : npx prisma migrate resolve --applied 20260228110000_add_manual_relance_log.