Status: done
En tant que système, je veux envoyer une relance automatique aux contributeurs sans soumission 21 jours après leur invitation, afin de les inciter à contribuer.
Given un contributeur a été invité il y a 21 jours ou plus et n'a soumis aucune idée (statut INVITED)
When le cron Vercel s'exécute via GET /api/cron/relance
Then une relance email est envoyée au contributeur (une seule occurrence, ton neutre, lien direct vers /submit/[workspaceSlug])
And le champ lastRemindedAt du contributeur est mis à jour avec la date d'envoi
And le statut du contributeur passe de INVITED à NOT_SUBMITTED
Given un contributeur a déjà reçu une relance (lastRemindedAt non null)
When le cron s'exécute à nouveau
Then aucune relance n'est envoyée (idempotent - une seule relance automatique par contributeur)
Given un contributeur a soumis une idée (statut SUBMITTED)
When le cron s'exécute
Then aucune relance n'est envoyée à ce contributeur
Given le Transformateur a désactivé la relance automatique dans les paramètres du workspace (autoRelanceEnabled = false)
When le cron s'exécute
Then aucune relance n'est envoyée pour les contributeurs de ce workspace
Given le cron endpoint est appelé sans le header Authorization: Bearer CRON_SECRET valide
When la requête HTTP arrive sur /api/cron/relance
Then une réponse 401 Unauthorized est retournée
Given le cron s'exécute et relance N contributeurs
When les relances sont envoyées
Then le log de chaque relance est visible dans le workspace (date d'envoi par contributeur via lastRemindedAt)
And le endpoint retourne un résumé JSON { sent, failed, total }
[x] Task 1 : Migration Prisma - champs relance (AC: #1, #4, #6)
lastRemindedAt DateTime? au modèle ContributorautoRelanceEnabled Boolean @default(true) au modèle Workspacenpx prisma migrate dev --name add_relance_fields[x] Task 2 : Service email - sendRelanceEmail() (AC: #1)
sendRelanceEmail dans src/server/services/email.ts (même pattern que sendInvitationEmail)[x] Task 3 : Route handler cron - src/app/api/cron/relance/route.ts (AC: #1, #2, #3, #4, #5, #6)
src/app/api/cron/relance/route.ts avec handler GETCRON_SECRET via header Authorization: Bearer ...status = INVITED, invitedAt <= J-21, lastRemindedAt IS NULL, workspace.autoRelanceEnabled = true)lastRemindedAt et status = NOT_SUBMITTED{ sent, failed, total }[x] Task 4 : Configuration Vercel Cron (AC: #1)
vercel.json à la racine du projet aimpact-hub/ avec schedule quotidienCRON_SECRET dans src/env.js (optionnel, Zod)CRON_SECRET dans .env.example[x] Task 5 : Toggle workspace - désactivation relance automatique (AC: #4)
workspaceUpdateInputSchema dans workspace.schema.ts : ajouter autoRelanceEnabled: z.boolean().optional()workspace.update dans workspace.ts pour persister autoRelanceEnabled[x] Task 6 : Tests (AC: #1, #2, #3, #4, #5)
sendRelanceEmail dans email.test.ts (même pattern que tests existants)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()workspaceNameEMAIL_FROM : process.env.EMAIL_FROM ?? "onboarding@resend.dev"contributor.ts (router) - déjà fonctionnel :
invite : crée le contributeur, envoie l'email, vérifie limites tierlist : db.contributor.findMany({ where: { workspaceId }, orderBy: { invitedAt: "desc" } })createWorkspaceProcedure pour l'auth workspaceidea.ts (router, ligne ~74) - transition INVITED → SUBMITTED déjà implémentée :
if (contributor && contributor.status === "INVITED") {
await tx.contributor.update({
where: { id: contributor.id },
data: { status: "SUBMITTED" },
});
}
Aucune modification à idea.ts pour cette story.
Schéma Prisma actuel - Contributor :
id, workspaceId, email, status (enum INVITED/SUBMITTED/NOT_SUBMITTED), invitedAt, createdAt, ideas[]@@unique([workspaceId, email])lastRemindedAt (à ajouter)Schéma Prisma actuel - Workspace :
id, name, slug, sector, companySize, contactEmail, tier, llmCallsThisMonth, llmCallsResetAt, ownerId, contributors[], ideas[]autoRelanceEnabled (à ajouter)Page Settings (settings/page.tsx) - existe :
WorkspaceSettingsForm (secteur, taille), SubscriptionStatus, EmailInboxSectionworkspace.schema.ts - schéma update actuel :
workspaceId, sector (optional), companySize (optional)autoRelanceEnabledenv.js - validation variables d'environnement :
@t3-oss/env-nextjs avec Zodz.string().optional()CRON_SECRETModèle Contributor - ajouter :
model Contributor {
// ... champs existants ...
lastRemindedAt DateTime? // Story 2.10 : date de la relance J+21 (null = jamais relancé)
// ... reste identique ...
}
Modèle Workspace - ajouter :
model Workspace {
// ... champs existants ...
autoRelanceEnabled Boolean @default(true) // Story 2.10 : désactivable par le Transformateur
// ... reste identique ...
}
Commande migration :
cd aimpact-hub
npx prisma migrate dev --name add_relance_fields
sendRelanceEmail()Ajouter dans src/server/services/email.ts - MÊME pattern que sendInvitationEmail :
export interface SendRelanceEmailParams {
email: string;
workspaceSlug: string;
workspaceName: string;
}
export async function sendRelanceEmail(
params: SendRelanceEmailParams
): 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 subject = `Rappel : partagez vos idées - ${params.workspaceName}`;
const html = `
<p>Bonjour,</p>
<p>Il y a quelques semaines, vous avez été invité(e) à partager vos idées pour la transformation de <strong>${escapedName}</strong>.</p>
<p>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 :</p>
<p><a href="${submitUrl}">Soumettre une idée →</a></p>
<p>2 minutes suffisent pour décrire un problème ou une opportunité.</p>
<p>- L'équipe ${escapedName}</p>
`;
const resend = getResend();
if (!resend) {
console.log("[email] Relance (mock):", {
to: params.email,
subject,
submitUrl,
});
return;
}
const { error } = await resend.emails.send({ from, to: params.email, subject, html });
if (error) {
throw new Error(`Échec envoi relance: ${error.message}`);
}
}
Ton de l'email : neutre, non-intrusif, valorisant la contribution (UX spec J2b : « jamais de harcèlement »).
Créer src/app/api/cron/relance/route.ts :
import { type NextRequest, NextResponse } from "next/server";
import { db } from "~/server/db";
import { sendRelanceEmail } from "~/server/services/email";
export async function GET(req: NextRequest) {
const authHeader = req.headers.get("authorization");
if (authHeader !== `Bearer ${process.env.CRON_SECRET}`) {
return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
}
const twentyOneDaysAgo = new Date();
twentyOneDaysAgo.setDate(twentyOneDaysAgo.getDate() - 21);
const contributors = await db.contributor.findMany({
where: {
status: "INVITED",
invitedAt: { lte: twentyOneDaysAgo },
lastRemindedAt: null,
workspace: { autoRelanceEnabled: true },
},
include: {
workspace: { select: { slug: true, name: true } },
},
});
let sent = 0;
let failed = 0;
for (const contributor of contributors) {
try {
await sendRelanceEmail({
email: contributor.email,
workspaceSlug: contributor.workspace.slug,
workspaceName: contributor.workspace.name,
});
await db.contributor.update({
where: { id: contributor.id },
data: {
lastRemindedAt: new Date(),
status: "NOT_SUBMITTED",
},
});
sent++;
} catch (error) {
console.error(`[cron/relance] Échec pour ${contributor.email}:`, error);
failed++;
}
}
return NextResponse.json({ sent, failed, total: contributors.length });
}
Points critiques :
try/catch individuel évite qu'un échec d'envoi bloque les autreslastRemindedAt ET status = NOT_SUBMITTED sont mis à jour ensemble après envoi réussiworkspace.autoRelanceEnabled pour respecter AC #4lastRemindedAt: null garantit l'idempotence (AC #2)Créer aimpact-hub/vercel.json :
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"crons": [
{
"path": "/api/cron/relance",
"schedule": "0 9 * * *"
}
]
}
CRON_SECRET dans le header Authorization: Bearer ...Ajouter dans src/env.js section server :
CRON_SECRET: z.string().optional(),
Ajouter dans runtimeEnv :
CRON_SECRET: process.env.CRON_SECRET,
Ajouter dans .env.example :
# Story 2.10 : Cron relance J+21 (Vercel Cron)
# Générer avec : openssl rand -hex 32
# Configuré automatiquement par Vercel en production
CRON_SECRET=""
workspace.schema.ts - étendre :
export const workspaceUpdateInputSchema = z.object({
workspaceId: z.string().cuid(),
sector: sectorSchema.optional().nullable(),
companySize: z.number().int().positive().max(10000).optional().nullable(),
autoRelanceEnabled: z.boolean().optional(), // Story 2.10
});
workspace.ts router - étendre update :
Ajouter dans l'objet data du db.workspace.update :
...(input.autoRelanceEnabled !== undefined && {
autoRelanceEnabled: input.autoRelanceEnabled,
}),
Composant toggle - à ajouter dans la page Settings :
Créer un composant AutoRelanceToggle (ou l'intégrer dans WorkspaceSettingsForm) :
Switch + Labelworkspace.update avec { workspaceId, autoRelanceEnabled }autoRelanceEnabled au fetch dans settings/page.tsx)| Fichier | Action |
|---|---|
aimpact-hub/prisma/schema.prisma |
Modifier - ajouter lastRemindedAt sur Contributor, autoRelanceEnabled sur Workspace |
aimpact-hub/prisma/migrations/YYYYMMDDHHMMSS_add_relance_fields/migration.sql |
Créer - migration auto-générée |
aimpact-hub/src/server/services/email.ts |
Modifier - ajouter sendRelanceEmail() |
aimpact-hub/src/app/api/cron/relance/route.ts |
Créer - handler cron GET |
aimpact-hub/vercel.json |
Créer - config cron Vercel |
aimpact-hub/src/env.js |
Modifier - ajouter CRON_SECRET |
aimpact-hub/.env.example |
Modifier - ajouter CRON_SECRET |
aimpact-hub/src/server/api/routers/workspace.schema.ts |
Modifier - ajouter autoRelanceEnabled |
aimpact-hub/src/server/api/routers/workspace.ts |
Modifier - étendre update |
aimpact-hub/src/app/(dashboard)/workspace/[workspaceId]/settings/page.tsx |
Modifier - passer autoRelanceEnabled au composant |
aimpact-hub/src/components/workspace/AutoRelanceToggle.tsx |
Créer - toggle switch |
aimpact-hub/src/server/services/email.test.ts |
Modifier - ajouter tests sendRelanceEmail |
aimpact-hub/src/app/api/cron/relance/route.test.ts |
Créer - tests handler cron |
NOT_SUBMITTEDINVITED → NOT_SUBMITTED se fait UNIQUEMENT lors de l'envoi de la relance J+21 (cette story)ContributorsList.tsx affiche un badge ambre)NOT_SUBMITTED qui soumet une idée passera à SUBMITTED (déjà géré par idea.submit dans idea.ts - vérifier que la condition couvre aussi NOT_SUBMITTED, pas seulement INVITED)ATTENTION - Vérification critique dans idea.ts :
La condition existante est if (contributor && contributor.status === "INVITED"). Elle ne couvre PAS NOT_SUBMITTED. Il faut étendre cette condition :
if (contributor && (contributor.status === "INVITED" || contributor.status === "NOT_SUBMITTED")) {
await tx.contributor.update({
where: { id: contributor.id },
data: { status: "SUBMITTED" },
});
}
Ajouter cette modification dans Task 3 ou comme sous-tâche dédiée.
src/app/api/cron/relance/route.ts - aligné avec l'arborescence architecturesendRelanceEmail (camelCase), autoRelanceEnabled (camelCase Prisma)workspace.autoRelanceEnabled - pas besoin de workspaceId explicite car on itère sur tous les workspacesconsole.error) - jamais d'erreur brute exposéeCRON_SECRET vérifié en premier (fail-fast)GET /api/cron/relance avec un header Authorization: Bearer <test-secret>| Variable | Requise | Description |
|---|---|---|
CRON_SECRET |
Optionnel (obligatoire en prod) | Secret pour sécuriser le cron endpoint. Généré avec openssl rand -hex 32. Configuré automatiquement par Vercel. |
Aucune autre nouvelle variable requise - RESEND_API_KEY et EMAIL_FROM sont déjà configurés.
Contributor, sendInvitationEmail (pattern email), contributorRoutersendSubmissionConfirmationEmail (pattern à suivre)NOT_SUBMITTED dans ContributorsList.tsx (badge ambre)sendManualRelanceEmail et un bouton CDO - la relance auto ne bloque pasidea.ts : étendre la condition INVITED → inclure NOT_SUBMITTED pour la transition vers SUBMITTEDworkspace.autoRelanceEnabledsendInvitationEmail - COPIER exactement ce pattern pour sendRelanceEmail (même structure, même escaping HTML, même fallback mock en dev)sendSubmissionConfirmationEmail - même structure, CTA avec lien direct formulaireNOT_SUBMITTED est déjà géré dans ContributorsList.tsx - pas de modification nécessaire côté affichageworkspace.update pour persister les champs - étendre pour autoRelanceEnabledResend avec vi.mock("resend", ...) - pattern dans email.test.tsz.string().optional() - suivre pour CRON_SECRET/submit/[workspaceSlug]lastRemindedAt affiché dans la liste contributeurs (déjà géré par la colonne date dans ContributorsList.tsx - ajouter l'info "Relancé le..." si pertinent){{agent_model_name_version}}
lastRemindedAt (Contributor), autoRelanceEnabled (Workspace) - db push appliquésendRelanceEmail : pattern Resend identique à sendInvitationEmail, ton neutre/api/cron/relance : GET, CRON_SECRET Bearer, filtre J-21 + INVITED + lastRemindedAt null + autoRelanceEnabledidea.ts et webhook emailAutoRelanceToggle dans page Settings avec shadcn SwitchManualRelanceLog (schema.prisma) et procédures sendManualRelance/relanceLogs (contributor.ts) implémentés en avance pour réduire la friction sprint suivantlastRemindedAt + autoRelanceEnabled + ManualRelanceLog pré-implémenté pour Story 2.11)sendManualRelance + relanceLogs pré-implémentés pour Story 2.11 [scope anticipé])