Compare commits

...
11 Commits
Author SHA1 Message Date
LarsandCursor 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
LarsandCursor 234f87d408 V2-Dev-Stand: Skala 1-10, Benefits/Concerns, DEV-Isolation und Gitea-Doku.
Bündelt die Neuentwicklung in AssigmentMonitorV2 (eigene Ports/DB), die Umstellung auf numerische Bewertungen, Meeting-Checklisten, KI-Tagging und die geplante Feedback-Kaskade — als Basis für Versionsverwaltung in Gitea.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-08 17:35:05 +02:00
Lars 782678a1cf Verbesserung. Gesamtview, papierkorb Archiv 2026-07-13 12:45:35 +02:00
Lars 019c686254 Ki Prompts aktualisiert 2026-07-08 09:35:08 +02:00
Lars 1a1f3bb33f GenAI Anbindung 2026-07-07 11:14:00 +02:00
Lars 9c68c414d8 Update 2026-07-06 19:08:24 +02:00
LarsandClaude Sonnet 5 911dcace72 fix: N/A-Aggregationsbug behoben, FeedbackDraftPage migriert, toten Code entfernt
- buildAiPrompt (AssignmentFeedbackPage.tsx): 'na' wird jetzt korrekt aus dem
  Score-Mittelwert ausgeschlossen (war bislang als 0 mitgerechnet)
- FeedbackDraftPage.tsx auf feedbackCriterionItems/feedbackCategories migriert,
  letzter Konsument der Legacy-Tabellen außer den Seeds. Notizen hängen jetzt
  korrekt pro Kriterium über lineTags, statt ungefiltert an jedes Kriterium.
  Score-Anzeige nutzt RATING_OPTIONS-Labels statt rohem /5-Wert.
- FeedbackStructureConfig.tsx: verwaisten AssignmentType/PhaseTemplate-CRUD-Code
  entfernt (Funktionalität war bereits nach AssignmentTypeConfig.tsx verschoben)
- Doku aktualisiert: CLAUDE.md, docs/HANDOVER.md, docs/STATUS_UND_OFFENE_PUNKTE.md,
  docs/TECHNISCHE_ARCHITEKTUR.md

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 13:54:19 +02:00
Lars f47353dbe1 20260703_tagging von Zeilen und Verbindung 2026-07-03 11:56:22 +02:00
Lars f57db9d161 fix: Evaluation.tsx nach Assignment gruppiert, Papierkorb/Status gefiltert
- Oberste Gliederungsebene ist jetzt das Assignment, Institutees darunter
- Meeting-Filter: nur status='done', keine Papierkorb-Meetings (deletedAt)
- Migriert auf feedbackCriterionItems statt Legacy categories/criteria
- zustand aus package.json entfernt (ungenutzt)
2026-07-02 11:16:41 +02:00
Lars 63ca6583fa refactor: Evaluation.tsx auf feedbackCriterionItems migriert, zustand entfernt
- Liest jetzt feedbackDimensions/feedbackCategories/feedbackCriterionItems statt
  alter categories/criteria-Tabellen
- Korrekte 1-4 Rating-Skala mit RATING_OPTIONS-Labels
- Aggregation via RATING_NUM_MAP aus constants.ts
- zustand aus package.json entfernt (war nicht genutzt)
2026-07-02 10:58:44 +02:00
Lars 594a643068 refactor: MeetingView in 3 Dateien aufgeteilt (meeting/ Unterordner) 2026-07-02 10:30:46 +02:00
135 changed files with 18878 additions and 2438 deletions

No files matched your search

+16
View File
@@ -0,0 +1,16 @@
# Assignment Monitor V2 — lokale Entwicklungs-Isolation
# Kopie nach `.env` anlegen. Diese Werte dürfen NICHT mit dem Produktivsystem
# (c:\dev\AssigmentMonitor, Ports 5173/4000) kollidieren.
# Vite-Frontend (Produktiv: 5173)
PORT=5174
# Express-RPC-API (Produktiv: 4000)
API_PORT=4001
# Vite-Proxy-Ziel → muss zu API_PORT passen
API_URL=http://localhost:4001
# SQLite-Dateiname unter server/data/ (Produktiv: assignment-monitor.sqlite3)
# Nur Dateiname, kein Pfad — der Server erzwingt Ablage innerhalb dieses V2-Projekts.
SQLITE_FILENAME=assignment-monitor-v2-dev.sqlite3
+6
View File
@@ -11,6 +11,12 @@ dist-ssr/
# TypeScript build info
*.tsbuildinfo
# Lokale SQLite-Datenbank (enthält personenbezogene Daten, siehe CLAUDE.md → Datenschutz)
server/data/
# Versand-ZIPs (lokal erzeugt, nicht committen)
dist-release/
# Local environment / secrets
.env
.env.local
+178 -33
View File
@@ -2,25 +2,85 @@
Progressive Web App zur Live-Bewertung von Capgemini-Trainees (Institutees) während Kunden-Assignments.
**Vollständige Dokumentation:** `docs/` — bei neuer Session zuerst `docs/HANDOVER.md` lesen.
**Vollständige Dokumentation:** `docs/` — bei neuer Session zuerst `docs/HANDOVER.md` lesen; offene Punkte kanonisch: `docs/STATUS_UND_OFFENE_PUNKTE.md` (Stand 2026-08-16, inkl. C6/C7/T2 erledigt).
**DEV-Isolation:** Dieses Repo (`AssigmentMonitorV2`) ist von Produktiv (`c:\dev\AssigmentMonitor`) getrennt — Ports **5174/4001**, DB `assignment-monitor-v2-dev.sqlite3`. Regeln: `docs/DEV_ISOLATION.md`. Produktiv-Code und -Daten niemals anfassen.
---
## Stack
- React 18 + TypeScript + Vite (PWA)
- Tailwind CSS v4 — `@import "tailwindcss"` in CSS, **kein** `tailwind.config.js`
- Dexie.js v5 — IndexedDB-Wrapper, kein Backend
- React Router v6
- Capgemini-Brandfarbe: `#0070AD`
- **React 19** + TypeScript + Vite (PWA)
- Tailwind CSS v4 — `@import "tailwindcss"` in CSS, **kein** `tailwind.config.js`; Brandfarbe als `@theme { --color-brand }` in `src/index.css`
- **Lokaler Node/Express-Server + SQLite** (seit 2026-07-04) — löst Dexie/IndexedDB als primären Datenspeicher ab, siehe eigener Abschnitt unten
- **React Router 7** (`react-router-dom`)
- Capgemini-Brandfarbe: `#0070AD` (Tailwind-Klasse `brand`, JS-Konstante `BRAND_COLOR` in `src/config/constants.ts`)
- Bewertungsskala: **1–10** (`RatingScore`) — siehe `docs/SCALE_1_TO_10.md` (nicht mehr Client-Ready-Enum)
## Projektstruktur (Stand 2026-08; Erledigt-Historie unten weiter gültig)
```
src/
config/constants.ts ← RATING_SCORES, Score-Styles, AI_CONFIG, BRAND_COLOR, DEFAULT_RATING_TREND_WEIGHT_STEP, …
db/
index.ts ← Re-Export (types + queries)
types.ts ← alle Interfaces, RatingScore, AppSettings — von Client UND Server importiert
rpcClient.ts ← rpc(module, fn, ...args) — POST /api/rpc, einziger Netzwerk-Kontaktpunkt des Clients
queries/ ← Client-DB-Zugriffsschicht (siehe eigener Abschnitt unten)
pages/
meeting/ ← MeetingView.tsx, ConversationTab.tsx, AssessmentTab.tsx, CriterionTagPicker.tsx
RatingWeightConfig.tsx ← Settings-Tab für Zeitgewichtungs-Faktor (in Configuration.tsx eingebunden)
AssignmentTrash.tsx ← Papierkorb-Ansicht für Assignments (`/assignments/trash`), seit 2026-07-13
AssignmentArchive.tsx ← Archiv-Ansicht für Assignments (`/assignments/archive`), seit 2026-07-13
MeetingHistory.tsx ← Rein lesendes chronologisches Gesamtprotokoll aller Meetings eines Assignments (`/assignment/:id/history`), seit 2026-07-13
AiPromptConfig.tsx ← Settings-Tab „KI-Prompts" — ein editierbares Prompt-Template je Dimension, Default-Vorbelegung + Reset (in Configuration.tsx eingebunden, seit 2026-07-07)
...übrige Pages unverändert am alten Ort
utils/
ratingTrend.ts ← zeitgewichteter Bewertungs-Vorschlag + Trend-Erkennung + weightedAverageScore/weightedAverageRating (genutzt von Evaluation.tsx, AssignmentFeedbackPage.tsx, AssessmentTab.tsx, AssignmentDetail.tsx)
aiPrompt.ts ← Prompt-Engine für die KI-Feedback-Generierung (seit 2026-07-07): Platzhalter-Kontext pro Dimension, Rendering, Antwort-Parsing — siehe eigener Abschnitt „KI-Feedback-Generierung" unten
pdfExport.tsx ← PDF-Export (seit 2026-07-14, `@react-pdf/renderer`): Assignment-Report (Gesamtprotokoll + Feedback aller Institutees) und Einzel-Feedback-PDF pro Institutee
server/
index.ts ← Express-App, ein Endpunkt POST /api/rpc
database.ts ← node:sqlite-Verbindung (V2: assignment-monitor-v2-dev.sqlite3), Schema aus tableRegistry.ts, Pfad-Guards
rpcModules.ts ← Dispatch-Registry inkl. checklists, meetingCategoryRatings, assignmentTransfer, backup, …
db/
tableRegistry.ts ← EINE Quelle der Wahrheit: alle 26 Tabellen + Spalten + JSON-/Bool-Codecs (treibt Schema UND Backup)
crud.ts ← generische SQL-CRUD-Bausteine über die Registry
queries/ ← Server-Pendant zu src/db/queries/*.ts, gleiche Funktionsnamen, echtes SQL statt Dexie
scripts/verifyBackupRoundtrip.ts ← automatisierter Vollständigkeits-Beweis für Backup-Export/-Import
```
### Datenbank: lokaler Server statt IndexedDB (seit 2026-07-04)
Grund: Mehrere Browser auf demselben Laptop sollen dieselben Daten sehen. Browser können keine SQLite-Datei direkt öffnen, daher lokaler Node/Express-Server mit **`node:sqlite`** (**kein** `better-sqlite3`!). **V2-Defaults:** API Port **4001**, Vite **5174**, Proxy `/api` → `http://localhost:4001`, Datei `assignment-monitor-v2-dev.sqlite3`. (Produktiv bleibt 4000/5173 — nie vermischen, siehe `docs/DEV_ISOLATION.md`.)
**Abweichung vom ursprünglich gewählten Stack:** `better-sqlite3` scheiterte lokal an einer fehlenden/kaputten Python-Installation (node-gyp-Kompilierung). `node:sqlite` bietet dieselbe synchrone API (`DatabaseSync`, `.prepare().run()/.get()/.all()`), braucht keine native Kompilierung und ist ab dieser Node-Version (25.x) ohne Flag nutzbar (Node meldet es noch als "experimental" — rein informativ, funktioniert stabil). Falls auf einem anderen Rechner/Server `node:sqlite` fehlt (ältere Node-Version), wäre `better-sqlite3` dort nachzuholen, sofern eine funktionierende Build-Toolchain (Python + C++-Compiler) vorhanden ist.
**Spalten-Migration bei bestehenden Tabellen (seit 2026-07-07):** `database.ts` legt fehlende Tabellen per `CREATE TABLE IF NOT EXISTS` an — das migriert aber **nie** eine bereits existierende Tabelle. Wird `tableRegistry.ts` um eine neue Spalte einer bereits vorhandenen Tabelle ergänzt (z.B. `suggestedAchievements` auf `feedbackDimensionTexts`), gleicht `database.ts` das zusätzlich per `PRAGMA table_info` ab und zieht fehlende Spalten per `ALTER TABLE ... ADD COLUMN` automatisch nach. Ohne das bleibt die alte Spaltenmenge bestehen und jeder Zugriff auf die neue Spalte scheitert erst zur Laufzeit mit „no column named ..." — genau das ist beim Einführen des KI-Prompt-Systems passiert und wurde dabei gefixt.
**RPC statt REST:** Ein einziger Endpunkt `POST /api/rpc` mit Body `{ module, fn, args }` statt ~80 einzelnen Routen — Client (`src/db/rpcClient.ts`) und Server (`server/rpcModules.ts`) sind darüber 1:1 gekoppelt: jede Funktion aus `src/db/queries/*.ts` hat ein gleichnamiges Pendant in `server/db/queries/*.ts`.
**Dexie/IndexedDB-Legacy entfernt (2026-08-16):** `dexie`-Dependency, `src/db/schema.ts` und `src/db/seeds/` sind weg. Primärspeicher bleibt Express + `node:sqlite`; Struktur-Seed über Starter/`npm run setup`.
**Backup ist server-seitig** über `tableRegistry`. Zusätzlich: **Starter-Paket** (nur Struktur, `docs/starter/`, `npm run setup`) und **Assignment-Transfer** (ein Assignment inkl. Berater/Notizen/Checklisten, Merge-Import — `assignmentTransfer`).
### DB-Zugriffsschicht (`src/db/queries/`, seit 2026-07-04, intern auf RPC umgestellt)
Module u.a.: `appSettings`, `consultants`, `assignmentTypes`, `assignments`, `feedbackStructure` (`resolveVisibleStructure`/`filterVisibleFeedbackStructure`), `meetings` (`listDoneMeetingsChronological`, `getMeetingExportData`), `conversationEntries`, `assessments`, `assignmentFeedback`, `meetingCategoryRatings`, `checklists`, `criterionSuggestions`, **`assignmentTransfer`**.
## Entwicklung
```bash
npm run dev # Dev-Server starten
npx tsc --noEmit # TypeScript-Check — muss vor jeder Abgabe fehlerfrei sein
npm run dev:all # Frontend :5174 + Server :4001
npm run setup # Starter-Struktur einspielen (Feedback/Typen/Prompts/Checklisten-Defs)
npm run pack:zip # Team-ZIP → dist-release/ (ohne DB)
npm run pack:laptop # Umzug: Code + volle Dev-DB → dist-release/
npm run starter:export
npx tsc -b # TypeScript — muss vor jeder Abgabe fehlerfrei sein
```
**Wichtig:** `npx tsc --noEmit` am Root prüft **nichts** (0 Dateien, `tsc --noEmit --listFiles` bestätigt das) — der Root-`tsconfig.json` hat `"files": []` und nur `references`. Ohne `-b` (Build-Modus) werden referenzierte Projekte nicht ausgewertet. Der bisher in diesem Dokument dokumentierte Workflow `npx tsc --noEmit` war dadurch vermutlich seit Einführung der Project References ein stiller No-Op — **immer `npx tsc -b` verwenden.**
---
## Kritische Eigenheiten
@@ -28,31 +88,26 @@ npx tsc --noEmit # TypeScript-Check — muss vor jeder Abgabe fehlerfrei sei
### Doppelte `criteriaId`-Semantik
```
Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung)
ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung)
Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung)
ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung pro Protokoll-Eintrag)
ConversationLineTag.criterionItemId → FeedbackCriterionItem.id (Kriterium-Zuordnung einer einzelnen Zeile innerhalb eines ConversationEntry.note-Blocks, seit 2026-07-02 — bewusst anders benannt als "criteriaId" um obige Verwechslungsgefahr nicht fortzuschreiben)
```
### AssignmentType.criteriaIds
Referenziert `FeedbackCriterionItem.id[]`. Leer = alle Kriterien anzeigen.
Filterlogik (immer so anwenden):
```typescript
const itemFilter = aType?.criteriaIds?.length ? new Set(aType.criteriaIds) : null
const filteredItems = itemFilter ? allItems.filter(i => itemFilter.has(i.id!)) : allItems
const visibleCatIds = new Set(filteredItems.map(i => i.categoryId))
const filteredCats = itemFilter ? allCats.filter(c => visibleCatIds.has(c.id!)) : allCats
```
Filterlogik: `filterVisibleFeedbackStructure(allCategories, allItems, criteriaIds)` in `src/db/queries/feedbackStructure.ts` — seit dem `db/queries/`-Refactoring (2026-07-04) die einzige Implementierung, vorher identisch dupliziert in `MeetingView.tsx` und `AssignmentDetail.tsx`. Nicht erneut inline schreiben.
### Rating-Skala
```typescript
type FeedbackRating = 'na' | 'not_client_ready' | 'partially_client_ready' | 'nearly_client_ready' | 'client_ready'
// Numerisch: na=0, not=1, partially=2, nearly=3, fully=4
// N/A gilt als "nicht gesetzt" — aus allen Berechnungen ausschließen!
type RatingScore = number // 1–10; unset = null — siehe docs/SCALE_1_TO_10.md
// Farbbänder in appSettings.ratingColorBands / Config → Skala
// N/A-String-Enum (not_client_ready …) ist abgelöst — nicht neu einführen
```
Aggregation: gewichteter Durchschnitt → `avg < 1.5` Not · `< 2.5` Partially · `< 3.5` Nearly · `≥ 3.5` Fully
Aggregation: gewichteter Durchschnitt über `weightedAverageScore`/`weightedAverageRating` in `ratingTrend.ts` — bei `Σweight === 0` null.
### Routing
@@ -66,7 +121,16 @@ MeetingView liest: `const { id, meetingId: meetingIdParam } = useParams()`
- `MeetingInstance.generalNotes` kann `undefined` sein → immer `?? ''` als Fallback
- `PhaseKey` ist `string`, kein Union-Typ
- Tailwind v4: arbitrary values `bg-[#0070AD]` direkt im className — kein Config nötig
- Tailwind v4: Brandfarbe ist `brand` (Tailwind-Klasse, via `@theme` in `index.css`) — **kein** `bg-[#0070AD]` mehr neu schreiben
- Auswertungslogik greift auf **zwei komplett unabhängige Bewertungs-Strukturen** zu, die nicht automatisch synchron sind:
- `Assessment` (Tabelle `assessments`) — pro Meeting erfasste Kriterium-Bewertungen, Basis für `/evaluation`
- `FeedbackCategoryRating` — ausschließlich manuell auf `AssignmentFeedbackPage` gesetzt, unabhängig von Meeting-Daten, Basis für das finale Abschluss-Feedback
- Seit 2026-07-02: `src/utils/ratingTrend.ts` berechnet aus den `Assessment`-Daten einen **zeitgewichteten Vorschlag** pro Kategorie (spätere Meetings zählen stärker, Gewichtungsfaktor konfigurierbar unter Config → Gewichtung) inkl. Trend-Erkennung (Verbesserung/Verschlechterung). Der Vorschlag wird auf `AssignmentFeedbackPage` als Badge angezeigt und bleibt frei überschreibbar — die zwei Strukturen bleiben bewusst getrennt.
- Meeting-Filter bei Aggregationen über mehrere Meetings: immer `!m.deletedAt && m.status === 'done'` — sonst fließen Papierkorb-/unfertige Meetings mit ein
- **Weichmacher/Füllwörter in Formulierungen** (z.B. "ein bisschen") werden bewusst **nicht** über eine eigene Text-Erkennungslogik behandelt — stattdessen legt man dafür ein eigenes, niedrig gewichtetes Kriterium an (z.B. "Sprachliche Präzision", Gewicht < 1) und taggt/notiert entsprechende Zeilen ganz normal (meist mit `(!)`). Die bestehende Tagging- + Notation-Vorschlag-Mechanik deckt das automatisch ab.
- Der `äh`-Zähler (`ConversationEntry.fillerCount`) bleibt bewusst **rein informativ** — keine automatische Schwellenwert-Bewertung. Würde eine eigene Design-Entscheidung brauchen (ab wann gilt die Zahl als "zu hoch"), aktuell reicht die reine Anzeige als Grundlage für die manuelle Bewertung.
- **Cross-Boundary-Imports von `src/` nach `server/`**: Dateien, die (wie `src/db/types.ts`) sowohl vom Client als auch vom Server importiert werden, müssen frei von Laufzeit-Abhängigkeiten auf Browser-Only-Code sein — auch `import type` reicht nicht als Schutz, wenn die importierte Datei selbst wieder aus dem `'../db'`-Barrel importiert (der zieht `rpcClient` mit, siehe `src/config/constants.ts`-Fix vom 2026-07-07: Import auf `'../db/types'` direkt umgestellt). Jede neue Datei dieser Art muss zusätzlich explizit in `tsconfig.server.json`s `include` aufgenommen werden (sonst „File is not listed within the file list of project" bzw. sie wird stillschweigend nicht mitkompiliert) — Muster: `src/db/types.ts`, `src/config/constants.ts`.
- `ConversationEntry` entspricht weiterhin **einem ganzen Sprecher-Turn** (ein zusammenhängender, mehrzeiliger Text-Block bis "✓ Schließen") — bewusst so belassen, ein Zwischenstand mit "ein Entry pro Zeile" wurde am 2026-07-02 wieder verworfen, weil er die Lesbarkeit des Protokolls zerstört hat. Kriterium-Zuordnung passiert stattdessen **pro Zeile innerhalb** eines Entry über `ConversationEntry.lineTags` (Matching per exaktem Zeilentext, nicht per Index — robust gegenüber nachträglichem Einfügen/Löschen von Zeilen). Zeilen splitten immer über `splitNoteLines()` in `src/utils/notationParser.tsx`, nicht erneut `note.split('\n')` inline schreiben (sonst laufen Trim-/Filter-Verhalten auseinander).
---
@@ -74,28 +138,109 @@ MeetingView liest: `const { id, meetingId: meetingIdParam } = useParams()`
- **Keine Kommentare** außer für nicht-offensichtliche Invarianten (kein „Was", nur „Warum")
- **Keine Auto-Resize-Textarea via `rows={1}` + JS** — stattdessen View/Edit-Toggle oder `fieldSizing: 'content'` als Inline-Style
- **`RATING_OPTIONS`-Array** nicht neu definieren — immer aus dem bestehenden Array in der jeweiligen Datei verwenden
- **Score-UI** über `ScorePicker` / `RATING_SCORES` / `resolveScoreStyle` — keine alten Enum-`RATING_OPTIONS` neu erfinden
- Gewichtete Mittel immer über `weightedAverageScore`/`weightedAverageRating` in `ratingTrend.ts`
- **Kein `useEffect` für DB-Calls** außer bei initialem Load — lieber direkte `async`-Funktionen
---
## Offene Punkte (priorisiert)
| Prio | Aufgabe | Datei |
|---|---|---|
| M | `Evaluation.tsx` auf neue Datenstruktur migrieren | `src/pages/Evaluation.tsx` |
| M | AI-Prompt auf `feedbackCriterionItems` umstellen | `src/pages/AssignmentFeedbackPage.tsx` |
| M | `meetingExport.ts` — Kriterien-Auflösung anpassen | `src/utils/meetingExport.ts` |
| N | Dashboard: Assignment-Nummer anzeigen | `src/pages/Dashboard.tsx` |
| N | AssignmentCreate: Feld für Assignment-Nummer | `src/pages/AssignmentCreate.tsx` |
| N | Toter Code in FeedbackStructureConfig entfernen | `src/pages/FeedbackStructureConfig.tsx` |
| L | SQLite WASM + OPFS Migration (kein festes Datum) | `src/db/index.ts` |
**Kanonisch und aktuell:** `docs/STATUS_UND_OFFENE_PUNKTE.md` (2026-08-16). Kurz:
| Prio | Aufgabe |
|---|---|
| H | **UX.3** Dashboard · **UX.4** Meeting-Live-UX |
| M | UX.5–UX.8; **T4** Cascade Smoke; **T1** npm-Audit; **T5** Legacy; **T3** Backup-Reminder; **T6** Datenschutz |
| L | Create-Enrollments, Assignment-Nr. in URL |
| — | **C0/C6/C7/T2/UX.1–UX.2** + Cascade 1–3/1b: **erledigt** |
**Erledigt (2026-08-16):** C0 Skala-Smoke, C6 Tagging-Batches, C7 KI-Client, T2 Dexie-Legacy, UX.1 Design-Tokens + UX.2 App-Chrome (`index.css`, `App.tsx`, Source Sans 3).
**Erledigt (2026-07-19): Live-Formulierungshilfe, Beobachter-Fokus, Meeting-Checkliste umgesetzt** (Konzept siehe Eintrag unten, dort auch die Design-Begründungen). Neue Dateien: `src/utils/criterionOptions.tsx` (aus `FeedbackStructureConfig.tsx` extrahiertes `criterionOptionGroups()`, jetzt auch von `AssignmentTypeConfig.tsx` genutzt), `server/db/queries/checklists.ts` + `src/db/queries/checklists.ts` (neues RPC-Modul `checklists`), `src/pages/meeting/ChecklistTab.tsx` (neuer dritter Meeting-Tab, nur sichtbar wenn `PhaseTemplate.hasChecklist`). `AssignmentTypeConfig.tsx` bekam pro Phase eine „Checkliste"-Checkbox + aufklappbaren Punkte-Editor (Label, Scope-Auswahl, bei `perInstitutee` optionales Kriterium-Dropdown). `deletePhaseTemplate`/`deleteAssignmentType` cascaden jetzt zusätzlich über `checklistItemDefs` (gleiches Verteidigungsprinzip wie bei `deleteFeedbackCriterionItem`). Live-Formulierungshilfe: neuer State `corpus` in `MeetingView.tsx` (einmal pro Meeting-Load geholt, nicht pro Tastendruck), debounced (~800ms) Aufruf von `findSimilarTaggedLines()` sowohl in `ConversationTab.tsx` (aktive Notiz) als auch für die allgemeinen Notizen — rein lesendes „💭 Ähnliche frühere Notizen"-Panel. Fokus-Übersicht als neue aufklappbare „📊 Fokus-Übersicht"-Box in `FeedbackStructureConfig.tsx` (Top 5 Kriterien nach `getCriterionUsageMap()`-Verwendung, inkl. `learnedPatternHints` als Kontext). Verifiziert: `npx tsc -b` fehlerfrei (dabei einen fehlenden `hasChecklist`-Wert im toten Dexie-Seed-Code `src/db/seeds/assignmentTypes.ts` nachgezogen, da dieser weiterhin vom Client-Build mitkompiliert wird); neue RPC-Endpunkte (`checklists.listChecklistItemDefsForPhaseTemplate`, `assignmentTypes.listPhaseTemplates`) direkt gegen die laufende Dev-Instanz getestet — Schema-Migration (neue Spalte `hasChecklist`, neue Tabellen `checklistItemDefs`/`checklistResponses`) griff automatisch ohne manuellen Server-Neustart. Manueller Ausfüll-Test einer Checkliste in einem echten Meeting (inkl. Prüfung, dass verknüpfte Punkte korrekt in `Assessment` landen) steht noch aus.
**Nachtrag (2026-07-19, nach erstem echten Nutzungstest):** Drei Korrekturen an der Checkliste, nachdem sich die ursprüngliche Einschränkung in der Praxis als zu eng erwies:
1. **Kriterium-Verknüpfung jetzt für beide Scopes möglich** (vorher nur `perInstitutee`). Bei `scope: meetingWide` + verknüpft schreibt `MeetingView.tsx::saveChecklistResponse` dieselbe Bewertung/Notiz per Fan-out in `Assessment` **für jeden aktuellen Institutee gleichzeitig** — ein meeting-weiter Checkpunkt gilt für alle Beteiligten gleichermaßen. Löst das ursprüngliche Problem („`Assessment` verlangt `instituteeId`") durch Duplizieren statt durch Ausschluss.
2. **`ChecklistResponse` ist jetzt immer die Quelle für die Checkliste-UI selbst**, unabhängig von Kriterium-Verknüpfung (vorher las/schrieb die UI bei verknüpften Punkten direkt `Assessment`, was zu einem unsauberen Round-Trip führte, sobald die Notiz auch das Checklisten-Label enthalten sollte). Bei Verknüpfung spiegelt `saveChecklistResponse()` zusätzlich **einseitig** (Checkliste → Assessment, nie zurück) nach `Assessment`, inkl. komponierter Notiz `Checkliste „<Label>" (<Bewertung>): <Kommentar>` über `composeChecklistNote()` — dadurch landet der Checkpunkt-Name selbst (nicht nur der freie Kommentar) in `aiPrompt.ts::kriterienScores`, das `Assessment.note` bereits einsammelt; kein Änderung an `aiPrompt.ts` nötig. Bekannte Einschränkung: Wird dasselbe Kriterium zusätzlich direkt über den (weiterhin vorhandenen) Gesamtbewertungs-Tab bearbeitet, gewinnt der jeweils letzte Schreibzugriff — gleiches Verhalten wie beim bestehenden „Aus Protokoll"-Button, keine neue Fehlerklasse.
3. **Keine eigene Checkliste-Tab-Karte mehr** — `ChecklistTab` wird jetzt direkt oberhalb der Gesprächs-Zeitleiste innerhalb des Gesprächsprotokoll-Tabs gerendert (`tab === 'conversation'`), nicht mehr über einen separaten dritten Tab. Der Tab-Button „Gesprächsprotokoll" erscheint entsprechend schon bei `hasConv || hasChecklist`, damit auch reine Checklisten-Phasen (ohne Protokoll-Funktion) eine Heimat haben.
**Sechster Nachtrag (2026-07-20): Bug + fehlende Diagnose bei „Vorschläge analysieren" behoben.** Nutzer meldete: Aufruf lieferte keine Vorschläge, ohne jede Rückmeldung, was schiefläuft. Zwei Ursachen gefunden und behoben (`MeetingView.tsx::analyzeSuggestions`):
1. **Bug:** Checklisten-Punkte ohne effektives Kriterium wurden nur analysiert, wenn bereits ein Kommentar eingetragen war (`if (!comment) continue`) — reine Bewertungen ohne Freitext fielen dadurch komplett aus der Analyse heraus, obwohl der Checklisten-Punkt-Name (Label) selbst schon ein brauchbares Signal für die KI ist. Jetzt wird bei fehlendem Kommentar das Label allein als Text übergeben (`comment ? \`${ci.label}: ${comment}\` : ci.label`).
2. **Fehlende Diagnose:** Sowohl das stille `return` bei `lineRefs.length === 0` (nichts zu analysieren) als auch der Fall „KI hat für keine Zeile/keinen Punkt einen Vorschlag geliefert" gaben bisher keinerlei Rückmeldung. Neu: `suggestionInfo`-Statuszeile (blau, neben dem bestehenden roten Fehlerbanner) mit Zählung „X Zeile(n)/Punkt(e) analysiert, Y Vorschläge erhalten" sowie ein aufklappbares „🔍 Rohantwort ansehen"-Panel (`lastAnalysisRaw`), das die komplette, ungeparste KI-Antwort zeigt — macht Format-/Parsing-Probleme künftig direkt sichtbar statt raten zu müssen.
**Fünfter Nachtrag (2026-07-20): Checkliste in allen Export-/Berichts-Pfaden nachgezogen.** Bei der Prüfung stellte sich heraus, dass sämtliche bestehenden Export-/Berichtsfunktionen die Checkliste komplett ignorierten (vor Einführung der Checkliste geschrieben, nicht mitgepflegt). Nachgezogen:
- `server/db/queries/meetings.ts::getMeetingExportData()` liefert jetzt zusätzlich `checklistItems`/`checklistResponses` (nur wenn `template.hasChecklist`) — einzige Datenquelle für Meeting-Export, dadurch automatisch in MD/JSON verfügbar.
- Neue Bulk-Funktionen `listChecklistItemDefsForPhaseTemplates()`/`listChecklistResponsesForMeetings()` (Server + Client) analog zu `listAssessmentsForMeetings()` — für Berichte über mehrere Meetings/Phasentypen hinweg (`MeetingHistory.tsx`, Assignment-Report-PDF), vermeidet N+1-Abfragen.
- `src/utils/meetingExport.ts` (Markdown + JSON), `src/utils/pdfExport.tsx::AssignmentReportDocument` (PDF) und `src/pages/MeetingHistory.tsx` (Gesamtprotokoll-Ansicht) zeigen die Checkliste jetzt jeweils in derselben Position (nach dem Gesprächsprotokoll, vor der Gesamtbewertung) — Label, effektives Kriterium (individuelle Zuordnung > Konfigurations-Vorgabe, gleiche Auflösung wie in `MeetingView.tsx`), Bewertung, Kommentar.
- `src/utils/structureExport.ts` (Markdown) und `pdfExport.tsx::AssignmentTypesDocument` (PDF) — der Assignment-Typen-Bericht listet jetzt pro Phase zusätzlich `hasChecklist` und die konfigurierten Checklisten-Punkte (inkl. Scope und ggf. verknüpftem Kriterium), analog zum bereits bestehenden Kriterien-Mapping.
- Bewusst nicht angefasst: `AssignmentDetail.tsx`s Chip-Reihe (nur Rating-Aggregation, kein direkter Bezug zur Checkliste) — wäre ein separates, kleines UI-Ergänzung, kein Export/Bericht im eigentlichen Sinn.
**Vierter Nachtrag (2026-07-19): „Vorschläge analysieren" + Kriterium-Vorschläge jetzt auch für die Checkliste, individuelle Zuordnung pro Antwort.** Bisher war die Kriterium-Verknüpfung eines Checklisten-Punkts ausschließlich in der Config fix hinterlegt (`ChecklistItemDef.linkedCriterionItemId`) und für „🏷 Vorschläge analysieren" unsichtbar. Neu:
- **`ChecklistResponse.criterionItemId`** (neue, automatisch migrierte Spalte) überschreibt pro Antwort individuell die Konfigurations-Vorgabe — `getEffectiveChecklistCriterion()` in `MeetingView.tsx` liefert `response.criterionItemId ?? ci.linkedCriterionItemId ?? null`. Zuordnung direkt in `ChecklistTab.tsx` über denselben `CriterionTagPicker` wie im Protokoll (Chip + Popover, inkl. Suche und Vorschlägen) — keine separate Komponente nötig.
- **`analyzeSuggestions()` bezieht jetzt auch Checklisten-Kommentare ein:** Antworten ohne effektives Kriterium (weder individuell noch konfiguriert) mit vorhandenem Kommentar werden mit `${Label}: ${Kommentar}` als zusätzliche Zeile in denselben gebündelten KI-Call eingespeist wie Protokoll-/Notizzeilen. Da Checklisten-Antworten nicht textbasiert (wie `lineTags`) adressierbar sind, führt ein neuer optionaler `checklistKey`-Marker (`${checklistItemId}:${instituteeId ?? ''}`) am `LineRef` das Routing der KI-Antwort in eine eigene Map `checklistSuggestions` statt in die text-basierte `lineSuggestions`-Map.
- **Lokale (KI-freie) Checklisten-Vorschläge** analog zu `localLineSuggestions`: neuer `useMemo` `localChecklistSuggestions` wendet `findSimilarTaggedLines()` auf den Kommentartext jeder unzugeordneten Antwort an (Schwelle ≥ 0,25) — sofort verfügbar, ohne „Vorschläge analysieren" auszulösen. Merge mit den KI-Vorschlägen (`mergedChecklistSuggestions`, KI hat Vorrang) liefert `getChecklistSuggestions()`, das `ChecklistTab.tsx` genau wie im Protokoll als 💡-Chip im `CriterionTagPicker` anzeigt.
- **Mirroring nach `Assessment`** nutzt jetzt konsequent das *effektive* Kriterium (individuell > konfiguriert) statt nur `ci.linkedCriterionItemId`. Wechselt die individuelle Zuordnung nachträglich auf ein anderes Kriterium, bleibt ein bereits gespiegelter `Assessment`-Eintrag beim alten Kriterium bewusst unangetastet (keine rückwirkende Korrektur/Löschung) — gleiches einfaches Prinzip wie beim Löschen eines Checklisten-Punkts.
**Dritter Nachtrag (2026-07-19): Direkte Kriterien-Vorschläge ohne KI.** Zwei Ergänzungen zur Live-Formulierungshilfe, beide ohne KI-Call: (1) Das „💭 Ähnliche frühere Notizen"-Panel (`ConversationTab.tsx`/`MeetingView.tsx`) zeigt jetzt zusätzlich das Kriterium der jeweiligen Alt-Zeile an (`„Text" → 🏷 Kriterium`), aufgelöst aus dem bereits vorhandenen `criterionItemId` in `SimilarTaggedLine` — reine Zusatzinfo, keine neue Berechnung nötig. (2) Neuer `useMemo` `localLineSuggestions` in `MeetingView.tsx`: berechnet für **alle** noch nicht zugeordneten Zeilen (Gesprächsbeiträge + allgemeine Notizen, gleiche Sammel-/Ausschlusslogik wie `analyzeSuggestions`) lokale Kriterium-Vorschläge über `findSimilarTaggedLines()`, gefiltert auf Ähnlichkeit ≥ 0,25 („mittel", gleiche Schwelle wie in `criterionSuggestionPrompt.ts`) — macht den 💡-Vorschlags-Chip im `CriterionTagPicker` **sofort verfügbar, ohne „🏷 Vorschläge analysieren" auszulösen**. Wird mit den KI-Vorschlägen (`lineSuggestions`) zu `mergedLineSuggestions` zusammengeführt — KI-Vorschläge haben Vorrang, wenn für dieselbe Zeile beides vorliegt (`lineSuggestions`-Einträge überschreiben `localLineSuggestions` beim Merge). Geprüft und bestätigt: „🏷 Vorschläge analysieren" überschreibt nie eine bereits bestehende Zuordnung — `analyzeSuggestions` schließt bereits getaggte Zeilen von vornherein von der KI-Anfrage aus (`taggedTexts.has(line)`-Filter), und `CriterionTagPicker` zeigt bei vorhandener Zuordnung ohnehin immer den Tag-Chip statt des Vorschlags-Chips (Vorschläge sind nur bei leerer Zuordnung überhaupt sichtbar).
**Zweiter Nachtrag (2026-07-19):** Zwei UI-Korrekturen nach echtem Nutzungsfeedback. (1) `ChecklistTab.tsx` nahm zu viel Bildschirmplatz ein (eine Karte mit großen Buttons + immer sichtbarem Kommentarfeld pro Institutee/Punkt) — umgebaut auf Zeilen-Darstellung: `<select>` statt fünf breiter Bewertungs-Buttons, Kommentar nur über ein 💬-Icon ausklappbar (Icon zeigt blau eingefärbt an, wenn bereits ein Kommentar hinterlegt ist). (2) Die Live-Formulierungshilfe (`💭 Ähnliche frühere Notizen`, `ConversationTab.tsx` + `MeetingView.tsx`) zeigte Vorschläge bisher nur rein lesend an — jetzt per Klick übernehmbar, ersetzt dabei die gerade getippte (letzte) Zeile der Notiz. Wichtige Falle dabei: In `MeetingView.tsx` hätte ein reiner Klick auf den Vorschlag zuerst den `onBlur`-Handler der Notizen-Textarea ausgelöst (`finishEditingGeneralNotes()`, beendet den Editier-Modus und entfernt damit Textarea+Vorschlagsliste aus dem DOM, bevor der Klick verarbeitet wird) — behoben über `onMouseDown={e => e.preventDefault()}` auf den Vorschlags-Buttons, verhindert den Fokuswechsel/Blur überhaupt erst (gleiches Muster wie `stopPropagation` beim `CriterionTagPicker` in den allgemeinen Notizen, nur mit `preventDefault` statt `stopPropagation`, da hier kein Klick-Bubbling sondern der native Blur-vor-Click-Ablauf das Problem ist).
**Konzept (2026-07-18): Live-Formulierungshilfe, Beobachter-Fokus, Meeting-Checkliste.** Zwei unabhängige Erweiterungen, in einer Design-Session gemeinsam geprüft:
- **Live-Formulierungshilfe (kein KI-Call):** Während des Tippens in `ConversationTab.tsx`/allgemeinen Notizen liefert ein debounced Aufruf der bereits bestehenden `findSimilarTaggedLines()` (`src/utils/criterionSuggestion.ts`) ein rein lesendes Referenz-Panel „Ähnliche frühere Notizen" — bewusst **kein** Autocomplete/Text-Einfügung (würde die 2026-07-02 getroffene „nicht live während des Tippens"-Entscheidung für die Zuordnung unterlaufen; hier geht es nur um unverbindliche Formulierungs-Inspiration, kein Eingriff in den Text). Kein neues Backend nötig.
- **Beobachter-Fokus (global, keine Bewerter-Identität nötig):** Die App hat kein Login-/Nutzerkonzept — „was wird typischerweise fokussiert" bezieht sich daher bewusst auf alle Bewerter zusammen. Leistet im Kern bereits `learnedPatternHints` (Wie wird formuliert) + `getCriterionUsageMap()` (Was wird häufig kommentiert, bereits für die Config→Feedback-Verwendungs-Badges gebaut). Nur eine neue, rein lesende Anzeige nötig, kein neues Datenmodell.
- **Meeting-Checkliste pro Phasentyp:** Neues Feld `PhaseTemplate.hasChecklist` (Opt-in wie `hasConversation`/`hasAssessment`) + neue Tabelle `ChecklistItemDef` (`phaseTemplateId`, `label`, `order`, optional `linkedCriterionItemId`, `scope: 'perInstitutee' | 'meetingWide'` — pro Eintrag konfigurierbar). Wichtiger Fund: `PhaseTemplate.criteriaIds` existiert zwar schon, wird aber aktuell nirgends live im Meeting ausgewertet (nur für `getCriterionUsageMap`-Zählung) — bewusst NICHT für die Checkliste umgewidmet, da es bereits eine andere, etablierte Sichtbarkeits-Scoping-Semantik hat. Antwort-Ablage maximiert Wiederverwendung bestehender Strukturen statt einer vierten Bewertungs-Struktur: „pro Institutee + verknüpft" → direkt in `Assessment` (bestehende Funktionen); „meeting-weit + verknüpft" → direkt in `MeetingInstance.generalNoteTags` (bestehender, institutee-unabhängiger Mechanismus); nur „frei definiert" (verknüpft oder nicht, jeweils pro Institutee oder meeting-weit) braucht die einzige wirklich neue Tabelle `ChecklistResponse` (`meetingInstanceId`, `instituteeId?`, `checklistItemId`, `rating`, `note`) — bewusst **ohne** Aggregation in Evaluation/gewichteten Durchschnitt (reine lokale Meeting-Notiz, vermeidet eine dritte manuell synchron zu haltende Bewertungsstruktur neben Assessment/FeedbackCategoryRating). UI: neuer optionaler Tab „Checkliste" in `MeetingView.tsx`, Konfiguration als neuer Sub-Tab in `AssignmentTypeConfig.tsx`, Kriterium-Verknüpfung über das bestehende `criterionOptionGroups()`-Dropdown-Muster aus `FeedbackStructureConfig.tsx`. **Präzisiert bei der Umsetzungsplanung (gleicher Tag):** „meeting-weit + verknüpft" hat keine saubere Heimat (`Assessment` verlangt zwingend `instituteeId` — Kriterien sind in diesem Modell immer Personen-Kompetenzen, nie Meeting-Kollektiv-Eigenschaften; `generalNoteTags` kennt keine Bewertungsstufe, nur Text+Tag). Deshalb: Kriterium-Verknüpfung ist nur bei `scope: perInstitutee` möglich, `scope: meetingWide`-Punkte sind immer „frei" (kein Kriterium-Dropdown im UI). Vereinfacht die Ablage auf 3 statt 4 Fälle, siehe Umsetzungsplan.
**Konzept (2026-07-16, noch nicht umgesetzt): Selbstlernendes Kriterien-Tagging.** Löst den Offene-Punkte-Eintrag „Selbstlernendes Tagging" oben ab (bisher nur Idee, jetzt fertig gescoped in einer eigenen Design-Session, siehe Vorgabe oben). Ziel: eine priorisierte, KI-gestützte Vorschlagsliste für die Kriterium-Zuordnung noch nicht getaggter Protokollzeilen, direkt im `CriterionTagPicker` aufrufbar. Kernentscheidungen:
- **Kein neues Datenmodell für den Lernkorpus.** Die Lernbasis ist der bereits bestehende `lineTags`/`generalNoteTags`-Bestand, global über alle Assignments hinweg (siehe `getCriterionUsageMap()`/`getCriterionUsageDetails()` in `server/db/queries/feedbackStructure.ts`). Jede neu vergebene Zuordnung vergrößert den Korpus automatisch — kein separater Trainingsschritt, keine Migration nötig.
- **Zweistufiger Ablauf.** (1) Rein lokale Ähnlichkeitssuche ohne KI-Call (Wortüberschneidung/Jaccard über normalisierten Zeilentext; `parseNotationPrefix()`/`splitNoteLines()` zur Normalisierung wiederverwendet) liefert pro noch nicht zugeordneter Zeile ~5–8 ähnlichste Alt-Beispiele als Kontext-Hinweis. (2) EIN gebündelter KI-Call pro Protokoll-Ansicht (nicht pro Zeile) analysiert alle noch nicht zugeordneten Zeilen des gesamten offenen Protokolls auf einmal und liefert pro Zeile eine priorisierte Kandidatenliste (Kriterium-IDs) statt nur eines Einzelvorschlags. Fallback auf Einzel-Zeilen-Calls ist vorgesehen, aber erst nach einem ersten Testlauf zu entscheiden, falls die Bündelung qualitativ nicht ausreicht — nicht vorab bauen.
- **Expliziter Trigger-Button** („🏷 Vorschläge analysieren"), kein automatischer Call beim Öffnen des Meetings — gleiches Muster wie die bestehende KI-Feedback-Generierung (keine versteckten API-Kosten/Latenz im Hintergrund).
- **Neuer Platzhalter `{{KRITERIEN_STRUKTUR}}`** für den Tagging-Prompt: vollständige, ID-referenzierte Struktur Dimension → Kategorie (Name+Beschreibung) → Kriterium (Name+Beschreibung), gefiltert über die bestehende `filterVisibleFeedbackStructure()` anhand `AssignmentType.criteriaIds` — dieselbe Filterlogik wie überall sonst im Projekt, nicht neu implementiert. Kriterien werden über ihre ID referenziert statt über den Namen (robust gegen Namenskollisionen beim Parsen der KI-Antwort). `FeedbackDimension` hat aktuell kein `description`-Feld (anders als Kategorie/Kriterium) — „alle Erklärungsebenen" bezieht sich daher auf Dimension-Name + Kategorie-Name/Beschreibung + Kriterium-Name/Beschreibung. Weitere neue Platzhalter: `{{ASSIGNMENT_TYP}}`, `{{PROTOKOLL_ZEILEN}}` (nummerierte, noch nicht zugeordnete Zeilen des gesamten Protokolls), `{{AEHNLICHE_ALT_ZUORDNUNGEN}}` (Ergebnis aus Schritt 1).
- **EIN gemeinsames Prompt-Template statt eines pro Assignment-Typ** — die Typ-Abhängigkeit steckt im Inhalt von `{{KRITERIEN_STRUKTUR}}`, nicht in der Anzahl der Templates (gleiches Prinzip wie `{{KATEGORIEN_STRUKTUR}}` heute schon). Persistiert als neues Feld `AppSettings.criterionTaggingPromptTemplate` (automatische Spalten-Migration wie gehabt), editierbar in einem neuen, eigenen Abschnitt in `AiPromptConfig.tsx` („KI-Prompt: Kriterien-Zuordnungsvorschläge") — gleiches Aufklapp-Textarea-Muster + eigene Platzhalter-Legende wie der bestehende Standard-Prompt-Bereich. Kein Eintrag pro Dimension nötig, da es nur eine Protokoll-weite Analyse gibt, nicht pro Dimension.
- **Antwortformat:** Zeilennummer + priorisierte Kriterium-ID-Liste als Klartext-Marker (`ZEILE 3: 12, 47, 5`, `-` bei keinem Vorschlag) statt JSON — bewusst gleiches Prinzip wie `parseDimensionAiResponse` (JSON/Codefence-Parsing-Bugs waren 2026-07-07 der Grund für die Umstellung auf Marker-Text dort). Parser tolerant gegenüber fehlenden/kaputten Zeilen.
- **Datenschutz-Hinweis:** Gesprächsnotizen gehen für Schritt 2 an dieselbe bereits genutzte externe KI-API wie die bestehende Feedback-Generierung (gleiches Muster, kein neues Risiko-Muster) — vor Produktivnutzung trotzdem kurz mit dem Datenschutzbeauftragten abstimmen, da es eine neue Nutzungsart derselben Datenklasse ist.
**Nachtrag (2026-07-17):** Zusätzliche Lernebene beschlossen — bewusster Mittelweg zwischen reiner Wortüberschneidung und einem separaten trainierten Klassifikator (Letzteres verworfen, da ein eigener Trainings-/Aktualisierungsschritt der Prämisse „kein separater Trainingsschritt" widersprochen hätte). Der ohnehin gebündelte KI-Aufruf liefert pro Analyse-Lauf zusätzlich einen `MUSTER:`-Block mit kurzen, generalisierten Formulierungsmustern **pro Kriterium** (nicht pro Zeile), z.B. „Kunde wird häufig nach offenen Fragen gefragt, bevor...". Diese landen in einem neuen, optionalen Feld `FeedbackCriterionItem.learnedPatternHints` (automatische Spalten-Migration wie gehabt, kein neues Datenmodell/keine neue Tabelle) und werden bei jedem weiteren Lauf überschrieben/verfeinert — reines Nebenprodukt des normalen „🏷 Vorschläge analysieren"-Klicks, kein separater Trainingslauf. Neuer Platzhalter `{{GELERNTE_MUSTER}}` speist diese Muster (nur für die im aktuellen Assignment-Typ sichtbaren Kriterien) zusätzlich zu `{{AEHNLICHE_ALT_ZUORDNUNGEN}}` in künftige Prompts ein — verbessert die Vorschlagsqualität über die Zeit, ersetzt den KI-Call aber bewusst nicht.
**Erledigt (2026-07-17): Selbstlernendes Kriterien-Tagging umgesetzt** (siehe Konzept + Nachtrag oben). Neuer Button „🏷 Vorschläge analysieren" in `MeetingView.tsx` löst EINEN gebündelten KI-Call für das gesamte offene Protokoll aus (Gesprächsbeiträge + allgemeine Notizen, Kundenzitate ausgenommen). Neue Bausteine: `server/db/queries/criterionSuggestions.ts` (`getGlobalLineTagCorpus()`, flacht `lineTags`/`generalNoteTags` global ab, gleiches Iterationsmuster wie `getCriterionUsageMap()`), `src/utils/criterionSuggestion.ts` (rein lokale Jaccard-Ähnlichkeitssuche, kein KI-Call), `src/utils/criterionSuggestionPrompt.ts` (`buildCriterionStructureText()`/`buildCriterionSuggestionPromptContext()`/`parseCriterionSuggestionResponse()` — Response-Format bewusst Klartext-Marker `ZEILE n: <IDs>` + `MUSTER:`-Block statt JSON, gleiches Robustheitsprinzip wie `parseDimensionAiResponse`). `AppSettings.criterionTaggingPromptTemplate` (ein gemeinsames Template statt eines pro Assignment-Typ, editierbar in `AiPromptConfig.tsx` unter „KI-Prompt: Kriterien-Zuordnungsvorschläge") und `FeedbackCriterionItem.learnedPatternHints` sind neue, automatisch migrierte Spalten. `CriterionTagPicker.tsx` zeigt bei fehlender Zuordnung einen 💡-Vorschlags-Chip (Top-Vorschlag per Klick übernehmbar, Alternativen + volle Suche im Popover) statt des leeren „+"-Buttons. Nebenbei extrahiert: `src/utils/aiClient.ts` (`callOpenRouter()`/`getAiSettings()`/`saveAiSettings()`) aus `AssignmentFeedbackPage.tsx`, damit die bestehende KI-Feedback-Generierung und das neue Tagging dieselbe OpenRouter-Anbindung nutzen statt zwei leicht abweichende Implementierungen zu pflegen — reiner Refactor, kein Verhaltensunterschied. Verifiziert: `npx tsc -b` fehlerfrei; neue RPC-Endpunkte (`criterionSuggestions.getGlobalLineTagCorpus`, `appSettings.getOrSeedCriterionTaggingPromptTemplate`) direkt gegen die laufende Dev-Instanz getestet (der Server läuft unter `tsx watch` und hat Schema-Migration + neue Module automatisch übernommen, ohne manuellen Neustart). Manueller Browser-Test des Gesamtflusses (Klick auf „Vorschläge analysieren" in einem echten Meeting, Übernehmen eines Vorschlags) steht noch aus — sollte vor breiter Nutzung nachgeholt werden.
**Erledigt (2026-07-13, dritte Runde):** Kriterium-Zuordnung für „Allgemeine Notizen" (`MeetingInstance.generalNoteTags`, neue Spalte, gleicher Typ `ConversationLineTag[]` wie `ConversationEntry.lineTags`) — anders als die bestehende Zeilen-Zuordnung in Gesprächsbeiträgen ist diese **nicht** an ein Institutee gebunden, sondern gilt für **alle** Institutees des Assignments gleichzeitig, weil allgemeine Meeting-Notizen keinem einzelnen Sprecher zugeordnet sind. Erfassung in `MeetingView.tsx`: derselbe `CriterionTagPicker` wie bei Gesprächsbeiträgen, per `renderLineAddon` an `NotationText` gehängt (Klick auf den Picker mit `stopPropagation`, da der umgebende Notizen-Block sonst in den Editier-Modus wechseln würde); verwaiste Zuordnungen werden beim Verlassen des Editier-Modus anhand der aktuellen Zeilen bereinigt (gleiches Muster wie `saveEdit` bei Gesprächsbeiträgen). Fünf bestehende Konsumenten von `lineTags` wurden konsistent um die neue, ungefilterte Quelle ergänzt (Recherche in zwei unabhängigen Durchläufen bestätigt, dass dies eine vollständige Liste ist): `AssessmentTab.suggestedRating()` (💡-Vorschlags-Badges, jetzt pro Kriterium für jedes Institutee identisch beeinflusst), `aiPrompt.ts::buildDimensionPromptContext` (`{{KRITERIEN_SCORES}}` bekommt die zugeordneten Zeilen zusätzlich, `{{NOTIZEN_ALLGEMEIN_MEETING}}` blendet bereits zugeordnete Zeilen aus — exakt das bestehende Muster von `{{PROTOKOLL_UNZUGEORDNET}}`), `meetingExport.ts` (Kriterien-ID-Sammlung + `_(→ Kriteriumsname)_`-Annotation pro Zeile im Markdown-Export), `FeedbackDraftPage.tsx` (Legacy-Feedback-Entwurf, gleiche Erweiterung von Kriterien-Sammlung und Notizen), `MeetingHistory.tsx` (reine Anzeige, sonst wäre die neue Zuordnung dort unsichtbar geblieben). Bei leerem/fehlendem `generalNoteTags` ist das Verhalten überall identisch zu vorher — bestehende Daten/Prompts brechen nicht.
**Erledigt (2026-07-13, zweite Runde):** Chronologisches Gesamtprotokoll aller Meetings eines Assignments (`MeetingHistory.tsx`, Route `/assignment/:id/history`) — Anlass: Recap-Calls nach jedem Kundenmeeting brauchen einen schnellen Blick auf die Historie vorheriger Meetings, zusätzlich hilfreich bei der Gesamtdurchsprache im finalen Feedback-Call. Rein lesende Seite, baut bewusst auf bereits vorhandenen Bulk-Abfragen auf statt neuen Server-Code zu schreiben: `listDoneMeetingsChronological()` (kanonischer Trash-Filter + Sortierung, siehe unten) liefert die Meetings, `listConversationEntriesForMeetings()`/`listAssessmentsForMeetings()` (beide bereits vorhanden, u.a. schon von `AssignmentDetail.tsx` genutzt) liefern Notizen/Bewertungen über alle Meetings auf einen Schlag statt N+1-Abfragen pro Meeting. Rendering nutzt bestehende Bausteine statt Neuimplementierung: `NotationText` (`notationParser.tsx`) für Notiz-Formatierung, dieselbe `weightedAverageRating()`+`RATING_BG`-Chip-Logik wie die Meeting-Kacheln in `AssignmentDetail.tsx`. Kriterium-Tags werden hier bewusst nur als statisches Badge angezeigt (kein interaktiver `CriterionTagPicker`), da die Seite reine Anzeige ist. Das jeweils neueste Meeting wird optisch hervorgehoben und die Seite scrollt beim Laden automatisch dorthin — deckt den Recap-Anwendungsfall ab, während beim Hochscrollen die volle Historie für die Feedback-Gesamtdurchsprache verfügbar bleibt. Erreichbar über neue Buttons sowohl auf `AssignmentDetail.tsx` („📜 Gesamtprotokoll") als auch direkt aus `MeetingView.tsx` heraus („📜 Verlauf"), damit man auch mitten im Recap-Call ohne Umweg über die Detailseite wechseln kann.
**Erledigt (2026-07-14):** KI-Feedback-Generierung (siehe 2026-07-07) anhand echter Testläufe nachgeschärft. `RATING_OPTIONS` (`src/config/constants.ts`) hat ein neues `full`-Feld ("Not/Partially/Nearly/Fully Client Ready", "Not Applicable") als einzige Quelle der Wahrheit für ausgeschriebene Bewertungslabels — wichtig fürs KI-Prompting, da die kurzen Labels ("Not") für ein Modell ohne Kontext zum Zweck des Trainee-Programms (Ziel: "Client Ready" werden) nicht aussagekräftig genug sind. `src/utils/notationParser.tsx` hat eine neue Funktion `parseNotationPrefix()` (liefert Rating/Zitat-Flag/Resttext, `detectNotationRating()` ist jetzt darauf aufgebaut, keine doppelte Symbol-Zuordnung mehr). In `aiPrompt.ts` löst `formatNotationLine()` jede Notiz-Zeile (`{{KRITERIEN_SCORES}}`-Notizen, `{{NOTIZEN_ALLGEMEIN_MEETING}}`, `{{PROTOKOLL_UNZUGEORDNET}}`) konsistent auf — Format `Label — Text` (bewusst **keine** eckigen Klammern, da `[Titel]` bereits für Slide-/Themen-Referenzen reserviert ist und sonst mit aufgelösten Bewertungen kollidieren würde). Zwei fachliche Korrekturen dabei: (1) `{{KRITERIEN_SCORES}}` lässt Kriterien ohne jede Bewertung/Notiz jetzt komplett aus (reines Token-Rauschen), ebenso ganze Kategorien ohne verwertbare Kriterien. (2) Mit `>` markierte Kundenzitate werden aus `{{NOTIZEN_ALLGEMEIN_MEETING}}`/`{{PROTOKOLL_UNZUGEORDNET}}` jetzt **komplett herausgefiltert** statt nur aufgelöst — Kundenaussagen sind fachlicher Assignment-Kontext, keine Aussage über den Berater, und würden besonders beim Feedback-Call mit dem Kunden ein verzerrtes Bild erzeugen (der Kunde gibt ohnehin separates Feedback). Explizit einem Kriterium zugeordnete Zitate (bewusste Tagging-Entscheidung des Bewerters) werden davon nicht angefasst. Output-Format umgestellt von Fließtext-Absätzen auf Stichpunkte (`- `-Zeilen) — leichter in die offizielle Feedback-App zu übertragen; Development-Needs-Stichpunkte müssen jetzt explizit als Handlungsempfehlung formuliert sein (z.B. "Sollte darauf achten, dass ..."). Zusätzlich eine explizite Anti-Halluzinations-Anweisung im Prompt ("nutze ausschließlich die angegebenen Daten, erfinde nichts") ergänzt, nachdem die KI vereinzelt Details erfunden hatte. **Wichtige Einschränkung, die bei jeder künftigen Prompt-Engine-Änderung zu beachten ist:** Da jede Dimension einen **vollständig unabhängigen** Prompt-Text in der DB hat (bewusste Design-Entscheidung, siehe 2026-07-07), wirken Verbesserungen an `AI_CONFIG.defaultDimensionPromptTemplate` NICHT automatisch auf bereits existierende Dimensionen — nur auf neu angelegte oder explizit per "Auf Standard zurücksetzen" aktualisierte. Alle Änderungen dieser Runde wurden nach Rückfrage per Skript einmalig auf alle 5 bestehenden Dimensionen nachgezogen (nur unbedenklich, weil vorher per Read-Check bestätigt wurde, dass noch keine individuellen Anpassungen existierten).
**Erledigt (2026-07-14, dritte Runde):** PDF-Export ergänzt (`src/utils/pdfExport.tsx`, neue Abhängigkeit `@react-pdf/renderer` — reines JS, kein natives Kompilieren nötig, läuft browser- und Node-seitig). Zwei Dokument-Typen: `AssignmentReportDocument` (Gesamtprotokoll wie `MeetingHistory.tsx` + Feedback-Anhang aller Institutees, unabhängig vom Status Entwurf/Final) und `InstituteeFeedbackDocument` (nur das Feedback einer Person). Wichtig: Der Feedback-Teil zeigt ausschließlich die **finalen** Felder (`achievements`/`developmentNeeds`/`text`/`rating`) — niemals die `suggested*`-KI-Vorschläge, die noch nicht per „Übernehmen" bestätigt wurden. Notation in den Protokollzeilen wird wie in der App selbst als Icon/Farbe dargestellt (✓/✗/✓~/✗~/›, aus `parseNotationPrefix()` abgeleitet) — bewusst anders als die textuelle "Label — Text"-Auflösung in `aiPrompt.ts`, da das PDF für Menschen ist, die die App-Notation schon kennen, nicht für ein KI-Modell ohne Kontext. Erzeugung/Download sind getrennt (`buildAssignmentReportPdfBlob`/`buildInstituteeFeedbackPdfBlob` liefern nur den Blob, `exportAssignmentReportPdf`/`exportInstituteeFeedbackPdf` triggern zusätzlich den Browser-Download) — dadurch auch außerhalb des Browsers (Node/tsx) testbar, was beim Verifizieren genutzt wurde (die Download-Hälfte braucht `document`/`URL`, ist also browser-only). Buttons an drei Stellen: `MeetingHistory.tsx` (Gesamt-Report), `AssignmentFeedbackPage.tsx` (eigenes Feedback), `AssignmentDetail.tsx` (Schnellzugriff für beide Varianten ohne Navigation). Nachträglich (nach erstem Testlauf) Seitenumbrüche korrigiert: `wrap={false}` auf ganzen Meeting-/Dimension-Blöcken erzwang unsinnige Umbrüche/Lücken, sobald ein Block länger als eine Seite war — stattdessen nur noch kleine Kopfzeilen-Blöcke (Meeting-Titel+Datum, Dimension-/Institutee-Name, Achievements/Development-Needs-Label) mit `wrap={false}` + `minPresenceAhead` vor Verwaisung geschützt, der eigentliche Inhalt darf frei umbrechen. Zusätzlich erzwungener Seitenwechsel (`break`) vor dem „Feedback"-Abschnitt und vor jedem weiteren Institutee, damit Protokoll und Feedback klar getrennt bleiben. Ebenfalls ergänzt: Kriterium-Zuordnung pro Protokollzeile (`lineTags`/`generalNoteTags`) wird jetzt wie in `MeetingHistory.tsx`/`meetingExport.ts` als kleiner „→ Kriteriumsname"-Zusatz hinter der Zeile angezeigt (indigo, per `visibleItems`-Lookup) — vorher zeigte das PDF nur die Notation, aber keine Kriterium-Zuordnung.
**Erledigt (2026-07-16, zweite Runde):** Sicherer Umbau der Feedback-Struktur (Config → Feedback), motiviert durch laufende Umbenennungen/Löschungen/Verschiebungen von Kriterien ohne Überblick, wo diese bereits verwendet werden. Neu in `server/db/queries/feedbackStructure.ts`: `getCriterionUsageMap()` — EIN Durchlauf über `assessments`, `conversationEntries.lineTags`, `meetingInstances.generalNoteTags`, `assignmentTypes.criteriaIds`, `phaseTemplates.criteriaIds` liefert eine `criterionId → CriterionUsage`-Map (Zählungen + betroffene Meetings), wird beim Laden von `FeedbackStructureConfig.tsx` mitgeladen und zeigt pro Kriterium einen aufklappbaren „N Verwendungen"-Badge. **Verschieben** zwischen Kategorien per einfachem Dropdown (kein Drag & Drop, keine neue Abhängigkeit — nutzt das bereits vorhandene `updateFeedbackCriterionItem(id, { categoryId })`). **Löschen mit Verwendung** zeigt jetzt ein Inline-Panel mit zwei Wegen: „Übertragen auf ▾" (`reassignCriterionReferences(fromId, toId)`, verschiebt Assessments/Tags/Sichtbarkeitslisten auf ein anderes Kriterium, dann Löschen) oder „Trotzdem löschen" (Bewertungen werden gelöscht, Protokoll-Zuordnungen nur entfernt, Notiztext bleibt). **Wichtiger Edge-Case bei `reassignCriterionReferences`:** `assessments` hat keine DB-Unique-Constraint auf `(meetingInstanceId, instituteeId, criteriaId)` — ein blindes Umschreiben von `criteriaId` könnte eine Dubletten-Zeile für dieselbe Meeting/Institutee-Kombination erzeugen. Bei Konflikt wird die Quell-Zeile stattdessen in die bestehende Ziel-Zeile gemergt (Notizen zusammengeführt, vorhandener Score der Zielzeile hat Vorrang) und gelöscht; Rückgabewert `mergedConflicts` macht das der UI gegenüber transparent. `deleteFeedbackCriterionItem()` räumt jetzt selbst alle Referenzen auf (Verteidigung in der Tiefe, unabhängig vom UI-Pfad), `deleteFeedbackCategory()`/`deleteFeedbackDimension()` cascaden ab jetzt **durch** diese Funktion statt per direktem Bulk-Delete, damit die Aufräum-Logik auch bei Kategorie-/Dimension-Löschung greift. Verifiziert per Skript auf rein synthetischen Testdaten (temporäre Dimension/Kategorie/2 Kriterien + ein Test-Meeting unter einem echten Assignment, absichtlich erzeugter Konfliktfall bestätigt korrektes Merge-Verhalten ohne Dublette, danach vollständig wieder entfernt).
**Nachtrag (gleicher Tag):** Reine Zählungen/Meeting-Liste reichten nicht — beim Konsolidieren zweier Kriterien musste man sonst weiterhin jedes Meeting einzeln durchsuchen. Neu: `getCriterionUsageDetails(criterionId)` liefert pro Kriterium eine **Einzelinstanzen-Liste** (`CriterionUsageInstance`, discriminated union `assessment`/`lineTag`/`generalNoteTag`, mit Meeting/Assignment/Person/Text aufgelöst) — bewusst lazy pro Kriterium beim Aufklappen geladen, nicht eager für alle (im Unterschied zu `getCriterionUsageMap`), da hier echte Texte/Namen aufgelöst werden. Direkt im aufgeklappten Verwendungs-Badge kann jede einzelne Instanz jetzt per „→ anderes Kriterium…"-Dropdown + „Übertragen" gezielt umgehängt oder per „Entfernen" einzeln entfernt werden (`reassignUsageInstance()`/`removeUsageInstance()`) — ohne das ganze Kriterium zu löschen und ohne alle Verwendungen auf einmal zu bewegen. Die Konflikt-Merge-Logik für Assessments wurde dafür aus `reassignCriterionReferences` in eine gemeinsame Hilfsfunktion `mergeOrReassignAssessment()` extrahiert, damit Bulk- und Einzel-Reassign nicht zwei leicht unterschiedliche Implementierungen derselben Regel pflegen. Ebenfalls per Skript auf synthetischen Testdaten verifiziert (Einzel-Entfernen erhält den Notiztext, Einzel-Übertragen löst denselben Merge-Konflikt korrekt wie die Bulk-Variante).
**Zweiter Nachtrag (gleicher Tag):** Nach erstem Testlauf gemeldet: Ein Kriterium zeigte nach Bereinigung aller Bewertungen/Protokoll-Tags weiterhin „4 Verwendungen" — Ursache war, dass `assignmentTypeNames`/`phaseTemplateLabels` (Sichtbarkeits-Zuordnung in `AssignmentType.criteriaIds`/`PhaseTemplate.criteriaIds`) zwar in die Zählung eingehen, aber bis dahin nur als reiner Text angezeigt wurden — keine Einzelinstanz, kein Weg, sie von hier aus zu bereinigen. `CriterionUsageInstance` um zwei weitere Kinds ergänzt (`assignmentTypeVisibility`, `phaseTemplateVisibility`, mit `criterionId`-Feld, damit `reassignUsageInstance`/`removeUsageInstance` wissen, welche ID sie in der jeweiligen `criteriaIds`-Liste ersetzen/entfernen sollen). Damit sind jetzt **alle** in der Zählung enthaltenen Verwendungsarten auch einzeln direkt aus dem aufgeklappten Badge heraus behebbar, nicht nur die drei Protokoll-/Bewertungsarten. Client-Anzeige unterscheidet per `isDataInstance()`-Typprädikat zwischen den beiden Darstellungsformen (Meeting/Person-Kontext vs. reiner Name). Ebenfalls per Skript auf synthetischen Testdaten (temporärer Assignment-Typ + Phase-Vorlage, danach entfernt) verifiziert.
**Dritter Nachtrag (gleicher Tag):** Zwei UI-Bugs nach erstem echten Nutzungstest gefixt (`FeedbackStructureConfig.tsx`). (1) Alle „Ziel-Kriterium"-Dropdowns (Verschieben/Übertragen) gruppierten nur nach Dimension und übersprangen die Kategorie-Ebene — HTML kennt kein verschachteltes `<optgroup>`, daher jetzt eine kombinierte Optgroup-Beschriftung `"Dimension → Kategorie"` über die neue gemeinsame Hilfsfunktion `criterionOptionGroups()` (an allen drei Stellen genutzt: Verschieben-Dropdown, Lösch-Dialog-Übertragen, Einzel-Verwendungs-Übertragen). (2) Schwerwiegenderer Bug: Die Ziel-Auswahl pro Einzelverwendung war über den **Array-Index** in der Instanzen-Liste verknüpft (`` `${itemId}:${idx}` ``). Nach jedem „Übertragen" wird die Liste neu vom Server geladen, wodurch sich die Indizes der verbleibenden Instanzen verschieben — eine bei Index 3 gespeicherte Ziel-Auswahl gehörte danach plötzlich zu einer anderen Instanz, und ein Klick auf „Übertragen" verschob nachweislich die falsche Zeile. Gefixt durch einen **stabilen, inhaltsbasierten Schlüssel** (`instanceKey()`: `assessmentId` bzw. `conversationEntryId`/`meetingInstanceId` + Zeilentext bzw. `assignmentTypeId`/`phaseTemplateId`) statt des Index — Auswahlen bleiben dadurch auch nach einem Reload an der richtigen Instanz hängen, und bereits übertragene/entfernte Instanzen verschwinden korrekt aus der Liste statt eine falsche Zeile zu verändern.
**Erledigt (2026-07-16):** Zwei weitere Exporte ergänzt, jeweils als Markdown UND PDF. (1) „Feedback-Struktur" (Config → Feedback, neue Buttons „⬇ MD"/„⬇ PDF" im Header): alle Dimensionen/Kategorien/Kriterien inkl. Gewichtung und aller Beschreibungen (`FeedbackCategory.description`/`FeedbackCriterionItem.description`, siehe 2026-07-07/2026-07-15). (2) „Assignment-Typen-Bericht" (Config → Ass.-Typen, gleiche Buttons): pro Assignment-Typ die Phasen sowie das Kriterien-Mapping (`AssignmentType.criteriaIds`) — bei leerer/undefined `criteriaIds` „Alle Kriterien", sonst nach Dimension/Kategorie gruppierte Liste der zugeordneten Kriteriennamen (exakt dieselbe Lookup-Logik wie im „Kriterien"-Tab von `AssignmentTypeConfig.tsx`, nicht neu erfunden). Markdown-Erzeugung in neuer Datei `src/utils/structureExport.ts` (nutzt bestehendes `downloadFile()` aus `meetingExport.ts`), PDF-Dokumente als zwei weitere Komponenten in `pdfExport.tsx` (gleiche Styles/Pagination-Helfer wie die bestehenden Berichte). Bei der Verifikation aufgefallen, aber bewusst nicht angefasst: Phasen-Labels enthalten in den Bestandsdaten teils schon "(Lead)"/"(Kunde)" als Teil des Freitexts, wodurch der Bericht das zusätzlich per `PhaseTemplate.withWhom` angehängte "(Lead)"/"(Kunde)" doppelt zeigt — das ist eine Dateneingabe-Redundanz, keine Automatisierung, mit der ein Freitextfeld sicher bereinigt werden könnte, daher nicht angetastet.
**Erledigt (2026-07-15):** Analog zu `FeedbackCriterionItem.description` (2026-07-07) jetzt auch `FeedbackCategory.description` — Erläuterung, welche Themen/Beobachtungen in eine Kategorie einzahlen sollen, editierbar in `FeedbackStructureConfig.tsx` direkt unter dem Kategorienamen. Grund: Die KI kannte bisher nur die Kriterien-Ebene im Detail, nicht aber, wonach auf Kategorie-/Dimensionsebene grundsätzlich gefragt ist. Bewusst **keinen neuen Platzhalter** eingeführt, sondern die bestehende `{{KATEGORIEN_STRUKTUR}}` in `aiPrompt.ts` angereichert (`Name — Erläuterung` statt nur `Name`) — dadurch profitieren auch bereits bestehende, individuell angepasste Dimension-Prompts automatisch, ohne dass sie erneut synchronisiert werden müssen (der Platzhalter-Token selbst ändert sich nicht, nur was dahinter berechnet wird).
**Erledigt (2026-07-14, zweite Runde):** Zwei weitere Nachschärfungen der KI-Feedback-Generierung (siehe Eintrag oben). (1) Abschnittsmarker wie `[Background]`/`[Whiteboard - Storyboard]` (reine Navigationshilfe des Bewerters, an welcher Stelle der Präsentation/des Dialogs eine Beobachtung entstand) werden jetzt aus `{{NOTIZEN_ALLGEMEIN_MEETING}}`/`{{PROTOKOLL_UNZUGEORDNET}}` gefiltert, wenn ihnen keine Inhalts-Zeile folgt (`dropDanglingMarkers()` in `aiPrompt.ts`, Lookahead auf die jeweils nächste Zeile) — bleiben aber erhalten, wenn direkt danach noch etwas steht, da sie dann als Kontext-Header dienen. (2) `AI_CONFIG.defaultDimensionPromptTemplate` (der Basis-Prompt für neue Dimensionen und „Auf Standard zurücksetzen") ist nicht mehr rein im Code gepflegt, sondern zusätzlich in `appSettings` (Singleton-Tabelle, neue Spalte `defaultDimensionPromptTemplate`) persistiert und über einen neuen, aufklappbaren Bereich ganz oben im „KI-Prompts"-Tab (`AiPromptConfig.tsx`) direkt in der App editierbar — analog zum bestehenden Zeitgewichtungs-Faktor-Muster (`getOrSeedDefaultDimensionPromptTemplate()`/`saveDefaultDimensionPromptTemplate()` in `server/db/queries/appSettings.ts`, exakt wie `getOrSeedRatingTrendWeightStep()`). Der Code-Konstante dient jetzt nur noch als einmaliger Erstbefüllungswert für neue Installationen; `feedbackStructure.ts` (Auto-Anlage neuer Dimensionen, Backfill, Lazy-Create) liest den Default jetzt ausschließlich aus `appSettings`. Wie bei jeder Custom-Prompt-Änderung gilt weiterhin: bereits bestehende, individuell abweichende Dimension-Prompts ändern sich dadurch nicht automatisch mit.
**Erledigt (2026-07-13):** Papierkorb + Archiv für Assignments umgesetzt. Dashboard zeigt standardmäßig nur noch aktive Assignments (`statusFilter`-Default auf `'active'`), trashed/archivierte Assignments sind in keinem Status-Tab mehr sichtbar. `Assignment` hat zwei neue optionale Felder `deletedAt`/`archivedAt` (analog zu `MeetingInstance.deletedAt`). Löschen (`softDeleteAssignment`) ist nur möglich, wenn `status === 'done'` UND für **alle** `instituteeIds` ein Feedback mit Status `'final'` vorliegt (`isAssignmentFeedbackComplete()` in `server/db/queries/assignments.ts`) — Gate wird sowohl serverseitig erzwungen (wirft sonst) als auch clientseitig auf `AssignmentDetail.tsx` zum Deaktivieren des Buttons genutzt. Löschung ist zweistufig: `softDeleteAssignment` setzt nur `deletedAt` (Papierkorb, neue Seite `/assignments/trash`), `restoreAssignment` löscht es wieder (zurück nach „Abgeschlossen"). Nach 30 Tagen wird der Eintrag automatisch endgültig entfernt — kein Cron/Timer, sondern ein Lazy-Sweep (`purgeExpiredAssignmentTrash()`), der am Anfang von `listAssignmentsWithDetails()` mitläuft (Server läuft nicht dauerhaft, ein echter Scheduler wäre unzuverlässig). `hardDeleteAssignment()` kaskadiert manuell durch den kompletten Assignment-Baum (`meetingInstances` inkl. deren Kindern über das bestehende `hardDeleteMeetingInstance()`, `feedbackDrafts`, `assignmentFeedbacks` inkl. `feedbackCategoryRatings`/`feedbackDimensionTexts`/`feedbackCategoryTexts`) — Muster 1:1 von der bestehenden Meeting-Papierkorb-Kaskade in `server/db/queries/meetings.ts` übernommen. Zusätzlich unabhängiges Archiv (`archiveAssignment`/`unarchiveAssignment`, neue Seite `/assignments/archive`) für dauerhafte Aufbewahrung (spätere Auswertung/ML) — bewusst ohne Feedback-Zwang und ohne Lösch-Option in der UI, aber umkehrbar (Rückholen möglich). Neue Spalten `deletedAt`/`archivedAt` auf `assignments` werden automatisch per bestehendem `ALTER TABLE`-Migrationsmechanismus in `database.ts` nachgezogen, kein manuelles Migrationsskript nötig.
**Erledigt (2026-07-07):** KI-Feedback-Generierung neu konzipiert und umgesetzt — löst den zuvor diagnostizierten `response_format`/Markdown-Codefence-Bug strukturell statt punktuell. Statt einem Monolith-Call für alle Dimensionen macht `generateAllDimensions()` (`AssignmentFeedbackPage.tsx`) jetzt **sequenziell einen Call pro Dimension**, mit Fortschrittsanzeige und Teil-Fehlerbehandlung (fehlgeschlagene Dimensionen einzeln erneut versuchbar, `dimensionErrors`). Jede Dimension hat einen **vollständig frei editierbaren Prompt** (`FeedbackDimensionPrompt`, neuer Admin-Tab „KI-Prompts" → `AiPromptConfig.tsx`), der bei `addFeedbackDimension()` automatisch mit einem Default-Template vorbelegt wird (`AI_CONFIG.defaultDimensionPromptTemplate`) — neue Dimensionen funktionieren dadurch ohne Zutun. Antwortformat ist jetzt einfacher Text statt JSON (`KATEGORIE:`/`ACHIEVEMENTS:`/`DEVELOPMENT_NEEDS:`-Marker, geparst in `src/utils/aiPrompt.ts::parseDimensionAiResponse`), da pro Call ohnehin nur eine Dimension behandelt wird — macht den JSON/Codefence-Bug strukturell unmöglich statt ihn nur zu patchen. KI-generierte Texte landen zunächst als **Vorschlag** (`suggestedAchievements`/`suggestedDevelopmentNeeds` auf `FeedbackDimensionText`, `suggestedText` auf neuer Tabelle `FeedbackCategoryText`) und werden erst durch expliziten „Übernehmen"-Klick in die echten Felder kopiert (gleiches Muster wie die bestehende Rating-Vorschlags-Badge) — persistiert, übersteht also einen Seitenwechsel. Neu: kurzer KI-Text zusätzlich auf Kategorie-Ebene (`FeedbackCategoryText`), nicht nur auf Dimension-Ebene. Cross-Boundary-Falle dabei gefunden: `src/config/constants.ts` importierte bisher `FeedbackRating` aus dem Barrel `'../db'` (re-exportiert Dexie/rpcClient/Seeds) statt direkt aus `'../db/types'` — beim Import von `AI_CONFIG` in `server/db/queries/feedbackStructure.ts` hätte das transitiv Browser-only-Code (`fetch`, `localStorage`) in den Server-TS-Scope gezogen; auf direkten Typ-Import umgestellt und `src/config/constants.ts` zusätzlich explizit in `tsconfig.server.json`s `include` aufgenommen (gleiches Muster wie das dort schon gelistete `src/db/types.ts`). Nachträglich (gleicher Tag, nach erstem Testlauf) zwei Lücken gefixt/ergänzt: (1) `database.ts` migrierte nur neue Tabellen, nie Spalten einer bereits bestehenden Tabelle — `suggestedAchievements` u.ä. auf `feedbackDimensionTexts` fehlten dadurch auf bereits laufenden Installationen und scheiterten erst zur Laufzeit; jetzt gleicht `database.ts` zusätzlich per `PRAGMA table_info` ab und zieht fehlende Spalten per `ALTER TABLE ... ADD COLUMN` nach (siehe Datenbank-Abschnitt oben). (2) Prompt-Vorschau ergänzt: pro Dimension ein „👁 KI-Prompt ansehen"-Toggle auf `AssignmentFeedbackPage.tsx`, der den vollständig gerenderten Prompt (Template + aufgelöste Platzhalter) ohne API-Call anzeigt — Feedback war, dass die generierten Texte „brauchbar, aber nicht konkret genug" waren und ohne Einblick in den tatsächlich gesendeten Prompt nicht nachvollziehbar. Zusätzlich neues optionales Feld `FeedbackCriterionItem.description` (editierbar in `FeedbackStructureConfig.tsx`, direkt unter dem Kriteriumsnamen), das automatisch in `{{KRITERIEN_SCORES}}` einfließt (`src/utils/aiPrompt.ts`) — macht die KI-Vorgabe pro Kriterium einmal zentral pflegbar statt in jedem Dimension-Prompt wiederholt werden zu müssen. Bewusst **nicht** reaktiviert: die bereits vorhandene, aber seit Langem unverdrahtete Legacy-Tabelle `CriterionLevelDescription` (Text pro Kriterium UND Rating-Stufe) — wäre eine präzisere Rubrik gewesen, aber deutlich mehr Pflege-/UI-Aufwand; bei Bedarf spätere, bewusste Entscheidung.
**Erledigt (2026-07-04, zweite Runde):** Lokaler Node/Express-Server mit `node:sqlite` (statt IndexedDB) eingeführt, RPC-Bridge (`POST /api/rpc`) zwischen `src/db/queries/*.ts` (Client) und neuem `server/db/queries/*.ts` (Server) — siehe eigener Abschnitt "Datenbank: lokaler Server statt IndexedDB" oben für Details, Abweichungen (node:sqlite statt better-sqlite3) und die wichtige `npx tsc -b`-statt-`--noEmit`-Korrektur. Ziel: mehrere Browser auf demselben Laptop teilen sich dieselben Daten, unabhängig vom Browser-Cache, als Zwischenschritt vor einem Docker/Linux-Deployment.
**Erledigt (2026-07-04):** `db/queries/`-Layer eingeführt — alle 20 Komponenten/Utils mit vorherigem direktem `db.<table>.*`-Zugriff nutzen jetzt benannte Funktionen aus `src/db/queries/*.ts` (siehe eigener Abschnitt oben), reine Extraktion ohne beabsichtigte Verhaltensänderung. Dabei bewusst mitkonsolidiert: die drei unabhängig implementierten Varianten der gewichteten-Durchschnitt-Logik (`ratingTrend.ts`, `AssessmentTab.tsx`, `AssignmentDetail.tsx`) laufen jetzt über eine einzige Funktion `weightedAverageScore()`/`weightedAverageRating()` in `ratingTrend.ts` — dabei einen fehlenden `Σweight===0`-Guard in `AssignmentDetail.tsx` gefixt (identische Bug-Klasse wie die zweite Bug-Klasse oben, dort war er noch nicht behoben). Ebenfalls konsolidiert: die "AssignmentType.criteriaIds schränkt sichtbare Kriterien ein"-Filterlogik (vorher dupliziert in `MeetingView.tsx`/`AssignmentDetail.tsx`, jetzt `filterVisibleFeedbackStructure()`) und die doppelten Datenabfragen in `meetingExport.ts`s Markdown-/JSON-Export (jetzt `getMeetingExportData()` in `meetings.ts`). `dbBackup.ts` und Seed-Code bleiben bewusst bei direktem `db`-Zugriff (siehe Abschnitt oben). `npx tsc --noEmit` läuft fehlerfrei.
**Erledigt (2026-07-02):** Konfiguration zentralisiert (`config/constants.ts`), `db/index.ts` in types/schema/seeds aufgeteilt, `MeetingView.tsx` in 3 Dateien aufgeteilt (`pages/meeting/`), `Evaluation.tsx` auf `feedbackCriterionItems` migriert + nach Assignment gruppiert + Papierkorb/Status-Filter + N/A-Bug gefixt, `zustand` entfernt (war ungenutzt). Zeitgewichteter Bewertungs-Vorschlag mit Trend-Erkennung umgesetzt (`src/utils/ratingTrend.ts`, neue Tabelle `appSettings`, neuer Config-Tab „Gewichtung“, Vorschlags-Badge + Übernehmen/Trend-in-Text auf `AssignmentFeedbackPage`, `buildAiPrompt` um Trend-Abschnitt erweitert und Legacy-`db.criteria`-Bug dabei gefixt). Kriterium-Zuordnung für Freitext-Notizen umgesetzt: `ConversationEntry.lineTags` (Zeilentext → Kriterium, nach einem verworfenen Zwischenstand mit "ein Entry pro Zeile" — siehe Sonstige Fallstricke), `CriterionTagPicker.tsx` (Chip+Popover mit Suche, unverändert seit erster Version) wird pro Zeile direkt an der Zeile via `NotationText`s neuer optionaler `renderLineAddon`-Prop gerendert; Zuordnung passiert bewusst nur nachträglich (nicht live während des Tippens), um den Schreibfluss nicht zu stören. `buildAiPrompt` führt Assessment-Notizen und getaggte Zeilen jetzt pro Kriterium zusammen, unzugeordnete Zeilen bleiben im allgemeinen Protokoll-Block. **(2026-07-03)** Vier Folge-Fixes: `meetingExport.ts` löste Kriterien über die Legacy-Tabelle `db.criteria` auf (identischer Bug wie der frühere `buildAiPrompt`-Fix) — dadurch war die Gesamtbewertung im Export faktisch leer; jetzt auf `feedbackCriterionItems` umgestellt, Markdown-Export zeigt zusätzlich das Kriterium pro getaggter Protokollzeile. `dbBackup.ts`s `TABLE_NAMES` enthielt `appSettings` nicht — Voll-Backups verloren die Gewichtungs-Config stillschweigend; jetzt ergänzt samt Kommentar, dass neue Tabellen dort manuell nachgezogen werden müssen. Notation → Bewertungs-Vorschlag: `detectNotationRating()` in `notationParser.tsx` (`!`→Not, `(!)`→Partially, `(+)`→Nearly, `+`→Fully) kombiniert mit `lineTags` liefert in `AssessmentTab.tsx` einen "Vorschlag aus Protokoll"-Badge pro Kriterium-Item, unabhängig vom bestehenden "Aus Protokoll"-Button (andere Datenquelle). `AssignmentCreate.tsx`: Assignment-Nummer ist jetzt Pflichtfeld (nur auf Formular-Ebene, Typ bleibt optional wegen Altdaten). Kriterium-Gewichtung auf `0,0–2,0` in `0,1`-Schritten verfeinert (`FeedbackStructureConfig.tsx`, vorher `×1`–`×5`), dabei einen latenten Division-durch-Null-Bug gefixt, der durch das neu erlaubte Gewicht `0` real wurde (`catMode()` in `AssessmentTab.tsx`, `buildGroupMeetingScores()` in `ratingTrend.ts` — siehe zweite Bug-Klasse oben). Sprecher eines bereits erfassten Protokoll-Beitrags kann nachträglich geändert werden (`ConversationTab.tsx`, im Bearbeiten-Modus neben Füllwörtern — ändert sofort `ConversationEntry.instituteeId`, kein separater Speichern-Schritt nötig). N/A-Aggregationsbug in `buildAiPrompt` (`AssignmentFeedbackPage.tsx`) gefixt — war die letzte offene Stelle dieser Bug-Klasse außer der jetzt migrierten `FeedbackDraftPage.tsx`. `FeedbackDraftPage.tsx` vollständig auf `feedbackCriterionItems`/`feedbackCategories` migriert (letzter Konsument der Legacy-Tabellen ist jetzt nur noch der Seed-Code), Notizen jetzt korrekt pro Kriterium über `lineTags` statt aller Protokoll-Notizen ungefiltert an jedes Kriterium gehängt, Score-Anzeige auf `RATING_OPTIONS`-Labels umgestellt (statt `/5`-Rohwert). Toter Code (verwaiste AssignmentType/PhaseTemplate-CRUD-Reste) aus `FeedbackStructureConfig.tsx` entfernt. „Dashboard zeigt keine Assignment-Nummer" war bereits gelöst, nur die Doku war veraltet — richtiggestellt.
---
## Datenschutz
- Alle Daten lokal (IndexedDB) — **kein Public Cloud Upload**
- Alle Daten lokal — V2: `server/data/assignment-monitor-v2-dev.sqlite3`; **kein Cloud-Upload**, nur `localhost` (kein Auth, solange das so bleibt)
- `server/data/` ist per `.gitignore` ausgeschlossen — Datenbankdatei nie committen
- GDPR-relevant: Institutee-Namen, Kundennamen, Gesprächsnotizen
- KI-API-Key in `localStorage` — nie loggen oder ausgeben
- Backup-JSON enthält alle personenbezogenen Daten → vertraulich behandeln
+87
View File
@@ -0,0 +1,87 @@
# 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`
+68
View File
@@ -0,0 +1,68 @@
# 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\`.
+60
View File
@@ -0,0 +1,60 @@
# Entwicklungs-Isolation — AssignmentMonitorV2
Dieses Projekt ist die **Neuentwicklung**. Das Produktivsystem darf nicht verändert werden.
| | Produktiv | DEV (dieses Repo) |
|---|---|---|
| Ordner | `c:\dev\AssigmentMonitor` | `c:\dev\AssigmentMonitorV2` |
| Frontend | http://localhost:5173 | http://localhost:5174 |
| API | http://localhost:4000 | http://localhost:4001 |
| SQLite | `server/data/assignment-monitor.sqlite3` | `server/data/assignment-monitor-v2-dev.sqlite3` |
| PWA-Name | Assignment Monitor | Assignment Monitor DEV |
## Start
```bash
# einmalig: .env aus Vorlage (bereits vorhanden, falls nicht:)
copy .env.example .env
npm run dev:all
```
Öffnen: **http://localhost:5174** (nicht 5173).
## Frische Datenbank
```bash
npm run db:reset
npm run dev:all
```
`db:reset` löscht nur die V2-Dev-Datei. Der Produktiv-Ordner wird per Pfad-Guard abgelehnt.
## Sicherheitsmechanismen
1. **Eigene Ports** (5174 / 4001) — Defaults und `.env`; Start bricht ab, wenn Port 5173 bzw. 4000 gewählt wird.
2. **Eigene DB-Datei** — anderer Dateiname; `SQLITE_FILENAME` darf kein Pfad sein.
3. **Pfad-Guard** in `server/database.ts` — DB nur innerhalb von `AssigmentMonitorV2`; Zugriff auf `AssigmentMonitor\server\data` wird blockiert.
4. **`server/data/` ist gitignored** — keine DB im Repo.
5. **strictPort** — Vite weicht nicht still auf den Produktiv-Port aus.
## Regeln
- Niemals Skripte aus V2 gegen den Produktiv-Ordner ausführen.
- Niemals die Produktiv-SQLite nach `AssigmentMonitorV2/server/data/` kopieren, außer bewusst als read-only Analyse (dann anderen Dateinamen verwenden und nicht als `SQLITE_FILENAME` setzen).
- Backup-Import in V2 nur mit **anonymisierten / Testdaten**, nicht mit dem Produktiv-Backup, solange ihr an der Skala umbaut — sonst vermischt ihr personenbezogene Produktivdaten mit Experimenten.
## Team-Verteilung
Struktur an Kollegen weitergeben über das **Starter-Paket** (keine Personen-/Meeting-Daten):
```bash
npm run starter:export # Maintainer: Struktur aus V2-Dev exportieren
npm run setup # Team: frische V2-DB mit Struktur befüllen
npm run pack:zip # Versand-ZIP (ohne DB)
npm run pack:laptop # Umzug: Code + volle Dev-DB (personenbezogen)
```
Assignment-Übergabe Lead→Lead: UI **↔ Übergabe** / **↔ Import** (`assignmentTransfer`).
Details: [`TEAM_SETUP.md`](./TEAM_SETUP.md), [`HANDOVER.md`](./HANDOVER.md). Produktiv bleibt davon unberührt.
+51
View File
@@ -0,0 +1,51 @@
# Design-Brief: Zeitgewichteter Bewertungs-Vorschlag (Auswertung & Abschluss-Feedback)
Status: **Umgesetzt (2026-07-02).** Design-Fragen mit Lars geklärt und implementiert — siehe `CLAUDE.md` (Abschnitt "zwei parallele Bewertungs-Strukturen", Erledigt-Liste) für den aktuellen Stand. Dieses Dokument bleibt als Kontext/Historie der Design-Entscheidungen erhalten.
---
## Ausgangslage
Am 2026-07-02 wurde bei der Migration von `Evaluation.tsx` auf die neue Datenstruktur (`feedbackCriterionItems`) sichtbar, dass die App **zwei komplett unabhängige, nicht synchronisierte Bewertungs-Strukturen** hat:
| Struktur | Tabelle | Wo gesetzt | Zweck |
|---|---|---|---|
| Meeting-Assessment | `assessments` | `MeetingView` (`pages/meeting/AssessmentTab.tsx`), pro Meeting, pro Kriterium | Live-Bewertung während/nach jedem Kundentermin |
| Abschluss-Feedback | `feedbackCategoryRatings` | `AssignmentFeedbackPage.tsx`, manuell pro Kategorie | Finales, für den Institutee bestimmtes Feedback am Assignment-Ende |
Aktuell berechnet `/evaluation` (`Evaluation.tsx`) einen gleichgewichteten Durchschnitt aller `assessments` je Kriterium/Kategorie, gruppiert nach Assignment → Institutee. Das Abschluss-Feedback auf `AssignmentFeedbackPage` ist davon komplett entkoppelt — die Kategorie-Ratings dort werden per Klick frei gesetzt, nicht aus den Meeting-Daten abgeleitet. Der einzige bestehende Brückenschlag ist `buildAiPrompt()` in `AssignmentFeedbackPage.tsx`, der Assessment-Rohdaten in einen KI-Prompt packt (dieser Prompt hat aktuell noch einen offenen Bug: nutzt `db.criteria`, Legacy-Tabelle, sollte `feedbackCriterionItems` nutzen — siehe `docs/STATUS_UND_OFFENE_PUNKTE.md`, Punkt M2).
## Fachlicher Wunsch (Lars, 2026-07-02, wörtlich sinngemäß)
> Die Werte sollen aus den einzelnen Meetings berechnet werden — als **Vorschlag**. Dieser Vorschlag kann durch den Feedbackgeber überarbeitet werden. Eine parallele Ansicht ist daher möglicherweise sinnvoll. Bei der Berechnung der Vorschläge auf Kriteriumslevel über alle Meetings sollte auch die **zeitliche Reihenfolge** berücksichtigt werden. Es sollte honoriert werden, wenn sich der Berater über die Laufzeit des Assignments in bestimmten Kriterien **verbessert** hat. **Verschlechterung** über die Zeit sollte ebenfalls berücksichtigt werden (negative Lernkurve). Diese Entwicklung sollte dann auch **im Kommentar an der richtigen Stelle** berücksichtigt werden.
Kernpunkte:
1. **Zeitgewichtung** — spätere Meetings sollen stärker in den Kriterium-Durchschnitt einfließen als frühere (nicht der aktuelle gleichgewichtete Ansatz).
2. **Trend-Erkennung** — sowohl positive als auch negative Entwicklung über die Assignment-Laufzeit soll erkannt werden.
3. **Automatische Kommentar-Integration** — die erkannte Entwicklung soll an der "richtigen Stelle" im Feedback-Text auftauchen (vermutlich `FeedbackDimensionText.achievements`/`developmentNeeds`, evtl. über den bestehenden KI-Prompt-Mechanismus).
4. **Vorschlag bleibt überschreibbar** — die zwei Strukturen (`Assessment` vs. `FeedbackCategoryRating`) sollen bewusst getrennt bleiben; der berechnete Vorschlag ersetzt nicht die manuelle Entscheidung des Feedbackgebers.
## Bereits vorhandene Bausteine (wiederverwendbar)
- `RATING_NUM_MAP` in `src/config/constants.ts` — numerische Skala für Aggregation
- `weightedAvg()` in `src/pages/Evaluation.tsx` — aktueller (ungewichteter nach Zeit) Aggregationsansatz auf Item-/Kategorie-Ebene, als Ausgangspunkt für die zeitgewichtete Variante
- `MeetingInstance.date` — Zeitstempel pro Meeting, Basis für Zeitgewichtung
- `buildAiPrompt()` in `AssignmentFeedbackPage.tsx` — bestehender Mechanismus, der Assessment-Daten in strukturierten Text für die KI übersetzt; möglicher Ort, um Trend-Informationen einzuspeisen
- Bekannter Bug-Pattern, der bei jeder neuen Aggregationslogik zu beachten ist: `score !== null` schließt `'na'` nicht aus — immer `score !== null && score !== 'na'` prüfen (siehe `CLAUDE.md`)
## Offene Design-Fragen (in der Planungssession zu klären)
1. **Gewichtungsformel**: Linear nach Meeting-Reihenfolge? Exponentiell abfallend nach Alter? Feste Gewichte (z.B. letztes Meeting zählt doppelt)? Muss robust für Assignments mit 2 bis 7+ Meetings funktionieren.
2. **Trend-Schwellenwert**: Ab wann gilt eine Entwicklung als "signifikant" (z.B. mind. 1 Rating-Stufe Unterschied zwischen erstem und letztem gewerteten Meeting)? Wie viele Meetings mit Bewertung sind mindestens nötig, um überhaupt einen Trend zu behaupten?
3. **Granularität**: Wird der Trend auf Kriterium-Ebene, Kategorie-Ebene oder beidem berechnet?
4. **UI-Darstellung des Vorschlags**: Nebeneinander-Ansicht (Vorschlag vs. aktueller manueller Wert) mit "Übernehmen"-Button? Oder Vorschlag pre-fillt die Rating-Buttons direkt, überschreibbar wie jeder andere Wert?
5. **Kommentar-Generierung**: Deterministisch (Template-Satz wie "Zeigt über die Laufzeit eine Verbesserung in X") oder über den bestehenden KI-Prompt-Mechanismus? Wie wird das mit dem offenen AI-Prompt-Bug (M2) koordiniert?
6. **Code-Ort**: Soll die Trend-Berechnung eine gemeinsame Funktion sein, die sowohl `Evaluation.tsx` als auch `AssignmentFeedbackPage.tsx` nutzen (Vermeidung von Doppel-Logik)? Falls ja, wohin (`src/db/queries/`? neues `src/utils/ratingTrend.ts`?).
7. **Naming/Labeling**: Wie wird in der UI klar unterschieden zwischen "berechneter Vorschlag" und "final vom Feedbackgeber bestätigter Wert"?
## Betroffene Dateien (voraussichtlich)
- `src/pages/Evaluation.tsx` — zeigt den Vorschlag an
- `src/pages/AssignmentFeedbackPage.tsx` — übernimmt/überschreibt den Vorschlag, generiert Kommentar
- `src/config/constants.ts` — evtl. neue Konstanten für Gewichtungsparameter
- Neue Datei denkbar: `src/utils/ratingTrend.ts` oder `src/db/queries/ratingSuggestion.ts` für die gemeinsame Berechnungslogik
+28 -5
View File
@@ -1,5 +1,7 @@
# Fachliche Architektur — Assignment Monitor
> **Stand Hinweis (2026-08-16):** Dieses Dokument ist **historisch** (u.a. IndexedDB, ältere Skala). Aktueller Ist-Stand und offene Punkte: [`HANDOVER.md`](./HANDOVER.md), [`STATUS_UND_OFFENE_PUNKTE.md`](./STATUS_UND_OFFENE_PUNKTE.md). Bei Widerspruch gewinnen HANDOVER/STATUS/Code.
## Zweck und Kontext
Assignment Monitor ist eine Progressive Web App (PWA) zur **Live-Begleitung und Bewertung von Capgemini-Trainees** (Institutees) während ihrer Kunden-Assignments. Die App wird vom jeweiligen Lead (Führungskraft / Mentor) auf dem Smartphone genutzt, um:
@@ -10,7 +12,7 @@ Assignment Monitor ist eine Progressive Web App (PWA) zur **Live-Begleitung und
**Nutzer:** Lars Stommer (Capgemini Management Consultant Trainee Program Lead)
**Sprache der App:** Deutsch (Bedienoberfläche), Englisch (Rating-Labels)
**Datenschutz:** Alle Daten bleiben lokal im Browser (IndexedDB). Kein Public Cloud Upload.
**Datenschutz:** Alle Daten bleiben lokal (V2: SQLite unter `server/data/`, kein Public-Cloud-Upload). Details: [`HANDOVER.md`](./HANDOVER.md).
---
@@ -31,8 +33,9 @@ MeetingInstance ← Ein konkreter Termin (z.B. "Briefing C
└── ConversationEntry[] ← Zeitleiste: wer spricht wann
└── Assessment[] ← Gesamtbewertung pro Institutee am Ende
ConversationEntry ← Ein Gesprächsbeitrag eines Institutees
ConversationEntry ← Ein zusammenhängender Sprecher-Beitrag (mehrzeilig) eines Institutees
└── ConversationSkillScore[] ← Kategorie-Schnellbewertung (während des Beitrags)
└── lineTags[] ← Kriterium-Zuordnung einzelner Zeilen (nachträglich, per Zeilentext)
FeedbackDimension ← Übergeordnete Dimension für das Assignment-Feedback
└── FeedbackCategory[] ← Kategorie (z.B. "Kommunikationsfähigkeit")
@@ -79,7 +82,7 @@ Wiederholbare Phasen (z.B. Alignment Calls) werden mit fortlaufendem `phaseIndex
### Aggregationslogik
**Gewichteter Durchschnitt** über alle Kriterien mit `weight`-Faktor (×1–×5):
**Gewichteter Durchschnitt** über alle Kriterien mit `weight`-Faktor (konfigurierbar `0,0`–`2,0` in `0,1`-Schritten — `0` blendet ein Kriterium komplett aus, z.B. für sprachliche Weichmacher/Füllwörter mit reduziertem Einfluss):
```
avg = Σ(score_i × weight_i) / Σ(weight_i)
@@ -99,6 +102,26 @@ Mapping auf Rating:
2. **Kriterium-Level (Gesamtbewertung am Ende des Meetings):** `Assessment.criteriaId` → `FeedbackCriterionItem.id`
Detaillierte Bewertung je Kriterium nach dem Meeting. Grundlage für die Kategorie-Farbkodierung im Gesamtbewertungs-Tab.
Verbindendes drittes Element: **Kriterium-Zuordnung einzelner Protokollzeilen** (`ConversationEntry.lineTags`). Der Lead schreibt während des Gesprächs einen zusammenhängenden, mehrzeiligen Beitrag pro Sprecher-Block; nachträglich (nicht während des Tippens, um den Schreibfluss nicht zu stören) kann jede einzelne Zeile über ein kleines Tag-Symbol direkt einem Kriterium zugeordnet werden. Diese Zuordnung ist die Grundlage für den Notation-Vorschlag (siehe unten) und fließt auch strukturiert in den KI-Prompt ein.
---
## Bewertungs-Vorschläge
Die App leitet an zwei Stellen automatisch einen Bewertungs-Vorschlag ab — beide bleiben reine Vorschläge, die der Lead frei übernehmen oder überschreiben kann.
### 1. Notation-Vorschlag in der Gesamtbewertung (pro Meeting)
Die Schnellnotations-Symbole (siehe unten) entsprechen einer Bewertungsstufe: `!` → Not, `(!)` → Partially, `(+)` → Nearly, `+` → Fully. Ist eine notierte Protokollzeile einem Kriterium zugeordnet (siehe oben), errechnet die App daraus einen Vorschlag für die Gesamtbewertung dieses Kriteriums ("Vorschlag aus Protokoll" mit Übernehmen-Button). Bei mehreren getaggten Zeilen zum selben Kriterium wird gemittelt. Jede Kategorie-Kopfzeile zeigt zusätzlich — auch zugeklappt — wie viele ihrer Kriterien einen offenen Vorschlag haben.
Füllwörter oder sprachliche Weichmacher ("ein bisschen") werden nicht automatisch erkannt, sondern über ein eigenes, niedrig gewichtetes Kriterium abgebildet, das ganz normal getaggt und notiert wird.
### 2. Zeitgewichteter Vorschlag über die Assignment-Laufzeit (`/evaluation`, Abschluss-Feedback)
Über mehrere Meetings hinweg gewichtet die App spätere Bewertungen stärker als frühere (Gewichtungsfaktor konfigurierbar unter Config → Gewichtung) und erkennt eine Verbesserung oder Verschlechterung eines Institutees über die Zeit. Der Vorschlag erscheint als Badge auf der Abschluss-Feedback-Seite, mit „Übernehmen" für den Bewertungswert und „Trend in Text übernehmen" für einen automatisch formulierten Hinweis auf die Entwicklung in Achievements/Development Needs.
Beide Vorschlags-Mechanismen greifen nicht in die manuell gepflegten Endergebnisse ein (`Assessment.score`, `FeedbackCategoryRating`) — sie liefern nur einen Ausgangspunkt.
---
## Feedback-Struktur (Abschluss-Feedback)
@@ -142,8 +165,8 @@ Im Gesprächsprotokoll unterstützt die App eine Schnellnotations-Syntax, die fa
**Format:** `{AssignmentNummer}_{Datum}_{PhasenLabel}{-#Nr}.{md|json}`
**Beispiel:** `CGI-2024-001_02-07-2026_Alignment Call-2.md`
- **Markdown:** Lesbare Dokumentation mit Protokoll, Bewertungen und Notizen
- **JSON:** Vollständige Datensicherung eines einzelnen Meetings
- **Markdown:** Lesbare Dokumentation mit Protokoll, Bewertungen und Notizen — getaggte Protokollzeilen zeigen zusätzlich das zugeordnete Kriterium
- **JSON:** Vollständige Datensicherung eines einzelnen Meetings, inklusive Zeilen-Tags
### Datenbank-Backup
Vollständiger Export aller Tabellen als JSON-Datei. Import löscht alle Daten und stellt den gesicherten Stand wieder her. Backup sollte nach jedem Meeting erstellt werden.
+281
View File
@@ -0,0 +1,281 @@
# Plan: Feedback-Neukonzeption, KI-Kaskadierung & UX
Stand: 2026-08-16 (Abgleich) · nur DEV (`AssigmentMonitorV2`)
Voraussetzung: Bewertungsskala 1–10 umgesetzt (`docs/SCALE_1_TO_10.md`).
Dieses Dokument ist die **Arbeitsliste**. Status der offenen Punkte gesamt: `docs/STATUS_UND_OFFENE_PUNKTE.md`.
**Fortschritt 2026-08-16:** Pakete **0, 1, 1b, 2, 3, 6, 7**, **8.3** und **UX.1–UX.2** (Tokens + Shell) erledigt; **4/5** Code weitgehend; UX.3–UX.8 offen. **Nächster Fokus:** UX.3 Dashboard / UX.4 Meeting.
---
## Zielbild (festgezogen)
### Assignment-Feedback (Gesamtauswertung pro Person)
| Ebene | Inhalt |
|---|---|
| **Kategorie** | Score 1–10 · Benefits · Concerns (Gesprächsbasis) |
| **Dimension** | Benefits · Concerns — **3 bis max. 5** Hauptpunkte (verdichtet) |
- PDF enthält **beides** (Kategorie + Dimension) — intern/Manager-Gespräch, spätere Anbindung Erfassungssystem.
- Keine Pflicht-Rubrik „Reifegrad pro Scorelevel 1–10“; Score-Vorschlag primär aus **zeitgewichteten Meeting-Kategorie-Scores**, KI darf ±1 mit Begründung feinjustieren.
- Achievements/Development Needs → fachlich **Benefits/Concerns** (UI-Sprache umstellen).
### KI-Kaskade Feedback
```text
Stufe A — 1 Call pro Kategorie (schmaler Kontext)
→ suggested Score, Benefits, Concerns (Kategorie)
Stufe B — 1 Call pro Dimension
Input: NUR Ergebnisse aus A (kein Rohprotokoll)
→ 3–5 Benefits + 3–5 Concerns (Dimension)
```
### KI-Kaskade Tagging („Vorschläge analysieren“)
```text
Nur ungetaggte Zeilen (bereits zugeordnete nie an KI)
→ Batches nach Zeilenanzahl UND Zeichenbudget
→ optional Hybrid: bei Monster-Batches Kriterien auf lokale Top-Kandidaten beschränken
→ Dimensions-Schnitt kein Standardweg
→ lokale Jaccard-Vorschläge + learnedPatternHints bleiben
```
---
## Entscheidungen (Nachtrag 2026-08-06)
1. **Score:** KI darf vorschlagen. Primärquelle = Meeting-Trend (wie bisherige Gewichtung). Keine 10-stufige Erwartungs-Rubrik als Voraussetzung; optional später globale Anker (z.B. 2/5/8/10), nicht jetzt.
2. **PDF:** Kategorie-Benefits/Concerns mit ausgeben.
3. **Tagging-Batches:** A (zeilen- + zeichenbasiert). B (Dimension) verworfen als Standard; Hybrid nur bei extrem großen Einträgen (Top-K Kriterien). C: getaggte Zeilen weiter ausschließen.
---
## Paket 0 — Aufräumen Skala 1–10 (Rest aus SCALE Phase 2–4)
Bereits weitgehend erledigt; nur nachziehen, was noch hinkt.
| # | Aufgabe | Done |
|---|---|---|
| 0.1 | Farbbänder speichern/laden (`getOrSeed`/`saveRatingColorBands` Server) — Hell-/Dunkelgrün unterscheidbar | ☑ `npm run smoke` + manuell |
| 0.2 | Chips Detail/History/PDF/MD aus `meetingCategoryRatings` (+ Fallback) | ☑ geprüft |
| 0.3 | Dimension-Prompts per „Auf Standard (1–10) setzen“ nachziehen / manuell testen | ☑ |
| 0.4 | Kurz-Smoke: Speichern Skala → Meeting-Einschätzung → Farben greifen nach Reload | ☑ |
**Exit:** Skala und Farben verhalten sich in Config, Meeting und Feedback konsistent.
---
## Paket 1 — Datenmodell Feedback (Benefits/Concerns)
| # | Aufgabe | Dateien (Orientierung) | Done |
|---|---|---|---|
| 1.1 | `FeedbackCategoryText`: `benefits`, `concerns`, `suggestedBenefits`, `suggestedConcerns` (+ Migration ALTER). Altes `text`/`suggestedText` entfernt (Dev: ggf. `npm run db:reset` oder Spalten bleiben ungenutzt in alter SQLite) | `types.ts`, `tableRegistry`, UI/PDF | ☑ |
| 1.2 | Dimension: DB `achievements`/`developmentNeeds` behalten; UI/PDF-Labels **Benefits/Concerns** | | ☑ |
| 1.3 | CRUD unverändert (generisch); Parser + Feedback-Seite + PDF angepasst | | ☑ |
| 1.4 | `npx tsc -b` grün | | ☑ |
**Exit:** Persistenz für Kategorie- und Dimension-Benefits/Concerns inkl. `suggested*`.
---
## Paket 2 — Prompt-Engine Stufe A (pro Kategorie)
| # | Aufgabe | Done |
|---|---|---|
| 2.1 | Neues Template (AppSettings oder pro Dimension): Kategorie-Call — Platzhalter nur für **eine** Kategorie (Struktur, Kriterien-Scores/Notizen dieser Cat, Meeting-Cat-Scores/Trend, getaggte Zeilen dieser Cat) | ☑ |
| 2.2 | Antwortformat Marker z.B. `SCORE:`, `BENEFITS:`, `CONCERNS:` — Parser analog `parseDimensionAiResponse` | ☑ |
| 2.3 | Score-Vorschlag: berechneten Trend **im Prompt vorgeben**; KI nur bestätigen oder ±1 mit Begründung (nicht frei aus Protokoll erfinden) | ☑ |
| 2.4 | Sequenz: alle Kategorien eines Institutee (Fortschritt, Teilfehler, Retry pro Kategorie) | ☑ |
| 2.5 | Config-UI: Kategorie-Prompt editierbar (+ Reset), Platzhalter-Legende | ☑ |
**Exit:** „KI generieren“ füllt `suggested*` auf Kategorie-Ebene; Score-Badge aus Trend bleibt führend.
---
## Paket 3 — Prompt-Engine Stufe B (Dimension verdichten)
| # | Aufgabe | Done |
|---|---|---|
| 3.1 | Dimension-Template umbauen: Input = Kategorie-Benefits/Concerns + Scores der Dimension; **kein** Rohprotokoll | ☑ |
| 3.2 | Output: genau 3–5 Benefits, 3–5 Concerns; Parser/Validierung (zu viele kürzen-Hinweis oder Prompt-Zwang) | ☑ |
| 3.3 | Orchestrierung: erst alle Cats der Dim (A), dann ein Call B; fehlende Cats = Retry A vor B | ☑ |
| 3.4 | Bestehende Dimension-Prompts in DB: Reset-Button / Sync auf neues Default-Template | ☑ |
**Exit:** Dimension-Texte sind Verdichtung, nicht Parallel-Erfindung aus dem Protokoll.
---
## Paket 4 — Feedback-UI
| # | Aufgabe | Done |
|---|---|---|
| 4.1 | Pro Kategorie: ScorePicker + Trend/KI-Score-Vorschlag („Übernehmen“) + Benefits/Concerns (editierbar + suggested-Boxen) | ☑ Code · Smoke ☐ |
| 4.2 | Pro Dimension: nur Benefits/Concerns (3–5), suggested übernehmen/verwerfen | ☑ Code · Smoke ☐ |
| 4.3 | Alten Ein-Text-pro-Kategorie und Achievements/DevNeeds-Labels entfernen bzw. umbenennen | ☑ Code · Smoke ☐ |
| 4.4 | „Trend in Text“ → sinnvoll auf Concerns oder Benefits mappen (Regel festlegen, z.B. Verschlechterung→Concern) | ☑ |
| 4.5 | Fortschrittsanzeige Generierung: Kategorie X/Y, dann Dimension Z | ☑ |
**Exit:** Direktgespräch möglich: Kategorie-Details + Dimensions-Hauptpunkte auf einer Seite.
---
## Paket 5 — PDF & sonstige Exporte
| # | Aufgabe | Done |
|---|---|---|
| 5.1 | `InstituteeFeedbackDocument` / Assignment-Report: pro Kategorie Score + Benefits + Concerns; pro Dimension Benefits + Concerns | ☑ Code · Smoke ☐ |
| 5.2 | Nur finale Felder, nie `suggested*` | ☑ Code · Smoke ☐ |
| 5.3 | Markdown/JSON Assignment-Feedback falls vorhanden nachziehen | ☐ |
**Exit:** Internes PDF für Manager-Gespräch brauchbar.
---
## Paket 6 — Tagging-Kaskade (Zeichen-Batches)
| # | Aufgabe | Done |
|---|---|---|
| 6.1 | Hilfsfunktion: offene Zeilen sammeln (unverändert: ohne bereits Getaggte, ohne Kundenzitate wie bisher) | ☑ `collectOpenProtocolLines` |
| 6.2 | Batch-Builder: max. Zeilen **und** max. Zeichensumme (Konstanten in `constants` oder AI_CONFIG, konfigurierbar später) | ☑ `buildCharAwareBatches` / `AI_CONFIG.taggingBatch*` |
| 6.3 | `analyzeSuggestions`: Schleife über Batches; Ergebnisse mergen; Fortschritt „Batch i/n“; Teilfehler retrybar | ☑ |
| 6.4 | Hybrid-Notnagel: wenn ein Batch trotz 1 Zeile zu groß (Struktur+Text), `{{KRITERIEN_STRUKTUR}}` auf Jaccard-Top-K der Batch-Zeilen beschränken | ☑ `narrowCriteriaIdsForBatch` |
| 6.5 | `MUSTER:`-Block: nach allen Batches einmal zusammenführen/schreiben oder nur aus Batches mit Treffern — Regel dokumentieren | ☑ Merge, später überschreibt früher; ein DB-Write am Ende |
| 6.6 | Info-Zeile + Rohantwort weiter nutzbar (pro Batch oder letzte) | ☑ Rohantworten mit Batch-Trennern |
**Exit:** Lange Protokolle brechen nicht mehr am Einzelcall; getaggte Zeilen bleiben draußen.
---
## Paket 7 — Robustheit KI-Client (gemeinsam)
Betrifft Feedback- und Tagging-Calls.
| # | Aufgabe | Done |
|---|---|---|
| 7.1 | Timeouts / Abbruch klar melden (nicht still) | ☑ `callOpenRouter` 90s + Abort-Meldung |
| 7.2 | Retry mit Backoff für transient failures (einmalig) | ☑ 429/5xx/Netz/Timeout |
| 7.3 | Grobe Prompt-Größen-Schätzung vor Call → Warnung oder Auto-Split | ☑ Soft-Warn + Hard-Limit; Tagging auto-split (6) |
| 7.4 | Gleiche `aiClient`-Hilfen für Feedback und Tagging | ☑ |
**Exit:** Abbrüche sind erklärbar und oft automatisch reparierbar.
---
## Paket UX — Professionelle Oberfläche (Capgemini-Tool, kein Marketing-Landing)
Bisher wirkt die App funktional, aber wie ein schneller Prototyp (graue Fläche, Emoji-Navigation, uneinheitliche Karten/Abstände). Ziel: **ruhig, markenklar, gut lesbar im Direktgespräch und im Live-Meeting** — nicht „bunte Dashboard-Show“.
### Leitplanken
- Capgemini-Brand `#0070AD` / Tailwind `brand` als Primärsignal; keine lila/Indie-Themes.
- Bestehende Interaktionsmuster behalten (Tabs, ScorePicker, Tag-Picker) — visuell vereinheitlichen, nicht neu erfinden.
- Schreibfluss im Meeting schützen (keine zusätzlichen Overlays beim Tippen).
- Emojis in Nav/Buttons schrittweise durch klare Labels oder einfache Icons ersetzen (oder stark reduzieren).
- Typografie und Abstände einmal zentral (`index.css` / kleine UI-Primitives), nicht Seite für Seite wildwuchs.
| # | Aufgabe | Done |
|---|---|---|
| UX.1 | **Design-Tokens:** Schrift, Abstände, Radius, Schatten, Flächen (`bg-app`, `surface`, `border-subtle`) in `index.css` / `@theme` — App-Shell (`App.tsx`) darauf umstellen | ☑ |
| UX.2 | **App-Chrome:** Header (Titel/Kontext), Bottom-Nav ohne Emoji-Overload, aktiver Zustand klar, sichere Touch-Targets | ☑ |
| UX.3 | **Dashboard / Assignment-Listen:** einheitliche Zeilen/Kacheln, Status, Typografie-Hierarchie (Nummer, Kunde, Institutees) | ☐ |
| UX.4 | **Meeting-Live-UX:** Einschätzung + Protokoll dichter und ruhiger; ScorePicker/Chips konsistent; Fokus auf Tippen + schnelle Scores | ☐ |
| UX.5 | **Feedback-Seite:** nach Paket 4 — klare Hierarchie Dimension → Kategorie; Benefits/Concerns optisch getrennt; KI-Vorschläge als „Entwurf“, nicht als Lärm | ☐ |
| UX.6 | **Config:** Tabs und Formulare angleichen (Skala, KI-Prompts, Struktur) — gleiche Button-/Hinweis-Muster | ☐ |
| UX.7 | **Leere Zustände & Fehler:** kurze, professionelle Leer-/Fehlertexte statt stiller Lücken | ☐ |
| UX.8 | **PDF-Feinschliff:** Typo/Abstände an Capgemini-Report-Anmutung (ohne Corporate-Template-Zwang) | ☐ |
**Timing:** UX.1–UX.2 früh (nach Paket 0) als Fundament. UX.4 mit Meeting-Arbeit; **UX.5 bewusst nach Paket 4** (sonst doppelte UI-Arbeit). UX.3/6/7 parallel zu funktionalen Paketen möglich. UX.8 nach Paket 5.
**Exit:** App wirkt wie ein internes Capgemini-Fachtool: einheitlich, ruhig, brandklar — ohne Feature-Regression.
---
## Paket 8 — SCALE / Struktur Prio-2 und bekannte Offenheiten
Nicht blockierend für Pakete 1–7 / UX; einplanen wenn Kapazität.
| # | Aufgabe | Quelle | Done |
|---|---|---|---|
| 8.1 | Sichtbarkeit Dim/Cat pro Typ — **vorgezogen nach Paket 1b** | SCALE Phase 6 | → 1b |
| 8.2 | Notation-Schnellbuttons / mobile Hit-Areas (kann in UX.4 aufgehen) | SCALE Phase 5 | ☐ |
| 8.3 | Dexie/IndexedDB-Legacy entfernen | STATUS T2 | ☑ |
| 8.4 | Server Seed-if-empty Assignment-Typen/Struktur | STATUS N5 (weitgehend durch `setup` ersetzt) | ☐ optional |
| 8.5 | Evaluation.tsx / FeedbackDraftPage auf neue Benefits/Concerns + Bänder prüfen oder Legacy deprecaten | STATUS T5 | ☐ |
| 8.6 | Datenschutz: Hinweis Tagging+Feedback (externe API) vor Prod | STATUS T6 | ☐ |
---
## Empfohlene Abarbeitungsreihenfolge
```text
0 / 1 / 1b / 2 / 3 / 6 / 7 / 8.3 ← erledigt
→ UX.1–UX.2 Tokens + Shell ← erledigt
→ UX.3 Dashboard · UX.4 Meeting ← nächster UX-Schritt
→ UX.5 Feedback · UX.6 Config · UX.7–8
→ T4 Smoke / 5.3 parallel möglich
→ T1 / T5 / T6 nach Bedarf
```
**Hinweis:** Feature-Stabilität vor UX war Absicht; UX.1–UX.2 sind Fundament für die Folgeschritte.
**Warum 1b vor 2 (historisch):** Stufe A und Feedback-UI müssen nur Kategorien/Dimensionen des Assignment-Typs sehen — erledigt.
---
## Paket 1b — Feedback-Struktur je Assignment-Typ (vorziehen aus 8.1)
Ziel: Ein Assignment-Typ blendet Dimensionen und/oder Kategorien aus → Meeting-Einschätzung, Tagging-Struktur und Assignment-Feedback arbeiten auf **derselben** Teilmenge.
| # | Aufgabe | Done |
|---|---|---|
| 1b.1 | Kanonischer Helper z.B. `resolveVisibleStructure(allDims, allCats, allItems, criteriaIds)` → `{ dimensions, categories, items }` (Cats ohne Items und Dims ohne Cats entfallen) — baut auf `filterVisibleFeedbackStructure` auf | ☑ |
| 1b.2 | Überall verdrahten: MeetingView, Assessment, Feedback-Seite, Tagging-Prompt, PDF-Feedback-Teil, History/Detail wo nötig | ☑ |
| 1b.3 | Config Ass.-Typen: Auswahl auf **Dimension- / Kategorie-Ebene** (Checkboxen), persistiert weiter als `criteriaIds` (alle Items der gewählten Cats) — kein zweites Parallel-Feld nötig | ☑ |
| 1b.4 | Leere `criteriaIds` = alles sichtbar (unverändert); Smoke mit Typ der z.B. nur 1–2 Dimensionen hat | ☐ manuell |
**Nicht nötig jetzt:** separates `dimensionIds[]`/`categoryIds[]` in der DB, solange die UI Dim/Cat pflegt und auf `criteriaIds` mappt.
**Exit:** Feedback und Einschätzung zeigen für denselben Assignment-Typ dieselbe Struktur; KI-Kaskade kann darauf aufsetzen.
---
## Empfohlene Abarbeitungsreihenfolge (Detail)
```text
0 → 1 → 1b → (6+7 optional) → 2 → 3 → 4 → 5 → 8 → UX
```
**Alternative, wenn Feedback-Calls zuerst stören:** nach 1b sofort `2→3→4→5`, Tagging `6→7` dazwischen wenn Abbrüche blockieren.
---
## Nicht-Ziele (jetzt)
- Produktiv-Migration / Mapping alter Enum-Skala
- 10-stufige Score-Rubrik pro Kategorie
- Dimensions-Score als eigene Pflicht-Ebene
- Tagging-Batches standardmäßig nach Dimension schneiden
- Automatischer KI-Call beim Meeting-Öffnen
- Anbindung externes Erfassungssystem (PDF/Struktur vorbereiten reicht)
- Komplett-Redesign als Marketing-Landing / Dark Mode / Illustration-Heavy UI
---
## Abnahmekriterien (Gesamt)
1. Feedback-Seite zeigt Kategorie-Score + Benefits/Concerns und Dimensions-Hauptpunkte (3–5).
2. Generierung läuft kaskadiert (Cat → Dim), Teilfehler retrybar, Prompt ohne wiederholtes Vollprotokoll in Stufe B.
3. PDF enthält Kategorie- und Dimension-Benefits/Concerns (final).
4. „Vorschläge analysieren“ arbeitet in zeichenbewussten Batches; bereits getaggte Zeilen gehen nicht an die KI.
5. Score-Vorschlag bleibt an Meeting-Trend gekoppelt; KI erfindet keinen Score aus dem Nichts.
6. Oberfläche wirkt professionell und einheitlich (Shell, Typo, Abstände, Meeting + Feedback).
7. `npx tsc -b` fehlerfrei; manuelle Smoke-Tests Meeting + Feedback + PDF.
---
## Nächster Schritt
Beim Start der Umsetzung: **Paket 0 kurz verifizieren**, optional **UX.1–UX.2** für den ersten visuellen Sprung, dann entscheiden ob zuerst **Paket 6 (Tagging)** oder **Paket 1+2 (Feedback-Schema/KI)**.
+115
View File
@@ -0,0 +1,115 @@
# Gitea — Repository-Setup (Assignment Monitor V2)
Dieses Projekt ist lokal ein Git-Repo auf Branch `main`. Für Gitea fehlt nur noch der Remote und der erste Push.
## Voraussetzungen
- Gitea-Zugang (Benutzerkonto auf dem Server)
- **HTTPS + Personal Access Token** (empfohhen unter Windows / Firmennetz) **oder** SSH-Key bei Gitea hinterlegt
- Keine Secrets im Repo: `.env` und `server/data/` sind in `.gitignore`
## 1. Repository in Gitea anlegen
1. In Gitea einloggen
2. **„+“ → New Repository** (oder Organisation wählen, dann „New Repository“)
3. Einstellungen:
- **Name:** `AssigmentMonitorV2` (oder gewünschter Name)
- **Private** (empfohlen — personenbezogene Trainingsdaten im Backup-Format)
- **Initialize repository:** alle Häkchen **aus** (kein README, keine .gitignore — existiert lokal schon)
4. Erstellen
Gitea zeigt danach die Push-URLs an, z. B.:
- HTTPS: `https://gitea.example.com/lars/AssigmentMonitorV2.git`
- SSH: `git@gitea.example.com:lars/AssigmentMonitorV2.git`
## 2. Remote hinzufügen (lokal)
HTTPS (empfohlen):
```powershell
cd C:\dev\AssigmentMonitorV2
git remote add origin https://gitea.example.com/<user>/AssigmentMonitorV2.git
git remote -v
```
SSH (Alternative):
```powershell
git remote add origin git@gitea.example.com:<user>/AssigmentMonitorV2.git
```
## 3. Authentifizierung
### HTTPS — Personal Access Token (empfohlen)
1. Gitea → **Settings → Applications → Generate New Token**
2. Scopes: mindestens **`write:repository`** (bzw. „repo“ je nach Gitea-Version)
3. Beim ersten `git push`:
- **Username:** Gitea-Benutzername
- **Password:** der Token (nicht das Login-Passwort)
Windows speichert Credentials oft über den Credential Manager (`credential.helper=manager`).
### SSH
1. Key erzeugen (falls noch keiner existiert):
```powershell
ssh-keygen -t ed25519 -C "lars.stommer@capgemini.com"
```
2. Öffentlichen Key (`~/.ssh/id_ed25519.pub`) in Gitea unter **Settings → SSH Keys** eintragen
3. Verbindung testen:
```powershell
ssh -T git@gitea.example.com
```
## 4. Ersten Push ausführen
```powershell
cd C:\dev\AssigmentMonitorV2
git push -u origin main
```
Falls Gitea standardmäßig `master` erwartet und leer ist, reicht obiger Befehl. Bei Konflikt mit vorgefertigtem Initial-Commit auf dem Server:
```powershell
git pull origin main --rebase
git push -u origin main
```
## 5. Täglicher Workflow
```powershell
git status
git add -A
git commit -m "kurze Beschreibung des Warums"
git push
```
Feature-Branches (optional):
```powershell
git checkout -b feature/feedback-kaskade-stufe-a
# … arbeiten …
git push -u origin feature/feedback-kaskade-stufe-a
```
In Gitea dann Pull Request / Merge Request erstellen.
## Datenschutz
- **Nicht committen:** `.env`, `server/data/*.sqlite3`, OpenRouter-API-Keys, Produktiv-Backups mit echten Personendaten
- **Private Repo** auf Gitea verwenden
- Backup-JSONs aus der App nur verschlüsselt/teambasiert teilen, nicht ins Repo legen
## Troubleshooting
| Problem | Lösung |
|---|---|
| `403` / `Authentication failed` | Token statt Passwort; Token-Scopes prüfen |
| `remote origin already exists` | `git remote set-url origin <neue-url>` |
| Große Dateien abgelehnt | Keine DB/Backups committen; ggf. Gitea-LFS nur wenn wirklich nötig |
| SSL-Zertifikat (interne CA) | Firmen-Root-Zertifikat in Windows/Git hinterlegen oder IT fragen |
+158 -154
View File
@@ -1,169 +1,173 @@
# Handover-Dokument — Assignment Monitor
# Handover-Dokument — Assignment Monitor V2
Dieses Dokument ermöglicht einem neuen Chat-Kontext, die Arbeit am Projekt nahtlos fortzuführen.
Einstieg für neue Chat-/Dev-Sessions. **Produktiv** (`c:\dev\AssigmentMonitor`) niemals anfassen.
> **DEV-Isolation:** Repo `AssigmentMonitorV2` · Ports **5174 / 4001** · SQLite `assignment-monitor-v2-dev.sqlite3`
> Details: [`DEV_ISOLATION.md`](./DEV_ISOLATION.md) · Team-Verteilung: [`TEAM_SETUP.md`](./TEAM_SETUP.md) · Offene Punkte: [`STATUS_UND_OFFENE_PUNKTE.md`](./STATUS_UND_OFFENE_PUNKTE.md)
---
## Stand (2026-08-16)
**Arbeitsverzeichnis:** `C:\dev\AssigmentMonitorV2`
### Zuletzt umgesetzt (Auswahl)
| Wann | Thema |
|---|---|
| 2026-08-16 | **Personen v2** E-Mail Pflicht · Gruppen umbenennen/löschen · Verschieben · Excel-Import · Archiv · Detail (Assignments/Feedbacks/Entwicklung) · Lösch-Kaskade |
| 2026-08-16 | **UX.3 Teil 1** Nav (Assignments/Feedbacks/Personen/Einstellungen) · Dashboard-Kachel-Grid · Plandaten · Typ-Farben · Filter/Überfällig |
| 2026-08-16 | **UX.1–UX.2** Design-Tokens + App-Chrome · **C0** Smoke · **C6/C7** Tagging/KI · **T2** Dexie entfernt |
| 2026-08 | Assignment-**Übergabe** Export/Import (Lead→Lead, inkl. Berater/Checklisten/Notizen) |
| 2026-08 | Team-**Starter-Paket** (`starter:export` / `bootstrap` / `setup` / `pack:zip`) |
| 2026-08 | Bewertungsskala **1–10**, Farbbänder, `meetingCategoryRatings` |
| 2026-08 | Feedback-Kaskade Stufe A (Kategorie) → B (Dimension), Benefits/Concerns |
| 2026-07 | Checklisten, selbstlernendes Kriterien-Tagging, PDF-Exporte, Papierkorb/Archiv, Meeting-Historie |
| 2026-07-04 | Lokaler Node/Express + `node:sqlite` statt IndexedDB als Primärspeicher |
**Laufende Arbeitsliste Feedback/KI:** [`FEEDBACK_CASCADE_PLAN.md`](./FEEDBACK_CASCADE_PLAN.md) — Pakete **0**, 1–3, 1b, **6, 7**, 8.3 erledigt; 4/5 Code weitgehend (manuelles Smoke/5.3 offen).
**Kanonischer Status + offene Punkte:** [`STATUS_UND_OFFENE_PUNKTE.md`](./STATUS_UND_OFFENE_PUNKTE.md) — als Nächstes **T4**.
---
## Worum geht es?
**Assignment Monitor** ist eine PWA für Lars Stommer (Capgemini Management Consultant Trainee Program Lead). Die App wird auf dem Smartphone genutzt, um Trainees (intern: „Institutees") während ihrer Kunden-Assignments live zu begleiten und zu bewerten. Lars führt die Meetings, beobachtet die Trainees und möchte sofort Notizen und Bewertungen erfassen, ohne Stift/Papier.
PWA für die Live-Bewertung von Capgemini-Trainees („Institutees“) während Kunden-Assignments: Meetings protokollieren, Kriterien taggen, einschätzen, Abschluss-Feedback (Benefits/Concerns) erzeugen.
---
## Tech-Stack
- **React 18 + TypeScript + Vite** (PWA)
- **Tailwind CSS v4** (`@import "tailwindcss"` — kein `tailwind.config.js`!)
- **Dexie.js v5** als IndexedDB-Wrapper (lokale DB im Browser, kein Backend)
- **React Router v6**
- **Capgemini-Brandfarbe:** `#0070AD`
- Arbeitsverzeichnis: `C:\dev\AssigmentMonitor`
## Bewertungsskala (kritisch für alle Berechnungen)
```typescript
type FeedbackRating = 'na' | 'not_client_ready' | 'partially_client_ready' | 'nearly_client_ready' | 'client_ready'
// Numerisch: na=0, not=1, partially=2, nearly=3, fully=4
// Labels: N/A, Not, Partially, Nearly, Fully
// Farben: grau, rot, orange, hellgrün, dunkelgrün
// N/A gilt als "nicht gesetzt" — aus allen Berechnungen ausgeschlossen!
```
Aggregation: **gewichteter Durchschnitt** (avg < 1.5 → Not, < 2.5 → Partially, < 3.5 → Nearly, ≥ 3.5 → Fully)
## Datenmodell-Kern (was zu wissen ist)
### Schlüssel-Unterschied: zwei `criteriaId`-Semantiken
```
Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung nach Meeting)
ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung während Gespräch)
```
Das klingt inkonsistent — ist aber so gewollt und funktioniert so.
### AssignmentType.criteriaIds
```typescript
// Leer = alle Kriterien anzeigen
// Befüllt = nur diese FeedbackCriterionItem.id anzeigen
criteriaIds?: number[] // → FeedbackCriterionItem.id
```
Filterlogik (in MeetingView + AssignmentDetail):
```typescript
const itemFilter = aType?.criteriaIds?.length ? new Set(aType.criteriaIds) : null
const filteredItems = itemFilter ? allItems.filter(i => itemFilter.has(i.id!)) : allItems
const visibleCatIds = new Set(filteredItems.map(i => i.categoryId))
const filteredCats = itemFilter ? allCats.filter(c => visibleCatIds.has(c.id!)) : allCats
```
### Dateiname für Meeting-Exporte
```typescript
`${assignment.assignmentNumber ?? assignment.title}_${date}_${template.label}${phaseIndex > 1 ? `-${phaseIndex}` : ''}.${ext}`
// Beispiel: CGI-2024-001_02-07-2026_Alignment Call-2.md
```
## Routing-Übersicht
```
/ Dashboard
/assignment/new Neues Assignment
/assignment/:id AssignmentDetail
/assignment/:id/edit AssignmentEdit
/assignment/:id/meeting/:meetingId MeetingView ← WICHTIG: meetingId != assignmentId
/assignment/:id/feedback/:instituteeId AssignmentFeedbackPage
/assignment/:id/feedback-draft/:instituteeId FeedbackDraftPage (Legacy)
/evaluation Auswertung (veraltet!)
/consultants Berater
/config Konfiguration (3 Tabs)
```
MeetingView liest den Param als: `const { id, meetingId: meetingIdParam } = useParams()`
## Konfigurationsbereich
**Tab "Feedback"** (`FeedbackStructureConfig.tsx`):
- Dimensionen → Kategorien → Kriterium-Items (mit Gewichtung ×1–×5)
- Nur Feedback-Struktur, kein AssignmentType-CRUD mehr!
**Tab "Ass.-Typen"** (`AssignmentTypeConfig.tsx`):
- AssignmentTypen CRUD
- Pro Typ: Sub-Tabs "Phasen" und "Kriterien"
- Kriterien-Tab: Baumstruktur Dimension → Kategorie → Items (Checkbox, Indeterminate)
**Tab "Backup"** (`Configuration.tsx`):
- JSON-Export aller Tabellen via `exportFullBackup()`
- JSON-Import via `importFullBackup(file)` (löscht alles, dann bulkAdd)
## Bekannte offene Punkte (Priorität nach Dringlichkeit)
### Sofort-Fixes (einfach)
1. **Dashboard zeigt keine Assignment-Nummer** — `Dashboard.tsx` Zeile ~57: `{a.assignmentNumber && <span>...{a.assignmentNumber}</span>}` hinzufügen
2. **AssignmentCreate hat kein Nummer-Feld** — Inputfeld für `assignmentNumber` hinzufügen
3. **Toter Code in FeedbackStructureConfig** — State-Variablen `assignmentTypes`, `phaseTemplates`, `showCatalogs`, `showTypeConfig`, `expandedType`, `newTypeName`, `newPhase`, `typeError` + alle Handler `toggleCatalogCategory`, `addAssignmentType`, `updateAssignmentTypeName`, `deleteAssignmentType`, `addPhaseTemplate`, `updatePhaseTemplate`, `deletePhaseTemplate` entfernen
### Mittlere Aufgaben
4. **Evaluation.tsx neu schreiben** — nutzt `db.categories` + `db.criteria` (Legacy). Soll `feedbackCriterionItems` + `assessments` nutzen und Rating-Labels zeigen
5. **meetingExport.ts anpassen** — Score-Aufschlüsselung nutzt `db.criteria`, sollte `feedbackCriterionItems` nutzen; Kategorie-Namen im Markdown fehlen
6. **AI-Prompt in AssignmentFeedbackPage** — nutzt `db.criteria` (alt), sollte `feedbackCriterionItems` + neue Assessment-Scores nutzen
### Große Aufgaben
7. **SQLite WASM + OPFS** — Migration weg von IndexedDB. Konzept steht, Implementierung steht aus.
## Stil-Regeln (bitte einhalten)
- **Tailwind v4**: kein `bg-[#0070AD]` via config, direkt als CSS-Variable nicht nötig — `bg-[#0070AD]` im Class-String funktioniert direkt
- **Keine Kommentare** außer für nicht-offensichtliche Invarianten
- **Kein `rows={1}` + JS-Autoresize** — besser View/Edit-Toggle oder `fieldSizing: 'content'` via Inline-Style
- **Rating-Buttons** immer mit `RATING_OPTIONS`-Array (nicht neu definieren):
```typescript
{ value, short, color (inaktiv), active (aktiv) }
```
- **Weighted-Average** immer: N/A excludieren, dann `Σ(score×weight)/Σ(weight)`
## Notations-Parser
`src/utils/notationParser.tsx` exportiert `<NotationText text={string} />` — rendert `+`, `(+)`, `!`, `(!)`, `>`, `[…]` farbig. Überall verwenden wo Protokoll-Text angezeigt wird.
## DB-Backup
`src/utils/dbBackup.ts` exportiert:
```typescript
exportFullBackup(): Promise<void> // Download als JSON
importFullBackup(file: File): Promise<{ ok: boolean; error?: string }> // Clears + bulkAdd
```
Alle 20 Tabellen-Namen sind in `TABLE_NAMES` aufgelistet — bei neuen Tabellen dort ergänzen.
## Seed-Daten
`src/main.tsx` ruft beim Start auf:
1. `seedIfEmpty()` — 3 AssignmentTypen + Legacy-Kriterien
2. `seedFeedbackStructureIfEmpty()` — 5 Dimensionen, 14 Kategorien, ~70 Items
3. `seedCriterionMappingsIfEmpty()` — Legacy-Mappings
4. `migrateToUnifiedCriteriaIfNeeded()` — Migration auf FeedbackCategory-IDs in PhaseTemplates
## Datenschutz-Hinweise
- Alle Daten lokal, kein Cloud-Backend
- GDPR-relevant: Institutee-Namen + Kundennamen in der DB
- KI-API: OpenRouter, API-Key in localStorage (nicht im Klartext loggen!)
- Backup-JSON enthält alle personenbezogenen Daten → vertraulich behandeln
## TypeScript-Build
| | |
|---|---|
| Frontend | **React 19** + TypeScript + Vite (PWA) |
| Routing | **React Router 7** (`react-router-dom`) |
| CSS | Tailwind v4 — `@import "tailwindcss"`, Brand `brand` / `#0070AD` |
| Daten | Lokaler **Express** + **`node:sqlite`** (kein better-sqlite3), RPC `POST /api/rpc` |
| Ports (V2) | Frontend **5174**, API **4001** |
| DB-Datei | `server/data/assignment-monitor-v2-dev.sqlite3` (gitignored) |
| Tabellen | **26** — einzige Quelle: `server/db/tableRegistry.ts` |
```bash
npx tsc --noEmit # Muss ohne Fehler durchlaufen
npm run dev # Dev-Server starten
npm run dev:all # Vite :5174 + API :4001
npx tsc -b # TypeScript — NICHT tsc --noEmit am Root
npm run setup # Starter-Struktur einspielen
npm run pack:zip # Team-ZIP nach dist-release/ (ohne DB)
npm run pack:laptop # Umzug: Code + volle Dev-DB
```
Vor jeder Abgabe: `npx tsc --noEmit` ausführen und alle Fehler beheben.
---
## Wichtige Eigenheiten / Fallstricke
## Bewertungsskala (1–10)
1. **`MeetingInstance.generalNotes`**: Kann in alten Datensätzen `undefined` sein → immer `?? ''` fallback
2. **`Assessment.criteriaId`**: Zeigt auf `FeedbackCriterionItem.id`, NICHT auf `FeedbackCategory.id` — das verwirrt, weil der Feldname `criteriaId` ist
3. **`PhaseKey`**: Ist `type PhaseKey = string` (kein Union-Typ mehr)
4. **`aType2`** in `AssignmentDetail.tsx`: Doppelte Variable aus Refactoring — `aType` wird zweimal deklariert, zweite heißt `aType2`. Technische Schuld.
5. **`expandedCat`** in `MeetingView`: `Record<instituteeId, categoryId | null>` — öffnet pro Institutee genau eine Kategorie gleichzeitig
6. **Dexie v5**: `bulkAdd` schlägt fehl wenn IDs schon vorhanden → Backup-Import leert erst alle Tabellen
```typescript
type RatingScore = number // 1–10 ganzzahlig; unset = null (kein N/A-String mehr)
```
- Farbbänder konfigurierbar: Config → **Skala** (`ratingColorBands` in `appSettings`)
- Notation in Protokollen: **führende Zahl** `1`–`10` am Zeilenanfang (`parseNotationPrefix`); `>` Zitat, `[…]` Abschnitte bleiben
- Meeting-Pflichtscore oft auf **Kategorie**-Ebene (`meetingCategoryRatings`); Kriterien bleiben Beobachtungs-/Detail-Ebene
- Aggregation: gewichtet `Σ(score×weight)/Σ(weight)`; `Σweight===0` → null; Details `docs/SCALE_1_TO_10.md`
**Legacy:** Alte Enum-Skala `not_client_ready` … und Notation `+`/`!` sind abgelöst — nicht neu einbauen.
---
## Datenmodell-Kern
### `criteriaId`-Semantiken (unverändert kritisch)
```
Assessment.criteriaId → FeedbackCriterionItem.id
ConversationSkillScore.criteriaId → FeedbackCategory.id
ConversationLineTag.criterionItemId → FeedbackCriterionItem.id
```
### Sichtbare Struktur je Assignment-Typ
`AssignmentType.criteriaIds` (leer = alle). Kanonisch:
`resolveVisibleStructure()` / `filterVisibleFeedbackStructure()` in `src/db/queries/feedbackStructure.ts` — nicht erneut inline.
### Checkliste
- `PhaseTemplate.hasChecklist` + `checklistItemDefs` / `checklistResponses`
- Effektives Kriterium: Antwort-Override oder Config-`linkedCriterionItemId` (`getEffectiveChecklistCriterionId`)
- UI im Gesprächsprotokoll-Tab (kein eigener Meeting-Tab)
- Tagging: eigener Prompt `checklistTaggingPromptTemplate` (`PUNKT n:`), getrennt vom Protokoll (`ZEILE n:`)
---
## Routing
```
/ Dashboard (+ Import Übergabe)
/assignment/new
/assignments/trash | /assignments/archive
/assignment/:id Detail (+ Export Übergabe, PDF)
/assignment/:id/edit
/assignment/:id/history Gesamtprotokoll
/assignment/:id/meeting/:meetingId MeetingView ← meetingId ≠ Assignment-ID
/assignment/:id/feedback/:instituteeId
/assignment/:id/feedback-draft/:instituteeId Legacy
/evaluation | /consultants | /config
```
---
## Konfiguration (6 Tabs)
| Tab | Inhalt |
|---|---|
| Feedback | Dimensionen → Kategorien → Kriterien (Gewicht 0,0–2,0) |
| Ass.-Typen | Phasen, Checklisten, Kriterien-Sichtbarkeit, Standard-Zuordnung (KI) |
| Gewichtung | Zeitgewichtungs-Faktor Trend |
| Skala | Farbbänder 1–10 |
| KI-Prompts | Kategorie-/Dimension-Templates, Protokoll- + Checklisten-Tagging |
| Backup | Voll-Backup JSON (Wipe-Import) |
---
## Team & Übergabe
| Zweck | Wie |
|---|---|
| Frische Struktur ohne Personen | `docs/starter/starter-structure.json` · `npm run setup` |
| ZIP an Kollegen | `npm run pack:zip` → `dist-release/` · Anleitung `EINRICHTUNG.md` |
| Laptop-Umzug (Code + volle DB) | `npm run pack:laptop` → `dist-release/` · Anleitung `UMZUG.md` |
| Assignment an anderen Lead | Detail **↔ Übergabe** / Dashboard **↔ Import** (`assignmentTransfer`) |
Import prüft Berater per Vor-/Nachname (wiederverwenden oder anlegen); Feedback-Struktur muss auf dem Ziel (Starter) passen.
---
## Stil-Regeln
- Keine Kommentare außer nicht-offensichtlichen Invarianten
- Kein Auto-Resize-Textarea via `rows={1}` + JS
- Scores: `ScorePicker` / `resolveScoreStyle` / `RATING_SCORES` — keine alten `RATING_OPTIONS`-Enums neu erfinden
- Gewichtete Mittel: immer `weightedAverageScore` / `weightedAverageRating` in `ratingTrend.ts`
- Zeilen splitten: `splitNoteLines()` — nicht `note.split('\n')` inline
- Cross-Boundary: Dateien für Client+Server nur aus `src/db/types.ts` / `src/config/constants.ts` (in `tsconfig.server.json` include)
---
## Datenschutz
- Daten nur lokal unter V2-`server/data/` · kein Cloud-Upload
- GDPR: Institutee-/Kundennamen, Gesprächsnotizen
- KI-Key in `localStorage` — nie loggen
- Backup- und Übergabe-JSON = personenbezogen → vertraulich
- Produktiv-Backup nicht in V2-Experimente mischen
---
## Fallstricke
1. `MeetingInstance.generalNotes` → immer `?? ''`
2. `Assessment.criteriaId` ≠ Kategorie-ID
3. `npx tsc --noEmit` am Root prüft nichts — immer `npx tsc -b`
4. V2-Ports 5174/4001 — Start bricht bei 5173/4000 ab
5. Protokoll-Tagging-Prompt in DB darf kein `{{CHECKLISTEN_PUNKTE}}` mehr enthalten (Auto-Migration in `getOrSeedCriterionTaggingPromptTemplate`)
6. Dexie/IndexedDB-Legacy ist entfernt (2026-08-16) — nicht wieder einführen; Struktur über Starter/`npm run setup`
+100
View File
@@ -0,0 +1,100 @@
# Konzept: Bewertungsskala 1–10 (AssignmentMonitorV2)
Stand: 2026-08-06 · nur DEV (`AssigmentMonitorV2`), Produktiv unberührt.
## Festgezogene Entscheidungen
| # | Entscheidung |
|---|---|
| Skala | **1–10**, ganzzahlig; `null` = nicht gesetzt (kein N/A-String mehr) |
| Primäre Ebene | **Kategorie** — Meeting-Bewertung und Assignment-Feedback setzen den Score hier |
| Kriterien | Primär **Beobachtungen** (Tags, Notizen, Gewichtung); nicht die Pflicht-Bewertungsebene |
| Warum Kategorie direkt? | Nicht alle Kriterien sind in jedem Meeting beobachtbar → Score darf **nicht** nur aus Kriterien-Ø abgeleitet werden müssen |
| Notation | Führende Zahl `1`–`10` am Zeilenanfang; **keine** `+` / `!` / `(+)` / `(!)` mehr; `>` Zitat und `[…]` Abschnitte bleiben |
| Farben | 4 Bänder, **konfigurierbar** unter Config (Defaults unten) |
| Labels | Nur Zahlen, keine Ankertexte |
| Altdaten | Keine Migration; frische Dev-DB (`npm run db:reset` bei Bedarf) |
| Struktur | In V2 über Starter/`npm run setup` und Config pflegbar (Stand 2026-08) |
| Typ-Strukturen | Sichtbarkeit über `criteriaIds` + `resolveVisibleStructure` (Cascade 1b) |
| Schnelle Zuordnung | `lineTags` / Tag-Picker / Vorschläge bleiben |
### Default-Farbbänder
Überlappung an der 5 in der Erstidee bereinigt:
| Score | Farbe |
|---|---|
| 1–2 | rot |
| 3–5 | orange |
| 6–8 | hellgrün |
| 9–10 | dunkelgrün |
Speicherung in `appSettings.ratingColorBands` (JSON), editierbar in einem neuen Config-Bereich „Skala / Farben“.
---
## Zielmodell (Daten)
```text
Beobachtung (Kriterium)
lineTags / generalNoteTags / Assessment.note
optionale Notations-Zahl auf der Zeile → Vorschlag / Detail
Meeting-Bewertung (Pflicht-Skala)
NEU bzw. klar: Score 1–10 pro Kategorie × Institutee × Meeting
direkt setzbar, unabhängig davon ob alle Kriterien getaggt sind
Assignment-Feedback
FeedbackCategoryRating.rating → 1–10
Vorschlag aus zeitgewichteten Meeting-Kategorie-Scores
Checkliste
ChecklistResponse.rating → 1–10 (gleiche Skala/Farben)
```
### Speicherung Meeting-Kategorie-Score
Neue Tabelle `meetingCategoryRatings`:
- `meetingInstanceId`, `instituteeId`, `categoryId`, `score` (INTEGER nullable 1–10), optional `note`
Bestehende `ConversationSkillScore` (Schnellscore am Protokoll-Eintrag) ebenfalls auf 1–10 umstellen — bleibt optionaler Feinschliff während des Tippens, ersetzt aber nicht die Meeting-Gesamtbewertung pro Kategorie.
`Assessment.score` (pro Kriterium): optional `number | null` für Detail/KI; UI der Gesamtbewertung fokussiert auf **Kategorien**. Kriterien darunter zeigen Beobachtungen + optionalen Detail-Score.
---
## Umsetzungsphasen
### Phase 1 — Skalen-Kern ✅ (2026-08-06)
- Types: `RatingScore` 1–10, `null` = unset; `meetingCategoryRatings`; `ratingColorBands`
- `constants.ts`: Bänder, `resolveScoreStyle`, `ScorePicker`
- Config-Tab „Skala“
- `ratingTrend` / Notation (führende Zahl) / Meeting-/Feedback-/Export-UI umgestellt
- Hard-Delete räumt `meetingCategoryRatings` + `checklistResponses` auf
### Phase 2 — Meeting-UI Feinschliff
- Notation-Schnellbuttons weiter verfeinern; Farbbänder live aus Config laden (nicht nur Defaults)
- Detail/History-Chips primär aus `meetingCategoryRatings`
### Phase 3 — Feedback & Auswertung
- Trend/Vorschlag konsequent aus Meeting-Kategorie-Scores
- **Neukonzeption Benefits/Concerns + KI-Kaskade:** siehe `docs/FEEDBACK_CASCADE_PLAN.md`
### Phase 4 — Export & KI
- Persistierte Dimension-Prompts auf neue Skalen-Sprache zurücksetzen/syncen
- Kategorie-Benefits/Concerns im PDF (Teil von `FEEDBACK_CASCADE_PLAN.md` Paket 5)
### Phase 5 — UX-Feinschliff
- Slider/Stepper, mobile Hit-Areas; Schreibfluss schützen
### Phase 6 (Prio 2) — Struktur je Assignment-Typ
- Sichtbarkeit Dimension/Kategorie pro Typ — **umgesetzt als Paket 1b** (`resolveVisibleStructure`, Config → Ass.-Typen → Struktur)
---
## Nicht-Ziele (jetzt)
- Produktiv-Migration / Mapping alter Enum-Werte
- Ankertexte auf der Skala
- Getrennte Taxonomien pro Assignment-Typ (erst Prio 2)
+62
View File
@@ -0,0 +1,62 @@
# Smoke-Tests — Assignment Monitor V2
Stand: 2026-08-16 · nur DEV
## Automatisiert (C0 Kern + C6/C7-Logik)
```powershell
cd C:\dev\AssigmentMonitorV2
npm run smoke
```
Prüft u.a.: Score-Normalisierung, Default-Farbbänder inkl. Hell-/Dunkelgrün, DB-Roundtrip Farbbänder (stellt vorherigen Stand wieder her), Tagging-Batches, offene Zeilen ohne Tags/Zitate, Prompt Soft/Hard-Limit.
Kein Browser, keine echte OpenRouter-API.
---
## Manuell — C0 Skala (UI, ~10–15 Min)
Voraussetzung: `npm run dev:all` → http://localhost:5174
### 0.1 / 0.4 Farbbänder + Reload
1. **Config → Skala** öffnen.
2. Grenzen leicht ändern (z.B. Rot bis 3 statt 2) → speichern.
3. Seite neu laden (F5) → Werte müssen gleich bleiben.
4. Optional: `npm run smoke` danach — Roundtrip bleibt grün; eigene Werte bleiben erhalten.
### 0.2 / 0.4 Meeting → Chips
1. Assignment mit Institutee öffnen → Meeting mit Einschätzung.
2. Im Tab **Gesamtbewertung** / Kategorie-Scores Werte setzen (z.B. 2, 6, 9).
3. Speichern / Meeting verlassen.
4. Prüfen:
- **Assignment-Detail**: Chips farbig (rot / hellgrün / dunkelgrün unterscheidbar)
- **📜 Gesamtprotokoll**: gleiche Scores/Farben
- Optional: Meeting-**Export MD** enthält Scores
5. Config → Skala wieder auf Default setzen (falls geändert).
### 0.3 KI-Prompts Standard
1. **Config → KI-Prompts**
2. Eine Dimension „Auf Standard zurücksetzen“ (1–10 / Benefits-Concerns-Vorlage).
3. Auf Feedback-Seite Prompt-Vorschau kurz ansehen — Platzhalter/Struktur wirken stimmig.
**C0 abhaken:** erledigt 2026-08-16 (`npm run smoke` + Abnahme).
---
## Manuell — C6 Batches (optional, ~5 Min)
1. Meeting mit **≥15 ungetaggten** Protokollzeilen (kein `>`, keine Tags).
2. **🏷 Vorschläge analysieren** (API-Key nötig).
3. Erwartung: Fortschritt `Protokoll-Batch i/n`, Info mit Batch-Anzahl, Rohantwort mit `--- Protokoll-Batch ---`.
---
## Manuell — T4 Feedback kurz (optional)
1. Assignment → Feedback einer Person.
2. Benefits/Concerns auf Kategorie + Dimension sichtbar; ScorePicker 1–10.
3. PDF Institutee-Feedback: finale Benefits/Concerns, keine `suggested*`.
+158 -87
View File
@@ -1,98 +1,169 @@
# Projektstatus und offene Punkte — Assignment Monitor
# Projektstatus und offene Punkte — Assignment Monitor V2
Stand: 2026-07-02
Stand: **2026-08-16** (Abgleich Code + Session) · nur DEV (`AssigmentMonitorV2`) · Produktiv unberührt
Kanonische Einstiege: [`HANDOVER.md`](./HANDOVER.md) · Isolation: [`DEV_ISOLATION.md`](./DEV_ISOLATION.md) · Feedback-Arbeitsliste: [`FEEDBACK_CASCADE_PLAN.md`](./FEEDBACK_CASCADE_PLAN.md)
> Ältere STATUS-Stände (Juli 2026, IndexedDB/WASM/Enum-Skala) sind **ersetzt**. Offene Punkte unten sind gegen den Code abgeglichen.
---
## Implementierungsstatus
## Kurzfazit
### ✅ Vollständig implementiert
| Feature | Seite / Datei |
|---|---|
| Dashboard: Assignment-Liste | `Dashboard.tsx` |
| Assignment anlegen (Typ, Institutees, Phasen-Preview) | `AssignmentCreate.tsx` |
| Assignment nachbearbeiten (Nummer, Typ-Wechsel-Warnung, Institutee-Laufzeiten) | `AssignmentEdit.tsx` |
| Phasen-Flow-Ansicht pro Assignment | `AssignmentDetail.tsx` |
| Soft-Delete + Papierkorb für Meetings | `AssignmentDetail.tsx` |
| Bewertungs-Chips je Institutee + Kategorie in der Übersicht | `AssignmentDetail.tsx` |
| Live-Gesprächsprotokoll mit Sprecher-Zeitlinie | `MeetingView.tsx` |
| Schnellnotation (+, !, >, […]) mit farbigem Rendering | `MeetingView.tsx`, `notationParser.tsx` |
| Äh-Counter pro Institutee (live + nachträgliche Anpassung) | `MeetingView.tsx` |
| Gesamtbewertung auf Kriterium-Ebene (Accordion, farbige Kategorie-Header) | `MeetingView.tsx` |
| Auto-Calc Bewertung aus Protokoll-Kategorie-Scores | `MeetingView.tsx` |
| Allgemeine Notizen mit Auto-Resize + Notation-Rendering | `MeetingView.tsx` |
| Meeting-Export: Markdown + JSON, strukturierter Dateiname | `meetingExport.ts` |
| Assignment-Nummer im Dateinamen | `MeetingView.tsx`, `AssignmentDetail.tsx` |
| Strukturiertes Abschluss-Feedback pro Institutee | `AssignmentFeedbackPage.tsx` |
| KI-Feedback-Generierung via OpenRouter | `AssignmentFeedbackPage.tsx` |
| Feedback-Status: Entwurf → Final | `AssignmentFeedbackPage.tsx` |
| Feedback-Dimensionsstruktur CRUD mit Gewichtung ×1–×5 | `FeedbackStructureConfig.tsx` |
| AssignmentTyp CRUD mit Phasen-Templates | `AssignmentTypeConfig.tsx` |
| Kriterien-Auswahl je Typ (Baumstruktur, Indeterminate) | `AssignmentTypeConfig.tsx` |
| Kriterien-Filterung je Typ in Meetings + Übersicht | `MeetingView.tsx`, `AssignmentDetail.tsx` |
| Vollständiges DB-Backup (JSON Export/Import) | `dbBackup.ts`, `Configuration.tsx` |
| Berater/Gruppen-Verwaltung | `Consultants.tsx` |
| PWA (installierbar, Offline-fähig) | Vite-PWA-Plugin |
Die V2-App ist für den DEV-/Team-Einsatz **funktional weitgehend fertig**: Skala 1–10, Meetings/Checklisten/Tagging, Feedback-KI-Kaskade A→B, Starter-ZIP, Assignment-Übergabe.
**Heute erledigt:** … **UX.3 Teil 1**; **Personen v2** (E-Mail, Gruppen-CRUD, Verschieben, Excel-Import, Archiv, Detail inkl. Entwicklung, Lösch-Kaskade).
**Als Nächstes:** Meeting-Polish (UX.4); parallel optional T4.
---
## ⚠️ Offene Punkte / Bugs
## Implementierungsstatus (Ist)
### Priorität Hoch
### Kernplattform
| # | Beschreibung | Datei | Aufwand |
|---|---|---|---|
| H1 | **IndexedDB-Robustheit**: Browser kann IndexedDB unter Speicherdruck löschen. Migration zu SQLite WASM + OPFS geplant. Bis dahin: regelmäßige Backups als einzige Sicherheit. | `db/index.ts` | L (Wochen) |
| H2 | **Backup-Reminder fehlt**: Es gibt keine automatische Erinnerung / keinen Hinweis nach abgeschlossenem Meeting, dass ein Backup erstellt werden sollte. | `MeetingView.tsx` | S |
### Priorität Mittel
| # | Beschreibung | Datei | Aufwand |
|---|---|---|---|
| M1 | **Evaluation.tsx veraltet**: Nutzt die Legacy-`Category`/`Criterion`-Tabellen, nicht die neue `feedbackCriterionItems`-Struktur. Zeigt falsche / keine Daten aus neuen Meetings. | `Evaluation.tsx` | M |
| M2 | **AI-Prompt veraltet**: `AssignmentFeedbackPage` liest `db.criteria` (alt) für Score-Zeilen. Sollte auf `feedbackCriterionItems` + `assessments` umgestellt werden. | `AssignmentFeedbackPage.tsx` | M |
| M3 | **meetingExport.md veraltet**: Kriterien-Scores werden über `db.criteria` aufgelöst, nicht `feedbackCriterionItems`. Kategorie-Namen fehlen im Export. | `meetingExport.ts` | S |
### Priorität Niedrig
| # | Beschreibung | Datei | Aufwand |
|---|---|---|---|
| N1 | **Dashboard**: Zeigt keine Assignment-Nummer. Nur Titel + Kunde + Typ. | `Dashboard.tsx` | XS |
| N2 | **AssignmentCreate**: Kein Feld für Assignment-Nummer. Muss nachträglich über Edit eingegeben werden. | `AssignmentCreate.tsx` | XS |
| N3 | **FeedbackStructureConfig**: Toter Code — Funktionen für AssignmentType-CRUD wurden verschoben, Deklarationen blieben (`assignmentTypes`, `phaseTemplates` State + alle zugehörigen Handler). | `FeedbackStructureConfig.tsx` | XS |
| N4 | **Evaluation-Route**: Zeigt Scores als Dezimalzahlen `/5` mit alter Skala statt neuer Rating-Labels. | `Evaluation.tsx` | S |
| N5 | **AssignmentCreate**: Erstellt keine `instituteeEnrollments`. Von/Bis-Daten können nur über Edit gepflegt werden. | `AssignmentCreate.tsx` | S |
| N6 | **Meeting-Route**: URL ist `/assignment/:id/meeting/:meetingId` — `:id` ist die Assignment-ID, aber die Assignment-Nummer (z.B. CGI-2024-001) ist nicht in der URL. Akzeptiert als nice-to-have. | `App.tsx` | M |
---
## Geplante Erweiterungen (Roadmap)
### SQLite WASM + OPFS (Datenbankevolution)
**Ziel:** Robuste lokale Datenhaltung ohne Installation, ohne Risiko durch Browser-Speicherdruck.
**Technologie:** SQLite compiled to WebAssembly, persistiert via Origin Private File System (OPFS).
**Vorteil:** Echte Datei auf Gerät, nicht löschbar wie IndexedDB. Kein Server nötig.
**Status:** Konzept beschlossen. Implementierung steht aus. Paralleles Backup-System ist die aktuelle Notlösung.
### Evaluation neu (M1 oben)
Auswertungsseite auf neue Datenstruktur migrieren. Soll zeigen:
- Pro Institutee: aggregierte Kriterien-Scores über alle Meetings
- Trend über mehrere Assignments
- Vergleich zwischen Institutees
### Dashboard-Verbesserungen (N1 oben)
- Assignment-Nummer anzeigen
- Filtern nach Status (aktiv/abgeschlossen)
- Sortierung nach Datum / Assignment-Nummer
---
## Bekannte Datenkonsistenz-Risiken
| Risiko | Beschreibung | Mitigation |
| Feature | Status | Ort |
|---|---|---|
| `criteriaIds` auf `AssignmentType` | Referenziert `FeedbackCriterionItem.id`. Wenn Kriterien gelöscht werden, bleiben verwaiste IDs in `criteriaIds`. Filter ignoriert fehlende IDs stillschweigend. | Beim Löschen von Items: `criteriaIds` in allen AssignmentTypes bereinigen |
| `Assessment.criteriaId` | Referenziert `FeedbackCriterionItem.id`. Kein FK-Constraint in IndexedDB. | Beim Löschen von Items: zugehörige Assessments löschen |
| `ConversationSkillScore.criteriaId` | Referenziert `FeedbackCategory.id`. Gleiche Gefahr. | Beim Löschen von Kategorien: ConversationSkillScores bereinigen |
| Typ-Wechsel bei Assignment | Zeigt Warnung, löscht aber keine alten Meeting-Bewertungen. Bewertungen mit IDs aus dem alten Typ-Kriteriensatz bleiben erhalten, werden aber möglicherweise nicht mehr angezeigt. | Dokumentiertes Verhalten, absichtlich so gestaltet |
| React 19 + Vite PWA, Router 7, Tailwind v4 | ☑ | `package.json`, `src/` |
| Express + `node:sqlite`, RPC `POST /api/rpc` | ☑ | `server/` |
| 26 Tabellen via `tableRegistry` (Schema + Backup) | ☑ | `server/db/tableRegistry.ts` |
| Client-Queries 1:1 Server-Queries | ☑ | `src/db/queries/`, `server/db/queries/` |
| DEV-Ports 5174/4001, Pfad-Guards | ☑ | `.env.example`, `database.ts` |
| Dexie/IndexedDB-Legacy | ☑ entfernt | kein `dexie`, kein `schema.ts`/`seeds/` |
### Bewertung & Meetings
| Feature | Status | Ort |
|---|---|---|
| Skala 1–10, Farbbänder, ScorePicker | ☑ inkl. Smoke (C0) | Config → Skala, `constants.ts`, `npm run smoke` |
| Meeting-Kategorie-Scores | ☑ | `meetingCategoryRatings` |
| Protokoll + Notation (führende Zahl), Füllwörter | ☑ | `ConversationTab`, `notationParser` |
| Kriterium-Tags Zeile / allgemeine Notizen | ☑ | `lineTags`, `generalNoteTags` |
| Checklisten (Config + Meeting + Export) | ☑ | `ChecklistTab`, `checklists` RPC |
| Papierkorb/Archiv Assignments + Meeting-Trash | ☑ | Dashboard, Detail |
| Gesamtprotokoll Historie | ☑ | `MeetingHistory.tsx` |
| PDF Assignment-Report + Institutee-Feedback | ☑ | `pdfExport.tsx` |
| MD/JSON Meeting-Export | ☑ | `meetingExport.ts` |
### Feedback & KI
| Feature | Status | Ort |
|---|---|---|
| Benefits/Concerns Kategorie + Dimension | ☑ Code · Smoke ☐ (T4) | `AssignmentFeedbackPage`, Schema |
| KI-Kaskade Stufe A (Cat) → B (Dim) | ☑ | `aiPrompt.ts`, Config → KI-Prompts |
| Tagging Protokoll (`ZEILE n:`) inkl. Zeichen-/Zeilen-Batches | ☑ | `taggingBatches.ts`, `MeetingView.analyzeSuggestions` |
| Checklisten-Tagging (`PUNKT n:`) gebatcht | ☑ | `checklistTagging.ts` |
| KI-Client: Timeout, Retry, Prompt-Größen-Guard | ☑ | `aiClient.ts`, `AI_CONFIG` |
| Typ → sichtbare Struktur | ☑ | `resolveVisibleStructure` |
### Verteilung & Übergabe
| Feature | Status | Ort |
|---|---|---|
| Starter-Struktur ohne Personen | ☑ | `docs/starter/`, `npm run setup` |
| Team-ZIP | ☑ | `npm run pack:zip`, `EINRICHTUNG.md` |
| Laptop-Umzug ZIP | ☑ | `npm run pack:laptop`, `UMZUG.md` (Code + volle DB) |
| Assignment-Übergabe Export/Import | ☑ | `assignmentTransfer`, Detail ↔ / Dashboard ↔ |
### Cascade-Plan (Kurz)
| Paket | Status |
|---|---|
| 0 Smoke Skala | ☑ |
| 1 / 1b / 2 / 3 | ☑ |
| 4 / 5 UI+PDF Benefits | ☑ Code · Smoke ☐; 5.3 MD/JSON-Feedback ☐ |
| 6 Tagging-Batches | ☑ |
| 7 KI-Robustheit | ☑ |
| 8.3 Dexie-Legacy | ☑ |
| UX-Paket | UX.1–UX.3 Teil1 ☑ · Personen v2 ☑ · UX.4–UX.8 ☐ |
Details und Checkboxen: [`FEEDBACK_CASCADE_PLAN.md`](./FEEDBACK_CASCADE_PLAN.md).
---
## Offene Punkte (priorisiert)
### Hoch / als Nächstes sinnvoll
| ID | Thema | Hinweis |
|---|---|---|
| **T4** | Cascade 4/5 Feinschliff | Benefits/Concerns UI+PDF smoke; optional 5.3 MD/JSON Assignment-Feedback |
### Mittel
| ID | Thema | Hinweis |
|---|---|---|
| **T1** | npm-Deprecations / Audit | z.B. ungenutztes `recharts`, transitive Warnungen — beim nächsten Release/ZIP |
| **T5** | Evaluation / FeedbackDraft Legacy | an 1–10 + Benefits anpassen oder deprecaten (Cascade 8.5) |
| **T3** | Backup-Reminder nach Meeting | nie gebaut |
| **T6** | Datenschutz Tagging+Feedback (externe API) | vor Produktivnutzung organisatorisch |
### Niedrig
| ID | Thema | Hinweis |
|---|---|---|
| **N1** | `instituteeEnrollments` schon beim Anlegen | Create vs. nur Edit |
| **N2** | Assignment-Nummer in URL | Nice-to-have |
| **N3** | Notation-Schnellbuttons / mobile Hit-Areas | Cascade 8.2 / UX |
| **N4** | UX-Paket (Cascade) | UX.1–UX.3 Teil1 ☑ · Personen v2 ☑ · UX.4 Meeting offen |
| **N5** | Server seed-if-empty | weitgehend durch Starter/`setup` ersetzt — optional |
### Erledigt / obsolet (nicht wieder öffnen)
| ID / Thema | Status |
|---|---|
| **C0** Smoke Skala 1–10 | ☑ 2026-08-16 — `npm run smoke` (31 pass) + Abnahme |
| **C6** Tagging-Batches | ☑ 2026-08-16 — `taggingBatches.ts`; Limits in `AI_CONFIG` |
| **C7** KI-Client Timeout/Retry/Prompt-Guard | ☑ 2026-08-16 — `aiClient.ts` |
| **T2** Dexie/IndexedDB-Legacy | ☑ 2026-08-16 — Dependency + `schema.ts` + `seeds/` entfernt |
| Cascade 1 / 1b / 2 / 3 | ☑ Benefits-Schema, Sichtbarkeit, KI A→B |
| IndexedDB → SQLite WASM + OPFS | Obsolet — lokaler Server + SQLite |
| `db/queries/`-Layer fehlt | ☑ 2026-07-04 |
| Selbstlernendes Tagging „Idee“ | Basis + Batches erledigt |
| Prompt-System Neubau „ungescoped“ | Stufe A/B + Config erledigt |
| Enum-Skala Client-Ready | Abgelöst durch 1–10 |
| KI „komplett kaputt“ (alter Monolith) | Architektur ersetzt |
### Produktiv-Kontext (nicht V2-Dev)
| Thema | Hinweis |
|---|---|
| Echtdaten-Migration Produktiv → ggf. späteres System | V2 eigene DB + Starter; Produktiv-Ordner unangetastet lassen |
---
## Empfohlene Reihenfolge
```text
UX.4 Meeting · UX.5 Feedback · UX.6 Config · UX.7–8
→ T4 Cascade 4/5 Smoke + ggf. 5.3
→ T1 npm-Bereinigung (nächstes Team-ZIP/Release)
→ T5 Legacy Evaluation/FeedbackDraft (oder deprecaten)
→ T6 Datenschutz vor Prod
```
---
## Bekannte Konsistenz-Risiken
| Risiko | Mitigation |
|---|---|
| Verwaiste IDs in `criteriaIds` / Tags nach Kriterium-Löschung | Cascade/`reassign` in Feedback-Struktur-Config |
| Assignment-Übergabe braucht passende Feedback-Struktur auf dem Ziel | Gleicher Starter; Import mappt per Name |
| Checkliste ↔ Assessment | Kein Auto-Spiegel; Evidence über Primärquellen |
| Voll-Backup-Import = Wipe | Nicht mit Assignment-Übergabe verwechseln |
| Sehr lange Einzelzeile im Protokoll | Wird nicht mitten im Text gesplittet — eigener Batch / Struktur-Verengung / Hard-Limit |
---
## Dokumentations-Landkarte
| Doc | Rolle |
|---|---|
| `HANDOVER.md` | Session-Einstieg, Stack, Fallstricke |
| `STATUS_UND_OFFENE_PUNKTE.md` | **Diese Datei** — Ist + Offene Punkte (kanonisch) |
| `SMOKE_TESTS.md` | Automatisierter `npm run smoke` + manuelle UI-Checkliste (C0/C6/T4) |
| `DEV_ISOLATION.md` | Ports, Guards, Produktiv-Trennung |
| `TEAM_SETUP.md` / `EINRICHTUNG.md` | Kollegen-Onboarding / ZIP |
| `SCALE_1_TO_10.md` | Skalen-Konzept |
| `FEEDBACK_CASCADE_PLAN.md` | Feature-Arbeitsliste Feedback/KI |
| `CLAUDE.md` | Agent-Regeln + lange Erledigt-Historie |
| `FACHLICHE_` / `TECHNISCHE_ARCHITEKTUR.md` | Historisch — bei Widerspruch HANDOVER/STATUS/Code gewinnen |
+114
View File
@@ -0,0 +1,114 @@
# Team-Setup — Assignment Monitor V2
Verteilung an Teammitglieder **nur über dieses Repo** (`AssigmentMonitorV2`).
Das Produktivsystem (`c:\dev\AssigmentMonitor`, Ports 5173/4000) wird **nicht** angefasst und darf nicht verändert werden.
## Was im Starter-Paket steckt
Datei: [`docs/starter/starter-structure.json`](./starter/starter-structure.json)
| Enthalten | Nicht enthalten |
|---|---|
| Feedback-Struktur (Dimensionen, Kategorien, Kriterien) | Personen / Groups / Consultants |
| Dimension-Prompts, Tagging-Prompts, Farbbänder | Assignments, Meetings, Notizen |
| Assignment-Typen, Phasen, Checklisten-Definitionen | Scores, Feedback-Entwürfe, Backups mit Echtdaten |
`learnedPatternHints` aus echten Protokollen werden beim Export entfernt.
## Neuinstallation per ZIP (ohne Git)
1. ZIP entpacken (z.B. nach `C:\dev\AssigmentMonitorV2`)
2. Anleitung im Paket: **`EINRICHTUNG.md`** (Kurzfassung)
```powershell
cd C:\dev\AssigmentMonitorV2
copy .env.example .env
npm install
npm run setup
npm run dev:all
```
(`npm run setup` = Starter-Struktur; alternativ `npm run bootstrap -- --yes`)
Öffnen: **http://localhost:5174**
ZIP erzeugen (Maintainer, nur V2):
```powershell
npm run pack:zip
```
Die Datei liegt unter `dist-release/AssignmentMonitor-Team-YYYY-MM-DD.zip` (gitignored, enthält keine Dev-DB und kein `.env`).
### Laptop-Umzug (Code + komplette Datenbank)
Für den eigenen Rechnerwechsel, nicht für Kollegen:
```powershell
npm run pack:laptop
```
Datei: `dist-release/AssignmentMonitor-Umzug-YYYY-MM-DD.zip` — enthält die SQLite unter `server/data/` (personenbezogene Daten). Anleitung im Paket: **`UMZUG.md`**. Am Ziel **kein** `npm run setup` (sonst wird die mitgelieferte DB überschrieben).
### Assignment-Übergabe (Lead → Lead)
Nicht das Team-ZIP — sondern ein einzelnes Assignment inkl. Notizen/Checklisten/Beratern:
- **Export:** Assignment öffnen → **↔ Übergabe**
- **Import:** Dashboard → **↔ Import**
Voraussetzung: gleiche Feedback-Struktur (Starter) auf beiden Rechnern. Details: `docs/HANDOVER.md`, RPC `assignmentTransfer`.
## Neuinstallation per Git
Voraussetzungen: **Node.js 25+** (wegen `node:sqlite`), Git.
```powershell
git clone <URL-dieses-Repos>
cd AssigmentMonitorV2
copy .env.example .env
npm install
npm run setup
npm run dev:all
```
Öffnen: **http://localhost:5174** (nicht 5173).
Optional: OpenRouter-API-Key unter **Config → KI-Prompts / Feedback**.
## Starter aktualisieren (Maintainer, nur V2)
Nach Änderungen an Struktur/Typen/Checklisten/Prompts in der **eigenen V2-Dev-DB**:
```powershell
cd C:\dev\AssigmentMonitorV2
npm run starter:export
git add docs/starter/starter-structure.json
git commit -m "Starter-Paket: Struktur aktualisiert"
```
Teammitglieder holen die Datei per `git pull` und spielen bei Bedarf neu ein:
```powershell
npm run bootstrap -- --yes
```
**Achtung:** `bootstrap` löscht die lokale V2-Dev-DB-Inhalte (Meetings etc.) und ersetzt sie durch das Starter-Paket.
## Sicherheitsregeln
- Nie Produktiv-Ordner, -Ports (5173/4000) oder Produktiv-SQLite verwenden — siehe [`DEV_ISOLATION.md`](./DEV_ISOLATION.md).
- Starter-Skripte brechen ab bei `API_PORT=4000`, `PORT=5173` oder Dateiname `assignment-monitor.sqlite3`.
- Kein Produktiv-Backup in V2 importieren, wenn ihr nur Struktur teilen wollt.
## npm-Scripts
| Script | Zweck |
|---|---|
| `npm run starter:export` | Struktur aus V2-Dev-DB → `docs/starter/starter-structure.json` |
| `npm run bootstrap -- --yes` | Starter in V2-Dev-DB einspielen (Wipe) |
| `npm run setup` | Wie bootstrap + legt `.env` an falls fehlend |
| `npm run pack:zip` | Versandfertiges Team-ZIP nach `dist-release/` (ohne DB) |
| `npm run pack:laptop` | Laptop-Umzug: Code + komplette Dev-DB nach `dist-release/` |
| `npm run db:reset` | Nur Dev-DB-Datei löschen (leere DB beim nächsten Start) |
| `npm run dev:all` | Frontend :5174 + API :4001 |
+73 -23
View File
@@ -1,5 +1,7 @@
# Technische Architektur — Assignment Monitor
> **Stand Hinweis (2026-08-16):** Dieses Dokument ist **historisch** (React 18, Dexie/IndexedDB, Router 6, Enum-Skala). Aktueller Stack: React 19, Router 7, Express + `node:sqlite`, Skala 1–10 — siehe [`HANDOVER.md`](./HANDOVER.md), [`STATUS_UND_OFFENE_PUNKTE.md`](./STATUS_UND_OFFENE_PUNKTE.md). Bei Widerspruch gewinnen HANDOVER/STATUS/Code.
## Stack
| Schicht | Technologie | Version | Zweck |
@@ -17,29 +19,44 @@
---
## Projektstruktur
## Projektstruktur (aktualisiert nach Architektur-Refactoring, 2026-07-02)
```
src/
config/
constants.ts ← RATING_OPTIONS, INST_COLORS, AI_CONFIG, RATING_NUM_MAP, BRAND_COLOR, DEFAULT_RATING_TREND_WEIGHT_STEP, RATING_TREND_DELTA_THRESHOLD
db/
index.ts ← Dexie DB-Klasse, alle Interfaces, Seed-Funktionen, Migrations
index.ts ← reiner Re-Export von types/schema/seeds (bestehende Imports bleiben kompatibel)
types.ts ← alle Interfaces, FeedbackRating-Typ
schema.ts ← Dexie DB-Klasse + alle Migrationsversionen
seeds/
assignmentTypes.ts ← seedIfEmpty() — 3 AssignmentTypen + Legacy-Kriterien
feedbackStructure.ts ← seedFeedbackStructureIfEmpty() — Dimensionen/Kategorien/Items
migrations.ts ← seedCriterionMappingsIfEmpty(), migrateToUnifiedCriteriaIfNeeded()
index.ts ← Re-Export der Seed-Funktionen
pages/
Dashboard.tsx ← Assignment-Liste (Home)
AssignmentCreate.tsx ← Neues Assignment anlegen
AssignmentDetail.tsx ← Phasen-Flow, Meeting-Übersicht, Bewertungs-Chips
AssignmentEdit.tsx ← Assignment nachträglich bearbeiten
MeetingView.tsx ← Live-Meeting: Protokoll + Gesamtbewertung
AssignmentFeedbackPage.tsx ← Strukturiertes Abschluss-Feedback + KI-Generierung
FeedbackDraftPage.tsx ← Einfacher Feedback-Entwurf (Legacy)
Evaluation.tsx ← Auswertung (teilweise veraltet, nutzt alte Criterion-Tabelle)
meeting/
MeetingView.tsx ← Route-Komponente: State, DB-Handler, Header, Tabs
ConversationTab.tsx ← Gesprächsprotokoll-UI
AssessmentTab.tsx ← Gesamtbewertungs-UI (Accordion je Kategorie), Notation-Vorschlag
CriterionTagPicker.tsx ← Chip+Popover mit Suche, Kriterium-Zuordnung pro Protokoll-Zeile
AssignmentFeedbackPage.tsx ← Strukturiertes Abschluss-Feedback + KI-Generierung + Trend-Vorschlag
FeedbackDraftPage.tsx ← Einfacher Feedback-Entwurf (Legacy-UI, Datenzugriff auf feedbackCriterionItems migriert)
Evaluation.tsx ← Auswertung — zeitgewichteter Bewertungs-Vorschlag + Trend, gruppiert nach Assignment
Configuration.tsx ← Tab-Container für alle Konfigurationsseiten
FeedbackStructureConfig.tsx ← Dimensionen/Kategorien/Kriterien CRUD + Gewichtung
AssignmentTypeConfig.tsx ← AssignmentTypen + Phasen + Kriterien-Auswahl (Baum)
RatingWeightConfig.tsx ← Config-Tab "Gewichtung": Zeitgewichtungs-Faktor für Bewertungs-Vorschlag
Consultants.tsx ← Berater/Gruppen-Verwaltung
utils/
meetingExport.ts ← Markdown + JSON Export-Logik
dbBackup.ts ← Vollständiges DB-Backup (JSON Export/Import)
notationParser.tsx ← +/!/>/[…] Notation → farbiges JSX
notationParser.tsx ← +/!/>/[…] Notation → farbiges JSX, splitNoteLines(), detectNotationRating()
ratingTrend.ts ← Zeitgewichteter Bewertungs-Vorschlag + Trend-Erkennung
App.tsx ← Route-Definitionen, Navigation
main.tsx ← React-Einstiegspunkt, DB-Seed-Aufruf
```
@@ -48,10 +65,10 @@ src/
## Datenmodell (IndexedDB via Dexie v5)
### DB-Version: 5
### DB-Version: 6
```typescript
// Konfiguration (Legacy, nur noch für Evaluation.tsx)
// Konfiguration (Legacy, kein aktiver Seiten-Konsument mehr)
categories: '++id, order'
criteria: '++id, categoryId, order'
@@ -88,8 +105,13 @@ feedbackDimensionTexts: '++id, assignmentFeedbackId, feedbackDimensionId'
// Mappings (Legacy, kaum genutzt)
criterionCategoryMappings: '++id, criterionId, feedbackCategoryId'
criterionLevelDescriptions: '++id, criterionItemId, rating'
// App-Einstellungen (Singleton, id immer 1), seit Version 6
appSettings: '++id'
```
`ConversationEntry.lineTags` (Kriterium-Zuordnung pro Zeile) ist ein reines Objektfeld ohne eigenen Index — kein Versions-Bump nötig, da Dexies `.stores()` nur Indizes definiert, nicht das volle Objekt-Schema.
### Wichtige Interface-Details
```typescript
@@ -135,12 +157,34 @@ interface FeedbackCriterionItem {
id?: number
categoryId: number
name: string
weight?: number // Gewichtung ×1–×5, default 1
weight?: number // 0,0–2,0 in 0,1-Schritten, default 1 (seit 2026-07-03; vorher grobe ×1–×5-Stufen)
order: number
}
// Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung)
// ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung)
interface ConversationLineTag {
text: string // exakter Zeilentext, 1:1 wie in ConversationEntry.note
criterionItemId: number // → FeedbackCriterionItem.id
}
interface ConversationEntry {
id?: number
meetingInstanceId: number
instituteeId: number
sequenceIndex: number
note: string // ganzer Sprecher-Turn, mehrzeilig
fillerCount: number
updatedAt: string
lineTags?: ConversationLineTag[] // Kriterium-Zuordnung pro Zeile, gematcht per Zeilentext
}
interface AppSettings {
id?: number // Singleton, immer 1
ratingTrendWeightStep: number // Zeitgewichtungs-Faktor für den Bewertungs-Vorschlag
}
// Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung)
// ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung)
// ConversationLineTag.criterionItemId → FeedbackCriterionItem.id (Zeilen-Zuordnung, bewusst anders benannt)
```
---
@@ -157,7 +201,7 @@ interface FeedbackCriterionItem {
/assignment/:id/feedback-draft/:instituteeId FeedbackDraftPage (Legacy)
/evaluation Auswertungsübersicht
/consultants Berater-Verwaltung
/config Konfiguration (3 Tabs: Feedback | Ass.-Typen | Backup)
/config Konfiguration (4 Tabs: Feedback | Ass.-Typen | Gewichtung | Backup)
```
---
@@ -168,7 +212,7 @@ interface FeedbackCriterionItem {
CRUD für:
- Feedback-Dimensionen (mit Reihenfolge ↑/↓)
- Feedback-Kategorien je Dimension
- Feedback-Kriterium-Items je Kategorie (mit Gewichtung ×1–×5)
- Feedback-Kriterium-Items je Kategorie (mit Gewichtung `0,0–2,0` in `0,1`-Schritten)
### Tab "Ass.-Typen" → `AssignmentTypeConfig`
CRUD für:
@@ -177,6 +221,9 @@ CRUD für:
- Kriterien-Auswahl je Typ: Baumstruktur Dimension → Kategorie → Item (mit Checkbox, Indeterminate-State)
- `criteriaIds = []` → alle Kriterien werden angezeigt
### Tab "Gewichtung" → `RatingWeightConfig`
- Ein Regler für `AppSettings.ratingTrendWeightStep` (Zeitgewichtungs-Faktor des Bewertungs-Vorschlags), mit Live-Vorschau der resultierenden Gewichte
### Tab "Backup" → in `Configuration.tsx`
- JSON-Export aller Tabellen
- Zweistufiger JSON-Import mit Überschreib-Warnung
@@ -197,6 +244,7 @@ function catMode(cat: FeedbackCategory, fbItems: FeedbackCriterionItem[], getSco
.filter((x): x is { score: FeedbackRating; w: number } => x.score !== null && x.score !== 'na')
if (scored.length === 0) return null
const wSum = scored.reduce((s, x) => s + x.w, 0)
if (wSum === 0) return null // alle beteiligten Kriterien auf Gewicht 0 → sonst NaN < x überall false, fällt auf "Fully" durch
const avg = scored.reduce((s, x) => s + NUM_MAP[x.score] * x.w, 0) / wSum
if (avg < 1.5) return 'not_client_ready'
if (avg < 2.5) return 'partially_client_ready'
@@ -205,6 +253,8 @@ function catMode(cat: FeedbackCategory, fbItems: FeedbackCriterionItem[], getSco
}
```
Dieselbe `Σweight === 0`-Absicherung gilt für jede gewichtete Mittelung in der App (auch `buildGroupMeetingScores()` in `ratingTrend.ts`) — seit Gewicht `0` ein gültiger Wert ist, ist das kein theoretischer Randfall mehr.
---
## Export-Dateiname-Schema
@@ -227,8 +277,9 @@ const buildFilename = (ext: string) => {
- **Provider:** OpenRouter (https://openrouter.ai) — ermöglicht Modellwechsel ohne eigenen API-Zugang
- **Modelle:** GPT-4o mini, GPT-4o, Claude Sonnet 4.5, Claude Haiku 4.5, Gemini Flash 1.5
- **API-Key:** Lokal in `localStorage` gespeichert (`ai_api_key`, `ai_model`)
- **Datenweitergabe:** Kriterien-Scores, Protokoll-Notizen, Kategorie-Bewertungen werden im Prompt strukturiert übermittelt
- **Hinweis:** Der AI-Prompt nutzt noch die alte `criteria`-Tabelle (Legacy) — Aktualisierung auf `feedbackCriterionItems` steht aus
- **Datenweitergabe:** Kriterien-Scores + Notizen (Assessment und getaggte Protokoll-Zeilen zusammengeführt pro Kriterium), Kategorie-Bewertungen, zeitgewichteter Trend pro Kategorie werden im Prompt strukturiert übermittelt (`buildAiPrompt`, nutzt korrekt `feedbackCriterionItems`, alter `db.criteria`-Bug ist gefixt)
- **Bekanntes Problem:** Der Call schlägt aktuell fehl (vermutlich Capgemini-Netzwerk/Firewall blockiert `openrouter.ai`), Root Cause nicht untersucht
- **Geplanter Umbau (nicht gescoped):** Mehrstufiges, pro Dimension konfigurierbares Prompt-System mit Platzhaltersystem soll den aktuellen Einzel-Prompt ablösen
---
@@ -237,7 +288,7 @@ const buildFilename = (ext: string) => {
Die App legt beim ersten Start automatisch an:
1. **3 Assignment-Typen** mit je vollständigem Phasen-Flow (Generisch, Case Interview, Stakeholder Meeting / Pitch)
2. **Legacy-Kriterien** in `categories` + `criteria` (für Evaluation.tsx)
2. **Legacy-Kriterien** in `categories` + `criteria` (kein aktiver Seiten-Konsument mehr — `Evaluation.tsx` und `FeedbackDraftPage.tsx` sind beide auf `feedbackCriterionItems` migriert; die Tabellen bleiben aus historischen Gründen im Backup/Import)
3. **Feedback-Dimensionsstruktur** mit 5 Dimensionen, 14 Kategorien, ~70 Kriterium-Items (Capgemini-Kompetenzmodell)
4. **Criterion-Mappings** (Legacy, nicht mehr aktiv genutzt)
@@ -247,10 +298,9 @@ Die App legt beim ersten Start automatisch an:
| Bereich | Problem | Priorität |
|---|---|---|
| `Evaluation.tsx` | Nutzt alte `Category`/`Criterion`-Tabellen statt neue `feedbackCriterionItems` | Mittel |
| `meetingExport.ts` | Bewertungs-Labels im Markdown-Export zeigen `FeedbackRating`-Keys statt Labels | Niedrig |
| `FeedbackStructureConfig.tsx` | Enthält toten Code (Funktionen für gelöschte AssignmentType-CRUD) | Niedrig |
| AI-Prompt in `AssignmentFeedbackPage` | Nutzt `db.criteria` (alt), sollte `feedbackCriterionItems` nutzen | Mittel |
| Dashboard | Zeigt keine Assignment-Nummer | Niedrig |
| `AssignmentCreate` | Kein Feld für Assignment-Nummer | Niedrig |
| `meetingExport.ts` | Bewertungs-Labels im Markdown-Export zeigen `FeedbackRating`-Keys (z.B. `client_ready`) statt sprechender Labels | Niedrig |
| KI-Generierung | `generateWithAi()` schlägt fehl (vermutlich Netzwerk/Firewall), Root Cause offen | Hoch |
| Prompt-System | Aktueller Einzel-Prompt soll mehrstufig/pro Dimension konfigurierbar werden — eigene Design-Session nötig | Hoch (nicht gescoped) |
| Selbstlernendes Tagging | Idee, automatische Tag-Vorschläge aus bisherigen Zuordnungen abzuleiten — eigene Design-Session nötig | Mittel (nicht gescoped) |
| IndexedDB | Keine robuste Persistenz-Garantie (Browser kann löschen) | Hoch → SQLite WASM geplant |
| `db/queries/`-Layer | Fehlt — DB-Zugriffe direkt aus Komponenten, erschwert SQLite-Migration | Mittel |
+199
View File
@@ -0,0 +1,199 @@
# Feedback-Struktur
## Client-Readiness
### Problem Structuring
Übersetzt eine zunächst offene oder komplexe Kundenfragestellung in eine präzise, logisch gegliederte und bearbeitbare Problemstruktur, die eine fokussierte Analyse und zielgerichtete Entscheidungsfindung ermöglicht.
- **Problem- und Zielklarheit** (Gewicht 1.0) — Klärt Ausgangslage, eigentliches Problem, angestrebtes Ergebnis und relevante Entscheidung, bevor mit der Bearbeitung begonnen wird.
- **Scope-Klarheit** (Gewicht 1.0) — Grenzt Untersuchungsgegenstand, Betrachtungszeitraum, Stakeholder, Annahmen und Nicht-Ziele nachvollziehbar ab.
- **Logische Zerlegung** (Gewicht 1.0) — Zerlegt komplexe Fragestellungen in verständliche, trennscharfe und gemeinsam hinreichend vollständige Teilfragen.
- **Hypothesenorientierung** (Gewicht 1.0) — Formuliert frühzeitig plausible, überprüfbare Hypothesen und nutzt sie zur Steuerung der weiteren Analyse.
- **Priorisierung nach Relevanz** (Gewicht 1.0) — Fokussiert die Struktur auf die entscheidungs- und wirkungsrelevanten Fragestellungen und vermeidet unnötige Analysebreite.
- **Treiber- und Abhängigkeitsverständnis** (Gewicht 1.0) — Erkennt wesentliche Ursachen, Wirkzusammenhänge, Abhängigkeiten und Wechselwirkungen innerhalb der Fragestellung.
- **Ableitung eines Analyseplans** (Gewicht 1.0) — Übersetzt die Problemstruktur in konkrete Arbeitsschritte, benötigte Informationen, Verantwortlichkeiten und sinnvolle Prüfsequenzen.
### Problem Solving
Bearbeitet strukturierte Fragestellungen analytisch belastbar, pragmatisch und ergebnisorientiert. Entwickelt aus Fakten und Erkenntnissen umsetzbare Optionen, Entscheidungen und Empfehlungen.
- **Fakten- und Evidenzorientierung** (Gewicht 1.0) — Stützt Aussagen auf belastbare Daten, Quellen, Interviews, Analysen oder transparent hergeleitete Annahmen.
- **Methodengerechte Analyse** (Gewicht 1.0) — Wählt geeignete qualitative und quantitative Methoden aus und wendet sie fachlich korrekt und zweckmäßig an.
- **Kritische Prüfung von Informationen** (Gewicht 1.0) — Hinterfragt Datenqualität, Quellen, Annahmen, Widersprüche und mögliche Verzerrungen, statt Ergebnisse ungeprüft zu übernehmen.
- **Hypothesenprüfung und Iteration** (Gewicht 1.0) — Prüft Hypothesen systematisch, verwirft oder schärft sie anhand neuer Erkenntnisse und passt das Vorgehen entsprechend an.
- **Entwicklung von Lösungsoptionen** (Gewicht 1.0) — Entwickelt mehrere relevante Handlungsoptionen und macht deren Unterschiede, Vor- und Nachteile sowie Konsequenzen sichtbar.
- **Impact- und Value-Orientierung** (Gewicht 1.0) — Richtet Analyse, Vorgehen und Lösung auf den höchsten realistischen Kundennutzen aus. Hinterfragt bei Bedarf den ursprünglich gewünschten Deliverable-Typ und entwickelt wirkungsvollere Alternativen, ohne Ziel, Scope, Risiken oder Umsetzbarkeit eigenmächtig zu verändern.
- **Machbarkeit und Realitätsnähe** (Gewicht 1.0) — Berücksichtigt organisatorische, technische, wirtschaftliche und zeitliche Rahmenbedingungen bei der Lösungsentwicklung.
- **Entscheidungsorientierte Empfehlung** (Gewicht 1.0) — Verdichtet Analyseergebnisse zu einer klaren Empfehlung mit Begründung, Auswirkungen, Risiken und nächsten Schritten.
### Storylining
Verdichtet komplexe Inhalte zu einer logisch schlüssigen, adressatengerechten und entscheidungsorientierten Argumentationslinie, die Kernbotschaften klar transportiert.
- **Answer First / Kernaussage** (Gewicht 1.0) — Stellt die zentrale Aussage, Empfehlung oder Antwort frühzeitig und eindeutig heraus.
- **Logische Argumentationsstruktur** (Gewicht 1.0) — Ordnet Aussagen so, dass Schlussfolgerungen nachvollziehbar aus Fakten, Analysen und Teilargumenten hervorgehen.
- **Relevanz und Fokus** (Gewicht 1.0) — Beschränkt die Storyline auf Inhalte, die für Fragestellung, Zielgruppe und Entscheidung tatsächlich erforderlich sind.
- **Belegführung** (Gewicht 1.0) — Verknüpft Kernaussagen sichtbar mit belastbaren Fakten, Analysen und nachvollziehbaren Begründungen.
- **Managementgerechte Dramaturgie** (Gewicht 1.0) — Führt verständlich von Ausgangslage und Handlungsdruck über Erkenntnisse zu Empfehlung, Wirkung und nächstem Schritt.
- **Konsistenz über Medien und Beiträge** (Gewicht 1.0) — Hält Botschaften, Begriffe, Zahlen und Argumentationslogik über Folien, Dokumente und mündliche Beiträge hinweg widerspruchsfrei.
### Precise Communication
Nimmt Informationen aktiv auf und kommuniziert mündlich wie schriftlich klar, prägnant, adressatengerecht und handlungsorientiert.
- **Active Listening** (Gewicht 1.0) — Hört aufmerksam zu, erfasst Inhalt und Kontext und greift relevante Aussagen, Bedenken und Signale gezielt auf.
- **Präzise Fragetechnik** (Gewicht 1.0) — Stellt klare, relevante und aufeinander aufbauende Fragen, die Verständnis, Erkenntnisgewinn oder Entscheidung fördern.
- **To the Point** (Gewicht 1.0) — Formuliert die wesentliche Aussage ohne unnötige Vorrede, Wiederholungen oder Nebenpfade.
- **Adressatengerechte Kommunikation** (Gewicht 1.0) — Passt Tonalität, Detailtiefe, Begriffswahl und Kommunikationsstil an Zielgruppe, Hierarchie und Situation an.
- **Sprachliche Klarheit und Verbindlichkeit** (Gewicht 1.0) — Verwendet eindeutige Formulierungen und vermeidet unnötige Füllwörter, Weichmacher, Mehrdeutigkeit und Scheingenauigkeit.
- **Recap und Verständnissicherung** (Gewicht 1.0) — Fasst Kernaussagen, Entscheidungen, offene Punkte und nächste Schritte prägnant zusammen und prüft gemeinsames Verständnis.
- **Souveräne Präsenz** (Gewicht 1.0) — Tritt ruhig, vorbereitet, klar und entscheidungsorientiert auf. Behält auch bei kritischen Rückfragen, Widerspruch oder unvollständigen Informationen die Handlungsfähigkeit, unterscheidet sicher zwischen Fakten, Annahmen und offenen Punkten und vermittelt Orientierung, ohne Sicherheit vorzutäuschen.
### Client Intimacy Building
Baut professionelle, vertrauensvolle Kundenbeziehungen auf, versteht fachliche und persönliche Stakeholderbedürfnisse und entwickelt sich vom Ausführenden zum wirksamen Berater.
- **Verständnis des Kundenkontexts** (Gewicht 1.0) — Erfasst Ziele, Geschäftsmodell, Prioritäten, Restriktionen, Entscheidungslogiken und relevante Rahmenbedingungen des Kunden.
- **Stakeholderverständnis** (Gewicht 1.0) — Erkennt Interessen, Einfluss, Erwartungen und mögliche Widerstände relevanter Stakeholder und berücksichtigt sie im Vorgehen.
- **Vertrauensaufbau und Beziehungsqualität** (Gewicht 1.0) — Schafft durch Verlässlichkeit, Integrität, professionelles Verhalten und respektvolle Zusammenarbeit eine belastbare Arbeitsbeziehung.
- **Fachliche Glaubwürdigkeit und Kompetenzwahrnehmung** (Gewicht 1.0) — Wird durch fachliche Substanz, Kundenverständnis, klare Einordnung und belastbare Empfehlungen als relevanter und kompetenter Ansprechpartner wahrgenommen. Gibt Orientierung und macht zugleich Grenzen des eigenen Wissens transparent.
- **Aktives Erwartungsmanagement** (Gewicht 1.0) — Klärt Ziele, Rollen, Umfang, Annahmen, Risiken und Liefererwartungen und steuert Abweichungen frühzeitig nach.
- **Active Advisory und Customer Steering** (Gewicht 1.0) — Führt den Kunden aktiv durch Fragestellungen, Optionen, Konsequenzen und notwendige Entscheidungen. Spricht klare Empfehlungen aus und verhindert eine rein ausführende Rolle, ohne die Entscheidungsverantwortung des Kunden zu übergehen.
- **Konstruktives Challengen** (Gewicht 1.0) — Hinterfragt Annahmen oder Kundenwünsche respektvoll, faktenbasiert und lösungsorientiert, wenn dies dem Ergebnis dient.
- **Beziehungsentwicklung über den Einzeltermin hinaus** (Gewicht 1.0) — Pflegt relevante Kontakte, erkennt Anschlussbedarfe und schafft Kontinuität in der Zusammenarbeit, ohne aufdringlich oder rein vertriebsorientiert zu handeln.
### Quality of Deliverables
Erstellt fachlich belastbare, konsistente und professionell aufbereitete Arbeitsergebnisse, die für den Kunden verständlich, relevant und unmittelbar nutzbar sind.
- **Fachliche Richtigkeit** (Gewicht 1.0) — Inhalte, Berechnungen, Aussagen und Schlussfolgerungen sind fachlich korrekt und belastbar.
- **Inhaltliche Vollständigkeit** (Gewicht 1.0) — Deckt die für Fragestellung und Entscheidung relevanten Aspekte, Perspektiven und Auswirkungen angemessen ab.
- **Logische Konsistenz** (Gewicht 1.0) — Stellt sicher, dass Aussagen, Zahlen, Argumente und Empfehlungen in sich sowie untereinander widerspruchsfrei sind.
- **Kundenspezifische Konkretisierung** (Gewicht 1.0) — Überträgt generische Erkenntnisse sichtbar auf Situation, Sprache, Daten und Handlungsrealität des Kunden.
- **Informationsdichte und Nutzbarkeit** (Gewicht 1.0) — Wählt eine angemessene Detailtiefe und ermöglicht dem Adressaten, Kernaussagen und Handlungsbedarf schnell zu erfassen.
- **Visualisierungs- und Darstellungsqualität** (Gewicht 1.0) — Nutzt Struktur, Layout, Tabellen, Grafiken und Visualisierungen so, dass sie Verständnis und Botschaft wirksam unterstützen.
- **Formale Qualität und Standardkonformität** (Gewicht 1.0) — Hält relevante Templates, Designvorgaben, Sprache, Quellenangaben, Versionierung und Dokumentationsstandards konsequent ein.
### Proposal Writing & Value Proposition Design
Übersetzt einen Kundenbedarf in ein überzeugendes, differenziertes und realistisch lieferbares Leistungsversprechen mit klarer Wirkung, Vorgehensweise und Nutzenargumentation.
- **Verständnis von Bedarf und Buying Context** (Gewicht 1.0) — Erfasst Problem, Auslöser, Zielbild, Entscheidungskriterien, Stakeholder und Beschaffungskontext hinter der Anfrage.
- **Klare Value Proposition** (Gewicht 1.0) — Formuliert prägnant, welchen konkreten Nutzen und welche angestrebten Ergebnisse das Angebot für den Kunden erzeugt.
- **Kundenspezifische Differenzierung** (Gewicht 1.0) — Verbindet Kundenbedarf mit relevanten Fähigkeiten, Erfahrungen, Assets und unterscheidbaren Stärken des eigenen Angebots.
- **Schlüssiger Scope und Deliverables** (Gewicht 1.0) — Beschreibt Leistungsumfang, Ergebnisse, Grenzen und Verantwortlichkeiten klar und vermeidet Interpretationsspielräume.
- **Plausibles Vorgehensmodell** (Gewicht 1.0) — Entwickelt einen nachvollziehbaren Ansatz mit Arbeitspaketen, Meilensteinen, Beteiligten und Entscheidungszeitpunkten.
- **Belastbare Annahmen und Machbarkeit** (Gewicht 1.0) — Macht Voraussetzungen, Abhängigkeiten, Risiken und Mitwirkungspflichten transparent und verspricht nur realistisch Lieferbares.
- **Kommerzielles Verständnis** (Gewicht 1.0) — Berücksichtigt Aufwand, Preislogik, Wirtschaftlichkeit, Risiken und den für beide Seiten tragfähigen Zuschnitt des Angebots.
- **Überzeugende Angebotsstory** (Gewicht 1.0) — Verbindet Kundensituation, Handlungsdruck, Lösung, Nutzen, Vorgehen und Glaubwürdigkeit zu einer konsistenten Entscheidungsgrundlage.
### Workshop Design & Facilitation
Konzipiert und moderiert Workshops so, dass relevante Beteiligte fokussiert zusammenarbeiten, belastbare Ergebnisse erzielen und klare Entscheidungen oder nächste Schritte vereinbaren.
- **Ziel- und Ergebnisdefinition** (Gewicht 1.0) — Klärt vorab, welches konkrete Ergebnis, welche Entscheidung oder welcher Arbeitsfortschritt im Workshop erreicht werden soll.
- **Teilnehmer- und Stakeholderdesign** (Gewicht 1.0) — Bindet die für Inhalt, Entscheidung und Umsetzung relevanten Personen mit passenden Rollen ein.
- **Dramaturgie und Methodenauswahl** (Gewicht 1.0) — Entwickelt eine logische Agenda und wählt Methoden, die Ziel, Teilnehmergruppe, Zeit und Arbeitsmodus unterstützen.
- **Vorbereitung und Arbeitsfähigkeit** (Gewicht 1.0) — Stellt Inhalte, Leitfragen, Daten, Materialien, Technik, Rollen und organisatorische Voraussetzungen rechtzeitig bereit.
- **Zielgerichtete Moderation** (Gewicht 1.0) — Führt verständlich durch den Prozess, hält Fokus und Zeit und macht Übergänge sowie Arbeitsaufträge klar.
- **Aktivierung und Gruppendynamik** (Gewicht 1.0) — Fördert ausgewogene Beteiligung, geht konstruktiv mit Dominanz, Zurückhaltung, Konflikten und Abschweifungen um.
- **Ergebnissicherung und Follow-up** (Gewicht 1.0) — Verdichtet Diskussionen, dokumentiert Entscheidungen, Verantwortlichkeiten und nächste Schritte und stellt eine klare Nachbereitung sicher.
## AI-Readiness
### AI Fundamentals
Versteht Funktionsweise, Einsatzvoraussetzungen, Chancen, Grenzen und Risiken von KI auf einem für die Beratung angemessenen Niveau und handelt verantwortungsvoll.
- **Grundverständnis generativer KI** (Gewicht 1.0) — Erklärt in angemessener Tiefe, wie Modelle, Trainingsdaten, Kontext, Prompts und probabilistische Ausgabe die Ergebnisse beeinflussen.
- **Use-Case-Eignung beurteilen** (Gewicht 1.0) — Erkennt, für welche Aufgaben KI sinnvoll ist und wo menschliche Expertise, klassische Analyse oder andere Werkzeuge geeigneter sind.
- **Grenzen und Fehlerbilder erkennen** (Gewicht 1.0) — Berücksichtigt insbesondere Halluzinationen, Bias, fehlende Aktualität, Scheingenauigkeit, Kontextverlust und unvollständige Quellenlage.
- **Datenschutz und Vertraulichkeit** (Gewicht 1.0) — Behandelt Kunden-, Personen- und Unternehmensdaten entsprechend den geltenden Sicherheits-, Datenschutz- und Vertraulichkeitsvorgaben.
- **Responsible-AI-Verständnis** (Gewicht 1.0) — Berücksichtigt ethische, rechtliche, sicherheitsbezogene und gesellschaftliche Auswirkungen beim Einsatz von KI.
- **Qualitätssicherung von KI-Ergebnissen** (Gewicht 1.0) — Prüft Ergebnisse fachlich, logisch, methodisch und quellenbezogen und übernimmt keine KI-Ausgabe ungeprüft.
### AI-Augmented Consulting
Integriert KI gezielt und verantwortungsvoll in typische Beratungsaufgaben, um Qualität, Geschwindigkeit und Erkenntnisgewinn zu verbessern, ohne die Verantwortung für Ergebnisse abzugeben.
- **Zielgerichtete Tool- und Use-Case-Auswahl** (Gewicht 1.0) — Wählt KI-Werkzeug und Einsatzform passend zu Aufgabe, Datenlage, Risiko und erwartetem Mehrwert aus.
- **Kontext- und Promptgestaltung** (Gewicht 1.0) — Formuliert klare Arbeitsaufträge, stellt relevanten Kontext bereit und verbessert Ergebnisse iterativ durch geeignete Steuerung.
- **KI-gestützte Recherche und Verdichtung** (Gewicht 1.0) — Nutzt KI zur Informationsstrukturierung und Synthese, überprüft jedoch Quellen, Aktualität und Vollständigkeit.
- **KI-gestützte Analyse und Hypothesenbildung** (Gewicht 1.0) — Nutzt KI zur Entwicklung von Analysefragen, Hypothesen, Strukturierungsansätzen oder Auswertungsoptionen und validiert diese eigenständig.
- **KI-gestützte Storyline- und Deliverable-Erstellung** (Gewicht 1.0) — Erstellt mit KI erste Entwürfe für Storylines, Texte, Folien oder Arbeitsmaterialien und veredelt sie fachlich sowie kundenspezifisch.
- **KI-gestützte Meeting- und Workshopvorbereitung** (Gewicht 1.0) — Nutzt KI für Interviewleitfäden, Fragen, Szenarien, Zusammenfassungen oder Moderationsvorbereitung und prüft die Praxistauglichkeit.
- **Systematische Workflow-Integration** (Gewicht 1.0) — Identifiziert wiederkehrende Arbeitsschritte, integriert KI reproduzierbar und dokumentiert Vorgehen, Qualitätskontrollen und menschliche Entscheidungen angemessen.
### AI Certification
Dokumentiert formale, rollenbezogene KI-Qualifikationsnachweise. Da Zertifizierungen primär einen Nachweisstatus und kein beobachtbares Verhalten darstellen, sollten diese Kriterien möglichst als erfüllt, nicht erfüllt oder nicht erforderlich geführt werden.
- **Vorgegebene Basiszertifizierung** (Gewicht 1.0) — Hat die für die Rolle oder Entwicklungsstufe vorgeschriebene grundlegende KI-Zertifizierung erfolgreich abgeschlossen.
- **Rollen- oder technologiespezifische Zertifizierung** (Gewicht 1.0) — Verfügt über die für Einsatzgebiet, Technologie oder Projektkontext relevanten weiterführenden Nachweise, soweit diese gefordert sind.
- **Aktualität des Nachweises** (Gewicht 1.0) — Hält verpflichtende Zertifizierungen, Rezertifizierungen und vorgeschriebene Lernstände aktuell.
- **Nachgewiesener Praxistransfer** (Gewicht 1.0) — Kann zentrale Inhalte der Zertifizierung in Übungen oder Assignments korrekt anwenden und deren Grenzen erläutern.
## Culture-Readiness
### Quality Excellence
Verankert Qualität als kontinuierliche Arbeitsweise und sorgt durch Standards, Reviews und kritische Prüfung dafür, dass belastbare Ergebnisse reproduzierbar entstehen.
- **Qualitätsanspruch** (Gewicht 1.0) — Richtet die eigene Arbeit sichtbar auf fachlich belastbare, verständliche und kundentaugliche Ergebnisse aus.
- **Systematische Qualitätschecks** (Gewicht 1.0) — Prüft Inhalte, Zahlen, Logik, Sprache, Quellen, Format und Konsistenz vor Weitergabe anhand geeigneter Kontrollschritte.
- **Prozess- und Standardtreue** (Gewicht 1.0) — Kennt relevante Prozesse, Methoden, Templates und Vorgaben und wendet sie zweckmäßig sowie nachvollziehbar an.
- **Reviewfähigkeit** (Gewicht 1.0) — Bereitet Arbeitsergebnisse so vor, dass andere sie effizient prüfen können, und arbeitet Reviewhinweise sauber und vollständig ein.
- **Frühzeitige Qualitätssicherung** (Gewicht 1.0) — Plant Reviews, Abstimmungen und Prüfschritte rechtzeitig ein, statt Qualität ausschließlich am Ende herzustellen.
- **Integrität und Compliance** (Gewicht 1.0) — Handelt ehrlich und regelkonform, macht Unsicherheiten oder Fehler transparent und wahrt Vertraulichkeit sowie relevante fachliche und organisatorische Vorgaben.
- **Kontinuierliche Verbesserung** (Gewicht 1.0) — Erkennt wiederkehrende Fehler oder Ineffizienzen und verbessert Vorgehen, Standards oder Hilfsmittel nachhaltig.
### Drive (Extra Mile)
Zeigt wirkungsorientierte Initiative, Ausdauer und Gestaltungswillen und leistet bei relevantem Mehrwert bewusst mehr als das formal Geforderte. Bewertet wird nicht die Anzahl der Arbeitsstunden, sondern der zusätzliche Beitrag zum Ergebnis.
- **Proaktive Initiative** (Gewicht 1.0) — Erkennt Handlungsbedarf oder Chancen und wird selbstständig aktiv, ohne auf detaillierte Einzelaufträge zu warten.
- **Ambitionierter Wirkungsanspruch** (Gewicht 1.0) — Strebt nicht nur formale Erledigung, sondern ein erkennbar nützliches und überzeugendes Ergebnis an.
- **Beharrlichkeit bei Hindernissen** (Gewicht 1.0) — Verfolgt wichtige Themen trotz Rückschlägen konstruktiv weiter und sucht aktiv nach alternativen Lösungswegen.
- **Mehrwert über den Auftrag hinaus** (Gewicht 1.0) — Identifiziert sinnvolle zusätzliche Beiträge, Impulse oder wiederverwendbare Lösungen, ohne Scope, Prioritäten oder Wirtschaftlichkeit aus dem Blick zu verlieren.
- **Anpassungsfähigkeit** (Gewicht 1.0) — Bleibt bei veränderten Prioritäten, unvollständigen Informationen oder neuen Anforderungen handlungsfähig und richtet das Vorgehen neu aus.
- **Konstruktive Energie unter Druck** (Gewicht 1.0) — Bewahrt auch bei hoher Belastung Fokus, Lösungsorientierung und professionelles Verhalten.
### Ownership
Übernimmt End-to-End-Verantwortung für übertragene Aufgaben und angestrebte Ergebnisse, steuert die eigene Arbeit aktiv und schafft jederzeit Transparenz über Fortschritt, Risiken und Handlungsbedarf.
- **Auftrags- und Ergebnisverständnis** (Gewicht 1.0) — Klärt Ziel, Qualitätsmaßstab, Umfang, Rollen, Abhängigkeiten und erwartete Lieferung, bevor die Umsetzung fortschreitet.
- **Eigenständige Arbeitssteuerung** (Gewicht 1.0) — Plant, priorisiert und organisiert die eigene Arbeit nachvollziehbar und benötigt nur ein der Entwicklungsstufe angemessenes Maß an Steuerung.
- **Verbindlichkeit und Zuverlässigkeit** (Gewicht 1.0) — Hält Zusagen ein und behandelt vereinbarte Termine, Qualitätsziele und Verantwortlichkeiten verbindlich.
- **Fortschritts- und Risikotransparenz** (Gewicht 1.0) — Kommuniziert Arbeitsstand, offene Punkte, Abhängigkeiten und mögliche Abweichungen frühzeitig und konkret und vermittelt eine realistische Einschätzung der Zielerreichung.
- **Stufenweises Alignment und Acceptance Management** (Gewicht 1.0) — Validiert Annahmen, Konzepte und Zwischenergebnisse rechtzeitig mit den relevanten Kundenvertretern. Sichert ein explizites gemeinsames Verständnis beziehungsweise eine Teilfreigabe als Grundlage für die weitere Bearbeitung und dokumentiert Entscheidungen, Vorbehalte und Änderungen nachvollziehbar.
- **Vorausschauendes Handeln** (Gewicht 1.0) — Erkennt Risiken, Engpässe und Entscheidungsbedarfe früh und leitet geeignete Maßnahmen ein.
- **Angemessene Entscheidung und Eskalation** (Gewicht 1.0) — Entscheidet im eigenen Verantwortungsbereich selbstständig und eskaliert rechtzeitig mit klarer Sachlage und Lösungsvorschlägen.
- **Konsequenter Abschluss** (Gewicht 1.0) — Verfolgt offene Punkte bis zu einem belastbaren Ergebnis, sichert Übergaben und schließt Kommunikations- und Dokumentationsschleifen.
### Coachability
Nutzt Feedback, Reflexion und neue Erfahrungen aktiv zur Weiterentwicklung und zeigt nachvollziehbare Verhaltensänderungen über mehrere Assignments hinweg.
- **Aktives Einholen von Feedback** (Gewicht 1.0) — Fragt gezielt und rechtzeitig nach Rückmeldung zu Wirkung, Vorgehen und Ergebnis, statt nur auf formale Feedbacktermine zu warten.
- **Offene Feedbackannahme** (Gewicht 1.0) — Hört Feedback aufmerksam an, bleibt sachlich und vermeidet vorschnelle Rechtfertigung oder Abwehr.
- **Verständnisklärung** (Gewicht 1.0) — Fragt bei unklarer Rückmeldung nach konkreten Situationen, Erwartungen und beobachtbaren Alternativen.
- **Übersetzung in Entwicklungsmaßnahmen** (Gewicht 1.0) — Leitet aus Feedback konkrete, realistische und überprüfbare Verhaltens- oder Lernschritte ab.
- **Sichtbarer Praxistransfer** (Gewicht 1.0) — Wendet vereinbarte Verbesserungen in folgenden Aufgaben erkennbar an und zeigt nachhaltigen Fortschritt.
- **Selbstreflexion und Lernagilität** (Gewicht 1.0) — Analysiert eigene Wirkung, Stärken, Fehler und Muster realistisch und passt Verhalten an neue Situationen an.
### Collaboration
Arbeitet verlässlich, respektvoll und lösungsorientiert mit anderen zusammen, stärkt den gemeinsamen Teamerfolg und nutzt unterschiedliche Perspektiven und Fähigkeiten konstruktiv.
- **Proaktive Abstimmung** (Gewicht 1.0) — Stimmt sich rechtzeitig mit relevanten Beteiligten ab, macht Schnittstellen transparent und vermeidet Informationslücken.
- **Wissens- und Ergebnisteilung** (Gewicht 1.0) — Teilt Informationen, Zwischenergebnisse, Erfahrungen und wiederverwendbare Inhalte so, dass das Team wirksam weiterarbeiten kann.
- **Unterstützungsbereitschaft** (Gewicht 1.0) — Unterstützt andere konstruktiv und bedarfsgerecht, ohne eigene Verantwortlichkeiten oder gemeinsame Prioritäten zu vernachlässigen.
- **Verlässliches Teamverhalten** (Gewicht 1.0) — Hält Teamzusagen ein, respektiert Rollen und schafft durch professionelles Verhalten eine belastbare Arbeitsbasis.
- **Konstruktiver Umgang mit Differenzen** (Gewicht 1.0) — Spricht abweichende Sichtweisen sachlich an, hört Gegenargumente an und arbeitet auf eine tragfähige Lösung hin.
- **Einbindung unterschiedlicher Perspektiven** (Gewicht 1.0) — Bezieht relevante Erfahrungen und Meinungen aktiv ein und schafft Raum für Beteiligung unabhängig von Rolle oder Hierarchie.
- **Team- und organisationsübergreifende Zusammenarbeit** (Gewicht 1.0) — Vernetzt sich bei Bedarf über das unmittelbare Team hinaus und nutzt passende Experten, Communities oder Kontakte für den gemeinsamen Erfolg.
---
_Export: 6.8.2026, finale Kriterienstruktur ohne Änderungen der Kategorie-Ebene
+23
View File
@@ -0,0 +1,23 @@
# Feedback-Struktur Preload
Finale Kriterienstruktur (Export 2026-08-06) für die Dev-Umgebung.
## Dateien
| Datei | Zweck |
|---|---|
| `docs/preload/Feedback-Struktur-final.md` | Quelle (Markdown, gleiches Format wie Config → Feedback → ⬇ MD) |
| `src/db/seeds/feedbackStructureFinal.json` | Geparste Seed-Kopie (3 Dimensionen, 16 Kategorien, 109 Kriterien) |
## Einspielen
**In der App (Config → Feedback):**
- **Preload final** — lädt `docs/preload/Feedback-Struktur-final.md` in die Dev-DB (mit Bestätigung; ersetzt bestehende Struktur)
- **↑ MD** — beliebige MD-Datei im Export-Format importieren
**CLI:**
```bash
npm run preload:feedback-structure
```
Ersetzt die komplette Feedback-Struktur (Dimensionen inkl. Cascade). Nur in `AssigmentMonitorV2` verwenden — nicht gegen Produktiv.
+8
View File
@@ -0,0 +1,8 @@
# Starter-Struktur
Maschinell erzeugtes Paket für Team-Onboarding — **ohne personenbezogene Daten**.
- Erzeugen: `npm run starter:export` (nur AssignmentMonitorV2)
- Einspielen: `npm run bootstrap -- --yes`
Siehe [`../TEAM_SETUP.md`](../TEAM_SETUP.md).
File diff suppressed because it is too large. Load diff
+13 -2
View File
@@ -2,9 +2,20 @@
<html lang="de">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
<title>Assignment Monitor</title>
<meta name="description" content="Live-Bewertung und Feedback für Capgemini-Trainees während Kunden-Assignments." />
<meta name="theme-color" content="#0070AD" />
<meta name="application-name" content="Assignment Monitor" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="default" />
<meta name="apple-mobile-web-app-title" content="Assignment Monitor" />
<link rel="icon" href="/favicon.svg" type="image/svg+xml" />
<link rel="icon" href="/pwa-192.png" type="image/png" sizes="192x192" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" sizes="180x180" />
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,400;0,500;0,600;0,700;1,400&display=swap" rel="stylesheet" />
</head>
<body>
<div id="root"></div>
+2097 -69
View File
File diff suppressed because it is too large. Load diff
+20 -4
View File
@@ -1,33 +1,49 @@
{
"name": "assignment-monitor",
"name": "assignment-monitor-v2",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"server": "tsx watch --env-file=.env server/index.ts",
"dev:all": "concurrently -n web,api -c blue,green \"npm:dev\" \"npm:server\"",
"verify-backup": "tsx --env-file=.env server/scripts/verifyBackupRoundtrip.ts",
"smoke": "tsx --env-file=.env server/scripts/smokeScaleAndTagging.ts",
"db:reset": "tsx --env-file=.env server/scripts/resetDevDatabase.ts",
"starter:export": "tsx --env-file=.env server/scripts/exportStarterPackage.ts",
"bootstrap": "tsx --env-file=.env server/scripts/bootstrapFromStarter.ts",
"setup": "tsx --env-file=.env server/scripts/teamSetup.ts",
"pack:zip": "tsx server/scripts/packTeamZip.ts",
"pack:laptop": "tsx --env-file=.env server/scripts/packLaptopZip.ts",
"preload:feedback-structure": "tsx --env-file=.env server/scripts/preloadFeedbackStructure.ts",
"build": "tsc -b && vite build",
"lint": "eslint .",
"preview": "vite preview"
},
"dependencies": {
"@react-pdf/renderer": "^4.5.1",
"express": "^4.21.2",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-router-dom": "^7.6.2",
"dexie": "^4.0.11",
"zustand": "^5.0.5",
"recharts": "^2.15.3"
"recharts": "^2.15.3",
"xlsx": "^0.18.5"
},
"devDependencies": {
"@eslint/js": "^9.25.0",
"@tailwindcss/vite": "^4.1.10",
"@types/express": "^4.17.21",
"@types/node": "^22.10.5",
"@types/react": "^19.0.0",
"@types/react-dom": "^19.0.0",
"@vitejs/plugin-react": "^4.4.1",
"concurrently": "^9.1.2",
"eslint": "^9.25.0",
"eslint-plugin-react-hooks": "^5.2.0",
"eslint-plugin-react-refresh": "^0.4.19",
"globals": "^16.0.0",
"tailwindcss": "^4.1.10",
"tsx": "^4.19.2",
"typescript": "~5.8.3",
"vite": "^6.3.5",
"vite-plugin-pwa": "^1.0.0"
Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

+4
View File
@@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" role="img" aria-label="Assignment Monitor">
<rect width="32" height="32" rx="6" fill="#0070AD"/>
<text x="16" y="22" text-anchor="middle" font-family="Segoe UI, Arial, sans-serif" font-size="14" font-weight="700" fill="#ffffff">AM</text>
</svg>

After

Width:  |  Height:  |  Size: 309 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 828 KiB

+74
View File
@@ -0,0 +1,74 @@
import { DatabaseSync } from 'node:sqlite'
import { mkdirSync } from 'node:fs'
import { dirname, join, resolve, sep } from 'node:path'
import { fileURLToPath } from 'node:url'
import { TABLE_DEFINITIONS } from './db/tableRegistry'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '..'))
/** V2-Defaults weichen bewusst von Produktiv (assignment-monitor.sqlite3) ab. */
const sqliteFilename = process.env.SQLITE_FILENAME?.trim() || 'assignment-monitor-v2-dev.sqlite3'
if (sqliteFilename.includes('/') || sqliteFilename.includes('\\') || sqliteFilename.includes('..')) {
throw new Error(
`[db] SAFETY: SQLITE_FILENAME darf nur ein Dateiname sein (kein Pfad): "${sqliteFilename}"`,
)
}
const dbPath = resolve(join(__dirname, 'data', sqliteFilename))
/**
* Harte Absicherung: DB darf nur unter diesem V2-Projekt liegen und niemals unter
* dem Produktiv-Ordner c:\dev\AssigmentMonitor (ohne V2-Suffix).
*/
function assertDevDbPath(resolvedDbPath: string): void {
const dbNorm = resolvedDbPath.toLowerCase()
const rootNorm = projectRoot.toLowerCase()
const rootPrefix = rootNorm.endsWith(sep) ? rootNorm : rootNorm + sep
if (!dbNorm.startsWith(rootPrefix) && dbNorm !== rootNorm) {
throw new Error(
`[db] SAFETY: DB-Pfad liegt außerhalb von AssignmentMonitorV2.\n` +
` DB: ${resolvedDbPath}\n` +
` Root: ${projectRoot}`,
)
}
// Produktiv-Sibling: ...\AssigmentMonitor\server\data\... — V2-Pfad enthält "assigmentmonitorv2"
const looksLikeProdData =
/[/\\]assigmentmonitor[/\\]server[/\\]data[/\\]/.test(dbNorm) &&
!/[/\\]assigmentmonitorv2[/\\]/.test(dbNorm)
if (looksLikeProdData) {
throw new Error(
`[db] SAFETY: Versuch, die Produktiv-Datenbank zu öffnen wurde blockiert:\n ${resolvedDbPath}`,
)
}
}
assertDevDbPath(dbPath)
mkdirSync(dirname(dbPath), { recursive: true })
export const db = new DatabaseSync(dbPath)
/**
* `CREATE TABLE IF NOT EXISTS` legt eine fehlende Tabelle vollständig an, migriert aber niemals eine
* bereits bestehende — neue Spalten, die tableRegistry.ts für eine vorhandene Tabelle ergänzt (z.B.
* suggestedAchievements auf feedbackDimensionTexts, 2026-07-07), fehlen dort sonst dauerhaft und
* führen erst zur Laufzeit zu "no column named ..."-Fehlern. Deshalb zusätzlich per PRAGMA table_info
* abgleichen und fehlende Spalten per ALTER TABLE nachziehen.
*/
for (const table of TABLE_DEFINITIONS) {
const columnsSql = table.columns.map(c => `"${c.name}" ${c.sqlType}`).join(', ')
db.exec(`CREATE TABLE IF NOT EXISTS "${table.name}" (id INTEGER PRIMARY KEY AUTOINCREMENT, ${columnsSql})`)
const existingColumns = new Set(
(db.prepare(`PRAGMA table_info("${table.name}")`).all() as { name: string }[]).map(c => c.name),
)
for (const col of table.columns) {
if (!existingColumns.has(col.name)) {
db.exec(`ALTER TABLE "${table.name}" ADD COLUMN "${col.name}" ${col.sqlType}`)
}
}
}
console.log(`[db] DEV-SQLite bereit unter ${dbPath}`)
+133
View File
@@ -0,0 +1,133 @@
/**
* Generische SQL-CRUD-Bausteine über die Tabellen-Registry (tableRegistry.ts) — von allen
* server/db/queries/*.ts-Modulen genutzt, damit Spalten-Codecs (JSON/Bool) nur an einer
* Stelle behandelt werden.
*/
import { db } from '../database'
import { TABLE_DEFINITIONS, type TableDef, type ColumnDef, type ColumnCodec } from './tableRegistry'
const tablesByName = new Map(TABLE_DEFINITIONS.map(t => [t.name, t]))
function requireTable(name: string): TableDef {
const t = tablesByName.get(name)
if (!t) throw new Error(`Unbekannte Tabelle: ${name}`)
return t
}
type SqlPrimitive = number | string | bigint | null
function toBindValue(raw: unknown, codec: ColumnCodec): SqlPrimitive {
if (raw === undefined || raw === null) return null
if (codec === 'json') return JSON.stringify(raw)
if (codec === 'bool') return raw ? 1 : 0
return raw as SqlPrimitive
}
function fromSqlValue(raw: unknown, codec: ColumnCodec, sqlType?: ColumnDef['sqlType']): unknown {
if (raw === null || raw === undefined) return null
if (codec === 'json') return JSON.parse(raw as string)
if (codec === 'bool') return raw === 1
// SQLite/Affinity: INTEGER-Spalten können als string/bigint ankommen (v.a. nach TEXT→INTEGER-Schemawechsel)
if (sqlType === 'INTEGER' || sqlType === 'REAL') {
if (typeof raw === 'bigint') return Number(raw)
if (typeof raw === 'string' && raw.trim() !== '') {
const n = Number(raw)
return Number.isFinite(n) ? n : raw
}
}
return raw
}
export function decodeRow<T>(table: TableDef, row: Record<string, unknown>): T {
const result: Record<string, unknown> = { id: row.id }
for (const c of table.columns) result[c.name] = fromSqlValue(row[c.name], c.codec, c.sqlType)
return result as T
}
export function insertRow(tableName: string, obj: Record<string, unknown>): number {
const table = requireTable(tableName)
const cols = table.columns.map(c => `"${c.name}"`).join(', ')
const placeholders = table.columns.map(() => '?').join(', ')
const values = table.columns.map(c => toBindValue(obj[c.name], c.codec))
const info = db.prepare(`INSERT INTO "${tableName}" (${cols}) VALUES (${placeholders})`).run(...values)
return Number(info.lastInsertRowid)
}
/** Für Backup-Restore: fügt eine Zeile mit expliziter id ein, damit Fremdschlüssel-Referenzen im importierten Datensatz stabil bleiben. */
export function insertRowWithId(tableName: string, id: number, obj: Record<string, unknown>): void {
const table = requireTable(tableName)
const cols = ['"id"', ...table.columns.map(c => `"${c.name}"`)].join(', ')
const placeholders = ['?', ...table.columns.map(() => '?')].join(', ')
const values: SqlPrimitive[] = [id, ...table.columns.map(c => toBindValue(obj[c.name], c.codec))]
db.prepare(`INSERT INTO "${tableName}" (${cols}) VALUES (${placeholders})`).run(...values)
}
export function updateRow(tableName: string, id: number, patch: Record<string, unknown>): number {
const table = requireTable(tableName)
const entries = Object.entries(patch).filter(([k]) => k !== 'id')
if (entries.length === 0) return 0
const setSql = entries.map(([k]) => `"${k}" = ?`).join(', ')
const values = entries.map(([k, v]) => {
const colDef = table.columns.find(c => c.name === k)
return toBindValue(v, colDef?.codec ?? 'plain')
})
const info = db.prepare(`UPDATE "${tableName}" SET ${setSql} WHERE id = ?`).run(...values, id)
return Number(info.changes)
}
export function getRowById<T>(tableName: string, id: number): T | undefined {
const table = requireTable(tableName)
const row = db.prepare(`SELECT * FROM "${tableName}" WHERE id = ?`).get(id) as Record<string, unknown> | undefined
return row ? decodeRow<T>(table, row) : undefined
}
export function getAllRows<T>(tableName: string): T[] {
const table = requireTable(tableName)
const rows = db.prepare(`SELECT * FROM "${tableName}"`).all() as Record<string, unknown>[]
return rows.map(r => decodeRow<T>(table, r))
}
export function getAllRowsOrderedBy<T>(tableName: string, column: string): T[] {
const table = requireTable(tableName)
const rows = db.prepare(`SELECT * FROM "${tableName}" ORDER BY "${column}" ASC`).all() as Record<string, unknown>[]
return rows.map(r => decodeRow<T>(table, r))
}
export function getRowsWhereEquals<T>(tableName: string, column: string, value: SqlPrimitive): T[] {
const table = requireTable(tableName)
const rows = db.prepare(`SELECT * FROM "${tableName}" WHERE "${column}" = ?`).all(value) as Record<string, unknown>[]
return rows.map(r => decodeRow<T>(table, r))
}
export function getRowsWhereIn<T>(tableName: string, column: string, values: number[]): T[] {
if (values.length === 0) return []
const table = requireTable(tableName)
const placeholders = values.map(() => '?').join(', ')
const rows = db.prepare(`SELECT * FROM "${tableName}" WHERE "${column}" IN (${placeholders})`).all(...values) as Record<string, unknown>[]
return rows.map(r => decodeRow<T>(table, r))
}
export function deleteRowById(tableName: string, id: number): void {
requireTable(tableName)
db.prepare(`DELETE FROM "${tableName}" WHERE id = ?`).run(id)
}
export function deleteRowsWhereEquals(tableName: string, column: string, value: SqlPrimitive): number {
requireTable(tableName)
const info = db.prepare(`DELETE FROM "${tableName}" WHERE "${column}" = ?`).run(value)
return Number(info.changes)
}
export function deleteRowsWhereIn(tableName: string, column: string, values: number[]): number {
if (values.length === 0) return 0
requireTable(tableName)
const placeholders = values.map(() => '?').join(', ')
const info = db.prepare(`DELETE FROM "${tableName}" WHERE "${column}" IN (${placeholders})`).run(...values)
return Number(info.changes)
}
export function countWhereEquals(tableName: string, column: string, value: SqlPrimitive): number {
requireTable(tableName)
const row = db.prepare(`SELECT COUNT(*) as c FROM "${tableName}" WHERE "${column}" = ?`).get(value) as { c: number }
return row.c
}
+198
View File
@@ -0,0 +1,198 @@
import { getRowById, insertRowWithId, updateRow } from '../crud'
import type { AppSettings, RatingColorBand } from '../../../src/db/types'
import { AI_CONFIG, DEFAULT_RATING_COLOR_BANDS, normalizeRatingColorBands } from '../../../src/config/constants'
/** Muss mit DEFAULT_RATING_TREND_WEIGHT_STEP in src/config/constants.ts synchron gehalten werden. */
const DEFAULT_RATING_TREND_WEIGHT_STEP = 0.5
export function getRatingTrendWeightStep(): number {
const settings = getRowById<AppSettings>('appSettings', 1)
return settings?.ratingTrendWeightStep ?? DEFAULT_RATING_TREND_WEIGHT_STEP
}
export function getOrSeedRatingTrendWeightStep(): number {
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, { ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP })
settings = getRowById<AppSettings>('appSettings', 1)
}
return settings?.ratingTrendWeightStep ?? DEFAULT_RATING_TREND_WEIGHT_STEP
}
export function saveRatingTrendWeightStep(weightStep: number): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { ratingTrendWeightStep: weightStep })
else insertRowWithId('appSettings', 1, { ratingTrendWeightStep: weightStep })
return 1
}
export function getOrSeedRatingColorBands(): RatingColorBand[] {
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
ratingColorBands: DEFAULT_RATING_COLOR_BANDS.map(b => ({ ...b })),
})
return DEFAULT_RATING_COLOR_BANDS.map(b => ({ ...b }))
}
if (!settings.ratingColorBands?.length) {
const seeded = DEFAULT_RATING_COLOR_BANDS.map(b => ({ ...b }))
updateRow('appSettings', 1, { ratingColorBands: seeded })
return seeded
}
return normalizeRatingColorBands(settings.ratingColorBands)
}
export function saveRatingColorBands(bands: RatingColorBand[]): number {
const normalized = normalizeRatingColorBands(bands)
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { ratingColorBands: normalized })
else insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
ratingColorBands: normalized,
})
return 1
}
/**
* Der Standard-Prompt für neue Dimensionen/"Zurücksetzen" lebt jetzt in der DB statt im Code
* (`AI_CONFIG.defaultDimensionPromptTemplate` dient nur noch als einmaliger Erstbefüllungs-Wert
* beim allerersten Zugriff auf einer Installation, siehe Config → KI-Prompts).
*/
export function getDefaultDimensionPromptTemplate(): string {
const settings = getRowById<AppSettings>('appSettings', 1)
return settings?.defaultDimensionPromptTemplate ?? AI_CONFIG.defaultDimensionPromptTemplate
}
export function getOrSeedDefaultDimensionPromptTemplate(): string {
const settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
defaultDimensionPromptTemplate: AI_CONFIG.defaultDimensionPromptTemplate,
})
return AI_CONFIG.defaultDimensionPromptTemplate
}
if (!settings.defaultDimensionPromptTemplate) {
updateRow('appSettings', 1, { defaultDimensionPromptTemplate: AI_CONFIG.defaultDimensionPromptTemplate })
return AI_CONFIG.defaultDimensionPromptTemplate
}
return settings.defaultDimensionPromptTemplate
}
export function saveDefaultDimensionPromptTemplate(template: string): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { defaultDimensionPromptTemplate: template })
else insertRowWithId('appSettings', 1, { ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP, defaultDimensionPromptTemplate: template })
return 1
}
/**
* Prompt-Template für Protokoll-Tagging („🏷 Vorschläge analysieren", Freitext-Zeilen).
* Checklisten haben seit der Trennung ein eigenes Template (`checklistTaggingPromptTemplate`).
* Alte Zwischenstände mit `{{CHECKLISTEN_PUNKTE}}` im Protokoll-Prompt werden einmalig auf den
* aktuellen Protokoll-Standard migriert — sonst bleibt der Platzhalter unersetzt und die KI
* liefert keine brauchbaren ZEILE-Vorschläge mehr.
*/
export function getOrSeedCriterionTaggingPromptTemplate(): string {
const fresh = AI_CONFIG.defaultCriterionTaggingPromptTemplate
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
criterionTaggingPromptTemplate: fresh,
})
return fresh
}
const stored = settings.criterionTaggingPromptTemplate
if (!stored || stored.includes('{{CHECKLISTEN_PUNKTE}}')) {
updateRow('appSettings', 1, { criterionTaggingPromptTemplate: fresh })
return fresh
}
return stored
}
export function saveCriterionTaggingPromptTemplate(template: string): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { criterionTaggingPromptTemplate: template })
else insertRowWithId('appSettings', 1, { ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP, criterionTaggingPromptTemplate: template })
return 1
}
export function getOrSeedChecklistTaggingPromptTemplate(): string {
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
checklistTaggingPromptTemplate: AI_CONFIG.defaultChecklistTaggingPromptTemplate,
})
return AI_CONFIG.defaultChecklistTaggingPromptTemplate
}
if (!settings.checklistTaggingPromptTemplate) {
updateRow('appSettings', 1, { checklistTaggingPromptTemplate: AI_CONFIG.defaultChecklistTaggingPromptTemplate })
return AI_CONFIG.defaultChecklistTaggingPromptTemplate
}
return settings.checklistTaggingPromptTemplate
}
export function saveChecklistTaggingPromptTemplate(template: string): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { checklistTaggingPromptTemplate: template })
else insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
checklistTaggingPromptTemplate: template,
})
return 1
}
export function getOrSeedDefaultCategoryPromptTemplate(): string {
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
defaultCategoryPromptTemplate: AI_CONFIG.defaultCategoryPromptTemplate,
})
return AI_CONFIG.defaultCategoryPromptTemplate
}
if (!settings.defaultCategoryPromptTemplate) {
updateRow('appSettings', 1, { defaultCategoryPromptTemplate: AI_CONFIG.defaultCategoryPromptTemplate })
return AI_CONFIG.defaultCategoryPromptTemplate
}
return settings.defaultCategoryPromptTemplate
}
export function saveDefaultCategoryPromptTemplate(template: string): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { defaultCategoryPromptTemplate: template })
else insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
defaultCategoryPromptTemplate: template,
})
return 1
}
export function getOrSeedRequirePlannedDates(): boolean {
let settings = getRowById<AppSettings>('appSettings', 1)
if (!settings) {
insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
requirePlannedDates: false,
})
return false
}
if (settings.requirePlannedDates === undefined || settings.requirePlannedDates === null) {
updateRow('appSettings', 1, { requirePlannedDates: false })
return false
}
return !!settings.requirePlannedDates
}
export function saveRequirePlannedDates(required: boolean): number {
const existing = getRowById('appSettings', 1)
if (existing) updateRow('appSettings', 1, { requirePlannedDates: required })
else insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: DEFAULT_RATING_TREND_WEIGHT_STEP,
requirePlannedDates: required,
})
return 1
}
+12
View File
@@ -0,0 +1,12 @@
import { getAllRows, getRowsWhereEquals, getRowsWhereIn, insertRow, updateRow, deleteRowsWhereEquals } from '../crud'
import type { Assessment } from '../../../src/db/types'
export const listAssessmentsAll = (): Assessment[] => getAllRows<Assessment>('assessments')
export const listAssessmentsForMeeting = (meetingInstanceId: number): Assessment[] =>
getRowsWhereEquals<Assessment>('assessments', 'meetingInstanceId', meetingInstanceId)
export const listAssessmentsForMeetings = (meetingInstanceIds: number[]): Assessment[] =>
getRowsWhereIn<Assessment>('assessments', 'meetingInstanceId', meetingInstanceIds)
export const addAssessment = (a: Omit<Assessment, 'id'>): number => insertRow('assessments', a)
export const updateAssessment = (id: number, patch: Partial<Assessment>): number => updateRow('assessments', id, patch)
export const deleteAssessmentsForMeeting = (meetingInstanceId: number): number =>
deleteRowsWhereEquals('assessments', 'meetingInstanceId', meetingInstanceId)
+63
View File
@@ -0,0 +1,63 @@
import { getAllRows, getRowById, getRowsWhereEquals, insertRow, updateRow, deleteRowById } from '../crud'
import type {
FeedbackDraft, AssignmentFeedback, FeedbackCategoryRating, FeedbackDimensionText, FeedbackCategoryText,
} from '../../../src/db/types'
export const getFeedbackDraft = (assignmentId: number, instituteeId: number): FeedbackDraft | undefined =>
getRowsWhereEquals<FeedbackDraft>('feedbackDrafts', 'assignmentId', assignmentId).find(d => d.instituteeId === instituteeId)
export const addFeedbackDraft = (d: Omit<FeedbackDraft, 'id'>): number => insertRow('feedbackDrafts', d)
export const updateFeedbackDraft = (id: number, patch: Partial<FeedbackDraft>): number => updateRow('feedbackDrafts', id, patch)
export const getAssignmentFeedback = (assignmentId: number, instituteeId: number): AssignmentFeedback | undefined =>
getRowsWhereEquals<AssignmentFeedback>('assignmentFeedbacks', 'assignmentId', assignmentId).find(f => f.instituteeId === instituteeId)
/** Für die Auswertungsübersicht: Feedback-Status (Entwurf/Final) aller Assignments auf einen Schlag, statt N+1-Abfragen pro Zeile. */
export const listAssignmentFeedbacksAll = (): AssignmentFeedback[] => getAllRows<AssignmentFeedback>('assignmentFeedbacks')
export const getAssignmentFeedbackById = (id: number): AssignmentFeedback | undefined =>
getRowById<AssignmentFeedback>('assignmentFeedbacks', id)
export const addAssignmentFeedback = (f: Omit<AssignmentFeedback, 'id'>): number => insertRow('assignmentFeedbacks', f)
export const updateAssignmentFeedback = (id: number, patch: Partial<AssignmentFeedback>): number =>
updateRow('assignmentFeedbacks', id, patch)
export function getOrCreateAssignmentFeedback(assignmentId: number, instituteeId: number): AssignmentFeedback | undefined {
let fb = getAssignmentFeedback(assignmentId, instituteeId)
if (!fb) {
const fbId = addAssignmentFeedback({
assignmentId, instituteeId, status: 'draft', aiModel: '', updatedAt: new Date().toISOString(),
})
fb = getAssignmentFeedbackById(fbId)
}
return fb
}
export const listFeedbackCategoryRatings = (assignmentFeedbackId: number): FeedbackCategoryRating[] =>
getRowsWhereEquals<FeedbackCategoryRating>('feedbackCategoryRatings', 'assignmentFeedbackId', assignmentFeedbackId)
export const addFeedbackCategoryRating = (r: Omit<FeedbackCategoryRating, 'id'>): number => insertRow('feedbackCategoryRatings', r)
export const updateFeedbackCategoryRating = (id: number, patch: Partial<FeedbackCategoryRating>): number =>
updateRow('feedbackCategoryRatings', id, patch)
export const deleteFeedbackCategoryRating = (id: number): void => {
deleteRowById('feedbackCategoryRatings', id)
}
export const listFeedbackDimensionTexts = (assignmentFeedbackId: number): FeedbackDimensionText[] =>
getRowsWhereEquals<FeedbackDimensionText>('feedbackDimensionTexts', 'assignmentFeedbackId', assignmentFeedbackId)
export const getFeedbackDimensionText = (
assignmentFeedbackId: number,
feedbackDimensionId: number,
): FeedbackDimensionText | undefined =>
getRowsWhereEquals<FeedbackDimensionText>('feedbackDimensionTexts', 'assignmentFeedbackId', assignmentFeedbackId)
.find(t => t.feedbackDimensionId === feedbackDimensionId)
export const addFeedbackDimensionText = (t: Omit<FeedbackDimensionText, 'id'>): number => insertRow('feedbackDimensionTexts', t)
export const updateFeedbackDimensionText = (id: number, patch: Partial<FeedbackDimensionText>): number =>
updateRow('feedbackDimensionTexts', id, patch)
export const listFeedbackCategoryTexts = (assignmentFeedbackId: number): FeedbackCategoryText[] =>
getRowsWhereEquals<FeedbackCategoryText>('feedbackCategoryTexts', 'assignmentFeedbackId', assignmentFeedbackId)
export const getFeedbackCategoryText = (
assignmentFeedbackId: number,
feedbackCategoryId: number,
): FeedbackCategoryText | undefined =>
getRowsWhereEquals<FeedbackCategoryText>('feedbackCategoryTexts', 'assignmentFeedbackId', assignmentFeedbackId)
.find(t => t.feedbackCategoryId === feedbackCategoryId)
export const addFeedbackCategoryText = (t: Omit<FeedbackCategoryText, 'id'>): number => insertRow('feedbackCategoryTexts', t)
export const updateFeedbackCategoryText = (id: number, patch: Partial<FeedbackCategoryText>): number =>
updateRow('feedbackCategoryTexts', id, patch)
+527
View File
@@ -0,0 +1,527 @@
/**
* Einzel-Assignment Export/Import für Lead-Übergabe (Urlaub/Krankheit).
* Enthält Runtime-Daten inkl. Checklisten + referenzierte Berater/Gruppen.
* Struktur wird per stabilem Schlüssel gemappt; Berater werden bei Namensgleichheit
* wiederverwendet, sonst neu angelegt.
*/
import { db } from '../../database'
import {
getAllRows, getRowById, getRowsWhereEquals, getRowsWhereIn, insertRow,
} from '../crud'
import type {
Assignment, AssignmentType, PhaseTemplate, ChecklistItemDef, ChecklistResponse,
Group, Consultant, MeetingInstance, ConversationEntry, ConversationSkillScore,
Assessment, FeedbackDraft, AssignmentFeedback,
FeedbackCategoryRating, FeedbackDimensionText, FeedbackCategoryText,
FeedbackDimension, FeedbackCategory, FeedbackCriterionItem, ConversationLineTag,
AssignmentTransferPackage, AssignmentImportResult,
} from '../../../src/db/types'
import { ASSIGNMENT_TRANSFER_KIND } from '../../../src/db/types'
import { listMeetingInstancesForAssignment } from './meetings'
import { listChecklistItemDefsForPhaseTemplates, listChecklistResponsesForMeetings } from './checklists'
import { listConversationEntriesForMeetings } from './conversationEntries'
import { listAssessmentsForMeetings } from './assessments'
import { listMeetingCategoryRatingsForMeetings } from './meetingCategoryRatings'
const norm = (s: string) => s.trim().toLowerCase().replace(/\s+/g, ' ')
const personKey = (c: Pick<Consultant, 'firstName' | 'lastName'>) =>
`${norm(c.firstName)}|${norm(c.lastName)}`
const emailKey = (c: Pick<Consultant, 'email'>): string | null => {
const e = (c.email ?? '').trim().toLowerCase()
return e || null
}
const groupKey = (g: Pick<Group, 'name' | 'cohortYear'>) =>
`${norm(g.name)}|${g.cohortYear}`
function collectCriterionIds(pkgParts: {
assignmentType: AssignmentType
phaseTemplates: PhaseTemplate[]
checklistItemDefs: ChecklistItemDef[]
assessments: Assessment[]
checklistResponses: ChecklistResponse[]
conversationEntries: ConversationEntry[]
meetingInstances: MeetingInstance[]
}): Set<number> {
const ids = new Set<number>()
for (const id of pkgParts.assignmentType.criteriaIds ?? []) ids.add(id)
for (const p of pkgParts.phaseTemplates) for (const id of p.criteriaIds ?? []) ids.add(id)
for (const c of pkgParts.checklistItemDefs) {
if (c.linkedCriterionItemId != null) ids.add(c.linkedCriterionItemId)
}
for (const a of pkgParts.assessments) ids.add(a.criteriaId)
for (const r of pkgParts.checklistResponses) {
if (r.criterionItemId != null) ids.add(r.criterionItemId)
}
for (const e of pkgParts.conversationEntries) {
for (const t of e.lineTags ?? []) ids.add(t.criterionItemId)
}
for (const m of pkgParts.meetingInstances) {
for (const t of m.generalNoteTags ?? []) ids.add(t.criterionItemId)
}
return ids
}
function remapTags(
tags: ConversationLineTag[] | undefined,
criterionMap: Map<number, number>,
): ConversationLineTag[] | undefined {
if (!tags) return tags
return tags.map(t => ({
text: t.text,
criterionItemId: criterionMap.get(t.criterionItemId) ?? t.criterionItemId,
}))
}
function requireMap(map: Map<number, number>, oldId: number, label: string): number {
const next = map.get(oldId)
if (next == null) throw new Error(`${label}: Quell-ID ${oldId} konnte nicht gemappt werden`)
return next
}
/** Exportiert ein Assignment inkl. aller Meetings/Notizen/Checklisten/Feedbacks und referenzierter Berater. */
export function exportAssignmentTransfer(assignmentId: number): AssignmentTransferPackage {
const assignment = getRowById<Assignment>('assignments', assignmentId)
if (!assignment) throw new Error('Assignment nicht gefunden')
const assignmentType = getRowById<AssignmentType>('assignmentTypes', assignment.assignmentTypeId)
if (!assignmentType) throw new Error('Assignment-Typ nicht gefunden')
const phaseTemplates = getRowsWhereEquals<PhaseTemplate>('phaseTemplates', 'assignmentTypeId', assignment.assignmentTypeId)
.sort((a, b) => a.order - b.order)
const phaseIds = phaseTemplates.map(p => p.id!)
const checklistItemDefs = listChecklistItemDefsForPhaseTemplates(phaseIds)
const meetingInstances = listMeetingInstancesForAssignment(assignmentId)
const meetingIds = meetingInstances.map(m => m.id!)
const conversationEntries = listConversationEntriesForMeetings(meetingIds)
const entryIds = conversationEntries.map(e => e.id!)
const conversationSkillScores = getAllRows<ConversationSkillScore>('conversationSkillScores')
.filter(s => entryIds.includes(s.conversationEntryId))
const assessments = listAssessmentsForMeetings(meetingIds)
const meetingCategoryRatings = listMeetingCategoryRatingsForMeetings(meetingIds)
const checklistResponses = listChecklistResponsesForMeetings(meetingIds)
const feedbackDrafts = getRowsWhereEquals<FeedbackDraft>('feedbackDrafts', 'assignmentId', assignmentId)
const assignmentFeedbacks = getRowsWhereEquals<AssignmentFeedback>('assignmentFeedbacks', 'assignmentId', assignmentId)
const feedbackIds = assignmentFeedbacks.map(f => f.id!)
const feedbackCategoryRatings = getRowsWhereIn<FeedbackCategoryRating>('feedbackCategoryRatings', 'assignmentFeedbackId', feedbackIds)
const feedbackDimensionTexts = getRowsWhereIn<FeedbackDimensionText>('feedbackDimensionTexts', 'assignmentFeedbackId', feedbackIds)
const feedbackCategoryTexts = getRowsWhereIn<FeedbackCategoryText>('feedbackCategoryTexts', 'assignmentFeedbackId', feedbackIds)
const instituteeIds = new Set<number>(assignment.instituteeIds)
for (const e of assignment.instituteeEnrollments ?? []) instituteeIds.add(e.instituteeId)
for (const e of conversationEntries) instituteeIds.add(e.instituteeId)
for (const a of assessments) instituteeIds.add(a.instituteeId)
for (const r of meetingCategoryRatings) instituteeIds.add(r.instituteeId)
for (const r of checklistResponses) if (r.instituteeId != null) instituteeIds.add(r.instituteeId)
for (const f of feedbackDrafts) instituteeIds.add(f.instituteeId)
for (const f of assignmentFeedbacks) instituteeIds.add(f.instituteeId)
const consultants = getRowsWhereIn<Consultant>('consultants', 'id', [...instituteeIds])
const groupIds = [...new Set(consultants.map(c => c.groupId))]
const groups = getRowsWhereIn<Group>('groups', 'id', groupIds)
const criterionIds = collectCriterionIds({
assignmentType, phaseTemplates, checklistItemDefs, assessments,
checklistResponses, conversationEntries, meetingInstances,
})
for (const r of meetingCategoryRatings) {
for (const i of getRowsWhereEquals<FeedbackCriterionItem>('feedbackCriterionItems', 'categoryId', r.categoryId)) {
criterionIds.add(i.id!)
}
}
for (const r of feedbackCategoryRatings) {
for (const i of getRowsWhereEquals<FeedbackCriterionItem>('feedbackCriterionItems', 'categoryId', r.feedbackCategoryId)) {
criterionIds.add(i.id!)
}
}
for (const s of conversationSkillScores) {
for (const i of getRowsWhereEquals<FeedbackCriterionItem>('feedbackCriterionItems', 'categoryId', s.criteriaId)) {
criterionIds.add(i.id!)
}
}
const feedbackCriterionItems = getRowsWhereIn<FeedbackCriterionItem>('feedbackCriterionItems', 'id', [...criterionIds])
.map(i => ({ ...i, learnedPatternHints: undefined }))
const categoryIds = new Set(feedbackCriterionItems.map(i => i.categoryId))
for (const r of meetingCategoryRatings) categoryIds.add(r.categoryId)
for (const r of feedbackCategoryRatings) categoryIds.add(r.feedbackCategoryId)
for (const t of feedbackCategoryTexts) categoryIds.add(t.feedbackCategoryId)
for (const s of conversationSkillScores) categoryIds.add(s.criteriaId)
const feedbackCategories = getRowsWhereIn<FeedbackCategory>('feedbackCategories', 'id', [...categoryIds])
const dimensionIds = new Set(feedbackCategories.map(c => c.dimensionId))
for (const t of feedbackDimensionTexts) dimensionIds.add(t.feedbackDimensionId)
const feedbackDimensions = getRowsWhereIn<FeedbackDimension>('feedbackDimensions', 'id', [...dimensionIds])
return {
kind: ASSIGNMENT_TRANSFER_KIND,
version: 1,
exportedAt: new Date().toISOString(),
source: {
assignmentId,
assignmentNumber: assignment.assignmentNumber,
title: assignment.title,
client: assignment.client,
},
groups,
consultants,
assignmentType,
phaseTemplates,
checklistItemDefs,
feedbackDimensions,
feedbackCategories,
feedbackCriterionItems,
assignment,
meetingInstances,
conversationEntries,
conversationSkillScores,
assessments,
meetingCategoryRatings,
checklistResponses,
feedbackDrafts,
assignmentFeedbacks,
feedbackCategoryRatings,
feedbackDimensionTexts,
feedbackCategoryTexts,
}
}
/** Importiert ein Transfer-Paket als neues Assignment (Merge, kein Wipe). */
export function importAssignmentTransfer(pkg: AssignmentTransferPackage): AssignmentImportResult {
if (!pkg || pkg.kind !== ASSIGNMENT_TRANSFER_KIND || pkg.version !== 1) {
throw new Error('Ungültiges Assignment-Übergabe-Format')
}
if (!pkg.assignment || !pkg.assignmentType) {
throw new Error('Paket unvollständig (Assignment/Typ fehlt)')
}
const groupMap = new Map<number, number>()
const consultantMap = new Map<number, number>()
const dimensionMap = new Map<number, number>()
const categoryMap = new Map<number, number>()
const criterionMap = new Map<number, number>()
const typeMap = new Map<number, number>()
const phaseMap = new Map<number, number>()
const checklistDefMap = new Map<number, number>()
const meetingMap = new Map<number, number>()
const entryMap = new Map<number, number>()
const feedbackMap = new Map<number, number>()
const consultantsMatched: string[] = []
const consultantsCreated: string[] = []
const localDims = getAllRows<FeedbackDimension>('feedbackDimensions')
for (const d of pkg.feedbackDimensions) {
const byId = d.id != null ? getRowById<FeedbackDimension>('feedbackDimensions', d.id) : undefined
if (byId && norm(byId.name) === norm(d.name)) {
dimensionMap.set(d.id!, d.id!)
continue
}
const hit = localDims.find(x => norm(x.name) === norm(d.name))
if (!hit?.id) {
throw new Error(`Feedback-Dimension „${d.name}" fehlt lokal — bitte zuerst npm run setup / Starter laden.`)
}
dimensionMap.set(d.id!, hit.id)
}
const localCats = getAllRows<FeedbackCategory>('feedbackCategories')
for (const c of pkg.feedbackCategories) {
const dimId = requireMap(dimensionMap, c.dimensionId, 'Dimension')
const byId = c.id != null ? getRowById<FeedbackCategory>('feedbackCategories', c.id) : undefined
if (byId && norm(byId.name) === norm(c.name) && byId.dimensionId === dimId) {
categoryMap.set(c.id!, c.id!)
continue
}
const hit = localCats.find(x => x.dimensionId === dimId && norm(x.name) === norm(c.name))
if (!hit?.id) {
throw new Error(`Feedback-Kategorie „${c.name}" fehlt lokal — bitte Starter-Struktur angleichen.`)
}
categoryMap.set(c.id!, hit.id)
}
const localItems = getAllRows<FeedbackCriterionItem>('feedbackCriterionItems')
for (const item of pkg.feedbackCriterionItems) {
const catId = requireMap(categoryMap, item.categoryId, 'Kategorie')
const byId = item.id != null ? getRowById<FeedbackCriterionItem>('feedbackCriterionItems', item.id) : undefined
if (byId && norm(byId.name) === norm(item.name) && byId.categoryId === catId) {
criterionMap.set(item.id!, item.id!)
continue
}
const hit = localItems.find(x => x.categoryId === catId && norm(x.name) === norm(item.name))
if (!hit?.id) {
throw new Error(`Kriterium „${item.name}" fehlt lokal — bitte Starter-Struktur angleichen.`)
}
criterionMap.set(item.id!, hit.id)
}
const localTypes = getAllRows<AssignmentType>('assignmentTypes')
{
const t = pkg.assignmentType
const byId = t.id != null ? getRowById<AssignmentType>('assignmentTypes', t.id) : undefined
let typeId: number
if (byId && norm(byId.name) === norm(t.name)) {
typeId = t.id!
} else {
const hit = localTypes.find(x => norm(x.name) === norm(t.name))
if (hit?.id) {
typeId = hit.id
} else {
typeId = insertRow('assignmentTypes', {
name: t.name,
defaultPhaseKeys: t.defaultPhaseKeys,
criteriaIds: (t.criteriaIds ?? [])
.map(id => criterionMap.get(id))
.filter((id): id is number => id != null),
})
}
}
typeMap.set(t.id!, typeId)
}
const targetTypeId = requireMap(typeMap, pkg.assignmentType.id!, 'Assignment-Typ')
const localPhases = getRowsWhereEquals<PhaseTemplate>('phaseTemplates', 'assignmentTypeId', targetTypeId)
for (const p of pkg.phaseTemplates) {
const byKey = localPhases.find(x => x.phaseKey === p.phaseKey && norm(x.label) === norm(p.label))
?? localPhases.find(x => x.phaseKey === p.phaseKey)
let phaseId: number
if (byKey?.id) {
phaseId = byKey.id
} else {
phaseId = insertRow('phaseTemplates', {
assignmentTypeId: targetTypeId,
phaseKey: p.phaseKey,
label: p.label,
withWhom: p.withWhom,
isRepeatable: p.isRepeatable,
hasConversation: p.hasConversation,
hasAssessment: p.hasAssessment,
hasChecklist: p.hasChecklist,
criteriaIds: (p.criteriaIds ?? [])
.map(id => criterionMap.get(id))
.filter((id): id is number => id != null),
order: p.order,
})
}
phaseMap.set(p.id!, phaseId)
}
for (const def of pkg.checklistItemDefs) {
const phaseId = requireMap(phaseMap, def.phaseTemplateId, 'Phase')
const localDefs = getRowsWhereEquals<ChecklistItemDef>('checklistItemDefs', 'phaseTemplateId', phaseId)
const hit = localDefs.find(x => norm(x.label) === norm(def.label) && x.order === def.order)
?? localDefs.find(x => norm(x.label) === norm(def.label))
let defId: number
if (hit?.id) {
defId = hit.id
} else {
defId = insertRow('checklistItemDefs', {
phaseTemplateId: phaseId,
label: def.label,
linkedCriterionItemId: def.linkedCriterionItemId != null
? (criterionMap.get(def.linkedCriterionItemId) ?? null)
: null,
scope: def.scope,
order: def.order,
scoreContribution: def.scoreContribution,
})
}
checklistDefMap.set(def.id!, defId)
}
const pkgGroupsById = new Map(pkg.groups.map(g => [g.id!, g]))
for (const g of pkg.groups) {
const locals = getAllRows<Group>('groups')
const hit = locals.find(x => groupKey(x) === groupKey(g))
groupMap.set(g.id!, hit?.id ?? insertRow('groups', { name: g.name, cohortYear: g.cohortYear }))
}
for (const c of pkg.consultants) {
const label = `${c.firstName} ${c.lastName}`.trim()
const locals = getAllRows<Consultant>('consultants')
const ek = emailKey(c)
const hit = ek
? locals.find(x => emailKey(x) === ek)
: locals.find(x => personKey(x) === personKey(c))
if (hit?.id) {
consultantMap.set(c.id!, hit.id)
consultantsMatched.push(label)
continue
}
const srcGroup = pkgGroupsById.get(c.groupId)
if (!srcGroup) throw new Error(`Gruppe für Berater „${label}" fehlt im Paket`)
let groupId = groupMap.get(srcGroup.id!)
if (groupId == null) {
const gLocals = getAllRows<Group>('groups')
const gHit = gLocals.find(x => groupKey(x) === groupKey(srcGroup))
groupId = gHit?.id ?? insertRow('groups', { name: srcGroup.name, cohortYear: srcGroup.cohortYear })
groupMap.set(srcGroup.id!, groupId)
}
const newId = insertRow('consultants', {
groupId,
firstName: c.firstName,
lastName: c.lastName,
email: ek ?? '',
})
consultantMap.set(c.id!, newId)
consultantsCreated.push(label)
}
let newAssignmentId = 0
let checklistResponseCount = 0
db.exec('BEGIN')
try {
const a = pkg.assignment
newAssignmentId = insertRow('assignments', {
title: a.title,
client: a.client,
assignmentTypeId: targetTypeId,
instituteeIds: a.instituteeIds.map(id => requireMap(consultantMap, id, 'Berater')),
leadName: a.leadName,
status: a.status,
createdAt: a.createdAt || new Date().toISOString(),
assignmentNumber: a.assignmentNumber,
description: a.description,
instituteeEnrollments: (a.instituteeEnrollments ?? []).map(e => ({
...e,
instituteeId: requireMap(consultantMap, e.instituteeId, 'Berater'),
})),
deletedAt: null,
archivedAt: null,
})
for (const m of pkg.meetingInstances) {
const meetingId = insertRow('meetingInstances', {
assignmentId: newAssignmentId,
phaseTemplateId: requireMap(phaseMap, m.phaseTemplateId, 'Phase'),
phaseIndex: m.phaseIndex,
date: m.date,
status: m.status,
generalNotes: m.generalNotes ?? '',
deletedAt: m.deletedAt ?? null,
generalNoteTags: remapTags(m.generalNoteTags, criterionMap),
})
meetingMap.set(m.id!, meetingId)
}
for (const e of pkg.conversationEntries) {
const entryId = insertRow('conversationEntries', {
meetingInstanceId: requireMap(meetingMap, e.meetingInstanceId, 'Meeting'),
instituteeId: requireMap(consultantMap, e.instituteeId, 'Berater'),
sequenceIndex: e.sequenceIndex,
note: e.note,
fillerCount: e.fillerCount ?? 0,
updatedAt: e.updatedAt || new Date().toISOString(),
lineTags: remapTags(e.lineTags, criterionMap),
})
entryMap.set(e.id!, entryId)
}
for (const s of pkg.conversationSkillScores) {
insertRow('conversationSkillScores', {
conversationEntryId: requireMap(entryMap, s.conversationEntryId, 'Protokoll-Eintrag'),
criteriaId: requireMap(categoryMap, s.criteriaId, 'Kategorie (Skill-Score)'),
score: s.score,
})
}
for (const asmt of pkg.assessments) {
insertRow('assessments', {
meetingInstanceId: requireMap(meetingMap, asmt.meetingInstanceId, 'Meeting'),
instituteeId: requireMap(consultantMap, asmt.instituteeId, 'Berater'),
criteriaId: requireMap(criterionMap, asmt.criteriaId, 'Kriterium'),
score: asmt.score,
note: asmt.note ?? '',
updatedAt: asmt.updatedAt || new Date().toISOString(),
scoreNeedsReview: asmt.scoreNeedsReview ?? false,
})
}
for (const r of pkg.meetingCategoryRatings) {
insertRow('meetingCategoryRatings', {
meetingInstanceId: requireMap(meetingMap, r.meetingInstanceId, 'Meeting'),
instituteeId: requireMap(consultantMap, r.instituteeId, 'Berater'),
categoryId: requireMap(categoryMap, r.categoryId, 'Kategorie'),
score: r.score,
note: r.note,
})
}
for (const r of pkg.checklistResponses) {
insertRow('checklistResponses', {
meetingInstanceId: requireMap(meetingMap, r.meetingInstanceId, 'Meeting'),
instituteeId: r.instituteeId != null ? requireMap(consultantMap, r.instituteeId, 'Berater') : null,
checklistItemId: requireMap(checklistDefMap, r.checklistItemId, 'Checklistenpunkt'),
rating: r.rating,
note: r.note ?? '',
criterionItemId: r.criterionItemId != null ? (criterionMap.get(r.criterionItemId) ?? null) : null,
criterionOverride: r.criterionOverride ?? false,
})
checklistResponseCount++
}
for (const d of pkg.feedbackDrafts) {
insertRow('feedbackDrafts', {
assignmentId: newAssignmentId,
instituteeId: requireMap(consultantMap, d.instituteeId, 'Berater'),
content: d.content,
updatedAt: d.updatedAt || new Date().toISOString(),
})
}
for (const f of pkg.assignmentFeedbacks) {
const fbId = insertRow('assignmentFeedbacks', {
assignmentId: newAssignmentId,
instituteeId: requireMap(consultantMap, f.instituteeId, 'Berater'),
status: f.status,
aiModel: f.aiModel ?? '',
updatedAt: f.updatedAt || new Date().toISOString(),
})
feedbackMap.set(f.id!, fbId)
}
for (const r of pkg.feedbackCategoryRatings) {
insertRow('feedbackCategoryRatings', {
assignmentFeedbackId: requireMap(feedbackMap, r.assignmentFeedbackId, 'Feedback'),
feedbackCategoryId: requireMap(categoryMap, r.feedbackCategoryId, 'Kategorie'),
rating: r.rating,
})
}
for (const t of pkg.feedbackDimensionTexts) {
insertRow('feedbackDimensionTexts', {
assignmentFeedbackId: requireMap(feedbackMap, t.assignmentFeedbackId, 'Feedback'),
feedbackDimensionId: requireMap(dimensionMap, t.feedbackDimensionId, 'Dimension'),
achievements: t.achievements ?? '',
developmentNeeds: t.developmentNeeds ?? '',
suggestedAchievements: t.suggestedAchievements,
suggestedDevelopmentNeeds: t.suggestedDevelopmentNeeds,
})
}
for (const t of pkg.feedbackCategoryTexts) {
insertRow('feedbackCategoryTexts', {
assignmentFeedbackId: requireMap(feedbackMap, t.assignmentFeedbackId, 'Feedback'),
feedbackCategoryId: requireMap(categoryMap, t.feedbackCategoryId, 'Kategorie'),
benefits: t.benefits ?? '',
concerns: t.concerns ?? '',
suggestedBenefits: t.suggestedBenefits,
suggestedConcerns: t.suggestedConcerns,
})
}
db.exec('COMMIT')
} catch (err) {
db.exec('ROLLBACK')
throw err
}
return {
assignmentId: newAssignmentId,
consultantsMatched,
consultantsCreated,
meetings: pkg.meetingInstances.length,
checklistResponses: checklistResponseCount,
}
}
+38
View File
@@ -0,0 +1,38 @@
import {
getAllRows, getRowById, insertRow, updateRow,
getRowsWhereEquals, deleteRowsWhereEquals, deleteRowById, countWhereEquals,
} from '../crud'
import type { AssignmentType, PhaseTemplate } from '../../../src/db/types'
import { deleteChecklistItemDefsForPhaseTemplate } from './checklists'
export const listAssignmentTypes = (): AssignmentType[] => getAllRows<AssignmentType>('assignmentTypes')
export const getAssignmentType = (id: number): AssignmentType | undefined => getRowById<AssignmentType>('assignmentTypes', id)
export const addAssignmentType = (type: Omit<AssignmentType, 'id'>): number => insertRow('assignmentTypes', type)
export const updateAssignmentType = (id: number, patch: Partial<AssignmentType>): number =>
updateRow('assignmentTypes', id, patch)
/** Löscht nur, wenn keine Assignments mehr diesen Typ referenzieren (Cascade auf phaseTemplates sonst). */
export function deleteAssignmentType(id: number): { ok: true } | { ok: false; assignmentCount: number } {
const assignmentCount = countWhereEquals('assignments', 'assignmentTypeId', id)
if (assignmentCount > 0) return { ok: false, assignmentCount }
for (const tmpl of getRowsWhereEquals<PhaseTemplate>('phaseTemplates', 'assignmentTypeId', id)) {
deleteChecklistItemDefsForPhaseTemplate(tmpl.id!)
}
deleteRowsWhereEquals('phaseTemplates', 'assignmentTypeId', id)
deleteRowById('assignmentTypes', id)
return { ok: true }
}
export const listPhaseTemplates = (): PhaseTemplate[] => getAllRows<PhaseTemplate>('phaseTemplates')
export const getPhaseTemplate = (id: number): PhaseTemplate | undefined => getRowById<PhaseTemplate>('phaseTemplates', id)
export const listPhaseTemplatesForType = (assignmentTypeId: number): PhaseTemplate[] => {
const rows = getRowsWhereEquals<PhaseTemplate>('phaseTemplates', 'assignmentTypeId', assignmentTypeId)
return rows.sort((a, b) => a.order - b.order)
}
export const addPhaseTemplate = (tmpl: Omit<PhaseTemplate, 'id'>): number => insertRow('phaseTemplates', tmpl)
export const updatePhaseTemplate = (id: number, patch: Partial<PhaseTemplate>): number =>
updateRow('phaseTemplates', id, patch)
export function deletePhaseTemplate(id: number): void {
deleteChecklistItemDefsForPhaseTemplate(id)
deleteRowById('phaseTemplates', id)
}
+102
View File
@@ -0,0 +1,102 @@
import {
getAllRows, getRowById, getRowsWhereEquals, insertRow, updateRow,
deleteRowsWhereEquals, deleteRowsWhereIn, deleteRowById,
} from '../crud'
import type { Assignment, AssignmentType, Consultant, AssignmentFeedback } from '../../../src/db/types'
import { listMeetingInstancesForAssignment, hardDeleteMeetingInstance } from './meetings'
export const listAssignments = (): Assignment[] => getAllRows<Assignment>('assignments')
export const listAssignmentsNewestFirst = (): Assignment[] =>
getAllRows<Assignment>('assignments').sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())
export const getAssignment = (id: number): Assignment | undefined => getRowById<Assignment>('assignments', id)
export const addAssignment = (a: Omit<Assignment, 'id'>): number => insertRow('assignments', a)
export const updateAssignment = (id: number, patch: Partial<Assignment>): number => updateRow('assignments', id, patch)
/** Erfüllt für's Löschen nötige Voraussetzung: jedes zugeordnete Institutee hat ein finales Feedback. */
export function isAssignmentFeedbackComplete(assignmentId: number): boolean {
const a = getRowById<Assignment>('assignments', assignmentId)
if (!a) return false
const feedbacks = getRowsWhereEquals<AssignmentFeedback>('assignmentFeedbacks', 'assignmentId', assignmentId)
return a.instituteeIds.every(iid => feedbacks.some(f => f.instituteeId === iid && f.status === 'final'))
}
export function softDeleteAssignment(id: number): number {
const a = getRowById<Assignment>('assignments', id)
if (!a) throw new Error('Assignment nicht gefunden')
if (a.status !== 'done' || !isAssignmentFeedbackComplete(id)) {
throw new Error('Löschen nur möglich, wenn das Assignment abgeschlossen ist und für alle Institutees finales Feedback vorliegt')
}
return updateRow('assignments', id, { deletedAt: new Date().toISOString() })
}
export const restoreAssignment = (id: number): number =>
updateRow('assignments', id, { deletedAt: null })
export function archiveAssignment(id: number): number {
const a = getRowById<Assignment>('assignments', id)
if (!a) throw new Error('Assignment nicht gefunden')
if (a.status !== 'done') throw new Error('Nur abgeschlossene Assignments können archiviert werden')
return updateRow('assignments', id, { archivedAt: new Date().toISOString() })
}
export const unarchiveAssignment = (id: number): number =>
updateRow('assignments', id, { archivedAt: null })
/** Cascade: meetingInstances (+ deren Kinder) → feedbackDrafts → assignmentFeedbacks (+ deren Kinder) → assignment. */
export function hardDeleteAssignment(id: number): void {
for (const m of listMeetingInstancesForAssignment(id)) hardDeleteMeetingInstance(m.id!)
deleteRowsWhereEquals('feedbackDrafts', 'assignmentId', id)
const feedbackIds = getRowsWhereEquals<AssignmentFeedback>('assignmentFeedbacks', 'assignmentId', id).map(f => f.id!)
deleteRowsWhereIn('feedbackCategoryRatings', 'assignmentFeedbackId', feedbackIds)
deleteRowsWhereIn('feedbackDimensionTexts', 'assignmentFeedbackId', feedbackIds)
deleteRowsWhereIn('feedbackCategoryTexts', 'assignmentFeedbackId', feedbackIds)
deleteRowsWhereEquals('assignmentFeedbacks', 'assignmentId', id)
deleteRowById('assignments', id)
}
const TRASH_RETENTION_MS = 30 * 24 * 60 * 60 * 1000
/** Lazy-Sweep statt Cron: läuft bei jedem Dashboard-Load mit, da der Server nicht dauerhaft läuft. */
export function purgeExpiredAssignmentTrash(): void {
const now = Date.now()
for (const a of getAllRows<Assignment>('assignments')) {
if (a.deletedAt && now - new Date(a.deletedAt).getTime() > TRASH_RETENTION_MS) {
hardDeleteAssignment(a.id!)
}
}
}
export interface AssignmentWithDetails extends Assignment {
typeName: string
/** Hex-Farbe des Assignment-Typs (Fallback Brand). */
typeColor: string
instituteeNames: string[]
/** Nur für status==='done' relevant: jedes Institutee hat ein finales Feedback — steuert den Löschen-Button in der Übersicht. */
feedbackComplete: boolean
}
/** Für die Dashboard-Liste: Assignments mit aufgelöstem Typ- und Institutee-Namen, neueste zuerst. */
export function listAssignmentsWithDetails(): AssignmentWithDetails[] {
purgeExpiredAssignmentTrash()
const raw = listAssignmentsNewestFirst()
const types = getAllRows<AssignmentType>('assignmentTypes')
const consultants = getAllRows<Consultant>('consultants')
const allFeedbacks = getAllRows<AssignmentFeedback>('assignmentFeedbacks')
const typeMap = new Map<number, AssignmentType>(types.map(t => [t.id!, t]))
const consMap = new Map<number, Consultant>(consultants.map(c => [c.id!, c]))
return raw.map(a => {
const t = typeMap.get(a.assignmentTypeId)
return {
...a,
typeName: t?.name ?? '—',
typeColor: t?.color?.trim() || '#0070AD',
instituteeNames: a.instituteeIds.map(id => {
const c = consMap.get(id)
return c ? `${c.firstName} ${c.lastName}` : '?'
}),
feedbackComplete: a.instituteeIds.every(iid =>
allFeedbacks.some(f => f.assignmentId === a.id && f.instituteeId === iid && f.status === 'final'),
),
}
})
}
+45
View File
@@ -0,0 +1,45 @@
/**
* Generischer Dump/Restore aller Tabellen — Server-Pendant zum bisherigen client-seitigen
* dbBackup.ts (das direkt gegen Dexie/IndexedDB lief). Iteriert exakt TABLE_DEFINITIONS aus
* tableRegistry.ts, derselben Liste, die auch das SQL-Schema erzeugt (siehe Vollständigkeits-
* Garantie im Plan) — eine neue Tabelle kann dadurch nicht unbemerkt aus dem Backup fallen.
*/
import { db } from '../../database'
import { TABLE_DEFINITIONS } from '../tableRegistry'
import { getAllRows, insertRowWithId } from '../crud'
export interface BackupPayload {
version: number
exportedAt: string
tables: Record<string, Array<Record<string, unknown>>>
}
/** Liefert jede Tabelle mit dekodierten Spalten (echte Arrays/Booleans statt JSON-/Bit-Rohwerten). */
export function exportAll(): BackupPayload {
const tables: Record<string, Array<Record<string, unknown>>> = {}
for (const table of TABLE_DEFINITIONS) {
tables[table.name] = getAllRows<Record<string, unknown>>(table.name)
}
return { version: 1, exportedAt: new Date().toISOString(), tables }
}
/** Löscht alle Tabellen und fügt die übergebenen Zeilen mit ihrer ursprünglichen id wieder ein (erhält Fremdschlüssel-Referenzen). */
export function importAll(tables: Record<string, Array<Record<string, unknown>>>): void {
db.exec('BEGIN')
try {
for (const table of TABLE_DEFINITIONS) {
db.prepare(`DELETE FROM "${table.name}"`).run()
}
for (const table of TABLE_DEFINITIONS) {
for (const row of tables[table.name] ?? []) {
const { id, ...rest } = row
if (typeof id !== 'number') continue
insertRowWithId(table.name, id, rest)
}
}
db.exec('COMMIT')
} catch (err) {
db.exec('ROLLBACK')
throw err
}
}
+70
View File
@@ -0,0 +1,70 @@
import {
getAllRows, getRowsWhereEquals, getRowsWhereIn, insertRow, updateRow, deleteRowById, deleteRowsWhereEquals,
} from '../crud'
import type { ChecklistItemDef, ChecklistResponse } from '../../../src/db/types'
export const listChecklistItemDefsForPhaseTemplate = (phaseTemplateId: number): ChecklistItemDef[] => {
const rows = getRowsWhereEquals<ChecklistItemDef>('checklistItemDefs', 'phaseTemplateId', phaseTemplateId)
return rows.sort((a, b) => a.order - b.order)
}
/** Bulk-Variante für Berichte über mehrere Phasentypen hinweg (Assignment-Report-PDF, Gesamtprotokoll). */
export const listChecklistItemDefsForPhaseTemplates = (phaseTemplateIds: number[]): ChecklistItemDef[] =>
getRowsWhereIn<ChecklistItemDef>('checklistItemDefs', 'phaseTemplateId', phaseTemplateIds).sort((a, b) => a.order - b.order)
export const addChecklistItemDef = (def: Omit<ChecklistItemDef, 'id'>): number => insertRow('checklistItemDefs', def)
export const updateChecklistItemDef = (id: number, patch: Partial<ChecklistItemDef>): number =>
updateRow('checklistItemDefs', id, patch)
/** Räumt zugehörige `checklistResponses` mit auf — gleiches Verteidigungs-Prinzip wie `deleteFeedbackCriterionItem`. */
export function deleteChecklistItemDef(id: number): void {
deleteRowsWhereEquals('checklistResponses', 'checklistItemId', id)
deleteRowById('checklistItemDefs', id)
}
/** Cascade-Baustein für `deletePhaseTemplate`/`deleteAssignmentType` — löscht alle Checklisten-Punkte samt Antworten einer Phase. */
export function deleteChecklistItemDefsForPhaseTemplate(phaseTemplateId: number): void {
for (const def of listChecklistItemDefsForPhaseTemplate(phaseTemplateId)) {
deleteChecklistItemDef(def.id!)
}
}
export const listChecklistResponsesForMeeting = (meetingInstanceId: number): ChecklistResponse[] =>
getRowsWhereEquals<ChecklistResponse>('checklistResponses', 'meetingInstanceId', meetingInstanceId)
/** Bulk-Variante für Berichte über mehrere Meetings hinweg (Assignment-Report-PDF, Gesamtprotokoll). */
export const listChecklistResponsesForMeetings = (meetingInstanceIds: number[]): ChecklistResponse[] =>
getRowsWhereIn<ChecklistResponse>('checklistResponses', 'meetingInstanceId', meetingInstanceIds)
/**
* Upsert per Komposit-Schlüssel (meetingInstanceId, checklistItemId, instituteeId ?? null), gleiches
* Find-or-Insert-Muster wie `setAssessmentScore`/`saveAssessmentNote` in MeetingView.tsx. `criterionItemId`
* überschreibt pro Antwort individuell die Konfigurations-Vorgabe (`ChecklistItemDef.linkedCriterionItemId`)
* — siehe CLAUDE.md „Individuelle Kriterium-Zuordnung pro Checklisten-Antwort".
*/
export function upsertChecklistResponse(input: {
meetingInstanceId: number
instituteeId?: number
checklistItemId: number
rating: ChecklistResponse['rating']
note: string
criterionItemId?: number | null
criterionOverride?: boolean
}): number {
const existing = getAllRows<ChecklistResponse>('checklistResponses').find(r =>
r.meetingInstanceId === input.meetingInstanceId &&
r.checklistItemId === input.checklistItemId &&
(r.instituteeId ?? null) === (input.instituteeId ?? null),
)
const row = {
rating: input.rating,
note: input.note,
criterionItemId: input.criterionItemId,
criterionOverride: input.criterionOverride,
}
if (existing?.id) {
updateRow('checklistResponses', existing.id, row)
return existing.id
}
return insertRow('checklistResponses', { ...input, ...row })
}
+266
View File
@@ -0,0 +1,266 @@
import {
getAllRows, getRowById, getRowsWhereIn,
insertRow, updateRow, deleteRowById, deleteRowsWhereEquals, deleteRowsWhereIn,
} from '../crud'
import type {
Group, Consultant, Assignment, AssignmentFeedback, FeedbackCategoryRating,
FeedbackCategory, ConversationEntry, RatingScore,
ConsultantImportRow, ConsultantImportResult, HardDeleteConsultantResult,
ConsultantAssignmentSummary, ConsultantDetail,
} from '../../../src/db/types'
export type {
ConsultantImportRow, ConsultantImportResult, HardDeleteConsultantResult,
ConsultantAssignmentSummary, ConsultantDetail,
}
export function normalizeEmail(email: string): string {
return email.trim().toLowerCase()
}
export function listGroups(): Group[] {
return getAllRows<Group>('groups').sort((a, b) =>
a.cohortYear !== b.cohortYear ? b.cohortYear - a.cohortYear : a.name.localeCompare(b.name),
)
}
export const getGroup = (id: number): Group | undefined => getRowById<Group>('groups', id)
export const addGroup = (group: Omit<Group, 'id'>): number => insertRow('groups', group)
export function updateGroup(id: number, patch: Partial<Group>): number {
return updateRow('groups', id, patch)
}
/** Nur leere Gruppen — sonst Fehlertext. */
export function deleteGroup(id: number): { ok: true } | { ok: false; reason: string; memberCount: number } {
const members = getAllRows<Consultant>('consultants').filter(c => c.groupId === id)
if (members.length > 0) {
return {
ok: false,
reason: 'Gruppe hat noch Personen — zuerst umziehen oder archivieren/löschen.',
memberCount: members.length,
}
}
deleteRowById('groups', id)
return { ok: true }
}
export const listConsultants = (): Consultant[] => getAllRows<Consultant>('consultants')
export function listActiveConsultants(): Consultant[] {
return listConsultants().filter(c => !c.archivedAt)
}
export function listArchivedConsultants(): Consultant[] {
return listConsultants().filter(c => !!c.archivedAt)
}
export const getConsultant = (id: number): Consultant | undefined => getRowById<Consultant>('consultants', id)
export const getConsultantsByIds = (ids: number[]): Consultant[] =>
getRowsWhereIn<Consultant>('consultants', 'id', ids)
export function findConsultantByEmail(email: string): Consultant | undefined {
const key = normalizeEmail(email)
if (!key) return undefined
return listConsultants().find(c => normalizeEmail(c.email ?? '') === key)
}
function assertUniqueEmail(email: string, exceptId?: number): void {
const key = normalizeEmail(email)
if (!key) throw new Error('E-Mail ist Pflicht.')
const hit = listConsultants().find(c => normalizeEmail(c.email ?? '') === key && c.id !== exceptId)
if (hit) throw new Error(`E-Mail „${key}" ist bereits vergeben (${hit.firstName} ${hit.lastName}).`)
}
export function addConsultant(consultant: Omit<Consultant, 'id'>): number {
const email = normalizeEmail(consultant.email ?? '')
assertUniqueEmail(email)
return insertRow('consultants', {
...consultant,
email,
firstName: consultant.firstName.trim(),
lastName: consultant.lastName.trim(),
})
}
export function updateConsultant(id: number, patch: Partial<Consultant>): number {
const next: Partial<Consultant> = { ...patch }
if (patch.email !== undefined) {
const email = normalizeEmail(patch.email)
assertUniqueEmail(email, id)
next.email = email
}
if (patch.firstName !== undefined) next.firstName = patch.firstName.trim()
if (patch.lastName !== undefined) next.lastName = patch.lastName.trim()
return updateRow('consultants', id, next)
}
export function archiveConsultant(id: number): number {
return updateRow('consultants', id, { archivedAt: new Date().toISOString() })
}
export function unarchiveConsultant(id: number): number {
return updateRow('consultants', id, { archivedAt: null as unknown as undefined })
}
/**
* Import in eine gewählte Zielgruppe. Abgleich nur über E-Mail.
* moveIfDifferentGroup: bekannte Personen mit anderer Gruppe in die Zielgruppe verschieben.
*/
export function importConsultantsToGroup(
groupId: number,
rows: ConsultantImportRow[],
moveIfDifferentGroup = true,
): ConsultantImportResult {
const group = getGroup(groupId)
if (!group) throw new Error('Zielgruppe nicht gefunden.')
const result: ConsultantImportResult = { created: 0, updated: 0, moved: 0, skipped: 0, errors: [] }
const seenInFile = new Set<string>()
for (let i = 0; i < rows.length; i++) {
const row = rows[i]!
const line = i + 1
const email = normalizeEmail(row.email ?? '')
const firstName = (row.firstName ?? '').trim()
const lastName = (row.lastName ?? '').trim()
if (!email) {
result.errors.push(`Zeile ${line}: E-Mail fehlt`)
result.skipped++
continue
}
if (!firstName || !lastName) {
result.errors.push(`Zeile ${line}: Name unvollständig (${email})`)
result.skipped++
continue
}
if (seenInFile.has(email)) {
result.errors.push(`Zeile ${line}: doppelte E-Mail in Datei (${email})`)
result.skipped++
continue
}
seenInFile.add(email)
const existing = findConsultantByEmail(email)
if (!existing?.id) {
insertRow('consultants', { groupId, firstName, lastName, email })
result.created++
continue
}
const patch: Partial<Consultant> = { firstName, lastName }
if (existing.groupId !== groupId) {
if (moveIfDifferentGroup) {
patch.groupId = groupId
result.moved++
}
}
updateRow('consultants', existing.id, patch)
result.updated++
}
return result
}
/** Feedback + personenbezogene Meeting-Daten weg; Assignment bleibt, Person wird entkoppelt. */
export function hardDeleteConsultant(id: number): HardDeleteConsultantResult {
const person = getConsultant(id)
if (!person) throw new Error('Person nicht gefunden.')
const feedbacks = getAllRows<AssignmentFeedback>('assignmentFeedbacks').filter(f => f.instituteeId === id)
const feedbackIds = feedbacks.map(f => f.id!).filter(Boolean)
if (feedbackIds.length) {
deleteRowsWhereIn('feedbackCategoryRatings', 'assignmentFeedbackId', feedbackIds)
deleteRowsWhereIn('feedbackDimensionTexts', 'assignmentFeedbackId', feedbackIds)
deleteRowsWhereIn('feedbackCategoryTexts', 'assignmentFeedbackId', feedbackIds)
}
deleteRowsWhereEquals('assignmentFeedbacks', 'instituteeId', id)
deleteRowsWhereEquals('feedbackDrafts', 'instituteeId', id)
const entries = getAllRows<ConversationEntry>('conversationEntries').filter(e => e.instituteeId === id)
const entryIds = entries.map(e => e.id!).filter(Boolean)
if (entryIds.length) {
deleteRowsWhereIn('conversationSkillScores', 'conversationEntryId', entryIds)
}
deleteRowsWhereEquals('conversationEntries', 'instituteeId', id)
deleteRowsWhereEquals('assessments', 'instituteeId', id)
deleteRowsWhereEquals('meetingCategoryRatings', 'instituteeId', id)
deleteRowsWhereEquals('checklistResponses', 'instituteeId', id)
const emptiedAssignmentIds: number[] = []
let assignmentsTouched = 0
const assignments = getAllRows<Assignment>('assignments')
for (const a of assignments) {
if (!a.id || !a.instituteeIds.includes(id)) continue
assignmentsTouched++
const instituteeIds = a.instituteeIds.filter(x => x !== id)
const instituteeEnrollments = (a.instituteeEnrollments ?? []).filter(e => e.instituteeId !== id)
updateRow('assignments', a.id, { instituteeIds, instituteeEnrollments })
if (instituteeIds.length === 0) emptiedAssignmentIds.push(a.id)
}
deleteRowById('consultants', id)
return {
emptiedAssignmentIds,
feedbacksDeleted: feedbacks.length,
assignmentsTouched,
}
}
/** @deprecated — nutze hardDeleteConsultant; bleibt als Alias für alte Client-Aufrufe. */
export function deleteConsultant(id: number): void {
hardDeleteConsultant(id)
}
export function getConsultantDetail(id: number): ConsultantDetail | undefined {
const consultant = getConsultant(id)
if (!consultant) return undefined
const group = getGroup(consultant.groupId)
const types = getAllRows<{ id?: number; name: string }>('assignmentTypes')
const typeMap = new Map(types.map(t => [t.id!, t.name]))
const categories = getAllRows<FeedbackCategory>('feedbackCategories')
const catMap = new Map(categories.map(c => [c.id!, c.name]))
const allFeedbacks = getAllRows<AssignmentFeedback>('assignmentFeedbacks')
const allRatings = getAllRows<FeedbackCategoryRating>('feedbackCategoryRatings')
const assignments = getAllRows<Assignment>('assignments')
.filter(a => a.instituteeIds.includes(id))
.map(a => {
const fb = allFeedbacks.find(f => f.assignmentId === a.id && f.instituteeId === id)
const ratings = fb?.id
? allRatings
.filter(r => r.assignmentFeedbackId === fb.id)
.map(r => ({
categoryId: r.feedbackCategoryId,
categoryName: catMap.get(r.feedbackCategoryId) ?? `Kategorie ${r.feedbackCategoryId}`,
rating: (r.rating ?? null) as RatingScore | null,
}))
: []
return {
assignmentId: a.id!,
title: a.title,
assignmentNumber: a.assignmentNumber,
client: a.client,
status: a.status,
deletedAt: a.deletedAt,
archivedAt: a.archivedAt,
plannedStart: a.plannedStart,
plannedEnd: a.plannedEnd,
createdAt: a.createdAt,
typeName: typeMap.get(a.assignmentTypeId) ?? '—',
feedbackStatus: (!fb ? 'none' : fb.status === 'final' ? 'final' : 'draft') as 'none' | 'draft' | 'final',
categoryRatings: ratings,
}
})
.sort((a, b) => {
const ae = a.plannedEnd ?? a.createdAt
const be = b.plannedEnd ?? b.createdAt
return be.localeCompare(ae)
})
return { consultant, group, assignments }
}
+19
View File
@@ -0,0 +1,19 @@
import { getAllRows, getRowsWhereEquals, getRowsWhereIn, insertRow, updateRow, deleteRowById, deleteRowsWhereEquals } from '../crud'
import type { ConversationEntry, ConversationSkillScore } from '../../../src/db/types'
export const listConversationEntriesForMeeting = (meetingInstanceId: number): ConversationEntry[] =>
getRowsWhereEquals<ConversationEntry>('conversationEntries', 'meetingInstanceId', meetingInstanceId)
.sort((a, b) => a.sequenceIndex - b.sequenceIndex)
export const listConversationEntriesForMeetings = (meetingInstanceIds: number[]): ConversationEntry[] =>
getRowsWhereIn<ConversationEntry>('conversationEntries', 'meetingInstanceId', meetingInstanceIds)
export const addConversationEntry = (e: Omit<ConversationEntry, 'id'>): number => insertRow('conversationEntries', e)
export const updateConversationEntry = (id: number, patch: Partial<ConversationEntry>): number =>
updateRow('conversationEntries', id, patch)
export const deleteConversationEntry = (id: number): void => deleteRowById('conversationEntries', id)
export const listConversationSkillScoresAll = (): ConversationSkillScore[] => getAllRows<ConversationSkillScore>('conversationSkillScores')
export const addConversationSkillScore = (s: Omit<ConversationSkillScore, 'id'>): number => insertRow('conversationSkillScores', s)
export const updateConversationSkillScore = (id: number, patch: Partial<ConversationSkillScore>): number =>
updateRow('conversationSkillScores', id, patch)
export const deleteConversationSkillScoresForEntry = (conversationEntryId: number): number =>
deleteRowsWhereEquals('conversationSkillScores', 'conversationEntryId', conversationEntryId)
+28
View File
@@ -0,0 +1,28 @@
import { getAllRows } from '../crud'
import type { ConversationEntry, MeetingInstance, ConversationLineTag } from '../../../src/db/types'
/**
* Flacht `lineTags`/`generalNoteTags` über ALLE Assignments hinweg zu einem globalen
* (Zeilentext → Kriterium)-Korpus ab — Grundlage für die lokale Ähnlichkeitssuche im
* selbstlernenden Kriterien-Tagging (Client, `src/utils/criterionSuggestion.ts`). Gleiches
* Iterationsmuster wie `getCriterionUsageMap()` in `feedbackStructure.ts`, hier aber die
* Rohdaten statt aggregierter Zählungen. Rückgabetyp ist bewusst `ConversationLineTag[]` (kein
* neuer Typ) — jeder Korpus-Eintrag IST eine bereits vergebene Zeilen-Zuordnung, nur aus zwei
* Quellen (Gesprächsbeiträge + allgemeine Notizen) zusammengeführt.
*/
export function getGlobalLineTagCorpus(): ConversationLineTag[] {
const corpus: ConversationLineTag[] = []
for (const e of getAllRows<ConversationEntry>('conversationEntries')) {
for (const tag of e.lineTags ?? []) {
corpus.push({ text: tag.text, criterionItemId: tag.criterionItemId })
}
}
for (const m of getAllRows<MeetingInstance>('meetingInstances')) {
for (const tag of m.generalNoteTags ?? []) {
corpus.push({ text: tag.text, criterionItemId: tag.criterionItemId })
}
}
return corpus
}
+511
View File
@@ -0,0 +1,511 @@
import {
getAllRows, getRowsWhereIn, insertRow, updateRow, getRowById, insertRowWithId,
getRowsWhereEquals, deleteRowsWhereEquals, deleteRowById,
} from '../crud'
import type {
FeedbackDimension, FeedbackCategory, FeedbackCriterionItem, FeedbackDimensionPrompt,
Assessment, ConversationEntry, MeetingInstance, Assignment, AssignmentType, PhaseTemplate, Consultant,
AppSettings,
} from '../../../src/db/types'
import { AI_CONFIG } from '../../../src/config/constants'
import { getOrSeedDefaultDimensionPromptTemplate } from './appSettings'
import {
parseFeedbackStructureMarkdown,
type FeedbackStructureSeed,
} from '../../../src/utils/feedbackStructureImport'
import { existsSync, readFileSync } from 'node:fs'
import { dirname, join, resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
const __dirname = dirname(fileURLToPath(import.meta.url))
export interface FeedbackStructure {
dimensions: FeedbackDimension[]
categories: FeedbackCategory[]
items: FeedbackCriterionItem[]
}
const byOrder = <T extends { order: number }>(rows: T[]) => [...rows].sort((a, b) => a.order - b.order)
/** Vollständige, nach `order` sortierte Feedback-Taxonomie. */
export function loadFeedbackStructure(): FeedbackStructure {
return {
dimensions: byOrder(getAllRows<FeedbackDimension>('feedbackDimensions')),
categories: byOrder(getAllRows<FeedbackCategory>('feedbackCategories')),
items: byOrder(getAllRows<FeedbackCriterionItem>('feedbackCriterionItems')),
}
}
export const listFeedbackCategoriesOrdered = (): FeedbackCategory[] => byOrder(getAllRows<FeedbackCategory>('feedbackCategories'))
export const listFeedbackCategoriesAll = (): FeedbackCategory[] => getAllRows<FeedbackCategory>('feedbackCategories')
export const listFeedbackCriterionItemsAll = (): FeedbackCriterionItem[] => getAllRows<FeedbackCriterionItem>('feedbackCriterionItems')
export const getFeedbackCriterionItemsByIds = (ids: number[]): FeedbackCriterionItem[] =>
getRowsWhereIn<FeedbackCriterionItem>('feedbackCriterionItems', 'id', ids)
export interface CriterionUsage {
assessmentCount: number
lineTagCount: number
generalNoteTagCount: number
assignmentTypeNames: string[]
phaseTemplateLabels: string[]
meetings: { meetingId: number; assignmentId: number; assignmentTitle: string; date: string }[]
}
/**
* Verwendungs-Übersicht für ALLE Kriterien in einem Durchlauf (nicht pro Kriterium einzeln) —
* macht sichtbar, wo ein Kriterium schon referenziert ist, bevor man es beim Umbau der
* Feedback-Struktur umbenennt/verschiebt/löscht. Siehe CLAUDE.md.
*/
export function getCriterionUsageMap(): Record<number, CriterionUsage> {
const usage = new Map<number, CriterionUsage>()
const ensure = (id: number): CriterionUsage => {
let u = usage.get(id)
if (!u) {
u = { assessmentCount: 0, lineTagCount: 0, generalNoteTagCount: 0, assignmentTypeNames: [], phaseTemplateLabels: [], meetings: [] }
usage.set(id, u)
}
return u
}
const meetings = getAllRows<MeetingInstance>('meetingInstances')
const meetingMap = new Map(meetings.map(m => [m.id!, m]))
const assignments = getAllRows<Assignment>('assignments')
const assignmentMap = new Map(assignments.map(a => [a.id!, a]))
const addMeetingRef = (u: CriterionUsage, meetingId: number) => {
if (u.meetings.some(x => x.meetingId === meetingId)) return
const m = meetingMap.get(meetingId)
if (!m) return
const a = assignmentMap.get(m.assignmentId)
u.meetings.push({ meetingId, assignmentId: m.assignmentId, assignmentTitle: a?.title ?? '—', date: m.date })
}
for (const a of getAllRows<Assessment>('assessments')) {
const u = ensure(a.criteriaId)
u.assessmentCount++
addMeetingRef(u, a.meetingInstanceId)
}
for (const e of getAllRows<ConversationEntry>('conversationEntries')) {
for (const tag of e.lineTags ?? []) {
const u = ensure(tag.criterionItemId)
u.lineTagCount++
addMeetingRef(u, e.meetingInstanceId)
}
}
for (const m of meetings) {
for (const tag of m.generalNoteTags ?? []) {
const u = ensure(tag.criterionItemId)
u.generalNoteTagCount++
addMeetingRef(u, m.id!)
}
}
for (const at of getAllRows<AssignmentType>('assignmentTypes')) {
for (const cid of at.criteriaIds ?? []) ensure(cid).assignmentTypeNames.push(at.name)
}
for (const pt of getAllRows<PhaseTemplate>('phaseTemplates')) {
for (const cid of pt.criteriaIds ?? []) ensure(cid).phaseTemplateLabels.push(pt.label)
}
return Object.fromEntries(usage)
}
export type CriterionUsageInstance =
| { kind: 'assessment'; assessmentId: number; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'lineTag'; conversationEntryId: number; tagText: string; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'generalNoteTag'; meetingInstanceId: number; tagText: string; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'assignmentTypeVisibility'; assignmentTypeId: number; criterionId: number; text: string }
| { kind: 'phaseTemplateVisibility'; phaseTemplateId: number; criterionId: number; text: string }
/**
* Einzelinstanzen-Liste für EIN Kriterium (im Unterschied zu `getCriterionUsageMap`, das nur
* Zählungen für ALLE Kriterien liefert) — Grundlage dafür, eine einzelne Zuordnung direkt
* umzuhängen oder zu entfernen, ohne dafür ins jeweilige Meeting navigieren zu müssen.
* Bewusst lazy/pro-Kriterium (nicht eager für alle), da hier echte Texte/Namen aufgelöst werden.
*/
export function getCriterionUsageDetails(criterionId: number): CriterionUsageInstance[] {
const instances: CriterionUsageInstance[] = []
const meetings = getAllRows<MeetingInstance>('meetingInstances')
const meetingMap = new Map(meetings.map(m => [m.id!, m]))
const assignments = getAllRows<Assignment>('assignments')
const assignmentMap = new Map(assignments.map(a => [a.id!, a]))
const consultants = getAllRows<Consultant>('consultants')
const consultantMap = new Map(consultants.map(c => [c.id!, c]))
const meetingInfo = (meetingId: number) => {
const m = meetingMap.get(meetingId)
const a = m ? assignmentMap.get(m.assignmentId) : undefined
return { meetingId, assignmentTitle: a?.title ?? '—', date: m?.date ?? '' }
}
const personLabel = (instituteeId: number | undefined) => {
if (instituteeId === undefined) return 'Allgemein'
const c = consultantMap.get(instituteeId)
return c ? `${c.firstName} ${c.lastName}` : '—'
}
for (const a of getAllRows<Assessment>('assessments')) {
if (a.criteriaId !== criterionId) continue
instances.push({
kind: 'assessment', assessmentId: a.id!, personLabel: personLabel(a.instituteeId),
text: `Score: ${a.score ?? '—'}${a.note ? ` · Notiz: ${a.note}` : ''}`,
...meetingInfo(a.meetingInstanceId),
})
}
for (const e of getAllRows<ConversationEntry>('conversationEntries')) {
for (const tag of e.lineTags ?? []) {
if (tag.criterionItemId !== criterionId) continue
instances.push({
kind: 'lineTag', conversationEntryId: e.id!, tagText: tag.text, personLabel: personLabel(e.instituteeId),
text: tag.text,
...meetingInfo(e.meetingInstanceId),
})
}
}
for (const m of meetings) {
for (const tag of m.generalNoteTags ?? []) {
if (tag.criterionItemId !== criterionId) continue
instances.push({
kind: 'generalNoteTag', meetingInstanceId: m.id!, tagText: tag.text, personLabel: personLabel(undefined),
text: tag.text,
...meetingInfo(m.id!),
})
}
}
for (const at of getAllRows<AssignmentType>('assignmentTypes')) {
if (!at.criteriaIds?.includes(criterionId)) continue
instances.push({ kind: 'assignmentTypeVisibility', assignmentTypeId: at.id!, criterionId, text: at.name })
}
for (const pt of getAllRows<PhaseTemplate>('phaseTemplates')) {
if (!pt.criteriaIds?.includes(criterionId)) continue
instances.push({ kind: 'phaseTemplateVisibility', phaseTemplateId: pt.id!, criterionId, text: pt.label })
}
return instances
}
/** Hängt EINE einzelne Verwendungsinstanz auf ein anderes Kriterium um (Konsolidieren ohne den ganzen Rest mitzuziehen). */
export function reassignUsageInstance(instance: CriterionUsageInstance, toId: number): { merged: boolean } {
if (instance.kind === 'assessment') {
const allAssessments = getAllRows<Assessment>('assessments')
const row = allAssessments.find(a => a.id === instance.assessmentId)
if (!row) return { merged: false }
return { merged: mergeOrReassignAssessment(row, toId, allAssessments) }
}
if (instance.kind === 'lineTag') {
const e = getAllRows<ConversationEntry>('conversationEntries').find(x => x.id === instance.conversationEntryId)
if (!e?.lineTags) return { merged: false }
const lineTags = e.lineTags.map(t => t.text === instance.tagText ? { ...t, criterionItemId: toId } : t)
updateRow('conversationEntries', e.id!, { lineTags })
return { merged: false }
}
if (instance.kind === 'generalNoteTag') {
const m = getAllRows<MeetingInstance>('meetingInstances').find(x => x.id === instance.meetingInstanceId)
if (!m?.generalNoteTags) return { merged: false }
const generalNoteTags = m.generalNoteTags.map(t => t.text === instance.tagText ? { ...t, criterionItemId: toId } : t)
updateRow('meetingInstances', m.id!, { generalNoteTags })
return { merged: false }
}
if (instance.kind === 'assignmentTypeVisibility') {
const at = getAllRows<AssignmentType>('assignmentTypes').find(x => x.id === instance.assignmentTypeId)
if (!at?.criteriaIds) return { merged: false }
const criteriaIds = [...new Set(at.criteriaIds.map(id => id === instance.criterionId ? toId : id))]
updateRow('assignmentTypes', at.id!, { criteriaIds })
return { merged: false }
}
// phaseTemplateVisibility
const pt = getAllRows<PhaseTemplate>('phaseTemplates').find(x => x.id === instance.phaseTemplateId)
if (!pt?.criteriaIds) return { merged: false }
const criteriaIds = [...new Set(pt.criteriaIds.map(id => id === instance.criterionId ? toId : id))]
updateRow('phaseTemplates', pt.id!, { criteriaIds })
return { merged: false }
}
/** Entfernt EINE einzelne Verwendungsinstanz (Assessment wird gelöscht, Tags nur von der Kriterium-Zuordnung befreit, Text bleibt). */
export function removeUsageInstance(instance: CriterionUsageInstance): void {
if (instance.kind === 'assessment') {
deleteRowById('assessments', instance.assessmentId)
return
}
if (instance.kind === 'lineTag') {
const e = getAllRows<ConversationEntry>('conversationEntries').find(x => x.id === instance.conversationEntryId)
if (!e?.lineTags) return
updateRow('conversationEntries', e.id!, { lineTags: e.lineTags.filter(t => t.text !== instance.tagText) })
return
}
if (instance.kind === 'generalNoteTag') {
const m = getAllRows<MeetingInstance>('meetingInstances').find(x => x.id === instance.meetingInstanceId)
if (!m?.generalNoteTags) return
updateRow('meetingInstances', m.id!, { generalNoteTags: m.generalNoteTags.filter(t => t.text !== instance.tagText) })
return
}
if (instance.kind === 'assignmentTypeVisibility') {
const at = getAllRows<AssignmentType>('assignmentTypes').find(x => x.id === instance.assignmentTypeId)
if (!at?.criteriaIds) return
updateRow('assignmentTypes', at.id!, { criteriaIds: at.criteriaIds.filter(id => id !== instance.criterionId) })
return
}
// phaseTemplateVisibility
const pt = getAllRows<PhaseTemplate>('phaseTemplates').find(x => x.id === instance.phaseTemplateId)
if (!pt?.criteriaIds) return
updateRow('phaseTemplates', pt.id!, { criteriaIds: pt.criteriaIds.filter(id => id !== instance.criterionId) })
}
/**
* Schreibt EINE Assessment-Zeile auf `toId` um. Konfliktfall: existiert für dieselbe
* (meetingInstanceId, instituteeId) bereits eine Zeile mit criteriaId=toId (keine DB-Unique-
* Constraint verhindert das), wird `row` stattdessen in die bestehende Zeile gemergt (Notizen
* zusammengeführt, vorhandener Score der Zielzeile hat Vorrang) statt eine Dubletten-Zeile zu
* erzeugen. Von `reassignCriterionReferences` (alle Zeilen) UND `reassignUsageInstance` (eine
* einzelne Zeile) genutzt, damit die Konflikt-Logik nicht doppelt gepflegt werden muss.
*/
function mergeOrReassignAssessment(row: Assessment, toId: number, allAssessments: Assessment[]): boolean {
const conflict = allAssessments.find(a =>
a.id !== row.id && a.criteriaId === toId && a.meetingInstanceId === row.meetingInstanceId && a.instituteeId === row.instituteeId,
)
if (conflict) {
const mergedNote = [conflict.note, row.note].filter(n => n?.trim()).join('\n')
updateRow('assessments', conflict.id!, { note: mergedNote, score: conflict.score ?? row.score })
deleteRowById('assessments', row.id!)
return true
}
updateRow('assessments', row.id!, { criteriaId: toId })
return false
}
/**
* Überträgt alle Referenzen von `fromId` auf `toId` (Assessments, Protokoll-/Notiz-Tags,
* Sichtbarkeits-Listen) — für sicheres Löschen mit Zusammenführung statt Datenverlust.
*/
export function reassignCriterionReferences(fromId: number, toId: number): { mergedConflicts: number } {
let mergedConflicts = 0
const allAssessments = getAllRows<Assessment>('assessments')
for (const row of allAssessments.filter(a => a.criteriaId === fromId)) {
if (mergeOrReassignAssessment(row, toId, allAssessments)) mergedConflicts++
}
for (const e of getAllRows<ConversationEntry>('conversationEntries')) {
if (!e.lineTags?.some(t => t.criterionItemId === fromId)) continue
const lineTags = e.lineTags.map(t => t.criterionItemId === fromId ? { ...t, criterionItemId: toId } : t)
updateRow('conversationEntries', e.id!, { lineTags })
}
for (const m of getAllRows<MeetingInstance>('meetingInstances')) {
if (!m.generalNoteTags?.some(t => t.criterionItemId === fromId)) continue
const generalNoteTags = m.generalNoteTags.map(t => t.criterionItemId === fromId ? { ...t, criterionItemId: toId } : t)
updateRow('meetingInstances', m.id!, { generalNoteTags })
}
for (const at of getAllRows<AssignmentType>('assignmentTypes')) {
if (!at.criteriaIds?.includes(fromId)) continue
const criteriaIds = [...new Set(at.criteriaIds.map(id => id === fromId ? toId : id))]
updateRow('assignmentTypes', at.id!, { criteriaIds })
}
for (const pt of getAllRows<PhaseTemplate>('phaseTemplates')) {
if (!pt.criteriaIds?.includes(fromId)) continue
const criteriaIds = [...new Set(pt.criteriaIds.map(id => id === fromId ? toId : id))]
updateRow('phaseTemplates', pt.id!, { criteriaIds })
}
return { mergedConflicts }
}
/** Entfernt alle Referenzen auf `id` (Assessments werden gelöscht, Tags/Sichtbarkeitslisten nur von der ID befreit). */
function clearCriterionReferences(id: number): void {
deleteRowsWhereEquals('assessments', 'criteriaId', id)
for (const e of getAllRows<ConversationEntry>('conversationEntries')) {
if (!e.lineTags?.some(t => t.criterionItemId === id)) continue
updateRow('conversationEntries', e.id!, { lineTags: e.lineTags.filter(t => t.criterionItemId !== id) })
}
for (const m of getAllRows<MeetingInstance>('meetingInstances')) {
if (!m.generalNoteTags?.some(t => t.criterionItemId === id)) continue
updateRow('meetingInstances', m.id!, { generalNoteTags: m.generalNoteTags.filter(t => t.criterionItemId !== id) })
}
for (const at of getAllRows<AssignmentType>('assignmentTypes')) {
if (!at.criteriaIds?.includes(id)) continue
updateRow('assignmentTypes', at.id!, { criteriaIds: at.criteriaIds.filter(cid => cid !== id) })
}
for (const pt of getAllRows<PhaseTemplate>('phaseTemplates')) {
if (!pt.criteriaIds?.includes(id)) continue
updateRow('phaseTemplates', pt.id!, { criteriaIds: pt.criteriaIds.filter(cid => cid !== id) })
}
}
/** Legt zusätzlich einen Default-KI-Prompt für die neue Dimension an, siehe CLAUDE.md „Mehrstufiges Prompt-System". */
export function addFeedbackDimension(d: Omit<FeedbackDimension, 'id'>): number {
const id = insertRow('feedbackDimensions', d)
insertRow('feedbackDimensionPrompts', { dimensionId: id, promptTemplate: getOrSeedDefaultDimensionPromptTemplate() })
return id
}
export const updateFeedbackDimension = (id: number, patch: Partial<FeedbackDimension>): number =>
updateRow('feedbackDimensions', id, patch)
/** Cascade: Items der Kategorien (über deleteFeedbackCriterionItem, räumt Verwendungen mit auf) → Kategorien → Prompt-Konfiguration → Dimension. */
export function deleteFeedbackDimension(id: number): void {
const cats = getRowsWhereEquals<FeedbackCategory>('feedbackCategories', 'dimensionId', id)
for (const cat of cats) {
const catItems = getRowsWhereEquals<FeedbackCriterionItem>('feedbackCriterionItems', 'categoryId', cat.id!)
for (const item of catItems) deleteFeedbackCriterionItem(item.id!)
}
deleteRowsWhereEquals('feedbackCategories', 'dimensionId', id)
deleteRowsWhereEquals('feedbackDimensionPrompts', 'dimensionId', id)
deleteRowById('feedbackDimensions', id)
}
/**
* Selbstheilend: Dimensionen, die vor Einführung des Prompt-Systems (2026-07-07) angelegt wurden,
* haben noch keine `feedbackDimensionPrompts`-Zeile — wird hier per Backfill nachgezogen, statt eine
* separate Migration zu brauchen.
*/
export function listFeedbackDimensionPrompts(): FeedbackDimensionPrompt[] {
const dims = getAllRows<FeedbackDimension>('feedbackDimensions')
const existingDimIds = new Set(getAllRows<FeedbackDimensionPrompt>('feedbackDimensionPrompts').map(p => p.dimensionId))
const missing = dims.filter(dim => !existingDimIds.has(dim.id!))
if (missing.length > 0) {
const defaultTemplate = getOrSeedDefaultDimensionPromptTemplate()
for (const dim of missing) {
insertRow('feedbackDimensionPrompts', { dimensionId: dim.id!, promptTemplate: defaultTemplate })
}
}
return getAllRows<FeedbackDimensionPrompt>('feedbackDimensionPrompts')
}
/** Selbstheilend wie `listFeedbackDimensionPrompts` — legt die Zeile bei Bedarf lazy an. */
export function getFeedbackDimensionPrompt(dimensionId: number): FeedbackDimensionPrompt {
const existing = getRowsWhereEquals<FeedbackDimensionPrompt>('feedbackDimensionPrompts', 'dimensionId', dimensionId)[0]
if (existing) return existing
const promptTemplate = getOrSeedDefaultDimensionPromptTemplate()
const id = insertRow('feedbackDimensionPrompts', { dimensionId, promptTemplate })
return { id, dimensionId, promptTemplate }
}
export const updateFeedbackDimensionPrompt = (id: number, patch: Partial<FeedbackDimensionPrompt>): number =>
updateRow('feedbackDimensionPrompts', id, patch)
/** Setzt alle Dimension-Prompts auf den aktuellen Code-Standard (AI_CONFIG) und synchronisiert appSettings. */
export function resetAllDimensionPromptsToDefault(): { updated: number } {
const template = AI_CONFIG.defaultDimensionPromptTemplate
const settings = getRowById<AppSettings>('appSettings', 1)
if (settings) updateRow('appSettings', 1, { defaultDimensionPromptTemplate: template })
else insertRowWithId('appSettings', 1, {
ratingTrendWeightStep: 0.5,
defaultDimensionPromptTemplate: template,
})
const dims = getAllRows<FeedbackDimension>('feedbackDimensions')
let updated = 0
for (const dim of dims) {
const existing = getRowsWhereEquals<FeedbackDimensionPrompt>('feedbackDimensionPrompts', 'dimensionId', dim.id!)[0]
if (existing?.id) {
updateRow('feedbackDimensionPrompts', existing.id, { promptTemplate: template })
} else {
insertRow('feedbackDimensionPrompts', { dimensionId: dim.id!, promptTemplate: template })
}
updated++
}
return { updated }
}
export const addFeedbackCategory = (c: Omit<FeedbackCategory, 'id'>): number => insertRow('feedbackCategories', c)
export const updateFeedbackCategory = (id: number, patch: Partial<FeedbackCategory>): number =>
updateRow('feedbackCategories', id, patch)
/** Cascade: Items der Kategorie → Kategorie. */
export function deleteFeedbackCategory(id: number): void {
const catItems = getRowsWhereEquals<FeedbackCriterionItem>('feedbackCriterionItems', 'categoryId', id)
for (const item of catItems) deleteFeedbackCriterionItem(item.id!)
deleteRowById('feedbackCategories', id)
}
export const addFeedbackCriterionItem = (i: Omit<FeedbackCriterionItem, 'id'>): number => insertRow('feedbackCriterionItems', i)
export const updateFeedbackCriterionItem = (id: number, patch: Partial<FeedbackCriterionItem>): number =>
updateRow('feedbackCriterionItems', id, patch)
/**
* Räumt vor dem eigentlichen Löschen selbst alle Verwendungen auf (Verteidigung in der Tiefe,
* unabhängig davon ob die UI vorher per reassignCriterionReferences umgehängt hat) — siehe
* clearCriterionReferences() oben. Dadurch kann nach dem Löschen nie eine verwaiste Referenz
* übrig bleiben, egal über welchen Aufrufpfad (auch Kategorie-/Dimension-Cascade).
*/
export function deleteFeedbackCriterionItem(id: number): void {
clearCriterionReferences(id)
deleteRowById('feedbackCriterionItems', id)
}
export interface ReplaceFeedbackStructureResult {
dimensions: number
categories: number
items: number
clearedDimensions: number
}
/**
* Ersetzt die gesamte Feedback-Struktur durch ein Seed-Objekt (MD-Import / Preload).
* Löscht bestehende Dimensionen inkl. Cascade (Kategorien, Kriterien, Verwendungen, Prompts).
*/
export function replaceFeedbackStructure(seed: FeedbackStructureSeed): ReplaceFeedbackStructureResult {
if (!seed?.dimensions?.length) throw new Error('Seed enthält keine Dimensionen.')
const existing = getAllRows<FeedbackDimension>('feedbackDimensions')
for (const dim of existing) deleteFeedbackDimension(dim.id!)
let categoryCount = 0
let itemCount = 0
for (let di = 0; di < seed.dimensions.length; di++) {
const dimSeed = seed.dimensions[di]
const dimId = addFeedbackDimension({ name: dimSeed.name, order: di + 1 })
for (let ci = 0; ci < dimSeed.categories.length; ci++) {
const catSeed = dimSeed.categories[ci]
const catId = addFeedbackCategory({
dimensionId: dimId,
name: catSeed.name,
order: ci + 1,
description: catSeed.description,
})
categoryCount++
for (let ii = 0; ii < catSeed.items.length; ii++) {
const itemSeed = catSeed.items[ii]
addFeedbackCriterionItem({
categoryId: catId,
name: itemSeed.name,
order: ii + 1,
weight: itemSeed.weight,
description: itemSeed.description,
})
itemCount++
}
}
}
return {
dimensions: seed.dimensions.length,
categories: categoryCount,
items: itemCount,
clearedDimensions: existing.length,
}
}
/** Parst Markdown (Export-Format) und ersetzt die Struktur. */
export function importFeedbackStructureFromMarkdown(md: string): ReplaceFeedbackStructureResult {
return replaceFeedbackStructure(parseFeedbackStructureMarkdown(md))
}
/**
* Lädt die finale Struktur aus docs/preload/Feedback-Struktur-final.md (DEV-Preload).
* Pfad relativ zum Projektroot — nur innerhalb AssigmentMonitorV2.
*/
export function preloadFinalFeedbackStructure(): ReplaceFeedbackStructureResult {
const projectRoot = resolve(join(__dirname, '../../..'))
const mdPath = resolve(join(projectRoot, 'docs', 'preload', 'Feedback-Struktur-final.md'))
const rootNorm = projectRoot.toLowerCase()
const pathNorm = mdPath.toLowerCase()
if (!pathNorm.startsWith(rootNorm)) {
throw new Error(`[preload] SAFETY: Preload-Datei außerhalb des V2-Projekts: ${mdPath}`)
}
if (!existsSync(mdPath)) {
throw new Error(`Preload-Datei fehlt: ${mdPath}`)
}
const md = readFileSync(mdPath, 'utf8')
return importFeedbackStructureFromMarkdown(md)
}
@@ -0,0 +1,47 @@
import {
deleteRowsWhereEquals,
getAllRows,
getRowsWhereEquals,
getRowsWhereIn,
insertRow,
updateRow,
} from '../crud'
import type { MeetingCategoryRating, RatingScore } from '../../../src/db/types'
export const listMeetingCategoryRatingsForMeeting = (meetingInstanceId: number): MeetingCategoryRating[] =>
getRowsWhereEquals<MeetingCategoryRating>('meetingCategoryRatings', 'meetingInstanceId', meetingInstanceId)
export const listMeetingCategoryRatingsForMeetings = (meetingInstanceIds: number[]): MeetingCategoryRating[] =>
getRowsWhereIn<MeetingCategoryRating>('meetingCategoryRatings', 'meetingInstanceId', meetingInstanceIds)
export function upsertMeetingCategoryRating(input: {
meetingInstanceId: number
instituteeId: number
categoryId: number
score: RatingScore | null
note?: string
}): number {
const existing = getAllRows<MeetingCategoryRating>('meetingCategoryRatings').find(r =>
r.meetingInstanceId === input.meetingInstanceId &&
r.instituteeId === input.instituteeId &&
r.categoryId === input.categoryId,
)
if (existing?.id != null) {
updateRow('meetingCategoryRatings', existing.id, {
score: input.score,
note: input.note ?? existing.note ?? '',
})
return existing.id
}
return insertRow('meetingCategoryRatings', {
meetingInstanceId: input.meetingInstanceId,
instituteeId: input.instituteeId,
categoryId: input.categoryId,
score: input.score,
note: input.note ?? '',
})
}
export const deleteMeetingCategoryRatingsForMeeting = (meetingInstanceId: number): void => {
deleteRowsWhereEquals('meetingCategoryRatings', 'meetingInstanceId', meetingInstanceId)
}
+83
View File
@@ -0,0 +1,83 @@
import {
getAllRows, getRowById, getRowsWhereEquals, insertRow, updateRow,
deleteRowsWhereEquals, deleteRowsWhereIn, deleteRowById,
} from '../crud'
import type {
MeetingInstance, PhaseTemplate, Assignment, Consultant,
ConversationEntry, ConversationSkillScore, Assessment,
ChecklistItemDef, ChecklistResponse, MeetingCategoryRating,
} from '../../../src/db/types'
import { getConsultantsByIds } from './consultants'
import { listChecklistItemDefsForPhaseTemplate, listChecklistResponsesForMeeting } from './checklists'
import { listMeetingCategoryRatingsForMeeting } from './meetingCategoryRatings'
export const getMeetingInstance = (id: number): MeetingInstance | undefined => getRowById<MeetingInstance>('meetingInstances', id)
export const listMeetingInstancesForAssignment = (assignmentId: number): MeetingInstance[] =>
getRowsWhereEquals<MeetingInstance>('meetingInstances', 'assignmentId', assignmentId)
/**
* Kanonischer Filter für Aggregationen über mehrere Meetings: Papierkorb-/unfertige Meetings ausschließen,
* chronologisch sortiert. Siehe CLAUDE.md — immer diese Funktion nutzen, nicht erneut inline filtern.
*/
export function listDoneMeetingsChronological(assignmentId: number): MeetingInstance[] {
const instances = listMeetingInstancesForAssignment(assignmentId)
return instances
.filter(m => !m.deletedAt && m.status === 'done')
.sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime())
}
export const addMeetingInstance = (m: Omit<MeetingInstance, 'id'>): number => insertRow('meetingInstances', m)
export const updateMeetingInstance = (id: number, patch: Partial<MeetingInstance>): number =>
updateRow('meetingInstances', id, patch)
export const softDeleteMeetingInstance = (id: number): number =>
updateRow('meetingInstances', id, { deletedAt: new Date().toISOString() })
export const restoreMeetingInstance = (id: number): number =>
updateRow('meetingInstances', id, { deletedAt: null })
/** Cascade: conversationSkillScores der Entries → conversationEntries → assessments → meetingCategoryRatings → meetingInstance. */
export function hardDeleteMeetingInstance(id: number): void {
const entryIds = getRowsWhereEquals<ConversationEntry>('conversationEntries', 'meetingInstanceId', id).map(e => e.id!)
deleteRowsWhereIn('conversationSkillScores', 'conversationEntryId', entryIds)
deleteRowsWhereEquals('conversationEntries', 'meetingInstanceId', id)
deleteRowsWhereEquals('assessments', 'meetingInstanceId', id)
deleteRowsWhereEquals('meetingCategoryRatings', 'meetingInstanceId', id)
deleteRowsWhereEquals('checklistResponses', 'meetingInstanceId', id)
deleteRowById('meetingInstances', id)
}
export interface MeetingExportData {
meeting: MeetingInstance
template: PhaseTemplate | undefined
assignment: Assignment | undefined
consultants: Consultant[]
entries: ConversationEntry[]
allScores: ConversationSkillScore[]
assessments: Assessment[]
categoryRatings: MeetingCategoryRating[]
checklistItems: ChecklistItemDef[]
checklistResponses: ChecklistResponse[]
}
/** Gebündelte Rohdaten für Markdown-/JSON-Export eines Meetings — vorher in meetingExport.ts dupliziert. */
export function getMeetingExportData(meetingId: number): MeetingExportData {
const meeting = getRowById<MeetingInstance>('meetingInstances', meetingId)
if (!meeting) throw new Error('Meeting nicht gefunden')
const template = getRowById<PhaseTemplate>('phaseTemplates', meeting.phaseTemplateId)
const assignment = getRowById<Assignment>('assignments', meeting.assignmentId)
const instituteeIds = assignment?.instituteeIds ?? []
const consultants = getConsultantsByIds(instituteeIds)
const entries = getRowsWhereEquals<ConversationEntry>('conversationEntries', 'meetingInstanceId', meetingId)
.sort((a, b) => a.sequenceIndex - b.sequenceIndex)
const allScores = getAllRows<ConversationSkillScore>('conversationSkillScores')
const assessments = getRowsWhereEquals<Assessment>('assessments', 'meetingInstanceId', meetingId)
const categoryRatings = listMeetingCategoryRatingsForMeeting(meetingId)
const checklistItems = template?.hasChecklist ? listChecklistItemDefsForPhaseTemplate(template.id!) : []
const checklistResponses = template?.hasChecklist ? listChecklistResponsesForMeeting(meetingId) : []
return {
meeting, template, assignment, consultants, entries, allScores,
assessments, categoryRatings, checklistItems, checklistResponses,
}
}
+165
View File
@@ -0,0 +1,165 @@
/**
* Starter-Paket: nur Konfigurations-/Strukturdaten für Team-Verteilung.
* Keine Personen-, Assignment- oder Meeting-Daten (GDPR).
* Produktiv (`AssigmentMonitor`) wird nie angefasst — Skripte nutzen dieselben Pfad-Guards.
*/
import { writeFileSync, readFileSync, mkdirSync, existsSync } from 'node:fs'
import { dirname, join, resolve, sep } from 'node:path'
import { fileURLToPath } from 'node:url'
import { TABLE_DEFINITIONS, TABLE_NAMES } from './tableRegistry'
import { getAllRows, insertRowWithId } from './crud'
import { db } from '../database'
const __dirname = dirname(fileURLToPath(import.meta.url))
export const PROJECT_ROOT = resolve(join(__dirname, '../..'))
export const STARTER_DIR = join(PROJECT_ROOT, 'docs', 'starter')
export const STARTER_FILE = join(STARTER_DIR, 'starter-structure.json')
/** Tabellen mit Stammdaten / Config — IDs bleiben stabil (FK zwischen Struktur-Tabellen). */
export const STARTER_STRUCTURE_TABLES = [
'feedbackDimensions',
'feedbackCategories',
'feedbackCriterionItems',
'feedbackDimensionPrompts',
'assignmentTypes',
'phaseTemplates',
'checklistItemDefs',
'appSettings',
'criterionLevelDescriptions',
] as const
const STRUCTURE_SET = new Set<string>(STARTER_STRUCTURE_TABLES)
export interface StarterPackage {
kind: 'assignment-monitor-starter'
version: 1
exportedAt: string
note: string
tables: Record<string, Array<Record<string, unknown>>>
}
/** Verweigert jeden Pfad außerhalb V2 und jeden Produktiv-DB-Pfad. */
export function assertV2DevOnly(resolvedPath: string, label: string): void {
const pathNorm = resolvedPath.toLowerCase()
const rootNorm = PROJECT_ROOT.toLowerCase()
const rootPrefix = rootNorm.endsWith(sep) ? rootNorm : rootNorm + sep
if (!pathNorm.startsWith(rootPrefix) && pathNorm !== rootNorm) {
throw new Error(`[${label}] SAFETY: Pfad außerhalb AssignmentMonitorV2:\n ${resolvedPath}`)
}
if (
/[/\\]assigmentmonitor[/\\]/.test(pathNorm) &&
!/[/\\]assigmentmonitorv2[/\\]/.test(pathNorm)
) {
throw new Error(`[${label}] SAFETY: Produktiv-Pfad blockiert:\n ${resolvedPath}`)
}
}
export function assertStarterEnv(): void {
const apiPort = process.env.API_PORT?.trim() || '4001'
const vitePort = process.env.PORT?.trim() || '5174'
const sqliteFilename = process.env.SQLITE_FILENAME?.trim() || 'assignment-monitor-v2-dev.sqlite3'
if (apiPort === '4000') {
throw new Error('[starter] SAFETY: API_PORT=4000 ist der Produktiv-Port — abgebrochen.')
}
if (vitePort === '5173') {
throw new Error('[starter] SAFETY: PORT=5173 ist der Produktiv-Port — abgebrochen.')
}
if (sqliteFilename === 'assignment-monitor.sqlite3') {
throw new Error('[starter] SAFETY: Produktiv-DB-Dateiname blockiert.')
}
if (sqliteFilename.includes('/') || sqliteFilename.includes('\\') || sqliteFilename.includes('..')) {
throw new Error(`[starter] SAFETY: SQLITE_FILENAME ungültig: "${sqliteFilename}"`)
}
}
function sanitizeStructureRow(tableName: string, row: Record<string, unknown>): Record<string, unknown> {
const copy = { ...row }
// Destillierte Muster stammen aus echten Protokollen — nicht mitverteilen.
if (tableName === 'feedbackCriterionItems' && 'learnedPatternHints' in copy) {
copy.learnedPatternHints = null
}
return copy
}
/** Liest Struktur aus der aktuellen V2-Dev-DB (leere Laufzeit-Tabellen im Payload). */
export function buildStarterPackageFromDb(): StarterPackage {
assertStarterEnv()
assertV2DevOnly(PROJECT_ROOT, 'starter:export')
const tables: Record<string, Array<Record<string, unknown>>> = {}
for (const name of TABLE_NAMES) {
if (STRUCTURE_SET.has(name)) {
tables[name] = getAllRows<Record<string, unknown>>(name).map(r => sanitizeStructureRow(name, r))
} else {
tables[name] = []
}
}
return {
kind: 'assignment-monitor-starter',
version: 1,
exportedAt: new Date().toISOString(),
note: 'Nur Struktur/Config — keine Personen, Assignments oder Meetings. Nur für AssignmentMonitorV2.',
tables,
}
}
export function writeStarterPackage(pkg: StarterPackage, targetPath = STARTER_FILE): string {
assertV2DevOnly(targetPath, 'starter:export')
mkdirSync(dirname(targetPath), { recursive: true })
writeFileSync(targetPath, JSON.stringify(pkg, null, 2), 'utf8')
return targetPath
}
export function readStarterPackage(sourcePath = STARTER_FILE): StarterPackage {
assertV2DevOnly(sourcePath, 'starter:import')
if (!existsSync(sourcePath)) {
throw new Error(`[starter] Datei fehlt: ${sourcePath}`)
}
const raw = JSON.parse(readFileSync(sourcePath, 'utf8')) as StarterPackage
if (raw.kind !== 'assignment-monitor-starter' || raw.version !== 1 || !raw.tables) {
throw new Error('[starter] Ungültiges Starter-Paket (kind/version/tables).')
}
return raw
}
/**
* Ersetzt den kompletten DB-Inhalt durch das Starter-Paket (Struktur befüllt, Rest leer).
* Absichtlich voller Wipe — für frische Team-Installationen.
*/
export function importStarterPackage(pkg: StarterPackage): { structureRows: number } {
assertStarterEnv()
assertV2DevOnly(PROJECT_ROOT, 'starter:import')
let structureRows = 0
db.exec('BEGIN')
try {
for (const table of TABLE_DEFINITIONS) {
db.prepare(`DELETE FROM "${table.name}"`).run()
}
for (const table of TABLE_DEFINITIONS) {
const rows = pkg.tables[table.name] ?? []
for (const row of rows) {
const { id, ...rest } = row
if (typeof id !== 'number') continue
insertRowWithId(table.name, id, sanitizeStructureRow(table.name, rest))
if (STRUCTURE_SET.has(table.name)) structureRows++
}
}
db.exec('COMMIT')
} catch (err) {
db.exec('ROLLBACK')
throw err
}
return { structureRows }
}
export function summarizeStarter(pkg: StarterPackage): Record<string, number> {
const counts: Record<string, number> = {}
for (const name of STARTER_STRUCTURE_TABLES) {
counts[name] = pkg.tables[name]?.length ?? 0
}
return counts
}
+217
View File
@@ -0,0 +1,217 @@
/**
* Einzige Quelle der Wahrheit für alle SQL-Tabellen — treibt sowohl die Schema-Erstellung
* (database.ts) als auch Export/Import (queries/backup.ts) an. Eine neue Tabelle, die hier
* fehlt, fehlt dadurch gleichzeitig im Schema UND im Backup — sichtbarer Fehler statt eines
* Datenverlusts, der erst beim nächsten Restore aus dem Backup auffällt (siehe CLAUDE.md:
* appSettings fehlte einmal in TABLE_NAMES).
*
* 1:1 abgeleitet aus TABLE_NAMES (src/utils/dbBackup.ts) und den Interfaces in src/db/types.ts.
*/
export type ColumnCodec = 'json' | 'bool' | 'plain'
export interface ColumnDef {
name: string
sqlType: 'INTEGER' | 'TEXT' | 'REAL'
codec: ColumnCodec
}
export interface TableDef {
name: string
columns: ColumnDef[]
}
const col = (name: string, sqlType: ColumnDef['sqlType'], codec: ColumnCodec = 'plain'): ColumnDef =>
({ name, sqlType, codec })
export const TABLE_DEFINITIONS: TableDef[] = [
{ name: 'categories', columns: [
col('name', 'TEXT'),
col('order', 'INTEGER'),
]},
{ name: 'criteria', columns: [
col('categoryId', 'INTEGER'),
col('name', 'TEXT'),
col('description', 'TEXT'),
col('weight', 'REAL'),
col('order', 'INTEGER'),
]},
{ name: 'assignmentTypes', columns: [
col('name', 'TEXT'),
col('defaultPhaseKeys', 'TEXT', 'json'),
col('criteriaIds', 'TEXT', 'json'),
col('color', 'TEXT'),
]},
{ name: 'phaseTemplates', columns: [
col('assignmentTypeId', 'INTEGER'),
col('phaseKey', 'TEXT'),
col('label', 'TEXT'),
col('withWhom', 'TEXT'),
col('isRepeatable', 'INTEGER', 'bool'),
col('hasConversation', 'INTEGER', 'bool'),
col('hasAssessment', 'INTEGER', 'bool'),
col('hasChecklist', 'INTEGER', 'bool'),
col('criteriaIds', 'TEXT', 'json'),
col('order', 'INTEGER'),
]},
{ name: 'groups', columns: [
col('name', 'TEXT'),
col('cohortYear', 'INTEGER'),
]},
{ name: 'consultants', columns: [
col('groupId', 'INTEGER'),
col('firstName', 'TEXT'),
col('lastName', 'TEXT'),
col('email', 'TEXT'),
col('archivedAt', 'TEXT'),
]},
{ name: 'assignments', columns: [
col('title', 'TEXT'),
col('client', 'TEXT'),
col('assignmentTypeId', 'INTEGER'),
col('instituteeIds', 'TEXT', 'json'),
col('leadName', 'TEXT'),
col('status', 'TEXT'),
col('createdAt', 'TEXT'),
col('assignmentNumber', 'TEXT'),
col('description', 'TEXT'),
col('instituteeEnrollments', 'TEXT', 'json'),
col('deletedAt', 'TEXT'),
col('archivedAt', 'TEXT'),
col('plannedStart', 'TEXT'),
col('plannedEnd', 'TEXT'),
]},
{ name: 'meetingInstances', columns: [
col('assignmentId', 'INTEGER'),
col('phaseTemplateId', 'INTEGER'),
col('phaseIndex', 'INTEGER'),
col('date', 'TEXT'),
col('status', 'TEXT'),
col('generalNotes', 'TEXT'),
col('deletedAt', 'TEXT'),
col('generalNoteTags', 'TEXT', 'json'),
]},
{ name: 'conversationEntries', columns: [
col('meetingInstanceId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('sequenceIndex', 'INTEGER'),
col('note', 'TEXT'),
col('fillerCount', 'INTEGER'),
col('updatedAt', 'TEXT'),
col('lineTags', 'TEXT', 'json'),
]},
{ name: 'conversationSkillScores', columns: [
col('conversationEntryId', 'INTEGER'),
col('criteriaId', 'INTEGER'),
col('score', 'INTEGER'),
]},
{ name: 'assessments', columns: [
col('meetingInstanceId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('criteriaId', 'INTEGER'),
col('score', 'INTEGER'),
col('note', 'TEXT'),
col('updatedAt', 'TEXT'),
col('scoreNeedsReview', 'INTEGER', 'bool'),
]},
{ name: 'meetingCategoryRatings', columns: [
col('meetingInstanceId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('categoryId', 'INTEGER'),
col('score', 'INTEGER'),
col('note', 'TEXT'),
]},
{ name: 'feedbackDrafts', columns: [
col('assignmentId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('content', 'TEXT'),
col('updatedAt', 'TEXT'),
]},
{ name: 'feedbackDimensions', columns: [
col('name', 'TEXT'),
col('order', 'INTEGER'),
]},
{ name: 'feedbackCategories', columns: [
col('dimensionId', 'INTEGER'),
col('name', 'TEXT'),
col('order', 'INTEGER'),
col('description', 'TEXT'),
]},
{ name: 'feedbackCriterionItems', columns: [
col('categoryId', 'INTEGER'),
col('name', 'TEXT'),
col('weight', 'REAL'),
col('order', 'INTEGER'),
col('description', 'TEXT'),
col('learnedPatternHints', 'TEXT'),
]},
{ name: 'assignmentFeedbacks', columns: [
col('assignmentId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('status', 'TEXT'),
col('aiModel', 'TEXT'),
col('updatedAt', 'TEXT'),
]},
{ name: 'feedbackCategoryRatings', columns: [
col('assignmentFeedbackId', 'INTEGER'),
col('feedbackCategoryId', 'INTEGER'),
col('rating', 'INTEGER'),
]},
{ name: 'feedbackDimensionTexts', columns: [
col('assignmentFeedbackId', 'INTEGER'),
col('feedbackDimensionId', 'INTEGER'),
col('achievements', 'TEXT'),
col('developmentNeeds', 'TEXT'),
col('suggestedAchievements', 'TEXT'),
col('suggestedDevelopmentNeeds', 'TEXT'),
]},
{ name: 'feedbackDimensionPrompts', columns: [
col('dimensionId', 'INTEGER'),
col('promptTemplate', 'TEXT'),
]},
{ name: 'feedbackCategoryTexts', columns: [
col('assignmentFeedbackId', 'INTEGER'),
col('feedbackCategoryId', 'INTEGER'),
col('benefits', 'TEXT'),
col('concerns', 'TEXT'),
col('suggestedBenefits', 'TEXT'),
col('suggestedConcerns', 'TEXT'),
]},
{ name: 'criterionCategoryMappings', columns: [
col('criterionId', 'INTEGER'),
col('feedbackCategoryId', 'INTEGER'),
]},
{ name: 'criterionLevelDescriptions', columns: [
col('criterionItemId', 'INTEGER'),
col('rating', 'INTEGER'),
col('text', 'TEXT'),
]},
{ name: 'appSettings', columns: [
col('ratingTrendWeightStep', 'REAL'),
col('defaultDimensionPromptTemplate', 'TEXT'),
col('defaultCategoryPromptTemplate', 'TEXT'),
col('criterionTaggingPromptTemplate', 'TEXT'),
col('checklistTaggingPromptTemplate', 'TEXT'),
col('ratingColorBands', 'TEXT', 'json'),
col('requirePlannedDates', 'INTEGER', 'bool'),
]},
{ name: 'checklistItemDefs', columns: [
col('phaseTemplateId', 'INTEGER'),
col('label', 'TEXT'),
col('linkedCriterionItemId', 'INTEGER'),
col('scope', 'TEXT'),
col('order', 'INTEGER'),
col('scoreContribution', 'TEXT'),
]},
{ name: 'checklistResponses', columns: [
col('meetingInstanceId', 'INTEGER'),
col('instituteeId', 'INTEGER'),
col('checklistItemId', 'INTEGER'),
col('rating', 'INTEGER'),
col('note', 'TEXT'),
col('criterionItemId', 'INTEGER'),
col('criterionOverride', 'INTEGER', 'bool'),
]},
]
export const TABLE_NAMES = TABLE_DEFINITIONS.map(t => t.name)
+70
View File
@@ -0,0 +1,70 @@
import express from 'express'
import { existsSync } from 'node:fs'
import './database'
import { getAllRows } from './db/crud'
import { rpcModules } from './rpcModules'
import {
STARTER_FILE,
readStarterPackage,
importStarterPackage,
summarizeStarter,
} from './db/starterPackage'
const app = express()
app.use(express.json({ limit: '50mb' })) // Backup-Import kann alle Tabellen als ein JSON-Body enthalten
app.post('/api/rpc', (req, res) => {
const { module, fn, args } = req.body as { module?: string; fn?: string; args?: unknown[] }
const mod = module ? rpcModules[module] : undefined
const handler = fn ? mod?.[fn] : undefined
if (!mod || typeof handler !== 'function') {
res.json({ ok: false, error: `Unbekannte RPC-Zielfunktion: ${module}.${fn}` })
return
}
try {
const result = handler(...(args ?? []))
res.json({ ok: true, result: result ?? null })
} catch (err) {
res.json({ ok: false, error: err instanceof Error ? err.message : 'Unbekannter Server-Fehler' })
}
})
/** V2-Default 4001 — Produktiv bleibt auf 4000. */
const port = process.env.API_PORT ? Number(process.env.API_PORT) : 4001
if (!Number.isFinite(port) || port === 4000) {
throw new Error(
`[server] SAFETY: API_PORT=${process.env.API_PORT ?? '(unset)'} ist ungültig oder kollidiert mit Produktiv-Port 4000. ` +
`V2 erwartet z.B. 4001 (siehe .env).`,
)
}
/** Team-ZIP: leere DB automatisch mit Struktur befüllen (keine Meetings/Personen). */
function seedStarterIfEmpty(): void {
const dims = getAllRows('feedbackDimensions')
if (dims.length > 0) return
if (!existsSync(STARTER_FILE)) {
console.warn('[server] DB ohne Feedback-Struktur und ohne Starter-Paket — Config bleibt leer.')
return
}
try {
const pkg = readStarterPackage()
const { structureRows } = importStarterPackage(pkg)
const counts = summarizeStarter(pkg)
console.log(`[server] Starter-Struktur automatisch geladen (${structureRows} Zeilen).`)
console.log(
`[server] Dimensionen=${counts.feedbackDimensions} Kategorien=${counts.feedbackCategories} ` +
`Kriterien=${counts.feedbackCriterionItems} Typen=${counts.assignmentTypes}`,
)
} catch (err) {
console.warn('[server] Auto-Seed fehlgeschlagen:', err instanceof Error ? err.message : err)
}
}
seedStarterIfEmpty()
app.listen(port, () => {
console.log(`[server] DEV-RPC-API (AssignmentMonitorV2) auf http://localhost:${port}/api/rpc`)
console.log(`[server] Produktiv (AssigmentMonitor) nutzt Port 4000 — diese Instanz ist davon getrennt.`)
})
+41
View File
@@ -0,0 +1,41 @@
import * as appSettings from './db/queries/appSettings'
import * as consultants from './db/queries/consultants'
import * as assignmentTypes from './db/queries/assignmentTypes'
import * as assignments from './db/queries/assignments'
import * as feedbackStructure from './db/queries/feedbackStructure'
import * as criterionSuggestions from './db/queries/criterionSuggestions'
import * as checklists from './db/queries/checklists'
import * as meetings from './db/queries/meetings'
import * as conversationEntries from './db/queries/conversationEntries'
import * as assessments from './db/queries/assessments'
import * as assignmentFeedback from './db/queries/assignmentFeedback'
import * as meetingCategoryRatings from './db/queries/meetingCategoryRatings'
import * as backup from './db/queries/backup'
import * as assignmentTransfer from './db/queries/assignmentTransfer'
const modules = {
appSettings,
consultants,
assignmentTypes,
assignments,
feedbackStructure,
criterionSuggestions,
checklists,
meetings,
conversationEntries,
assessments,
assignmentFeedback,
meetingCategoryRatings,
backup,
assignmentTransfer,
}
export type RpcModuleName = keyof typeof modules
/**
* Modul-/Funktionsname kommen zur Laufzeit aus dem HTTP-Body, nicht aus statisch bekannten
* Aufrufstellen — `any[]` ist hier eine bewusste, eng begrenzte Typgrenze für den dynamischen
* Dispatch in index.ts (wie bei Express' req.body), nicht nachlässige Typisierung.
*/
// eslint-disable-next-line @typescript-eslint/no-explicit-any
export const rpcModules = modules as Record<string, Record<string, (...args: any[]) => unknown> | undefined>
+34
View File
@@ -0,0 +1,34 @@
/**
* Spielt docs/starter/starter-structure.json in die V2-Dev-DB ein (voller Wipe).
* Usage: npm run bootstrap -- --yes
* Ohne --yes / CONFIRM=1: Abbruch (Schutz vor versehentlichem Löschen).
* Produktiv-Ports/DB-Namen werden blockiert.
*/
const args = new Set(process.argv.slice(2))
const confirmed = args.has('--yes') || args.has('-y') || process.env.CONFIRM === '1'
if (!confirmed) {
console.error('[bootstrap] Abbruch: würde die V2-Dev-DB komplett ersetzen.')
console.error('[bootstrap] Zum Bestätigen: npm run bootstrap -- --yes')
console.error('[bootstrap] Quelle: docs/starter/starter-structure.json')
process.exit(1)
}
const {
readStarterPackage,
importStarterPackage,
summarizeStarter,
STARTER_FILE,
} = await import('../db/starterPackage')
const pkg = readStarterPackage()
const counts = summarizeStarter(pkg)
const { structureRows } = importStarterPackage(pkg)
console.log(`[bootstrap] Starter eingespielt (${structureRows} Struktur-Zeilen).`)
console.log(`[bootstrap] Quelle: ${STARTER_FILE} (${pkg.exportedAt})`)
for (const [table, n] of Object.entries(counts)) {
if (n > 0) console.log(` ${table}: ${n}`)
}
console.log('[bootstrap] Keine Personen-/Meeting-Daten. API-Key lokal unter Config → KI setzen.')
console.log('[bootstrap] Start: npm run dev:all → http://localhost:5174')
+22
View File
@@ -0,0 +1,22 @@
/**
* Exportiert Struktur/Config aus der V2-Dev-DB nach docs/starter/starter-structure.json.
* Usage: npm run starter:export
* Produktiv wird per Guard blockiert.
*/
import {
buildStarterPackageFromDb,
writeStarterPackage,
summarizeStarter,
STARTER_FILE,
} from '../db/starterPackage'
const pkg = buildStarterPackageFromDb()
const path = writeStarterPackage(pkg)
const counts = summarizeStarter(pkg)
console.log(`[starter:export] geschrieben: ${path}`)
console.log(`[starter:export] Stand: ${pkg.exportedAt}`)
for (const [table, n] of Object.entries(counts)) {
if (n > 0) console.log(` ${table}: ${n}`)
}
console.log(`[starter:export] Ziel: ${STARTER_FILE}`)
+158
View File
@@ -0,0 +1,158 @@
/**
* Laptop-Umzug: Code + komplette V2-Dev-SQLite (ohne node_modules, .env).
* Enthält personenbezogene Daten — nur an sich selbst / den Ziel-Laptop schicken.
*
* Usage: npm run pack:laptop
*/
import { mkdirSync, existsSync, rmSync, readFileSync, copyFileSync, writeFileSync } from 'node:fs'
import { dirname, join, resolve, relative } from 'node:path'
import { fileURLToPath } from 'node:url'
import { execFileSync } from 'node:child_process'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '../..'))
const outDir = join(projectRoot, 'dist-release')
const stamp = new Date().toISOString().slice(0, 10)
const zipName = `AssignmentMonitor-Umzug-${stamp}.zip`
const zipPath = join(outDir, zipName)
const stageName = 'AssigmentMonitorV2'
const stageRoot = join(outDir, '_stage-laptop', stageName)
const rootNorm = projectRoot.toLowerCase()
if (!rootNorm.includes('assigmentmonitorv2')) {
throw new Error('[pack:laptop] SAFETY: Skript nur innerhalb AssigmentMonitorV2 ausführen.')
}
const sqliteFilename = process.env.SQLITE_FILENAME?.trim() || 'assignment-monitor-v2-dev.sqlite3'
if (sqliteFilename.includes('/') || sqliteFilename.includes('\\') || sqliteFilename.includes('..')) {
throw new Error(`[pack:laptop] SAFETY: SQLITE_FILENAME ungültig: "${sqliteFilename}"`)
}
if (sqliteFilename === 'assignment-monitor.sqlite3') {
throw new Error('[pack:laptop] SAFETY: Produktiv-DB-Dateiname blockiert.')
}
const dbPath = join(projectRoot, 'server', 'data', sqliteFilename)
const EXCLUDE_DIR_NAMES = new Set([
'node_modules',
'dist',
'dist-release',
'dist-ssr',
'.vite',
'.claude',
'.vscode',
'_quarantine',
'_stage',
'_stage-laptop',
])
const EXCLUDE_FILE_NAMES = new Set([
'.env',
'.env.local',
'dist-release-log.txt',
])
function shouldSkip(absPath: string): boolean {
const rel = relative(projectRoot, absPath).split(/[/\\]/).join('/')
if (!rel || rel.startsWith('..')) return true
if (rel === 'server/data' || rel.startsWith('server/data/')) return true
if (rel === 'dist-release' || rel.startsWith('dist-release/')) return true
const parts = rel.split('/')
if (parts.some(p => EXCLUDE_DIR_NAMES.has(p) || p.startsWith('_quarantine'))) return true
const base = parts[parts.length - 1] ?? ''
if (EXCLUDE_FILE_NAMES.has(base)) return true
if (base.endsWith('.tsbuildinfo')) return true
if (base.startsWith('.env.') && base.endsWith('.local')) return true
if (base.endsWith('.bak')) return true
return false
}
async function copyTree(srcDir: string, destDir: string): Promise<number> {
const { readdirSync, statSync, mkdirSync: mkdir, copyFileSync: cp } = await import('node:fs')
let count = 0
mkdir(destDir, { recursive: true })
for (const name of readdirSync(srcDir)) {
const src = join(srcDir, name)
if (shouldSkip(src)) continue
const dest = join(destDir, name)
const st = statSync(src)
if (st.isDirectory()) {
count += await copyTree(src, dest)
} else if (st.isFile()) {
cp(src, dest)
count++
}
}
return count
}
function zipWithPowerShell(sourceFolder: string, targetZip: string): void {
const parent = dirname(sourceFolder)
const leaf = sourceFolder.split(/[/\\]/).pop()
const ps = `
$ErrorActionPreference = 'Stop'
if (Test-Path -LiteralPath '${targetZip.replace(/'/g, "''")}') { Remove-Item -LiteralPath '${targetZip.replace(/'/g, "''")}' -Force }
Compress-Archive -Path (Join-Path '${parent.replace(/'/g, "''")}' '${leaf}') -DestinationPath '${targetZip.replace(/'/g, "''")}' -CompressionLevel Optimal
`
execFileSync('powershell.exe', ['-NoProfile', '-Command', ps], { stdio: 'inherit' })
}
if (!existsSync(dbPath)) {
throw new Error(
`[pack:laptop] Datenbank fehlt: ${dbPath}\n` +
'Ohne SQLite wäre das nur ein Team-Paket — zuerst die App einmal starten oder pack:zip nutzen.',
)
}
mkdirSync(outDir, { recursive: true })
const stageParent = join(outDir, '_stage-laptop')
if (existsSync(stageParent)) rmSync(stageParent, { recursive: true, force: true })
mkdirSync(stageRoot, { recursive: true })
console.log('[pack:laptop] Kopiere Projektdateien (ohne node_modules, .env; inkl. .git) …')
const files = await copyTree(projectRoot, stageRoot)
console.log(`[pack:laptop] ${files} Dateien → Staging`)
const stageDataDir = join(stageRoot, 'server', 'data')
mkdirSync(stageDataDir, { recursive: true })
copyFileSync(dbPath, join(stageDataDir, sqliteFilename))
let extraDbFiles = 0
for (const suffix of ['-wal', '-shm']) {
const extra = `${dbPath}${suffix}`
if (existsSync(extra)) {
copyFileSync(extra, join(stageDataDir, `${sqliteFilename}${suffix}`))
extraDbFiles++
}
}
writeFileSync(
join(stageDataDir, 'README.txt'),
[
'Diese SQLite-Datei ist die vollständige lokale Datenbank (Personen, Assignments, Meetings).',
`Datei: ${sqliteFilename}`,
'Nach dem Entpacken NICHT npm run setup / bootstrap / db:reset ausführen.',
'',
].join('\n'),
'utf8',
)
console.log(`[pack:laptop] DB kopiert: ${sqliteFilename}${extraDbFiles ? ` (+${extraDbFiles} WAL/SHM)` : ''}`)
if (!existsSync(join(stageRoot, 'UMZUG.md'))) {
throw new Error('[pack:laptop] UMZUG.md fehlt im Staging — Abbruch.')
}
if (!existsSync(join(stageRoot, '.env.example'))) {
throw new Error('[pack:laptop] .env.example fehlt')
}
if (!existsSync(join(stageRoot, 'server', 'data', sqliteFilename))) {
throw new Error('[pack:laptop] DB landete nicht im Staging — Abbruch.')
}
console.log(`[pack:laptop] Erzeuge ${zipName} …`)
zipWithPowerShell(stageRoot, zipPath)
rmSync(stageParent, { recursive: true, force: true })
const sizeMb = (readFileSync(zipPath).byteLength / (1024 * 1024)).toFixed(2)
console.log(`[pack:laptop] Fertig: ${zipPath}`)
console.log(`[pack:laptop] Größe: ${sizeMb} MB (E-Mail-tauglich, solange unter dem Postfach-Limit)`)
console.log('[pack:laptop] Enthält personenbezogene Daten — nur an den Ziel-Laptop schicken.')
console.log('[pack:laptop] Am Ziel: UMZUG.md folgen. Nicht npm run setup.')
console.log('[pack:laptop] Produktiv (AssigmentMonitor) wurde nicht angefasst.')
+120
View File
@@ -0,0 +1,120 @@
/**
* Erzeugt ein versandfertiges ZIP der V2-Team-Version (ohne node_modules, .env, Dev-DB, .git).
* Schreibt nach dist-release/ — Ordner ist gitignored; Produktiv wird nicht angefasst.
*
* Usage: npm run pack:zip
*/
import { mkdirSync, existsSync, rmSync, readFileSync } from 'node:fs'
import { dirname, join, resolve, relative } from 'node:path'
import { fileURLToPath } from 'node:url'
import { execFileSync } from 'node:child_process'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '../..'))
const outDir = join(projectRoot, 'dist-release')
const stamp = new Date().toISOString().slice(0, 10)
const zipName = `AssignmentMonitor-Team-${stamp}.zip`
const zipPath = join(outDir, zipName)
const stageName = 'AssigmentMonitorV2'
const stageRoot = join(outDir, '_stage', stageName)
const rootNorm = projectRoot.toLowerCase()
if (!rootNorm.includes('assigmentmonitorv2')) {
throw new Error('[pack:zip] SAFETY: Skript nur innerhalb AssigmentMonitorV2 ausführen.')
}
const EXCLUDE_DIR_NAMES = new Set([
'node_modules',
'.git',
'dist',
'dist-release',
'dist-ssr',
'.vite',
'.claude',
'.vscode',
'server\\data',
'server/data',
'_quarantine',
'_stage',
])
const EXCLUDE_FILE_NAMES = new Set([
'.env',
'.env.local',
'dist-release-log.txt',
])
function shouldSkip(absPath: string): boolean {
const rel = relative(projectRoot, absPath).split(/[/\\]/).join('/')
if (!rel || rel.startsWith('..')) return true
if (rel === 'server/data' || rel.startsWith('server/data/')) return true
if (rel === 'dist-release' || rel.startsWith('dist-release/')) return true
const parts = rel.split('/')
if (parts.some(p => EXCLUDE_DIR_NAMES.has(p) || p.startsWith('_quarantine'))) return true
const base = parts[parts.length - 1] ?? ''
if (EXCLUDE_FILE_NAMES.has(base)) return true
if (base.endsWith('.tsbuildinfo')) return true
if (base.startsWith('.env.') && base.endsWith('.local')) return true
return false
}
async function copyTree(srcDir: string, destDir: string): Promise<number> {
const { readdirSync, statSync, mkdirSync: mkdir, copyFileSync: cp } = await import('node:fs')
let count = 0
mkdir(destDir, { recursive: true })
for (const name of readdirSync(srcDir)) {
const src = join(srcDir, name)
if (shouldSkip(src)) continue
const dest = join(destDir, name)
const st = statSync(src)
if (st.isDirectory()) {
count += await copyTree(src, dest)
} else if (st.isFile()) {
cp(src, dest)
count++
}
}
return count
}
function zipWithPowerShell(sourceFolder: string, targetZip: string): void {
// Compress-Archive braucht den Inhalt so, dass der Root-Ordner im ZIP liegt
const parent = dirname(sourceFolder)
const leaf = sourceFolder.split(/[/\\]/).pop()
const ps = `
$ErrorActionPreference = 'Stop'
if (Test-Path -LiteralPath '${targetZip.replace(/'/g, "''")}') { Remove-Item -LiteralPath '${targetZip.replace(/'/g, "''")}' -Force }
Compress-Archive -Path (Join-Path '${parent.replace(/'/g, "''")}' '${leaf}') -DestinationPath '${targetZip.replace(/'/g, "''")}' -CompressionLevel Optimal
`
execFileSync('powershell.exe', ['-NoProfile', '-Command', ps], { stdio: 'inherit' })
}
mkdirSync(outDir, { recursive: true })
const stageParent = join(outDir, '_stage')
if (existsSync(stageParent)) rmSync(stageParent, { recursive: true, force: true })
mkdirSync(stageRoot, { recursive: true })
console.log('[pack:zip] Kopiere Projektdateien (ohne DB, .env, node_modules, .git) …')
const files = await copyTree(projectRoot, stageRoot)
console.log(`[pack:zip] ${files} Dateien → Staging`)
// Sicherstellen, dass Einrichtungsdateien im Root der ZIP liegen
if (!existsSync(join(stageRoot, 'EINRICHTUNG.md'))) {
throw new Error('[pack:zip] EINRICHTUNG.md fehlt im Staging — Abbruch.')
}
if (!existsSync(join(stageRoot, 'docs', 'starter', 'starter-structure.json'))) {
throw new Error('[pack:zip] starter-structure.json fehlt — zuerst npm run starter:export')
}
if (!existsSync(join(stageRoot, '.env.example'))) {
throw new Error('[pack:zip] .env.example fehlt')
}
console.log(`[pack:zip] Erzeuge ${zipName} …`)
zipWithPowerShell(stageRoot, zipPath)
rmSync(stageParent, { recursive: true, force: true })
const sizeMb = (readFileSync(zipPath).byteLength / (1024 * 1024)).toFixed(2)
console.log(`[pack:zip] Fertig: ${zipPath}`)
console.log(`[pack:zip] Größe: ${sizeMb} MB`)
console.log('[pack:zip] An Kollegen: ZIP schicken + auf EINRICHTUNG.md verweisen.')
console.log('[pack:zip] Produktiv (AssigmentMonitor) wurde nicht angefasst.')
@@ -0,0 +1,13 @@
/**
* CLI: finale Feedback-Struktur aus docs/preload in die Dev-SQLite laden.
* Usage: npm run preload:feedback-structure
*/
import '../database'
import { preloadFinalFeedbackStructure } from '../db/queries/feedbackStructure'
const result = preloadFinalFeedbackStructure()
console.log(
`[preload] Feedback-Struktur geladen: ${result.dimensions} Dimensionen, `
+ `${result.categories} Kategorien, ${result.items} Kriterien `
+ `(ersetzt ${result.clearedDimensions} bestehende Dimensionen)`,
)
+42
View File
@@ -0,0 +1,42 @@
/**
* Setzt NUR die V2-Dev-Datenbank zurück (löscht die Datei unter server/data/).
* Produktiv (c:\dev\AssigmentMonitor) wird nicht angefasst — gleiche Pfad-Guards wie database.ts.
*
* Usage: npm run db:reset
*/
import { existsSync, unlinkSync } from 'node:fs'
import { dirname, join, resolve, sep } from 'node:path'
import { fileURLToPath } from 'node:url'
const __dirname = dirname(fileURLToPath(import.meta.url))
const projectRoot = resolve(join(__dirname, '../..'))
const sqliteFilename = process.env.SQLITE_FILENAME?.trim() || 'assignment-monitor-v2-dev.sqlite3'
if (sqliteFilename.includes('/') || sqliteFilename.includes('\\') || sqliteFilename.includes('..')) {
throw new Error(`[db:reset] SAFETY: SQLITE_FILENAME ungültig: "${sqliteFilename}"`)
}
const dbPath = resolve(join(__dirname, '..', 'data', sqliteFilename))
const dbNorm = dbPath.toLowerCase()
const rootNorm = projectRoot.toLowerCase()
const rootPrefix = rootNorm.endsWith(sep) ? rootNorm : rootNorm + sep
if (!dbNorm.startsWith(rootPrefix)) {
throw new Error(`[db:reset] SAFETY: Pfad außerhalb V2: ${dbPath}`)
}
if (
/[/\\]assigmentmonitor[/\\]server[/\\]data[/\\]/.test(dbNorm) &&
!/[/\\]assigmentmonitorv2[/\\]/.test(dbNorm)
) {
throw new Error(`[db:reset] SAFETY: Produktiv-DB blockiert: ${dbPath}`)
}
if (!existsSync(dbPath)) {
console.log(`[db:reset] Keine Datei vorhanden — nichts zu löschen:\n ${dbPath}`)
console.log(`[db:reset] Beim nächsten Server-Start wird eine leere DB angelegt.`)
process.exit(0)
}
unlinkSync(dbPath)
console.log(`[db:reset] Dev-DB gelöscht:\n ${dbPath}`)
console.log(`[db:reset] Beim nächsten \`npm run server\` / \`npm run dev:all\` wird eine frische DB erzeugt.`)
+124
View File
@@ -0,0 +1,124 @@
/**
* Automatisierter Smoke für C0 (Skala/Farbbänder) + C6/C7-Hilfslogik (Batches, Prompt-Größe).
* Schreibt temporär Farbbänder in die V2-Dev-DB und stellt den vorherigen Stand wieder her.
*
* Aufruf: npm run smoke
* Voraussetzung: .env mit V2-Ports/DB (wie npm run setup / server).
*
* Nur server-kompatible Imports (kein DOM/JSX) — siehe tsconfig.server.json.
*/
import '../database'
import {
DEFAULT_RATING_COLOR_BANDS,
BAND_STYLES,
bandForScore,
normalizeRatingColorBands,
normalizeRatingScore,
resolveScoreStyle,
AI_CONFIG,
} from '../../src/config/constants'
import { getOrSeedRatingColorBands, saveRatingColorBands } from '../db/queries/appSettings'
import { buildCharAwareBatches, mergePatternHints } from '../../src/utils/charAwareBatches'
import { checkPromptSize } from '../../src/utils/promptSize'
let failed = 0
let passed = 0
function assert(cond: boolean, label: string, detail?: string) {
if (cond) {
console.log(`✅ ${label}`)
passed++
} else {
console.log(`❌ ${label}${detail ? ` — ${detail}` : ''}`)
failed++
}
}
console.log('=== Smoke: Skala 1–10 (C0) ===\n')
assert(normalizeRatingScore(7) === 7, 'normalizeRatingScore(7) → 7')
assert(normalizeRatingScore(0) === null, 'normalizeRatingScore(0) → null')
assert(normalizeRatingScore(11) === null, 'normalizeRatingScore(11) → null')
assert(normalizeRatingScore('5') === 5, 'normalizeRatingScore("5") → 5')
const bands = normalizeRatingColorBands(DEFAULT_RATING_COLOR_BANDS)
assert(bandForScore(1, bands).key === 'red', 'Score 1 → Band rot')
assert(bandForScore(2, bands).key === 'red', 'Score 2 → Band rot')
assert(bandForScore(3, bands).key === 'orange', 'Score 3 → Band orange')
assert(bandForScore(5, bands).key === 'orange', 'Score 5 → Band orange')
assert(bandForScore(6, bands).key === 'lightGreen', 'Score 6 → Band hellgrün')
assert(bandForScore(8, bands).key === 'lightGreen', 'Score 8 → Band hellgrün')
assert(bandForScore(9, bands).key === 'darkGreen', 'Score 9 → Band dunkelgrün')
assert(bandForScore(10, bands).key === 'darkGreen', 'Score 10 → Band dunkelgrün')
assert(
BAND_STYLES.lightGreen.color !== BAND_STYLES.darkGreen.color,
'Hellgrün und Dunkelgrün haben unterscheidbare CSS-Klassen',
)
assert(
BAND_STYLES.lightGreen.hex !== BAND_STYLES.darkGreen.hex,
'Hellgrün und Dunkelgrün haben unterscheidbare Hex-Farben',
)
const style6 = resolveScoreStyle(6, bands)
const style9 = resolveScoreStyle(9, bands)
assert(style6.color !== style9.color, 'resolveScoreStyle: 6 und 9 unterschiedliche Farben')
const previousBands = getOrSeedRatingColorBands()
const probeBands = [
{ max: 3, key: 'red' as const },
{ max: 6, key: 'orange' as const },
{ max: 8, key: 'lightGreen' as const },
{ max: 10, key: 'darkGreen' as const },
]
saveRatingColorBands(probeBands)
const reloaded = getOrSeedRatingColorBands()
assert(
JSON.stringify(reloaded) === JSON.stringify(normalizeRatingColorBands(probeBands)),
'Farbbänder speichern/laden Roundtrip (DB)',
`got ${JSON.stringify(reloaded)}`,
)
saveRatingColorBands(previousBands)
const restored = getOrSeedRatingColorBands()
assert(
JSON.stringify(restored) === JSON.stringify(normalizeRatingColorBands(previousBands)),
'Vorherige Farbbänder wiederhergestellt',
)
console.log('\n=== Smoke: Tagging-Batches (C6) ===\n')
const manyShort = Array.from({ length: 25 }, (_, i) => `Zeile ${i + 1} kurz`)
const byLines = buildCharAwareBatches(manyShort, s => s, 12, 50_000)
assert(byLines.length === 3, `25 Zeilen / max 12 → 3 Batches (ist ${byLines.length})`)
assert(byLines[0].length === 12 && byLines[1].length === 12 && byLines[2].length === 1, 'Batch-Größen 12+12+1')
const longA = 'a'.repeat(2000)
const longB = 'b'.repeat(2000)
const byChars = buildCharAwareBatches([longA, longB, 'kurz'], s => s, 12, 3500)
assert(byChars.length === 2, `Zeichen-Budget → 2 Batches (ist ${byChars.length})`)
assert(byChars[0].length === 1 && byChars[0][0] === longA, 'Erste lange Zeile allein im Batch')
assert(byChars[1][0] === longB && byChars[1].includes('kurz'), 'Zweite lange Zeile + Kurzzeile im Folgebatch')
const oneHuge = ['x'.repeat(5000)]
const alone = buildCharAwareBatches(oneHuge, s => s, 12, 3500)
assert(alone.length === 1 && alone[0].length === 1, 'Überlanges Einzelstück → 1 Batch mit 1 Zeile')
const patterns = new Map<number, string>()
mergePatternHints(patterns, new Map([[1, 'alt'], [2, 'zwei']]))
mergePatternHints(patterns, new Map([[1, 'neu']]))
assert(patterns.get(1) === 'neu' && patterns.get(2) === 'zwei', 'MUSTER-Merge: später überschreibt früher')
console.log('\n=== Smoke: Prompt-Größe (C7) ===\n')
const small = checkPromptSize('kurz')
assert(!small.softWarn && !small.overHardLimit, 'Kleiner Prompt: kein Soft/Hard')
const soft = checkPromptSize('y'.repeat(AI_CONFIG.promptSoftWarnChars))
assert(soft.softWarn && !soft.overHardLimit, 'Soft-Warn-Schwelle greift')
const hard = checkPromptSize('z'.repeat(AI_CONFIG.promptHardLimitChars))
assert(hard.overHardLimit, 'Hard-Limit-Schwelle greift')
console.log(`\n=== Ergebnis: ${passed} pass, ${failed} fail ===`)
if (failed > 0) process.exit(1)
console.log('\nHinweis: UI-Teile → manuell in docs/SMOKE_TESTS.md')
+18
View File
@@ -0,0 +1,18 @@
/**
* Einmal-Setup für Team-ZIP: Starter-Struktur in die V2-Dev-DB laden.
* Usage: npm run setup
*/
import { existsSync, copyFileSync } from 'node:fs'
import { dirname, join } from 'node:path'
import { fileURLToPath } from 'node:url'
const rootPath = join(dirname(fileURLToPath(import.meta.url)), '../..')
const envPath = join(rootPath, '.env')
const examplePath = join(rootPath, '.env.example')
if (!existsSync(envPath) && existsSync(examplePath)) {
copyFileSync(examplePath, envPath)
console.log('[setup] .env aus .env.example angelegt.')
}
process.env.CONFIRM = '1'
await import('./bootstrapFromStarter')
+66
View File
@@ -0,0 +1,66 @@
/**
* Harter Vollständigkeits-Beweis für Backup-Export/-Import (siehe Plan "Vollständigkeits-Garantie").
* Nimmt eine zuvor exportierte Backup-JSON (egal ob aus der alten Dexie-Version oder aus einem
* früheren exportAll()), importiert sie in die aktuelle SQLite-DB, exportiert sofort wieder und
* vergleicht pro Tabelle Zeilenzahl + Inhalt. ACHTUNG: überschreibt den aktuellen Inhalt der
* lokalen SQLite-Datenbank mit dem Inhalt der Backup-Datei.
*
* Aufruf: npm run verify-backup -- <pfad-zur-backup.json>
*/
import { readFileSync } from 'node:fs'
import '../database'
import { TABLE_DEFINITIONS } from '../db/tableRegistry'
import { exportAll, importAll } from '../db/queries/backup'
const filePath = process.argv[2]
if (!filePath) {
console.error('Nutzung: npm run verify-backup -- <pfad-zur-backup.json>')
process.exit(1)
}
const backup = JSON.parse(readFileSync(filePath, 'utf8')) as { tables?: Record<string, Array<Record<string, unknown>>> }
if (!backup.tables || typeof backup.tables !== 'object') {
console.error('Ungültiges Backup-Format: kein "tables"-Feld gefunden.')
process.exit(1)
}
const sourceTables = backup.tables
console.log(`Importiere ${filePath} in die SQLite-DB ...`)
importAll(sourceTables)
console.log('Exportiere sofort wieder zum Vergleich ...\n')
const reexported = exportAll()
const byId = (rows: Array<Record<string, unknown>>) =>
[...rows].sort((a, b) => (a.id as number) - (b.id as number))
let allPass = true
for (const table of TABLE_DEFINITIONS) {
const name = table.name
const sourceRows = byId(sourceTables[name] ?? [])
const targetRows = byId(reexported.tables[name] ?? [])
if (sourceRows.length !== targetRows.length) {
console.log(`❌ ${name}: FAIL — Zeilenzahl weicht ab (Quelle: ${sourceRows.length}, Reexport: ${targetRows.length})`)
allPass = false
continue
}
const sourceJson = JSON.stringify(sourceRows)
const targetJson = JSON.stringify(targetRows)
if (sourceJson !== targetJson) {
console.log(`❌ ${name}: FAIL — Inhalt weicht ab`)
console.log(` Quelle (Ausschnitt): ${sourceJson.slice(0, 300)}`)
console.log(` Reexport (Ausschnitt): ${targetJson.slice(0, 300)}`)
allPass = false
continue
}
console.log(`✅ ${name}: PASS (${sourceRows.length} Zeile${sourceRows.length === 1 ? '' : 'n'}, identisch)`)
}
console.log(allPass
? '\n✅ Alle 21 Tabellen vollständig und inhaltlich identisch importiert/exportiert.'
: '\n❌ Mindestens eine Tabelle weicht ab — siehe oben.')
process.exit(allPass ? 0 : 1)
+90 -27
View File
@@ -1,55 +1,118 @@
import { Routes, Route, NavLink } from 'react-router-dom'
import { BRAND_COLOR } from './config/constants'
import { useEffect } from 'react'
import { Routes, Route, NavLink, Navigate, useLocation } from 'react-router-dom'
import Dashboard from './pages/Dashboard'
import Configuration from './pages/Configuration'
import Consultants from './pages/Consultants'
import AssignmentCreate from './pages/AssignmentCreate'
import AssignmentDetail from './pages/AssignmentDetail'
import AssignmentEdit from './pages/AssignmentEdit'
import MeetingView from './pages/MeetingView'
import AssignmentTrash from './pages/AssignmentTrash'
import AssignmentArchive from './pages/AssignmentArchive'
import MeetingHistory from './pages/MeetingHistory'
import MeetingView from './pages/meeting/MeetingView'
import FeedbackDraftPage from './pages/FeedbackDraftPage'
import AssignmentFeedbackPage from './pages/AssignmentFeedbackPage'
import Evaluation from './pages/Evaluation'
import ConsultantDetailPage from './pages/ConsultantDetail'
function headerContext(pathname: string): string {
if (pathname.startsWith('/config')) return 'Einstellungen'
if (pathname.startsWith('/consultants')) return 'Personen'
if (pathname.startsWith('/evaluation') || pathname.startsWith('/feedbacks')) return 'Feedbacks'
if (pathname.startsWith('/assignments/trash')) return 'Papierkorb'
if (pathname.startsWith('/assignments/archive')) return 'Archiv'
if (/\/meeting\//.test(pathname)) return 'Meeting'
if (/\/history$/.test(pathname)) return 'Gesamtprotokoll'
if (/\/feedback/.test(pathname)) return 'Feedback'
if (pathname.startsWith('/assignment')) return 'Assignment'
return 'Assignments'
}
const NAV = [
{ to: '/', label: 'Assignments', end: true },
{ to: '/feedbacks', label: 'Feedbacks', end: false },
{ to: '/consultants', label: 'Personen', end: false },
{ to: '/config', label: 'Einstellungen', end: false },
] as const
export default function App() {
const { pathname } = useLocation()
const wideLayout =
pathname === '/' ||
pathname.startsWith('/feedbacks') ||
pathname.startsWith('/evaluation') ||
pathname.startsWith('/consultants') ||
/\/meeting\/|\/history$/.test(pathname)
const context = headerContext(pathname)
useEffect(() => {
document.title = context === 'Assignments'
? 'Assignment Monitor'
: `${context} · Assignment Monitor`
}, [context])
return (
<div className="min-h-screen bg-gray-50 flex flex-col">
<header className="text-white px-4 py-3 flex items-center gap-3 shadow" style={{ backgroundColor: BRAND_COLOR }}>
<span className="font-bold text-lg tracking-tight">Assignment Monitor</span>
<div className="min-h-dvh bg-app flex flex-col font-sans text-ink">
<header className="bg-brand text-white px-4 py-3 flex items-center gap-3 shrink-0 shadow-[var(--shadow-header)]">
<div className="min-w-0 flex-1">
<div className="font-bold text-lg tracking-tight leading-tight truncate">
Assignment Monitor
</div>
<div className="text-xs text-white/80 mt-0.5 truncate">{context}</div>
</div>
</header>
<main className="flex-1 p-4 max-w-2xl mx-auto w-full pb-20">
<main
className={`flex-1 w-full mx-auto px-4 pt-4 pb-24 ${
wideLayout ? 'max-w-6xl' : 'max-w-2xl'
}`}
>
<Routes>
<Route path="/" element={<Dashboard />} />
<Route path="/assignment/new" element={<AssignmentCreate />} />
<Route path="/assignments/trash" element={<AssignmentTrash />} />
<Route path="/assignments/archive" element={<AssignmentArchive />} />
<Route path="/assignment/:id" element={<AssignmentDetail />} />
<Route path="/assignment/:id/edit" element={<AssignmentEdit />} />
<Route path="/assignment/:id/history" element={<MeetingHistory />} />
<Route path="/assignment/:id/meeting/:meetingId" element={<MeetingView />} />
<Route path="/assignment/:id/feedback/:instituteeId" element={<AssignmentFeedbackPage />} />
<Route path="/assignment/:id/feedback-draft/:instituteeId" element={<FeedbackDraftPage />} />
<Route path="/evaluation" element={<Evaluation />} />
<Route path="/feedbacks" element={<Evaluation />} />
<Route path="/evaluation" element={<Navigate to="/feedbacks" replace />} />
<Route path="/consultants" element={<Consultants />} />
<Route path="/consultants/:id" element={<ConsultantDetailPage />} />
<Route path="/config" element={<Configuration />} />
</Routes>
</main>
<nav className="bg-white border-t border-gray-200 flex justify-around py-2 sticky bottom-0">
{[
{ to: '/', label: 'Home' },
{ to: '/consultants', label: 'Berater' },
{ to: '/evaluation', label: 'Auswertung' },
{ to: '/config', label: 'Config' },
].map(({ to, label }) => (
<NavLink
key={to}
to={to}
end
className={({ isActive }) =>
`text-xs px-3 py-1 rounded ${isActive ? 'font-semibold' : 'text-gray-500'}`
}
style={({ isActive }) => isActive ? { color: BRAND_COLOR } : undefined}
>
{label}
</NavLink>
))}
<nav
className="fixed bottom-0 inset-x-0 z-20 bg-surface border-t border-line shadow-[var(--shadow-nav)]"
aria-label="Hauptnavigation"
>
<div className={`mx-auto flex justify-around px-1 pt-1 pb-[max(0.35rem,env(safe-area-inset-bottom))] ${
wideLayout ? 'max-w-6xl' : 'max-w-2xl'
}`}>
{NAV.map(({ to, label, end }) => (
<NavLink
key={to}
to={to}
end={end}
className={({ isActive }) =>
[
'flex-1 min-h-11 max-w-[7.5rem] mx-0.5 flex items-center justify-center',
'rounded-[var(--radius-control)] px-2 text-[11px] sm:text-xs font-medium leading-tight text-center',
'transition-colors',
isActive
? 'bg-brand-soft text-brand font-semibold'
: 'text-ink-muted hover:text-ink hover:bg-app',
].join(' ')
}
>
{label}
</NavLink>
))}
</div>
</nav>
</div>
)
+85
View File
@@ -0,0 +1,85 @@
import {
DEFAULT_RATING_COLOR_BANDS,
RATING_SCORES,
normalizeRatingScore,
resolveScoreStyle,
} from '../config/constants'
import type { RatingColorBand, RatingScore } from '../db/types'
interface ScorePickerProps {
value: RatingScore | null
onChange: (score: RatingScore | null) => void
bands?: RatingColorBand[]
/** 'buttons' = 1–10-Leiste, 'select' = kompaktes Dropdown */
variant?: 'buttons' | 'select'
className?: string
/** Zeigt n/a / Leeren — setzt Score auf null. */
allowClear?: boolean
}
export function ScorePicker({
value,
onChange,
bands = DEFAULT_RATING_COLOR_BANDS,
variant = 'buttons',
className = '',
allowClear = true,
}: ScorePickerProps) {
const normalized = normalizeRatingScore(value)
if (variant === 'select') {
const style = resolveScoreStyle(normalized, bands)
return (
<select
value={normalized ?? ''}
onChange={e => {
const v = e.target.value
onChange(v === '' ? null : Number(v) as RatingScore)
}}
className={`text-xs rounded-lg border px-1 py-1 focus:outline-none flex-shrink-0 tabular-nums ${
normalized !== null ? style.active : style.color
} ${className}`}
>
<option value="">{allowClear ? 'n/a' : '–'}</option>
{RATING_SCORES.map(n => (
<option key={n} value={n}>{n}</option>
))}
</select>
)
}
const clearStyle = resolveScoreStyle(null, bands)
return (
<div className={`flex gap-0.5 ${className}`}>
{allowClear && (
<button
type="button"
title="Nicht bewertet / zurücksetzen"
onClick={() => onChange(null)}
className={`flex-shrink-0 px-1.5 py-1.5 rounded text-xs font-bold border transition ${
normalized === null ? clearStyle.active : clearStyle.color
}`}
>
n/a
</button>
)}
{RATING_SCORES.map(n => {
const style = resolveScoreStyle(n, bands)
const selected = normalized === n
return (
<button
key={n}
type="button"
onClick={() => onChange(n)}
className={`flex-1 min-w-0 py-1.5 rounded text-xs font-bold border transition tabular-nums ${
selected ? style.active : style.color
}`}
>
{n}
</button>
)
})}
</div>
)
}
+261 -19
View File
@@ -1,26 +1,115 @@
import type { FeedbackRating } from '../db'
import type { RatingBandKey, RatingColorBand, RatingScore } from '../db/types'
export const BRAND_COLOR = '#0070AD'
/** Voreinstellungen für AssignmentType.color (Einstellungen → Ass.-Typen). */
export const ASSIGNMENT_TYPE_COLOR_PRESETS = [
'#0070AD',
'#2E7D32',
'#C62828',
'#EF6C00',
'#6A1B9A',
'#00838F',
'#4527A0',
'#546E7A',
] as const
export const DEFAULT_ASSIGNMENT_TYPE_COLOR = ASSIGNMENT_TYPE_COLOR_PRESETS[0]
export const RATING_MIN = 1
export const RATING_MAX = 10
/** Kanonische Scores 1–10 — einzige Quelle für Picker/Selects. */
export const RATING_SCORES: readonly RatingScore[] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
/**
* Kanonische Reihenfolge der Rating-Skala (nicht ändern — DB-Werte sind stabil).
* `color` = Badge/Display-State (inaktiv)
* `active` = ausgewählter Button-State
* Abwärtskompatible Options-Liste (short/label/full = Zahl als Text).
* Farben kommen dynamisch über `resolveScoreStyle` / Farbbänder — `color`/`active` hier nur Fallback.
*/
export const RATING_OPTIONS: ReadonlyArray<{
value: FeedbackRating
value: RatingScore
short: string
label: string
full: string
color: string
active: string
}> = [
{ value: 'na', short: 'N/A', label: 'N/A (0)', color: 'bg-gray-100 text-gray-500 border-gray-300', active: 'bg-gray-400 text-white border-gray-400' },
{ value: 'not_client_ready', short: 'Not', label: 'Not (1)', color: 'bg-red-100 text-red-700 border-red-300', active: 'bg-red-500 text-white border-red-500' },
{ value: 'partially_client_ready', short: 'Partially', label: 'Partially (2)', color: 'bg-orange-100 text-orange-700 border-orange-300', active: 'bg-orange-500 text-white border-orange-500' },
{ value: 'nearly_client_ready', short: 'Nearly', label: 'Nearly (3)', color: 'bg-green-100 text-green-600 border-green-300', active: 'bg-green-400 text-white border-green-400' },
{ value: 'client_ready', short: 'Fully', label: 'Fully (4)', color: 'bg-green-100 text-green-800 border-green-400', active: 'bg-green-700 text-white border-green-700' },
}> = RATING_SCORES.map(n => ({
value: n,
short: String(n),
label: String(n),
full: String(n),
color: 'bg-gray-100 text-gray-600 border-gray-300',
active: 'bg-brand text-white border-brand',
}))
export const BAND_STYLES: Record<RatingBandKey, { color: string; active: string; hex: string }> = {
red: { color: 'bg-red-100 text-red-700 border-red-300', active: 'bg-red-500 text-white border-red-500', hex: '#ef4444' },
orange: { color: 'bg-orange-100 text-orange-700 border-orange-300', active: 'bg-orange-500 text-white border-orange-500', hex: '#f97316' },
// Unselected: light lime vs saturated green — both used bg-green-100 before and looked identical.
lightGreen: { color: 'bg-lime-50 text-lime-700 border-lime-300', active: 'bg-lime-400 text-white border-lime-400', hex: '#a3e635' },
darkGreen: { color: 'bg-green-200 text-green-900 border-green-700', active: 'bg-green-700 text-white border-green-700', hex: '#15803d' },
}
/** Default: 1–2 rot, 3–5 orange, 6–8 hellgrün, 9–10 dunkelgrün (siehe docs/SCALE_1_TO_10.md). */
export const DEFAULT_RATING_COLOR_BANDS: RatingColorBand[] = [
{ max: 2, key: 'red' },
{ max: 5, key: 'orange' },
{ max: 8, key: 'lightGreen' },
{ max: 10, key: 'darkGreen' },
]
export function isValidRatingScore(value: unknown): value is RatingScore {
const n = typeof value === 'number' ? value : typeof value === 'string' && value.trim() !== '' ? Number(value) : NaN
return Number.isInteger(n) && n >= RATING_MIN && n <= RATING_MAX
}
/** Normalisiert DB-/UI-Werte auf 1–10 oder null (SQLite kann INTEGER-Spalten als String liefern). */
export function normalizeRatingScore(value: unknown): RatingScore | null {
if (value === null || value === undefined || value === '') return null
const n = typeof value === 'number' ? value : Number(value)
if (!Number.isInteger(n) || n < RATING_MIN || n > RATING_MAX) return null
return n
}
/** Rundet Mittelwerte auf 1–10; außerhalb / NaN → null. */
export function clampRatingScore(avg: number): RatingScore | null {
if (!Number.isFinite(avg)) return null
const rounded = Math.round(avg)
if (rounded < RATING_MIN || rounded > RATING_MAX) return null
return rounded
}
export function normalizeRatingColorBands(bands: RatingColorBand[] | null | undefined): RatingColorBand[] {
if (!bands?.length) return DEFAULT_RATING_COLOR_BANDS.map(b => ({ ...b }))
const sorted = [...bands].sort((a, b) => a.max - b.max)
if (sorted[sorted.length - 1]?.max !== RATING_MAX) return DEFAULT_RATING_COLOR_BANDS.map(b => ({ ...b }))
return sorted
}
export function bandForScore(score: RatingScore, bands: RatingColorBand[] = DEFAULT_RATING_COLOR_BANDS): RatingColorBand {
const normalized = normalizeRatingColorBands(bands)
return normalized.find(b => score <= b.max) ?? normalized[normalized.length - 1]
}
export function resolveScoreStyle(
score: RatingScore | null | undefined,
bands: RatingColorBand[] = DEFAULT_RATING_COLOR_BANDS,
): { value: RatingScore | null; short: string; color: string; active: string; hex: string } {
const normalized = normalizeRatingScore(score)
if (normalized === null) {
return {
value: null,
short: '–',
color: 'bg-gray-100 text-gray-500 border-gray-300',
active: 'bg-gray-400 text-white border-gray-400',
hex: '#9ca3af',
}
}
const band = bandForScore(normalized, bands)
const style = BAND_STYLES[band.key]
return { value: normalized, short: String(normalized), color: style.color, active: style.active, hex: style.hex }
}
/** Farb-Schemata für Teilnehmer-Badges (Index = Reihenfolge im Assignment). */
export const INST_COLORS = [
{ bg: 'bg-blue-50', border: 'border-blue-300', tag: 'bg-blue-500', text: 'text-blue-700' },
@@ -34,13 +123,166 @@ export const AI_CONFIG = {
localStorageKeyModel: 'ai_model',
defaultModel: 'openai/gpt-4o-mini',
openRouterBaseUrl: 'https://openrouter.ai/api/v1',
/** Timeout pro OpenRouter-Call (inkl. Retry). */
requestTimeoutMs: 90_000,
/** Einmaliger Retry bei transienten Fehlern (Netz/429/5xx). */
retryTransientOnce: true,
retryBackoffMs: 1_500,
/** Soft-Warnung / Hard-Abbruch nach Prompt-Zeichenzahl (roher Prompt-Text). */
promptSoftWarnChars: 24_000,
promptHardLimitChars: 100_000,
/** Tagging-Batches: max. Zeilen und max. Summe Rohtext-Zeichen pro Call. */
taggingBatchMaxLines: 12,
taggingBatchMaxChars: 3_500,
/** Hybrid-Notnagel: Top-K Kriterien per Jaccard, wenn ein Einzelzeilen-Prompt zu groß ist. */
taggingStructureTopK: 15,
/**
* Seit 2026-07-14 nur noch einmaliger Erstbefüllungs-Wert für `appSettings.defaultDimensionPromptTemplate`
* (siehe `getOrSeedDefaultDimensionPromptTemplate()` in server/db/queries/appSettings.ts) — der tatsächlich
* aktive Standard-Prompt lebt danach in der DB und ist im Admin-Tab „KI-Prompts" editierbar, nicht mehr hier.
*/
defaultCategoryPromptTemplate: `Du bist Führungskraft bei Capgemini. Erstelle Feedback-Inhalte für EINE Kategorie auf Basis der Beobachtungsdaten aus Kundenterminen.
BERATER: {{BERATER_NAME}}
ASSIGNMENT: {{ASSIGNMENT_TITEL}} | Kunde: {{ASSIGNMENT_KUNDE}}
DIMENSION: {{DIMENSION_NAME}}
KATEGORIE: {{KATEGORIE_NAME}}
{{KATEGORIE_ERLAEUTERUNG}}
KRITERIEN & BEOBACHTUNGEN (nur diese Kategorie — chronologisch, mit Einzelbelegen):
{{KRITERIEN_SCORES}}
Jedes Kriterium enthält Gesamt-Ø über Meetings sowie Einzelbelege mit Datum, Quelle, Score und Wichtigkeit.
Priorisiere bei der Auswertung: (1) Einträge mit Wichtigkeit „hoch"/„erhöht", (2) neuere Meetings, (3) konkrete Kommentare mit Score.
Nutze den Gesamt-Ø als Orientierung — wähle aus den Belegen die aussagekräftigsten für BENEFITS/CONCERNS.
MANUELLE KATEGORIE-BEWERTUNG: {{KATEGORIE_BEWERTUNG}}
ENTWICKLUNG ÜBER MEETINGS: {{ENTWICKLUNG_VERLAUF}}
{{TREND_VORSCHLAG}}
GETAGGTE PROTOKOLLZEILEN (dieser Kategorie zugeordnet):
{{PROTOKOLL_GETAGGT}}
Schreibe:
- SCORE: 1–10 (Trend-Vorschlag beachten — bestätigen oder maximal ±1 abweichen)
- BENEFITS: 1–3 kurze positive Beobachtungen (Stichpunkte mit "- ")
- CONCERNS: 1–3 kurze kritische Beobachtungen (Stichpunkte mit "- "). Concerns sind Feststellungen, KEINE Handlungsempfehlungen.
Nutze ausschließlich die oben genannten Daten. Reicht die Datenlage nicht: SCORE weglassen, BENEFITS/CONCERNS mit "- n/a".
Antwortformat (Marker in eigener Zeile oder mit Text in derselben Zeile), ohne Markdown-Codefences:
SCORE: <1-10>
BENEFITS:
- <Stichpunkt>
CONCERNS:
- <Stichpunkt>`,
defaultDimensionPromptTemplate: `Du bist Führungskraft bei Capgemini. Verdichte die folgenden Kategorie-Feedbacks zu übergreifenden Dimension-Hauptpunkten — ohne Rohprotokoll, nur auf Basis der Kategorie-Ergebnisse.
BERATER: {{BERATER_NAME}}
ASSIGNMENT: {{ASSIGNMENT_TITEL}} | Kunde: {{ASSIGNMENT_KUNDE}}
DIMENSION: {{DIMENSION_NAME}}
KATEGORIE-ERGEBNISSE:
{{KATEGORIE_ERGEBNISSE}}
Schreibe für die gesamte Dimension:
- ACHIEVEMENTS: genau 3 bis 5 übergreifende Benefits (keine bloße Wiederholung einzelner Kategorien)
- DEVELOPMENT_NEEDS: genau 3 bis 5 übergreifende Concerns als Beobachtungen (keine Empfehlungsformeln wie "Sollte …")
Nutze ausschließlich die Kategorie-Ergebnisse oben. Antwortformat:
ACHIEVEMENTS:
- <Hauptpunkt>
DEVELOPMENT_NEEDS:
- <Beobachtung>`,
categoryPromptPlaceholders: [
{ token: '{{BERATER_NAME}}', description: 'Vor- und Nachname des Institutee' },
{ token: '{{ASSIGNMENT_TITEL}}', description: 'Titel des Assignments' },
{ token: '{{ASSIGNMENT_KUNDE}}', description: 'Kundenname des Assignments' },
{ token: '{{DIMENSION_NAME}}', description: 'Name der übergeordneten Dimension' },
{ token: '{{KATEGORIE_NAME}}', description: 'Name der aktuellen Kategorie' },
{ token: '{{KATEGORIE_ERLAEUTERUNG}}', description: 'Optional: Erläuterung der Kategorie' },
{ token: '{{KRITERIEN_SCORES}}', description: 'Pro Kriterium: Gesamt-Ø + chronologische Einzelbelege (Protokoll, Checkliste, Notizen) mit Datum, Score und Wichtigkeit' },
{ token: '{{KATEGORIE_BEWERTUNG}}', description: 'Manuelle Kategorie-Bewertung (1–10)' },
{ token: '{{ENTWICKLUNG_VERLAUF}}', description: 'Meeting-Verlauf dieser Kategorie' },
{ token: '{{TREND_VORSCHLAG}}', description: 'Vorgeschlagener Score aus Meeting-Trend (±1 Regel)' },
{ token: '{{PROTOKOLL_GETAGGT}}', description: 'Protokollzeilen, die Kriterien dieser Kategorie zugeordnet sind' },
],
dimensionPromptPlaceholders: [
{ token: '{{BERATER_NAME}}', description: 'Vor- und Nachname des Institutee' },
{ token: '{{ASSIGNMENT_TITEL}}', description: 'Titel des Assignments' },
{ token: '{{ASSIGNMENT_KUNDE}}', description: 'Kundenname des Assignments' },
{ token: '{{DIMENSION_NAME}}', description: 'Name der aktuellen Dimension' },
{ token: '{{KATEGORIE_ERGEBNISSE}}', description: 'Scores + Benefits/Concerns aller Kategorien (Stufe A)' },
],
defaultCriterionTaggingPromptTemplate: `Du bist Assistent bei der Auswertung von Kundentermin-Protokollen für Capgemini-Trainees (Institutees). Analysiere die folgenden noch nicht einem Bewertungskriterium zugeordneten Protokollzeilen (Freitext-Beobachtungen) und schlage pro Zeile passende Kriterien vor.
ASSIGNMENT-TYP: {{ASSIGNMENT_TYP}}
VERFÜGBARE KRITERIEN (Dimension → Kategorie → Kriterium, referenziert über die Zahl in eckigen Klammern):
{{KRITERIEN_STRUKTUR}}
BEREITS BEKANNTE, TYPISCHE FORMULIERUNGSMUSTER PRO KRITERIUM (aus früheren Analyse-Läufen, sofern vorhanden):
{{GELERNTE_MUSTER}}
ÄHNLICHE, BEREITS ZUGEORDNETE ALT-ZEILEN (Kontext-Hinweis, keine feste Vorgabe):
{{AEHNLICHE_ALT_ZUORDNUNGEN}}
NOCH NICHT ZUGEORDNETE PROTOKOLLZEILEN (nummeriert):
{{PROTOKOLL_ZEILEN}}
Ordne jede Zeile 0 bis 3 Kriterien zu, priorisiert nach Passung (wahrscheinlichstes zuerst). Nutze ausschließlich die oben gelisteten Kriterium-IDs. Wenn keine sinnvolle Zuordnung erkennbar ist, gib "-" an. Erfinde keine Kriterien und keine Beobachtungen, die nicht im Zeilentext stehen.
Antworte AUSSCHLIESSLICH in exakt diesem Format, ohne zusätzliche Erklärungen, ohne Markdown-Formatierung (Kriterium-IDs als plain numbers, ohne eckige Klammern):
ZEILE <Nummer>: <Kriterium-ID>, <Kriterium-ID>, ...
ZEILE <Nummer>: -
Ergänze danach, nur für Kriterien mit mindestens einer Zuordnung in dieser Analyse, kurze generalisierte Formulierungsmuster (1-2 Sätze, keine Zitate einzelner Zeilen):
MUSTER:
<Kriterium-ID>: <kurze Beschreibung typischer Formulierungen für dieses Kriterium>`,
criterionTaggingPromptPlaceholders: [
{ token: '{{ASSIGNMENT_TYP}}', description: 'Name des Assignment-Typs des aktuellen Meetings' },
{ token: '{{KRITERIEN_STRUKTUR}}', description: 'ID-referenzierte Struktur Dimension → Kategorie → Kriterium, gefiltert auf die im Assignment-Typ sichtbaren Kriterien, inkl. aller Beschreibungen' },
{ token: '{{GELERNTE_MUSTER}}', description: 'KI-destillierte Formulierungsmuster pro Kriterium aus früheren Analyse-Läufen (Nebenprodukt, siehe FeedbackCriterionItem.learnedPatternHints)' },
{ token: '{{AEHNLICHE_ALT_ZUORDNUNGEN}}', description: 'Lokal (ohne KI) ermittelte, ähnlichste bereits getaggte Alt-Zeilen je noch offener Zeile' },
{ token: '{{PROTOKOLL_ZEILEN}}', description: 'Nummerierte, noch nicht zugeordnete Protokollzeilen (Gesprächsbeiträge + allgemeine Notizen)' },
],
defaultChecklistTaggingPromptTemplate: `Du ordnest Checklistenpunkte aus Kundenterminen Bewertungskriterien zu. Jeder Punkt ist ein strukturierter Prüfpunkt mit festem Namen (Label). Kommentare zu Checklistenpunkten sind absichtlich nicht enthalten — sie dienen nur der späteren Feedback-Text-Erstellung, nicht der Kriterium-Zuordnung.
ASSIGNMENT-TYP: {{ASSIGNMENT_TYP}}
VERFÜGBARE KRITERIEN (Dimension → Kategorie → Kriterium, referenziert über die Zahl in eckigen Klammern):
{{KRITERIEN_STRUKTUR}}
BEREITS BEKANNTE, TYPISCHE FORMULIERUNGSMUSTER PRO KRITERIUM (aus früheren Analyse-Läufen, sofern vorhanden):
{{GELERNTE_MUSTER}}
ÄHNLICHE, BEREITS ZUGEORDNETE ALT-ZEILEN (Kontext-Hinweis — Suche primär nach Label-Ähnlichkeit):
{{AEHNLICHE_ALT_ZUORDNUNGEN}}
NOCH NICHT ZUGEORDNETE CHECKLISTENPUNKTE (nummeriert — ordne ausschließlich nach Bedeutung des Punkt-Namens/Labels):
{{CHECKLISTEN_PUNKTE}}
Ordne jeden Punkt 0 bis 3 Kriterien zu, priorisiert nach Passung (wahrscheinlichstes zuerst). Nutze ausschließlich die oben gelisteten Kriterium-IDs. Der Punkt-Name ist das einzige Zuordnungskriterium — es gibt keine Scores oder Kommentare. Wenn keine sinnvolle Zuordnung erkennbar ist, gib "-" an.
Antworte AUSSCHLIESSLICH in exakt diesem Format, ohne zusätzliche Erklärungen, ohne Markdown-Formatierung (Kriterium-IDs als plain numbers, ohne eckige Klammern):
PUNKT <Nummer>: <Kriterium-ID>, <Kriterium-ID>, ...
PUNKT <Nummer>: -`,
checklistTaggingPromptPlaceholders: [
{ token: '{{ASSIGNMENT_TYP}}', description: 'Name des Assignment-Typs des aktuellen Meetings' },
{ token: '{{KRITERIEN_STRUKTUR}}', description: 'ID-referenzierte Struktur Dimension → Kategorie → Kriterium (gefiltert)' },
{ token: '{{GELERNTE_MUSTER}}', description: 'Formulierungsmuster aus früheren Protokoll-Analysen' },
{ token: '{{AEHNLICHE_ALT_ZUORDNUNGEN}}', description: 'Ähnlichste Alt-Zuordnungen je Checklistenpunkt (Label-basiert)' },
{ token: '{{CHECKLISTEN_PUNKTE}}', description: 'Nummerierte Checklistenpunkte (nur Label — kein Score, kein Kommentar)' },
],
} as const
/** Numerische Gewichte für Rating-Aggregation. N/A wird aus Berechnungen ausgeschlossen. */
export const RATING_NUM_MAP: Record<FeedbackRating, number> = {
na: 0,
not_client_ready: 1,
partially_client_ready: 2,
nearly_client_ready: 3,
client_ready: 4,
}
/** Default-Zeitgewichtung für den Bewertungs-Vorschlag, überschreibbar über Config > Gewichtung. */
export const DEFAULT_RATING_TREND_WEIGHT_STEP = 0.5
/** Mindest-Punktedelta auf der 1–10-Skala zwischen erstem und letztem Meeting, ab dem ein Trend gilt. */
export const RATING_TREND_DELTA_THRESHOLD = 1
+1 -7
View File
@@ -1,8 +1,2 @@
export * from './types'
export { db } from './schema'
export {
seedIfEmpty,
seedFeedbackStructureIfEmpty,
seedCriterionMappingsIfEmpty,
migrateToUnifiedCriteriaIfNeeded,
} from './seeds'
export * from './queries'
+39
View File
@@ -0,0 +1,39 @@
import { rpc } from '../rpcClient'
import type { RatingColorBand } from '../types'
export const getRatingTrendWeightStep = (): Promise<number> => rpc('appSettings', 'getRatingTrendWeightStep')
export const getOrSeedRatingTrendWeightStep = (): Promise<number> => rpc('appSettings', 'getOrSeedRatingTrendWeightStep')
export const saveRatingTrendWeightStep = (weightStep: number): Promise<number> =>
rpc('appSettings', 'saveRatingTrendWeightStep', weightStep)
export const getOrSeedRatingColorBands = (): Promise<RatingColorBand[]> =>
rpc('appSettings', 'getOrSeedRatingColorBands')
export const saveRatingColorBands = (bands: RatingColorBand[]): Promise<number> =>
rpc('appSettings', 'saveRatingColorBands', bands)
export const getDefaultDimensionPromptTemplate = (): Promise<string> =>
rpc('appSettings', 'getDefaultDimensionPromptTemplate')
export const getOrSeedDefaultDimensionPromptTemplate = (): Promise<string> =>
rpc('appSettings', 'getOrSeedDefaultDimensionPromptTemplate')
export const saveDefaultDimensionPromptTemplate = (template: string): Promise<number> =>
rpc('appSettings', 'saveDefaultDimensionPromptTemplate', template)
export const getOrSeedCriterionTaggingPromptTemplate = (): Promise<string> =>
rpc('appSettings', 'getOrSeedCriterionTaggingPromptTemplate')
export const saveCriterionTaggingPromptTemplate = (template: string): Promise<number> =>
rpc('appSettings', 'saveCriterionTaggingPromptTemplate', template)
export const getOrSeedChecklistTaggingPromptTemplate = (): Promise<string> =>
rpc('appSettings', 'getOrSeedChecklistTaggingPromptTemplate')
export const saveChecklistTaggingPromptTemplate = (template: string): Promise<number> =>
rpc('appSettings', 'saveChecklistTaggingPromptTemplate', template)
export const getOrSeedDefaultCategoryPromptTemplate = (): Promise<string> =>
rpc('appSettings', 'getOrSeedDefaultCategoryPromptTemplate')
export const saveDefaultCategoryPromptTemplate = (template: string): Promise<number> =>
rpc('appSettings', 'saveDefaultCategoryPromptTemplate', template)
export const getOrSeedRequirePlannedDates = (): Promise<boolean> =>
rpc('appSettings', 'getOrSeedRequirePlannedDates')
export const saveRequirePlannedDates = (required: boolean): Promise<number> =>
rpc('appSettings', 'saveRequirePlannedDates', required)
+13
View File
@@ -0,0 +1,13 @@
import { rpc } from '../rpcClient'
import type { Assessment } from '../types'
export const listAssessmentsAll = (): Promise<Assessment[]> => rpc('assessments', 'listAssessmentsAll')
export const listAssessmentsForMeeting = (meetingInstanceId: number): Promise<Assessment[]> =>
rpc('assessments', 'listAssessmentsForMeeting', meetingInstanceId)
export const listAssessmentsForMeetings = (meetingInstanceIds: number[]): Promise<Assessment[]> =>
rpc('assessments', 'listAssessmentsForMeetings', meetingInstanceIds)
export const addAssessment = (a: Omit<Assessment, 'id'>): Promise<number> => rpc('assessments', 'addAssessment', a)
export const updateAssessment = (id: number, patch: Partial<Assessment>): Promise<number> =>
rpc('assessments', 'updateAssessment', id, patch)
export const deleteAssessmentsForMeeting = (meetingInstanceId: number): Promise<number> =>
rpc('assessments', 'deleteAssessmentsForMeeting', meetingInstanceId)
+59
View File
@@ -0,0 +1,59 @@
import { rpc } from '../rpcClient'
import type {
FeedbackDraft, AssignmentFeedback, FeedbackCategoryRating, FeedbackDimensionText, FeedbackCategoryText,
} from '../types'
export const getFeedbackDraft = (assignmentId: number, instituteeId: number): Promise<FeedbackDraft | undefined> =>
rpc('assignmentFeedback', 'getFeedbackDraft', assignmentId, instituteeId)
export const addFeedbackDraft = (d: Omit<FeedbackDraft, 'id'>): Promise<number> => rpc('assignmentFeedback', 'addFeedbackDraft', d)
export const updateFeedbackDraft = (id: number, patch: Partial<FeedbackDraft>): Promise<number> =>
rpc('assignmentFeedback', 'updateFeedbackDraft', id, patch)
export const getAssignmentFeedback = (assignmentId: number, instituteeId: number): Promise<AssignmentFeedback | undefined> =>
rpc('assignmentFeedback', 'getAssignmentFeedback', assignmentId, instituteeId)
/** Für die Auswertungsübersicht: Feedback-Status (Entwurf/Final) aller Assignments auf einen Schlag, statt N+1-Abfragen pro Zeile. */
export const listAssignmentFeedbacksAll = (): Promise<AssignmentFeedback[]> => rpc('assignmentFeedback', 'listAssignmentFeedbacksAll')
export const getAssignmentFeedbackById = (id: number): Promise<AssignmentFeedback | undefined> =>
rpc('assignmentFeedback', 'getAssignmentFeedbackById', id)
export const addAssignmentFeedback = (f: Omit<AssignmentFeedback, 'id'>): Promise<number> =>
rpc('assignmentFeedback', 'addAssignmentFeedback', f)
export const updateAssignmentFeedback = (id: number, patch: Partial<AssignmentFeedback>): Promise<number> =>
rpc('assignmentFeedback', 'updateAssignmentFeedback', id, patch)
export const getOrCreateAssignmentFeedback = (
assignmentId: number,
instituteeId: number,
): Promise<AssignmentFeedback | undefined> => rpc('assignmentFeedback', 'getOrCreateAssignmentFeedback', assignmentId, instituteeId)
export const listFeedbackCategoryRatings = (assignmentFeedbackId: number): Promise<FeedbackCategoryRating[]> =>
rpc('assignmentFeedback', 'listFeedbackCategoryRatings', assignmentFeedbackId)
export const addFeedbackCategoryRating = (r: Omit<FeedbackCategoryRating, 'id'>): Promise<number> =>
rpc('assignmentFeedback', 'addFeedbackCategoryRating', r)
export const updateFeedbackCategoryRating = (id: number, patch: Partial<FeedbackCategoryRating>): Promise<number> =>
rpc('assignmentFeedback', 'updateFeedbackCategoryRating', id, patch)
export const deleteFeedbackCategoryRating = (id: number): Promise<void> =>
rpc('assignmentFeedback', 'deleteFeedbackCategoryRating', id)
export const listFeedbackDimensionTexts = (assignmentFeedbackId: number): Promise<FeedbackDimensionText[]> =>
rpc('assignmentFeedback', 'listFeedbackDimensionTexts', assignmentFeedbackId)
export const getFeedbackDimensionText = (
assignmentFeedbackId: number,
feedbackDimensionId: number,
): Promise<FeedbackDimensionText | undefined> =>
rpc('assignmentFeedback', 'getFeedbackDimensionText', assignmentFeedbackId, feedbackDimensionId)
export const addFeedbackDimensionText = (t: Omit<FeedbackDimensionText, 'id'>): Promise<number> =>
rpc('assignmentFeedback', 'addFeedbackDimensionText', t)
export const updateFeedbackDimensionText = (id: number, patch: Partial<FeedbackDimensionText>): Promise<number> =>
rpc('assignmentFeedback', 'updateFeedbackDimensionText', id, patch)
export const listFeedbackCategoryTexts = (assignmentFeedbackId: number): Promise<FeedbackCategoryText[]> =>
rpc('assignmentFeedback', 'listFeedbackCategoryTexts', assignmentFeedbackId)
export const getFeedbackCategoryText = (
assignmentFeedbackId: number,
feedbackCategoryId: number,
): Promise<FeedbackCategoryText | undefined> =>
rpc('assignmentFeedback', 'getFeedbackCategoryText', assignmentFeedbackId, feedbackCategoryId)
export const addFeedbackCategoryText = (t: Omit<FeedbackCategoryText, 'id'>): Promise<number> =>
rpc('assignmentFeedback', 'addFeedbackCategoryText', t)
export const updateFeedbackCategoryText = (id: number, patch: Partial<FeedbackCategoryText>): Promise<number> =>
rpc('assignmentFeedback', 'updateFeedbackCategoryText', id, patch)
+10
View File
@@ -0,0 +1,10 @@
import { rpc } from '../rpcClient'
import type { AssignmentTransferPackage, AssignmentImportResult } from '../types'
export type { AssignmentTransferPackage, AssignmentImportResult }
export const exportAssignmentTransfer = (assignmentId: number): Promise<AssignmentTransferPackage> =>
rpc('assignmentTransfer', 'exportAssignmentTransfer', assignmentId)
export const importAssignmentTransfer = (pkg: AssignmentTransferPackage): Promise<AssignmentImportResult> =>
rpc('assignmentTransfer', 'importAssignmentTransfer', pkg)
+23
View File
@@ -0,0 +1,23 @@
import { rpc } from '../rpcClient'
import type { AssignmentType, PhaseTemplate } from '../types'
export const listAssignmentTypes = (): Promise<AssignmentType[]> => rpc('assignmentTypes', 'listAssignmentTypes')
export const getAssignmentType = (id: number): Promise<AssignmentType | undefined> => rpc('assignmentTypes', 'getAssignmentType', id)
export const addAssignmentType = (type: Omit<AssignmentType, 'id'>): Promise<number> =>
rpc('assignmentTypes', 'addAssignmentType', type)
export const updateAssignmentType = (id: number, patch: Partial<AssignmentType>): Promise<number> =>
rpc('assignmentTypes', 'updateAssignmentType', id, patch)
/** Löscht nur, wenn keine Assignments mehr diesen Typ referenzieren (Cascade auf phaseTemplates sonst). */
export const deleteAssignmentType = (id: number): Promise<{ ok: true } | { ok: false; assignmentCount: number }> =>
rpc('assignmentTypes', 'deleteAssignmentType', id)
export const listPhaseTemplates = (): Promise<PhaseTemplate[]> => rpc('assignmentTypes', 'listPhaseTemplates')
export const getPhaseTemplate = (id: number): Promise<PhaseTemplate | undefined> => rpc('assignmentTypes', 'getPhaseTemplate', id)
export const listPhaseTemplatesForType = (assignmentTypeId: number): Promise<PhaseTemplate[]> =>
rpc('assignmentTypes', 'listPhaseTemplatesForType', assignmentTypeId)
export const addPhaseTemplate = (tmpl: Omit<PhaseTemplate, 'id'>): Promise<number> =>
rpc('assignmentTypes', 'addPhaseTemplate', tmpl)
export const updatePhaseTemplate = (id: number, patch: Partial<PhaseTemplate>): Promise<number> =>
rpc('assignmentTypes', 'updatePhaseTemplate', id, patch)
export const deletePhaseTemplate = (id: number): Promise<void> => rpc('assignmentTypes', 'deletePhaseTemplate', id)
+30
View File
@@ -0,0 +1,30 @@
import { rpc } from '../rpcClient'
import type { Assignment } from '../types'
export const listAssignments = (): Promise<Assignment[]> => rpc('assignments', 'listAssignments')
export const listAssignmentsNewestFirst = (): Promise<Assignment[]> => rpc('assignments', 'listAssignmentsNewestFirst')
export const getAssignment = (id: number): Promise<Assignment | undefined> => rpc('assignments', 'getAssignment', id)
export const addAssignment = (a: Omit<Assignment, 'id'>): Promise<number> => rpc('assignments', 'addAssignment', a)
export const updateAssignment = (id: number, patch: Partial<Assignment>): Promise<number> =>
rpc('assignments', 'updateAssignment', id, patch)
export const isAssignmentFeedbackComplete = (assignmentId: number): Promise<boolean> =>
rpc('assignments', 'isAssignmentFeedbackComplete', assignmentId)
export const softDeleteAssignment = (id: number): Promise<number> => rpc('assignments', 'softDeleteAssignment', id)
export const restoreAssignment = (id: number): Promise<number> => rpc('assignments', 'restoreAssignment', id)
export const archiveAssignment = (id: number): Promise<number> => rpc('assignments', 'archiveAssignment', id)
export const unarchiveAssignment = (id: number): Promise<number> => rpc('assignments', 'unarchiveAssignment', id)
/** Cascade: meetingInstances (+ deren Kinder) → feedbackDrafts → assignmentFeedbacks (+ deren Kinder) → assignment. */
export const hardDeleteAssignment = (id: number): Promise<void> => rpc('assignments', 'hardDeleteAssignment', id)
export interface AssignmentWithDetails extends Assignment {
typeName: string
typeColor: string
instituteeNames: string[]
/** Nur für status==='done' relevant: jedes Institutee hat ein finales Feedback — steuert den Löschen-Button in der Übersicht. */
feedbackComplete: boolean
}
/** Für die Dashboard-Liste: Assignments mit aufgelöstem Typ- und Institutee-Namen, neueste zuerst. */
export const listAssignmentsWithDetails = (): Promise<AssignmentWithDetails[]> => rpc('assignments', 'listAssignmentsWithDetails')
+28
View File
@@ -0,0 +1,28 @@
import { rpc } from '../rpcClient'
import type { ChecklistItemDef, ChecklistResponse } from '../types'
export const listChecklistItemDefsForPhaseTemplate = (phaseTemplateId: number): Promise<ChecklistItemDef[]> =>
rpc('checklists', 'listChecklistItemDefsForPhaseTemplate', phaseTemplateId)
export const listChecklistItemDefsForPhaseTemplates = (phaseTemplateIds: number[]): Promise<ChecklistItemDef[]> =>
rpc('checklists', 'listChecklistItemDefsForPhaseTemplates', phaseTemplateIds)
export const addChecklistItemDef = (def: Omit<ChecklistItemDef, 'id'>): Promise<number> =>
rpc('checklists', 'addChecklistItemDef', def)
export const updateChecklistItemDef = (id: number, patch: Partial<ChecklistItemDef>): Promise<number> =>
rpc('checklists', 'updateChecklistItemDef', id, patch)
export const deleteChecklistItemDef = (id: number): Promise<void> =>
rpc('checklists', 'deleteChecklistItemDef', id)
export const listChecklistResponsesForMeeting = (meetingInstanceId: number): Promise<ChecklistResponse[]> =>
rpc('checklists', 'listChecklistResponsesForMeeting', meetingInstanceId)
export const listChecklistResponsesForMeetings = (meetingInstanceIds: number[]): Promise<ChecklistResponse[]> =>
rpc('checklists', 'listChecklistResponsesForMeetings', meetingInstanceIds)
export const upsertChecklistResponse = (input: {
meetingInstanceId: number
instituteeId?: number
checklistItemId: number
rating: ChecklistResponse['rating']
note: string
criterionItemId?: number | null
criterionOverride?: boolean
}): Promise<number> => rpc('checklists', 'upsertChecklistResponse', input)
+50
View File
@@ -0,0 +1,50 @@
import { rpc } from '../rpcClient'
import type {
Group, Consultant,
ConsultantImportRow, ConsultantImportResult,
HardDeleteConsultantResult, ConsultantDetail,
} from '../types'
export type {
ConsultantImportRow, ConsultantImportResult,
HardDeleteConsultantResult, ConsultantDetail,
}
export const listGroups = (): Promise<Group[]> => rpc('consultants', 'listGroups')
export const getGroup = (id: number): Promise<Group | undefined> => rpc('consultants', 'getGroup', id)
export const addGroup = (group: Omit<Group, 'id'>): Promise<number> => rpc('consultants', 'addGroup', group)
export const updateGroup = (id: number, patch: Partial<Group>): Promise<number> =>
rpc('consultants', 'updateGroup', id, patch)
export const deleteGroup = (
id: number,
): Promise<{ ok: true } | { ok: false; reason: string; memberCount: number }> =>
rpc('consultants', 'deleteGroup', id)
export const listConsultants = (): Promise<Consultant[]> => rpc('consultants', 'listConsultants')
export const listActiveConsultants = (): Promise<Consultant[]> => rpc('consultants', 'listActiveConsultants')
export const listArchivedConsultants = (): Promise<Consultant[]> => rpc('consultants', 'listArchivedConsultants')
export const getConsultant = (id: number): Promise<Consultant | undefined> => rpc('consultants', 'getConsultant', id)
export const getConsultantsByIds = (ids: number[]): Promise<Consultant[]> =>
rpc('consultants', 'getConsultantsByIds', ids)
export const findConsultantByEmail = (email: string): Promise<Consultant | undefined> =>
rpc('consultants', 'findConsultantByEmail', email)
export const addConsultant = (consultant: Omit<Consultant, 'id'>): Promise<number> =>
rpc('consultants', 'addConsultant', consultant)
export const updateConsultant = (id: number, patch: Partial<Consultant>): Promise<number> =>
rpc('consultants', 'updateConsultant', id, patch)
export const archiveConsultant = (id: number): Promise<number> => rpc('consultants', 'archiveConsultant', id)
export const unarchiveConsultant = (id: number): Promise<number> => rpc('consultants', 'unarchiveConsultant', id)
export const hardDeleteConsultant = (id: number): Promise<HardDeleteConsultantResult> =>
rpc('consultants', 'hardDeleteConsultant', id)
export const deleteConsultant = (id: number): Promise<void> => rpc('consultants', 'deleteConsultant', id)
export const importConsultantsToGroup = (
groupId: number,
rows: ConsultantImportRow[],
moveIfDifferentGroup?: boolean,
): Promise<ConsultantImportResult> =>
rpc('consultants', 'importConsultantsToGroup', groupId, rows, moveIfDifferentGroup)
export const getConsultantDetail = (id: number): Promise<ConsultantDetail | undefined> =>
rpc('consultants', 'getConsultantDetail', id)
+21
View File
@@ -0,0 +1,21 @@
import { rpc } from '../rpcClient'
import type { ConversationEntry, ConversationSkillScore } from '../types'
export const listConversationEntriesForMeeting = (meetingInstanceId: number): Promise<ConversationEntry[]> =>
rpc('conversationEntries', 'listConversationEntriesForMeeting', meetingInstanceId)
export const listConversationEntriesForMeetings = (meetingInstanceIds: number[]): Promise<ConversationEntry[]> =>
rpc('conversationEntries', 'listConversationEntriesForMeetings', meetingInstanceIds)
export const addConversationEntry = (e: Omit<ConversationEntry, 'id'>): Promise<number> =>
rpc('conversationEntries', 'addConversationEntry', e)
export const updateConversationEntry = (id: number, patch: Partial<ConversationEntry>): Promise<number> =>
rpc('conversationEntries', 'updateConversationEntry', id, patch)
export const deleteConversationEntry = (id: number): Promise<void> => rpc('conversationEntries', 'deleteConversationEntry', id)
export const listConversationSkillScoresAll = (): Promise<ConversationSkillScore[]> =>
rpc('conversationEntries', 'listConversationSkillScoresAll')
export const addConversationSkillScore = (s: Omit<ConversationSkillScore, 'id'>): Promise<number> =>
rpc('conversationEntries', 'addConversationSkillScore', s)
export const updateConversationSkillScore = (id: number, patch: Partial<ConversationSkillScore>): Promise<number> =>
rpc('conversationEntries', 'updateConversationSkillScore', id, patch)
export const deleteConversationSkillScoresForEntry = (conversationEntryId: number): Promise<number> =>
rpc('conversationEntries', 'deleteConversationSkillScoresForEntry', conversationEntryId)
+6
View File
@@ -0,0 +1,6 @@
import { rpc } from '../rpcClient'
import type { ConversationLineTag } from '../types'
/** Globaler (Zeilentext → Kriterium)-Korpus über alle Assignments — siehe server/db/queries/criterionSuggestions.ts. */
export const getGlobalLineTagCorpus = (): Promise<ConversationLineTag[]> =>
rpc('criterionSuggestions', 'getGlobalLineTagCorpus')
+154
View File
@@ -0,0 +1,154 @@
import { rpc } from '../rpcClient'
import type { FeedbackDimension, FeedbackCategory, FeedbackCriterionItem, FeedbackDimensionPrompt } from '../types'
export interface FeedbackStructure {
dimensions: FeedbackDimension[]
categories: FeedbackCategory[]
items: FeedbackCriterionItem[]
}
/** Vollständige, nach `order` sortierte Feedback-Taxonomie. */
export const loadFeedbackStructure = (): Promise<FeedbackStructure> => rpc('feedbackStructure', 'loadFeedbackStructure')
/** Unsortierte Rohtabellen — für Stellen, die selbst filtern/sortieren (z.B. MeetingView, AssignmentDetail). */
export const listFeedbackCategoriesOrdered = (): Promise<FeedbackCategory[]> => rpc('feedbackStructure', 'listFeedbackCategoriesOrdered')
export const listFeedbackCategoriesAll = (): Promise<FeedbackCategory[]> => rpc('feedbackStructure', 'listFeedbackCategoriesAll')
export const listFeedbackCriterionItemsAll = (): Promise<FeedbackCriterionItem[]> => rpc('feedbackStructure', 'listFeedbackCriterionItemsAll')
export const getFeedbackCriterionItemsByIds = (ids: number[]): Promise<FeedbackCriterionItem[]> =>
rpc('feedbackStructure', 'getFeedbackCriterionItemsByIds', ids)
/**
* "AssignmentType.criteriaIds restrict die sichtbaren Kriterien" — identische Filterlogik, die zuvor
* in MeetingView.tsx und AssignmentDetail.tsx dupliziert war. Leere/undefined criteriaIds = alles sichtbar.
* Reine Client-Berechnung, kein Server-Roundtrip nötig.
*/
export function filterVisibleFeedbackStructure<
C extends { id?: number },
I extends { id?: number; categoryId: number },
>(allCategories: C[], allItems: I[], criteriaIds: number[] | undefined): { categories: C[]; items: I[] } {
const itemFilter = criteriaIds?.length ? new Set(criteriaIds) : null
const items = itemFilter ? allItems.filter(i => itemFilter.has(i.id!)) : allItems
const visibleCatIds = new Set(items.map(i => i.categoryId))
const categories = itemFilter ? allCategories.filter(c => visibleCatIds.has(c.id!)) : allCategories
return { categories, items }
}
/**
* Kanonische Sichtbarkeit für Assignment-Typ: Dimension → Kategorie → Kriterien.
* Kategorien ohne sichtbare Items und Dimensionen ohne sichtbare Kategorien entfallen.
* Leere/undefined criteriaIds = alles sichtbar. Baut auf `filterVisibleFeedbackStructure`.
*/
export function resolveVisibleStructure<
D extends { id?: number },
C extends { id?: number; dimensionId: number },
I extends { id?: number; categoryId: number },
>(
allDimensions: D[],
allCategories: C[],
allItems: I[],
criteriaIds: number[] | undefined,
): { dimensions: D[]; categories: C[]; items: I[] } {
const { categories, items } = filterVisibleFeedbackStructure(allCategories, allItems, criteriaIds)
const visibleDimIds = new Set(categories.map(c => c.dimensionId))
const dimensions = allDimensions.filter(d => visibleDimIds.has(d.id!))
return { dimensions, categories, items }
}
/** Alle Kriterium-IDs der gegebenen Kategorien — für Config „Kategorie/Dimension wählen → criteriaIds“. */
export function criterionIdsForCategories(
categoryIds: number[],
allItems: { id?: number; categoryId: number }[],
): number[] {
const catSet = new Set(categoryIds)
return allItems.filter(i => catSet.has(i.categoryId) && i.id != null).map(i => i.id!)
}
export const addFeedbackDimension = (d: Omit<FeedbackDimension, 'id'>): Promise<number> =>
rpc('feedbackStructure', 'addFeedbackDimension', d)
export const updateFeedbackDimension = (id: number, patch: Partial<FeedbackDimension>): Promise<number> =>
rpc('feedbackStructure', 'updateFeedbackDimension', id, patch)
/** Cascade: Items der Kategorien → Kategorien → Dimension. */
export const deleteFeedbackDimension = (id: number): Promise<void> => rpc('feedbackStructure', 'deleteFeedbackDimension', id)
export const addFeedbackCategory = (c: Omit<FeedbackCategory, 'id'>): Promise<number> =>
rpc('feedbackStructure', 'addFeedbackCategory', c)
export const updateFeedbackCategory = (id: number, patch: Partial<FeedbackCategory>): Promise<number> =>
rpc('feedbackStructure', 'updateFeedbackCategory', id, patch)
/** Cascade: Items der Kategorie → Kategorie. */
export const deleteFeedbackCategory = (id: number): Promise<void> => rpc('feedbackStructure', 'deleteFeedbackCategory', id)
export const addFeedbackCriterionItem = (i: Omit<FeedbackCriterionItem, 'id'>): Promise<number> =>
rpc('feedbackStructure', 'addFeedbackCriterionItem', i)
export const updateFeedbackCriterionItem = (id: number, patch: Partial<FeedbackCriterionItem>): Promise<number> =>
rpc('feedbackStructure', 'updateFeedbackCriterionItem', id, patch)
/** Räumt vorher selbst alle Verwendungen auf (Assessments/Tags/Sichtbarkeitslisten) — siehe CLAUDE.md. */
export const deleteFeedbackCriterionItem = (id: number): Promise<void> => rpc('feedbackStructure', 'deleteFeedbackCriterionItem', id)
export interface CriterionUsage {
assessmentCount: number
lineTagCount: number
generalNoteTagCount: number
assignmentTypeNames: string[]
phaseTemplateLabels: string[]
meetings: { meetingId: number; assignmentId: number; assignmentTitle: string; date: string }[]
}
/** Verwendungs-Übersicht für alle Kriterien in einem Rutsch — siehe CLAUDE.md „Kriterien-Umbau". */
export const getCriterionUsageMap = (): Promise<Record<number, CriterionUsage>> =>
rpc('feedbackStructure', 'getCriterionUsageMap')
/** Überträgt alle Referenzen von `fromId` auf `toId` (für sicheres Löschen mit Zusammenführung statt Datenverlust). */
export const reassignCriterionReferences = (fromId: number, toId: number): Promise<{ mergedConflicts: number }> =>
rpc('feedbackStructure', 'reassignCriterionReferences', fromId, toId)
export type CriterionUsageInstance =
| { kind: 'assessment'; assessmentId: number; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'lineTag'; conversationEntryId: number; tagText: string; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'generalNoteTag'; meetingInstanceId: number; tagText: string; meetingId: number; assignmentTitle: string; date: string; personLabel: string; text: string }
| { kind: 'assignmentTypeVisibility'; assignmentTypeId: number; criterionId: number; text: string }
| { kind: 'phaseTemplateVisibility'; phaseTemplateId: number; criterionId: number; text: string }
/** Einzelinstanzen-Liste für EIN Kriterium — Grundlage, um eine Zuordnung direkt umzuhängen/zu entfernen. */
export const getCriterionUsageDetails = (criterionId: number): Promise<CriterionUsageInstance[]> =>
rpc('feedbackStructure', 'getCriterionUsageDetails', criterionId)
/** Hängt EINE einzelne Verwendungsinstanz auf ein anderes Kriterium um. */
export const reassignUsageInstance = (instance: CriterionUsageInstance, toId: number): Promise<{ merged: boolean }> =>
rpc('feedbackStructure', 'reassignUsageInstance', instance, toId)
/** Entfernt EINE einzelne Verwendungsinstanz (Assessment wird gelöscht, Tags nur von der Zuordnung befreit). */
export const removeUsageInstance = (instance: CriterionUsageInstance): Promise<void> =>
rpc('feedbackStructure', 'removeUsageInstance', instance)
export const listFeedbackDimensionPrompts = (): Promise<FeedbackDimensionPrompt[]> =>
rpc('feedbackStructure', 'listFeedbackDimensionPrompts')
/** Selbstheilend — legt serverseitig bei Bedarf eine fehlende Prompt-Zeile mit Default-Template an. */
export const getFeedbackDimensionPrompt = (dimensionId: number): Promise<FeedbackDimensionPrompt> =>
rpc('feedbackStructure', 'getFeedbackDimensionPrompt', dimensionId)
export const updateFeedbackDimensionPrompt = (id: number, patch: Partial<FeedbackDimensionPrompt>): Promise<number> =>
rpc('feedbackStructure', 'updateFeedbackDimensionPrompt', id, patch)
export const resetAllDimensionPromptsToDefault = (): Promise<{ updated: number }> =>
rpc('feedbackStructure', 'resetAllDimensionPromptsToDefault')
export type { FeedbackStructureSeed } from '../../utils/feedbackStructureImport'
export type ReplaceFeedbackStructureResult = {
dimensions: number
categories: number
items: number
clearedDimensions: number
}
/** Ersetzt die gesamte Feedback-Struktur durch ein Seed-Objekt. */
export const replaceFeedbackStructure = (seed: import('../../utils/feedbackStructureImport').FeedbackStructureSeed): Promise<ReplaceFeedbackStructureResult> =>
rpc('feedbackStructure', 'replaceFeedbackStructure', seed)
/** Parst Markdown (Export-Format) und ersetzt die Struktur. */
export const importFeedbackStructureFromMarkdown = (md: string): Promise<ReplaceFeedbackStructureResult> =>
rpc('feedbackStructure', 'importFeedbackStructureFromMarkdown', md)
/** Lädt docs/preload/Feedback-Struktur-final.md in die Dev-DB. */
export const preloadFinalFeedbackStructure = (): Promise<ReplaceFeedbackStructureResult> =>
rpc('feedbackStructure', 'preloadFinalFeedbackStructure')
+13
View File
@@ -0,0 +1,13 @@
export * from './appSettings'
export * from './consultants'
export * from './assignmentTypes'
export * from './assignments'
export * from './feedbackStructure'
export * from './criterionSuggestions'
export * from './checklists'
export * from './meetings'
export * from './conversationEntries'
export * from './assessments'
export * from './assignmentFeedback'
export * from './meetingCategoryRatings'
export * from './assignmentTransfer'
+16
View File
@@ -0,0 +1,16 @@
import { rpc } from '../rpcClient'
import type { MeetingCategoryRating, RatingScore } from '../types'
export const listMeetingCategoryRatingsForMeeting = (meetingInstanceId: number): Promise<MeetingCategoryRating[]> =>
rpc('meetingCategoryRatings', 'listMeetingCategoryRatingsForMeeting', meetingInstanceId)
export const listMeetingCategoryRatingsForMeetings = (meetingInstanceIds: number[]): Promise<MeetingCategoryRating[]> =>
rpc('meetingCategoryRatings', 'listMeetingCategoryRatingsForMeetings', meetingInstanceIds)
export const upsertMeetingCategoryRating = (input: {
meetingInstanceId: number
instituteeId: number
categoryId: number
score: RatingScore | null
note?: string
}): Promise<number> => rpc('meetingCategoryRatings', 'upsertMeetingCategoryRating', input)
+43
View File
@@ -0,0 +1,43 @@
import { rpc } from '../rpcClient'
import type {
MeetingInstance, PhaseTemplate, Assignment, Consultant,
ConversationEntry, ConversationSkillScore, Assessment,
ChecklistItemDef, ChecklistResponse, MeetingCategoryRating,
} from '../types'
export const getMeetingInstance = (id: number): Promise<MeetingInstance | undefined> => rpc('meetings', 'getMeetingInstance', id)
export const listMeetingInstancesForAssignment = (assignmentId: number): Promise<MeetingInstance[]> =>
rpc('meetings', 'listMeetingInstancesForAssignment', assignmentId)
/**
* Kanonischer Filter für Aggregationen über mehrere Meetings: Papierkorb-/unfertige Meetings ausschließen,
* chronologisch sortiert. Siehe CLAUDE.md — immer diese Funktion nutzen, nicht erneut inline filtern.
*/
export const listDoneMeetingsChronological = (assignmentId: number): Promise<MeetingInstance[]> =>
rpc('meetings', 'listDoneMeetingsChronological', assignmentId)
export const addMeetingInstance = (m: Omit<MeetingInstance, 'id'>): Promise<number> => rpc('meetings', 'addMeetingInstance', m)
export const updateMeetingInstance = (id: number, patch: Partial<MeetingInstance>): Promise<number> =>
rpc('meetings', 'updateMeetingInstance', id, patch)
export const softDeleteMeetingInstance = (id: number): Promise<number> => rpc('meetings', 'softDeleteMeetingInstance', id)
export const restoreMeetingInstance = (id: number): Promise<number> => rpc('meetings', 'restoreMeetingInstance', id)
/** Cascade: conversationSkillScores der Entries → conversationEntries → assessments → meetingInstance. */
export const hardDeleteMeetingInstance = (id: number): Promise<void> => rpc('meetings', 'hardDeleteMeetingInstance', id)
export interface MeetingExportData {
meeting: MeetingInstance
template: PhaseTemplate | undefined
assignment: Assignment | undefined
consultants: Consultant[]
entries: ConversationEntry[]
allScores: ConversationSkillScore[]
assessments: Assessment[]
categoryRatings: MeetingCategoryRating[]
checklistItems: ChecklistItemDef[]
checklistResponses: ChecklistResponse[]
}
/** Gebündelte Rohdaten für Markdown-/JSON-Export eines Meetings — vorher in meetingExport.ts dupliziert. */
export const getMeetingExportData = (meetingId: number): Promise<MeetingExportData> =>
rpc('meetings', 'getMeetingExportData', meetingId)
+30
View File
@@ -0,0 +1,30 @@
/**
* Bridge zum lokalen Server (server/index.ts) — ersetzt den bisherigen direkten Dexie-Zugriff
* in src/db/queries/*.ts. Ein Endpunkt statt ~80 REST-Routen: `{ module, fn, args }` → Server
* ruft `rpcModules[module][fn](...args)` auf. Relativer Pfad `/api/rpc`, damit derselbe Code
* unverändert über den Vite-Dev-Proxy UND später hinter einem Reverse Proxy/Docker funktioniert.
*/
export async function rpc<T>(module: string, fn: string, ...args: unknown[]): Promise<T> {
let res: Response
try {
res = await fetch('/api/rpc', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ module, fn, args }),
})
} catch (err) {
throw new Error(
`API nicht erreichbar (${err instanceof Error ? err.message : String(err)}). `
+ `Läuft der Dev-Server? In AssigmentMonitorV2: npm run dev:all (API-Port 4001).`,
)
}
if (!res.ok) {
const hint = res.status === 502 || res.status === 504 || res.status === 500
? ` — vermutlich läuft die API auf Port 4001 nicht (npm run server / npm run dev:all).`
: ''
throw new Error(`RPC-Fehler: ${res.status} ${res.statusText}${hint}`)
}
const body = await res.json() as { ok: boolean; result?: T; error?: string }
if (!body.ok) throw new Error(body.error ?? 'RPC-Fehler')
return body.result as T
}
-135
View File
@@ -1,135 +0,0 @@
import Dexie, { type Table } from 'dexie'
import type {
Category, Criterion,
AssignmentType, PhaseTemplate,
Group, Consultant,
Assignment, MeetingInstance,
ConversationEntry, ConversationSkillScore,
Assessment, FeedbackDraft,
FeedbackDimension, FeedbackCategory, FeedbackCriterionItem,
AssignmentFeedback, FeedbackCategoryRating, FeedbackDimensionText,
CriterionCategoryMapping, CriterionLevelDescription,
} from './types'
class AssignmentMonitorDB extends Dexie {
categories!: Table<Category>
criteria!: Table<Criterion>
assignmentTypes!: Table<AssignmentType>
phaseTemplates!: Table<PhaseTemplate>
groups!: Table<Group>
consultants!: Table<Consultant>
assignments!: Table<Assignment>
meetingInstances!: Table<MeetingInstance>
conversationEntries!: Table<ConversationEntry>
conversationSkillScores!: Table<ConversationSkillScore>
assessments!: Table<Assessment>
feedbackDrafts!: Table<FeedbackDraft>
feedbackDimensions!: Table<FeedbackDimension>
feedbackCategories!: Table<FeedbackCategory>
feedbackCriterionItems!: Table<FeedbackCriterionItem>
assignmentFeedbacks!: Table<AssignmentFeedback>
feedbackCategoryRatings!: Table<FeedbackCategoryRating>
feedbackDimensionTexts!: Table<FeedbackDimensionText>
criterionCategoryMappings!: Table<CriterionCategoryMapping>
criterionLevelDescriptions!: Table<CriterionLevelDescription>
constructor() {
super('AssignmentMonitorDB')
this.version(1).stores({
categories: '++id, order',
criteria: '++id, categoryId, order',
groups: '++id',
consultants: '++id, groupId',
meetings: '++id, date, status, groupId',
assessments: '++id, meetingId, consultantId, criteriaId',
consultantNotes: '++id, meetingId, consultantId',
})
this.version(2).stores({
categories: '++id, order',
criteria: '++id, categoryId, order',
assignmentTypes: '++id',
phaseTemplates: '++id, assignmentTypeId, order',
groups: '++id',
consultants: '++id, groupId',
assignments: '++id, status, createdAt',
meetingInstances: '++id, assignmentId, phaseTemplateId',
conversationEntries: '++id, meetingInstanceId, instituteeId, sequenceIndex',
conversationSkillScores: '++id, conversationEntryId, criteriaId',
assessments: '++id, meetingInstanceId, instituteeId, criteriaId',
feedbackDrafts: '++id, assignmentId, instituteeId',
meetings: null,
consultantNotes: null,
})
this.version(3).stores({
categories: '++id, order',
criteria: '++id, categoryId, order',
assignmentTypes: '++id',
phaseTemplates: '++id, assignmentTypeId, order',
groups: '++id',
consultants: '++id, groupId',
assignments: '++id, status, createdAt',
meetingInstances: '++id, assignmentId, phaseTemplateId',
conversationEntries: '++id, meetingInstanceId, instituteeId, sequenceIndex',
conversationSkillScores: '++id, conversationEntryId, criteriaId',
assessments: '++id, meetingInstanceId, instituteeId, criteriaId',
feedbackDrafts: '++id, assignmentId, instituteeId',
feedbackDimensions: '++id, order',
feedbackCategories: '++id, dimensionId, order',
feedbackCriterionItems: '++id, categoryId, order',
assignmentFeedbacks: '++id, assignmentId, instituteeId',
feedbackCategoryRatings: '++id, assignmentFeedbackId, feedbackCategoryId',
feedbackDimensionTexts: '++id, assignmentFeedbackId, feedbackDimensionId',
meetings: null,
consultantNotes: null,
})
this.version(4).stores({
categories: '++id, order',
criteria: '++id, categoryId, order',
assignmentTypes: '++id',
phaseTemplates: '++id, assignmentTypeId, order',
groups: '++id',
consultants: '++id, groupId',
assignments: '++id, status, createdAt',
meetingInstances: '++id, assignmentId, phaseTemplateId',
conversationEntries: '++id, meetingInstanceId, instituteeId, sequenceIndex',
conversationSkillScores: '++id, conversationEntryId, criteriaId',
assessments: '++id, meetingInstanceId, instituteeId, criteriaId',
feedbackDrafts: '++id, assignmentId, instituteeId',
feedbackDimensions: '++id, order',
feedbackCategories: '++id, dimensionId, order',
feedbackCriterionItems: '++id, categoryId, order',
assignmentFeedbacks: '++id, assignmentId, instituteeId',
feedbackCategoryRatings: '++id, assignmentFeedbackId, feedbackCategoryId',
feedbackDimensionTexts: '++id, assignmentFeedbackId, feedbackDimensionId',
criterionCategoryMappings: '++id, criterionId, feedbackCategoryId',
meetings: null,
consultantNotes: null,
})
this.version(5).stores({
categories: '++id, order',
criteria: '++id, categoryId, order',
assignmentTypes: '++id',
phaseTemplates: '++id, assignmentTypeId, order',
groups: '++id',
consultants: '++id, groupId',
assignments: '++id, status, createdAt',
meetingInstances: '++id, assignmentId, phaseTemplateId',
conversationEntries: '++id, meetingInstanceId, instituteeId, sequenceIndex',
conversationSkillScores: '++id, conversationEntryId, criteriaId',
assessments: '++id, meetingInstanceId, instituteeId, criteriaId',
feedbackDrafts: '++id, assignmentId, instituteeId',
feedbackDimensions: '++id, order',
feedbackCategories: '++id, dimensionId, order',
feedbackCriterionItems: '++id, categoryId, order',
assignmentFeedbacks: '++id, assignmentId, instituteeId',
feedbackCategoryRatings: '++id, assignmentFeedbackId, feedbackCategoryId',
feedbackDimensionTexts: '++id, assignmentFeedbackId, feedbackDimensionId',
criterionCategoryMappings: '++id, criterionId, feedbackCategoryId',
criterionLevelDescriptions: '++id, criterionItemId, rating',
meetings: null,
consultantNotes: null,
})
}
}
export const db = new AssignmentMonitorDB()
-87
View File
@@ -1,87 +0,0 @@
import { db } from '../schema'
import type { PhaseKey } from '../types'
export async function seedIfEmpty() {
const count = await db.assignmentTypes.count()
if (count > 0) return
// ── Gemeinsame Kategorien & Kriterien (Legacy-Tabellen für Evaluation.tsx) ──
const catKomm = await db.categories.add({ name: 'Kommunikation', order: 1 })
const catFach = await db.categories.add({ name: 'Fachkompetenz', order: 2 })
const catKunde = await db.categories.add({ name: 'Kundenorientierung', order: 3 })
const catSelf = await db.categories.add({ name: 'Selbstorganisation', order: 4 })
const catCase = await db.categories.add({ name: 'Case-Kompetenz', order: 5 })
const kritKlarheit = await db.criteria.add({ categoryId: catKomm, name: 'Klarheit & Struktur', description: 'Klare, strukturierte Aussagen', weight: 2, order: 1 })
const kritUeberzeug = await db.criteria.add({ categoryId: catKomm, name: 'Überzeugungskraft', description: 'Argumente überzeugend präsentieren', weight: 2, order: 2 })
const kritZuhoeren = await db.criteria.add({ categoryId: catKomm, name: 'Aktives Zuhören', description: 'Eingehen auf Gesprächspartner', weight: 1, order: 3 })
const kritFragen = await db.criteria.add({ categoryId: catKomm, name: 'Umgang mit Fragen', description: 'Reaktion auf Kunden-Fragen', weight: 2, order: 4 })
const kritTiefe = await db.criteria.add({ categoryId: catFach, name: 'Fachliche Tiefe', description: 'Inhaltliche Korrektheit und Tiefe', weight: 3, order: 1 })
const kritProblem = await db.criteria.add({ categoryId: catFach, name: 'Problemlösung', description: 'Analytisches Vorgehen, Hypothesen', weight: 3, order: 2 })
const kritStakeholder = await db.criteria.add({ categoryId: catKunde, name: 'Stakeholder-Verständnis', description: 'Erkennt Bedürfnisse und Erwartungen', weight: 2, order: 1 })
const kritEmpathie = await db.criteria.add({ categoryId: catKunde, name: 'Empathie', description: 'Einfühlungsvermögen im Gespräch', weight: 1, order: 2 })
const kritVorb = await db.criteria.add({ categoryId: catSelf, name: 'Vorbereitung', description: 'Zeigt gute Meeting-Vorbereitung', weight: 2, order: 1 })
const kritInitiative = await db.criteria.add({ categoryId: catSelf, name: 'Eigeninitiative', description: 'Handelt proaktiv ohne Aufforderung', weight: 2, order: 2 })
const kritStruktur = await db.criteria.add({ categoryId: catCase, name: 'Problemstrukturierung', description: 'Systematische Zerlegung des Problems', weight: 3, order: 1 })
const kritHypo = await db.criteria.add({ categoryId: catCase, name: 'Hypothesenbildung', description: 'Klare, testbare Hypothesen', weight: 3, order: 2 })
const kritAnalyse = await db.criteria.add({ categoryId: catCase, name: 'Rechnen & Analyse', description: 'Datenbasiertes Vorgehen, Schätzfähigkeit', weight: 2, order: 3 })
const kritZeitmanage = await db.criteria.add({ categoryId: catCase, name: 'Zeitmanagement', description: 'Effizienter Umgang mit der Case-Zeit', weight: 2, order: 4 })
const addPhase = (
assignmentTypeId: number,
phaseKey: PhaseKey,
label: string,
withWhom: 'lead' | 'client',
opts: { repeatable?: boolean; conv?: boolean; assess?: boolean; criteriaIds?: number[]; order: number }
) => db.phaseTemplates.add({
assignmentTypeId,
phaseKey,
label,
withWhom,
isRepeatable: opts.repeatable ?? false,
hasConversation: opts.conv ?? false,
hasAssessment: opts.assess ?? false,
criteriaIds: opts.criteriaIds ?? [],
order: opts.order,
})
// ── AssignmentType 1: Generisch ──────────────────────────────────────────
const genericId = await db.assignmentTypes.add({
name: 'Generisch',
defaultPhaseKeys: ['preBriefing', 'briefing', 'alignmentCall', 'preDelivery', 'delivery', 'feedbackCallClient', 'feedbackCallLead'],
})
const genericCriteria = [kritKlarheit, kritUeberzeug, kritZuhoeren, kritTiefe, kritProblem, kritStakeholder, kritEmpathie, kritVorb, kritInitiative]
await addPhase(genericId, 'preBriefing', 'Pre-Briefing (Lead)', 'lead', { order: 1 })
await addPhase(genericId, 'briefing', 'Briefing (Kunde)', 'client', { conv: true, assess: true, criteriaIds: genericCriteria, order: 2 })
await addPhase(genericId, 'alignmentCall', 'Alignment Call (Kunde)', 'client', { repeatable: true, conv: true, assess: true, criteriaIds: genericCriteria, order: 3 })
await addPhase(genericId, 'preDelivery', 'Pre-Delivery (Lead)', 'lead', { order: 4 })
await addPhase(genericId, 'delivery', 'Delivery (Kunde)', 'client', { conv: true, assess: true, criteriaIds: genericCriteria, order: 5 })
await addPhase(genericId, 'feedbackCallClient', 'Feedback Call (Kunde)', 'client', { conv: true, assess: true, criteriaIds: genericCriteria, order: 6 })
await addPhase(genericId, 'feedbackCallLead', 'Feedback Call (Lead)', 'lead', { order: 7 })
// ── AssignmentType 2: Case Interview ────────────────────────────────────
const caseId = await db.assignmentTypes.add({
name: 'Case Interview',
defaultPhaseKeys: ['preBriefing', 'briefing', 'delivery', 'feedbackCallClient', 'feedbackCallLead'],
})
const caseCriteria = [kritStruktur, kritHypo, kritAnalyse, kritKlarheit, kritZeitmanage, kritUeberzeug, kritFragen]
await addPhase(caseId, 'preBriefing', 'Pre-Briefing (Lead)', 'lead', { order: 1 })
await addPhase(caseId, 'briefing', 'Case Briefing (Kunde)', 'client', { conv: true, assess: true, criteriaIds: caseCriteria, order: 2 })
await addPhase(caseId, 'delivery', 'Case Delivery (Kunde)', 'client', { conv: true, assess: true, criteriaIds: caseCriteria, order: 3 })
await addPhase(caseId, 'feedbackCallClient', 'Feedback Call (Kunde)', 'client', { conv: true, assess: true, criteriaIds: caseCriteria, order: 4 })
await addPhase(caseId, 'feedbackCallLead', 'Feedback Call (Lead)', 'lead', { order: 5 })
// ── AssignmentType 3: Stakeholder Meeting / Pitch ────────────────────────
const pitchId = await db.assignmentTypes.add({
name: 'Stakeholder Meeting / Pitch',
defaultPhaseKeys: ['preBriefing', 'briefing', 'alignmentCall', 'preDelivery', 'delivery', 'feedbackCallClient', 'feedbackCallLead'],
})
const pitchCriteria = [kritVorb, kritKlarheit, kritUeberzeug, kritStakeholder, kritFragen, kritEmpathie, kritInitiative]
await addPhase(pitchId, 'preBriefing', 'Pre-Briefing (Lead)', 'lead', { order: 1 })
await addPhase(pitchId, 'briefing', 'Briefing (Kunde)', 'client', { conv: true, assess: true, criteriaIds: pitchCriteria, order: 2 })
await addPhase(pitchId, 'alignmentCall', 'Alignment Call (Kunde)', 'client', { repeatable: true, conv: true, assess: true, criteriaIds: pitchCriteria, order: 3 })
await addPhase(pitchId, 'preDelivery', 'Pre-Delivery (Lead)', 'lead', { order: 4 })
await addPhase(pitchId, 'delivery', 'Pitch / Delivery (Kunde)', 'client', { conv: true, assess: true, criteriaIds: pitchCriteria, order: 5 })
await addPhase(pitchId, 'feedbackCallClient', 'Feedback Call (Kunde)', 'client', { conv: true, assess: true, criteriaIds: pitchCriteria, order: 6 })
await addPhase(pitchId, 'feedbackCallLead', 'Feedback Call (Lead)', 'lead', { order: 7 })
}
-65
View File
@@ -1,65 +0,0 @@
import { db } from '../schema'
export async function seedFeedbackStructureIfEmpty() {
const count = await db.feedbackDimensions.count()
if (count > 0) return
type CatSeed = { name: string; items: string[] }
type DimSeed = { name: string; cats: CatSeed[] }
const dimensions: DimSeed[] = [
{
name: 'Mindset, Commitment, Collaboration',
cats: [
{ name: 'Persönliche Einstellung', items: ['Ruhig bei Stress', 'Offen für neue Themen', 'Auftreten / Ausstrahlung', 'Pro aktiv', 'Lösungsorientiert'] },
{ name: 'Professionalität', items: ['Pünktlichkeit', 'Professionell bei informellen Gesprächen', 'Adressatengerecht', 'Hohes Maß an Selbststeuerung', 'Klarheit', 'Zuverlässigkeit'] },
{ name: 'Commitment', items: ['Offen für spontane Änderungen', 'Selbständiger Lösungsansatz', 'Pro aktive Ideen', 'Verantwortungsbewusst', 'Hilfsbereit', 'Teamorientiert'] },
{ name: 'Kommunikationsfähigkeit', items: ['To the point', 'Recap-Fähigkeit', 'Active Listening', 'Souveränität'] },
{ name: 'Zusammenarbeit', items: ['Regelmäßige Abstimmung', 'Unterstützung bei Bedarf', 'Know-How Sharing', 'Starkes Teamverhalten', 'Verantwortung und Vertrauen', 'Inhaltlich unterstützend'] },
],
},
{
name: 'Running Our Projects',
cats: [
{ name: 'Ergebnisverantwortung', items: ['Fokussierung', 'Priorisierung (Impact Driven)', 'Machbarkeit / Umsetzbarkeit', 'Alternativvorschläge', 'Interne Abstimmung und Feedback'] },
{ name: 'Arbeitsstil', items: ['Komplexitätsmanagement', 'Eigenverantwortung', 'Feedbackaffinität', 'Verantwortungsbewusst / vorausschauend', 'Selbstreflektiert, lösungsorientiert', 'Offen, initiativ, kollegial', 'Organisiert, kommunikationsfähig', 'Lernfähig, anpassungsbereit, flexibel'] },
{ name: 'Kundenmanagement', items: ['Aktives Erwartungsmanagement', 'Selbstsicherheit und fachliche Überzeugung', 'Aktive Advisory', 'Realistisch', 'Kundenfokussiert'] },
{ name: 'Lieferzeiten', items: ['Verlässlichkeit', 'Fortschrittskontrolle und Planadaption', 'Aktives Scoping', 'Meetingsvorbereitung', 'Transparent'] },
],
},
{
name: 'Growing our People',
cats: [
{ name: 'Networking', items: ['Cross-Collaboration', 'Network Growth', 'Network Utilization'] },
{ name: 'Learning und Development', items: ['Kritikfähigkeit', 'Wissensaufbau (Kompetenzausstrahlung)', 'Umsetzungsbereitschaft Feedback'] },
],
},
{
name: 'Functional & Technical Skills',
cats: [
{ name: 'Qualität des Inhalts', items: ['Belastbarkeit', 'Nachvollziehbarkeit', 'Logische Storyline'] },
{ name: 'Inhaltliche Vollständigkeit', items: ['Wesentliche Elemente vorhanden', 'Realitätsnähe', 'Nutzenfokus'] },
{ name: 'Qualität der Unterlage', items: ['Design nach Standardvorgaben', 'Sprachliche Präzision', 'Visualisierungen unterstützen Kernbotschaften'] },
{ name: 'Prozesstreue', items: ['Kenne und befolge Prozesse und Vorgaben', 'Nachvollziehbarkeit und Transparenz', 'Qualitätschecks'] },
],
},
{
name: 'Innovation und Asset Development',
cats: [
{ name: 'Innovation', items: ['Aktiver Vorschlag für Verbesserungen', 'Neue Ideen zur Verbesserung', 'Nutze aktuellen Wissensstand', 'Liefere über den Kundenerwartungen'] },
],
},
]
for (let di = 0; di < dimensions.length; di++) {
const dim = dimensions[di]
const dimId = await db.feedbackDimensions.add({ name: dim.name, order: di + 1 })
for (let ci = 0; ci < dim.cats.length; ci++) {
const cat = dim.cats[ci]
const catId = await db.feedbackCategories.add({ dimensionId: dimId, name: cat.name, order: ci + 1 })
for (let ii = 0; ii < cat.items.length; ii++) {
await db.feedbackCriterionItems.add({ categoryId: catId, name: cat.items[ii], order: ii + 1 })
}
}
}
}
-3
View File
@@ -1,3 +0,0 @@
export { seedIfEmpty } from './assignmentTypes'
export { seedFeedbackStructureIfEmpty } from './feedbackStructure'
export { seedCriterionMappingsIfEmpty, migrateToUnifiedCriteriaIfNeeded } from './migrations'
-106
View File
@@ -1,106 +0,0 @@
import { db } from '../schema'
export async function seedCriterionMappingsIfEmpty() {
const count = await db.criterionCategoryMappings.count()
if (count > 0) return
const [crits, cats] = await Promise.all([
db.criteria.toArray(),
db.feedbackCategories.toArray(),
])
if (crits.length === 0 || cats.length === 0) return
const c = (name: string) => crits.find(x => x.name === name)?.id
const f = (name: string) => cats.find(x => x.name === name)?.id
const mappings: [string, string][] = [
['Klarheit & Struktur', 'Kommunikationsfähigkeit'],
['Klarheit & Struktur', 'Qualität des Inhalts'],
['Überzeugungskraft', 'Kommunikationsfähigkeit'],
['Überzeugungskraft', 'Kundenmanagement'],
['Aktives Zuhören', 'Kommunikationsfähigkeit'],
['Umgang mit Fragen', 'Kommunikationsfähigkeit'],
['Umgang mit Fragen', 'Kundenmanagement'],
['Fachliche Tiefe', 'Qualität des Inhalts'],
['Fachliche Tiefe', 'Inhaltliche Vollständigkeit'],
['Problemlösung', 'Ergebnisverantwortung'],
['Problemlösung', 'Arbeitsstil'],
['Stakeholder-Verständnis', 'Kundenmanagement'],
['Stakeholder-Verständnis', 'Persönliche Einstellung'],
['Empathie', 'Persönliche Einstellung'],
['Empathie', 'Kommunikationsfähigkeit'],
['Vorbereitung', 'Professionalität'],
['Vorbereitung', 'Lieferzeiten'],
['Eigeninitiative', 'Commitment'],
['Eigeninitiative', 'Persönliche Einstellung'],
['Problemstrukturierung', 'Ergebnisverantwortung'],
['Problemstrukturierung', 'Qualität des Inhalts'],
['Hypothesenbildung', 'Ergebnisverantwortung'],
['Hypothesenbildung', 'Arbeitsstil'],
['Rechnen & Analyse', 'Qualität des Inhalts'],
['Rechnen & Analyse', 'Inhaltliche Vollständigkeit'],
['Zeitmanagement', 'Lieferzeiten'],
['Zeitmanagement', 'Arbeitsstil'],
]
for (const [critName, catName] of mappings) {
const criterionId = c(critName)
const feedbackCategoryId = f(catName)
if (criterionId && feedbackCategoryId) {
await db.criterionCategoryMappings.add({ criterionId, feedbackCategoryId })
}
}
}
// Löscht nur Bewertungs-Scores (keine Textinhalte), verknüpft PhaseTemplates
// mit FeedbackCategory-IDs statt veralteten Criterion-IDs.
export async function migrateToUnifiedCriteriaIfNeeded() {
const cats = await db.feedbackCategories.toArray()
if (cats.length === 0) return
const templates = await db.phaseTemplates.toArray()
if (templates.length === 0) return
const catIds = new Set(cats.map(c => c.id!))
const firstWithIds = templates.find(t => t.criteriaIds.length > 0)
if (firstWithIds && catIds.has(firstWithIds.criteriaIds[0])) return
const cat = (name: string) => cats.find(c => c.name === name)?.id
await db.conversationSkillScores.clear()
await db.assessments.clear()
const genericCats = [
cat('Kommunikationsfähigkeit'), cat('Persönliche Einstellung'),
cat('Kundenmanagement'), cat('Ergebnisverantwortung'), cat('Qualität des Inhalts'),
].filter(Boolean) as number[]
const caseCats = [
cat('Kommunikationsfähigkeit'), cat('Ergebnisverantwortung'),
cat('Arbeitsstil'), cat('Qualität des Inhalts'), cat('Inhaltliche Vollständigkeit'),
].filter(Boolean) as number[]
const pitchCats = [
cat('Kommunikationsfähigkeit'), cat('Persönliche Einstellung'),
cat('Kundenmanagement'), cat('Ergebnisverantwortung'),
cat('Qualität des Inhalts'), cat('Qualität der Unterlage'),
].filter(Boolean) as number[]
const types = await db.assignmentTypes.toArray()
for (const tmpl of templates) {
if (!tmpl.hasAssessment && !tmpl.hasConversation) {
await db.phaseTemplates.update(tmpl.id!, { criteriaIds: [] })
continue
}
const aType = types.find(t => t.id === tmpl.assignmentTypeId)
let newIds: number[]
if (aType?.name === 'Case Interview') {
newIds = caseCats
} else if (aType?.name === 'Stakeholder Meeting / Pitch') {
newIds = pitchCats
} else {
newIds = genericCats
}
await db.phaseTemplates.update(tmpl.id!, { criteriaIds: newIds })
}
}
+236 -12
View File
@@ -1,11 +1,16 @@
// ─── Bewertungs-Skala ────────────────────────────────────────────────────────
// ─── Bewertungs-Skala (1–10) ─────────────────────────────────────────────────
export type FeedbackRating =
| 'na'
| 'not_client_ready'
| 'partially_client_ready'
| 'nearly_client_ready'
| 'client_ready'
/** Ganzzahlige Bewertung 1–10. Speicherung: INTEGER; „nicht gesetzt" = null (kein N/A-String). */
export type RatingScore = number
/** Farbband für die 1–10-Skala — Grenzen/Keys editierbar in Config → Skala. */
export type RatingBandKey = 'red' | 'orange' | 'lightGreen' | 'darkGreen'
export interface RatingColorBand {
/** Inklusive Obergrenze dieses Bandes (aufsteigend, letzte max muss 10 sein). */
max: number
key: RatingBandKey
}
// ─── Legacy-Konfiguration (nur noch für Evaluation.tsx) ───────────────────────
@@ -33,6 +38,8 @@ export interface AssignmentType {
name: string
defaultPhaseKeys: PhaseKey[]
criteriaIds?: number[] // FeedbackCriterionItem IDs; leer = alle anzeigen
/** Anzeige-Farbe auf Dashboard-Kacheln (Hex, z.B. #0070AD), editierbar in Einstellungen → Ass.-Typen. */
color?: string
}
export interface PhaseTemplate {
@@ -44,10 +51,54 @@ export interface PhaseTemplate {
isRepeatable: boolean
hasConversation: boolean
hasAssessment: boolean
/** Opt-in wie hasConversation/hasAssessment — schaltet den Checkliste-Tab in MeetingView frei. */
hasChecklist: boolean
criteriaIds: number[]
order: number
}
/**
* Definition eines Checklisten-Punkts für einen Phasentyp (Config → Assignment-Typen).
* Kriterium-Verknüpfung ist bewusst nur bei scope==='perInstitutee' sinnvoll/erlaubt — Kriterien
* sind in diesem Modell immer Personen-Kompetenzen, nie Meeting-Kollektiv-Eigenschaften (siehe
* CLAUDE.md „Präzisiert bei der Umsetzungsplanung"). Verknüpfte Punkte schreiben direkt in
* `Assessment` (keine eigene Antwort-Speicherung), unverknüpfte in `ChecklistResponse`.
*/
export interface ChecklistItemDef {
id?: number
phaseTemplateId: number
label: string
linkedCriterionItemId?: number | null
scope: 'perInstitutee' | 'meetingWide'
order: number
/**
* Wie der Checklisten-Score mit Protokoll-Notation auf dasselbe Kriterium zusammenfließt:
* equal = gleichrangig mitteln; primary = Checkliste dominiert; weighted = Checkliste ×2.
*/
scoreContribution?: ChecklistScoreContribution
}
export type ChecklistScoreContribution = 'equal' | 'primary' | 'weighted'
/**
* Antwort auf einen Checklisten-Punkt für dieses Meeting. `criterionItemId` überschreibt pro
* Antwort individuell die Konfigurations-Vorgabe aus `ChecklistItemDef.linkedCriterionItemId`
* (leer = es gilt die konfigurierte Vorgabe, falls vorhanden) — nur bei effektiv vorhandenem
* Kriterium wird nach `Assessment` gespiegelt (siehe CLAUDE.md).
*/
export interface ChecklistResponse {
id?: number
meetingInstanceId: number
/** Gesetzt bei scope 'perInstitutee', leer bei 'meetingWide'. */
instituteeId?: number
checklistItemId: number
rating: RatingScore | null
note: string
/** Gesetzt wenn im Meeting manuell zugeordnet oder explizit entfernt — sonst gilt Config-Standard. */
criterionItemId?: number | null
criterionOverride?: boolean
}
// ─── Stammdaten ───────────────────────────────────────────────────────────────
export interface Group {
@@ -61,6 +112,56 @@ export interface Consultant {
groupId: number
firstName: string
lastName: string
/** Unternehmens-E-Mail, Pflicht und eindeutig (normalisiert klein). */
email: string
/** Archiv — Person nicht mehr für neue Assignments vorschlagen; Historie bleibt. */
archivedAt?: string
}
export interface ConsultantImportRow {
email: string
firstName: string
lastName: string
}
export interface ConsultantImportResult {
created: number
updated: number
moved: number
skipped: number
errors: string[]
}
export interface HardDeleteConsultantResult {
emptiedAssignmentIds: number[]
feedbacksDeleted: number
assignmentsTouched: number
}
export interface ConsultantAssignmentSummary {
assignmentId: number
title: string
assignmentNumber?: string
client: string
status: 'active' | 'done'
deletedAt?: string
archivedAt?: string
plannedStart?: string
plannedEnd?: string
createdAt: string
typeName: string
feedbackStatus: 'none' | 'draft' | 'final'
categoryRatings: Array<{
categoryId: number
categoryName: string
rating: RatingScore | null
}>
}
export interface ConsultantDetail {
consultant: Consultant
group: Group | undefined
assignments: ConsultantAssignmentSummary[]
}
// ─── Assignments ─────────────────────────────────────────────────────────────
@@ -81,6 +182,14 @@ export interface Assignment {
from?: string
to?: string
}>
/** Papierkorb-Zeitpunkt — analog MeetingInstance.deletedAt, nach 30 Tagen automatisch endgültig gelöscht. */
deletedAt?: string
/** Archiv-Zeitpunkt — dauerhafte Aufbewahrung (spätere Auswertung/ML), unabhängig vom Papierkorb. */
archivedAt?: string
/** Geplanter Beginn (ISO-Datum YYYY-MM-DD), optional; Pflicht nur wenn AppSettings.requirePlannedDates. */
plannedStart?: string
/** Geplantes Ende (ISO-Datum YYYY-MM-DD), optional. */
plannedEnd?: string
}
// ─── Meeting-Instanzen ────────────────────────────────────────────────────────
@@ -94,10 +203,17 @@ export interface MeetingInstance {
status: 'planned' | 'active' | 'done'
generalNotes: string
deletedAt?: string
/** Kriterium-Zuordnung pro Zeile der allgemeinen Notizen — anders als ConversationEntry.lineTags NICHT an ein Institutee gebunden, gilt für alle Institutees des Assignments. */
generalNoteTags?: ConversationLineTag[]
}
// ─── Gesprächs-Zeitleiste ─────────────────────────────────────────────────────
export interface ConversationLineTag {
text: string
criterionItemId: number // → FeedbackCriterionItem.id
}
export interface ConversationEntry {
id?: number
meetingInstanceId: number
@@ -106,6 +222,7 @@ export interface ConversationEntry {
note: string
fillerCount: number
updatedAt: string
lineTags?: ConversationLineTag[] // Kriterium-Zuordnung pro Zeile, gematcht per exaktem Zeilentext
}
// criteriaId → FeedbackCategory.id (Schnellbewertung während Gesprächsbeitrag)
@@ -113,20 +230,35 @@ export interface ConversationSkillScore {
id?: number
conversationEntryId: number
criteriaId: number
score: FeedbackRating | null
score: RatingScore | null
}
// ─── Gesamtbewertung ─────────────────────────────────────────────────────────
// criteriaId → FeedbackCriterionItem.id (Gesamtbewertung am Meeting-Ende)
// criteriaId → FeedbackCriterionItem.id (optionale Detail-Bewertung / Beobachtungsnotiz am Meeting)
export interface Assessment {
id?: number
meetingInstanceId: number
instituteeId: number
criteriaId: number
score: FeedbackRating | null
score: RatingScore | null
note: string
updatedAt: string
/** Score aus Vorschlag übernommen — Hinweis, dass manuell gegengelesen werden sollte. */
scoreNeedsReview?: boolean
}
/**
* Pflicht-Meeting-Bewertung auf Kategorie-Ebene (1–10), unabhängig davon ob alle
* Kriterien beobachtet wurden — siehe docs/SCALE_1_TO_10.md.
*/
export interface MeetingCategoryRating {
id?: number
meetingInstanceId: number
instituteeId: number
categoryId: number
score: RatingScore | null
note?: string
}
// ─── Feedback-Entwurf (Legacy) ────────────────────────────────────────────────
@@ -152,6 +284,8 @@ export interface FeedbackCategory {
dimensionId: number
name: string
order: number
/** Erläuterung, welche Themen/Beobachtungen in diese Kategorie einzahlen — fließt in {{KATEGORIEN_STRUKTUR}} der KI-Prompts ein. */
description?: string
}
export interface FeedbackCriterionItem {
@@ -160,6 +294,10 @@ export interface FeedbackCriterionItem {
name: string
weight?: number
order: number
/** Konkretisierung, worauf bei diesem Kriterium zu achten ist — fließt in {{KRITERIEN_SCORES}} der KI-Prompts ein. */
description?: string
/** KI-destillierte, generalisierte Formulierungsmuster (Nebenprodukt des „🏷 Vorschläge analysieren"-Laufs) — fließt in {{GELERNTE_MUSTER}} des Tagging-Prompts ein, wird bei jedem weiteren Lauf überschrieben. */
learnedPatternHints?: string
}
export interface AssignmentFeedback {
@@ -175,15 +313,37 @@ export interface FeedbackCategoryRating {
id?: number
assignmentFeedbackId: number
feedbackCategoryId: number
rating: FeedbackRating
rating: RatingScore
}
export interface FeedbackDimensionText {
id?: number
assignmentFeedbackId: number
feedbackDimensionId: number
/** DB-Feldname historisch; UI/PDF: Benefits */
achievements: string
/** DB-Feldname historisch; UI/PDF: Concerns */
developmentNeeds: string
suggestedAchievements?: string
suggestedDevelopmentNeeds?: string
}
// ─── KI-Prompt-Konfiguration & Kategorie-Texte ────────────────────────────────
export interface FeedbackDimensionPrompt {
id?: number
dimensionId: number
promptTemplate: string
}
export interface FeedbackCategoryText {
id?: number
assignmentFeedbackId: number
feedbackCategoryId: number
benefits: string
concerns: string
suggestedBenefits?: string
suggestedConcerns?: string
}
// ─── Legacy-Mappings ──────────────────────────────────────────────────────────
@@ -197,6 +357,70 @@ export interface CriterionCategoryMapping {
export interface CriterionLevelDescription {
id?: number
criterionItemId: number
rating: FeedbackRating
rating: RatingScore
text: string
}
// ─── App-Einstellungen (Singleton, id immer 1) ───────────────────────────────
export interface AppSettings {
id?: number
ratingTrendWeightStep: number // 0 = keine Zeitgewichtung, höher = stärkere Gewichtung späterer Meetings
/** Verdichtungs-Prompt Stufe B (Dimension aus Kategorie-Ergebnissen), editierbar in Config → KI-Prompts. */
defaultDimensionPromptTemplate?: string
/** Kategorie-Prompt Stufe A (1 Call pro Kategorie), editierbar in Config → KI-Prompts. */
defaultCategoryPromptTemplate?: string
/** Prompt-Template für „🏷 Vorschläge analysieren" (Protokoll-Freitext), editierbar in Config → KI-Prompts. */
criterionTaggingPromptTemplate?: string
/** Prompt-Template für Checklisten-Kriterium-Vorschläge (separater KI-Call), editierbar in Config → KI-Prompts. */
checklistTaggingPromptTemplate?: string
/** Farbbänder der 1–10-Skala (Defaults in constants.ts), editierbar in Config → Skala. */
ratingColorBands?: RatingColorBand[]
/** Wenn true: plannedStart/plannedEnd beim Anlegen eines Assignments Pflicht. */
requirePlannedDates?: boolean
}
// ─── Assignment-Übergabe (Lead → Lead, Export/Import) ─────────────────────────
export const ASSIGNMENT_TRANSFER_KIND = 'assignment-monitor-assignment-transfer' as const
/** JSON-Paket für die Übergabe eines einzelnen Assignments inkl. Notizen/Checklisten/Berater. */
export interface AssignmentTransferPackage {
kind: typeof ASSIGNMENT_TRANSFER_KIND
version: 1
exportedAt: string
source: {
assignmentId: number
assignmentNumber?: string
title: string
client: string
}
groups: Group[]
consultants: Consultant[]
assignmentType: AssignmentType
phaseTemplates: PhaseTemplate[]
checklistItemDefs: ChecklistItemDef[]
feedbackDimensions: FeedbackDimension[]
feedbackCategories: FeedbackCategory[]
feedbackCriterionItems: FeedbackCriterionItem[]
assignment: Assignment
meetingInstances: MeetingInstance[]
conversationEntries: ConversationEntry[]
conversationSkillScores: ConversationSkillScore[]
assessments: Assessment[]
meetingCategoryRatings: MeetingCategoryRating[]
checklistResponses: ChecklistResponse[]
feedbackDrafts: FeedbackDraft[]
assignmentFeedbacks: AssignmentFeedback[]
feedbackCategoryRatings: FeedbackCategoryRating[]
feedbackDimensionTexts: FeedbackDimensionText[]
feedbackCategoryTexts: FeedbackCategoryText[]
}
export interface AssignmentImportResult {
assignmentId: number
consultantsMatched: string[]
consultantsCreated: string[]
meetings: number
checklistResponses: number
}
+17
View File
@@ -0,0 +1,17 @@
import { useEffect, useState } from 'react'
import { DEFAULT_RATING_COLOR_BANDS, normalizeRatingColorBands } from '../config/constants'
import { getOrSeedRatingColorBands } from '../db'
import type { RatingColorBand } from '../db/types'
/** Lädt die konfigurierten Farbbänder einmalig (Config → Skala). */
export function useRatingColorBands(): RatingColorBand[] {
const [bands, setBands] = useState<RatingColorBand[]>(DEFAULT_RATING_COLOR_BANDS)
useEffect(() => {
getOrSeedRatingColorBands()
.then(b => setBands(normalizeRatingColorBands(b)))
.catch(() => setBands(DEFAULT_RATING_COLOR_BANDS))
}, [])
return bands
}
+38
View File
@@ -1,6 +1,44 @@
@import "tailwindcss";
/*
* Design-Tokens (UX.1) — Capgemini-Fachtool.
* Seiten schrittweise auf bg-app / bg-surface / border-line / text-ink* umstellen.
*/
@theme {
--color-brand: #0070AD;
--color-brand-dark: #005a8e;
--color-brand-soft: #e8f3f9;
--color-app: #eef2f5;
--color-surface: #ffffff;
--color-line: #d8e0e8;
--color-ink: #1a2b3c;
--color-ink-muted: #5a6b7c;
--color-ink-faint: #8a9aab;
--font-sans: "Source Sans 3", "Segoe UI", ui-sans-serif, system-ui, sans-serif;
--radius-control: 0.5rem;
--radius-panel: 0.75rem;
--shadow-header: 0 1px 0 rgb(0 0 0 / 0.06), 0 2px 8px rgb(0 70 120 / 0.12);
--shadow-nav: 0 -1px 0 rgb(0 0 0 / 0.06), 0 -4px 12px rgb(0 0 0 / 0.04);
}
@layer base {
html {
font-family: var(--font-sans);
color: var(--color-ink);
-webkit-font-smoothing: antialiased;
}
body {
margin: 0;
min-height: 100dvh;
background-color: var(--color-app);
}
#root {
min-height: 100dvh;
}
}
-7
View File
@@ -3,13 +3,6 @@ import { createRoot } from 'react-dom/client'
import { BrowserRouter } from 'react-router-dom'
import './index.css'
import App from './App.tsx'
import { seedIfEmpty, seedFeedbackStructureIfEmpty, seedCriterionMappingsIfEmpty, migrateToUnifiedCriteriaIfNeeded } from './db/index.ts'
seedIfEmpty()
seedFeedbackStructureIfEmpty().then(() => {
seedCriterionMappingsIfEmpty()
migrateToUnifiedCriteriaIfNeeded()
})
createRoot(document.getElementById('root')!).render(
<StrictMode>
+400
View File
@@ -0,0 +1,400 @@
import { useEffect, useRef, useState } from 'react'
import {
type FeedbackDimension, type FeedbackDimensionPrompt,
loadFeedbackStructure, listFeedbackDimensionPrompts, updateFeedbackDimensionPrompt,
resetAllDimensionPromptsToDefault,
getOrSeedDefaultDimensionPromptTemplate, saveDefaultDimensionPromptTemplate,
getOrSeedDefaultCategoryPromptTemplate, saveDefaultCategoryPromptTemplate,
getOrSeedCriterionTaggingPromptTemplate, saveCriterionTaggingPromptTemplate,
getOrSeedChecklistTaggingPromptTemplate, saveChecklistTaggingPromptTemplate,
} from '../db'
import { AI_CONFIG } from '../config/constants'
import { getAiSettings, saveAiSettings } from '../utils/aiClient'
export default function AiPromptConfig() {
const [dimensions, setDimensions] = useState<FeedbackDimension[]>([])
const [prompts, setPrompts] = useState<FeedbackDimensionPrompt[]>([])
const [defaultTemplate, setDefaultTemplate] = useState('')
const [defaultExpanded, setDefaultExpanded] = useState(false)
const [defaultSaved, setDefaultSaved] = useState(false)
const [categoryTemplate, setCategoryTemplate] = useState('')
const [categoryExpanded, setCategoryExpanded] = useState(false)
const [categorySaved, setCategorySaved] = useState(false)
const [taggingTemplate, setTaggingTemplate] = useState('')
const [taggingExpanded, setTaggingExpanded] = useState(false)
const [taggingSaved, setTaggingSaved] = useState(false)
const [checklistTaggingTemplate, setChecklistTaggingTemplate] = useState('')
const [checklistTaggingExpanded, setChecklistTaggingExpanded] = useState(false)
const [checklistTaggingSaved, setChecklistTaggingSaved] = useState(false)
const [expanded, setExpanded] = useState<Set<number>>(new Set())
const [savedDimId, setSavedDimId] = useState<number | null>(null)
const [bulkResetMsg, setBulkResetMsg] = useState('')
const saveTimer = useRef<Map<number | 'default' | 'category' | 'tagging' | 'checklistTagging', ReturnType<typeof setTimeout>>>(new Map())
const [aiKey, setAiKey] = useState(getAiSettings().apiKey)
const [aiModel, setAiModel] = useState(getAiSettings().model)
const [aiSaved, setAiSaved] = useState(false)
const load = async () => {
const [structure, promptRows, defTemplate, catTemplate, taggingTpl, checklistTaggingTpl] = await Promise.all([
loadFeedbackStructure(),
listFeedbackDimensionPrompts(),
getOrSeedDefaultDimensionPromptTemplate(),
getOrSeedDefaultCategoryPromptTemplate(),
getOrSeedCriterionTaggingPromptTemplate(),
getOrSeedChecklistTaggingPromptTemplate(),
])
setDimensions([...structure.dimensions].sort((a, b) => a.order - b.order))
setPrompts(promptRows)
setDefaultTemplate(defTemplate)
setCategoryTemplate(catTemplate)
setTaggingTemplate(taggingTpl)
setChecklistTaggingTemplate(checklistTaggingTpl)
}
useEffect(() => { load() }, [])
const getPrompt = (dimId: number) => prompts.find(p => p.dimensionId === dimId)
const saveTemplate = (dimId: number, value: string) => {
setPrompts(prev => prev.map(p => p.dimensionId === dimId ? { ...p, promptTemplate: value } : p))
const prevTimer = saveTimer.current.get(dimId)
if (prevTimer) clearTimeout(prevTimer)
saveTimer.current.set(dimId, setTimeout(async () => {
const existing = getPrompt(dimId)
if (!existing?.id) return
await updateFeedbackDimensionPrompt(existing.id, { promptTemplate: value })
setSavedDimId(dimId)
setTimeout(() => setSavedDimId(null), 2000)
}, 600))
}
const resetToDefault = async (dimId: number) => {
const existing = getPrompt(dimId)
if (!existing?.id) return
await updateFeedbackDimensionPrompt(existing.id, { promptTemplate: defaultTemplate })
setPrompts(prev => prev.map(p => p.dimensionId === dimId ? { ...p, promptTemplate: defaultTemplate } : p))
}
const resetAllToDefault = async () => {
if (!confirm('Alle Dimension-Prompts wirklich auf den Standard (1–10) setzen? Individuelle Anpassungen gehen verloren.')) return
const { updated } = await resetAllDimensionPromptsToDefault()
const promptRows = await listFeedbackDimensionPrompts()
setPrompts(promptRows)
setBulkResetMsg(`${updated} Dimension-Prompt(s) auf Standard gesetzt.`)
setTimeout(() => setBulkResetMsg(''), 4000)
}
const saveDefaultTemplate = (value: string) => {
setDefaultTemplate(value)
const prevTimer = saveTimer.current.get('default')
if (prevTimer) clearTimeout(prevTimer)
saveTimer.current.set('default', setTimeout(async () => {
await saveDefaultDimensionPromptTemplate(value)
setDefaultSaved(true)
setTimeout(() => setDefaultSaved(false), 2000)
}, 600))
}
const saveCategoryTemplate = (value: string) => {
setCategoryTemplate(value)
const prevTimer = saveTimer.current.get('category')
if (prevTimer) clearTimeout(prevTimer)
saveTimer.current.set('category', setTimeout(async () => {
await saveDefaultCategoryPromptTemplate(value)
setCategorySaved(true)
setTimeout(() => setCategorySaved(false), 2000)
}, 600))
}
const resetTaggingToDefault = async () => {
const def = AI_CONFIG.defaultCriterionTaggingPromptTemplate
await saveCriterionTaggingPromptTemplate(def)
setTaggingTemplate(def)
}
const resetChecklistTaggingToDefault = async () => {
const def = AI_CONFIG.defaultChecklistTaggingPromptTemplate
await saveChecklistTaggingPromptTemplate(def)
setChecklistTaggingTemplate(def)
}
const saveTaggingTemplate = (value: string) => {
setTaggingTemplate(value)
const prevTimer = saveTimer.current.get('tagging')
if (prevTimer) clearTimeout(prevTimer)
saveTimer.current.set('tagging', setTimeout(async () => {
await saveCriterionTaggingPromptTemplate(value)
setTaggingSaved(true)
setTimeout(() => setTaggingSaved(false), 2000)
}, 600))
}
const saveChecklistTaggingTemplate = (value: string) => {
setChecklistTaggingTemplate(value)
const prevTimer = saveTimer.current.get('checklistTagging')
if (prevTimer) clearTimeout(prevTimer)
saveTimer.current.set('checklistTagging', setTimeout(async () => {
await saveChecklistTaggingPromptTemplate(value)
setChecklistTaggingSaved(true)
setTimeout(() => setChecklistTaggingSaved(false), 2000)
}, 600))
}
return (
<div className="space-y-4">
<div>
<h2 className="text-lg font-bold text-gray-800">KI-Feedback (Kaskade)</h2>
<p className="text-sm text-gray-500 mt-1">
Stufe A: ein Call pro Kategorie (globaler Kategorie-Prompt). Stufe B: ein Call pro Dimension
(Verdichtung aus Kategorie-Ergebnissen — pro Dimension editierbar unten).
</p>
</div>
<div className="bg-white rounded-xl border border-blue-100 shadow-sm p-4 space-y-3">
<div className="text-sm font-semibold text-blue-800">OpenRouter API-Key</div>
<p className="text-xs text-gray-500">
Wird lokal im Browser gespeichert (<span className="font-mono">localStorage</span>) — nötig für
KI-Feedback und „Vorschläge analysieren". Key von{' '}
<span className="font-mono">openrouter.ai</span>.
</p>
<input
type="password"
className="w-full border border-blue-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
placeholder="sk-or-..."
value={aiKey}
onChange={e => setAiKey(e.target.value)}
/>
<select
className="w-full border border-blue-200 rounded-lg px-3 py-2 text-sm bg-white"
value={aiModel}
onChange={e => setAiModel(e.target.value)}>
<option value="openai/gpt-4o-mini">GPT-4o mini (günstig)</option>
<option value="openai/gpt-4o">GPT-4o</option>
<option value="anthropic/claude-sonnet-4-5">Claude Sonnet 4.5</option>
<option value="anthropic/claude-haiku-4-5">Claude Haiku 4.5 (schnell)</option>
<option value="google/gemini-flash-1.5">Gemini Flash 1.5</option>
</select>
<button
onClick={() => {
saveAiSettings(aiKey, aiModel)
setAiSaved(true)
setTimeout(() => setAiSaved(false), 2000)
}}
className="w-full py-2.5 bg-brand text-white rounded-xl text-sm font-semibold">
API-Key speichern
</button>
{aiSaved && (
<div className="text-xs text-green-700 bg-green-50 border border-green-200 rounded-lg px-3 py-2 text-center">
Gespeichert.
</div>
)}
</div>
{/* Kategorie-Prompt Stufe A */}
<div className="bg-white rounded-xl border border-green-100 shadow-sm overflow-hidden">
<button
onClick={() => setCategoryExpanded(p => !p)}
className="w-full flex items-center justify-between p-3 bg-green-50 border-b border-green-100 text-left">
<span className="font-semibold text-sm text-green-800">Stufe A — Kategorie-Prompt (1 Call pro Kategorie)</span>
<span className="text-xs text-green-400">{categoryExpanded ? '▲' : '▼'}</span>
</button>
{categoryExpanded && (
<div className="p-3 space-y-2">
<p className="text-xs text-gray-500">
Wird für jede Kategorie einzeln aufgerufen. Der Trend-Vorschlag aus Meetings wird im Prompt
vorgegeben; die KI bestätigt oder passt maximal ±1 an.
</p>
<textarea
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-xs font-mono focus:outline-none focus:border-brand min-h-[280px]"
value={categoryTemplate}
onChange={e => saveCategoryTemplate(e.target.value)}
/>
{categorySaved && <span className="text-xs text-green-600 font-medium">Gespeichert.</span>}
<div className="grid gap-1.5 pt-2">
{AI_CONFIG.categoryPromptPlaceholders.map(p => (
<div key={p.token} className="text-xs text-gray-600 flex gap-2">
<code className="bg-white border border-gray-200 rounded px-1.5 py-0.5 text-brand font-mono flex-shrink-0">{p.token}</code>
<span>{p.description}</span>
</div>
))}
</div>
</div>
)}
</div>
{/* Standard-Prompt Stufe B */}
<div className="bg-white rounded-xl border border-blue-100 shadow-sm overflow-hidden">
<button
onClick={() => setDefaultExpanded(p => !p)}
className="w-full flex items-center justify-between p-3 bg-blue-50 border-b border-blue-100 text-left">
<span className="font-semibold text-sm text-blue-800">Stufe B — Dimensions-Verdichtung (Basis für neue Dimensionen &amp; „Zurücksetzen")</span>
<span className="text-xs text-blue-400">{defaultExpanded ? '▲' : '▼'}</span>
</button>
{defaultExpanded && (
<div className="p-3 space-y-2">
<p className="text-xs text-gray-500">
Input sind nur die Kategorie-Ergebnisse aus Stufe A — kein Rohprotokoll. Wird beim Anlegen
neuer Dimensionen automatisch übernommen und ist die Basis für „Auf Standard zurücksetzen".
</p>
<textarea
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-xs font-mono focus:outline-none focus:border-brand min-h-[320px]"
value={defaultTemplate}
onChange={e => saveDefaultTemplate(e.target.value)}
/>
{defaultSaved && <span className="text-xs text-green-600 font-medium">Gespeichert.</span>}
</div>
)}
</div>
<div className="flex items-center gap-3 flex-wrap">
<button
onClick={resetAllToDefault}
className="text-xs bg-amber-50 hover:bg-amber-100 text-amber-800 border border-amber-200 px-3 py-1.5 rounded-lg font-medium">
Alle Dimension-Prompts auf Standard (Stufe B) setzen
</button>
{bulkResetMsg && <span className="text-xs text-green-600 font-medium">{bulkResetMsg}</span>}
</div>
{/* Platzhalter-Legende */}
<div className="bg-gray-50 rounded-xl border border-gray-100 p-4 space-y-2">
<div className="text-xs font-semibold text-gray-500 uppercase tracking-wide">Verfügbare Platzhalter</div>
<div className="grid gap-1.5">
{AI_CONFIG.dimensionPromptPlaceholders.map(p => (
<div key={p.token} className="text-xs text-gray-600 flex gap-2">
<code className="bg-white border border-gray-200 rounded px-1.5 py-0.5 text-brand font-mono flex-shrink-0">{p.token}</code>
<span>{p.description}</span>
</div>
))}
</div>
</div>
<div>
<h2 className="text-lg font-bold text-gray-800">KI-Prompts: Kriterien-Zuordnungsvorschläge</h2>
<p className="text-sm text-gray-500 mt-1">
„🏷 Vorschläge analysieren" im Meeting löst <strong>zwei getrennte KI-Calls</strong> aus: Protokoll-Freitext
(Antwortformat <code className="font-mono text-xs">ZEILE n:</code>) und Checklistenpunkte
(<code className="font-mono text-xs">PUNKT n:</code>).
</p>
</div>
<div className="bg-white rounded-xl border border-indigo-100 shadow-sm overflow-hidden">
<button
onClick={() => setTaggingExpanded(p => !p)}
className="w-full flex items-center justify-between p-3 bg-indigo-50 border-b border-indigo-100 text-left">
<span className="font-semibold text-sm text-indigo-800">Protokoll — Tagging-Prompt</span>
<span className="text-xs text-indigo-400">{taggingExpanded ? '▲' : '▼'}</span>
</button>
{taggingExpanded && (
<div className="p-3 space-y-2">
<p className="text-xs text-gray-500">Freitext-Zeilen aus Gesprächsprotokoll und allgemeinen Notizen.</p>
<textarea
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-xs font-mono focus:outline-none focus:border-brand min-h-[280px]"
value={taggingTemplate}
onChange={e => saveTaggingTemplate(e.target.value)}
/>
{taggingSaved && <span className="text-xs text-green-600 font-medium">Gespeichert.</span>}
<button onClick={resetTaggingToDefault}
className="text-xs bg-gray-100 hover:bg-gray-200 text-gray-600 px-3 py-1.5 rounded-lg font-medium">
Protokoll-Tagging auf Standard zurücksetzen
</button>
</div>
)}
</div>
<div className="bg-gray-50 rounded-xl border border-gray-100 p-4 space-y-2">
<div className="text-xs font-semibold text-gray-500 uppercase tracking-wide">Platzhalter Protokoll-Tagging</div>
<div className="grid gap-1.5">
{AI_CONFIG.criterionTaggingPromptPlaceholders.map(p => (
<div key={p.token} className="text-xs text-gray-600 flex gap-2">
<code className="bg-white border border-gray-200 rounded px-1.5 py-0.5 text-brand font-mono flex-shrink-0">{p.token}</code>
<span>{p.description}</span>
</div>
))}
</div>
</div>
<div className="bg-white rounded-xl border border-teal-100 shadow-sm overflow-hidden">
<button
onClick={() => setChecklistTaggingExpanded(p => !p)}
className="w-full flex items-center justify-between p-3 bg-teal-50 border-b border-teal-100 text-left">
<span className="font-semibold text-sm text-teal-800">Checkliste — Tagging-Prompt</span>
<span className="text-xs text-teal-400">{checklistTaggingExpanded ? '▲' : '▼'}</span>
</button>
{checklistTaggingExpanded && (
<div className="p-3 space-y-2">
<p className="text-xs text-gray-500">
Strukturierte Prüfpunkte — nur Label (kein Score). Antwortformat: <code className="font-mono">PUNKT n:</code>.
In Config → Ass.-Typen als „Standard-Zuordnung (KI)" nutzbar; spart Meeting-Calls.
</p>
<textarea
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-xs font-mono focus:outline-none focus:border-brand min-h-[280px]"
value={checklistTaggingTemplate}
onChange={e => saveChecklistTaggingTemplate(e.target.value)}
/>
{checklistTaggingSaved && <span className="text-xs text-green-600 font-medium">Gespeichert.</span>}
<button onClick={resetChecklistTaggingToDefault}
className="text-xs bg-gray-100 hover:bg-gray-200 text-gray-600 px-3 py-1.5 rounded-lg font-medium">
Checklisten-Tagging auf Standard zurücksetzen
</button>
</div>
)}
</div>
<div className="bg-gray-50 rounded-xl border border-gray-100 p-4 space-y-2">
<div className="text-xs font-semibold text-gray-500 uppercase tracking-wide">Platzhalter Checklisten-Tagging</div>
<div className="grid gap-1.5">
{AI_CONFIG.checklistTaggingPromptPlaceholders.map(p => (
<div key={p.token} className="text-xs text-gray-600 flex gap-2">
<code className="bg-white border border-gray-200 rounded px-1.5 py-0.5 text-brand font-mono flex-shrink-0">{p.token}</code>
<span>{p.description}</span>
</div>
))}
</div>
</div>
{/* Dimensionen */}
{dimensions.map(dim => {
const isOpen = expanded.has(dim.id!)
const prompt = getPrompt(dim.id!)
return (
<div key={dim.id} className="bg-white rounded-xl border border-gray-100 shadow-sm overflow-hidden">
<button
onClick={() => setExpanded(prev => {
const next = new Set(prev)
if (next.has(dim.id!)) next.delete(dim.id!); else next.add(dim.id!)
return next
})}
className="w-full flex items-center justify-between p-3 bg-gray-50 border-b border-gray-100 text-left">
<span className="font-semibold text-sm text-gray-800">{dim.name}</span>
<span className="text-xs text-gray-400">{isOpen ? '▲' : '▼'}</span>
</button>
{isOpen && (
<div className="p-3 space-y-2">
<textarea
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-xs font-mono focus:outline-none focus:border-brand min-h-[320px]"
value={prompt?.promptTemplate ?? ''}
onChange={e => saveTemplate(dim.id!, e.target.value)}
/>
<div className="flex items-center gap-2">
<button onClick={() => resetToDefault(dim.id!)}
className="text-xs bg-gray-100 hover:bg-gray-200 text-gray-600 px-3 py-1.5 rounded-lg font-medium">
Auf Standard zurücksetzen
</button>
{savedDimId === dim.id && (
<span className="text-xs text-green-600 font-medium">Gespeichert.</span>
)}
</div>
</div>
)}
</div>
)
})}
{dimensions.length === 0 && (
<div className="text-sm text-gray-400 text-center py-6">
Noch keine Dimensionen angelegt — siehe Tab „Feedback".
</div>
)}
</div>
)
}
+57
View File
@@ -0,0 +1,57 @@
import { useEffect, useState } from 'react'
import { useNavigate } from 'react-router-dom'
import { listAssignmentsWithDetails, unarchiveAssignment, type AssignmentWithDetails } from '../db'
export default function AssignmentArchive() {
const [assignments, setAssignments] = useState<AssignmentWithDetails[]>([])
const navigate = useNavigate()
const load = () => { listAssignmentsWithDetails().then(setAssignments) }
useEffect(() => { load() }, [])
const archived = assignments.filter(a => a.archivedAt)
const unarchive = async (id: number) => {
await unarchiveAssignment(id)
load()
}
return (
<div className="space-y-3">
<button onClick={() => navigate('/')} className="text-sm text-brand mb-2 block">← Zurück</button>
<h1 className="text-xl font-bold text-gray-800">🗄 Archiv</h1>
{archived.length === 0 && (
<p className="text-gray-400 text-sm text-center py-8">Archiv ist leer.</p>
)}
{archived.map(a => (
<div key={a.id} className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<div className="flex items-start justify-between gap-3">
<div className="flex-1 min-w-0">
{a.assignmentNumber && (
<div className="text-xs font-semibold text-brand uppercase tracking-wide leading-none mb-0.5">
{a.assignmentNumber}
</div>
)}
<div className="font-semibold text-gray-800 truncate">{a.title}</div>
<div className="text-sm text-gray-500">{a.client}</div>
<div className="text-xs text-gray-400 mt-0.5">
{a.typeName} · {a.instituteeNames.join(', ')}
</div>
{a.archivedAt && (
<div className="text-xs text-gray-400 mt-1">
Archiviert am {new Date(a.archivedAt).toLocaleDateString('de-DE')}
</div>
)}
</div>
<button onClick={() => unarchive(a.id!)}
className="flex-shrink-0 text-xs bg-white border border-gray-200 text-gray-600 px-2.5 py-1 rounded-lg hover:bg-gray-100">
↺ Aus Archiv zurückholen
</button>
</div>
</div>
))}
</div>
)
}
+86 -20
View File
@@ -1,6 +1,11 @@
import { useEffect, useState } from 'react'
import { useNavigate } from 'react-router-dom'
import { db, type AssignmentType, type PhaseTemplate, type Consultant, type Group } from '../db'
import {
type AssignmentType, type PhaseTemplate, type Consultant, type Group,
listAssignmentTypes, listPhaseTemplatesForType,
listGroups, listActiveConsultants, addGroup, addConsultant,
addAssignment, getOrSeedRequirePlannedDates,
} from '../db'
export default function AssignmentCreate() {
const navigate = useNavigate()
@@ -12,31 +17,39 @@ export default function AssignmentCreate() {
title: '',
client: '',
leadName: '',
assignmentNumber: '',
assignmentTypeId: 0,
selectedGroupId: 0,
instituteeIds: [] as number[],
plannedStart: '',
plannedEnd: '',
})
const [requirePlannedDates, setRequirePlannedDates] = useState(false)
// Inline Berater-Anlage
const [showAddInstitutee, setShowAddInstitutee] = useState(false)
const [newFirst, setNewFirst] = useState('')
const [newLast, setNewLast] = useState('')
const [newEmail, setNewEmail] = useState('')
const [createError, setCreateError] = useState<string | null>(null)
const reload = async () => {
const [t, g, c] = await Promise.all([
db.assignmentTypes.toArray(),
db.groups.toArray(),
db.consultants.toArray(),
const [t, g, c, requireDates] = await Promise.all([
listAssignmentTypes(),
listGroups(),
listActiveConsultants(),
getOrSeedRequirePlannedDates(),
])
setTypes(t)
setGroups(g)
setConsultants(c)
setRequirePlannedDates(requireDates)
}
useEffect(() => { reload() }, [])
useEffect(() => {
if (!form.assignmentTypeId) { setPhases([]); return }
db.phaseTemplates.where('assignmentTypeId').equals(form.assignmentTypeId).sortBy('order').then(setPhases)
listPhaseTemplatesForType(form.assignmentTypeId).then(setPhases)
}, [form.assignmentTypeId])
const groupConsultants = consultants.filter(c => c.groupId === form.selectedGroupId)
@@ -50,36 +63,57 @@ export default function AssignmentCreate() {
}))
const addInstituteeInline = async () => {
if (!newFirst.trim() || !newLast.trim()) return
if (!newFirst.trim() || !newLast.trim() || !newEmail.trim()) return
let groupId = form.selectedGroupId
if (!groupId) {
// Erstelle eine Standardgruppe falls keine vorhanden
groupId = await db.groups.add({ name: 'Neue Gruppe', cohortYear: new Date().getFullYear() })
groupId = await addGroup({ name: 'Neue Gruppe', cohortYear: new Date().getFullYear() })
setForm(p => ({ ...p, selectedGroupId: groupId }))
}
const id = await db.consultants.add({ groupId, firstName: newFirst.trim(), lastName: newLast.trim() })
await reload()
setForm(p => ({ ...p, instituteeIds: [...p.instituteeIds, id] }))
setNewFirst('')
setNewLast('')
setShowAddInstitutee(false)
try {
setCreateError(null)
const id = await addConsultant({
groupId,
firstName: newFirst.trim(),
lastName: newLast.trim(),
email: newEmail.trim(),
})
await reload()
setForm(p => ({ ...p, instituteeIds: [...p.instituteeIds, id] }))
setNewFirst('')
setNewLast('')
setNewEmail('')
setShowAddInstitutee(false)
} catch (e) {
setCreateError(e instanceof Error ? e.message : String(e))
}
}
const create = async () => {
if (!form.title.trim() || !form.client.trim() || !form.assignmentTypeId || form.instituteeIds.length === 0) return
const id = await db.assignments.add({
if (!form.title.trim() || !form.client.trim() || !form.assignmentNumber.trim() || !form.assignmentTypeId || form.instituteeIds.length === 0) return
if (requirePlannedDates && (!form.plannedStart || !form.plannedEnd)) return
const id = await addAssignment({
title: form.title,
client: form.client,
leadName: form.leadName,
assignmentNumber: form.assignmentNumber.trim(),
assignmentTypeId: form.assignmentTypeId,
instituteeIds: form.instituteeIds,
status: 'active',
createdAt: new Date().toISOString(),
plannedStart: form.plannedStart || undefined,
plannedEnd: form.plannedEnd || undefined,
})
navigate(`/assignment/${id}`)
}
const canCreate = form.title.trim() && form.client.trim() && form.assignmentTypeId && form.instituteeIds.length > 0
const canCreate = !!(
form.title.trim() &&
form.client.trim() &&
form.assignmentNumber.trim() &&
form.assignmentTypeId &&
form.instituteeIds.length > 0 &&
(!requirePlannedDates || (form.plannedStart && form.plannedEnd))
)
const selectedInstitutees = consultants.filter(c => form.instituteeIds.includes(c.id!))
return (
@@ -88,6 +122,9 @@ export default function AssignmentCreate() {
{/* Basisdaten */}
<div className="bg-white rounded-xl shadow-sm border border-gray-100 p-4 space-y-3">
<input className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
placeholder="Assignment-Nummer (Pflichtfeld)" value={form.assignmentNumber}
onChange={e => setForm(p => ({ ...p, assignmentNumber: e.target.value }))} />
<input className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
placeholder="Titel des Assignments" value={form.title}
onChange={e => setForm(p => ({ ...p, title: e.target.value }))} />
@@ -103,6 +140,30 @@ export default function AssignmentCreate() {
<option value={0}>Assignment-Typ wählen…</option>
{types.map(t => <option key={t.id} value={t.id}>{t.name}</option>)}
</select>
<div className="grid grid-cols-2 gap-2">
<div className="space-y-1">
<label className="text-xs font-medium text-gray-500">
Geplanter Beginn{requirePlannedDates ? ' *' : ''}
</label>
<input
type="date"
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
value={form.plannedStart}
onChange={e => setForm(p => ({ ...p, plannedStart: e.target.value }))}
/>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-gray-500">
Geplantes Ende{requirePlannedDates ? ' *' : ''}
</label>
<input
type="date"
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
value={form.plannedEnd}
onChange={e => setForm(p => ({ ...p, plannedEnd: e.target.value }))}
/>
</div>
</div>
</div>
{/* Phase-Preview */}
@@ -144,6 +205,11 @@ export default function AssignmentCreate() {
onChange={e => setNewLast(e.target.value)}
onKeyDown={e => e.key === 'Enter' && addInstituteeInline()} />
</div>
<input className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
placeholder="E-Mail *" type="email" value={newEmail}
onChange={e => setNewEmail(e.target.value)}
onKeyDown={e => e.key === 'Enter' && addInstituteeInline()} />
{createError && <p className="text-xs text-red-600">{createError}</p>}
{groups.length > 0 && (
<select className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm"
value={form.selectedGroupId || ''}
@@ -154,11 +220,11 @@ export default function AssignmentCreate() {
)}
<div className="flex gap-2">
<button onClick={addInstituteeInline}
disabled={!newFirst.trim() || !newLast.trim()}
disabled={!newFirst.trim() || !newLast.trim() || !newEmail.trim()}
className="flex-1 py-2 rounded-lg text-sm font-medium bg-brand text-white disabled:bg-gray-200 disabled:text-gray-400">
Hinzufügen
</button>
<button onClick={() => { setShowAddInstitutee(false); setNewFirst(''); setNewLast('') }}
<button onClick={() => { setShowAddInstitutee(false); setNewFirst(''); setNewLast(''); setNewEmail(''); setCreateError(null) }}
className="px-4 py-2 rounded-lg text-sm border border-gray-200 text-gray-500">
Abbrechen
</button>
+189 -64
View File
@@ -1,19 +1,23 @@
import { useEffect, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom'
import { db, type Assignment, type AssignmentType, type PhaseTemplate, type MeetingInstance, type Consultant, type Assessment, type FeedbackRating, type FeedbackCategory, type FeedbackCriterionItem } from '../db'
import {
type Assignment, type AssignmentType, type PhaseTemplate, type MeetingInstance, type Consultant, type Assessment, type RatingScore, type FeedbackCategory, type FeedbackCriterionItem,
getAssignment, getAssignmentType,
listPhaseTemplatesForType,
listMeetingInstancesForAssignment, addMeetingInstance, softDeleteMeetingInstance, restoreMeetingInstance, hardDeleteMeetingInstance,
getConsultantsByIds,
listAssessmentsForMeetings,
listMeetingCategoryRatingsForMeetings,
loadFeedbackStructure, resolveVisibleStructure,
isAssignmentFeedbackComplete, softDeleteAssignment, archiveAssignment,
} from '../db'
import { exportMeetingAsMarkdown, exportMeetingAsJson, downloadFile } from '../utils/meetingExport'
const RATING_BG: Record<FeedbackRating, string> = {
na: 'bg-gray-400 text-white',
not_client_ready: 'bg-red-500 text-white',
partially_client_ready: 'bg-orange-500 text-white',
nearly_client_ready: 'bg-green-400 text-white',
client_ready: 'bg-green-700 text-white',
}
const NUM_MAP: Record<FeedbackRating, number> = { na: 0, not_client_ready: 1, partially_client_ready: 2, nearly_client_ready: 3, client_ready: 4 }
const avgToRating = (avg: number): FeedbackRating =>
avg < 1.5 ? 'not_client_ready' : avg < 2.5 ? 'partially_client_ready' : avg < 3.5 ? 'nearly_client_ready' : 'client_ready'
import { downloadAssignmentTransfer } from '../utils/assignmentTransfer'
import { exportAssignmentReportPdf, exportInstituteeFeedbackPdf } from '../utils/pdfExport'
import { resolveScoreStyle } from '../config/constants'
import { resolveCategoryChipScore } from '../utils/meetingCategoryScore'
import { useRatingColorBands } from '../hooks/useRatingColorBands'
import type { MeetingCategoryRating } from '../db'
interface PhaseRow {
template: PhaseTemplate
@@ -37,19 +41,28 @@ export default function AssignmentDetail() {
const [confirmSoftDelete, setConfirmSoftDelete] = useState<number | null>(null)
const [confirmHardDelete, setConfirmHardDelete] = useState<number | null>(null)
const [allAssessments, setAllAssessments] = useState<Assessment[]>([])
const [categoryRatings, setCategoryRatings] = useState<MeetingCategoryRating[]>([])
const [fbCategories, setFbCategories] = useState<FeedbackCategory[]>([])
const [fbItems, setFbItems] = useState<FeedbackCriterionItem[]>([])
const colorBands = useRatingColorBands()
const [feedbackComplete, setFeedbackComplete] = useState(false)
const [confirmAssignmentTrash, setConfirmAssignmentTrash] = useState(false)
const [confirmAssignmentArchive, setConfirmAssignmentArchive] = useState(false)
const [pdfExportingKey, setPdfExportingKey] = useState<string | null>(null)
const [transferExporting, setTransferExporting] = useState(false)
const [transferMsg, setTransferMsg] = useState('')
const load = async () => {
const a = await db.assignments.get(assignmentId)
const a = await getAssignment(assignmentId)
if (!a) return
setAssignment(a)
setFeedbackComplete(a.status === 'done' ? await isAssignmentFeedbackComplete(assignmentId) : false)
const [aType, templates, instances, cons] = await Promise.all([
db.assignmentTypes.get(a.assignmentTypeId),
db.phaseTemplates.where('assignmentTypeId').equals(a.assignmentTypeId).sortBy('order'),
db.meetingInstances.where('assignmentId').equals(assignmentId).toArray(),
db.consultants.where('id').anyOf(a.instituteeIds).toArray(),
getAssignmentType(a.assignmentTypeId),
listPhaseTemplatesForType(a.assignmentTypeId),
listMeetingInstancesForAssignment(assignmentId),
getConsultantsByIds(a.instituteeIds),
])
setAssignmentType(aType ?? null)
@@ -63,24 +76,23 @@ export default function AssignmentDetail() {
instances: active.filter(i => i.phaseTemplateId === t.id).sort((a, b) => a.phaseIndex - b.phaseIndex),
})))
const instIds = active.map(i => i.id!)
const [asmts, allCats, allItems, aType2] = await Promise.all([
instIds.length > 0 ? db.assessments.where('meetingInstanceId').anyOf(instIds).toArray() : Promise.resolve([]),
db.feedbackCategories.toArray(),
db.feedbackCriterionItems.toArray(),
db.assignmentTypes.get(a.assignmentTypeId),
const [asmts, catRatings, structure, aType2] = await Promise.all([
listAssessmentsForMeetings(instIds),
listMeetingCategoryRatingsForMeetings(instIds),
loadFeedbackStructure(),
getAssignmentType(a.assignmentTypeId),
])
setAllAssessments(asmts)
const itemFilter = aType2?.criteriaIds?.length ? new Set(aType2.criteriaIds) : null
const filteredItems = itemFilter ? allItems.filter(i => itemFilter.has(i.id!)) : allItems
setFbItems(filteredItems)
const visibleCatIds = new Set(filteredItems.map(i => i.categoryId))
setFbCategories(itemFilter ? allCats.filter(c => visibleCatIds.has(c.id!)) : allCats)
setCategoryRatings(catRatings)
const visible = resolveVisibleStructure(structure.dimensions, structure.categories, structure.items, aType2?.criteriaIds)
setFbItems(visible.items)
setFbCategories(visible.categories)
}
useEffect(() => { load() }, [assignmentId])
const startMeeting = async (templateId: number, existingCount: number) => {
const mid = await db.meetingInstances.add({
const mid = await addMeetingInstance({
assignmentId,
phaseTemplateId: templateId,
phaseIndex: existingCount + 1,
@@ -113,28 +125,64 @@ export default function AssignmentDetail() {
}
const softDeleteMeeting = async (instId: number) => {
await db.meetingInstances.update(instId, { deletedAt: new Date().toISOString() })
await softDeleteMeetingInstance(instId)
setConfirmSoftDelete(null)
await load()
}
const restoreMeeting = async (instId: number) => {
await db.meetingInstances.update(instId, { deletedAt: undefined })
await restoreMeetingInstance(instId)
await load()
}
const hardDeleteMeeting = async (instId: number) => {
await db.conversationSkillScores
.where('conversationEntryId')
.anyOf((await db.conversationEntries.where('meetingInstanceId').equals(instId).primaryKeys()))
.delete()
await db.conversationEntries.where('meetingInstanceId').equals(instId).delete()
await db.assessments.where('meetingInstanceId').equals(instId).delete()
await db.meetingInstances.delete(instId)
await hardDeleteMeetingInstance(instId)
setConfirmHardDelete(null)
await load()
}
const trashAssignment = async () => {
await softDeleteAssignment(assignmentId)
navigate('/')
}
const archiveThisAssignment = async () => {
await archiveAssignment(assignmentId)
navigate('/')
}
const handleExportReportPdf = async () => {
setPdfExportingKey('report')
try {
await exportAssignmentReportPdf(assignmentId)
} finally {
setPdfExportingKey(null)
}
}
const handleExportInstituteeFeedbackPdf = async (instituteeId: number) => {
const key = `inst-${instituteeId}`
setPdfExportingKey(key)
try {
await exportInstituteeFeedbackPdf(assignmentId, instituteeId)
} finally {
setPdfExportingKey(null)
}
}
const handleExportTransfer = async () => {
setTransferExporting(true)
setTransferMsg('')
try {
await downloadAssignmentTransfer(assignmentId)
setTransferMsg('Übergabe-Datei heruntergeladen (inkl. Berater, Meetings, Checklisten, Notizen).')
} catch (e) {
setTransferMsg(e instanceof Error ? e.message : 'Export fehlgeschlagen')
} finally {
setTransferExporting(false)
}
}
const statusBadge = (status: MeetingInstance['status']) => {
const map = {
planned: 'bg-yellow-100 text-yellow-700',
@@ -158,18 +206,90 @@ export default function AssignmentDetail() {
)}
<h1 className="text-xl font-bold text-gray-800 leading-tight">{assignment.title}</h1>
</div>
<button
onClick={() => navigate(`/assignment/${assignmentId}/edit`)}
className="flex-shrink-0 text-xs px-3 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition">
✏️ Bearbeiten
</button>
<div className="flex-shrink-0 flex gap-1.5 flex-wrap justify-end">
<button
onClick={() => navigate(`/assignment/${assignmentId}/history`)}
className="text-xs px-3 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition">
📜 Gesamtprotokoll
</button>
<button
onClick={handleExportReportPdf}
disabled={pdfExportingKey === 'report'}
title="Gesamtprotokoll + Feedback als PDF"
className="text-xs px-3 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition disabled:opacity-50">
{pdfExportingKey === 'report' ? '⏳' : '⬇ PDF'}
</button>
<button
onClick={handleExportTransfer}
disabled={transferExporting}
title="Assignment inkl. Notizen, Checklisten und Beratern für Lead-Übergabe exportieren"
className="text-xs px-3 py-1.5 border border-brand/30 rounded-lg text-brand hover:bg-brand/5 transition disabled:opacity-50">
{transferExporting ? '⏳' : '↔ Übergabe'}
</button>
<button
onClick={() => navigate(`/assignment/${assignmentId}/edit`)}
className="text-xs px-3 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition">
✏️ Bearbeiten
</button>
</div>
</div>
<div className="text-sm text-gray-500">{assignment.client} · {assignmentType?.name}</div>
<div className="text-xs text-gray-400 mt-1">
{institutees.map(c => `${c.firstName} ${c.lastName}`).join(', ')}
</div>
{transferMsg && (
<div className="mt-2 text-xs text-brand bg-brand/5 border border-brand/20 rounded-lg px-3 py-2">
{transferMsg}
</div>
)}
</div>
{/* Assignment-Aktionen (nur für abgeschlossene Assignments) */}
{assignment.status === 'done' && (
<div className="bg-white rounded-xl shadow-sm border border-gray-100 p-4 space-y-2">
<span className="text-sm font-semibold text-gray-700">Assignment-Aktionen</span>
<div className="flex gap-2 flex-wrap">
<button
onClick={() => setConfirmAssignmentTrash(p => !p)}
disabled={!feedbackComplete}
title={!feedbackComplete ? 'Erst möglich, wenn für alle Institutees ein finales Feedback vorliegt' : undefined}
className={`text-xs px-3 py-1.5 rounded-lg font-medium ${
feedbackComplete ? 'bg-red-50 text-red-600 border border-red-200 hover:bg-red-100' : 'bg-gray-100 text-gray-400 cursor-not-allowed'
}`}>
🗑 In Papierkorb verschieben
</button>
<button
onClick={() => setConfirmAssignmentArchive(p => !p)}
className="text-xs px-3 py-1.5 rounded-lg font-medium bg-gray-50 text-gray-600 border border-gray-200 hover:bg-gray-100">
🗄 Archivieren
</button>
</div>
{!feedbackComplete && (
<div className="text-xs text-gray-400">
Löschen erst möglich, sobald für alle Institutees ein finales Feedback vorliegt.
</div>
)}
{confirmAssignmentTrash && (
<div className="bg-red-50 border border-red-200 rounded-lg px-3 py-2.5 flex items-center justify-between gap-2">
<span className="text-xs text-red-700">Assignment in den Papierkorb verschieben?</span>
<div className="flex gap-1.5">
<button onClick={trashAssignment} className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg font-medium">Ja</button>
<button onClick={() => setConfirmAssignmentTrash(false)} className="text-xs border border-gray-200 text-gray-500 px-2.5 py-1 rounded-lg">Nein</button>
</div>
</div>
)}
{confirmAssignmentArchive && (
<div className="bg-gray-50 border border-gray-200 rounded-lg px-3 py-2.5 flex items-center justify-between gap-2">
<span className="text-xs text-gray-600">Assignment archivieren?</span>
<div className="flex gap-1.5">
<button onClick={archiveThisAssignment} className="text-xs bg-gray-700 text-white px-2.5 py-1 rounded-lg font-medium">Ja</button>
<button onClick={() => setConfirmAssignmentArchive(false)} className="text-xs border border-gray-200 text-gray-500 px-2.5 py-1 rounded-lg">Nein</button>
</div>
</div>
)}
</div>
)}
{/* Ad-hoc Meeting */}
<div className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<div className="flex items-center justify-between">
@@ -204,11 +324,20 @@ export default function AssignmentDetail() {
<span className="text-sm text-amber-800 font-medium">Feedback-Entwürfe</span>
<div className="flex gap-2 flex-wrap">
{institutees.map(c => (
<button key={c.id}
onClick={() => navigate(`/assignment/${assignmentId}/feedback/${c.id}`)}
className="text-xs bg-amber-600 text-white px-3 py-1 rounded-lg">
{c.firstName}
</button>
<div key={c.id} className="flex items-center gap-1">
<button
onClick={() => navigate(`/assignment/${assignmentId}/feedback/${c.id}`)}
className="text-xs bg-amber-600 text-white px-3 py-1 rounded-lg">
{c.firstName}
</button>
<button
onClick={() => handleExportInstituteeFeedbackPdf(c.id!)}
disabled={pdfExportingKey === `inst-${c.id}`}
title={`Feedback für ${c.firstName} als PDF`}
className="text-xs bg-amber-100 text-amber-700 px-2 py-1 rounded-lg disabled:opacity-50">
{pdfExportingKey === `inst-${c.id}` ? '⏳' : '⬇'}
</button>
</div>
))}
</div>
</div>
@@ -258,28 +387,24 @@ export default function AssignmentDetail() {
{institutees.map(c => {
const chips = fbCategories.map(cat => {
const catItems = fbItems.filter(i => i.categoryId === cat.id)
const scored = catItems.map(item => {
const asmt = allAssessments.find(a =>
a.meetingInstanceId === inst.id &&
a.instituteeId === c.id &&
a.criteriaId === item.id &&
a.score !== null && a.score !== 'na'
)
return asmt ? { score: asmt.score as FeedbackRating, w: item.weight ?? 1 } : null
}).filter(Boolean) as { score: FeedbackRating; w: number }[]
if (scored.length === 0) return null
const wSum = scored.reduce((s, x) => s + x.w, 0)
const avg = scored.reduce((s, x) => s + NUM_MAP[x.score] * x.w, 0) / wSum
return { cat, mode: avgToRating(avg) }
}).filter(Boolean) as { cat: FeedbackCategory; mode: FeedbackRating }[]
const mode = resolveCategoryChipScore({
meetingId: inst.id!,
instituteeId: c.id!,
categoryId: cat.id!,
categoryRatings,
assessments: allAssessments,
catItems,
})
return mode ? { cat, mode } : null
}).filter(Boolean) as { cat: FeedbackCategory; mode: RatingScore }[]
if (chips.length === 0) return null
return (
<div key={c.id} className="mt-1">
<span className="text-xs text-gray-400 mr-1">{c.firstName}:</span>
{chips.map(({ cat, mode }) => (
<span key={cat.id} className={`inline-block text-xs px-2 py-0.5 rounded font-medium mr-1 ${RATING_BG[mode]}`}>
{cat.name}
<span key={cat.id} className={`inline-block text-xs px-2 py-0.5 rounded font-medium mr-1 tabular-nums ${resolveScoreStyle(mode, colorBands).active}`}>
{cat.name} {mode}
</span>
))}
</div>
+35 -6
View File
@@ -1,6 +1,9 @@
import { useEffect, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom'
import { db, type Assignment, type AssignmentType, type Consultant } from '../db'
import {
type Assignment, type AssignmentType, type Consultant,
getAssignment, updateAssignment, listAssignmentTypes, listConsultants,
} from '../db'
export default function AssignmentEdit() {
const { id } = useParams()
@@ -21,15 +24,17 @@ export default function AssignmentEdit() {
const [status, setStatus] = useState<'active' | 'done'>('active')
const [instituteeIds, setInstituteeIds] = useState<number[]>([])
const [instituteeEnrollments, setInstituteeEnrollments] = useState<Array<{ instituteeId: number; from?: string; to?: string }>>([])
const [plannedStart, setPlannedStart] = useState('')
const [plannedEnd, setPlannedEnd] = useState('')
const [typeChanged, setTypeChanged] = useState(false)
const [addInstituteeId, setAddInstituteeId] = useState(0)
useEffect(() => {
const loadData = async () => {
const [a, types, cons] = await Promise.all([
db.assignments.get(assignmentId),
db.assignmentTypes.toArray(),
db.consultants.toArray(),
getAssignment(assignmentId),
listAssignmentTypes(),
listConsultants(),
])
if (!a) return
setAssignment(a)
@@ -45,12 +50,14 @@ export default function AssignmentEdit() {
setStatus(a.status)
setInstituteeIds(a.instituteeIds ?? [])
setInstituteeEnrollments(a.instituteeEnrollments ?? [])
setPlannedStart(a.plannedStart?.slice(0, 10) ?? '')
setPlannedEnd(a.plannedEnd?.slice(0, 10) ?? '')
}
loadData()
}, [assignmentId])
const handleSave = async () => {
await db.assignments.update(assignmentId, {
await updateAssignment(assignmentId, {
assignmentNumber: assignmentNumber.trim() || undefined,
title,
client,
@@ -60,6 +67,8 @@ export default function AssignmentEdit() {
status,
instituteeIds,
instituteeEnrollments,
plannedStart: plannedStart || undefined,
plannedEnd: plannedEnd || undefined,
})
navigate(`/assignment/${assignmentId}`)
}
@@ -87,7 +96,7 @@ export default function AssignmentEdit() {
)
}
const availableConsultants = allConsultants.filter(c => !instituteeIds.includes(c.id!))
const availableConsultants = allConsultants.filter(c => !instituteeIds.includes(c.id!) && !c.archivedAt)
if (!assignment) return <div className="text-center py-10 text-gray-400">Lädt…</div>
@@ -136,6 +145,26 @@ export default function AssignmentEdit() {
onChange={e => setDescription(e.target.value)}
/>
</div>
<div className="grid grid-cols-2 gap-2">
<div className="space-y-1">
<label className="text-xs font-medium text-gray-500">Geplanter Beginn</label>
<input
type="date"
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
value={plannedStart}
onChange={e => setPlannedStart(e.target.value)}
/>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-gray-500">Geplantes Ende</label>
<input
type="date"
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm focus:outline-none focus:border-brand"
value={plannedEnd}
onChange={e => setPlannedEnd(e.target.value)}
/>
</div>
</div>
<div className="space-y-1">
<label className="text-xs font-medium text-gray-500">Assignment-Typ</label>
<select
File diff suppressed because it is too large. Load diff
+97
View File
@@ -0,0 +1,97 @@
import { useEffect, useState } from 'react'
import { useNavigate } from 'react-router-dom'
import {
listAssignmentsWithDetails, restoreAssignment, hardDeleteAssignment,
type AssignmentWithDetails,
} from '../db'
const TRASH_RETENTION_DAYS = 30
export default function AssignmentTrash() {
const [assignments, setAssignments] = useState<AssignmentWithDetails[]>([])
const [confirmHardDelete, setConfirmHardDelete] = useState<number | null>(null)
const navigate = useNavigate()
const load = () => { listAssignmentsWithDetails().then(setAssignments) }
useEffect(() => { load() }, [])
const trashed = assignments.filter(a => a.deletedAt)
const restore = async (id: number) => {
await restoreAssignment(id)
load()
}
const hardDelete = async (id: number) => {
await hardDeleteAssignment(id)
setConfirmHardDelete(null)
load()
}
const remainingDays = (deletedAt: string) => {
const elapsedDays = Math.floor((Date.now() - new Date(deletedAt).getTime()) / 86_400_000)
return Math.max(0, TRASH_RETENTION_DAYS - elapsedDays)
}
return (
<div className="space-y-3">
<button onClick={() => navigate('/')} className="text-sm text-brand mb-2 block">← Zurück</button>
<h1 className="text-xl font-bold text-gray-800">🗑 Papierkorb</h1>
{trashed.length === 0 && (
<p className="text-gray-400 text-sm text-center py-8">Papierkorb ist leer.</p>
)}
{trashed.map(a => (
<div key={a.id} className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<div className="flex items-start justify-between gap-3">
<div className="flex-1 min-w-0">
{a.assignmentNumber && (
<div className="text-xs font-semibold text-brand uppercase tracking-wide leading-none mb-0.5">
{a.assignmentNumber}
</div>
)}
<div className="font-semibold text-gray-800 truncate">{a.title}</div>
<div className="text-sm text-gray-500">{a.client}</div>
<div className="text-xs text-gray-400 mt-0.5">
{a.typeName} · {a.instituteeNames.join(', ')}
</div>
{a.deletedAt && (
<div className="text-xs text-gray-400 mt-1">
Gelöscht am {new Date(a.deletedAt).toLocaleDateString('de-DE')} · noch {remainingDays(a.deletedAt)} Tage bis zur endgültigen Löschung
</div>
)}
</div>
<div className="flex flex-col gap-1.5 items-end flex-shrink-0">
<button onClick={() => restore(a.id!)}
className="text-xs bg-white border border-gray-200 text-gray-600 px-2.5 py-1 rounded-lg hover:bg-gray-100">
↺ Wiederherstellen
</button>
<button onClick={() => setConfirmHardDelete(confirmHardDelete === a.id ? null : a.id!)}
className="text-xs text-red-400 hover:text-red-600 px-2 py-1">
✕ Endgültig löschen
</button>
</div>
</div>
{confirmHardDelete === a.id && (
<div className="mt-2 bg-red-50 border border-red-200 rounded-lg p-3 space-y-2">
<div className="text-xs text-red-700 font-medium">
Endgültig löschen? Alle Meetings, Protokolle und Feedback-Daten dieses Assignments werden unwiderruflich entfernt.
</div>
<div className="flex gap-2">
<button onClick={() => hardDelete(a.id!)}
className="flex-1 py-1.5 rounded-lg text-xs font-medium bg-red-600 text-white">
Endgültig löschen
</button>
<button onClick={() => setConfirmHardDelete(null)}
className="px-3 py-1.5 rounded-lg text-xs border border-gray-200 text-gray-500">
Abbrechen
</button>
</div>
</div>
)}
</div>
))}
</div>
)
}
+475 -44
View File
@@ -1,7 +1,37 @@
import { useEffect, useState } from 'react'
import { db, type AssignmentType, type PhaseTemplate, type FeedbackDimension, type FeedbackCategory, type FeedbackCriterionItem } from '../db'
import {
type AssignmentType, type PhaseTemplate, type FeedbackDimension, type FeedbackCategory, type FeedbackCriterionItem,
type ChecklistItemDef,
listAssignmentTypes, listPhaseTemplates, loadFeedbackStructure, resolveVisibleStructure,
addAssignmentType, updateAssignmentType, deleteAssignmentType,
addPhaseTemplate, updatePhaseTemplate, deletePhaseTemplate,
listChecklistItemDefsForPhaseTemplate, addChecklistItemDef, updateChecklistItemDef, deleteChecklistItemDef,
getGlobalLineTagCorpus, getOrSeedChecklistTaggingPromptTemplate,
} from '../db'
import { exportAssignmentTypesReportAsMarkdown } from '../utils/structureExport'
import { exportAssignmentTypesReportPdf } from '../utils/pdfExport'
import { criterionOptionGroups } from '../utils/criterionOptions'
import { getAiSettings, callOpenRouter } from '../utils/aiClient'
import { runChecklistTaggingAnalysis } from '../utils/checklistTagging'
import { criterionHoverTitle } from './meeting/CriterionTagPicker'
import type { ChecklistScoreContribution } from '../db/types'
import {
ASSIGNMENT_TYPE_COLOR_PRESETS,
DEFAULT_ASSIGNMENT_TYPE_COLOR,
} from '../config/constants'
import {
getOrSeedRequirePlannedDates,
saveRequirePlannedDates,
} from '../db'
const SCORE_CONTRIBUTION_OPTIONS: { value: ChecklistScoreContribution; label: string }[] = [
{ value: 'equal', label: 'Ø gleich' },
{ value: 'primary', label: 'primär' },
{ value: 'weighted', label: '×2' },
]
export default function AssignmentTypeConfig() {
const [exportingPdf, setExportingPdf] = useState(false)
const [types, setTypes] = useState<AssignmentType[]>([])
const [templates, setTemplates] = useState<PhaseTemplate[]>([])
const [dimensions, setDimensions] = useState<FeedbackDimension[]>([])
@@ -14,22 +44,37 @@ export default function AssignmentTypeConfig() {
const [typeError, setTypeError] = useState<Record<number, string>>({})
const [newPhase, setNewPhase] = useState<Record<number, {
label: string; withWhom: 'lead' | 'client'
isRepeatable: boolean; hasConversation: boolean; hasAssessment: boolean
isRepeatable: boolean; hasConversation: boolean; hasAssessment: boolean; hasChecklist: boolean
}>>({})
const [checklistItems, setChecklistItems] = useState<ChecklistItemDef[]>([])
const [expandedChecklist, setExpandedChecklist] = useState<Set<number>>(new Set())
const [newChecklistItem, setNewChecklistItem] = useState<Record<number, {
label: string; scope: 'perInstitutee' | 'meetingWide'; linkedCriterionItemId: string
}>>({})
const [analyzingChecklistPhaseId, setAnalyzingChecklistPhaseId] = useState<number | null>(null)
const [checklistConfigMsg, setChecklistConfigMsg] = useState('')
const [checklistConfigRaw, setChecklistConfigRaw] = useState('')
const [checklistConfigRawOpen, setChecklistConfigRawOpen] = useState(false)
/** checklistItemDef.id → priorisierte Kriterium-IDs aus letzter KI-Analyse dieser Phase. */
const [checklistAiSuggestions, setChecklistAiSuggestions] = useState<Record<number, number[]>>({})
const [requirePlannedDates, setRequirePlannedDates] = useState(false)
const [plannedDatesSaved, setPlannedDatesSaved] = useState(false)
const load = async () => {
const [t, tmpl, dims, cats, itms] = await Promise.all([
db.assignmentTypes.toArray(),
db.phaseTemplates.toArray(),
db.feedbackDimensions.orderBy('order').toArray(),
db.feedbackCategories.orderBy('order').toArray(),
db.feedbackCriterionItems.orderBy('order').toArray(),
const [t, tmpl, structure, requireDates] = await Promise.all([
listAssignmentTypes(),
listPhaseTemplates(),
loadFeedbackStructure(),
getOrSeedRequirePlannedDates(),
])
setTypes(t)
setTemplates(tmpl)
setDimensions(dims)
setCategories(cats)
setItems(itms)
setDimensions(structure.dimensions)
setCategories(structure.categories)
setItems(structure.items)
setRequirePlannedDates(requireDates)
const checklistLists = await Promise.all(tmpl.map(p => listChecklistItemDefsForPhaseTemplate(p.id!)))
setChecklistItems(checklistLists.flat())
}
useEffect(() => { load() }, [])
@@ -39,25 +84,37 @@ export default function AssignmentTypeConfig() {
const addType = async () => {
const name = newTypeName.trim()
if (!name) return
const id = await db.assignmentTypes.add({ name, defaultPhaseKeys: [], criteriaIds: [] })
const color = ASSIGNMENT_TYPE_COLOR_PRESETS[types.length % ASSIGNMENT_TYPE_COLOR_PRESETS.length]
?? DEFAULT_ASSIGNMENT_TYPE_COLOR
const id = await addAssignmentType({ name, defaultPhaseKeys: [], criteriaIds: [], color })
setNewTypeName('')
await load()
setExpanded(id)
}
const updateTypeName = async (id: number, name: string) => {
await db.assignmentTypes.update(id, { name })
await updateAssignmentType(id, { name })
setTypes(prev => prev.map(t => t.id === id ? { ...t, name } : t))
}
const updateTypeColor = async (id: number, color: string) => {
await updateAssignmentType(id, { color })
setTypes(prev => prev.map(t => t.id === id ? { ...t, color } : t))
}
const savePlannedDatesSetting = async (required: boolean) => {
setRequirePlannedDates(required)
await saveRequirePlannedDates(required)
setPlannedDatesSaved(true)
setTimeout(() => setPlannedDatesSaved(false), 2000)
}
const deleteType = async (id: number) => {
const count = await db.assignments.where('assignmentTypeId').equals(id).count()
if (count > 0) {
setTypeError(prev => ({ ...prev, [id]: `Kann nicht gelöscht werden — ${count} Assignment(s) verwenden diesen Typ.` }))
const result = await deleteAssignmentType(id)
if (!result.ok) {
setTypeError(prev => ({ ...prev, [id]: `Kann nicht gelöscht werden — ${result.assignmentCount} Assignment(s) verwenden diesen Typ.` }))
return
}
await db.phaseTemplates.where('assignmentTypeId').equals(id).delete()
await db.assignmentTypes.delete(id)
await load()
}
@@ -66,28 +123,45 @@ export default function AssignmentTypeConfig() {
const toggleItem = async (type: AssignmentType, itemId: number) => {
const current = type.criteriaIds ?? []
const next = current.includes(itemId) ? current.filter(id => id !== itemId) : [...current, itemId]
await db.assignmentTypes.update(type.id!, { criteriaIds: next })
await updateAssignmentType(type.id!, { criteriaIds: next })
setTypes(prev => prev.map(t => t.id === type.id ? { ...t, criteriaIds: next } : t))
}
const toggleAllInCategory = async (type: AssignmentType, catId: number) => {
const catItemIds = items.filter(i => i.categoryId === catId).map(i => i.id!)
const current = type.criteriaIds ?? []
const allSelected = catItemIds.every(id => current.includes(id))
const allSelected = catItemIds.length > 0 && catItemIds.every(id => current.includes(id))
const next = allSelected
? current.filter(id => !catItemIds.includes(id))
: [...new Set([...current, ...catItemIds])]
await db.assignmentTypes.update(type.id!, { criteriaIds: next })
await updateAssignmentType(type.id!, { criteriaIds: next })
setTypes(prev => prev.map(t => t.id === type.id ? { ...t, criteriaIds: next } : t))
}
const toggleAllInDimension = async (type: AssignmentType, dimId: number) => {
const dimCatIds = categories.filter(c => c.dimensionId === dimId).map(c => c.id!)
const dimItemIds = items.filter(i => dimCatIds.includes(i.categoryId)).map(i => i.id!)
const current = type.criteriaIds ?? []
const allSelected = dimItemIds.length > 0 && dimItemIds.every(id => current.includes(id))
const next = allSelected
? current.filter(id => !dimItemIds.includes(id))
: [...new Set([...current, ...dimItemIds])]
await updateAssignmentType(type.id!, { criteriaIds: next })
setTypes(prev => prev.map(t => t.id === type.id ? { ...t, criteriaIds: next } : t))
}
const clearStructureFilter = async (type: AssignmentType) => {
await updateAssignmentType(type.id!, { criteriaIds: [] })
setTypes(prev => prev.map(t => t.id === type.id ? { ...t, criteriaIds: [] } : t))
}
// ── Phasen-Templates ───────────────────────────────────────────────────────
const addPhase = async (typeId: number) => {
const np = newPhase[typeId]
if (!np?.label.trim()) return
const existing = templates.filter(t => t.assignmentTypeId === typeId)
await db.phaseTemplates.add({
await addPhaseTemplate({
assignmentTypeId: typeId,
phaseKey: np.label.trim().toLowerCase().replace(/\s+/g, '_'),
label: np.label.trim(),
@@ -95,25 +169,167 @@ export default function AssignmentTypeConfig() {
isRepeatable: np.isRepeatable,
hasConversation: np.hasConversation,
hasAssessment: np.hasAssessment,
hasChecklist: np.hasChecklist,
criteriaIds: [],
order: existing.length + 1,
})
setNewPhase(prev => ({ ...prev, [typeId]: { label: '', withWhom: 'lead', isRepeatable: false, hasConversation: false, hasAssessment: false } }))
setNewPhase(prev => ({ ...prev, [typeId]: { label: '', withWhom: 'lead', isRepeatable: false, hasConversation: false, hasAssessment: false, hasChecklist: false } }))
await load()
}
const updatePhase = async (id: number, patch: Partial<PhaseTemplate>) => {
await db.phaseTemplates.update(id, patch)
await updatePhaseTemplate(id, patch)
setTemplates(prev => prev.map(t => t.id === id ? { ...t, ...patch } : t))
}
const deletePhase = async (id: number) => {
await db.phaseTemplates.delete(id)
await deletePhaseTemplate(id)
await load()
}
// ── Checkliste pro Phase ───────────────────────────────────────────────────
const addChecklistItem = async (phaseId: number) => {
const nci = newChecklistItem[phaseId]
if (!nci?.label.trim()) return
const existing = checklistItems.filter(c => c.phaseTemplateId === phaseId)
await addChecklistItemDef({
phaseTemplateId: phaseId,
label: nci.label.trim(),
scope: nci.scope,
linkedCriterionItemId: nci.linkedCriterionItemId ? Number(nci.linkedCriterionItemId) : undefined,
order: existing.length + 1,
})
setNewChecklistItem(prev => ({ ...prev, [phaseId]: { label: '', scope: 'perInstitutee', linkedCriterionItemId: '' } }))
await load()
}
const updateChecklistItem = async (id: number, patch: Partial<ChecklistItemDef>) => {
await updateChecklistItemDef(id, patch)
setChecklistItems(prev => prev.map(c => {
if (c.id !== id) return c
const next = { ...c, ...patch }
if (patch.linkedCriterionItemId === null) delete next.linkedCriterionItemId
return next
}))
}
const deleteChecklistItem = async (id: number) => {
await deleteChecklistItemDef(id)
setChecklistItems(prev => prev.filter(c => c.id !== id))
}
const suggestChecklistStandardMappings = async (phaseId: number, type: AssignmentType) => {
const settings = getAiSettings()
if (!settings.apiKey) {
setChecklistConfigMsg('Kein KI-API-Key — bitte unter Config → KI-Prompts hinterlegen.')
return
}
const unmapped = checklistItems
.filter(c => c.phaseTemplateId === phaseId && !c.linkedCriterionItemId && c.label.trim())
if (unmapped.length === 0) {
setChecklistConfigMsg('Alle Checklisten-Punkte dieser Phase haben bereits eine Standard-Zuordnung.')
setTimeout(() => setChecklistConfigMsg(''), 4000)
return
}
setAnalyzingChecklistPhaseId(phaseId)
setChecklistConfigMsg('')
setChecklistConfigRaw('')
setChecklistConfigRawOpen(false)
try {
const [corpus, template] = await Promise.all([
getGlobalLineTagCorpus(),
getOrSeedChecklistTaggingPromptTemplate(),
])
const visible = resolveVisibleStructure(dimensions, categories, items, type.criteriaIds)
const { raw, suggestionsByKey, batchErrors } = await runChecklistTaggingAnalysis(
{
assignmentTypeName: type.name,
dimensions: visible.dimensions,
categories: visible.categories,
items: visible.items,
visibleCriteriaIds: type.criteriaIds,
corpus,
template,
targets: unmapped.map(ci => ({ key: String(ci.id), label: ci.label })),
},
prompt => callOpenRouter(prompt, settings),
)
if (batchErrors.length > 0) {
setChecklistConfigMsg(`Teilfehler: ${batchErrors.join(' · ')}`)
}
let applied = 0
const nextSuggestions: Record<number, number[]> = { ...checklistAiSuggestions }
for (const ci of unmapped) {
const ids = suggestionsByKey.get(String(ci.id)) ?? []
if (ids.length > 0) nextSuggestions[ci.id!] = ids
const topId = ids[0]
if (topId) {
await updateChecklistItemDef(ci.id!, { linkedCriterionItemId: topId })
applied++
}
}
setChecklistAiSuggestions(nextSuggestions)
const checklistLists = await Promise.all(templates.map(p => listChecklistItemDefsForPhaseTemplate(p.id!)))
setChecklistItems(checklistLists.flat())
setChecklistConfigMsg(
applied > 0
? `${applied} Standard-Zuordnung(en) gesetzt (${unmapped.length} Punkt(e) analysiert).`
: `${unmapped.length} Punkt(e) analysiert, aber die KI hat keine Zuordnung geliefert — Rohantwort unten einsehbar.`,
)
if (applied === 0) {
setChecklistConfigRaw(raw)
setChecklistConfigRawOpen(true)
}
setTimeout(() => setChecklistConfigMsg(''), 6000)
} catch (e) {
setChecklistConfigMsg(e instanceof Error ? e.message : 'KI-Analyse fehlgeschlagen.')
} finally {
setAnalyzingChecklistPhaseId(null)
}
}
return (
<div className="space-y-4">
<div className="flex items-center justify-between gap-2">
<h2 className="text-lg font-bold text-gray-800">Assignment-Typen</h2>
<div className="flex gap-1.5 flex-shrink-0">
<button onClick={() => exportAssignmentTypesReportAsMarkdown()}
className="text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition">
⬇ MD
</button>
<button
onClick={async () => { setExportingPdf(true); try { await exportAssignmentTypesReportPdf() } finally { setExportingPdf(false) } }}
disabled={exportingPdf}
className="text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition disabled:opacity-50">
{exportingPdf ? '⏳' : '⬇ PDF'}
</button>
</div>
</div>
<div className="bg-white rounded-xl border border-gray-100 shadow-sm p-4 space-y-2">
<label className="flex items-start gap-3 cursor-pointer">
<input
type="checkbox"
className="mt-1"
checked={requirePlannedDates}
onChange={e => savePlannedDatesSetting(e.target.checked)}
/>
<span>
<span className="text-sm font-medium text-gray-800 block">Plandaten beim Anlegen Pflicht</span>
<span className="text-xs text-gray-500">
Wenn aktiv, müssen Beginn und Ende eines Assignments beim Anlegen gesetzt werden.
</span>
</span>
</label>
{plannedDatesSaved && (
<div className="text-xs text-green-700">Gespeichert.</div>
)}
</div>
{/* Neuer Typ */}
<div className="flex gap-2">
<input
@@ -137,25 +353,57 @@ export default function AssignmentTypeConfig() {
const isOpen = expanded === type.id
const typPhases = templates.filter(t => t.assignmentTypeId === type.id).sort((a, b) => a.order - b.order)
const tab = activeTab[type.id!] ?? 'phases'
const np = newPhase[type.id!] ?? { label: '', withWhom: 'lead' as const, isRepeatable: false, hasConversation: false, hasAssessment: false }
const np = newPhase[type.id!] ?? { label: '', withWhom: 'lead' as const, isRepeatable: false, hasConversation: false, hasAssessment: false, hasChecklist: false }
const selected = type.criteriaIds ?? []
return (
<div key={type.id} className="bg-white rounded-xl border border-gray-100 shadow-sm overflow-hidden">
{/* Header */}
<div className="flex items-center gap-2 px-4 py-3 bg-gray-50 border-b border-gray-100">
<span
className="w-3 h-8 rounded-sm shrink-0"
style={{ backgroundColor: type.color?.trim() || DEFAULT_ASSIGNMENT_TYPE_COLOR }}
title="Typ-Farbe"
/>
<input
className="flex-1 bg-transparent text-sm font-semibold text-gray-800 focus:outline-none border-b border-transparent focus:border-brand py-0.5"
value={type.name}
onChange={e => updateTypeName(type.id!, e.target.value)}
/>
<span className="text-xs text-gray-400">{typPhases.length} Phasen · {selected.length ? `${selected.length} Kriterien` : 'alle Kriterien'}</span>
<span className="text-xs text-gray-400">{typPhases.length} Phasen · {selected.length ? `${selected.length} Kriterien` : 'gesamte Struktur'}</span>
<button onClick={() => setExpanded(isOpen ? null : type.id!)}
className="text-xs text-gray-400 px-1">{isOpen ? '▲' : '▼'}</button>
<button onClick={() => deleteType(type.id!)}
className="text-xs text-red-300 hover:text-red-500 px-1">🗑</button>
</div>
{isOpen && (
<div className="px-4 pt-3 flex flex-wrap items-center gap-2 border-b border-gray-50 pb-3">
<span className="text-xs text-gray-500 shrink-0">Farbe:</span>
{ASSIGNMENT_TYPE_COLOR_PRESETS.map(c => (
<button
key={c}
type="button"
title={c}
onClick={() => updateTypeColor(type.id!, c)}
className={`w-6 h-6 rounded-md border-2 ${
(type.color?.trim() || DEFAULT_ASSIGNMENT_TYPE_COLOR) === c
? 'border-gray-800 scale-110'
: 'border-transparent'
}`}
style={{ backgroundColor: c }}
/>
))}
<input
type="color"
value={type.color?.trim() || DEFAULT_ASSIGNMENT_TYPE_COLOR}
onChange={e => updateTypeColor(type.id!, e.target.value)}
className="w-8 h-6 p-0 border border-gray-200 rounded cursor-pointer bg-transparent"
title="Eigene Farbe"
/>
</div>
)}
{typeError[type.id!] && (
<div className="px-4 py-2 text-xs text-red-600 bg-red-50 border-b border-red-100">
{typeError[type.id!]}
@@ -172,7 +420,7 @@ export default function AssignmentTypeConfig() {
className={`flex-1 py-2 text-xs font-medium transition ${
tab === t ? 'text-brand border-b-2 border-brand' : 'text-gray-400'
}`}>
{t === 'phases' ? `Phasen (${typPhases.length})` : `Kriterien (${selected.length || 'alle'})`}
{t === 'phases' ? `Phasen (${typPhases.length})` : `Struktur (${selected.length || 'alle'})`}
</button>
))}
@@ -215,7 +463,162 @@ export default function AssignmentTypeConfig() {
onChange={e => updatePhase(phase.id!, { hasAssessment: e.target.checked })} />
Bewertung
</label>
<label className="flex items-center gap-1 cursor-pointer">
<input type="checkbox" checked={phase.hasChecklist}
onChange={e => updatePhase(phase.id!, { hasChecklist: e.target.checked })} />
Checkliste
</label>
</div>
{phase.hasChecklist && (() => {
const phaseChecklist = checklistItems
.filter(c => c.phaseTemplateId === phase.id)
.sort((a, b) => a.order - b.order)
const isChecklistOpen = expandedChecklist.has(phase.id!)
const nci = newChecklistItem[phase.id!] ?? { label: '', scope: 'perInstitutee' as const, linkedCriterionItemId: '' }
return (
<div className="border-t border-gray-100 pt-1.5">
<button
onClick={() => setExpandedChecklist(prev => {
const next = new Set(prev)
if (next.has(phase.id!)) next.delete(phase.id!); else next.add(phase.id!)
return next
})}
className="text-xs text-gray-500 font-medium">
🗹 Checkliste ({phaseChecklist.length}) {isChecklistOpen ? '▲' : '▼'}
</button>
{isChecklistOpen && (
<div className="mt-1.5 space-y-1.5">
{phaseChecklist.map(ci => (
<div key={ci.id} className="bg-gray-50 rounded-lg px-2 py-1.5 space-y-1">
<div className="flex items-center gap-1.5">
<input
className="flex-1 text-xs bg-transparent border-b border-transparent focus:border-brand focus:outline-none"
value={ci.label}
onChange={e => updateChecklistItem(ci.id!, { label: e.target.value })}
/>
<select
value={ci.scope}
onChange={e => updateChecklistItem(ci.id!, { scope: e.target.value as 'perInstitutee' | 'meetingWide' })}
className="text-xs border border-gray-200 rounded px-1 py-0.5 bg-white focus:outline-none">
<option value="perInstitutee">pro Institutee</option>
<option value="meetingWide">meeting-weit</option>
</select>
<select
value={ci.linkedCriterionItemId ?? ''}
onChange={e => updateChecklistItem(ci.id!, {
linkedCriterionItemId: e.target.value ? Number(e.target.value) : null,
})}
className="text-xs border border-gray-200 rounded px-1 py-0.5 bg-white focus:outline-none max-w-[180px]"
title={(() => {
if (!ci.linkedCriterionItemId) return undefined
const crit = items.find(i => i.id === ci.linkedCriterionItemId)
if (!crit) return undefined
return criterionHoverTitle(crit, categories.find(c => c.id === crit.categoryId)?.name ?? '')
})()}>
<option value="">— frei —</option>
{criterionOptionGroups(dimensions, categories, items)}
</select>
<select
value={ci.scoreContribution ?? 'equal'}
onChange={e => updateChecklistItem(ci.id!, {
scoreContribution: e.target.value as ChecklistScoreContribution,
})}
title="Wie Checklisten-Score mit Protokoll auf dasselbe Kriterium zusammenfließt"
className="text-xs border border-gray-200 rounded px-1 py-0.5 bg-white focus:outline-none">
{SCORE_CONTRIBUTION_OPTIONS.map(o => (
<option key={o.value} value={o.value}>{o.label}</option>
))}
</select>
<button onClick={() => deleteChecklistItem(ci.id!)}
className="text-red-300 hover:text-red-500 text-xs">×</button>
</div>
{checklistAiSuggestions[ci.id!]?.length ? (
<div className="flex flex-wrap gap-1 pl-0.5">
{checklistAiSuggestions[ci.id!]!.map((critId, idx) => {
const crit = items.find(i => i.id === critId)
if (!crit) return null
const cat = categories.find(c => c.id === crit.categoryId)?.name ?? ''
const active = ci.linkedCriterionItemId === critId
return (
<button
key={critId}
type="button"
title={criterionHoverTitle(crit, cat)}
onClick={() => updateChecklistItem(ci.id!, { linkedCriterionItemId: critId })}
className={`text-[10px] px-1.5 py-0.5 rounded-full border max-w-full text-left whitespace-normal leading-snug ${
active
? 'bg-teal-100 border-teal-300 text-teal-900'
: 'bg-white border-gray-200 text-gray-600 hover:border-teal-200 hover:bg-teal-50'
}`}>
{idx === 0 ? '💡 ' : `${idx + 1}. `}{crit.name}
</button>
)
})}
</div>
) : null}
</div>
))}
<div className="flex items-center gap-1.5">
<input
className="flex-1 border border-gray-200 rounded px-2 py-1 text-xs focus:outline-none focus:border-brand bg-white"
placeholder="Neuer Checklisten-Punkt…"
value={nci.label}
onChange={e => setNewChecklistItem(prev => ({ ...prev, [phase.id!]: { ...nci, label: e.target.value } }))}
onKeyDown={e => e.key === 'Enter' && addChecklistItem(phase.id!)}
/>
<select
value={nci.scope}
onChange={e => setNewChecklistItem(prev => ({ ...prev, [phase.id!]: { ...nci, scope: e.target.value as 'perInstitutee' | 'meetingWide' } }))}
className="text-xs border border-gray-200 rounded px-1 py-1 bg-white focus:outline-none">
<option value="perInstitutee">pro Institutee</option>
<option value="meetingWide">meeting-weit</option>
</select>
<select
value={nci.linkedCriterionItemId}
onChange={e => setNewChecklistItem(prev => ({ ...prev, [phase.id!]: { ...nci, linkedCriterionItemId: e.target.value } }))}
className="text-xs border border-gray-200 rounded px-1 py-1 bg-white focus:outline-none max-w-[140px]">
<option value="">— frei —</option>
{criterionOptionGroups(dimensions, categories, items)}
</select>
<button onClick={() => addChecklistItem(phase.id!)}
className="text-xs bg-brand text-white px-2 py-1 rounded-lg font-medium">+ Punkt</button>
</div>
<div className="flex items-center gap-2 flex-wrap">
<button
onClick={() => suggestChecklistStandardMappings(phase.id!, type)}
disabled={analyzingChecklistPhaseId === phase.id}
className="text-xs bg-teal-50 hover:bg-teal-100 text-teal-800 border border-teal-200 px-2 py-1 rounded-lg font-medium disabled:opacity-50">
{analyzingChecklistPhaseId === phase.id
? '⏳ KI analysiert…'
: '🏷 Standard-Zuordnung (KI)'}
</button>
{checklistConfigMsg && analyzingChecklistPhaseId === null && (
<span className="text-[10px] text-teal-700">{checklistConfigMsg}</span>
)}
</div>
{checklistConfigRaw && checklistConfigRawOpen && (
<div className="rounded-lg border border-gray-200 bg-gray-50 p-2 space-y-1">
<div className="flex items-center justify-between">
<span className="text-[10px] font-medium text-gray-600">🔍 KI-Rohantwort</span>
<button
type="button"
onClick={() => setChecklistConfigRawOpen(false)}
className="text-[10px] text-gray-400 hover:text-gray-600">
Schließen
</button>
</div>
<pre className="text-[10px] text-gray-700 whitespace-pre-wrap max-h-40 overflow-y-auto">{checklistConfigRaw}</pre>
</div>
)}
<p className="text-[10px] text-gray-400">
Standard-Zuordnung: KI-Button + Alternativen-Chips. Score-Modus: gleichrangig (Ø), primär (Checkliste dominiert), ×2 (höher gewichtet).
</p>
</div>
)}
</div>
)
})()}
</div>
))}
@@ -254,6 +657,11 @@ export default function AssignmentTypeConfig() {
onChange={e => setNewPhase(prev => ({ ...prev, [type.id!]: { ...np, hasAssessment: e.target.checked } }))} />
Bewertung
</label>
<label className="flex items-center gap-1 cursor-pointer">
<input type="checkbox" checked={np.hasChecklist}
onChange={e => setNewPhase(prev => ({ ...prev, [type.id!]: { ...np, hasChecklist: e.target.checked } }))} />
Checkliste
</label>
</div>
<button onClick={() => addPhase(type.id!)}
className="px-4 py-1.5 bg-brand text-white text-xs rounded-lg font-medium">
@@ -266,9 +674,18 @@ export default function AssignmentTypeConfig() {
{/* Kriterien-Tab */}
{tab === 'criteria' && (
<div className="p-3 space-y-1">
<p className="text-xs text-gray-400 pb-2">
Kein Haken = alle Kriterien werden angezeigt.
</p>
<div className="flex items-start justify-between gap-2 pb-2">
<p className="text-xs text-gray-400">
Steuert, welche Dimensionen/Kategorien in Meeting und Feedback sichtbar sind.
Kein Haken = gesamte Struktur. Haken setzen schränkt auf die Auswahl ein (gespeichert als Kriterien-IDs).
</p>
{selected.length > 0 && (
<button type="button" onClick={() => clearStructureFilter(type)}
className="text-xs text-brand whitespace-nowrap flex-shrink-0">
Alles freigeben
</button>
)}
</div>
{items.length === 0 && (
<div className="text-xs text-gray-400">Keine Kriterien konfiguriert. Erst unter "Feedback" anlegen.</div>
)}
@@ -278,20 +695,33 @@ export default function AssignmentTypeConfig() {
if (dimItems.length === 0) return null
const isDimOpen = expandedDim.has(dim.id!)
const dimSelectedCount = dimItems.filter(i => selected.includes(i.id!)).length
const allDimSelected = dimItems.every(i => selected.includes(i.id!))
const someDimSelected = dimItems.some(i => selected.includes(i.id!))
return (
<div key={dim.id} className="border border-gray-100 rounded-lg overflow-hidden">
<button
onClick={() => setExpandedDim(prev => {
const next = new Set(prev)
if (next.has(dim.id!)) next.delete(dim.id!); else next.add(dim.id!)
return next
})}
className="w-full flex items-center justify-between px-3 py-2 bg-gray-50 hover:bg-gray-100 text-left">
<span className="text-xs font-semibold text-gray-700">{dim.name}</span>
<span className="text-xs text-gray-400">
{dimSelectedCount > 0 ? `${dimSelectedCount}/${dimItems.length}` : 'alle'} · {isDimOpen ? '▲' : '▼'}
</span>
</button>
<div className="flex items-center gap-2 px-3 py-2 bg-gray-50">
<input
type="checkbox"
checked={allDimSelected}
ref={el => { if (el) el.indeterminate = someDimSelected && !allDimSelected }}
onChange={() => toggleAllInDimension(type, dim.id!)}
className="rounded border-gray-300"
title="Gesamte Dimension"
/>
<button
type="button"
onClick={() => setExpandedDim(prev => {
const next = new Set(prev)
if (next.has(dim.id!)) next.delete(dim.id!); else next.add(dim.id!)
return next
})}
className="flex-1 flex items-center justify-between text-left hover:opacity-80">
<span className="text-xs font-semibold text-gray-700">{dim.name}</span>
<span className="text-xs text-gray-400">
{selected.length === 0 ? 'alle' : `${dimSelectedCount}/${dimItems.length}`} · {isDimOpen ? '▲' : '▼'}
</span>
</button>
</div>
{isDimOpen && (
<div className="divide-y divide-gray-50">
{dimCats.map(cat => {
@@ -310,6 +740,7 @@ export default function AssignmentTypeConfig() {
className="rounded border-gray-300"
/>
<span className="text-xs font-semibold text-gray-600">{cat.name}</span>
<span className="text-xs text-gray-300">{catItems.length} Krit.</span>
</label>
<div className="pl-5 space-y-1">
{catItems.map(item => (
@@ -321,7 +752,7 @@ export default function AssignmentTypeConfig() {
className="rounded border-gray-300"
/>
<span className="text-xs text-gray-600">{item.name}</span>
{(item.weight ?? 1) > 1 && (
{(item.weight ?? 1) !== 1 && (
<span className="text-xs text-gray-300">×{item.weight}</span>
)}
</label>
+26 -9
View File
@@ -1,10 +1,13 @@
import { useRef, useState } from 'react'
import FeedbackStructureConfig from './FeedbackStructureConfig'
import AssignmentTypeConfig from './AssignmentTypeConfig'
import RatingWeightConfig from './RatingWeightConfig'
import RatingScaleConfig from './RatingScaleConfig'
import AiPromptConfig from './AiPromptConfig'
import { exportFullBackup, importFullBackup } from '../utils/dbBackup'
export default function Configuration() {
const [tab, setTab] = useState<'feedback' | 'types' | 'backup'>('feedback')
const [tab, setTab] = useState<'feedback' | 'types' | 'weighting' | 'scale' | 'aiPrompts' | 'backup'>('feedback')
const [backupStatus, setBackupStatus] = useState<{ type: 'success' | 'error'; msg: string } | null>(null)
const [restoreConfirm, setRestoreConfirm] = useState(false)
const [importing, setImporting] = useState(false)
@@ -36,20 +39,31 @@ export default function Configuration() {
return (
<div className="space-y-4">
<h1 className="text-xl font-bold text-gray-800">Konfiguration</h1>
<h1 className="text-xl font-bold text-gray-800">Einstellungen</h1>
{/* Tab-Switcher */}
<div className="flex bg-gray-100 rounded-xl p-1 gap-0.5">
<div className="flex bg-gray-100 rounded-xl p-1 gap-0.5 flex-wrap">
<button onClick={() => setTab('feedback')}
className={`flex-1 py-2 rounded-lg text-sm font-medium transition ${tab === 'feedback' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'feedback' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
Feedback
</button>
<button onClick={() => setTab('types')}
className={`flex-1 py-2 rounded-lg text-sm font-medium transition ${tab === 'types' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'types' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
Ass.-Typen
</button>
<button onClick={() => setTab('weighting')}
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'weighting' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
Gewichtung
</button>
<button onClick={() => setTab('scale')}
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'scale' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
Skala
</button>
<button onClick={() => setTab('aiPrompts')}
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'aiPrompts' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
KI-Prompts
</button>
<button onClick={() => setTab('backup')}
className={`flex-1 py-2 rounded-lg text-sm font-medium transition ${tab === 'backup' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
className={`flex-1 min-w-[4.5rem] py-2 rounded-lg text-sm font-medium transition ${tab === 'backup' ? 'bg-white text-brand shadow-sm' : 'text-gray-500'}`}>
Backup
</button>
</div>
@@ -63,8 +77,11 @@ export default function Configuration() {
</div>
)}
{tab === 'feedback' && <FeedbackStructureConfig />}
{tab === 'types' && <AssignmentTypeConfig />}
{tab === 'feedback' && <FeedbackStructureConfig />}
{tab === 'types' && <AssignmentTypeConfig />}
{tab === 'weighting' && <RatingWeightConfig />}
{tab === 'scale' && <RatingScaleConfig />}
{tab === 'aiPrompts' && <AiPromptConfig />}
{tab === 'backup' && (
<div className="space-y-4">
+262
View File
@@ -0,0 +1,262 @@
import { useEffect, useMemo, useState } from 'react'
import { Link, useNavigate, useParams } from 'react-router-dom'
import {
type ConsultantDetail, type Group,
getConsultantDetail, listGroups, updateConsultant,
archiveConsultant, unarchiveConsultant, hardDeleteConsultant,
} from '../db'
import { formatPlanRange } from '../utils/assignmentSignals'
const FB_LABEL = { none: 'Kein Feedback', draft: 'Entwurf', final: 'Final' } as const
const FB_CLASS = {
none: 'bg-app text-ink-muted',
draft: 'bg-amber-50 text-amber-800',
final: 'bg-green-50 text-green-700',
} as const
export default function ConsultantDetailPage() {
const { id } = useParams()
const consultantId = Number(id)
const navigate = useNavigate()
const [detail, setDetail] = useState<ConsultantDetail | null>(null)
const [groups, setGroups] = useState<Group[]>([])
const [edit, setEdit] = useState({ firstName: '', lastName: '', email: '', groupId: 0 })
const [msg, setMsg] = useState<string | null>(null)
const [confirmDelete, setConfirmDelete] = useState(false)
const load = async () => {
const [d, g] = await Promise.all([getConsultantDetail(consultantId), listGroups()])
if (!d) {
setDetail(null)
return
}
setDetail(d)
setGroups(g)
setEdit({
firstName: d.consultant.firstName,
lastName: d.consultant.lastName,
email: d.consultant.email ?? '',
groupId: d.consultant.groupId,
})
}
useEffect(() => { load() }, [consultantId])
const developmentRows = useMemo(() => {
if (!detail) return []
return detail.assignments
.filter(a => !a.deletedAt && a.feedbackStatus === 'final' && a.categoryRatings.length > 0)
}, [detail])
const categoryNames = useMemo(() => {
const names = new Set<string>()
for (const a of developmentRows) {
for (const r of a.categoryRatings) names.add(r.categoryName)
}
return [...names].sort()
}, [developmentRows])
const save = async () => {
if (!edit.firstName.trim() || !edit.lastName.trim() || !edit.email.trim()) {
setMsg('Name und E-Mail sind Pflicht.')
return
}
try {
await updateConsultant(consultantId, {
firstName: edit.firstName.trim(),
lastName: edit.lastName.trim(),
email: edit.email.trim(),
groupId: edit.groupId,
})
setMsg('Gespeichert.')
await load()
} catch (e) {
setMsg(e instanceof Error ? e.message : String(e))
}
}
const archive = async () => {
await archiveConsultant(consultantId)
setMsg('Archiviert.')
await load()
}
const unarchive = async () => {
await unarchiveConsultant(consultantId)
setMsg('Wieder aktiv.')
await load()
}
const hardDelete = async () => {
const res = await hardDeleteConsultant(consultantId)
navigate('/consultants', {
replace: true,
state: {
flash: `Person gelöscht (${res.feedbacksDeleted} Feedbacks, ${res.assignmentsTouched} Assignments).`
+ (res.emptiedAssignmentIds.length
? ` ${res.emptiedAssignmentIds.length} Assignment(s) ohne Berater.`
: ''),
},
})
}
if (!detail) {
return (
<div className="text-center py-10 text-ink-muted text-sm">
Person nicht gefunden.{' '}
<Link to="/consultants" className="text-brand">Zurück</Link>
</div>
)
}
const { consultant, group, assignments } = detail
const visibleAssignments = assignments.filter(a => !a.deletedAt)
return (
<div className="space-y-4">
<div>
<button type="button" onClick={() => navigate('/consultants')} className="text-sm text-brand mb-2">
← Personen
</button>
<h1 className="text-xl font-bold text-ink">
{consultant.firstName} {consultant.lastName}
</h1>
<p className="text-sm text-ink-muted">
{consultant.email || 'keine E-Mail'} · {group?.name ?? 'ohne Gruppe'}
{consultant.archivedAt ? ' · Archiv' : ''}
</p>
</div>
{msg && (
<div className="text-xs rounded-lg px-3 py-2 border border-brand/20 bg-brand-soft text-brand">{msg}</div>
)}
<section className="bg-surface rounded-xl border border-line p-4 space-y-3">
<h2 className="font-semibold text-ink text-sm">Stammdaten</h2>
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
<input className="border border-line rounded-lg px-3 py-2 text-sm" value={edit.firstName}
onChange={e => setEdit(p => ({ ...p, firstName: e.target.value }))} placeholder="Vorname" />
<input className="border border-line rounded-lg px-3 py-2 text-sm" value={edit.lastName}
onChange={e => setEdit(p => ({ ...p, lastName: e.target.value }))} placeholder="Nachname" />
<input className="border border-line rounded-lg px-3 py-2 text-sm sm:col-span-2" type="email"
value={edit.email} onChange={e => setEdit(p => ({ ...p, email: e.target.value }))} placeholder="E-Mail" />
<select className="border border-line rounded-lg px-3 py-2 text-sm sm:col-span-2"
value={edit.groupId} onChange={e => setEdit(p => ({ ...p, groupId: +e.target.value }))}>
{groups.map(g => <option key={g.id} value={g.id}>{g.name}</option>)}
</select>
</div>
<div className="flex flex-wrap gap-2">
<button type="button" onClick={save} className="bg-brand text-white px-4 py-2 rounded-lg text-sm font-medium">
Speichern
</button>
{consultant.archivedAt ? (
<button type="button" onClick={unarchive} className="border border-line px-4 py-2 rounded-lg text-sm">
Aus Archiv holen
</button>
) : (
<button type="button" onClick={archive} className="border border-line px-4 py-2 rounded-lg text-sm">
Archivieren
</button>
)}
<button type="button" onClick={() => setConfirmDelete(v => !v)}
className="text-red-600 border border-red-200 px-4 py-2 rounded-lg text-sm">
Endgültig löschen
</button>
</div>
{confirmDelete && (
<div className="bg-red-50 border border-red-200 rounded-lg px-3 py-2 space-y-2">
<p className="text-xs text-red-700">
Feedbacks und personenbezogene Meeting-Daten werden gelöscht. Assignments bleiben ohne diese Person.
Besser zuerst archivieren.
</p>
<div className="flex gap-2">
<button type="button" onClick={hardDelete} className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg">
Ja, löschen
</button>
<button type="button" onClick={() => setConfirmDelete(false)}
className="text-xs border border-line px-2.5 py-1 rounded-lg">Abbruch</button>
</div>
</div>
)}
</section>
<section className="bg-surface rounded-xl border border-line p-4 space-y-3">
<h2 className="font-semibold text-ink text-sm">Assignments ({visibleAssignments.length})</h2>
{visibleAssignments.length === 0 ? (
<p className="text-xs text-ink-muted">Noch keinem Assignment zugeordnet.</p>
) : (
<ul className="space-y-2">
{visibleAssignments.map(a => {
const plan = formatPlanRange(a.plannedStart, a.plannedEnd)
return (
<li key={a.assignmentId} className="border border-line rounded-lg p-3 flex flex-wrap items-start gap-2">
<div className="min-w-0 flex-1">
<Link to={`/assignment/${a.assignmentId}`} className="font-medium text-ink hover:text-brand">
{a.assignmentNumber ? `${a.assignmentNumber} · ` : ''}{a.title}
</Link>
<div className="text-xs text-ink-muted">
{a.client} · {a.typeName}
{plan ? ` · ${plan}` : ''}
{a.archivedAt ? ' · archiviert' : ''}
</div>
</div>
<span className={`text-[11px] px-2 py-0.5 rounded-md font-medium ${FB_CLASS[a.feedbackStatus]}`}>
{FB_LABEL[a.feedbackStatus]}
</span>
<Link
to={`/assignment/${a.assignmentId}/feedback/${consultantId}`}
className="text-xs text-brand hover:underline"
>
Feedback
</Link>
</li>
)
})}
</ul>
)}
</section>
<section className="bg-surface rounded-xl border border-line p-4 space-y-3">
<h2 className="font-semibold text-ink text-sm">Entwicklung</h2>
<p className="text-xs text-ink-muted">
Kategorie-Bewertungen aus finalen Feedbacks über die Assignments (neueste zuerst).
</p>
{developmentRows.length === 0 ? (
<p className="text-xs text-ink-muted">Noch keine finalen Feedbacks mit Kategorie-Scores.</p>
) : (
<div className="overflow-x-auto">
<table className="w-full text-xs text-left border-collapse min-w-[20rem]">
<thead>
<tr className="border-b border-line text-ink-muted">
<th className="py-1.5 pr-2 font-medium">Assignment</th>
{categoryNames.map(n => (
<th key={n} className="py-1.5 px-1 font-medium whitespace-nowrap">{n}</th>
))}
</tr>
</thead>
<tbody>
{developmentRows.map(a => {
const byName = new Map(a.categoryRatings.map(r => [r.categoryName, r.rating]))
return (
<tr key={a.assignmentId} className="border-b border-line/60">
<td className="py-1.5 pr-2">
<Link to={`/assignment/${a.assignmentId}`} className="text-brand hover:underline">
{a.assignmentNumber || a.title}
</Link>
</td>
{categoryNames.map(n => (
<td key={n} className="py-1.5 px-1 tabular-nums text-ink">
{byName.get(n) ?? '—'}
</td>
))}
</tr>
)
})}
</tbody>
</table>
</div>
)}
</section>
</div>
)
}
+411 -36
View File
@@ -1,90 +1,465 @@
import { useEffect, useState } from 'react'
import { db, type Consultant, type Group } from '../db'
import { useEffect, useMemo, useRef, useState } from 'react'
import { Link, useNavigate } from 'react-router-dom'
import {
type Consultant, type Group, type ConsultantImportResult,
listGroups, listConsultants,
addGroup as addGroupQuery, updateGroup, deleteGroup,
addConsultant as addConsultantQuery, updateConsultant,
archiveConsultant, hardDeleteConsultant,
importConsultantsToGroup,
} from '../db'
import { parseConsultantExcelFile } from '../utils/consultantImport'
type ViewMode = 'active' | 'archived' | 'all'
export default function Consultants() {
const navigate = useNavigate()
const [groups, setGroups] = useState<Group[]>([])
const [consultants, setConsultants] = useState<Consultant[]>([])
const [query, setQuery] = useState('')
const [view, setView] = useState<ViewMode>('active')
const [msg, setMsg] = useState<{ text: string; error: boolean } | null>(null)
const [newGroup, setNewGroup] = useState({ name: '', cohortYear: new Date().getFullYear() })
const [newCons, setNewCons] = useState({ groupId: 0, firstName: '', lastName: '' })
const [newCons, setNewCons] = useState({
groupId: 0, firstName: '', lastName: '', email: '',
})
const [renamingGroupId, setRenamingGroupId] = useState<number | null>(null)
const [renameValue, setRenameValue] = useState('')
const [confirmDeleteGroupId, setConfirmDeleteGroupId] = useState<number | null>(null)
const [confirmHardDeleteId, setConfirmHardDeleteId] = useState<number | null>(null)
const [importGroupId, setImportGroupId] = useState(0)
const [importMove, setImportMove] = useState(true)
const [importing, setImporting] = useState(false)
const [importResult, setImportResult] = useState<ConsultantImportResult | null>(null)
const [newImportGroupName, setNewImportGroupName] = useState('')
const fileRef = useRef<HTMLInputElement>(null)
const load = async () => {
setGroups(await db.groups.toArray())
setConsultants(await db.consultants.toArray())
const [g, c] = await Promise.all([listGroups(), listConsultants()])
setGroups(g)
setConsultants(c)
if (!importGroupId && g[0]?.id) setImportGroupId(g[0].id)
if (!newCons.groupId && g[0]?.id) setNewCons(p => ({ ...p, groupId: g[0]!.id! }))
}
useEffect(() => { load() }, [])
const flash = (text: string, error = false) => {
setMsg({ text, error })
setTimeout(() => setMsg(null), 5000)
}
const filteredByView = useMemo(() => {
return consultants.filter(c => {
if (view === 'active') return !c.archivedAt
if (view === 'archived') return !!c.archivedAt
return true
})
}, [consultants, view])
const q = query.trim().toLowerCase()
const matchesQuery = (c: Consultant) => {
if (!q) return true
return (
c.firstName.toLowerCase().includes(q) ||
c.lastName.toLowerCase().includes(q) ||
(c.email ?? '').toLowerCase().includes(q)
)
}
const addGroup = async () => {
if (!newGroup.name.trim()) return
await db.groups.add({ ...newGroup })
const id = await addGroupQuery({ ...newGroup, name: newGroup.name.trim() })
setNewGroup({ name: '', cohortYear: new Date().getFullYear() })
load()
await load()
setImportGroupId(id)
flash('Gruppe angelegt.')
}
const saveRename = async (id: number) => {
if (!renameValue.trim()) return
await updateGroup(id, { name: renameValue.trim() })
setRenamingGroupId(null)
await load()
}
const tryDeleteGroup = async (id: number) => {
const res = await deleteGroup(id)
if (!res.ok) {
flash(res.reason, true)
setConfirmDeleteGroupId(null)
return
}
setConfirmDeleteGroupId(null)
await load()
flash('Gruppe gelöscht.')
}
const addConsultant = async () => {
if (!newCons.firstName.trim() || !newCons.lastName.trim() || !newCons.groupId) return
await db.consultants.add({ ...newCons })
setNewCons(p => ({ ...p, firstName: '', lastName: '' }))
load()
if (!newCons.firstName.trim() || !newCons.lastName.trim() || !newCons.email.trim() || !newCons.groupId) {
flash('Vorname, Nachname, E-Mail und Gruppe sind Pflicht.', true)
return
}
try {
await addConsultantQuery({
groupId: newCons.groupId,
firstName: newCons.firstName.trim(),
lastName: newCons.lastName.trim(),
email: newCons.email.trim(),
})
setNewCons(p => ({ ...p, firstName: '', lastName: '', email: '' }))
await load()
flash('Person angelegt.')
} catch (e) {
flash(e instanceof Error ? e.message : String(e), true)
}
}
const deleteConsultant = async (id: number) => {
await db.consultants.delete(id)
load()
const movePerson = async (id: number, groupId: number) => {
await updateConsultant(id, { groupId })
await load()
}
const archivePerson = async (id: number) => {
await archiveConsultant(id)
await load()
flash('Person archiviert (erste Empfehlung vor dem Löschen).')
}
const hardDeletePerson = async (id: number) => {
try {
const res = await hardDeleteConsultant(id)
setConfirmHardDeleteId(null)
await load()
const emptyHint = res.emptiedAssignmentIds.length
? ` ${res.emptiedAssignmentIds.length} Assignment(s) ohne Berater — bitte archivieren oder löschen.`
: ''
flash(
`Person gelöscht (${res.feedbacksDeleted} Feedback(s), ${res.assignmentsTouched} Assignment(s) entkoppelt).${emptyHint}`,
)
} catch (e) {
flash(e instanceof Error ? e.message : String(e), true)
}
}
const ensureImportGroup = async (): Promise<number | null> => {
if (importGroupId) return importGroupId
if (!newImportGroupName.trim()) {
flash('Bitte Zielgruppe wählen oder neu anlegen.', true)
return null
}
const id = await addGroupQuery({
name: newImportGroupName.trim(),
cohortYear: new Date().getFullYear(),
})
setNewImportGroupName('')
await load()
setImportGroupId(id)
return id
}
const handleImportFile = async (file: File | undefined) => {
if (!file) return
setImporting(true)
setImportResult(null)
try {
const groupId = await ensureImportGroup()
if (!groupId) return
const buf = await file.arrayBuffer()
const rows = parseConsultantExcelFile(buf)
if (rows.length === 0) {
flash('Keine Zeilen in der Excel-Datei gefunden.', true)
return
}
const result = await importConsultantsToGroup(groupId, rows, importMove)
setImportResult(result)
await load()
flash(
`Import: ${result.created} neu, ${result.updated} aktualisiert`
+ (result.moved ? `, ${result.moved} verschoben` : '')
+ (result.skipped ? `, ${result.skipped} übersprungen` : ''),
result.errors.length > 0,
)
} catch (e) {
flash(e instanceof Error ? e.message : String(e), true)
} finally {
setImporting(false)
if (fileRef.current) fileRef.current.value = ''
}
}
return (
<div className="space-y-6">
<h1 className="text-xl font-bold text-gray-800">Berater</h1>
<div className="space-y-4">
<div className="flex flex-wrap items-center justify-between gap-2">
<h1 className="text-xl font-bold text-ink">Personen</h1>
<div className="flex bg-app rounded-xl p-1 gap-0.5">
{([['active', 'Aktiv'], ['archived', 'Archiv'], ['all', 'Alle']] as const).map(([val, label]) => (
<button
key={val}
type="button"
onClick={() => setView(val)}
className={`px-3 py-1.5 rounded-lg text-xs font-medium transition ${
view === val ? 'bg-surface text-brand shadow-sm' : 'text-ink-muted'
}`}
>
{label}
</button>
))}
</div>
</div>
<section className="bg-white rounded-xl shadow-sm border border-gray-100 p-4 space-y-3">
<h2 className="font-semibold text-gray-700">Neue Gruppe / Kohorte</h2>
{msg && (
<div className={`text-xs rounded-lg px-3 py-2 border ${
msg.error ? 'bg-red-50 border-red-200 text-red-700' : 'bg-brand-soft border-brand/20 text-brand'
}`}>
{msg.text}
</div>
)}
<input
type="search"
placeholder="Suche Name oder E-Mail…"
value={query}
onChange={e => setQuery(e.target.value)}
className="w-full border border-line rounded-xl px-3 py-2 text-sm focus:outline-none focus:border-brand bg-surface"
/>
{/* Excel-Import */}
<section className="bg-surface rounded-xl border border-line p-4 space-y-3">
<h2 className="font-semibold text-ink text-sm">Excel-Import</h2>
<p className="text-xs text-ink-muted">
SharePoint-Liste als Excel. Keine Gruppen-Spalte nötig — Zielgruppe hier wählen oder anlegen.
Abgleich über E-Mail.
</p>
<div className="flex flex-wrap gap-2 items-end">
<div className="space-y-0.5 min-w-[12rem] flex-1">
<label className="text-[11px] text-ink-muted">Zielgruppe</label>
<select
className="w-full border border-line rounded-lg px-2 py-1.5 text-sm bg-surface"
value={importGroupId}
onChange={e => setImportGroupId(+e.target.value)}
>
<option value={0}>— wählen oder neu —</option>
{groups.map(g => (
<option key={g.id} value={g.id}>{g.name}</option>
))}
</select>
</div>
{importGroupId === 0 && (
<div className="space-y-0.5 min-w-[10rem] flex-1">
<label className="text-[11px] text-ink-muted">Neue Gruppe</label>
<input
className="w-full border border-line rounded-lg px-2 py-1.5 text-sm"
placeholder="Gruppenname"
value={newImportGroupName}
onChange={e => setNewImportGroupName(e.target.value)}
/>
</div>
)}
<label className="flex items-center gap-2 text-xs text-ink-muted py-1.5">
<input type="checkbox" checked={importMove} onChange={e => setImportMove(e.target.checked)} />
Bei Treffer in andere Gruppe verschieben
</label>
<input
ref={fileRef}
type="file"
accept=".xlsx,.xls,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
className="hidden"
onChange={e => handleImportFile(e.target.files?.[0])}
/>
<button
type="button"
disabled={importing}
onClick={() => fileRef.current?.click()}
className="bg-brand text-white px-4 py-2 rounded-lg text-sm font-medium disabled:opacity-50"
>
{importing ? 'Import…' : 'Excel wählen'}
</button>
</div>
{importResult && importResult.errors.length > 0 && (
<ul className="text-xs text-amber-800 bg-amber-50 border border-amber-200 rounded-lg px-3 py-2 space-y-0.5 max-h-32 overflow-auto">
{importResult.errors.map((e, i) => <li key={i}>{e}</li>)}
</ul>
)}
</section>
{/* Neue Gruppe */}
<section className="bg-surface rounded-xl border border-line p-4 space-y-2">
<h2 className="font-semibold text-ink text-sm">Neue Gruppe</h2>
<div className="flex gap-2">
<input
className="flex-1 border border-gray-200 rounded-lg px-3 py-2 text-sm"
className="flex-1 border border-line rounded-lg px-3 py-2 text-sm"
placeholder="Gruppenname (z.B. MC Kohorte 2025)"
value={newGroup.name}
onChange={e => setNewGroup(p => ({ ...p, name: e.target.value }))}
onKeyDown={e => e.key === 'Enter' && addGroup()}
/>
<button onClick={addGroup} className="bg-brand text-white px-4 py-2 rounded-lg text-sm">+</button>
<input
type="number"
className="w-24 border border-line rounded-lg px-2 py-2 text-sm"
value={newGroup.cohortYear}
onChange={e => setNewGroup(p => ({ ...p, cohortYear: +e.target.value }))}
title="Kohortejahr"
/>
<button type="button" onClick={addGroup} className="bg-brand text-white px-4 py-2 rounded-lg text-sm">+</button>
</div>
</section>
<section className="bg-white rounded-xl shadow-sm border border-gray-100 p-4 space-y-3">
<h2 className="font-semibold text-gray-700">Neuer Berater</h2>
{/* Neue Person */}
<section className="bg-surface rounded-xl border border-line p-4 space-y-3">
<h2 className="font-semibold text-ink text-sm">Neue Person</h2>
<select
className="w-full border border-gray-200 rounded-lg px-3 py-2 text-sm"
className="w-full border border-line rounded-lg px-3 py-2 text-sm"
value={newCons.groupId}
onChange={e => setNewCons(p => ({ ...p, groupId: +e.target.value }))}
>
<option value={0}>Gruppe wählen…</option>
{groups.map(g => <option key={g.id} value={g.id}>{g.name}</option>)}
</select>
<div className="flex gap-2">
<input className="flex-1 border border-gray-200 rounded-lg px-3 py-2 text-sm" placeholder="Vorname"
<div className="grid grid-cols-1 sm:grid-cols-3 gap-2">
<input className="border border-line rounded-lg px-3 py-2 text-sm" placeholder="Vorname"
value={newCons.firstName} onChange={e => setNewCons(p => ({ ...p, firstName: e.target.value }))} />
<input className="flex-1 border border-gray-200 rounded-lg px-3 py-2 text-sm" placeholder="Nachname"
<input className="border border-line rounded-lg px-3 py-2 text-sm" placeholder="Nachname"
value={newCons.lastName} onChange={e => setNewCons(p => ({ ...p, lastName: e.target.value }))} />
<input className="border border-line rounded-lg px-3 py-2 text-sm" placeholder="E-Mail *" type="email"
value={newCons.email} onChange={e => setNewCons(p => ({ ...p, email: e.target.value }))} />
</div>
<button onClick={addConsultant} className="w-full bg-brand text-white py-2 rounded-lg text-sm font-medium">Berater hinzufügen</button>
<button type="button" onClick={addConsultant}
className="w-full bg-brand text-white py-2 rounded-lg text-sm font-medium">
Person hinzufügen
</button>
</section>
{/* Gruppen + Mitglieder */}
{groups.map(g => {
const members = consultants.filter(c => c.groupId === g.id)
if (members.length === 0) return null
const members = filteredByView.filter(c => c.groupId === g.id && matchesQuery(c))
const allInGroup = consultants.filter(c => c.groupId === g.id)
if (view !== 'all' && members.length === 0 && q) return null
if (view === 'archived' && members.length === 0) return null
return (
<div key={g.id} className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<h3 className="font-semibold text-gray-700 mb-2">{g.name}</h3>
{members.map(c => (
<div key={c.id} className="flex items-center justify-between py-1 text-sm text-gray-700 border-b border-gray-50 last:border-0">
<span>{c.firstName} {c.lastName}</span>
<button onClick={() => deleteConsultant(c.id!)} className="text-red-400 text-xs hover:text-red-600">×</button>
<div key={g.id} className="bg-surface rounded-xl border border-line overflow-hidden">
<div className="flex flex-wrap items-center gap-2 px-4 py-3 bg-app border-b border-line">
{renamingGroupId === g.id ? (
<>
<input
className="flex-1 border border-line rounded-lg px-2 py-1 text-sm"
value={renameValue}
onChange={e => setRenameValue(e.target.value)}
onKeyDown={e => e.key === 'Enter' && saveRename(g.id!)}
autoFocus
/>
<button type="button" onClick={() => saveRename(g.id!)} className="text-xs text-brand font-medium">OK</button>
<button type="button" onClick={() => setRenamingGroupId(null)} className="text-xs text-ink-muted">Abbruch</button>
</>
) : (
<>
<h3 className="font-semibold text-ink flex-1 min-w-0 truncate">{g.name}</h3>
<span className="text-[11px] text-ink-muted">{allInGroup.length} Pers. · {g.cohortYear}</span>
<button
type="button"
className="text-xs text-ink-muted hover:text-brand"
onClick={() => { setRenamingGroupId(g.id!); setRenameValue(g.name) }}
>
Umbenennen
</button>
<button
type="button"
className="text-xs text-red-500 hover:text-red-700"
onClick={() => setConfirmDeleteGroupId(confirmDeleteGroupId === g.id ? null : g.id!)}
>
Löschen
</button>
</>
)}
</div>
{confirmDeleteGroupId === g.id && (
<div className="px-4 py-2 bg-red-50 border-b border-red-100 flex flex-wrap items-center justify-between gap-2">
<span className="text-xs text-red-700">
{allInGroup.length === 0
? 'Leere Gruppe endgültig löschen?'
: `Gruppe hat ${allInGroup.length} Person(en) — Löschen nur möglich wenn leer. Mitglieder zuerst umziehen.`}
</span>
<div className="flex gap-1.5">
{allInGroup.length === 0 && (
<button type="button" onClick={() => tryDeleteGroup(g.id!)}
className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg">Ja</button>
)}
<button type="button" onClick={() => setConfirmDeleteGroupId(null)}
className="text-xs border border-line px-2.5 py-1 rounded-lg">Schließen</button>
</div>
</div>
))}
)}
{members.length === 0 ? (
<p className="px-4 py-3 text-xs text-ink-muted">Keine Personen in dieser Ansicht.</p>
) : (
<ul>
{members.map(c => (
<li key={c.id} className="px-4 py-2.5 border-b border-line last:border-0 flex flex-wrap items-center gap-2 text-sm">
<button
type="button"
className="text-left min-w-0 flex-1 hover:text-brand"
onClick={() => navigate(`/consultants/${c.id}`)}
>
<span className="font-medium text-ink">{c.firstName} {c.lastName}</span>
<span className="block text-xs text-ink-muted truncate">{c.email || 'keine E-Mail'}</span>
{c.archivedAt && (
<span className="inline-block mt-0.5 text-[10px] px-1.5 py-0.5 rounded bg-app text-ink-muted">Archiv</span>
)}
</button>
<select
className="text-xs border border-line rounded-lg px-1.5 py-1 max-w-[9rem]"
value={c.groupId}
onChange={e => movePerson(c.id!, +e.target.value)}
title="Gruppe wechseln"
>
{groups.map(og => (
<option key={og.id} value={og.id}>{og.name}</option>
))}
</select>
<Link to={`/consultants/${c.id}`} className="text-xs text-brand hover:underline">Öffnen</Link>
{!c.archivedAt && (
<button type="button" onClick={() => archivePerson(c.id!)}
className="text-xs text-ink-muted hover:text-brand">Archivieren</button>
)}
<button
type="button"
onClick={() => setConfirmHardDeleteId(confirmHardDeleteId === c.id ? null : c.id!)}
className="text-xs text-red-400 hover:text-red-600"
>
Löschen
</button>
{confirmHardDeleteId === c.id && (
<div className="w-full bg-red-50 border border-red-200 rounded-lg px-3 py-2 space-y-1.5">
<p className="text-xs text-red-700">
Endgültig löschen? Feedbacks und personenbezogene Meeting-Daten werden entfernt.
Assignments bleiben (Person wird nur ausgehängt). Besser zuerst archivieren.
</p>
<div className="flex gap-1.5">
<button type="button" onClick={() => hardDeletePerson(c.id!)}
className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg">Endgültig löschen</button>
<button type="button" onClick={() => setConfirmHardDeleteId(null)}
className="text-xs border border-line px-2.5 py-1 rounded-lg">Abbruch</button>
</div>
</div>
)}
</li>
))}
</ul>
)}
</div>
)
})}
{groups.length === 0 && (
<p className="text-center text-ink-muted text-sm py-8">Noch keine Gruppen — zuerst anlegen oder per Excel-Import erstellen.</p>
)}
</div>
)
}
+359 -67
View File
@@ -1,119 +1,411 @@
import { useEffect, useMemo, useState } from 'react'
import { useEffect, useMemo, useRef, useState } from 'react'
import { useNavigate } from 'react-router-dom'
import { db, type Assignment, type AssignmentType, type Consultant } from '../db'
import {
listAssignmentsWithDetails,
softDeleteAssignment,
archiveAssignment,
listAssignmentTypes,
type AssignmentWithDetails,
type AssignmentType,
} from '../db'
import { importAssignmentTransferFile } from '../utils/assignmentTransfer'
import {
assignmentSignals,
formatPlanRange,
plannedRangeOverlaps,
type AssignmentSignal,
} from '../utils/assignmentSignals'
import { DEFAULT_ASSIGNMENT_TYPE_COLOR } from '../config/constants'
interface AssignmentRow extends Assignment {
typeName: string
instituteeNames: string[]
type QuickFilter = 'all' | 'overdue' | 'ending_soon' | 'no_plan'
const SIGNAL_LABEL: Record<AssignmentSignal, string> = {
plan_overdue: 'Plan überfällig',
feedback_overdue: 'Feedback fehlt',
ending_soon: 'Endet bald',
}
const SIGNAL_CLASS: Record<AssignmentSignal, string> = {
plan_overdue: 'bg-red-50 text-red-700 border-red-200',
feedback_overdue: 'bg-amber-50 text-amber-800 border-amber-200',
ending_soon: 'bg-orange-50 text-orange-700 border-orange-200',
}
export default function Dashboard() {
const [assignments, setAssignments] = useState<AssignmentRow[]>([])
const [query, setQuery] = useState('')
const [statusFilter, setStatusFilter] = useState<'all' | 'active' | 'done'>('all')
const [assignments, setAssignments] = useState<AssignmentWithDetails[]>([])
const [types, setTypes] = useState<AssignmentType[]>([])
const [query, setQuery] = useState('')
const [statusFilter, setStatusFilter] = useState<'all' | 'active' | 'done'>('active')
const [hiddenTypeIds, setHiddenTypeIds] = useState<Set<number>>(() => new Set())
const [dateFrom, setDateFrom] = useState('')
const [dateTo, setDateTo] = useState('')
const [quickFilter, setQuickFilter] = useState<QuickFilter>('all')
const [confirmTrashId, setConfirmTrashId] = useState<number | null>(null)
const [confirmArchiveId, setConfirmArchiveId] = useState<number | null>(null)
const [importing, setImporting] = useState(false)
const [importMsg, setImportMsg] = useState<{ text: string; error: boolean } | null>(null)
const importInputRef = useRef<HTMLInputElement>(null)
const navigate = useNavigate()
useEffect(() => {
const load = async () => {
const raw = await db.assignments.orderBy('createdAt').reverse().toArray()
const types = await db.assignmentTypes.toArray()
const consultants = await db.consultants.toArray()
const typeMap = new Map<number, AssignmentType>(types.map(t => [t.id!, t]))
const consMap = new Map<number, Consultant>(consultants.map(c => [c.id!, c]))
setAssignments(raw.map(a => ({
...a,
typeName: typeMap.get(a.assignmentTypeId)?.name ?? '—',
instituteeNames: a.instituteeIds.map(id => {
const c = consMap.get(id)
return c ? `${c.firstName} ${c.lastName}` : '?'
}),
})))
const load = () => {
Promise.all([listAssignmentsWithDetails(), listAssignmentTypes()]).then(([a, t]) => {
setAssignments(a)
setTypes(t)
})
}
useEffect(() => { load() }, [])
const handleImportTransfer = async (file: File | undefined) => {
if (!file) return
setImporting(true)
setImportMsg(null)
try {
const res = await importAssignmentTransferFile(file)
if (!res.ok) {
setImportMsg({ text: res.error, error: true })
return
}
const { result } = res
const matched = result.consultantsMatched.length
? `Berater vorhanden: ${result.consultantsMatched.join(', ')}`
: null
const created = result.consultantsCreated.length
? `Berater neu: ${result.consultantsCreated.join(', ')}`
: null
setImportMsg({
text: [
`Assignment importiert (${result.meetings} Meetings, ${result.checklistResponses} Checklisten-Antworten).`,
matched,
created,
].filter(Boolean).join(' '),
error: false,
})
load()
navigate(`/assignment/${result.assignmentId}`)
} finally {
setImporting(false)
if (importInputRef.current) importInputRef.current.value = ''
}
}
const trashAssignment = async (id: number) => {
await softDeleteAssignment(id)
setConfirmTrashId(null)
load()
}, [])
}
const archiveThisAssignment = async (id: number) => {
await archiveAssignment(id)
setConfirmArchiveId(null)
load()
}
const toggleTypeHidden = (typeId: number) => {
setHiddenTypeIds(prev => {
const next = new Set(prev)
if (next.has(typeId)) next.delete(typeId)
else next.add(typeId)
return next
})
}
const trashCount = useMemo(() => assignments.filter(a => a.deletedAt).length, [assignments])
const archiveCount = useMemo(() => assignments.filter(a => a.archivedAt).length, [assignments])
const filtered = useMemo(() => {
const q = query.trim().toLowerCase()
const dateFilterActive = !!(dateFrom || dateTo)
return assignments.filter(a => {
if (a.deletedAt || a.archivedAt) return false
if (statusFilter !== 'all' && a.status !== statusFilter) return false
if (hiddenTypeIds.has(a.assignmentTypeId)) return false
if (dateFilterActive) {
if (!a.plannedStart && !a.plannedEnd) return false
if (!plannedRangeOverlaps(a.plannedStart, a.plannedEnd, dateFrom, dateTo)) return false
}
const signals = assignmentSignals(a)
if (quickFilter === 'overdue') {
if (!signals.includes('plan_overdue') && !signals.includes('feedback_overdue')) return false
} else if (quickFilter === 'ending_soon') {
if (!signals.includes('ending_soon')) return false
} else if (quickFilter === 'no_plan') {
if (a.plannedStart || a.plannedEnd) return false
}
if (!q) return true
return (
a.title.toLowerCase().includes(q) ||
(a.assignmentNumber ?? '').toLowerCase().includes(q) ||
a.client.toLowerCase().includes(q) ||
a.typeName.toLowerCase().includes(q) ||
a.instituteeNames.some(n => n.toLowerCase().includes(q))
)
})
}, [assignments, query, statusFilter])
}, [assignments, query, statusFilter, hiddenTypeIds, dateFrom, dateTo, quickFilter])
return (
<div className="space-y-3">
{/* Header */}
<div className="flex items-center justify-between">
<h1 className="text-xl font-bold text-gray-800">Assignments</h1>
<button
onClick={() => navigate('/assignment/new')}
className="bg-brand text-white px-4 py-2 rounded-lg text-sm font-medium"
>
+ Neues
</button>
<div className="space-y-4">
<div className="flex flex-wrap items-center justify-between gap-2">
<h1 className="text-xl font-bold text-ink">Assignments</h1>
<div className="flex flex-wrap items-center gap-2">
<button
onClick={() => navigate('/assignments/trash')}
className="text-xs px-2.5 py-1.5 border border-line rounded-[var(--radius-control)] text-ink-muted hover:border-brand hover:text-brand transition"
>
Papierkorb{trashCount > 0 && ` (${trashCount})`}
</button>
<button
onClick={() => navigate('/assignments/archive')}
className="text-xs px-2.5 py-1.5 border border-line rounded-[var(--radius-control)] text-ink-muted hover:border-brand hover:text-brand transition"
>
Archiv{archiveCount > 0 && ` (${archiveCount})`}
</button>
<input
ref={importInputRef}
type="file"
accept="application/json,.json"
className="hidden"
onChange={e => handleImportTransfer(e.target.files?.[0])}
/>
<button
onClick={() => importInputRef.current?.click()}
disabled={importing}
title="Assignment-Übergabe importieren (Lead → Lead)"
className="text-xs px-2.5 py-1.5 border border-brand/30 rounded-[var(--radius-control)] text-brand hover:bg-brand-soft transition disabled:opacity-50"
>
{importing ? 'Import…' : 'Import'}
</button>
<button
onClick={() => navigate('/assignment/new')}
className="bg-brand text-white px-4 py-2 rounded-[var(--radius-control)] text-sm font-medium"
>
+ Neues
</button>
</div>
</div>
{/* Suche + Status-Filter */}
{importMsg && (
<div className={`text-xs rounded-[var(--radius-control)] px-3 py-2 border ${
importMsg.error
? 'bg-red-50 border-red-200 text-red-700'
: 'bg-brand-soft border-brand/20 text-brand'
}`}>
{importMsg.text}
</div>
)}
<div className="space-y-2">
<input
type="search"
placeholder="Suche nach Nummer, Titel, Kunde, Berater…"
placeholder="Suche nach Nummer, Titel, Kunde, Typ, Berater…"
value={query}
onChange={e => setQuery(e.target.value)}
className="w-full border border-gray-200 rounded-xl px-3 py-2 text-sm focus:outline-none focus:border-brand bg-white"
className="w-full border border-line rounded-xl px-3 py-2 text-sm focus:outline-none focus:border-brand bg-surface"
/>
<div className="flex bg-gray-100 rounded-xl p-1 gap-0.5">
<div className="flex bg-app rounded-xl p-1 gap-0.5">
{([['all', 'Alle'], ['active', 'Aktiv'], ['done', 'Abgeschlossen']] as const).map(([val, label]) => (
<button key={val} onClick={() => setStatusFilter(val)}
className={`flex-1 py-1.5 rounded-lg text-xs font-medium transition ${
statusFilter === val ? 'bg-white text-brand shadow-sm' : 'text-gray-500'
statusFilter === val ? 'bg-surface text-brand shadow-sm' : 'text-ink-muted'
}`}>
{label}
</button>
))}
</div>
{types.length > 0 && (
<div className="flex flex-wrap gap-1.5 items-center">
<span className="text-[11px] text-ink-muted shrink-0">Typen:</span>
{types.map(t => {
const hidden = hiddenTypeIds.has(t.id!)
const color = t.color?.trim() || DEFAULT_ASSIGNMENT_TYPE_COLOR
return (
<button
key={t.id}
type="button"
onClick={() => toggleTypeHidden(t.id!)}
title={hidden ? 'Einblenden' : 'Ausblenden'}
className={`inline-flex items-center gap-1.5 text-xs px-2 py-1 rounded-lg border transition ${
hidden
? 'opacity-40 border-line text-ink-muted line-through'
: 'border-line bg-surface text-ink'
}`}
>
<span className="w-2 h-2 rounded-full shrink-0" style={{ backgroundColor: color }} />
{t.name}
</button>
)
})}
</div>
)}
<div className="flex flex-wrap gap-2 items-end">
<div className="space-y-0.5">
<label className="text-[11px] text-ink-muted">Zeitraum von</label>
<input
type="date"
value={dateFrom}
onChange={e => setDateFrom(e.target.value)}
className="border border-line rounded-lg px-2 py-1.5 text-xs bg-surface"
/>
</div>
<div className="space-y-0.5">
<label className="text-[11px] text-ink-muted">bis</label>
<input
type="date"
value={dateTo}
onChange={e => setDateTo(e.target.value)}
className="border border-line rounded-lg px-2 py-1.5 text-xs bg-surface"
/>
</div>
{(dateFrom || dateTo) && (
<button
type="button"
onClick={() => { setDateFrom(''); setDateTo('') }}
className="text-xs text-ink-muted underline py-1.5"
>
Zeitraum zurücksetzen
</button>
)}
</div>
<div className="flex flex-wrap gap-1.5">
{([
['all', 'Alle'],
['overdue', 'Überfällig'],
['ending_soon', 'Endet bald'],
['no_plan', 'Ohne Plandaten'],
] as const).map(([val, label]) => (
<button
key={val}
type="button"
onClick={() => setQuickFilter(val)}
className={`text-xs px-2.5 py-1 rounded-lg border transition ${
quickFilter === val
? 'border-brand bg-brand-soft text-brand font-medium'
: 'border-line text-ink-muted hover:border-brand/40'
}`}
>
{label}
</button>
))}
</div>
</div>
{/* Liste */}
{filtered.length === 0 && (
<p className="text-gray-400 text-sm text-center py-8">
{assignments.length === 0 ? 'Noch keine Assignments angelegt.' : 'Keine Treffer.'}
<p className="text-ink-muted text-sm text-center py-8">
{assignments.filter(a => !a.deletedAt && !a.archivedAt).length === 0
? 'Noch keine Assignments angelegt.'
: 'Keine Treffer.'}
</p>
)}
{filtered.map(a => (
<div
key={a.id}
onClick={() => navigate(`/assignment/${a.id}`)}
className="bg-white rounded-xl shadow-sm border border-gray-100 p-4 cursor-pointer hover:shadow-md transition"
>
<div className="flex items-start justify-between gap-3">
<div className="flex-1 min-w-0">
{a.assignmentNumber && (
<div className="text-xs font-semibold text-brand uppercase tracking-wide leading-none mb-0.5">
{a.assignmentNumber}
<div className="grid grid-cols-1 sm:grid-cols-2 xl:grid-cols-3 gap-3">
{filtered.map(a => {
const color = a.typeColor?.trim() || DEFAULT_ASSIGNMENT_TYPE_COLOR
const plan = formatPlanRange(a.plannedStart, a.plannedEnd)
const signals = assignmentSignals(a)
return (
<div
key={a.id}
onClick={() => navigate(`/assignment/${a.id}`)}
className="bg-surface rounded-xl border border-line cursor-pointer hover:shadow-md transition overflow-hidden flex flex-col min-h-[8.5rem]"
>
<div className="h-1.5 shrink-0" style={{ backgroundColor: color }} />
<div className="p-4 flex-1 flex flex-col gap-2">
<div className="flex items-start justify-between gap-2">
<div className="min-w-0 flex-1">
{a.assignmentNumber && (
<div className="text-xs font-semibold text-brand uppercase tracking-wide leading-none mb-0.5 truncate">
{a.assignmentNumber}
</div>
)}
<div className="font-semibold text-ink truncate">{a.title}</div>
<div className="text-sm text-ink-muted truncate">{a.client}</div>
</div>
<span className={`shrink-0 text-[11px] px-2 py-0.5 rounded-md font-medium ${
a.status === 'active' ? 'bg-green-50 text-green-700' : 'bg-app text-ink-muted'
}`}>
{a.status === 'active' ? 'Aktiv' : 'Fertig'}
</span>
</div>
)}
<div className="font-semibold text-gray-800 truncate">{a.title}</div>
<div className="text-sm text-gray-500">{a.client}</div>
<div className="text-xs text-gray-400 mt-0.5">
{a.typeName} · {a.instituteeNames.join(', ')}
<div className="flex items-center gap-1.5 min-w-0">
<span className="w-2 h-2 rounded-full shrink-0" style={{ backgroundColor: color }} />
<span className="text-xs font-medium text-ink truncate">{a.typeName}</span>
</div>
<div className="text-xs text-ink-muted truncate">
{a.instituteeNames.join(', ') || '—'}
</div>
{plan && (
<div className="text-xs text-ink-muted">{plan}</div>
)}
{signals.length > 0 && (
<div className="flex flex-wrap gap-1 mt-auto pt-1">
{signals.map(s => (
<span
key={s}
className={`text-[10px] px-1.5 py-0.5 rounded border font-medium ${SIGNAL_CLASS[s]}`}
>
{SIGNAL_LABEL[s]}
</span>
))}
</div>
)}
{a.status === 'done' && (
<div className="pt-2 border-t border-line flex gap-2" onClick={e => e.stopPropagation()}>
<button
onClick={() => { setConfirmTrashId(confirmTrashId === a.id ? null : a.id!); setConfirmArchiveId(null) }}
disabled={!a.feedbackComplete}
title={!a.feedbackComplete ? 'Erst möglich, wenn für alle Institutees ein finales Feedback vorliegt' : undefined}
className={`text-xs px-2.5 py-1 rounded-lg font-medium ${
a.feedbackComplete
? 'bg-red-50 text-red-600 border border-red-200 hover:bg-red-100'
: 'bg-app text-ink-muted cursor-not-allowed'
}`}>
Papierkorb
</button>
<button
onClick={() => { setConfirmArchiveId(confirmArchiveId === a.id ? null : a.id!); setConfirmTrashId(null) }}
className="text-xs px-2.5 py-1 rounded-lg font-medium bg-app text-ink-muted border border-line hover:bg-surface">
Archivieren
</button>
</div>
)}
{confirmTrashId === a.id && (
<div className="bg-red-50 border border-red-200 rounded-lg px-3 py-2.5 flex items-center justify-between gap-2" onClick={e => e.stopPropagation()}>
<span className="text-xs text-red-700">In den Papierkorb?</span>
<div className="flex gap-1.5">
<button onClick={() => trashAssignment(a.id!)} className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg font-medium">Ja</button>
<button onClick={() => setConfirmTrashId(null)} className="text-xs border border-line text-ink-muted px-2.5 py-1 rounded-lg">Nein</button>
</div>
</div>
)}
{confirmArchiveId === a.id && (
<div className="bg-app border border-line rounded-lg px-3 py-2.5 flex items-center justify-between gap-2" onClick={e => e.stopPropagation()}>
<span className="text-xs text-ink-muted">Archivieren?</span>
<div className="flex gap-1.5">
<button onClick={() => archiveThisAssignment(a.id!)} className="text-xs bg-ink text-white px-2.5 py-1 rounded-lg font-medium">Ja</button>
<button onClick={() => setConfirmArchiveId(null)} className="text-xs border border-line text-ink-muted px-2.5 py-1 rounded-lg">Nein</button>
</div>
</div>
)}
</div>
</div>
<span className={`flex-shrink-0 text-xs px-2 py-1 rounded-full font-medium ${
a.status === 'active' ? 'bg-green-100 text-green-700' : 'bg-gray-100 text-gray-500'
}`}>
{a.status === 'active' ? 'Aktiv' : 'Fertig'}
</span>
</div>
</div>
))}
)
})}
</div>
</div>
)
}
+146 -83
View File
@@ -1,67 +1,111 @@
import { useEffect, useState } from 'react'
import { useNavigate } from 'react-router-dom'
import { db, type Assignment, type Consultant, type Category, type Criterion, type FeedbackRating } from '../db'
import {
type Assignment, type Consultant,
type FeedbackDimension, type FeedbackCategory,
type RatingScore,
listAssignments, listConsultants,
loadFeedbackStructure,
listAssessmentsAll,
getRatingTrendWeightStep,
listDoneMeetingsChronological,
listAssignmentFeedbacksAll,
} from '../db'
import { DEFAULT_RATING_COLOR_BANDS, resolveScoreStyle } from '../config/constants'
import { buildGroupMeetingScores, computeTrend, type TrendResult } from '../utils/ratingTrend'
const ratingToNum = (r: FeedbackRating | null | undefined): number => {
const m: Record<FeedbackRating, number> = { na: 0, not_client_ready: 1, partially_client_ready: 2, nearly_client_ready: 3, client_ready: 4 }
return r ? (m[r] ?? 0) : 0
interface CatScore {
category: FeedbackCategory
avg: number | null
trend: TrendResult['trend']
}
interface InstScore {
institutee: Consultant
assignment: Assignment
scores: { criterion: Criterion; avg: number | null }[]
weightedTotal: number | null
institutee: Consultant
assignment: Assignment
catScores: CatScore[]
overall: number | null
overallTrend: TrendResult['trend']
feedbackStatus: 'none' | 'draft' | 'final'
}
function feedbackStatusBadge(status: InstScore['feedbackStatus']) {
if (status === 'final') return <span className="text-xs font-medium px-2 py-1 rounded-lg bg-green-100 text-green-700">✓ Final</span>
if (status === 'draft') return <span className="text-xs font-medium px-2 py-1 rounded-lg bg-amber-100 text-amber-700">Entwurf</span>
return <span className="text-xs font-medium px-2 py-1 rounded-lg bg-gray-100 text-gray-400">Kein Feedback</span>
}
function ratingColor(avg: number | null): string {
const rounded = avg === null ? null : Math.round(avg)
return resolveScoreStyle(rounded as RatingScore | null, DEFAULT_RATING_COLOR_BANDS).color
}
function ratingLabel(avg: number | null): string {
if (avg === null) return '—'
return avg.toFixed(1)
}
function trendArrow(trend: TrendResult['trend']) {
if (trend === 'up') return <span className="text-green-600" title="Verbesserung über die Laufzeit">↑</span>
if (trend === 'down') return <span className="text-red-600" title="Verschlechterung über die Laufzeit">↓</span>
return null
}
export default function Evaluation() {
const [data, setData] = useState<InstScore[]>([])
const [categories, setCategories] = useState<Category[]>([])
const [selected, setSelected] = useState<string | null>(null)
const [data, setData] = useState<InstScore[]>([])
const [dimensions, setDimensions] = useState<FeedbackDimension[]>([])
const [categories, setCategories] = useState<FeedbackCategory[]>([])
const [selected, setSelected] = useState<string | null>(null)
const navigate = useNavigate()
useEffect(() => {
const load = async () => {
const [assignments, consultants, criteria, cats, assessments] = await Promise.all([
db.assignments.toArray(),
db.consultants.toArray(),
db.criteria.orderBy('order').toArray(),
db.categories.orderBy('order').toArray(),
db.assessments.toArray(),
const [allAssignments, consultants, structure, assessments, weightStep, feedbacks] = await Promise.all([
listAssignments(),
listConsultants(),
loadFeedbackStructure(),
listAssessmentsAll(),
getRatingTrendWeightStep(),
listAssignmentFeedbacksAll(),
])
const { dimensions: dims, categories: cats, items } = structure
setDimensions(dims)
setCategories(cats)
// Papierkorb/Archiv ausgeschlossen — analog zum Dashboard-Filter, siehe CLAUDE.md.
const assignments = allAssignments.filter(a => !a.deletedAt && !a.archivedAt)
const rows: InstScore[] = []
for (const a of assignments) {
const meetings = await listDoneMeetingsChronological(a.id!)
const meetingIds = meetings.map(m => m.id!)
for (const instId of a.instituteeIds) {
const inst = consultants.find(c => c.id === instId)
if (!inst) continue
// Nur Meetings dieses Assignments
const meetingIds = (await db.meetingInstances.where('assignmentId').equals(a.id!).toArray()).map(m => m.id!)
const instAssessments = assessments.filter(
as => as.instituteeId === instId && meetingIds.includes(as.meetingInstanceId)
)
if (instAssessments.length === 0) continue
const usedCritIds = [...new Set(instAssessments.map(a => a.criteriaId))]
const usedCrit = criteria.filter(c => usedCritIds.includes(c.id!))
const getScore = (meetingId: number, itemId: number): RatingScore | null =>
instAssessments.find(as => as.meetingInstanceId === meetingId && as.criteriaId === itemId)?.score ?? null
const scores = usedCrit.map(crit => {
const relevant = instAssessments.filter(a => a.criteriaId === crit.id && a.score !== null)
const avg = relevant.length > 0
? relevant.reduce((s, a) => s + ratingToNum(a.score), 0) / relevant.length
: null
return { criterion: crit, avg }
const catScores: CatScore[] = cats.map(cat => {
const history = buildGroupMeetingScores(items.filter(i => i.categoryId === cat.id), meetings, getScore)
const { suggestion, trend } = computeTrend(history, weightStep)
return { category: cat, avg: suggestion, trend }
})
const rated = scores.filter(s => s.avg !== null)
const weightedTotal = rated.length > 0
? rated.reduce((s, x) => s + x.avg! * x.criterion.weight, 0) /
rated.reduce((s, x) => s + x.criterion.weight, 0)
: null
const overallHistory = buildGroupMeetingScores(items, meetings, getScore)
const { suggestion: overall, trend: overallTrend } = computeTrend(overallHistory, weightStep)
if (overall === null && catScores.every(c => c.avg === null)) continue
rows.push({ institutee: inst, assignment: a, scores, weightedTotal })
const fb = feedbacks.find(f => f.assignmentId === a.id && f.instituteeId === instId)
const feedbackStatus: InstScore['feedbackStatus'] = fb?.status === 'final' ? 'final' : fb?.status === 'draft' ? 'draft' : 'none'
rows.push({ institutee: inst, assignment: a, catScores, overall, overallTrend, feedbackStatus })
}
}
setData(rows)
@@ -69,66 +113,85 @@ export default function Evaluation() {
load()
}, [])
const scoreColor = (avg: number | null) => {
if (avg === null) return 'bg-gray-100 text-gray-400'
if (avg >= 4) return 'bg-green-100 text-green-700'
if (avg >= 3) return 'bg-yellow-100 text-yellow-700'
return 'bg-red-100 text-red-700'
}
const rowKey = (r: InstScore) => `${r.assignment.id}-${r.institutee.id}`
const assignmentGroups = data.reduce<Map<number, { assignment: Assignment; rows: InstScore[] }>>(
(map, row) => {
const key = row.assignment.id!
const group = map.get(key)
if (group) group.rows.push(row)
else map.set(key, { assignment: row.assignment, rows: [row] })
return map
},
new Map()
)
return (
<div className="space-y-4">
<h1 className="text-xl font-bold text-gray-800">Auswertung</h1>
<div className="space-y-6">
<h1 className="text-xl font-bold text-gray-800">Feedbacks</h1>
{data.length === 0 && (
<p className="text-gray-500 text-sm">Noch keine Bewertungen vorhanden.</p>
)}
{data.map(row => (
<div key={rowKey(row)} className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<div
className="flex items-start justify-between cursor-pointer"
onClick={() => setSelected(selected === rowKey(row) ? null : rowKey(row))}
>
<div>
<div className="font-semibold text-gray-800">
{row.institutee.firstName} {row.institutee.lastName}
</div>
<div className="text-xs text-gray-400">{row.assignment.title} · {row.assignment.client}</div>
</div>
<div className="flex items-center gap-2">
<div className={`px-3 py-1 rounded-full text-sm font-bold ${scoreColor(row.weightedTotal)}`}>
{row.weightedTotal !== null ? row.weightedTotal.toFixed(1) : '—'} / 5
</div>
<button
onClick={e => { e.stopPropagation(); navigate(`/assignment/${row.assignment.id}/feedback/${row.institutee.id}`) }}
className="text-xs bg-amber-100 text-amber-700 px-2 py-1 rounded-lg">
Feedback
</button>
</div>
{[...assignmentGroups.values()].map(({ assignment, rows }) => (
<div key={assignment.id} className="space-y-2">
<div className="px-1">
{assignment.assignmentNumber && (
<div className="text-xs font-semibold text-brand uppercase tracking-wide">{assignment.assignmentNumber}</div>
)}
<h2 className="font-bold text-gray-800">{assignment.title}</h2>
<div className="text-xs text-gray-400">{assignment.client}</div>
</div>
{selected === rowKey(row) && (
<div className="mt-4 space-y-3">
{categories.map(cat => {
const catScores = row.scores.filter(s => s.criterion.categoryId === cat.id)
if (catScores.every(s => s.avg === null)) return null
return (
<div key={cat.id}>
<div className="text-xs font-semibold uppercase text-gray-400 tracking-wide mb-2">{cat.name}</div>
{catScores.map(({ criterion, avg }) => (
<div key={criterion.id} className="flex items-center justify-between py-1.5 border-b border-gray-50 last:border-0">
<span className="text-sm text-gray-700">{criterion.name}</span>
<span className={`text-sm font-semibold px-2 py-0.5 rounded min-w-[36px] text-center ${scoreColor(avg)}`}>
{avg !== null ? avg.toFixed(1) : '—'}
</span>
</div>
))}
{rows.map(row => (
<div key={rowKey(row)} className="bg-white rounded-xl shadow-sm border border-gray-100 p-4">
<div
className="flex items-start justify-between cursor-pointer"
onClick={() => setSelected(selected === rowKey(row) ? null : rowKey(row))}>
<div className="font-semibold text-gray-800">
{row.institutee.firstName} {row.institutee.lastName}
</div>
<div className="flex items-center gap-2">
<div className={`px-3 py-1 rounded-full text-sm font-bold flex items-center gap-1 ${ratingColor(row.overall)}`}>
{ratingLabel(row.overall)} {trendArrow(row.overallTrend)}
</div>
)
})}
{feedbackStatusBadge(row.feedbackStatus)}
<button
onClick={e => { e.stopPropagation(); navigate(`/assignment/${row.assignment.id}/feedback/${row.institutee.id}`) }}
className="text-xs bg-amber-100 text-amber-700 px-2 py-1 rounded-lg">
Feedback
</button>
</div>
</div>
{selected === rowKey(row) && (
<div className="mt-4 space-y-4">
{dimensions.map(dim => {
const dimCats = categories.filter(c => c.dimensionId === dim.id)
const dimScores = row.catScores.filter(cs =>
dimCats.some(c => c.id === cs.category.id) && cs.avg !== null
)
if (dimScores.length === 0) return null
return (
<div key={dim.id}>
<div className="text-xs font-semibold uppercase text-gray-400 tracking-wide mb-2">
{dim.name}
</div>
{dimScores.map(({ category, avg, trend }) => (
<div key={category.id}
className="flex items-center justify-between py-1.5 border-b border-gray-50 last:border-0">
<span className="text-sm text-gray-700">{category.name}</span>
<span className={`text-xs font-semibold px-2 py-0.5 rounded flex items-center gap-1 ${ratingColor(avg)}`}>
{ratingLabel(avg)} {trendArrow(trend)}
</span>
</div>
))}
</div>
)
})}
</div>
)}
</div>
)}
))}
</div>
))}
</div>
+49 -41
View File
@@ -1,22 +1,35 @@
import { useCallback, useEffect, useRef, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom'
import {
db,
type Assignment,
type Consultant,
type Category,
type Criterion,
type FeedbackCategory,
type FeedbackCriterionItem,
type FeedbackDraft,
type FeedbackRating,
getAssignment, getConsultant,
listFeedbackCategoriesOrdered, getFeedbackCriterionItemsByIds,
listMeetingInstancesForAssignment,
listAssessmentsForMeetings,
listConversationEntriesForMeetings,
getFeedbackDraft, addFeedbackDraft, updateFeedbackDraft,
} from '../db'
import {
DEFAULT_RATING_COLOR_BANDS, isValidRatingScore, resolveScoreStyle,
} from '../config/constants'
import type { RatingScore } from '../db/types'
const ratingToNum = (r: FeedbackRating | null | undefined): number => {
const m: Record<FeedbackRating, number> = { na: 0, not_client_ready: 1, partially_client_ready: 2, nearly_client_ready: 3, client_ready: 4 }
return r ? (m[r] ?? 0) : 0
const ratingLabel = (avg: number | null): string => {
if (avg === null) return '—'
return `${avg.toFixed(1)}/10`
}
const scoreColor = (avg: number | null): string => {
const rounded = avg === null ? null : Math.round(avg)
return resolveScoreStyle(rounded as RatingScore | null, DEFAULT_RATING_COLOR_BANDS).color
}
interface CriterionSummary {
criterion: Criterion
criterion: FeedbackCriterionItem
avg: number | null
notes: string[]
}
@@ -29,7 +42,7 @@ export default function FeedbackDraftPage() {
const [assignment, setAssignment] = useState<Assignment | null>(null)
const [institutee, setInstitutee] = useState<Consultant | null>(null)
const [categories, setCategories] = useState<Category[]>([])
const [categories, setCategories] = useState<FeedbackCategory[]>([])
const [summary, setSummary] = useState<CriterionSummary[]>([])
const [draft, setDraft] = useState<FeedbackDraft | null>(null)
const [content, setContent] = useState('')
@@ -38,47 +51,50 @@ export default function FeedbackDraftPage() {
const load = useCallback(async () => {
const [a, cons, cats] = await Promise.all([
db.assignments.get(assignmentId),
db.consultants.get(instId),
db.categories.orderBy('order').toArray(),
getAssignment(assignmentId),
getConsultant(instId),
listFeedbackCategoriesOrdered(),
])
setAssignment(a ?? null)
setInstitutee(cons ?? null)
setCategories(cats)
const meetings = await db.meetingInstances.where('assignmentId').equals(assignmentId).toArray()
const meetings = await listMeetingInstancesForAssignment(assignmentId)
const meetingIds = meetings.map(m => m.id!)
const [allAssessments, allEntries] = await Promise.all([
db.assessments.where('meetingInstanceId').anyOf(meetingIds).toArray(),
db.conversationEntries.where('meetingInstanceId').anyOf(meetingIds).toArray(),
listAssessmentsForMeetings(meetingIds),
listConversationEntriesForMeetings(meetingIds),
])
const instAssessments = allAssessments.filter(a => a.instituteeId === instId)
const instEntries = allEntries.filter(e => e.instituteeId === instId)
const allLineTags = instEntries.flatMap(e => e.lineTags ?? [])
// Allgemeine Notizen sind an kein Institutee gebunden — zählen daher ungefiltert für jedes Institutee.
const generalNoteTags = meetings.flatMap(m => m.generalNoteTags ?? [])
const criteriaIds = [...new Set(instAssessments.map(a => a.criteriaId))]
const crits = criteriaIds.length > 0
? await db.criteria.where('id').anyOf(criteriaIds).toArray()
: []
const criteriaIds = [...new Set([
...instAssessments.map(a => a.criteriaId),
...allLineTags.map(t => t.criterionItemId),
...generalNoteTags.map(t => t.criterionItemId),
])]
const crits = await getFeedbackCriterionItemsByIds(criteriaIds)
const sum: CriterionSummary[] = crits.map(crit => {
const relevant = instAssessments.filter(a => a.criteriaId === crit.id && a.score !== null)
const relevant = instAssessments.filter(a => a.criteriaId === crit.id && isValidRatingScore(a.score))
const avg = relevant.length > 0
? relevant.reduce((s, a) => s + ratingToNum(a.score), 0) / relevant.length
? relevant.reduce((s, a) => s + (a.score as number), 0) / relevant.length
: null
const notes = [
...instAssessments.filter(a => a.criteriaId === crit.id && a.note).map(a => a.note),
...instEntries.filter(e => e.note).map(e => e.note),
].filter(Boolean)
...allLineTags.filter(t => t.criterionItemId === crit.id).map(t => t.text),
...generalNoteTags.filter(t => t.criterionItemId === crit.id).map(t => t.text),
]
return { criterion: crit, avg, notes }
})
setSummary(sum)
const existing = await db.feedbackDrafts
.where('assignmentId').equals(assignmentId)
.filter(d => d.instituteeId === instId)
.first()
const existing = await getFeedbackDraft(assignmentId, instId)
if (existing) {
setDraft(existing)
setContent(existing.content)
@@ -104,8 +120,7 @@ export default function FeedbackDraftPage() {
for (const [catId, items] of grouped) {
text += `## ${catMap.get(catId) ?? 'Sonstige'}\n`
for (const item of items) {
const avgStr = item.avg !== null ? item.avg.toFixed(1) : '—'
text += `${item.criterion.name}: ${avgStr}/5\n`
text += `${item.criterion.name}: ${ratingLabel(item.avg)}\n`
if (item.notes.length > 0) {
const uniqueNotes = [...new Set(item.notes)]
text += uniqueNotes.map(n => ` • ${n}`).join('\n') + '\n'
@@ -120,10 +135,10 @@ export default function FeedbackDraftPage() {
const now = new Date().toISOString()
if (draft?.id) {
await db.feedbackDrafts.update(draft.id, { content: text, updatedAt: now })
await updateFeedbackDraft(draft.id, { content: text, updatedAt: now })
setDraft(prev => prev ? { ...prev, content: text, updatedAt: now } : null)
} else {
const newId = await db.feedbackDrafts.add({
const newId = await addFeedbackDraft({
assignmentId, instituteeId: instId, content: text, updatedAt: now,
})
setDraft({ id: newId, assignmentId, instituteeId: instId, content: text, updatedAt: now })
@@ -136,9 +151,9 @@ export default function FeedbackDraftPage() {
saveTimer.current = setTimeout(async () => {
const now = new Date().toISOString()
if (draft?.id) {
await db.feedbackDrafts.update(draft.id, { content: val, updatedAt: now })
await updateFeedbackDraft(draft.id, { content: val, updatedAt: now })
} else {
const newId = await db.feedbackDrafts.add({
const newId = await addFeedbackDraft({
assignmentId, instituteeId: instId, content: val, updatedAt: now,
})
setDraft({ id: newId, assignmentId, instituteeId: instId, content: val, updatedAt: now })
@@ -146,13 +161,6 @@ export default function FeedbackDraftPage() {
}, 600)
}
const scoreColor = (avg: number | null) => {
if (avg === null) return 'bg-gray-100 text-gray-400'
if (avg >= 4) return 'bg-green-100 text-green-700'
if (avg >= 3) return 'bg-yellow-100 text-yellow-700'
return 'bg-red-100 text-red-700'
}
if (!assignment || !institutee) return <div className="text-center py-10 text-gray-400">Lädt…</div>
return (
@@ -179,7 +187,7 @@ export default function FeedbackDraftPage() {
className="flex items-center justify-between py-1.5 border-b border-gray-50 last:border-0">
<span className="text-sm text-gray-700">{s.criterion.name}</span>
<span className={`text-sm font-semibold px-2 py-0.5 rounded min-w-[40px] text-center ${scoreColor(s.avg)}`}>
{s.avg !== null ? s.avg.toFixed(1) : '—'}
{ratingLabel(s.avg)}
</span>
</div>
))}
+462 -115
View File
@@ -1,39 +1,87 @@
import { useEffect, useState } from 'react'
import { db, type FeedbackDimension, type FeedbackCategory, type FeedbackCriterionItem, type AssignmentType, type PhaseTemplate } from '../db'
import {
type FeedbackDimension, type FeedbackCategory, type FeedbackCriterionItem, type CriterionUsage, type CriterionUsageInstance,
loadFeedbackStructure,
addFeedbackDimension, updateFeedbackDimension, deleteFeedbackDimension,
addFeedbackCategory, updateFeedbackCategory, deleteFeedbackCategory,
addFeedbackCriterionItem, updateFeedbackCriterionItem, deleteFeedbackCriterionItem,
getCriterionUsageMap, reassignCriterionReferences,
getCriterionUsageDetails, reassignUsageInstance, removeUsageInstance,
preloadFinalFeedbackStructure, importFeedbackStructureFromMarkdown,
} from '../db'
import { exportFeedbackStructureAsMarkdown } from '../utils/structureExport'
import { exportFeedbackStructurePdf } from '../utils/pdfExport'
import { criterionOptionGroups } from '../utils/criterionOptions'
import { summarizeFeedbackStructureSeed, parseFeedbackStructureMarkdown } from '../utils/feedbackStructureImport'
const totalUsage = (u: CriterionUsage | undefined): number =>
!u ? 0 : u.assessmentCount + u.lineTagCount + u.generalNoteTagCount + u.assignmentTypeNames.length + u.phaseTemplateLabels.length
const instanceKindLabel: Record<CriterionUsageInstance['kind'], string> = {
assessment: 'Bewertung',
lineTag: 'Protokollzeile',
generalNoteTag: 'Allgemeine Notiz',
assignmentTypeVisibility: 'Sichtbarkeit (Assignment-Typ)',
phaseTemplateVisibility: 'Sichtbarkeit (Phase)',
}
/** Die drei "Daten"-Kinds haben Meeting/Person-Kontext, die zwei "Sichtbarkeits"-Kinds nicht. */
const isDataInstance = (
instance: CriterionUsageInstance,
): instance is Extract<CriterionUsageInstance, { kind: 'assessment' | 'lineTag' | 'generalNoteTag' }> =>
instance.kind === 'assessment' || instance.kind === 'lineTag' || instance.kind === 'generalNoteTag'
/**
* Stabiler, inhaltsbasierter Schlüssel statt Array-Index — der Index verschiebt sich nach jedem
* Übertragen/Entfernen, weil die Instanzen-Liste neu vom Server geladen wird. Mit dem Index als
* Schlüssel hingen ausgewählte Ziel-Kriterien danach plötzlich an der falschen (neu an dieser
* Position stehenden) Instanz.
*/
const instanceKey = (instance: CriterionUsageInstance): string => {
switch (instance.kind) {
case 'assessment': return `assessment:${instance.assessmentId}`
case 'lineTag': return `lineTag:${instance.conversationEntryId}:${instance.tagText}`
case 'generalNoteTag': return `generalNoteTag:${instance.meetingInstanceId}:${instance.tagText}`
case 'assignmentTypeVisibility': return `atVis:${instance.assignmentTypeId}`
case 'phaseTemplateVisibility': return `ptVis:${instance.phaseTemplateId}`
}
}
export default function FeedbackStructureConfig() {
const [dimensions, setDimensions] = useState<FeedbackDimension[]>([])
const [categories, setCategories] = useState<FeedbackCategory[]>([])
const [items, setItems] = useState<FeedbackCriterionItem[]>([])
const [assignmentTypes, setAssignmentTypes] = useState<AssignmentType[]>([])
const [usageMap, setUsageMap] = useState<Record<number, CriterionUsage>>({})
const [usageDetails, setUsageDetails] = useState<Record<number, CriterionUsageInstance[]>>({})
const [loadingUsage, setLoadingUsage] = useState<Set<number>>(new Set())
const [instanceTarget, setInstanceTarget] = useState<Record<string, number>>({})
const [instanceNotice, setInstanceNotice] = useState<Record<number, string>>({})
const [expanded, setExpanded] = useState<Set<number>>(new Set())
const [expandedCat, setExpandedCat] = useState<Set<number>>(new Set())
const [showCatalogs, setShowCatalogs] = useState(false)
const [phaseTemplates, setPhaseTemplates] = useState<PhaseTemplate[]>([])
const [showTypeConfig, setShowTypeConfig] = useState(false)
const [expandedType, setExpandedType] = useState<number | null>(null)
const [newTypeName, setNewTypeName] = useState('')
const [newPhase, setNewPhase] = useState<Record<number, { label: string; withWhom: 'lead'|'client'; isRepeatable: boolean; hasConversation: boolean; hasAssessment: boolean }>>({})
const [typeError, setTypeError] = useState<Record<number, string>>({})
const [expandedUsage, setExpandedUsage] = useState<Set<number>>(new Set())
// Neue Einträge
const [newDimName, setNewDimName] = useState('')
const [newCatName, setNewCatName] = useState<Record<number, string>>({})
const [newItemName, setNewItemName] = useState<Record<number, string>>({})
const [exportingPdf, setExportingPdf] = useState(false)
const [importingStructure, setImportingStructure] = useState(false)
const [importNotice, setImportNotice] = useState<string | null>(null)
const [confirmPreload, setConfirmPreload] = useState(false)
// Lösch-Bestätigungen & Übertragen-auf-anderes-Kriterium
const [confirmDeleteDimId, setConfirmDeleteDimId] = useState<number | null>(null)
const [confirmDeleteCatId, setConfirmDeleteCatId] = useState<number | null>(null)
const [confirmDeleteItemId, setConfirmDeleteItemId] = useState<number | null>(null)
const [reassignTarget, setReassignTarget] = useState<Record<number, number>>({})
const [mergeNotice, setMergeNotice] = useState('')
const load = async () => {
const [dims, cats, itms, types, phases] = await Promise.all([
db.feedbackDimensions.orderBy('order').toArray(),
db.feedbackCategories.orderBy('order').toArray(),
db.feedbackCriterionItems.orderBy('order').toArray(),
db.assignmentTypes.toArray(),
db.phaseTemplates.toArray(),
])
setDimensions(dims)
setCategories(cats)
setItems(itms)
setAssignmentTypes(types)
setPhaseTemplates(phases)
const [structure, usage] = await Promise.all([loadFeedbackStructure(), getCriterionUsageMap()])
setDimensions(structure.dimensions)
setCategories(structure.categories)
setItems(structure.items)
setUsageMap(usage)
}
useEffect(() => { load() }, [])
@@ -43,24 +91,29 @@ export default function FeedbackStructureConfig() {
const addDimension = async () => {
if (!newDimName.trim()) return
const maxOrder = dimensions.reduce((m, d) => Math.max(m, d.order), 0)
const id = await db.feedbackDimensions.add({ name: newDimName.trim(), order: maxOrder + 1 })
const id = await addFeedbackDimension({ name: newDimName.trim(), order: maxOrder + 1 })
setNewDimName('')
await load()
setExpanded(prev => new Set([...prev, id]))
}
const updateDimension = async (id: number, name: string) => {
await db.feedbackDimensions.update(id, { name })
const updateDimension = (id: number, name: string) => {
setDimensions(prev => prev.map(d => d.id === id ? { ...d, name } : d))
updateFeedbackDimension(id, { name })
}
const dimensionUsageTotal = (dimId: number): number =>
categories.filter(c => c.dimensionId === dimId)
.reduce((sum, cat) => sum + categoryUsageTotal(cat.id!), 0)
const requestDeleteDimension = (id: number) => {
if (dimensionUsageTotal(id) === 0) { deleteDimension(id); return }
setConfirmDeleteDimId(id)
}
const deleteDimension = async (id: number) => {
const cats = await db.feedbackCategories.where('dimensionId').equals(id).toArray()
for (const cat of cats) {
await db.feedbackCriterionItems.where('categoryId').equals(cat.id!).delete()
}
await db.feedbackCategories.where('dimensionId').equals(id).delete()
await db.feedbackDimensions.delete(id)
await deleteFeedbackDimension(id)
setConfirmDeleteDimId(null)
await load()
}
@@ -69,8 +122,8 @@ export default function FeedbackStructureConfig() {
const idx = sorted.findIndex(d => d.id === dim.id)
const other = sorted[idx + dir]
if (!other) return
await db.feedbackDimensions.update(dim.id!, { order: other.order })
await db.feedbackDimensions.update(other.id!, { order: dim.order })
await updateFeedbackDimension(dim.id!, { order: other.order })
await updateFeedbackDimension(other.id!, { order: dim.order })
await load()
}
@@ -81,20 +134,33 @@ export default function FeedbackStructureConfig() {
if (!name) return
const dimCats = categories.filter(c => c.dimensionId === dimId)
const maxOrder = dimCats.reduce((m, c) => Math.max(m, c.order), 0)
const id = await db.feedbackCategories.add({ dimensionId: dimId, name, order: maxOrder + 1 })
const id = await addFeedbackCategory({ dimensionId: dimId, name, order: maxOrder + 1 })
setNewCatName(prev => ({ ...prev, [dimId]: '' }))
await load()
setExpandedCat(prev => new Set([...prev, id]))
}
const updateCategory = async (id: number, name: string) => {
await db.feedbackCategories.update(id, { name })
const updateCategory = (id: number, name: string) => {
setCategories(prev => prev.map(c => c.id === id ? { ...c, name } : c))
updateFeedbackCategory(id, { name })
}
const updateCategoryDescription = (id: number, description: string) => {
setCategories(prev => prev.map(c => c.id === id ? { ...c, description } : c))
updateFeedbackCategory(id, { description })
}
const categoryUsageTotal = (catId: number): number =>
items.filter(i => i.categoryId === catId).reduce((sum, i) => sum + totalUsage(usageMap[i.id!]), 0)
const requestDeleteCategory = (id: number) => {
if (categoryUsageTotal(id) === 0) { deleteCategory(id); return }
setConfirmDeleteCatId(id)
}
const deleteCategory = async (id: number) => {
await db.feedbackCriterionItems.where('categoryId').equals(id).delete()
await db.feedbackCategories.delete(id)
await deleteFeedbackCategory(id)
setConfirmDeleteCatId(null)
await load()
}
@@ -105,95 +171,225 @@ export default function FeedbackStructureConfig() {
if (!name) return
const catItems = items.filter(i => i.categoryId === catId)
const maxOrder = catItems.reduce((m, i) => Math.max(m, i.order), 0)
await db.feedbackCriterionItems.add({ categoryId: catId, name, order: maxOrder + 1 })
await addFeedbackCriterionItem({ categoryId: catId, name, order: maxOrder + 1 })
setNewItemName(prev => ({ ...prev, [catId]: '' }))
await load()
}
const updateItem = async (id: number, name: string) => {
await db.feedbackCriterionItems.update(id, { name })
const updateItem = (id: number, name: string) => {
setItems(prev => prev.map(i => i.id === id ? { ...i, name } : i))
updateFeedbackCriterionItem(id, { name })
}
const requestDeleteItem = (id: number) => {
if (totalUsage(usageMap[id]) === 0) { deleteItem(id); return }
setMergeNotice('')
setConfirmDeleteItemId(id)
}
const deleteItem = async (id: number) => {
await db.feedbackCriterionItems.delete(id)
await deleteFeedbackCriterionItem(id)
setItems(prev => prev.filter(i => i.id !== id))
setConfirmDeleteItemId(null)
await load()
}
const updateItemWeight = async (id: number, weight: number) => {
await db.feedbackCriterionItems.update(id, { weight })
const reassignAndDeleteItem = async (fromId: number) => {
const toId = reassignTarget[fromId]
if (!toId) return
const { mergedConflicts } = await reassignCriterionReferences(fromId, toId)
await deleteFeedbackCriterionItem(fromId)
setConfirmDeleteItemId(null)
setMergeNotice(mergedConflicts > 0 ? `${mergedConflicts} Bewertung(en) wurden dabei mit bereits vorhandenen Bewertungen des Ziel-Kriteriums zusammengeführt.` : '')
await load()
}
const updateItemWeight = (id: number, weight: number) => {
setItems(prev => prev.map(i => i.id === id ? { ...i, weight } : i))
updateFeedbackCriterionItem(id, { weight })
}
const toggleCatalogCategory = async (type: AssignmentType, catId: number) => {
const current = type.criteriaIds ?? []
const next = current.includes(catId) ? current.filter(id => id !== catId) : [...current, catId]
await db.assignmentTypes.update(type.id!, { criteriaIds: next })
setAssignmentTypes(prev => prev.map(t => t.id === type.id ? { ...t, criteriaIds: next } : t))
const updateItemDescription = (id: number, description: string) => {
setItems(prev => prev.map(i => i.id === id ? { ...i, description } : i))
updateFeedbackCriterionItem(id, { description })
}
// ── AssignmentType CRUD ───────────────────────────────────────────────────
const addAssignmentType = async () => {
if (!newTypeName.trim()) return
await db.assignmentTypes.add({ name: newTypeName.trim(), defaultPhaseKeys: [] })
setNewTypeName('')
await load()
const moveItemToCategory = (itemId: number, newCategoryId: number) => {
setItems(prev => prev.map(i => i.id === itemId ? { ...i, categoryId: newCategoryId } : i))
updateFeedbackCriterionItem(itemId, { categoryId: newCategoryId })
}
const updateAssignmentTypeName = async (id: number, name: string) => {
await db.assignmentTypes.update(id, { name })
setAssignmentTypes(prev => prev.map(t => t.id === id ? { ...t, name } : t))
}
const deleteAssignmentType = async (id: number) => {
const count = await db.assignments.where('assignmentTypeId').equals(id).count()
if (count > 0) {
setTypeError(prev => ({ ...prev, [id]: `Kann nicht gelöscht werden – ${count} Assignment(s) verwenden diesen Typ.` }))
return
}
await db.phaseTemplates.where('assignmentTypeId').equals(id).delete()
await db.assignmentTypes.delete(id)
setTypeError(prev => { const n = { ...prev }; delete n[id]; return n })
await load()
}
// ── PhaseTemplate CRUD ────────────────────────────────────────────────────
const addPhaseTemplate = async (typeId: number) => {
const p = newPhase[typeId]
if (!p?.label.trim()) return
const existing = phaseTemplates.filter(t => t.assignmentTypeId === typeId)
await db.phaseTemplates.add({
assignmentTypeId: typeId,
phaseKey: p.label.trim().toLowerCase().replace(/\s+/g, '_'),
label: p.label.trim(),
withWhom: p.withWhom,
isRepeatable: p.isRepeatable,
hasConversation: p.hasConversation,
hasAssessment: p.hasAssessment,
criteriaIds: [],
order: existing.length + 1,
const toggleUsageExpanded = async (itemId: number) => {
const willOpen = !expandedUsage.has(itemId)
setExpandedUsage(prev => {
const next = new Set(prev)
if (next.has(itemId)) next.delete(itemId); else next.add(itemId)
return next
})
setNewPhase(prev => ({ ...prev, [typeId]: { label: '', withWhom: 'lead', isRepeatable: false, hasConversation: false, hasAssessment: false } }))
await load()
if (willOpen && !usageDetails[itemId]) {
setLoadingUsage(prev => new Set(prev).add(itemId))
const details = await getCriterionUsageDetails(itemId)
setUsageDetails(prev => ({ ...prev, [itemId]: details }))
setLoadingUsage(prev => { const next = new Set(prev); next.delete(itemId); return next })
}
}
const updatePhaseTemplate = async (id: number, fields: Partial<PhaseTemplate>) => {
await db.phaseTemplates.update(id, fields)
setPhaseTemplates(prev => prev.map(t => t.id === id ? { ...t, ...fields } : t))
const refreshUsageAfterInstanceChange = async (itemId: number) => {
const [details, usage] = await Promise.all([getCriterionUsageDetails(itemId), getCriterionUsageMap()])
setUsageDetails(prev => ({ ...prev, [itemId]: details }))
setUsageMap(usage)
}
const deletePhaseTemplate = async (id: number) => {
await db.phaseTemplates.delete(id)
setPhaseTemplates(prev => prev.filter(t => t.id !== id))
const reassignOneInstance = async (itemId: number, instance: CriterionUsageInstance) => {
const key = `${itemId}:${instanceKey(instance)}`
const toId = instanceTarget[key]
if (!toId) return
const { merged } = await reassignUsageInstance(instance, toId)
setInstanceTarget(prev => { const next = { ...prev }; delete next[key]; return next })
setInstanceNotice(prev => ({ ...prev, [itemId]: merged ? 'Mit vorhandener Bewertung des Ziel-Kriteriums zusammengeführt.' : 'Übertragen.' }))
await refreshUsageAfterInstanceChange(itemId)
}
const removeOneInstance = async (itemId: number, instance: CriterionUsageInstance) => {
await removeUsageInstance(instance)
setInstanceNotice(prev => ({ ...prev, [itemId]: 'Zuordnung entfernt.' }))
await refreshUsageAfterInstanceChange(itemId)
}
const runPreloadFinal = async () => {
setImportingStructure(true)
setImportNotice(null)
setConfirmPreload(false)
try {
const result = await preloadFinalFeedbackStructure()
setImportNotice(
`Finale Struktur geladen: ${result.dimensions} Dimensionen, ${result.categories} Kategorien, ${result.items} Kriterien`
+ (result.clearedDimensions ? ` (vorher ${result.clearedDimensions} Dimensionen ersetzt)` : ''),
)
await load()
} catch (e) {
setImportNotice(`Import fehlgeschlagen: ${e instanceof Error ? e.message : String(e)}`)
} finally {
setImportingStructure(false)
}
}
const importMarkdownFile = async (file: File) => {
setImportingStructure(true)
setImportNotice(null)
try {
const md = await file.text()
const seed = parseFeedbackStructureMarkdown(md)
const sum = summarizeFeedbackStructureSeed(seed)
const result = await importFeedbackStructureFromMarkdown(md)
setImportNotice(
`MD importiert: ${result.dimensions} Dimensionen, ${result.categories} Kategorien, ${result.items} Kriterien`
+ ` (Datei: ${sum.items} Kriterien erkannt)`,
)
await load()
} catch (e) {
setImportNotice(`MD-Import fehlgeschlagen: ${e instanceof Error ? e.message : String(e)}`)
} finally {
setImportingStructure(false)
}
}
const sorted = [...dimensions].sort((a, b) => a.order - b.order)
return (
<div className="space-y-4">
<h2 className="text-lg font-bold text-gray-800">Feedback-Dimensionen & Kategorien</h2>
<div className="flex items-center justify-between gap-2 flex-wrap">
<h2 className="text-lg font-bold text-gray-800">Feedback-Dimensionen & Kategorien</h2>
<div className="flex gap-1.5 flex-shrink-0 flex-wrap">
{!confirmPreload ? (
<button
onClick={() => setConfirmPreload(true)}
disabled={importingStructure}
className="text-xs px-2.5 py-1.5 border border-brand/30 rounded-lg text-brand hover:bg-brand/5 transition disabled:opacity-50">
Preload final
</button>
) : (
<div className="flex gap-1">
<button
onClick={runPreloadFinal}
disabled={importingStructure}
className="text-xs px-2.5 py-1.5 bg-brand text-white rounded-lg disabled:opacity-50">
{importingStructure ? '…' : 'Ersetzen bestätigen'}
</button>
<button onClick={() => setConfirmPreload(false)}
className="text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500">
Abbrechen
</button>
</div>
)}
<label className={`text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition cursor-pointer ${importingStructure ? 'opacity-50 pointer-events-none' : ''}`}>
↑ MD
<input
type="file"
accept=".md,text/markdown,text/plain"
className="hidden"
onChange={e => {
const file = e.target.files?.[0]
if (file) importMarkdownFile(file)
e.target.value = ''
}}
/>
</label>
<button onClick={() => exportFeedbackStructureAsMarkdown()}
className="text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition">
⬇ MD
</button>
<button
onClick={async () => { setExportingPdf(true); try { await exportFeedbackStructurePdf() } finally { setExportingPdf(false) } }}
disabled={exportingPdf}
className="text-xs px-2.5 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition disabled:opacity-50">
{exportingPdf ? '⏳' : '⬇ PDF'}
</button>
</div>
</div>
{importNotice && (
<div className="rounded-xl px-4 py-3 text-sm bg-blue-50 text-blue-800 border border-blue-200">
{importNotice}
</div>
)}
{confirmPreload && (
<div className="rounded-xl px-4 py-3 text-sm bg-amber-50 text-amber-800 border border-amber-200">
Ersetzt die gesamte Feedback-Struktur durch die finale Preload-Datei
(<code className="mx-1 text-xs bg-amber-100 px-1 rounded">docs/preload/Feedback-Struktur-final.md</code>
(3 Dimensionen, 16 Kategorien, 109 Kriterien). Bestehende Dimensionen/Kategorien/Kriterien werden gelöscht.
</div>
)}
{/* Fokus-Übersicht: was wird über alle Bewerter hinweg am häufigsten kommentiert (siehe CLAUDE.md „Beobachter-Fokus") */}
{items.length > 0 && (
<details className="bg-white rounded-xl border border-gray-100 shadow-sm p-3">
<summary className="text-sm font-semibold text-gray-700 cursor-pointer select-none">📊 Fokus-Übersicht — am häufigsten kommentierte Kriterien</summary>
<div className="mt-2 space-y-1.5">
{[...items]
.sort((a, b) => totalUsage(usageMap[b.id!]) - totalUsage(usageMap[a.id!]))
.slice(0, 5)
.filter(i => totalUsage(usageMap[i.id!]) > 0)
.map(i => (
<div key={i.id} className="flex items-start justify-between gap-2 text-xs">
<div className="min-w-0">
<span className="font-medium text-gray-700">{i.name}</span>
{i.learnedPatternHints && (
<div className="text-gray-400 truncate">{i.learnedPatternHints}</div>
)}
</div>
<span className="flex-shrink-0 bg-blue-50 text-blue-700 border border-blue-200 px-1.5 py-0.5 rounded-full font-semibold">
{totalUsage(usageMap[i.id!])}
</span>
</div>
))}
{items.every(i => totalUsage(usageMap[i.id!]) === 0) && (
<div className="text-xs text-gray-400">Noch keine Verwendungen erfasst.</div>
)}
</div>
</details>
)}
{/* Neue Dimension */}
<div className="flex gap-2">
@@ -235,10 +431,22 @@ export default function FeedbackStructureConfig() {
if (next.has(dim.id!)) next.delete(dim.id!); else next.add(dim.id!)
return next
})} className="text-xs text-gray-400 px-1">{isOpen ? '▲' : '▼'}</button>
<button onClick={() => deleteDimension(dim.id!)}
<button onClick={() => requestDeleteDimension(dim.id!)}
className="text-xs text-red-300 hover:text-red-500 px-1">🗑</button>
</div>
{confirmDeleteDimId === dim.id && (
<div className="px-3 py-2 bg-red-50 border-b border-red-100 flex items-center justify-between gap-2">
<span className="text-xs text-red-700">
Diese Dimension enthält Kriterien mit insgesamt {dimensionUsageTotal(dim.id!)} Verwendung(en) — werden beim Löschen mit entfernt.
</span>
<div className="flex gap-1.5 flex-shrink-0">
<button onClick={() => deleteDimension(dim.id!)} className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg font-medium">Trotzdem löschen</button>
<button onClick={() => setConfirmDeleteDimId(null)} className="text-xs border border-gray-200 text-gray-500 px-2.5 py-1 rounded-lg">Abbrechen</button>
</div>
</div>
)}
{isOpen && (
<div className="p-3 space-y-3">
{dimCats.map(cat => {
@@ -257,31 +465,170 @@ export default function FeedbackStructureConfig() {
if (next.has(cat.id!)) next.delete(cat.id!); else next.add(cat.id!)
return next
})} className="text-xs text-gray-400">{isCatOpen ? '▲' : '▼'}</button>
<button onClick={() => deleteCategory(cat.id!)}
<button onClick={() => requestDeleteCategory(cat.id!)}
className="text-xs text-red-300 hover:text-red-500">🗑</button>
</div>
<input
className="w-full px-3 py-1.5 text-xs text-gray-400 border-b border-gray-100 focus:outline-none focus:border-brand bg-white"
placeholder="Erläuterung, welche Themen/Beobachtungen in diese Kategorie einzahlen (optional, fließt in KI-Prompts ein)…"
value={cat.description ?? ''}
onChange={e => updateCategoryDescription(cat.id!, e.target.value)}
/>
{confirmDeleteCatId === cat.id && (
<div className="px-3 py-2 bg-red-50 border-b border-red-100 flex items-center justify-between gap-2">
<span className="text-xs text-red-700">
Diese Kategorie enthält Kriterien mit insgesamt {categoryUsageTotal(cat.id!)} Verwendung(en) — werden beim Löschen mit entfernt.
</span>
<div className="flex gap-1.5 flex-shrink-0">
<button onClick={() => deleteCategory(cat.id!)} className="text-xs bg-red-600 text-white px-2.5 py-1 rounded-lg font-medium">Trotzdem löschen</button>
<button onClick={() => setConfirmDeleteCatId(null)} className="text-xs border border-gray-200 text-gray-500 px-2.5 py-1 rounded-lg">Abbrechen</button>
</div>
</div>
)}
{isCatOpen && (
<div className="p-2 space-y-1.5">
{catItems.map(item => (
<div key={item.id} className="flex items-center gap-2">
<span className="text-gray-300 text-xs">·</span>
{catItems.map(item => {
const usage = usageMap[item.id!]
const usageCount = totalUsage(usage)
const isUsageOpen = expandedUsage.has(item.id!)
return (
<div key={item.id} className="space-y-0.5">
<div className="flex items-center gap-2">
<span className="text-gray-300 text-xs">·</span>
<input
className="flex-1 text-xs text-gray-600 border-b border-transparent focus:border-gray-300 focus:outline-none bg-transparent py-0.5"
value={item.name}
onChange={e => updateItem(item.id!, e.target.value)}
/>
<input
type="number" min={0} max={2} step={0.1}
value={item.weight ?? 1}
onChange={e => updateItemWeight(item.id!, Number(e.target.value))}
title="Gewichtung"
className="w-14 text-xs border border-gray-200 rounded px-1 py-0.5 text-gray-500 bg-white focus:outline-none focus:border-brand"
/>
<select
value=""
onChange={e => e.target.value && moveItemToCategory(item.id!, Number(e.target.value))}
title="In andere Kategorie verschieben"
className="text-xs border border-gray-200 rounded px-1 py-0.5 text-gray-500 bg-white focus:outline-none focus:border-brand max-w-[7rem]">
<option value="">Verschieben…</option>
{sorted.map(d => {
const dimCats = categories.filter(c => c.dimensionId === d.id && c.id !== item.categoryId).sort((a, b) => a.order - b.order)
if (dimCats.length === 0) return null
return (
<optgroup key={d.id} label={d.name}>
{dimCats.map(c => <option key={c.id} value={c.id}>{c.name}</option>)}
</optgroup>
)
})}
</select>
<button onClick={() => requestDeleteItem(item.id!)}
className="text-xs text-red-200 hover:text-red-400">×</button>
</div>
<input
className="flex-1 text-xs text-gray-600 border-b border-transparent focus:border-gray-300 focus:outline-none bg-transparent py-0.5"
value={item.name}
onChange={e => updateItem(item.id!, e.target.value)}
className="w-full ml-3.5 text-xs text-gray-400 border-b border-transparent focus:border-gray-300 focus:outline-none bg-transparent py-0.5"
placeholder="Beschreibung, worauf zu achten ist (optional, fließt in KI-Prompts ein)…"
value={item.description ?? ''}
onChange={e => updateItemDescription(item.id!, e.target.value)}
/>
<select
value={item.weight ?? 1}
onChange={e => updateItemWeight(item.id!, Number(e.target.value))}
title="Gewichtung"
className="text-xs border border-gray-200 rounded px-1 py-0.5 text-gray-500 bg-white focus:outline-none focus:border-brand">
{[1,2,3,4,5].map(w => <option key={w} value={w}>×{w}</option>)}
</select>
<button onClick={() => deleteItem(item.id!)}
className="text-xs text-red-200 hover:text-red-400">×</button>
{usageCount > 0 && (
<div className="ml-3.5">
<button onClick={() => toggleUsageExpanded(item.id!)}
className="text-xs bg-indigo-50 text-indigo-600 border border-indigo-100 px-1.5 py-0.5 rounded-full">
{usageCount} Verwendung(en) {isUsageOpen ? '▲' : '▼'}
</button>
{isUsageOpen && (
<div className="mt-1 space-y-1.5">
{instanceNotice[item.id!] && (
<div className="text-xs text-indigo-600 bg-indigo-50 border border-indigo-100 rounded-lg px-2 py-1">
{instanceNotice[item.id!]}
</div>
)}
{loadingUsage.has(item.id!) && <div className="text-xs text-gray-400">Lädt…</div>}
{(usageDetails[item.id!] ?? []).map(instance => {
const key = `${item.id}:${instanceKey(instance)}`
return (
<div key={key} className="bg-gray-50 border border-gray-100 rounded-lg p-1.5 space-y-1">
<div className="text-xs text-gray-600">
<span className="font-medium">{instanceKindLabel[instance.kind]}</span>
{isDataInstance(instance) && (
<>
{' · '}{instance.assignmentTitle} ({instance.date ? new Date(instance.date).toLocaleDateString('de-DE') : '—'})
{' · '}{instance.personLabel}
</>
)}
<div className="text-gray-400 truncate">{instance.text}</div>
</div>
<div className="flex items-center gap-1 flex-wrap">
<select
value={instanceTarget[key] ?? ''}
onChange={e => setInstanceTarget(prev => ({ ...prev, [key]: Number(e.target.value) }))}
className="text-xs border border-gray-200 rounded px-1 py-0.5 bg-white focus:outline-none">
<option value="">→ anderes Kriterium…</option>
{criterionOptionGroups(dimensions, categories, items, item.id)}
</select>
<button
onClick={() => reassignOneInstance(item.id!, instance)}
disabled={!instanceTarget[key]}
className="text-xs bg-indigo-600 text-white px-1.5 py-0.5 rounded font-medium disabled:opacity-40">
Übertragen
</button>
<button
onClick={() => removeOneInstance(item.id!, instance)}
className="text-xs bg-red-100 text-red-600 px-1.5 py-0.5 rounded font-medium">
Entfernen
</button>
</div>
</div>
)
})}
</div>
)}
</div>
)}
{confirmDeleteItemId === item.id && (
<div className="ml-3.5 bg-red-50 border border-red-200 rounded-lg p-2 space-y-1.5">
<div className="text-xs text-red-700">
Wird an {usageCount} Stelle(n) verwendet. „Übertragen" verschiebt alle Bewertungen/Zuordnungen auf ein anderes Kriterium (kein Datenverlust). „Trotzdem löschen" entfernt Bewertungen vollständig, Protokollzeilen bleiben als Text erhalten, nur die Zuordnung geht verloren.
</div>
<div className="flex items-center gap-1.5 flex-wrap">
<select
value={reassignTarget[item.id!] ?? ''}
onChange={e => setReassignTarget(prev => ({ ...prev, [item.id!]: Number(e.target.value) }))}
className="text-xs border border-red-200 rounded px-1.5 py-1 bg-white focus:outline-none">
<option value="">Übertragen auf…</option>
{criterionOptionGroups(dimensions, categories, items, item.id)}
</select>
<button
onClick={() => reassignAndDeleteItem(item.id!)}
disabled={!reassignTarget[item.id!]}
className="text-xs bg-indigo-600 text-white px-2 py-1 rounded-lg font-medium disabled:opacity-40">
Übertragen & löschen
</button>
<button onClick={() => deleteItem(item.id!)}
className="text-xs bg-red-600 text-white px-2 py-1 rounded-lg font-medium">
Trotzdem löschen
</button>
<button onClick={() => setConfirmDeleteItemId(null)}
className="text-xs border border-gray-200 text-gray-500 px-2 py-1 rounded-lg">
Abbrechen
</button>
</div>
</div>
)}
</div>
))}
)
})}
{mergeNotice && (
<div className="text-xs text-indigo-600 bg-indigo-50 border border-indigo-100 rounded-lg px-2 py-1.5">
{mergeNotice}
</div>
)}
<div className="flex gap-1.5 mt-1">
<input
className="flex-1 border border-gray-200 rounded px-2 py-1 text-xs focus:outline-none focus:border-brand"
+267
View File
@@ -0,0 +1,267 @@
import { useEffect, useRef, useState } from 'react'
import { useNavigate, useParams } from 'react-router-dom'
import {
type Assignment, type PhaseTemplate, type MeetingInstance, type Consultant,
type FeedbackCategory, type FeedbackCriterionItem, type ConversationEntry, type Assessment, type RatingScore,
type ChecklistItemDef, type ChecklistResponse,
getAssignment, getAssignmentType,
listPhaseTemplatesForType,
listDoneMeetingsChronological,
getConsultantsByIds,
loadFeedbackStructure, resolveVisibleStructure,
listConversationEntriesForMeetings,
listAssessmentsForMeetings,
listMeetingCategoryRatingsForMeetings,
listChecklistItemDefsForPhaseTemplates,
listChecklistResponsesForMeetings,
} from '../db'
import { NotationText } from '../utils/notationParser'
import { INST_COLORS, resolveScoreStyle } from '../config/constants'
import { resolveCategoryChipScore } from '../utils/meetingCategoryScore'
import { useRatingColorBands } from '../hooks/useRatingColorBands'
import { exportAssignmentReportPdf } from '../utils/pdfExport'
import { getEffectiveChecklistCriterionId } from '../utils/checklistCriterion'
import type { MeetingCategoryRating } from '../db'
export default function MeetingHistory() {
const { id } = useParams()
const navigate = useNavigate()
const assignmentId = Number(id)
const [assignment, setAssignment] = useState<Assignment | null>(null)
const [templates, setTemplates] = useState<PhaseTemplate[]>([])
const [meetings, setMeetings] = useState<MeetingInstance[]>([])
const [institutees, setInstitutees] = useState<Consultant[]>([])
const [fbCategories, setFbCategories] = useState<FeedbackCategory[]>([])
const [fbItems, setFbItems] = useState<FeedbackCriterionItem[]>([])
const [entries, setEntries] = useState<ConversationEntry[]>([])
const [assessments, setAssessments] = useState<Assessment[]>([])
const [categoryRatings, setCategoryRatings] = useState<MeetingCategoryRating[]>([])
const [checklistItems, setChecklistItems] = useState<ChecklistItemDef[]>([])
const [checklistResponses, setChecklistResponses] = useState<ChecklistResponse[]>([])
const [loaded, setLoaded] = useState(false)
const [exportingPdf, setExportingPdf] = useState(false)
const latestRef = useRef<HTMLDivElement>(null)
const colorBands = useRatingColorBands()
useEffect(() => {
const load = async () => {
const a = await getAssignment(assignmentId)
if (!a) return
setAssignment(a)
const [aType, tmpls, doneMeetings, cons] = await Promise.all([
getAssignmentType(a.assignmentTypeId),
listPhaseTemplatesForType(a.assignmentTypeId),
listDoneMeetingsChronological(assignmentId),
getConsultantsByIds(a.instituteeIds),
])
setTemplates(tmpls)
setMeetings(doneMeetings)
setInstitutees(a.instituteeIds.map(cid => cons.find(c => c.id === cid)!).filter(Boolean))
const structure = await loadFeedbackStructure()
const visible = resolveVisibleStructure(structure.dimensions, structure.categories, structure.items, aType?.criteriaIds)
setFbCategories(visible.categories)
setFbItems(visible.items)
const meetingIds = doneMeetings.map(m => m.id!)
const templateIds = tmpls.map(t => t.id!)
const [convEntries, asmts, catRatings, checklistDefs, checklistResp] = await Promise.all([
listConversationEntriesForMeetings(meetingIds),
listAssessmentsForMeetings(meetingIds),
listMeetingCategoryRatingsForMeetings(meetingIds),
listChecklistItemDefsForPhaseTemplates(templateIds),
listChecklistResponsesForMeetings(meetingIds),
])
setEntries(convEntries)
setAssessments(asmts)
setCategoryRatings(catRatings)
setChecklistItems(checklistDefs)
setChecklistResponses(checklistResp)
setLoaded(true)
}
load()
}, [assignmentId])
useEffect(() => {
if (loaded) latestRef.current?.scrollIntoView({ block: 'start' })
}, [loaded])
const handleExportPdf = async () => {
setExportingPdf(true)
try {
await exportAssignmentReportPdf(assignmentId)
} finally {
setExportingPdf(false)
}
}
const displayName = (inst: Consultant) => {
const dup = institutees.filter(c => c.firstName === inst.firstName && c.id !== inst.id).length > 0
return dup ? `${inst.firstName} ${inst.lastName.charAt(0)}.` : inst.firstName
}
if (!assignment) return <div className="text-center py-10 text-gray-400">Lädt…</div>
return (
<div className="space-y-4">
<div className="flex items-start justify-between gap-2">
<div>
<button onClick={() => navigate(`/assignment/${assignmentId}`)} className="text-sm text-brand mb-2 block">← Assignment</button>
<h1 className="text-xl font-bold text-gray-800">📜 Gesamtprotokoll</h1>
<div className="text-sm text-gray-500">{assignment.title} · {assignment.client}</div>
</div>
<button onClick={handleExportPdf} disabled={exportingPdf}
className="flex-shrink-0 text-xs px-3 py-1.5 border border-gray-200 rounded-lg text-gray-500 hover:border-brand hover:text-brand transition disabled:opacity-50">
{exportingPdf ? 'Erstelle PDF…' : '⬇ Als PDF exportieren'}
</button>
</div>
{meetings.length === 0 && (
<p className="text-gray-400 text-sm text-center py-8">Noch keine abgeschlossenen Meetings.</p>
)}
{meetings.map((meeting, idx) => {
const template = templates.find(t => t.id === meeting.phaseTemplateId)
const meetingEntries = entries
.filter(e => e.meetingInstanceId === meeting.id)
.sort((a, b) => a.sequenceIndex - b.sequenceIndex)
const meetingChecklistItems = checklistItems.filter(ci => ci.phaseTemplateId === template?.id).sort((a, b) => a.order - b.order)
const isLatest = idx === meetings.length - 1
return (
<div key={meeting.id}
ref={isLatest ? latestRef : undefined}
className={`bg-white rounded-xl shadow-sm p-4 space-y-3 ${isLatest ? 'border-2 border-brand' : 'border border-gray-100'}`}>
<div className="flex items-center justify-between">
<div>
<div className="font-semibold text-gray-800">
{template?.label ?? 'Meeting'}{template?.isRepeatable ? ` #${meeting.phaseIndex}` : ''}
</div>
<div className="text-xs text-gray-400">{new Date(meeting.date).toLocaleDateString('de-DE')}</div>
</div>
{isLatest && (
<span className="text-xs bg-brand text-white px-2 py-1 rounded-full font-medium flex-shrink-0">
Aktuellstes Meeting
</span>
)}
</div>
{meeting.generalNotes?.trim() && (
<div className="bg-gray-50 rounded-lg px-3 py-2">
<NotationText
text={meeting.generalNotes}
renderLineAddon={line => {
const critId = meeting.generalNoteTags?.find(t => t.text === line)?.criterionItemId
const critName = critId ? fbItems.find(i => i.id === critId)?.name : null
return critName
? <span className="flex-shrink-0 text-xs bg-indigo-50 text-indigo-700 border border-indigo-200 rounded-full px-2 py-0.5 mt-0.5">{critName}</span>
: null
}}
/>
</div>
)}
{meetingEntries.length > 0 && (
<div className="space-y-1.5">
{meetingEntries.map(entry => {
const instIdx = institutees.findIndex(c => c.id === entry.instituteeId)
const inst = institutees[instIdx]
const color = INST_COLORS[instIdx % INST_COLORS.length]
return (
<div key={entry.id}
className={`rounded-lg border px-3 py-2 ${color?.bg ?? 'bg-gray-50'} ${color?.border ?? 'border-gray-200'}`}>
<div className="flex items-start gap-2">
<span className={`flex-shrink-0 text-xs font-bold text-white px-2 py-0.5 rounded mt-0.5 ${color?.tag ?? 'bg-gray-400'}`}>
{inst ? displayName(inst) : '?'}
</span>
<div className="flex-1 min-w-0">
{entry.note && (
<NotationText
text={entry.note}
renderLineAddon={line => {
const critId = entry.lineTags?.find(t => t.text === line)?.criterionItemId
const critName = critId ? fbItems.find(i => i.id === critId)?.name : null
return critName
? <span className="flex-shrink-0 text-xs bg-indigo-50 text-indigo-700 border border-indigo-200 rounded-full px-2 py-0.5 mt-0.5">{critName}</span>
: null
}}
/>
)}
{(entry.fillerCount ?? 0) > 0 && (
<span className="inline-block mt-1 text-xs bg-red-50 text-red-500 border border-red-200 px-1.5 py-0.5 rounded font-medium">
äh×{entry.fillerCount}
</span>
)}
</div>
</div>
</div>
)
})}
</div>
)}
{meetingChecklistItems.length > 0 && (
<div className="space-y-1 pt-1 border-t border-gray-50">
<div className="text-xs font-semibold text-gray-400 uppercase tracking-wide">🗹 Checkliste</div>
{meetingChecklistItems.map(ci => {
const responsesForItem = checklistResponses.filter(r => r.checklistItemId === ci.id)
const targets = ci.scope === 'meetingWide' ? [undefined] : institutees.map(i => i.id)
return targets.map(instituteeId => {
const response = responsesForItem.find(r => (r.instituteeId ?? undefined) === instituteeId)
if (!response) return null
const effectiveCritId = getEffectiveChecklistCriterionId(ci, response)
const critName = effectiveCritId ? fbItems.find(i => i.id === effectiveCritId)?.name : null
const inst = instituteeId ? institutees.find(c => c.id === instituteeId) : undefined
return (
<div key={`${ci.id}-${instituteeId ?? 'm'}`} className="text-xs text-gray-600 flex items-center gap-1.5 flex-wrap">
<span className="font-medium">{ci.label}</span>
{inst && <span className="text-gray-400">— {displayName(inst)}</span>}
<span className={`px-1.5 py-0.5 rounded font-medium tabular-nums ${resolveScoreStyle(response.rating, colorBands).active}`}>
{response.rating ?? '—'}
</span>
{critName && <span className="text-indigo-600">→ {critName}</span>}
{response.note?.trim() && <span className="text-gray-500">— {response.note.trim()}</span>}
</div>
)
})
})}
</div>
)}
{institutees.length > 0 && fbCategories.length > 0 && (
<div className="space-y-1 pt-1 border-t border-gray-50">
{institutees.map(inst => {
const chips = fbCategories.map(cat => {
const catItems = fbItems.filter(i => i.categoryId === cat.id)
const mode = resolveCategoryChipScore({
meetingId: meeting.id!,
instituteeId: inst.id!,
categoryId: cat.id!,
categoryRatings,
assessments,
catItems,
})
return mode ? { cat, mode } : null
}).filter(Boolean) as { cat: FeedbackCategory; mode: RatingScore }[]
if (chips.length === 0) return null
return (
<div key={inst.id} className="flex items-center gap-1 flex-wrap">
<span className="text-xs text-gray-400">{displayName(inst)}:</span>
{chips.map(({ cat, mode }) => (
<span key={cat.id} className={`text-xs px-2 py-0.5 rounded font-medium tabular-nums ${resolveScoreStyle(mode, colorBands).active}`}>
{cat.name} {mode}
</span>
))}
</div>
)
})}
</div>
)}
</div>
)
})}
</div>
)
}
Loaded 100 of 135 files, more files were not shown because too many files have changed in this diff. Show more