# 📦 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`.
