Status: done
En tant que Transformateur, je veux inviter des contributeurs par email avec un lien vers le formulaire, afin qu'ils puissent soumettre des idées.
Given j'ai un workspace configuré When je saisis des emails et envoie les invitations Then chaque contributeur reçoit un email avec un lien direct vers le formulaire de soumission (incluant workspaceSlug) And les contributeurs invités sont listés dans le workspace
Given mon workspace est en tier Free When le nombre de contributeurs atteint ou dépasse 5 (FR4) Then l'invitation est bloquée avec un message explicite indiquant la limite du tier Free And un lien vers la mise à niveau est suggéré (optionnel en MVP - simple message suffit)
Given j'invite un email déjà invité pour ce workspace When j'envoie l'invitation Then le système détecte le doublon et affiche un message approprié (pas de double envoi) And l'email existant reste listé avec son statut actuel
Given j'ai envoyé des invitations When je consulte la page contributeurs du workspace Then je vois la liste des contributeurs invités avec leur email et leur statut (invité / a soumis / n'a rien soumis) And le statut "invité" est le défaut pour les contributeurs n'ayant pas encore soumis d'idée
[x] Task 1 : Modèle de données Contributor (AC: #1, #3, #4)
Contributor dans prisma/schema.prisma : id, workspaceId, email, status (enum: INVITED, SUBMITTED, NOT_SUBMITTED), invitedAt, createdAtcontributors Contributor[] sur modèle Workspace ; index @@unique([workspaceId, email]) sur Contributor pour éviter doublonsprisma migrate dev --name add-contributor-model (db push utilisé)[x] Task 2 : Service email et envoi d'invitations (AC: #1)
src/server/services/email.ts - fonction sendInvitationEmail(contributor, workspace) avec lien {baseUrl}/submit/{workspace.slug}resend npm) ; variables RESEND_API_KEY, EMAIL_FROM dans .env.example[x] Task 3 : Router tRPC contributor (AC: #1, #2, #3, #4)
src/server/api/routers/contributor.ts avec createWorkspaceProcedureinvite : input { workspaceId, emails: string[] } - valider format email (Zod), vérifier limite tier (5), créer Contributor, envoyer emaillist : retourner contributeurs du workspace avec statutcontributorRouter dans root.ts[x] Task 4 : UI invitation et liste contributeurs (AC: #1, #2, #3, #4)
src/app/(dashboard)/workspace/[workspaceId]/contributors/page.tsx - formulaire invitation (champ emails, bouton Envoyer) + liste contributeursInviteContributorsForm - Input ou Textarea pour saisir emails (séparés par virgule ou ligne), validation côté client, appel contributor.inviteContributorsList - Table ou liste avec colonnes email, statut (Badge), date invitation[x] Task 5 : Tests (AC: #1, #2, #3)
contributor.invite - validation logic (succès, limite, doublon, format email)InviteContributorsForm - rendu formulairesrc/lib/tier.ts expose FREE_TIER_LIMITS.maxContributors = 5. Utiliser isAtContributorLimit(contributorsCount) ou vérifier contributorsCount >= 5 avant d'accepter une nouvelle invitation.Contributor. Le modèle Idea n'existe pas encore - le statut "a soumis" sera mis à jour dans Story 2.2 (formulaire soumission). Pour cette story, tous les contributeurs créés ont statut INVITED ou NOT_SUBMITTED (équivalent fonctionnel jusqu'à Story 2.2).{NEXT_PUBLIC_APP_URL}/submit/{workspace.slug}. Variable NEXT_PUBLIC_APP_URL ou VERCEL_URL pour l'environnement.invite_contributors existe. Ajouter un lien vers /workspace/[workspaceId]/contributors pour que le Transformateur puisse accomplir cette étape.| Statut | Signification |
|---|---|
| INVITED | Invitation envoyée, pas encore de soumission (défaut à la création) |
| SUBMITTED | Au moins une idée soumise (mis à jour en Story 2.2) |
| NOT_SUBMITTED | Relance J+21 envoyée sans soumission (Story 2.10) |
Pour Story 2.1 : tous les contributeurs sont INVITED. Story 2.2 mettra à jour en SUBMITTED quand une idée est soumise avec cet email.
enum ContributorStatus {
INVITED
SUBMITTED
NOT_SUBMITTED
}
model Contributor {
id String @id @default(cuid())
workspaceId String
workspace Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
email String
status ContributorStatus @default(INVITED)
invitedAt DateTime @default(now())
createdAt DateTime @default(now())
@@unique([workspaceId, email])
@@index([workspaceId])
}
// Sur Workspace, ajouter :
// contributors Contributor[]
// src/server/services/email.ts
export async function sendInvitationEmail(params: {
email: string;
workspaceSlug: string;
workspaceName: string;
}): Promise<void> {
const baseUrl = process.env.NEXT_PUBLIC_APP_URL ?? process.env.VERCEL_URL ?? 'http://localhost:3000';
const submitUrl = `${baseUrl}/submit/${params.workspaceSlug}`;
// Resend: resend.emails.send({ from, to, subject, html })
}
createWorkspaceProcedure. Filtrer par workspaceId sur toutes les requêtes Contributor.Workspace.slug pour URLs contributeur - déjà en place.npm install resend - API simple, compatible EU. Alternative : SendGrid, Postmark.emails: z.array(z.string().email()).min(1).max(10) - limiter le nombre d'invitations par batch (éviter spam).| Fichier | Action |
|---|---|
prisma/schema.prisma |
Modifier - ajouter enum ContributorStatus, modèle Contributor, relation Workspace |
prisma/migrations/ |
Créer via prisma migrate dev |
src/server/services/email.ts |
Créer - sendInvitationEmail |
src/server/api/routers/contributor.ts |
Créer - invite, list |
src/server/api/root.ts |
Modifier - ajouter contributor: contributorRouter |
src/app/(dashboard)/workspace/[workspaceId]/contributors/page.tsx |
Créer |
src/components/workspace/InviteContributorsForm.tsx |
Créer |
src/components/workspace/ContributorsList.tsx |
Créer |
.env.example |
Modifier - ajouter RESEND_API_KEY, EMAIL_FROM, NEXT_PUBLIC_APP_URL |
contributor.invite : succès avec 1 email, blocage à 6e contributeur (tier Free), rejet doublon, validation email invalideworkspaceSlugInviteContributorsForm - rendu, validation, appel mutationworkspace.ts. Réutiliser pour contributorRouter.FREE_TIER_LIMITS.maxContributors = 5. Ajouter isAtContributorLimit(contributorsCount: number) si absent, ou vérifier contributorsCount >= FREE_TIER_LIMITS.maxContributors avant invite.invite_contributors - ajouter lien vers page contributeurs. Pattern : router.push ou Link vers /workspace/[id]/contributors.contributorsCount. S'assurer que le modèle Contributor est bien compté (relation workspace.contributors).{{agent_model_name_version}}
Date: 2026-02-27
Outcome: Changes Requested → Fixes applied
Action Items (résolus):
Action Items (à faire manuellement):
20260226000000_init_schema (Contributor créé avec Workspace)Findings non bloquants (LOW):