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>
This commit is contained in:
1 parent
782678a1cf
commit
234f87d408
71 files changed
+7567
-705
No files matched your search
@@ -0,0 +1,45 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,280 @@
|
||||
# Plan: Feedback-Neukonzeption, KI-Kaskadierung & UX
|
||||
|
||||
Stand: 2026-08-06 · nur DEV (`AssigmentMonitorV2`)
|
||||
Voraussetzung: Bewertungsskala 1–10 weitgehend umgesetzt (`docs/SCALE_1_TO_10.md`).
|
||||
|
||||
Dieses Dokument ist die **Arbeitsliste**. Pakete nacheinander abarbeiten; innerhalb eines Pakets Unterpunkte möglichst in der angegebenen Reihenfolge. Abhaken in diesem File oder in der Session-Todo-Liste.
|
||||
|
||||
---
|
||||
|
||||
## 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 | ☐ prüfen |
|
||||
| 0.2 | Chips Detail/History/PDF/MD aus `meetingCategoryRatings` (+ Fallback) | ☐ prüfen |
|
||||
| 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) | ☐ |
|
||||
| 4.2 | Pro Dimension: nur Benefits/Concerns (3–5), suggested übernehmen/verwerfen | ☐ |
|
||||
| 4.3 | Alten Ein-Text-pro-Kategorie und Achievements/DevNeeds-Labels entfernen bzw. umbenennen | ☐ |
|
||||
| 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 | ☐ |
|
||||
| 5.2 | Nur finale Felder, nie `suggested*` | ☐ |
|
||||
| 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) | ☐ |
|
||||
| 6.2 | Batch-Builder: max. Zeilen **und** max. Zeichensumme (Konstanten in `constants` oder AI_CONFIG, konfigurierbar später) | ☐ |
|
||||
| 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 | ☐ |
|
||||
| 6.5 | `MUSTER:`-Block: nach allen Batches einmal zusammenführen/schreiben oder nur aus Batches mit Treffern — Regel dokumentieren | ☐ |
|
||||
| 6.6 | Info-Zeile + Rohantwort weiter nutzbar (pro Batch oder letzte) | ☐ |
|
||||
|
||||
**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) | ☐ |
|
||||
| 7.2 | Retry mit Backoff für transient failures (einmalig) | ☐ |
|
||||
| 7.3 | Grobe Prompt-Größen-Schätzung vor Call → Warnung oder Auto-Split | ☐ |
|
||||
| 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 | CLAUDE Offene Punkte L | ☐ |
|
||||
| 8.4 | Server Seed-if-empty Assignment-Typen/Struktur | CLAUDE L | ☐ |
|
||||
| 8.5 | Evaluation.tsx / FeedbackDraftPage auf neue Benefits/Concerns + Bänder prüfen oder Legacy deprecaten | | ☐ |
|
||||
| 8.6 | Datenschutz: Hinweis Tagging+Feedback (externe API) vor Prod | CLAUDE | ☐ |
|
||||
|
||||
---
|
||||
|
||||
## Empfohlene Abarbeitungsreihenfolge
|
||||
|
||||
```text
|
||||
0 (Smoke Skala)
|
||||
→ 1 (Schema Benefits/Concerns) ← erledigt
|
||||
→ 1b (Typ → sichtbare Struktur) ← VOR Feedback-KI: gleiche Teilmenge in Meeting + Feedback + Kaskade
|
||||
→ 6 + 7 parallel möglich ← Tagging-Abbrüche lindern
|
||||
→ 2 → 3 → 4 → 5 ← Feedback-Neukonzeption Ende-zu-Ende
|
||||
→ 8 Rest nach Bedarf
|
||||
→ UX später
|
||||
```
|
||||
|
||||
**Hinweis:** Paket UX ist spezifiziert, aber **zurückgestellt** — erst Features fertig, dann Optik.
|
||||
|
||||
**Warum 1b vor 2:** Stufe A (ein Call pro Kategorie) und Feedback-UI müssen nur Kategorien/Dimensionen des Assignment-Typs sehen. Ohne kanonische Sichtbarkeit generiert die KI später Inhalte für ausgeblendete Strukturteile.
|
||||
|
||||
---
|
||||
|
||||
## 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
@@ -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 |
|
||||
+5
-1
@@ -2,11 +2,15 @@
|
||||
|
||||
Dieses Dokument ermöglicht einem neuen Chat-Kontext, die Arbeit am Projekt nahtlos fortzuführen.
|
||||
|
||||
> **DEV-Isolation (V2):** Dieses Repo (`AssigmentMonitorV2`) läuft getrennt vom Produktivsystem (`c:\dev\AssigmentMonitor`). Ports **5174 / 4001**, eigene SQLite `assignment-monitor-v2-dev.sqlite3`. Details und Regeln: [`docs/DEV_ISOLATION.md`](./DEV_ISOLATION.md). Produktiv-Daten und -Code niemals anfassen.
|
||||
|
||||
---
|
||||
|
||||
## Stand & nächste Schritte
|
||||
|
||||
Zuletzt abgeschlossen (2026-07-13, zweite Runde): Chronologisches Gesamtprotokoll aller Meetings eines Assignments (`MeetingHistory.tsx`, `/assignment/:id/history`, erreichbar von `AssignmentDetail.tsx` und `MeetingView.tsx` aus) — für Recap-Calls nach Kundenmeetings und die Gesamtdurchsprache im Feedback-Call. Details: `CLAUDE.md` → Erledigt-Historie (2026-07-13, zweite Runde).
|
||||
Zuletzt abgeschlossen (2026-07-13, dritte Runde): Kriterium-Zuordnung für „Allgemeine Notizen" (`MeetingInstance.generalNoteTags`) — wirkt anders als die bestehende `ConversationEntry.lineTags`-Zuordnung nicht auf ein einzelnes Institutee, sondern auf alle Institutees des Assignments gleichzeitig; alle fünf bestehenden Konsumenten von `lineTags` (Vorschlags-Badges, KI-Prompt, Markdown-Export, Legacy-Feedback-Entwurf, Meeting-Historie) wurden entsprechend erweitert. Details: `CLAUDE.md` → Erledigt-Historie (2026-07-13, dritte Runde).
|
||||
|
||||
Davor abgeschlossen (2026-07-13, zweite Runde): Chronologisches Gesamtprotokoll aller Meetings eines Assignments (`MeetingHistory.tsx`, `/assignment/:id/history`, erreichbar von `AssignmentDetail.tsx` und `MeetingView.tsx` aus) — für Recap-Calls nach Kundenmeetings und die Gesamtdurchsprache im Feedback-Call. Details: `CLAUDE.md` → Erledigt-Historie (2026-07-13, zweite Runde).
|
||||
|
||||
Davor abgeschlossen (2026-07-13): Papierkorb + Archiv für Assignments — Dashboard zeigt standardmäßig nur aktive Assignments, Löschen abgeschlossener Assignments erst möglich wenn für alle Institutees finales Feedback vorliegt, zweistufige Löschung (Papierkorb → automatische endgültige Löschung nach 30 Tagen, mit Wiederherstellen-Option) sowie ein unabhängiges, umkehrbares Archiv für dauerhafte Aufbewahrung. Details: `CLAUDE.md` → Erledigt-Historie (2026-07-13).
|
||||
|
||||
|
||||
@@ -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 | Noch nicht angelegt — parallel in Config pflegbar, kein Blocker für Skalen-Umbau |
|
||||
| Typ-Strukturen | Prio 2 (später) |
|
||||
| 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)
|
||||
@@ -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
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user