# Einrichtung — Assignment Monitor (Team-Paket)

Kurz: ZIP entpacken → Node installieren → einrichten → Browser öffnen.

**Wichtig:** Das ist die Team-/DEV-Version (Ports **5174** / **4001**).  
Eine vorhandene Produktiv-Installation wird **nicht** verändert.

**Laptop-Umzug** (Code + komplette Datenbank): siehe **`UMZUG.md`**. Dort **kein** `npm run setup`.

---

## Was du bekommst / was nicht

| Enthalten (nach Setup) | Nicht enthalten |
|---|---|
| Feedback-Struktur (Dimensionen, Kategorien, Kriterien) | Institutees / Personen |
| Assignment-Typen + Phasen | Kunden-Assignments |
| Checklisten-Definitionen | Meetings, Protokolle, Beobachtungen |
| KI-Prompts (Feedback, Tagging) + Farbbänder | Bewertungen, Scores, Feedback-Texte |

Die Struktur liegt in `docs\starter\starter-structure.json` und wird beim Setup in die lokale DB geladen.

---

## 1. Voraussetzung

- **Node.js 25 oder neuer** — https://nodejs.org/  
  Prüfen:

```powershell
node -v
```

---

## 2. Entpacken

z.B. nach `C:\dev\AssigmentMonitorV2`, dann:

```powershell
cd C:\dev\AssigmentMonitorV2
```

---

## 3. Einmalig einrichten

```powershell
copy .env.example .env
npm install
npm run setup
```

`npm run setup` spielt die **Struktur** ein (Feedback, Typen, Prompts, Checklisten) — ohne Bewertungen/Beobachtungen.

Falls du `setup` vergisst: Beim ersten Server-Start wird die Struktur automatisch nachgeladen, sobald die DB noch leer ist.

---

## 4. Starten

```powershell
npm run dev:all
```

Browser: **http://localhost:5174**

Beenden: `Strg+C` im Terminal.

---

## Optional: KI

Unter **Config → KI-Prompts** einen eigenen OpenRouter-API-Key eintragen (bleibt nur lokal im Browser).

---

## Probleme

| Symptom | Lösung |
|---|---|
| `node` nicht gefunden | Node 25+ installieren, neues Terminal |
| Port belegt | Anderes Programm auf 5174/4001 beenden — **nicht** auf 5173/4000 umbiegen |
| Keine Kriterien / leere Config | `npm run setup` nochmal |
| `npm install` fehlerhaft | Im Projektordner ausführen |

Mehr: `docs\TEAM_SETUP.md`