CG-Feedback-Monitor/UMZUG.md

69 lines
1.6 KiB
Markdown
Raw Normal View History

# Umzug auf einen neuen Laptop — Assignment Monitor V2
Dieses Paket ist **kein Team-Starter**. Es enthält den aktuellen Code **und die komplette lokale Datenbank** (Personen, Assignments, Meetings, Feedback).
**Nicht** `npm run setup` ausführen — das würde die mitgelieferte Datenbank durch die leere Struktur ersetzen.
---
## 1. Voraussetzung
- **Node.js 25 oder neuer** — https://nodejs.org/
- Prüfen: `node -v`
Eine vorhandene Produktiv-Installation (`AssigmentMonitor` ohne V2, Ports 5173/4000) bleibt unberührt.
---
## 2. Entpacken
Nach z.B. `C:\dev\AssigmentMonitorV2`, dann:
```powershell
cd C:\dev\AssigmentMonitorV2
```
---
## 3. Einmalig einrichten
```powershell
copy .env.example .env
npm install
```
Kein `setup`, kein `bootstrap`, kein `db:reset`.
Die Datei `server\data\assignment-monitor-v2-dev.sqlite3` muss nach dem Entpacken vorhanden sein.
---
## 4. Starten
```powershell
npm run dev:all
```
Browser: **http://localhost:5174**
Beenden: `Strg+C` im Terminal.
---
## 5. KI-Schlüssel
Der OpenRouter-API-Key lag im Browser (`localStorage`) des alten Laptops und ist **nicht** in diesem ZIP. Unter **Einstellungen → KI-Prompts** neu eintragen.
---
## Probleme
| Symptom | Lösung |
|---|---|
| `node` nicht gefunden | Node 25+ installieren, neues Terminal |
| Leere App / keine Assignments | `setup` wurde ausgeführt — ZIP erneut entpacken, DB nicht überschreiben |
| Port belegt | Anderes Programm auf 5174/4001 beenden — **nicht** auf 5173/4000 umbiegen |
| `npm install` fehlerhaft | Im Projektordner ausführen |
Neues Paket erzeugen (alter Laptop): `npm run pack:laptop` → Datei unter `dist-release\`.