Hébergement : Vercel (plan Hobby, région US East iad1).
Base de données : Neon (PostgreSQL, région EU eu-central-1).
Déploiement : CLI Vercel locale (pas de lien Git automatique — voir note ci-dessous).
Client Prisma : généré dans aimpact-hub/generated/prisma (pas dans node_modules). Le script postinstall exécute prisma generate à chaque pnpm install.
| Étape | Commande |
|---|---|
| Libérer les verrous Windows | Fermer pnpm dev / Studio, puis taskkill si besoin (voir section dédiée) |
| Nettoyer (local) | Supprimer .next, node_modules, generated |
| Install + Prisma | pnpm install (ou --ignore-scripts si EPERM) puis pnpm exec prisma generate |
| DB prod | pnpm db:migrate avec DATABASE_URL Neon prod |
| Test build local | pnpm build |
| Déployer | npx vercel --prod ou Redeploy + Clear cache (dashboard Vercel) |
Sur Windows, Prisma et pnpm échouent souvent si un ancien processus garde ouvert generated\prisma\query_engine-windows.dll.node ou des fichiers dans .next/.
Faire un « kill » avant pnpm install, prisma generate ou la suppression de dossiers si tu vois :
EPERM: operation not permitted sur query_engine-windows.dll.nodeEBUSY: resource busy or lockedRemove-Item / rmdir qui refuse de supprimer generated, .next ou node_modulespnpm install ou prisma generate qui restent bloqués sans finpnpm devCtrl+C sur pnpm dev, pnpm db:studio, pnpm test:watch, vitestpnpm db:studio).⚠️ Tue tous les node.exe de la machine (y compris d’autres projets ou outils basés sur Node). À utiliser quand rien d’autre ne suffit.
taskkill /f /im node.exe
Attendre 2–3 secondes, puis supprimer et réinstaller :
cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
rmdir /s /q generated
rmdir /s /q .next
pnpm install --ignore-scripts
pnpm exec prisma generate
Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep -Seconds 2
cd "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
Remove-Item -Recurse -Force generated, .next -ErrorAction SilentlyContinue
pnpm install --ignore-scripts
pnpm exec prisma generate
netstat -ano | findstr :3000
Noter le PID (dernière colonne), puis :
taskkill /f /pid NUMERO_DU_PID
PowerShell :
Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue |
ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }
| Processus / commande | Fichiers concernés |
|---|---|
pnpm dev (Turbopack) |
.next/, parfois modules |
pnpm db:studio |
moteur Prisma / generated/ |
pnpm test:watch / Vitest |
cache, parfois node_modules |
| Ancien terminal oublié | tout ce qui tourne encore en arrière-plan |
| Éditeur (Cursor) + TS Server | rarement generated/ ; en cas de doute, fermer le dossier aimpact-hub ou redémarrer l’éditeur |
[ ] Ctrl+C dans tous les terminaux du projet
[ ] Plus de Prisma Studio
[ ] taskkill /f /im node.exe (si EPERM / EBUSY)
[ ] Supprimer generated, .next, (optionnel) node_modules
[ ] pnpm install --ignore-scripts
[ ] pnpm exec prisma generate
[ ] pnpm build
Rappel : ces blocages sont locaux Windows. Un npx vercel --prod peut réussir même si le poste de dev est bloqué, car le build tourne sur Linux chez Vercel.
Répertoire de travail : aimpact-hub/.
cd "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
# Si EPERM / fichiers verrouillés : arrêter dev/studio puis kill Node
Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep -Seconds 2
# Nettoyer
Remove-Item -Recurse -Force .next, node_modules, generated -ErrorAction SilentlyContinue
# Réinstaller (postinstall = prisma generate)
pnpm install
# Générer le client Prisma à la main (au cas où)
pnpm exec prisma generate
# Appliquer les migrations (nécessite DATABASE_URL dans .env ou ci-dessous)
pnpm exec prisma migrate deploy
# Optionnel : données de démo
pnpm exec prisma db seed
# Vérifier que le build Next.js passe
pnpm build
# Relancer le dev
pnpm dev
query_engine-windows.dll.node)cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
taskkill /f /im node.exe
rmdir /s /q .next
rmdir /s /q node_modules
rmdir /s /q generated
pnpm install --ignore-scripts
pnpm exec prisma generate
pnpm build
--ignore-scripts évite l'erreur Windows sur le binaire Prisma verrouillé ; Vercel regénère Prisma sur Linux au build.
cd /d "C:\Users\USER\Documents\Intersel - Livinweb\dev\AImpact-Ai_Hub\aimpact-hub"
pnpm install --ignore-scripts
pnpm db:migrate
npx vercel --prod
--ignore-scripts : contourne l'erreur EPERM Windows sur generated\prisma\query_engine-windows.dll.node (Vercel regénère Prisma lui-même sur Linux).pnpm db:migrate : seulement si de nouvelles migrations Prisma ont été ajoutées depuis le dernier déploiement. Nécessite DATABASE_URL pointant vers Neon prod.npx vercel --prod : envoie les fichiers locaux et déclenche le build sur Vercel.prisma generate doit apparaître pendant postinstall).Si un remote GitHub est connecté à Vercel :
cd "/c/Users/USER/Documents/Intersel - Livinweb/dev/AImpact-Ai_Hub"
git add -A
git commit -m "Description"
git push origin main
Sinon, le push vers Gitea ne déclenche pas Vercel — utiliser npx vercel --prod.
DATABASE_URL prod se trouve dans : Vercel → Project → Settings → Environment Variables.
set DATABASE_URL=postgresql://...URL_NEON_PROD...?sslmode=require
pnpm db:migrate
Vérifier que tout est appliqué :
pnpm exec prisma migrate status
Toutes les migrations doivent être en Applied.
ERR_PNPM_OUTDATED_LOCKFILECause : pnpm-lock.yaml local n'est pas synchronisé avec package.json (ex. après un pnpm add ou pnpm remove).
Fix :
pnpm install
npx vercel --prod
Si pnpm install échoue avec EPERM :
taskkill /f /im node.exe
rmdir /s /q generated\prisma
pnpm install --ignore-scripts
npx vercel --prod
EPERM sur query_engine-windows.dll.nodeCause : Un processus Windows verrouille le fichier (serveur dev, Prisma Studio, terminal oublié).
Fix : suivre la section Libérer les fichiers verrouillés (kill processus Windows) ci-dessus.
Résumé minimal :
taskkill /f /im node.exe
rmdir /s /q generated\prisma
pnpm install --ignore-scripts
pnpm exec prisma generate
Note : Cette erreur est locale à Windows. Elle n'empêche pas Vercel de builder (Linux).
Can't resolve '~/generated/prisma'Cause : L'alias TypeScript ~/* pointe vers ./src/*. L'import ~/generated/prisma est donc résolu vers src/generated/prisma, qui n'existe pas. Le client Prisma est généré dans generated/prisma à la racine de aimpact-hub/.
prisma generate seul ne corrige pas cette erreur.
Fix (choisir une option) :
Alias dédié dans aimpact-hub/tsconfig.json :
"paths": {
"~/*": ["./src/*"],
"~/generated/*": ["./generated/*"]
}
Imports relatifs (comme dans src/server/db.ts) :
import { FeedbackType } from "../../../generated/prisma";
Fichiers historiquement concernés : src/server/api/routers/feedback.ts, src/components/feedback/FeedbackForm.tsx, src/components/feedback/FeedbackList.tsx.
Après correction : pnpm exec prisma generate puis pnpm build.
DATABASE_URL (Production + Preview), AUTH_SECRET, NEXT_PUBLIC_APP_URL, etc. (voir tableau ci-dessous).aimpact-hub si le dépôt monorepo est à la racine AImpact-Ai_Hub.prisma generate pendant postinstall, puis next build sans erreur de module.@vercel/analytics + <Analytics /> dans src/app/layout.tsx ; les données n'apparaissent qu'en production déployée (pas en pnpm dev local).Le repo principal est sur Gitea :
https://git.intersel.fr/augustin.podvin/AImpact-Hub.git
cd "/c/Users/USER/Documents/Intersel - Livinweb/dev/AImpact-Ai_Hub"
git add -A
git commit -m "Description"
git push origin master
Le push Git ne déclenche pas de déploiement Vercel automatique (pas de lien GitHub/GitLab configuré). Le déploiement se fait séparément avec npx vercel --prod.
| Ressource | Limite |
|---|---|
| Builds par jour | 100 |
| Durée max d'un build | 45 min |
| Bandwidth | 100 GB/mois |
| Edge function invocations | 500 000/mois |
Largement suffisant en phase de développement et de démarrage.
| Variable | Rôle |
|---|---|
DATABASE_URL |
URL Neon prod |
AUTH_SECRET |
Clé secrète NextAuth (générer avec npx auth secret) |
NEXT_PUBLIC_APP_URL |
URL publique de l'app (ex. https://aimpact-hub.vercel.app) |
RESEND_API_KEY |
Clé Resend pour les emails |
EMAIL_FROM |
Adresse expéditeur emails |
BLOB_READ_WRITE_TOKEN |
Token Vercel Blob (pièces jointes) |
CRON_SECRET |
Secret cron relance J+21 (générer avec openssl rand -hex 32) |
OPENAI_API_KEY |
Optionnel — exemples contextuels LLM |
RESEND_WEBHOOK_SECRET |
Optionnel — webhook email entrant |
INBOUND_EMAIL_DOMAIN |
Optionnel — domaine Resend inbound |
Le repo est hébergé sur un Gitea auto-hébergé (git.intersel.fr) que Vercel ne supporte pas nativement. Options possibles si besoin de déploiement automatique :
git push déclenche le build automatiquement.Ajouter GitHub comme second remote pour pousser sur les deux en une commande :
git remote set-url --add --push origin https://github.com/TON_USER/aimpact-hub.git
git remote set-url --add --push origin https://git.intersel.fr/augustin.podvin/AImpact-Hub.git
Pour l'instant le workflow CLI (npx vercel --prod) est suffisant.