# Déploiement — AImpact Hub 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`. --- ## Résumé rapide « tout refaire » | É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) | --- ## Libérer les fichiers verrouillés (kill processus Windows) 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/`. ### Quand tuer les tâches ? 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.node` - `EBUSY: resource busy or locked` - `Remove-Item` / `rmdir` qui refuse de supprimer `generated`, `.next` ou `node_modules` - `pnpm install` ou `prisma generate` qui restent bloqués sans fin - Le port **3000** déjà utilisé au lancement de `pnpm dev` ### Ordre recommandé (du plus doux au plus radical) 1. **Arrêter proprement** dans chaque terminal Cursor / PowerShell : - `Ctrl+C` sur `pnpm dev`, `pnpm db:studio`, `pnpm test:watch`, `vitest` 2. **Fermer les onglets** qui tournent encore (terminal intégré avec un serveur actif). 3. **Fermer Prisma Studio** si ouvert (`pnpm db:studio`). 4. Si ça bloque encore → **kill Node** (voir ci-dessous). 5. En dernier recours → redémarrer Cursor, ou la session Windows. ### CMD — kill tous les processus Node ⚠️ 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. ```cmd taskkill /f /im node.exe ``` Attendre 2–3 secondes, puis supprimer et réinstaller : ```cmd 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 ``` ### PowerShell — équivalent ```powershell 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 ``` ### Libérer le port 3000 (Next.js déjà lancé) ```cmd netstat -ano | findstr :3000 ``` Noter le **PID** (dernière colonne), puis : ```cmd taskkill /f /pid NUMERO_DU_PID ``` PowerShell : ```powershell Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force } ``` ### Processus qui verrouillent le plus souvent | 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 | ### Checklist rapide avant un reset complet ```text [ ] 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. --- ## Procédure complète en local (reset + build) Répertoire de travail : `aimpact-hub/`. ### PowerShell ```powershell 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 ``` ### CMD (si EPERM sur `query_engine-windows.dll.node`) ```cmd 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. --- ## Commandes de redéploiement (ordre à respecter) ```cmd 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. ### Redéployer sans nouveau commit (dashboard Vercel) 1. **Deployments** → dernier déploiement → **Redeploy**. 2. Cocher **Clear build cache** si le build échoue de façon incohérente (module manquant, ancien artefact). 3. Attendre la fin du build ; vérifier les logs (`prisma generate` doit apparaître pendant `postinstall`). ### Redéployer via Git (miroir GitHub uniquement) Si un remote GitHub est connecté à Vercel : ```bash 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`. --- ## Appliquer les migrations sur Neon prod `DATABASE_URL` prod se trouve dans : **Vercel → Project → Settings → Environment Variables**. ```cmd set DATABASE_URL=postgresql://...URL_NEON_PROD...?sslmode=require pnpm db:migrate ``` Vérifier que tout est appliqué : ```cmd pnpm exec prisma migrate status ``` Toutes les migrations doivent être en `Applied`. --- ## Erreur fréquente : `ERR_PNPM_OUTDATED_LOCKFILE` **Cause :** `pnpm-lock.yaml` local n'est pas synchronisé avec `package.json` (ex. après un `pnpm add` ou `pnpm remove`). **Fix :** ```cmd pnpm install npx vercel --prod ``` Si `pnpm install` échoue avec `EPERM` : ```cmd taskkill /f /im node.exe rmdir /s /q generated\prisma pnpm install --ignore-scripts npx vercel --prod ``` --- ## Erreur fréquente : `EPERM` sur `query_engine-windows.dll.node` **Cause :** 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)](#libérer-les-fichiers-verrouillés-kill-processus-windows)** ci-dessus. Résumé minimal : ```cmd 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). --- ## Erreur fréquente : `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) :** 1. **Alias dédié** dans `aimpact-hub/tsconfig.json` : ```json "paths": { "~/*": ["./src/*"], "~/generated/*": ["./generated/*"] } ``` 2. **Imports relatifs** (comme dans `src/server/db.ts`) : ```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`. --- ## Vérifications Vercel avant / après déploiement - **Settings → Environment Variables** : `DATABASE_URL` (Production + Preview), `AUTH_SECRET`, `NEXT_PUBLIC_APP_URL`, etc. (voir tableau ci-dessous). - **Root Directory** : `aimpact-hub` si le dépôt monorepo est à la racine `AImpact-Ai_Hub`. - Build logs : `prisma generate` pendant `postinstall`, puis `next build` sans erreur de module. - **Analytics** (optionnel POC) : package `@vercel/analytics` + `` dans `src/app/layout.tsx` ; les données n'apparaissent qu'en **production** déployée (pas en `pnpm dev` local). --- ## Sauvegarder le code (Git) Le repo principal est sur Gitea : ``` https://git.intersel.fr/augustin.podvin/AImpact-Hub.git ``` ```bash 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`. --- ## Limites Vercel (plan Hobby gratuit) | 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. --- ## Variables d'environnement requises en prod (Vercel) | 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 | --- ## Note : pourquoi pas GitHub → Vercel ? 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 : - Ajouter un **miroir GitHub** (repo privé) + connecter Vercel à GitHub → `git push` déclenche le build automatiquement. - Ajouter GitHub comme second remote pour pousser sur les deux en une commande : ```bash 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.