initial commit
This commit is contained in:
commit
ece111c0a7
34 files changed
+13702
No files matched your search
@@ -0,0 +1,160 @@
|
||||
# Fachliche Architektur — Assignment Monitor
|
||||
|
||||
## 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:
|
||||
|
||||
- Kundentermine strukturiert zu protokollieren
|
||||
- Beobachtungen und Bewertungen in Echtzeit zu erfassen
|
||||
- Am Ende eines Assignments ein qualifiziertes Feedback vorzubereiten
|
||||
|
||||
**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.
|
||||
|
||||
---
|
||||
|
||||
## Fachliche Entitätenhierarchie
|
||||
|
||||
```
|
||||
AssignmentType ← Konfiguration (z.B. "Case Interview")
|
||||
└── PhaseTemplate[] ← Definierter Meeting-Flow des Typs
|
||||
└── criteriaIds: FeedbackCriterionItem[] ← Welche Kriterien gelten für diesen Typ
|
||||
|
||||
Assignment ← Ein konkretes Kundenprojekt
|
||||
└── AssignmentType ← Zugeordneter Typ
|
||||
└── Institutees: Consultant[] ← Begleitete Berater (1–n)
|
||||
└── MeetingInstance[] ← Durchgeführte Meetings je Phase
|
||||
|
||||
MeetingInstance ← Ein konkreter Termin (z.B. "Briefing Call #1")
|
||||
└── PhaseTemplate ← Welche Phase des Assignments
|
||||
└── ConversationEntry[] ← Zeitleiste: wer spricht wann
|
||||
└── Assessment[] ← Gesamtbewertung pro Institutee am Ende
|
||||
|
||||
ConversationEntry ← Ein Gesprächsbeitrag eines Institutees
|
||||
└── ConversationSkillScore[] ← Kategorie-Schnellbewertung (während des Beitrags)
|
||||
|
||||
FeedbackDimension ← Übergeordnete Dimension für das Assignment-Feedback
|
||||
└── FeedbackCategory[] ← Kategorie (z.B. "Kommunikationsfähigkeit")
|
||||
└── FeedbackCriterionItem[] ← Einzelnes Kriterium (z.B. "To the point")
|
||||
|
||||
AssignmentFeedback ← Strukturiertes Abschluss-Feedback pro Institutee
|
||||
└── FeedbackCategoryRating[] ← Bewertung je Kategorie
|
||||
└── FeedbackDimensionText[] ← Freitext Achievements + Development Needs je Dimension
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Meeting-Phasen
|
||||
|
||||
Jeder AssignmentTyp definiert einen geordneten Flow von PhaseTemplates. Die drei vordefinierten Typen haben folgende Phasen:
|
||||
|
||||
| Phase | Mit wem | Wdh. | Protokoll | Bewertung | Generisch | Case | Pitch |
|
||||
|---|---|:-:|:-:|:-:|:-:|:-:|:-:|
|
||||
| Pre-Briefing (Lead) | Lead | — | — | — | ✓ | ✓ | ✓ |
|
||||
| Briefing (Kunde) | Kunde | — | ✓ | ✓ | ✓ | ✓ | ✓ |
|
||||
| Alignment Call | Kunde | **✓** | ✓ | ✓ | ✓ | — | ✓ |
|
||||
| Pre-Delivery (Lead) | Lead | — | — | — | ✓ | — | ✓ |
|
||||
| Delivery / Pitch | Kunde | — | ✓ | ✓ | ✓ | ✓ | ✓ |
|
||||
| Feedback Call (Kunde) | Kunde | — | ✓ | ✓ | ✓ | ✓ | ✓ |
|
||||
| Feedback Call (Lead) | Lead | — | — | — | ✓ | ✓ | ✓ |
|
||||
|
||||
Wiederholbare Phasen (z.B. Alignment Calls) werden mit fortlaufendem `phaseIndex` und Dateinamen-Suffix `-#2`, `-#3` etc. gekennzeichnet.
|
||||
|
||||
---
|
||||
|
||||
## Bewertungssystem
|
||||
|
||||
### Skala
|
||||
|
||||
| Label | Kürzel | Farbe | Numerischer Wert |
|
||||
|---|---|---|:-:|
|
||||
| N/A | N/A | grau | 0 |
|
||||
| Not Client Ready | Not | rot | 1 |
|
||||
| Partially Client Ready | Partially | orange | 2 |
|
||||
| Nearly Client Ready | Nearly | hellgrün | 3 |
|
||||
| Client Ready | Fully | dunkelgrün | 4 |
|
||||
|
||||
`N/A` gilt als „nicht gesetzt" und wird aus allen Berechnungen ausgeschlossen.
|
||||
|
||||
### Aggregationslogik
|
||||
|
||||
**Gewichteter Durchschnitt** über alle Kriterien mit `weight`-Faktor (×1–×5):
|
||||
|
||||
```
|
||||
avg = Σ(score_i × weight_i) / Σ(weight_i)
|
||||
```
|
||||
|
||||
Mapping auf Rating:
|
||||
- `avg < 1.5` → Not
|
||||
- `avg < 2.5` → Partially
|
||||
- `avg < 3.5` → Nearly
|
||||
- `avg ≥ 3.5` → Fully
|
||||
|
||||
### Zwei Assessment-Ebenen
|
||||
|
||||
1. **Kategorie-Level (live, während Gesprächsbeitrag):** `ConversationSkillScore.criteriaId` → `FeedbackCategory.id`
|
||||
Schnelle Bewertung während ein Institutee spricht. Optional, da im Hektik oft nicht machbar.
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Feedback-Struktur (Abschluss-Feedback)
|
||||
|
||||
Die Feedback-Struktur ist vollständig konfigurierbar und von der Meeting-Bewertungsstruktur **getrennt**. Sie spiegelt das Capgemini-Kompetenzmodell wider:
|
||||
|
||||
| Dimension | Kategorien (Beispiele) |
|
||||
|---|---|
|
||||
| Mindset, Commitment, Collaboration | Persönliche Einstellung, Professionalität, Commitment, Kommunikationsfähigkeit, Zusammenarbeit |
|
||||
| Running Our Projects | Ergebnisverantwortung, Arbeitsstil, Kundenmanagement, Lieferzeiten |
|
||||
| Growing our People | Networking, Learning und Development |
|
||||
| Functional & Technical Skills | Qualität des Inhalts, Inhaltliche Vollständigkeit, Qualität der Unterlage, Prozesstreue |
|
||||
| Innovation und Asset Development | Innovation |
|
||||
|
||||
Das Abschluss-Feedback (`AssignmentFeedbackPage`) erlaubt:
|
||||
- Manuelle Bewertung je Kategorie (N/A bis Fully)
|
||||
- KI-gestützten Textentwurf via OpenRouter API (GPT-4o, Claude, Gemini)
|
||||
- Manuell editierbare Textfelder „Achievements" und „Development Needs" je Dimension
|
||||
- Status-Toggle: Entwurf → Final
|
||||
|
||||
---
|
||||
|
||||
## Protokoll-Notation
|
||||
|
||||
Im Gesprächsprotokoll unterstützt die App eine Schnellnotations-Syntax, die farbig gerendert wird:
|
||||
|
||||
| Symbol | Bedeutung | Darstellung |
|
||||
|---|---|---|
|
||||
| `+` | Positiv | grün |
|
||||
| `(+)` | Positiv mit Abstrichen | grün (gedimmt) |
|
||||
| `!` | Negativ | rot |
|
||||
| `(!)` | Negativ mit Abstrichen | rot (gedimmt) |
|
||||
| `>` | Einwand / Kundeninput | blau |
|
||||
| `[…]` | Slide-/Dokument-Referenz | grau |
|
||||
|
||||
---
|
||||
|
||||
## Export-Funktionen
|
||||
|
||||
### Meeting-Export
|
||||
**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
|
||||
|
||||
### 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.
|
||||
|
||||
---
|
||||
|
||||
## Datenschutz und Datenhaltung
|
||||
|
||||
- Alle Daten bleiben im **lokalen Browser-IndexedDB** (Dexie.js)
|
||||
- Kein Backend, kein Cloud-Sync
|
||||
- Personenbezogene Daten: Namen von Institutees, Kundennamen, Gesprächsnotizen
|
||||
- GDPR-relevant: Backup-Dateien müssen sicher (OneDrive, lokaler Ordner) aufbewahrt werden
|
||||
- **Kein Public Cloud Storage** erlaubt (explizite Anforderung)
|
||||
- Zukünftig geplant: SQLite WASM + OPFS für robustere lokale Speicherung ohne Installation
|
||||
@@ -0,0 +1,169 @@
|
||||
# Handover-Dokument — Assignment Monitor
|
||||
|
||||
Dieses Dokument ermöglicht einem neuen Chat-Kontext, die Arbeit am Projekt nahtlos fortzuführen.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
|
||||
## 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
|
||||
|
||||
```bash
|
||||
npx tsc --noEmit # Muss ohne Fehler durchlaufen
|
||||
npm run dev # Dev-Server starten
|
||||
```
|
||||
|
||||
Vor jeder Abgabe: `npx tsc --noEmit` ausführen und alle Fehler beheben.
|
||||
|
||||
## Wichtige Eigenheiten / Fallstricke
|
||||
|
||||
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
|
||||
@@ -0,0 +1,98 @@
|
||||
# Projektstatus und offene Punkte — Assignment Monitor
|
||||
|
||||
Stand: 2026-07-02
|
||||
|
||||
---
|
||||
|
||||
## Implementierungsstatus
|
||||
|
||||
### ✅ 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 |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Offene Punkte / Bugs
|
||||
|
||||
### Priorität Hoch
|
||||
|
||||
| # | 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 |
|
||||
|---|---|---|
|
||||
| `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 |
|
||||
@@ -0,0 +1,256 @@
|
||||
# Technische Architektur — Assignment Monitor
|
||||
|
||||
## Stack
|
||||
|
||||
| Schicht | Technologie | Version | Zweck |
|
||||
|---|---|---|---|
|
||||
| UI-Framework | React | 18 | Component-basiertes UI |
|
||||
| Sprache | TypeScript | 5 | Typsicherheit |
|
||||
| Build | Vite | 6 | Dev-Server, HMR, PWA-Plugin |
|
||||
| CSS | Tailwind CSS | v4 | Utility-First, `@import "tailwindcss"` |
|
||||
| Datenbank | Dexie.js | 5 | IndexedDB-Wrapper |
|
||||
| Routing | React Router | v6 | Client-Side-Routing (SPA) |
|
||||
| PWA | vite-plugin-pwa | — | Offline-Fähigkeit, installierbar |
|
||||
| KI | OpenRouter API | — | Feedback-Generierung (extern, opt-in) |
|
||||
|
||||
**Capgemini Brand Color:** `#0070AD`
|
||||
|
||||
---
|
||||
|
||||
## Projektstruktur
|
||||
|
||||
```
|
||||
src/
|
||||
db/
|
||||
index.ts ← Dexie DB-Klasse, alle Interfaces, Seed-Funktionen, Migrations
|
||||
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)
|
||||
Configuration.tsx ← Tab-Container für alle Konfigurationsseiten
|
||||
FeedbackStructureConfig.tsx ← Dimensionen/Kategorien/Kriterien CRUD + Gewichtung
|
||||
AssignmentTypeConfig.tsx ← AssignmentTypen + Phasen + Kriterien-Auswahl (Baum)
|
||||
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
|
||||
App.tsx ← Route-Definitionen, Navigation
|
||||
main.tsx ← React-Einstiegspunkt, DB-Seed-Aufruf
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Datenmodell (IndexedDB via Dexie v5)
|
||||
|
||||
### DB-Version: 5
|
||||
|
||||
```typescript
|
||||
// Konfiguration (Legacy, nur noch für Evaluation.tsx)
|
||||
categories: '++id, order'
|
||||
criteria: '++id, categoryId, order'
|
||||
|
||||
// Assignment-Typen
|
||||
assignmentTypes: '++id'
|
||||
phaseTemplates: '++id, assignmentTypeId, order'
|
||||
|
||||
// Stammdaten
|
||||
groups: '++id'
|
||||
consultants: '++id, groupId'
|
||||
|
||||
// Assignments
|
||||
assignments: '++id, status, createdAt'
|
||||
meetingInstances: '++id, assignmentId, phaseTemplateId'
|
||||
|
||||
// Gesprächsprotokoll
|
||||
conversationEntries: '++id, meetingInstanceId, instituteeId, sequenceIndex'
|
||||
conversationSkillScores: '++id, conversationEntryId, criteriaId'
|
||||
|
||||
// Meeting-Assessment
|
||||
assessments: '++id, meetingInstanceId, instituteeId, criteriaId'
|
||||
|
||||
// Feedback-Entwürfe (Legacy)
|
||||
feedbackDrafts: '++id, assignmentId, instituteeId'
|
||||
|
||||
// Strukturiertes Feedback
|
||||
feedbackDimensions: '++id, order'
|
||||
feedbackCategories: '++id, dimensionId, order'
|
||||
feedbackCriterionItems: '++id, categoryId, order'
|
||||
assignmentFeedbacks: '++id, assignmentId, instituteeId'
|
||||
feedbackCategoryRatings: '++id, assignmentFeedbackId, feedbackCategoryId'
|
||||
feedbackDimensionTexts: '++id, assignmentFeedbackId, feedbackDimensionId'
|
||||
|
||||
// Mappings (Legacy, kaum genutzt)
|
||||
criterionCategoryMappings: '++id, criterionId, feedbackCategoryId'
|
||||
criterionLevelDescriptions: '++id, criterionItemId, rating'
|
||||
```
|
||||
|
||||
### Wichtige Interface-Details
|
||||
|
||||
```typescript
|
||||
type FeedbackRating = 'na' | 'not_client_ready' | 'partially_client_ready' | 'nearly_client_ready' | 'client_ready'
|
||||
|
||||
interface AssignmentType {
|
||||
id?: number
|
||||
name: string
|
||||
defaultPhaseKeys: string[]
|
||||
criteriaIds?: number[] // FeedbackCriterionItem IDs; leer = alle anzeigen
|
||||
}
|
||||
|
||||
interface Assignment {
|
||||
id?: number
|
||||
title: string
|
||||
client: string
|
||||
assignmentTypeId: number
|
||||
instituteeIds: number[]
|
||||
leadName: string
|
||||
status: 'active' | 'done'
|
||||
createdAt: string
|
||||
assignmentNumber?: string // z.B. "CGI-2024-001"
|
||||
description?: string
|
||||
instituteeEnrollments?: Array<{
|
||||
instituteeId: number
|
||||
from?: string // ISO date
|
||||
to?: string // ISO date
|
||||
}>
|
||||
}
|
||||
|
||||
interface MeetingInstance {
|
||||
id?: number
|
||||
assignmentId: number
|
||||
phaseTemplateId: number
|
||||
phaseIndex: number // 1 = erste Instanz, 2+ = Wiederholungen
|
||||
date: string
|
||||
status: 'planned' | 'active' | 'done'
|
||||
generalNotes: string
|
||||
deletedAt?: string // Soft-Delete
|
||||
}
|
||||
|
||||
interface FeedbackCriterionItem {
|
||||
id?: number
|
||||
categoryId: number
|
||||
name: string
|
||||
weight?: number // Gewichtung ×1–×5, default 1
|
||||
order: number
|
||||
}
|
||||
|
||||
// Assessment.criteriaId → FeedbackCriterionItem.id (Gesamtbewertung)
|
||||
// ConversationSkillScore.criteriaId → FeedbackCategory.id (Schnellbewertung)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Routing
|
||||
|
||||
```
|
||||
/ Dashboard (Assignment-Liste)
|
||||
/assignment/new Neues Assignment anlegen
|
||||
/assignment/:id AssignmentDetail (Phasen-Flow)
|
||||
/assignment/:id/edit Assignment bearbeiten
|
||||
/assignment/:id/meeting/:meetingId MeetingView (Protokoll + Bewertung)
|
||||
/assignment/:id/feedback/:instituteeId AssignmentFeedbackPage (strukturiertes Feedback)
|
||||
/assignment/:id/feedback-draft/:instituteeId FeedbackDraftPage (Legacy)
|
||||
/evaluation Auswertungsübersicht
|
||||
/consultants Berater-Verwaltung
|
||||
/config Konfiguration (3 Tabs: Feedback | Ass.-Typen | Backup)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Konfigurationsbereich
|
||||
|
||||
### Tab "Feedback" → `FeedbackStructureConfig`
|
||||
CRUD für:
|
||||
- Feedback-Dimensionen (mit Reihenfolge ↑/↓)
|
||||
- Feedback-Kategorien je Dimension
|
||||
- Feedback-Kriterium-Items je Kategorie (mit Gewichtung ×1–×5)
|
||||
|
||||
### Tab "Ass.-Typen" → `AssignmentTypeConfig`
|
||||
CRUD für:
|
||||
- Assignment-Typen (Name, Löschschutz wenn Assignments vorhanden)
|
||||
- Phasen-Templates je Typ (Label, Lead/Kunde, Wiederholbar, Protokoll, Bewertung)
|
||||
- Kriterien-Auswahl je Typ: Baumstruktur Dimension → Kategorie → Item (mit Checkbox, Indeterminate-State)
|
||||
- `criteriaIds = []` → alle Kriterien werden angezeigt
|
||||
|
||||
### Tab "Backup" → in `Configuration.tsx`
|
||||
- JSON-Export aller Tabellen
|
||||
- Zweistufiger JSON-Import mit Überschreib-Warnung
|
||||
|
||||
---
|
||||
|
||||
## Bewertungs-Aggregation (Implementierungsdetail)
|
||||
|
||||
```typescript
|
||||
const NUM_MAP: Record<FeedbackRating, number> = {
|
||||
na: 0, not_client_ready: 1, partially_client_ready: 2, nearly_client_ready: 3, client_ready: 4
|
||||
}
|
||||
|
||||
function catMode(cat: FeedbackCategory, fbItems: FeedbackCriterionItem[], getScore: (itemId: number) => FeedbackRating | null): FeedbackRating | null {
|
||||
const scored = fbItems
|
||||
.filter(i => i.categoryId === cat.id)
|
||||
.map(i => ({ score: getScore(i.id!), w: i.weight ?? 1 }))
|
||||
.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)
|
||||
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'
|
||||
if (avg < 3.5) return 'nearly_client_ready'
|
||||
return 'client_ready'
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Export-Dateiname-Schema
|
||||
|
||||
```typescript
|
||||
const buildFilename = (ext: string) => {
|
||||
const date = new Date(meeting.date).toLocaleDateString('de-DE').replace(/\./g, '-')
|
||||
const label = template.label // z.B. "Alignment Call"
|
||||
const idx = phaseIndex > 1 ? `-${phaseIndex}` : ''
|
||||
const id = assignment.assignmentNumber ?? assignment.title
|
||||
return `${id}_${date}_${label}${idx}.${ext}`
|
||||
// Beispiel: CGI-2024-001_02-07-2026_Alignment Call-2.md
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## KI-Integration (AssignmentFeedbackPage)
|
||||
|
||||
- **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
|
||||
|
||||
---
|
||||
|
||||
## Seed-Daten (beim ersten Start)
|
||||
|
||||
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)
|
||||
3. **Feedback-Dimensionsstruktur** mit 5 Dimensionen, 14 Kategorien, ~70 Kriterium-Items (Capgemini-Kompetenzmodell)
|
||||
4. **Criterion-Mappings** (Legacy, nicht mehr aktiv genutzt)
|
||||
|
||||
---
|
||||
|
||||
## Bekannte technische Schulden
|
||||
|
||||
| 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 |
|
||||
| IndexedDB | Keine robuste Persistenz-Garantie (Browser kann löschen) | Hoch → SQLite WASM geplant |
|
||||
Reference in new issue
Block a user