docs: fix cannot finde module 'which'

docs/troubleshooting/npm-ci-vs-install.md

@@ -0,0 +1,60 @@
+# 📦 Problem mit Abhängigkeiten und npm-Fehlern
+
+**Datum:** 17.06.2025
+
+## ❓ Problem
+
+Nach einem Update oder manuellem Eingriff traten folgende Probleme auf:
+
+- `npm run dev` funktionierte nicht mehr.
+- Fehlermeldungen wie `Cannot find module 'which`, `tailwindcss`, oder 500er Fehler beim Start.
+- Konflikte in `package-lock.json`, z. B. bei `@mui/material`.
+
+---
+
+## 🛠️ Lösungsschritte
+
+### 1. ❌ Komplett zurücksetzen
+
+Lösche folgende Ordner und Dateien:
+
+```bash
+node_modules, package-lock.json, package.json, .next
+```
+
+### 2. 🧱 Alte funktionierende `package-lock.json` verwenden
+
+Füge die gesicherte Version wieder ein.
+
+### 3. 📦 Neu installieren
+
+```bash
+npm ci
+```
+
+> Wichtig: `npm ci` verwendet exakt die Versionen aus der `package-lock.json`.
+
+### 4. 📝 Alte `package.json` zurückholen
+
+Falls nötig, auch die alte `package.json` ersetzen.
+
+### 5. 🚀 Projekt starten
+
+```bash
+npm run dev
+```
+
+---
+
+## ✅ Empfehlung für die Zukunft
+
+- **Immer `package.json` und `package-lock.json` sichern**, wenn eine Version stabil funktioniert.
+- **Husky-Hook** verwenden, um Version bei jedem Commit automatisch zu erhöhen.
+- Zusätzlich kannst du `node_modules-v1.1.xxx.zip` archivieren.
+
+---
+
+## 🗂️ Dateiablage
+
+Diese Datei wurde erstellt für zukünftige Referenz und liegt in
+`/docs/troubleshooting/npm-ci-vs-install.md`.