20260703_tagging von Zeilen und Verbindung
This commit is contained in:
1 parent
f57db9d161
commit
f47353dbe1
25 files changed
+869
-143
No files matched your search
@@ -17,29 +17,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, nutzt noch alte Criterion-Tabelle)
|
||||
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 +63,10 @@ src/
|
||||
|
||||
## Datenmodell (IndexedDB via Dexie v5)
|
||||
|
||||
### DB-Version: 5
|
||||
### DB-Version: 6
|
||||
|
||||
```typescript
|
||||
// Konfiguration (Legacy, nur noch für Evaluation.tsx)
|
||||
// Konfiguration (Legacy, nur noch für FeedbackDraftPage.tsx + Seeds)
|
||||
categories: '++id, order'
|
||||
criteria: '++id, categoryId, order'
|
||||
|
||||
@@ -88,8 +103,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 +155,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 +199,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 +210,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 +219,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 +242,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 +251,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 +275,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 +286,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` (nur noch von `FeedbackDraftPage.tsx` genutzt, `Evaluation.tsx` ist längst auf `feedbackCriterionItems` migriert)
|
||||
3. **Feedback-Dimensionsstruktur** mit 5 Dimensionen, 14 Kategorien, ~70 Kriterium-Items (Capgemini-Kompetenzmodell)
|
||||
4. **Criterion-Mappings** (Legacy, nicht mehr aktiv genutzt)
|
||||
|
||||
@@ -247,10 +296,13 @@ 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 |
|
||||
| `FeedbackDraftPage.tsx` | Nutzt alte `Category`/`Criterion`-Tabellen statt neue `feedbackCriterionItems`; letzter Konsument der Legacy-Tabellen außer den Seeds | Mittel |
|
||||
| `meetingExport.ts` | Bewertungs-Labels im Markdown-Export zeigen `FeedbackRating`-Keys (z.B. `client_ready`) statt sprechender 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 |
|
||||
| AI-Prompt & `FeedbackDraftPage` | N/A-Aggregationsbug: `score !== null` schließt `'na'` nicht aus, verfälscht Mittelwerte | Hoch |
|
||||
| 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) |
|
||||
| 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 |
|
||||
| `db/queries/`-Layer | Fehlt — DB-Zugriffe direkt aus Komponenten, erschwert SQLite-Migration | Mittel |
|
||||
Reference in new issue
Block a user