88 lines
2.0 KiB
Markdown
88 lines
2.0 KiB
Markdown
|
# 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`
|