Sichert den lokalen Entwicklungsstand nach Gitea: Nav/Dashboard, Personen-Excel/Archiv, Team-Setup, Assignment-Übergabe und C6/C7/T2. Co-authored-by: Cursor <cursoragent@cursor.com>
2.0 KiB
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:
node -v
2. Entpacken
z.B. nach C:\dev\AssigmentMonitorV2, dann:
cd C:\dev\AssigmentMonitorV2
3. Einmalig einrichten
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
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