Status: done
En tant que Contributeur, je veux soumettre une idée via un formulaire en langage métier (4 champs de base), afin de partager mon idée sans créer de compte.
Given j'ai reçu un lien d'invitation ou j'accède directement à /submit/[workspaceSlug]
When la page se charge
Then le formulaire est affiché (fond crème Livinia #fefdfb, bouton primaire violet #7c3aed)
And le workspace est identifié via le workspaceSlug dans l'URL
And si le workspaceSlug est invalide, une page 404 est affichée
Given je suis sur le formulaire de soumission
When je remplis les 4 champs (description du problème, département, impact estimé, fréquence) et saisis mon email
Then l'idée est créée en base liée au workspace
And le statut de l'idée est SUBMITTED (Envoyé)
And une confirmation visuelle s'affiche en moins de 1 seconde (NFR2)
Given je soumets avec un email qui correspond à une invitation existante dans ce workspace
When l'idée est créée
Then l'idée est associée au Contributor existant (via contributorId)
And le statut du Contributor est mis à jour en SUBMITTED (s'il était INVITED)
Given je soumets avec un email qui n'a pas d'invitation dans ce workspace
When l'idée est créée
Then l'idée est créée avec contributorId = null et contributorEmail stocké
And aucun Contributor n'est créé automatiquement
Given je remplis le formulaire de manière incomplète (champ obligatoire manquant) When je tente de soumettre Then les erreurs de validation s'affichent inline sous le champ concerné (pas de modale) And les messages sont en langage simple et accessible (ex. "Décrivez votre problème en au moins 10 caractères")
Given le formulaire est sur mobile (< 768px) When je consulte la page Then le formulaire est affiché en colonne unique, les touch targets sont ≥ 44×44px And le formulaire reste utilisable et soumettable
[x] Task 1 : Schéma Prisma — modèle Idea (AC: #2, #3, #4)
IdeaStatus (SUBMITTED, IN_REVIEW, ON_AGENDA, IN_PROGRESS, NOT_PRIORITY) dans prisma/schema.prismaImpactLevel (FAIBLE, MODERE, ELEVE, CRITIQUE) et enum Frequency (QUOTIDIENNE, HEBDOMADAIRE, MENSUELLE, TRIMESTRIELLE, PONCTUELLE)Idea (voir Dev Notes § Schéma Prisma ci-dessous) avec toutes les colonnes Story 2.2 + colonnes LLM null pour Stories 3.xideas Idea[] sur Workspace et relation optionnelle ideas Idea[] sur Contributorprisma migrate dev --name add-idea-modelgetTierInfo dans workspace.ts — remplacer ideasCount = 0 par une vraie query ctx.db.idea.count({ where: { workspaceId: ctx.workspace.id } })[x] Task 2 : Router tRPC idea — procédure publique submit (AC: #2, #3, #4, #5)
src/server/api/routers/idea.ts avec createTRPCRouter et publicProceduresubmit : input IdeaSubmitInput (voir Dev Notes § Schéma Zod) — chercher workspace par workspaceSlug ; si absent → TRPCError NOT_FOUNDdb.contributor.findUnique({ where: { workspaceId_email: { workspaceId, email } } }) — si trouvé, associer via contributorId et mettre à jour statut SUBMITTEDideaRouter dans src/server/api/root.ts[x] Task 3 : Route et page publique /submit/[workspaceSlug] (AC: #1, #6)
src/app/(public)/ avec layout.tsx minimal (pas de nav CDO, fond crème #fefdfb, pas d'authentification requise)src/app/(public)/submit/[workspaceSlug]/page.tsx — Server Component qui récupère le workspace par slug (Prisma direct), passe workspaceName, workspaceSlug, workspaceId au composant formulairenotFound() de Next.js[x] Task 4 : Composants formulaire (AC: #2, #5, #6)
src/components/form/IdeaSubmissionForm.tsx — Client Component avec React Hook Form ou état local ; les 4 champs + emailsrc/components/form/DepartmentPicker.tsx — boutons pill RH, Finance, Supply Chain, Commercial, Direction, Autre ; sélection unique déclenchant mise à jour du champ departmentsrc/components/form/SubmissionConfirmation.tsx — écran de confirmation affiché après soumission (< 1s, AC NFR2) : message de succès, CTA "Soumettre une autre idée" (reset du formulaire), lien vers le formulaire (pas de redirection)isPending du bouton Soumettre (désactivé + spinner inline pendant l'envoi, voir UX § Micro-interactions)[x] Task 5 : Tests (AC: #2, #3, #4, #5)
idea.submit — succès sans contributeur invité, succès avec contributeur invité (statut mis à jour), workspace slug invalide (404), champs manquants (validation Zod)IdeaSubmissionForm — rendu, remplissage champs, soumission, affichage erreurs inlineDepartmentPicker — sélection single, changement de sélectionContributor est déjà dans prisma/schema.prisma avec les champs id, workspaceId, email, status (INVITED/SUBMITTED/NOT_SUBMITTED), invitedAt, createdAt et un @@unique([workspaceId, email]). Cette story doit ajouter la relation ideas Idea[] sur Contributor (sans casser Story 2.1).email.ts (créé dans Story 2.1) : si le fichier n'est pas encore créé lors du dev de Story 2.2, l'envoi de confirmation email (Story 2.7) est hors scope ici. Story 2.2 ne dépend pas de l'envoi d'email.contributor.ts router (créé dans Story 2.1) : si absent, Story 2.2 ne dépend pas de ce router — la logique de matching contributeur est dans idea.submit (accès DB direct).FREE_TIER_LIMITS dans src/lib/tier.ts : maxIdeasWithLlm = 30. Story 2.2 ne bloque pas la soumission si la limite est atteinte (NFR11) — les idées sont créées sans enrichissement LLM au-delà. Ne pas bloquer la création d'idée ici.createWorkspaceProcedure : procédure protégée (auth requise). NE PAS utiliser pour la procédure publique idea.submit. Utiliser publicProcedure et chercher le workspace par workspaceSlug.@unique dans le schéma. Utiliser db.workspace.findUnique({ where: { slug: workspaceSlug } }).getTierInfo dans workspace.ts : contient const ideasCount = 0 (placeholder). À mettre à jour après ajout du modèle Idea.Idea// À ajouter dans prisma/schema.prisma
enum IdeaStatus {
SUBMITTED // Envoyé (statut initial)
IN_REVIEW // En traitement
ON_AGENDA // Mis à l'ordre du jour
IN_PROGRESS // En cours
NOT_PRIORITY // Non prioritaire (filtrable, non supprimé — FR26)
}
enum ImpactLevel {
FAIBLE
MODERE
ELEVE
CRITIQUE
}
enum Frequency {
QUOTIDIENNE
HEBDOMADAIRE
MENSUELLE
TRIMESTRIELLE
PONCTUELLE
}
model Idea {
id String @id @default(cuid())
workspaceId String
workspace Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
// Données contributeur
contributorEmail String
contributorId String?
contributor Contributor? @relation(fields: [contributorId], references: [id], onDelete: SetNull)
// Champs formulaire FR14
department String
problemDescription String @db.Text
estimatedImpact ImpactLevel
frequency Frequency
// Statut
status IdeaStatus @default(SUBMITTED)
// Enrichissement LLM — rempli par Story 3.1 (api/llm/enrich)
llmTitle String?
llmDomain String?
llmAiType String?
llmExplanation String? @db.Text
llmScoreImpact Int? // 1–5, NFR18
llmScoreFeasibility Int? // 1–5
llmScoreUrgency Int? // 1–5
llmEnrichedAt DateTime?
llmEnrichFailed Boolean @default(false) // FR21 : fallback "À qualifier manuellement"
// Scores manuels (Story 3.4, FR20 — overrides LLM)
manualScoreImpact Int?
manualScoreFeasibility Int?
manualScoreUrgency Int?
// Ordre priorisation (Story 4.3, FR33)
priorityOrder Int?
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
@@index([workspaceId, createdAt])
@@index([workspaceId, status])
@@index([workspaceId, contributorEmail])
}
// Sur Workspace, ajouter :
// ideas Idea[]
// Sur Contributor, ajouter :
// ideas Idea[]
idea.submit// src/server/api/routers/idea.ts
import { z } from "zod";
export const IdeaSubmitInputSchema = z.object({
workspaceSlug: z.string().min(1),
contributorEmail: z.string().email("Email invalide"),
department: z.string().min(1, "Sélectionnez votre département"),
problemDescription: z.string().min(10, "Décrivez votre problème en au moins 10 caractères").max(2000),
estimatedImpact: z.enum(["FAIBLE", "MODERE", "ELEVE", "CRITIQUE"]),
frequency: z.enum(["QUOTIDIENNE", "HEBDOMADAIRE", "MENSUELLE", "TRIMESTRIELLE", "PONCTUELLE"]),
});
idea.submit — avec transaction// src/server/api/routers/idea.ts
import { createTRPCRouter, publicProcedure } from "~/server/api/trpc";
import { TRPCError } from "@trpc/server";
import { IdeaSubmitInputSchema } from "./idea"; // ou schéma inline
export const ideaRouter = createTRPCRouter({
submit: publicProcedure
.input(IdeaSubmitInputSchema)
.mutation(async ({ ctx, input }) => {
// 1. Chercher workspace par slug
const workspace = await ctx.db.workspace.findUnique({
where: { slug: input.workspaceSlug },
});
if (!workspace) {
throw new TRPCError({ code: "NOT_FOUND", message: "Workspace non trouvé" });
}
// 2. Matching contributeur
const contributor = await ctx.db.contributor.findUnique({
where: {
workspaceId_email: {
workspaceId: workspace.id,
email: input.contributorEmail,
},
},
});
// 3. Transaction : créer l'idée + mettre à jour statut si matching
const idea = await ctx.db.$transaction(async (tx) => {
const newIdea = await tx.idea.create({
data: {
workspaceId: workspace.id,
contributorEmail: input.contributorEmail,
contributorId: contributor?.id ?? null,
department: input.department,
problemDescription: input.problemDescription,
estimatedImpact: input.estimatedImpact,
frequency: input.frequency,
},
});
// Mettre à jour statut contributeur si INVITED → SUBMITTED
if (contributor && contributor.status === "INVITED") {
await tx.contributor.update({
where: { id: contributor.id },
data: { status: "SUBMITTED" },
});
}
return newIdea;
});
return { ideaId: idea.id };
}),
});
/submit/[workspaceSlug]// src/app/(public)/submit/[workspaceSlug]/page.tsx
import { notFound } from "next/navigation";
import { db } from "~/server/db";
import IdeaSubmissionForm from "~/components/form/IdeaSubmissionForm";
interface Props {
params: Promise<{ workspaceSlug: string }>;
}
export default async function SubmitPage({ params }: Props) {
const { workspaceSlug } = await params;
const workspace = await db.workspace.findUnique({
where: { slug: workspaceSlug },
select: { id: true, name: true, slug: true },
});
if (!workspace) notFound();
return (
<IdeaSubmissionForm
workspaceName={workspace.name}
workspaceSlug={workspace.slug}
/>
);
}
workspaceId. La procédure submit cherche le workspace par slug (public), jamais sans isolation workspace.createWorkspaceProcedure ici : la route est publique (pas d'auth NextAuth). Utiliser publicProcedure.workspaceId est toujours résolu côté serveur à partir du workspaceSlug. Le client ne passe jamais de workspaceId directement (protection IDOR).ideasCount >= 30. Créer l'idée sans LLM au-delà — vérification isAtIdeaLimit() uniquement dans api/llm/enrich (Story 3.1).@db.Text : utiliser pour problemDescription et llmExplanation (textes longs potentiels).| Bibliothèque | Usage | Note |
|---|---|---|
@trpc/server, zod |
Validation input + procédure publique | Déjà installés (T3) |
@tanstack/react-query (via tRPC) |
Mutation côté client | Déjà configuré |
shadcn/ui : Button, Input, Textarea, Select, Label, Badge, Skeleton |
Composants formulaire | Déjà installés |
react-hook-form ou useState |
Gestion état formulaire | Pas de dépendance supplémentaire si useState ; préférer useState pour MVP simple |
lucide-react |
Icônes (Check, Loader2 pour spinner) | Déjà disponible via shadcn/ui |
| Fichier | Action |
|---|---|
prisma/schema.prisma |
Modifier — ajouter enums IdeaStatus, ImpactLevel, Frequency ; modèle Idea ; relations Workspace + Contributor |
prisma/migrations/ |
Créer via prisma migrate dev --name add-idea-model |
src/server/api/routers/idea.ts |
Créer — procédure submit publique |
src/server/api/root.ts |
Modifier — ajouter idea: ideaRouter |
src/server/api/routers/workspace.ts |
Modifier — mettre à jour getTierInfo : ideasCount réel |
src/app/(public)/layout.tsx |
Créer — layout public (fond crème, sans nav CDO) |
src/app/(public)/submit/[workspaceSlug]/page.tsx |
Créer — Server Component, lookup workspace, notFound() |
src/components/form/IdeaSubmissionForm.tsx |
Créer — formulaire complet Client Component |
src/components/form/DepartmentPicker.tsx |
Créer — boutons pill département |
src/components/form/SubmissionConfirmation.tsx |
Créer — écran succès post-soumission |
@testing-library/react (configuré en Story 1.5 — fichier vitest.config.ts existant)idea.submit (caller tRPC côté serveur) :
Contributor passé de INVITED → SUBMITTEDIdeaSubmissionForm : rendu, validation on-blur, appel mutation, affichage spinner, affichage SubmissionConfirmation après succèsDepartmentPicker : sélection unique, changement de sélection, aria-pressedLayout 2 colonnes Desktop (lg: ≥ 1024px) :
DepartmentPicker (src/components/form/DepartmentPicker.tsx) :
rounded-full px-4 py-2 text-sm, sélectionné → fond #ede9fe bordure #c4b5fd texte #5b21b6department dans le formulairerole="group", aria-label="Sélectionnez votre fonction" (WCAG 2.1 AA)scale(1.04) 120ms bounce sur le pill sélectionnéChamps formulaire (libellés en langage métier pur — jamais de jargon IA) :
| Champ | Libellé affiché | Type | Placeholder |
|---|---|---|---|
| contributorEmail | "Votre email (pour le suivi)" | Input type=email | "prenom@entreprise.com" |
| department | "Votre fonction" | DepartmentPicker | — |
| problemDescription | "Décrivez le problème ou la situation" | Textarea | "Ex : chaque semaine, je passe 4h à compiler des données de différentes sources…" |
| estimatedImpact | "Impact estimé si ce problème était résolu" | Select | "Choisissez…" |
| frequency | "À quelle fréquence rencontrez-vous ce problème ?" | Select | "Choisissez…" |
Options Select estimatedImpact : Faible (quelques heures/an) | Modéré (quelques jours/mois) | Élevé (plusieurs jours/semaine) | Critique (bloque le quotidien)
Options Select frequency : Tous les jours | Chaque semaine | Chaque mois | Chaque trimestre | Occasionnellement
Bouton Soumettre :
#7c3aed, texte blanc, radius 10px — "Soumettre mon idée"Loader2 inline (animate-spin h-4 w-4 mr-2)Validation inline (on blur) :
#dc2626SubmissionConfirmation (AC NFR2 < 1s) :
#dcfce7, icône CheckCircle vert, texte #166534Pas de mention RGPD dans cette story — couverte par Story 2.8.
Layout public (src/app/(public)/layout.tsx) :
#fefdfb (crème Livinia)max-w-2xl mx-auto px-4 py-8 (formulaire seul) ou max-w-4xl (avec panneau exemples à droite en Story 2.3)SUBMITTED lors de la soumission. Statut NOT_SUBMITTED est réservé à la relance J+21 (Story 2.10).@@unique([workspaceId, email]) sur Contributor → utiliser findUnique({ where: { workspaceId_email: { ... } } }) pour le matching.sendSubmissionConfirmationEmail). Ne pas créer de dépendance ici.params en Server Components : dans Next.js 15+, params est un objet Promise — utiliser const { workspaceSlug } = await params (voir exemple page.tsx ci-dessus).~/server/db depuis le Server Component pour la lookup workspace (pas besoin de passer par tRPC côté serveur).api.idea.submit.useMutation() dans IdeaSubmissionForm.tsx (Client Component).publicProcedure vs protectedProcedure : les procédures publiques n'appellent pas auth() et sont accessibles sans cookie de session.(public)/submit/, components/form/IdeaSubmissionForm.tsx](public)/submit/* sans auth]publicProcedure]DepartmentPicker, ExamplePill, SubmissionConfirmation]claude-4.6-sonnet-medium-thinking (Cursor)
ideaSubmitInputSchema: extrait dans idea.schema.ts (import next-auth transitif évité)IdeaStatus, ImpactLevel, Frequency + modèle Idea complet (colonnes formulaire + LLM null + scores manuels + priorityOrder). Relations ajoutées sur Workspace et Contributor.prisma/migrations/20260227100000_add_idea_model/migration.sql (appliquer avec prisma migrate dev)getTierInfo mis à jour : ideasCount maintenant compté via db.idea.count() (plus de placeholder = 0)idea.schema.ts + idea.ts : schéma Zod séparé (pattern projet), publicProcedure (pas d'auth), lookup workspace par slug côté serveur (sécurité IDOR), transaction atomique idée + statut contributeurideaRouter enregistré dans root.ts(public)/layout.tsx et page submit/[workspaceSlug]/page.tsx (Server Component, await params Next.js 15, notFound())IdeaSubmissionForm.tsx : validation on blur, tous les champs, isPending + spinner, layout 2 colonnes (panneau exemples placeholder Story 2.3)DepartmentPicker.tsx : boutons pill, aria-pressed, role="group", touch targets ≥ 44px, palette LiviniaSubmissionConfirmation.tsx : role="status" aria-live="polite", CTA reset, fond vert succèsformValidation.ts (tests réels) ; H3 typage FormState strict (ImpactLevelValue, FrequencyValue) sans cast unsafe ; M1 focus auto sur titre confirmation ; L1 layout Tailwind bg-[#fefdfb] ; L2 constantes PROBLEM_DESCRIPTION_MIN/MAX_LENGTH partagéesidea.submit (endpoint public) — middleware Next.js ou tRPC (M3)prisma/schema.prisma (modifié — enums IdeaStatus/ImpactLevel/Frequency, modèle Idea, relations)prisma/migrations/20260227100000_add_idea_model/migration.sql (créé)src/server/api/routers/idea.schema.ts (modifié — constantes PROBLEM_DESCRIPTION_MIN/MAX_LENGTH)src/server/api/routers/idea.ts (créé)src/server/api/routers/idea.test.ts (créé)src/server/api/root.ts (modifié — ajout ideaRouter)src/server/api/routers/workspace.ts (modifié — ideasCount réel dans getTierInfo)src/lib/formValidation.ts (créé — validation partagée formulaire + tests)src/app/(public)/layout.tsx (modifié — bg-[#fefdfb] Tailwind)src/app/(public)/submit/[workspaceSlug]/page.tsx (créé)src/components/form/IdeaSubmissionForm.tsx (modifié — formValidation, FormState typé, formError banner en tête)src/components/form/IdeaSubmissionForm.test.tsx (modifié — tests importent formValidation)src/components/form/DepartmentPicker.tsx (créé)src/components/form/DepartmentPicker.test.tsx (créé)src/components/form/SubmissionConfirmation.tsx (modifié — focus auto sur h2, tabIndex -1)