CG-Feedback-Monitor/EINRICHTUNG.md
Lars d894c3c8e4 V2-Stand: UX-Dashboard, Personen v2, Starter-Paket und Dexie-Legacy entfernt.
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>
2026-09-16 14:17:25 +02:00

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 -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