docs/uc36-uc31a-gesamtbericht #35

Merged

ingo merged 3 commits from docs/uc36-uc31a-gesamtbericht into master

2026-06-19 17:00:34 +02:00

ingo commented

2026-06-18 23:37:35 +02:00

Owner

No description provided.

ingo added 3 commits

2026-06-18 23:37:35 +02:00

docs(usecases): UC36 um Foto-Galerie + vergleichende Würdigung erweitern e8093551f1

UC36 von text-only zu "Gesamt-Rückblick + Foto-Galerie" überarbeitet:
geteiltes Dokument für alle Teams mit Galerie aller angenommenen Fotos
nach Aufgabe gruppiert und positiv-vergleichender Würdigung je Aufgabe
("hier stach Team X hervor"). Foto-Beschreibungen aus dem Cache (UC31/
UC62), optionaler visueller Foto-Vergleich je Aufgabe via UC31A
(summary_compare_photos, Default text-only). Datenmodell/API/UI/
Guardrails/Tests entsprechend angepasst; summary_compare_best_photo ->
summary_compare_photos.

UC31A: Mehrbild-Primitiv vision(images=[...]) explizit als wiederver-
wendbar markiert (Referenz<->Einreichung, Team-Versuche UC62, team-
übergreifend UC36); Querverweis auf UC36 korrigiert.

admin-overview: UC36-Kurzbeschreibung um Galerie + UC31A-Bezug ergänzt.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

feat(uc31a): Foto-Review mit Referenzbild-Vergleich (Multi-Image-Vision) 20188e5edf

Erweitert UC31 um optionalen Multi-Image-Vergleich: Referenzbilder der
Aufgabe werden zusammen mit der Einreichung in einem Vision-Call
geschickt, wenn das konfigurierte Modell das unterstuetzt
(ai_config.vision_multi_image) oder per Task-Config erzwungen wird.
Stiller Fallback auf UC31-Einzelbild-Verhalten, falls Capability/
Referenzbilder fehlen oder defekt sind.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(uc36): Gesamt-Rückblick + Foto-Galerie (lauf-weiter KI-Bericht) 2ce5592197

Ein geteiltes, lauf-weites KI-Dokument für alle Teams: erzählender Rückblick
(Endstand, Highlights, besondere Momente, Voting-Sieger) plus eine nach
Aufgaben gruppierte Foto-Galerie mit allen freigegebenen Fotos und einer
positiv-vergleichenden Würdigung je Foto-Aufgabe.

Teilt Auslöser, Stil-Katalog (narrative_styles / rallyes.narrative_style_id)
und PDF-/Foto-Helfer mit UC61/UC62.

Backend
- Migration 0043: rallyes.summary_enabled / summary_compare_photos
- run_summary.py: Faktenaggregation (Ranking, Highlights, special_moments,
  Galerie, Voting, captions_sample, PII-Filter) + zweistufige Pipeline
  (Rückblick-Text + Foto-Würdigung je Aufgabe, optional Mehrbild-Vision UC31A)
- Prompts: summary_report, gallery_compare_prompt, gallery_compare_vision_prompt
- Manueller Anstoß durch die Spielleitung (kein Auto-Trigger beim Lauf-Ende) —
  POST/Status/Progress/Download-Endpunkte (PDF/MD); Teilnehmer-Download
- Stil geteilt mit den Team-Berichten (resolve_style über narrative_style_id)
- Erstellungsbericht (Trace) als Diagnose-Protokoll der KI-Aufrufe, wie UC62;
  inkl. Erkennung abgeschnittener Antworten
- Token-Budget wie UC62 (num_ctx=32768, max_tokens=num_ctx): verhindert den
  Abbruch mitten im Text bei Reasoning-Modellen

Frontend
- Gesamt-Rückblick als erste Zeile im "KI-Ergebnisberichte"-Block (gleiches
  Schema wie Team-Berichte: Status-Chip + PDF/MD/Trace/Neu-generieren)
- Ein/Aus-Schalter + optionaler visueller Foto-Vergleich in den Einstellungen

Tests: 29 neue UC36-Tests (Aggregation, Pipeline, Vergleich, Trigger, Download)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>