v1.0

2026-02-13 00:21:53 +01:00
parent 81d2412835
commit 6923c319a1
85 changed files with 17836 additions and 0 deletions
@@ -0,0 +1,58 @@
+# Build sur Windows — Dépannage
+
+Le client utilise **Vite**, qui s’appuie sur **esbuild** (binaire natif fourni pour Windows : `@esbuild/win32-x64/esbuild.exe`). Aucune compilation C++ n’est nécessaire : ce sont des exécutables précompilés.
+
+## Vous avez désinstallé « Windows Development » / « Windows Developer » (~2 Go)
+
+Le logiciel d’environ **2 Go** dont le nom contient **Windows Development** ou **Windows Developer** est en général :
+
+- **Visual Studio Build Tools** (outils de génération Visual Studio), ou  
+- **Windows SDK** (Software Development Kit), ou  
+- un composant **« Développement Windows »** de Visual Studio.
+
+Pour ce projet (Vite + esbuild), **vous n’avez pas besoin de réinstaller tout ça**. Il suffit d’installer le **runtime** qui va avec, beaucoup plus léger.
+
+### 1. Réinstaller uniquement le Visual C++ Redistributable (souvent suffisant)
+
+Après la désinstallation du gros paquet « Windows Development », il peut manquer le **Visual C++ Redistributable** (quelques dizaines de Mo). C’est lui qui permet d’exécuter des .exe natifs comme `esbuild.exe`.
+
+- Télécharger : [Microsoft Visual C++ Redistributable (dernière version)](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)  
+- Installer la version **x64** (et éventuellement x86 si vous utilisez du 32 bits).  
+- Redémarrer le terminal, puis dans `client/` : `npm run build`.
+
+Pas besoin de réinstaller les 2 Go de « Windows Development » pour faire tourner le build.
+
+### 2. Réinstaller les dépendances du client
+
+```powershell
+cd client
+Remove-Item -Recurse -Force node_modules
+Remove-Item -Force package-lock.json
+npm install
+npm run build
+```
+
+### 3. Antivirus / Windows Defender
+
+Parfois l’antivirus ou Windows Defender bloque l’exécution de `esbuild.exe`.
+
+- Ajouter une exclusion pour le dossier du projet (ou au minimum `client\node_modules`) dans Windows Defender / antivirus.
+- Relancer `npm run build`.
+
+### 4. Droits / exécution
+
+- Lancer **PowerShell ou CMD en tant qu’administrateur** une fois, aller dans `client/` et lancer `npm run build` pour vérifier si le problème vient des droits.
+- Vérifier que le disque n’est pas en lecture seule et que le dossier n’est pas synchronisé par OneDrive/Dropbox au moment du build.
+
+### 5. Node et npm à jour
+
+```powershell
+node -v   # 18+ recommandé
+npm -v
+```
+
+Si besoin, réinstaller Node depuis [nodejs.org](https://nodejs.org/) (version LTS).
+
+---
+
+En résumé : après avoir désinstallé des outils de dev Windows, réinstaller le **Visual C++ Redistributable** et refaire un `npm install` dans `client/` règle souvent le problème.