Status: done
En tant que développeur, je veux initialiser le projet avec create-t3-app et shadcn/ui, afin d'avoir une base Next.js, Prisma, tRPC, NextAuth et design system prêts à recevoir le schéma multi-tenant (Story 1.2) et les composants métier (Stories suivantes).
Given le répertoire projet actuel (AImpact-Ai_Hub/)
When j'exécute le scaffold T3 avec les flags spécifiés
Then un sous-dossier projet (ou le dossier courant) contient Next.js App Router, TypeScript strict, Tailwind CSS, tRPC, Prisma (provider postgres), NextAuth
And pnpm dev démarre sans erreur et affiche la page d'accueil T3
Given le projet T3 scaffoldé
When j'exécute npx shadcn@latest init avec les options alignées sur la spec UX
Then components.json est créé à la racine
And src/lib/utils.ts contient la fonction cn() (class merge helper)
And src/app/globals.css contient les CSS variables de theming shadcn
Given shadcn/ui initialisé
When j'ajoute un composant de test (npx shadcn@latest add button)
Then le fichier src/components/ui/button.tsx est créé
And le composant est importable et s'affiche sans erreur dans pnpm dev
Given le projet complet (T3 + shadcn)
When je vérifie la structure de fichiers
Then elle correspond à la structure documentée dans l'architecture (voir section File Structure ci-dessous)
And .env.example existe avec les variables documentées (sans secrets)
And prisma/schema.prisma contient le provider postgresql et les modèles NextAuth par défaut
Given le projet complet
When j'exécute pnpm build
Then le build réussit sans erreur TypeScript ni warning critique
pnpm --version)pnpm dlx create-t3-app@latest --CI --trpc --prisma --nextAuth --tailwind --appRouter --dbProvider postgrespnpm install si les dépendances n'ont pas été installéespnpm dev — la page d'accueil T3 s'affiche sur localhost:3000pnpm build — build sans erreur.env à partir de .env.example avec des valeurs de développement localDATABASE_URL : utiliser une URL PostgreSQL locale ou placeholder — la connexion Neon sera configurée en Story 1.2NEXTAUTH_SECRET : générer avec openssl rand -base64 32NEXTAUTH_URL : http://localhost:3000.env est dans .gitignorenpx shadcn@latest initcomponents.json est créésrc/lib/utils.ts contient cn()npx shadcn@latest add buttonsrc/components/ui/button.tsx existe et est importablenpx shadcn@latest add card) pour validerpnpm dev fonctionnepnpm build réussit.env.example documentéAImpact Hub est un SaaS B2B d'accélération de la culture IA en entreprise. Cette story est le tout premier scaffold — aucun code n'existe encore. Le projet sera multi-tenant (workspace_id sur toutes les tables), avec deux personas : le Transformateur (CDO, authentifié NextAuth) et le Contributeur (accès public sans compte, via /submit/[workspaceSlug]).
Ces choix sont figés — ne pas les remettre en question :
| Décision | Choix | Source |
|---|---|---|
| Framework | Next.js App Router | Architecture doc |
| ORM | Prisma avec PostgreSQL | Architecture doc |
| API | tRPC (interne) + Route Handlers (webhooks, LLM) | Architecture doc |
| Auth | NextAuth.js 4.x (Prisma adapter) | Architecture doc |
| Styling | Tailwind CSS + shadcn/ui (Radix) | Architecture + UX spec |
| Package manager | pnpm | Architecture doc |
| DB provider | Neon eu-central-1 (Frankfurt) | Architecture doc |
| Design tokens | Livinia Chaleureux (#fefdfb, #7c3aed) | UX spec |
| Hébergement | Vercel (EU region) | Architecture doc |
pnpm dev et pnpm build.env.example documentéRépertoire de travail : create-t3-app crée un sous-dossier par défaut (nommé d'après le projet). En mode --CI, le nom par défaut est utilisé. Décider si on travaille dans le sous-dossier ou si on déplace le contenu à la racine. Documenter le choix.
Le flag --CI est obligatoire pour éviter les prompts interactifs. Sans --CI, les flags --trpc, --prisma, etc. sont ignorés.
shadcn/ui init APRÈS T3 — jamais l'inverse. L'init détecte la config Tailwind existante.
CSS variables = Yes lors du shadcn init — indispensable pour le theming Livinia Chaleureux qui sera appliqué en Story 1.2.
Ne PAS restructurer src/app/, src/server/, src/lib/ — la structure T3 par défaut est conforme à l'architecture cible.
Ne PAS modifier prisma/schema.prisma — le schéma multi-tenant sera défini en Story 1.2.
Structure attendue après scaffold T3 + shadcn init :
aimpact-hub/ (ou racine projet)
├── .env.example
├── .env (local, gitignored)
├── .eslintrc.cjs
├── .gitignore
├── components.json ← shadcn config
├── next.config.js
├── package.json
├── pnpm-lock.yaml
├── tailwind.config.ts
├── tsconfig.json
├── prisma/
│ └── schema.prisma ← modèles NextAuth par défaut, provider postgresql
├── public/
├── src/
│ ├── app/
│ │ ├── globals.css ← CSS variables shadcn injectées ici
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── components/
│ │ └── ui/
│ │ └── button.tsx ← ajouté via `npx shadcn add button`
│ ├── lib/
│ │ └── utils.ts ← cn() helper (shadcn)
│ ├── server/
│ │ ├── auth.ts
│ │ ├── db.ts
│ │ └── api/
│ │ ├── root.ts
│ │ └── trpc.ts
│ ├── styles/ ← (sera créé en Story 1.2 pour les tokens Livinia)
│ └── trpc/ ← client tRPC (React Query)
# Base de données — PostgreSQL (Neon eu-central-1 en production)
DATABASE_URL="postgresql://user:password@localhost:5432/aimpact_hub?schema=public"
# NextAuth
NEXTAUTH_SECRET="generate-with-openssl-rand-base64-32"
NEXTAUTH_URL="http://localhost:3000"
# Auth (décision 2026-02-27 : email + password, pas d'OAuth)
# Le provider Discord fourni par T3 n'est PAS utilisé — Story 1.2b implémente Credentials (email/password + confirmation)
# Step 1 — Scaffold T3
pnpm dlx create-t3-app@latest --CI --trpc --prisma --nextAuth --tailwind --appRouter --dbProvider postgres
# Step 2 — Init shadcn/ui (dans le dossier projet)
npx shadcn@latest init
# Step 3 — Ajouter composant de validation
npx shadcn@latest add button
Quand npx shadcn@latest init pose des questions :
| Question | Réponse | Raison |
|---|---|---|
| Style | Default (ou New York) | Sera remplacé par Livinia en 1.2 |
| Base color | Slate | Sera remplacé par palette crème/violet en 1.2 |
| CSS variables | Yes | Obligatoire pour le theming Livinia Chaleureux |
| Where is your global CSS file? | src/app/globals.css |
Détecté auto par T3 |
| Import alias | @/* ou ~/ |
Garder celui de T3 |
| Anti-pattern | Pourquoi |
|---|---|
Modifier prisma/schema.prisma |
Story 1.2 — schéma multi-tenant |
| Ajouter des pages ou routes métier | Stories suivantes |
| Installer des dépendances supplémentaires (dnd-kit, etc.) | Chaque story installe ses propres dépendances |
Restructurer src/ (renommer server/, lib/, etc.) |
La structure T3 est conforme à l'architecture cible |
| Supprimer les exemples T3 (page d'accueil, etc.) | Sera nettoyé en Story 1.2/1.3 quand les vraies pages arrivent |
| Configurer la palette Livinia Chaleureux | Story 1.2 — design tokens |
| Créer des composants custom | Stories suivantes |
Modifier next.config.js (sauf si build échoue) |
Configuration par défaut suffisante |
| Utiliser npm ou yarn au lieu de pnpm | pnpm est le package manager du projet |
create-t3-app crée un dossier nommé (ex. my-t3-app/). En mode --CI, le nom par défaut est utilisé. Si le CLI demande un nom, répondre aimpact-hub.--CI obligatoire : sans ce flag, les autres flags (--trpc, --prisma, etc.) sont ignorés et le CLI devient interactif.pnpm dev fonctionne sans base PostgreSQL connectée, mais prisma db push échouera — normal, c'est Story 1.2.init vs create : npx shadcn@latest create est pour un nouveau projet from scratch. Pour un projet T3 existant → toujours npx shadcn@latest init.tailwind.config.ts existe.cn() helper : shadcn crée src/lib/utils.ts avec la fonction cn() qui merge les classes Tailwind. Si le fichier existe déjà (T3 en crée un), shadcn le modifie. Vérifier qu'il contient bien cn().| Bibliothèque | Version attendue | Notes |
|---|---|---|
| create-t3-app | v7.40+ | pnpm dlx create-t3-app@latest |
| Next.js | 14+ ou 15+ (fourni par T3) | App Router, Turbopack |
| TypeScript | 5.x (fourni par T3) | Strict mode activé |
| Tailwind CSS | 3.x ou 4.x (fourni par T3) | Config dans tailwind.config.ts |
| Prisma | 5.x ou 6.x (fourni par T3) | Provider PostgreSQL |
| NextAuth.js | 4.x (fourni par T3) | Prisma adapter |
| shadcn/ui | @latest | Via CLI npx shadcn@latest |
| React | 18+ (fourni par T3) | Server Components support |
L'auth Transformateur utilise email + mot de passe avec confirmation par email. Pas d'OAuth (Google, Discord). Story 1.2b implémente : inscription → confirmation email → connexion (NextAuth Credentials). Story 1.3 (création workspace) s'exécute après première connexion.
Story 1.2 (Schéma Prisma Workspace et modèle multi-tenant) prendra le relais avec :
prisma/schema.prisma pour ajouter Workspace, Idea, Contributor, etc.DATABASE_URL vers Neon eu-central-1prisma db push ou prisma migrateglobals.csscreateWorkspaceProcedure pour l'isolation multi-tenantPour que Story 1.2 fonctionne, cette story DOIT livrer :
prisma/schema.prisma fonctionnel avec provider postgresqlsrc/server/db.ts avec le Prisma client configurésrc/server/api/trpc.ts avec la base tRPCcomponents.json avec CSS variables activéesglobals.css avec les CSS variables shadcn (base pour le theming)[ ] pnpm dev démarre → localhost:3000 affiche la page T3
[ ] pnpm build → succès, 0 erreur TypeScript
[ ] components.json existe à la racine
[ ] src/components/ui/button.tsx existe
[ ] src/lib/utils.ts contient cn()
[ ] prisma/schema.prisma → provider = "postgresql"
[ ] .env.example documenté
[ ] .env dans .gitignore
[ ] Aucun modèle Prisma custom ajouté
[ ] Aucune dépendance supplémentaire installée
aimpact-hub/ (sous-dossier). NextAuth v5 beta, Tailwind v4.globals.css dans src/styles/ (T3 v7).env.js : AUTH_DISCORD_ID/SECRET rendus optionnels (auth email/password en Story 1.2b)..env.example mis à jour (auth Credentials, pas Discord).