stepsCompleted: [1, 2, 3, 4, 5, 6, 7, 8] inputDocuments:
This document builds collaboratively through step-by-step discovery. Sections are appended as we work through each architectural decision together.
Functional Requirements: 38 exigences fonctionnelles couvrant : création de workspace (1 user = 1 workspace en MVP), onboarding guidé, invitation de contributeurs, formulaire de soumission avec exemples IA contextuels (LLM), bibliothèque de cas d'usage partagée CDO–métiers, ingestion email par workspace, backlog (liste + kanban 4 colonnes), fiches enrichies par LLM (titre, domaine, type IA, explication, scores), scoring IA avec ajustement manuel, drag & drop priorisation, statuts contributeur, questions de qualification, relances (auto J+21 et manuelle), export PDF / lien partageable, conformité RGPD. Deux rôles : Transformateur (admin) et Contributeur.
Non-Functional Requirements:
Scale & Complexity:
Full-stack web - frontend React, Next.js (App Router), API backend, base de données, intégrations LLM et email.
Rationale for Selection: Le starter T3 fournit une base déjà configurée pour Tailwind, Prisma, NextAuth et tRPC - aligné avec la spec UX (Tailwind + shadcn/ui) et les besoins projet (multi-tenant, auth, API type-safe). Prisma facilite l'isolation par workspace et PostgreSQL pour hébergement EU.
Initialization Command:
pnpm dlx create-t3-app@latest --CI --trpc --prisma --nextAuth --tailwind --appRouter --dbProvider postgres
Architectural Decisions Provided by Starter:
Language & Runtime:
Styling Solution:
Build Tooling:
Testing Framework:
Code Organization:
src/app/), src/server/ pour tRPC, src/lib/ pour utilitairesDevelopment Experience:
Note: L'initialisation du projet avec cette commande doit être la première story d'implémentation. shadcn/ui sera ajouté après le scaffold via npx shadcn@latest init.
Critical Decisions (Block Implementation):
workspace_id sur toutes les tablesImportant Decisions (Shape Architecture):
Deferred Decisions (Post-MVP):
| Decision | Choice | Version | Rationale |
|---|---|---|---|
| Database | PostgreSQL | 15+ | Multi-tenant, hébergement EU |
| ORM | Prisma | 7.x | Fourni par T3, migrations, typage |
| Provider | Neon | - | eu-central-1 (Frankfurt), RGPD |
| Multi-tenant | workspace_id sur toutes les tables |
- | Isolation stricte (NFR14) |
| Validation | Zod | - | Intégré avec tRPC |
| Migrations | Prisma Migrate | - | Versioning du schéma |
| Decision | Choice | Version | Rationale |
|---|---|---|---|
| Auth Transformateur | NextAuth.js | 4.x/5.x (T3) | Fourni par T3, adaptateur Prisma |
| Auth provider | Credentials (email + password) | - | Simple, B2B-friendly, pas de dépendance OAuth (Google, Discord) |
| RBAC | 2 rôles custom | - | Transformateur, Contributeur |
| Contributeur | Pas de compte | - | FR8 : token/lien par email |
| Encryption at rest | AES-256 | - | NFR15 |
| HTTPS | TLS 1.2+ | - | NFR16 |
Le Transformateur s'authentifie via email + mot de passe avec confirmation par email. Pas d'OAuth (Google, Discord) en MVP.
| Étape | Description | Implémentation |
|---|---|---|
| 1. Inscription | Formulaire email + mot de passe | Page /signup, tRPC auth.register |
| 2. Confirmation email | Lien de vérification envoyé par email | User.emailVerified mis à jour au clic |
| 3. Connexion | Email + mot de passe | NextAuth provider Credentials |
| 4. Création workspace | Après première connexion | Story 1.3 - formulaire nom entreprise + email contact |
Schéma User (Prisma) : email (unique), password (hash bcrypt), emailVerified (DateTime?), name (optionnel).
Service email : Resend, SendGrid ou équivalent pour l'envoi du lien de confirmation. Le token de vérification est stocké temporairement (table VerificationToken ou champ dédié) avec expiration (ex. 24h).
| Decision | Choice | Rationale |
|---|---|---|
| API interne | tRPC | Type-safety, React Query |
| Webhooks externes | Next.js Route Handlers | Email, OpenAI |
| Error handling | tRPC error codes | Standardisation |
| Documentation | tRPC auto + OpenAPI pour routes externes | Intégrations |
| Decision | Choice | Rationale |
|---|---|---|
| Composants UI | shadcn/ui | Spec UX |
| Drag & drop | dnd-kit | Kanban |
| State | React Query (tRPC) + état local | Pas de store global |
| Routing | App Router | Fourni par T3 |
| Design tokens | Livinia Chaleureux | Spec UX |
| Decision | Choice | Rationale |
|---|---|---|
| Hosting | Vercel | Next.js natif |
| Region | EU | RGPD |
| PostgreSQL | Neon eu-central-1 | Frankfurt, EU |
| Stockage fichiers | Vercel Blob ou S3 EU | Pièces jointes |
Implementation Sequence:
Cross-Component Dependencies:
workspace_id → tous les routers tRPC doivent filtrer par workspaceCritical Conflict Points Identified: 12 zones où les agents IA pourraient diverger sans règles explicites.
Database Naming Conventions:
snake_case pluriel (workspaces, ideas, contributors)snake_case (workspace_id, created_at, idea_status){table_singular}_id (workspace_id, contributor_id)@@index([workspace_id, created_at])workspace_id en premier.API Naming Conventions:
camelCase (getIdeas, updateIdeaStatus, createWorkspace)ideaRouter, workspaceRouter)app/api/... (/api/webhooks/email, /api/llm/enrich)Code Naming Conventions:
PascalCase (IdeaCard, KanbanBoard, DepartmentPicker)PascalCase.tsx (IdeaCard.tsx)use + camelCase (useIdeas, useWorkspace)camelCase (formatIdeaStatus, getWorkspaceContext)UPPER_SNAKE_CASE (IDEA_STATUSES, MAX_ATTACHMENTS)Project Organization:
src/app/ - routes App Router (pages, layouts)src/components/ - composants UI (sous-dossiers par feature : backlog/, form/, shared/)src/server/ - tRPC routers, context, Prisma clientsrc/lib/ - utilitaires, helpers, constantessrc/styles/ - tokens design, globals__tests__/ à côté du fichier ou *.test.ts co-localiséFile Structure Patterns:
index.ts pour les dossiers de composants.env.example documenté, pas de secrets en durAPI Response Formats:
{ data }TRPCError avec code (UNAUTHORIZED, NOT_FOUND, BAD_REQUEST)2026-02-27T10:00:00Z)Data Exchange Formats:
camelCase (aligné TypeScript)true/false uniquementEvent System Patterns:
utils.idea.invalidate())workspace_id pour routageState Management Patterns:
useState / useReducerError Handling Patterns:
throw new TRPCError({ code, message })NextResponse.json({ error: message }, { status })isError de React Query + affichage inline (pas de modale pour erreurs simples)Loading State Patterns:
isLoading / isPending pour requêtesSkeleton de shadcn sur la zone concernéeAll AI Agents MUST:
workspace_id quand applicableAIBadge ou équivalentPattern Enforcement:
Good Examples:
// tRPC procedure avec workspace
const getIdeas = protectedProcedure
.input(z.object({ workspaceId: z.string() }))
.query(async ({ ctx, input }) => {
return ctx.db.idea.findMany({
where: { workspaceId: input.workspaceId },
orderBy: { createdAt: 'desc' },
});
});
// Composant avec fallback LLM
{isEnriching ? <Skeleton className="h-20" /> : <IdeaEnrichment data={idea} />}
Anti-Patterns:
// ❌ Pas de filtre workspace
ctx.db.idea.findMany() // fuite multi-tenant
// ❌ Erreur LLM exposée au contributeur
throw new Error(openAIError.message)
// ❌ Nommage incohérent
const UserCard = () => {} // fichier user-card.tsx
aimpact-hub/
├── README.md
├── package.json
├── pnpm-lock.yaml
├── next.config.js
├── tailwind.config.ts
├── tsconfig.json
├── .env.example
├── .env.local
├── .gitignore
├── .eslintrc.cjs
├── components.json
├── .github/
│ └── workflows/
│ └── ci.yml
├── docs/
│ └── architecture/
│ └── journey-to-structure.md # Mapping parcours → dossiers
├── prisma/
│ ├── schema.prisma
│ ├── seed.ts
│ └── migrations/
├── public/
│ └── assets/
│ └── images/
├── src/
│ ├── app/
│ │ ├── globals.css
│ │ ├── layout.tsx
│ │ ├── page.tsx
│ │ ├── (auth)/
│ │ │ ├── signin/
│ │ │ │ └── page.tsx
│ │ │ └── signup/
│ │ │ └── page.tsx
│ │ ├── (dashboard)/
│ │ │ ├── layout.tsx
│ │ │ ├── workspace/
│ │ │ │ ├── page.tsx
│ │ │ │ └── [workspaceId]/
│ │ │ │ ├── page.tsx
│ │ │ │ ├── backlog/
│ │ │ │ │ └── page.tsx
│ │ │ │ ├── ideas/
│ │ │ │ │ └── [ideaId]/
│ │ │ │ │ └── page.tsx
│ │ │ │ ├── contributors/
│ │ │ │ │ └── page.tsx
│ │ │ │ ├── library/
│ │ │ │ │ └── page.tsx
│ │ │ │ └── settings/
│ │ │ │ └── page.tsx
│ │ │ └── export/
│ │ │ └── page.tsx
│ │ ├── (public)/
│ │ │ └── submit/
│ │ │ └── [workspaceSlug]/
│ │ │ └── page.tsx
│ │ ├── api/
│ │ │ ├── auth/
│ │ │ │ └── [...nextauth]/
│ │ │ │ └── route.ts
│ │ │ ├── trpc/
│ │ │ │ └── [trpc]/
│ │ │ │ └── route.ts
│ │ │ ├── webhooks/
│ │ │ │ └── email/
│ │ │ │ └── route.ts
│ │ │ ├── cron/
│ │ │ │ └── relance/
│ │ │ │ └── route.ts # Relance J+21 (Vercel Cron)
│ │ │ └── llm/
│ │ │ ├── examples/
│ │ │ │ └── route.ts
│ │ │ └── enrich/
│ │ │ └── route.ts
│ │ └── share/
│ │ └── [shareToken]/
│ │ └── page.tsx
│ ├── components/
│ │ ├── ui/
│ │ ├── shared/
│ │ ├── backlog/
│ │ ├── form/
│ │ ├── idea/
│ │ ├── workspace/
│ │ ├── library/
│ │ └── export/
│ ├── server/
│ │ ├── db.ts
│ │ ├── auth.ts
│ │ ├── api/
│ │ │ ├── root.ts
│ │ │ ├── trpc.ts
│ │ │ ├── procedures.ts
│ │ │ ├── procedures/
│ │ │ │ └── createWorkspaceProcedure.ts
│ │ │ └── routers/
│ │ │ ├── workspace.ts
│ │ │ ├── idea.ts
│ │ │ ├── contributor.ts
│ │ │ ├── library.ts
│ │ │ └── export.ts
│ │ └── services/
│ │ ├── llm.ts
│ │ ├── email.ts
│ │ ├── storage.ts # Convention: {workspaceId}/attachments/{ideaId}/{filename}
│ │ └── export.ts
│ ├── lib/
│ │ ├── utils.ts
│ │ ├── constants.ts
│ │ ├── validators/
│ │ └── trpc.ts
│ └── styles/
│ └── tokens.css
├── __tests__/
│ ├── lib/
│ ├── components/
│ ├── server/
│ │ └── routers/
│ └── api/
│ ├── webhooks/
│ └── llm/
| Parcours | Dossiers principaux | Point d'entrée |
|---|---|---|
| Onboarding CDO | (dashboard)/workspace/, components/workspace/OnboardingChecklist |
workspace/page.tsx |
| Soumission contributeur | (public)/submit/, components/form/ |
submit/[workspaceSlug]/page.tsx |
| Backlog CDO | (dashboard)/workspace/[id]/backlog/, components/backlog/ |
backlog/page.tsx |
| Enrichissement LLM | api/llm/, services/llm.ts |
Appelé par webhook + tRPC |
| Relance J+21 | api/cron/relance/ |
Vercel Cron |
API Boundaries:
src/server/api/routers/* - procédures protégées (Transformateur) ou publiques (formulaire)src/app/api/webhooks/email, src/app/api/llm/*, src/app/api/cron/relance(dashboard)/*, formulaire (public)/submit/* sans authSecurity Conventions (Multi-Tenant):
createWorkspaceProcedure ou recevoir workspaceId validé/api/llm/* : valider que l'idée appartient au workspace avant enrichissement{workspaceId}/attachments/{ideaId}/{filename}Prisma: Workspace.slug (unique) pour les URLs contributeur (/submit/[workspaceSlug]).
Workspace & Gestion (FR1–FR5): src/app/(dashboard)/workspace/, src/server/api/routers/workspace.ts, Prisma Workspace (incl. slug)
Contributeurs (FR6–FR13): src/server/api/routers/contributor.ts, components/workspace/, services/email.ts, api/cron/relance/
Éducation IA & Bibliothèque (FR14-IA1–FR14-IA6): api/llm/examples/, components/form/ExamplesPanel.tsx, components/library/, routers/library.ts
Soumission (FR14–FR17): (public)/submit/, components/form/IdeaSubmissionForm.tsx, api/webhooks/email/
Enrichissement & Scoring (FR18–FR21): api/llm/enrich/, services/llm.ts, components/idea/ScoreSlider.tsx
Backlog (FR22–FR28): workspace/[workspaceId]/backlog/, components/backlog/*, routers/idea.ts
Qualification (FR29–FR32): components/idea/QualificationQuestion.tsx, services/email.ts
Priorisation (FR33–FR34): components/backlog/KanbanBoard.tsx, ideaRouter.updateOrder
Export (FR35–FR36): components/export/ExportPdfButton.tsx, services/export.ts, routers/export.ts
Decision Compatibility: Stack T3 (Next.js, Prisma, tRPC, NextAuth) cohérent avec multi-tenant et LLM. Neon eu-central-1 + Vercel EU respecte RGPD. shadcn/ui + Tailwind alignés avec spec UX. Aucun conflit identifié.
Pattern Consistency: Conventions de nommage cohérentes. createWorkspaceProcedure appliqué à tous les routers. Conventions stockage et sécurité multi-tenant documentées.
Structure Alignment: Arborescence alignée avec décisions (feature-based, séparation CDO/contributeur). Route Handlers pour webhooks/LLM, tRPC pour app. Cron relance J+21, services/export.ts pour PDF.
Functional Requirements: Tous les FR (FR1–FR38) couverts par la structure et les routers.
Non-Functional Requirements: Performance (fallback LLM < 3s), disponibilité, sécurité EU, chiffrement, limites LLM - tous adressés architecturalement.
Decision Completeness: Versions documentées, commandes d'initialisation fournies.
Structure Completeness: Arborescence complète, mapping parcours → structure, tests définis.
Pattern Completeness: Conventions exhaustives, exemples et anti-patterns, règles sécurité multi-tenant.
Critical Gaps: Aucun
Important Gaps: Middleware validateWorkspaceToken pour webhook email à implémenter ; config Vercel Cron à documenter.
Nice-to-Have: Vitest, monitoring LLM (NFR8).
✅ Requirements Analysis - Contexte, échelle, contraintes, cross-cutting concerns
✅ Architectural Decisions - Décisions critiques, stack, intégrations, performance
✅ Implementation Patterns - Nommage, structure, communication, processus
✅ Project Structure - Arborescence, frontières, intégrations, mapping requirements
Overall Status: READY FOR IMPLEMENTATION
Confidence Level: High
Key Strengths: Multi-tenant sécurisé, fallback LLM, structure alignée parcours, enrichissements Advanced Elicitation + Party Mode.
Areas for Future Enhancement: Monitoring LLM, Vitest, DPA grands comptes.
AI Agent Guidelines:
First Implementation Priority:
pnpm dlx create-t3-app@latest --CI --trpc --prisma --nextAuth --tailwind --appRouter --dbProvider postgres