Update Planning Exercise Suggestion and Context Handling
Deploy Development / deploy (push) Successful in 42s
Test Suite / pytest-backend (push) Successful in 40s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 13s
Test Suite / k6 /health Baseline (push) Successful in 33s
Test Suite / playwright-tests (push) Successful in 1m13s
Test Suite / pytest-backend (pull_request) Successful in 37s
Test Suite / lint-backend (pull_request) Successful in 0s
Test Suite / build-frontend (pull_request) Successful in 13s
Test Suite / k6 /health Baseline (pull_request) Successful in 33s
Test Suite / playwright-tests (pull_request) Successful in 1m15s

- Incremented version to 0.8.183, reflecting the implementation of Phase C1 enhancements.
- Added support for progression graph auto-matching and variant-aware successors in exercise suggestions.
- Updated request and response structures to include `anchor_exercise_variant_id`, `progression_graph_name`, and `suggested_variant_id`.
- Enhanced frontend components to integrate planning AI search capabilities, including a new modal for exercise creation and improved context display in the exercise list.
- Updated changelog to document these significant improvements in planning AI functionality.
This commit is contained in:
Lars committed 2026-05-23 10:42:17 +02:00
1 parent 50aff849d8
commit b2157d8a40
16 files changed
+985 -136

No files matched your search

@@ -0,0 +1,90 @@
import React, { useEffect } from 'react'
import ExerciseAiQuickCreateOffer from '../ExerciseAiQuickCreateOffer'
/**
* KI-gestützte Neuanlage in einem Dialog — statt normalem „+ Neu“-Formular.
*/
export default function ExerciseAiQuickCreateModal({
open,
onClose,
searchLabel,
title,
onTitleChange,
sketch,
onSketchChange,
focusAreaId,
onFocusAreaChange,
focusAreas = [],
catalogsReady = true,
busy = false,
error = '',
onRunAi,
}) {
useEffect(() => {
if (!open) return undefined
const onKey = (e) => {
if (e.key === 'Escape' && !busy) {
e.preventDefault()
onClose()
}
}
window.addEventListener('keydown', onKey)
return () => window.removeEventListener('keydown', onKey)
}, [open, busy, onClose])
if (!open) return null
return (
<div
className="admin-modal-backdrop"
role="presentation"
onClick={(e) => {
if (e.target === e.currentTarget && !busy) onClose()
}}
>
<div
className="admin-modal-sheet exercise-ai-quick-create-modal"
role="dialog"
aria-modal="true"
aria-labelledby="exercise-ai-quick-create-title"
onClick={(e) => e.stopPropagation()}
style={{ maxWidth: '640px' }}
>
<div className="admin-modal-sheet__header">
<h3 id="exercise-ai-quick-create-title" className="admin-modal-sheet__title">
Neue Übung mit KI
</h3>
<button type="button" className="btn btn-secondary admin-modal-sheet__close" disabled={busy} onClick={onClose}>
Schließen
</button>
</div>
<div className="admin-modal-sheet__body">
<p className="muted" style={{ marginTop: 0, marginBottom: '12px', lineHeight: 1.45 }}>
Die KI schlägt Titel, Ziel, Anleitung und Fähigkeiten vor — danach bearbeiten und als Entwurf speichern.
Für die normale manuelle Anlage den KI-Assistenten ausschalten.
</p>
<ExerciseAiQuickCreateOffer
searchLabel={searchLabel}
title={title}
onTitleChange={onTitleChange}
sketch={sketch}
onSketchChange={onSketchChange}
focusAreaId={focusAreaId}
onFocusAreaChange={onFocusAreaChange}
focusAreas={focusAreas}
catalogsReady={catalogsReady}
busy={busy}
error={error}
onRunAi={onRunAi}
headline="Übung vorschlagen lassen"
hint={
searchLabel
? `Optional aus Suchanfrage „${searchLabel}“ — Titel mindestens 3 Zeichen, Fokusbereich Pflicht.`
: 'Titel mindestens 3 Zeichen, Fokusbereich Pflicht; Kurzbeschreibung optional.'
}
/>
</div>
</div>
</div>
)
}
@@ -241,6 +241,22 @@ export default function ExerciseListCard({
/>
</div>
) : null}
{Array.isArray(exercise._planningReasons) && exercise._planningReasons.length > 0 ? (
<ul
className="exercise-card__planning-reasons"
style={{
margin: '8px 0 0',
paddingLeft: '18px',
fontSize: '12px',
color: 'var(--accent-dark)',
lineHeight: 1.4,
}}
>
{exercise._planningReasons.slice(0, 3).map((r) => (
<li key={r}>{r}</li>
))}
</ul>
) : null}
</div>
</div>
<div className="exercise-card__footer">
@@ -14,7 +14,110 @@ export default function ExerciseListSearchBar({
exerciseCount,
allOnPageSelected,
onToggleSelectAllPage,
kiSearchMode = false,
planningSearchInput = '',
onPlanningSearchInputChange,
onSubmitPlanningSearch,
planningSearchLoading = false,
planningHasSearched = false,
planningRetrievalPhase = '',
planningContextSummary = null,
planningTargetProfileSummary = null,
planningSearchError = '',
}) {
if (kiSearchMode) {
return (
<div className="card exercise-search-bar exercise-search-bar--ki">
<label className="form-label">Planungs-Anfrage (KI)</label>
<div style={{ display: 'flex', flexWrap: 'wrap', gap: '0.5rem', alignItems: 'stretch' }}>
<input
type="search"
className="form-input exercise-search-bar__primary"
placeholder="z. B. Partnerübung Reaktion, Vertiefung Schnellkraft …"
value={planningSearchInput}
onChange={(e) => onPlanningSearchInputChange?.(e.target.value)}
onKeyDown={(e) => {
if (e.key === 'Enter') {
e.preventDefault()
onSubmitPlanningSearch?.()
}
}}
autoComplete="off"
enterKeyHint="search"
/>
<button
type="button"
className="btn btn-primary"
disabled={planningSearchLoading}
onClick={() => onSubmitPlanningSearch?.()}
>
{planningSearchLoading ? 'Suche …' : 'Vorschläge laden'}
</button>
</div>
<p className="exercise-search-hint" style={{ marginTop: '10px' }}>
<strong>Planungs-KI</strong> durchsucht die sichtbare Bibliothek mit Profil-Score und optional LLM — nicht
die einfache Volltextsuche. Filter und „Meine Übungen“ gelten hier nicht; KI-Assistent ausschalten für
klassische Liste.
{planningRetrievalPhase ? (
<>
{' '}
· Phase: <code>{planningRetrievalPhase}</code>
</>
) : null}
</p>
{planningSearchError ? (
<p className="form-error" style={{ marginTop: '8px' }}>
{planningSearchError}
</p>
) : null}
{planningHasSearched && planningContextSummary ? (
<div
style={{
marginTop: '10px',
padding: '8px 10px',
borderRadius: '8px',
background: 'var(--surface2)',
border: '1px solid var(--border)',
fontSize: '12px',
color: 'var(--text2)',
lineHeight: 1.45,
}}
>
<strong style={{ color: 'var(--text1)', fontSize: '13px' }}>KI-Kontext</strong>
<div style={{ marginTop: '4px', display: 'flex', flexWrap: 'wrap', gap: '6px' }}>
{planningContextSummary.expectation_mode ? (
<span className="exercise-tag">
{planningContextSummary.expectation_mode === 'query_only' ? 'Freitext-Profil' : 'Hybrid-Profil'}
</span>
) : null}
{Array.isArray(planningTargetProfileSummary?.focus_areas) &&
planningTargetProfileSummary.focus_areas.length > 0
? planningTargetProfileSummary.focus_areas.slice(0, 2).map((fa) => (
<span key={fa} className="exercise-tag">
Fokus: {fa}
</span>
))
: null}
{Array.isArray(planningTargetProfileSummary?.top_skills) &&
planningTargetProfileSummary.top_skills.length > 0
? planningTargetProfileSummary.top_skills.slice(0, 2).map((sk) => (
<span key={sk.skill_id} className="exercise-tag">
{sk.name}
</span>
))
: null}
</div>
</div>
) : null}
{!planningHasSearched ? (
<p className="muted" style={{ marginTop: '10px', marginBottom: 0, fontSize: '13px' }}>
Anfrage formulieren und „Vorschläge laden“ klicken.
</p>
) : null}
</div>
)
}
return (
<div className="card exercise-search-bar">
<label className="form-label">Volltextsuche (Titel, Ziel, …)</label>
@@ -12,7 +12,8 @@ import ExerciseListBulkToolbar from './ExerciseListBulkToolbar'
import SaveSelectedExercisesAsModuleModal from './SaveSelectedExercisesAsModuleModal'
import ExercisePeekModal from '../ExercisePeekModal'
import NavStateLink from '../NavStateLink'
import ExerciseAiQuickCreateOffer from '../ExerciseAiQuickCreateOffer'
import { ExerciseAiQuickCreateTeaser } from '../ExerciseAiQuickCreateOffer'
import ExerciseAiQuickCreateModal from './ExerciseAiQuickCreateModal'
import ExerciseAiSuggestPreviewModal from '../ExerciseAiSuggestPreviewModal'
import {
buildQuickCreateAiPreview,
@@ -31,6 +32,7 @@ import {
snapshotExerciseForSelection,
} from '../../utils/exerciseListSelection'
import { useExerciseListCatalogsAndQuery } from '../../hooks/useExerciseListCatalogsAndQuery'
import { usePlanningExerciseSuggestSearch } from '../../hooks/usePlanningExerciseSuggestSearch'
import {
INITIAL_EXERCISE_LIST_FILTERS,
mergeExerciseListPrefsFromApi,
@@ -89,10 +91,15 @@ function ExercisesListPageRoot() {
const [peekExercise, setPeekExercise] = useState(null)
const [saveModuleModalOpen, setSaveModuleModalOpen] = useState(false)
const [aiQuickCreateEnabled, setAiQuickCreateEnabled] = useState(false)
const [aiQuickCreateModalOpen, setAiQuickCreateModalOpen] = useState(false)
const [quickSaving, setQuickSaving] = useState(false)
const [quickAiError, setQuickAiError] = useState('')
const [quickCreateDraft, setQuickCreateDraft] = useState(null)
const planningKi = usePlanningExerciseSuggestSearch({
enabled: pageTab === 'list' && aiQuickCreateEnabled,
})
const {
title: quickTitle,
sketch: quickSketch,
@@ -100,9 +107,14 @@ function ExercisesListPageRoot() {
setTitle: setQuickTitle,
setSketch: setQuickSketch,
setFocusAreaId: setQuickFocusAreaId,
} = useExerciseAiQuickCreateFields(debouncedSearch, {
enabled: pageTab === 'list' && (aiQuickCreateEnabled || debouncedSearch.length >= 3),
})
} = useExerciseAiQuickCreateFields(
aiQuickCreateModalOpen
? planningKi.submittedQuery || planningKi.searchInput || debouncedSearch
: debouncedSearch,
{
enabled: pageTab === 'list' && aiQuickCreateModalOpen,
},
)
useEffect(() => {
if (!user?.id) return
@@ -174,14 +186,18 @@ function ExercisesListPageRoot() {
loadingMore,
hasMore,
loadMore,
} = useExerciseListCatalogsAndQuery({ queryBase, pageTab, tenantClubDepKey })
} = useExerciseListCatalogsAndQuery({
queryBase,
pageTab,
tenantClubDepKey,
skipListFetch: aiQuickCreateEnabled,
})
const showQuickCreateOffer =
pageTab === 'list' &&
catalogsReady &&
!listFetching &&
(aiQuickCreateEnabled ||
(exercises.length === 0 && selectedEntries.length === 0 && debouncedSearch.length >= 3))
const listExercises = exercises
const listFetchingResolved = listFetching
const exercisesForDisplay = aiQuickCreateEnabled ? planningKi.rows : listExercises
const listFetchingDisplay = aiQuickCreateEnabled ? planningKi.loading : listFetchingResolved
const hasMoreDisplay = aiQuickCreateEnabled ? false : hasMore
const selectedIds = useMemo(
() => new Set(selectedEntries.map((e) => Number(e.id)).filter((id) => Number.isFinite(id) && id > 0)),
@@ -189,15 +205,22 @@ function ExercisesListPageRoot() {
)
const selectedExercisesDisplay = useMemo(
() => mergeSelectedWithListEntries(selectedEntries, exercises),
[selectedEntries, exercises]
() => mergeSelectedWithListEntries(selectedEntries, exercisesForDisplay),
[selectedEntries, exercisesForDisplay],
)
const filterResultExercises = useMemo(
() => exercises.filter((e) => !selectedIds.has(Number(e.id))),
[exercises, selectedIds]
() => exercisesForDisplay.filter((e) => !selectedIds.has(Number(e.id))),
[exercisesForDisplay, selectedIds],
)
const showKiCreateTeaser =
aiQuickCreateEnabled &&
planningKi.hasSearched &&
!planningKi.loading &&
catalogsReady &&
filterResultExercises.length > 0
const focusOptions = useMemo(
() =>
catalogs.focusAreas.map((fa) => ({
@@ -274,9 +297,9 @@ function ExercisesListPageRoot() {
/** Für Browser-/datalist-Vorschläge (aktuelle Treffer-Titel, begrenzt) */
const searchTitleSuggestions = useMemo(() => {
const titles = exercises.map((e) => (e.title || '').trim()).filter(Boolean)
const titles = listExercises.map((e) => (e.title || '').trim()).filter(Boolean)
return [...new Set(titles)].slice(0, 80)
}, [exercises])
}, [listExercises])
const clubNameById = useMemo(() => {
const m = {}
@@ -377,6 +400,7 @@ function ExercisesListPageRoot() {
setQuickCreateDraft(
aiPreviewToQuickCreateDraft(preview, { title, focusAreaId: focusId, sketchPlain: sketch }),
)
setAiQuickCreateModalOpen(false)
} catch (e) {
console.error(e)
const msg = e?.message || String(e)
@@ -597,23 +621,36 @@ function ExercisesListPageRoot() {
<div className="exercises-page__header-actions">
<label
className="exercises-ai-assistant-toggle"
title="Neue Übung per KI vorschlagen — Titel, optional Kurzbeschreibung, Fokusbereich"
title="Planungs-KI-Suche in der Bibliothek und Neuanlage per KI-Dialog (ohne normales Formular „+ Neu“)"
>
<input
type="checkbox"
checked={aiQuickCreateEnabled}
onChange={(e) => setAiQuickCreateEnabled(e.target.checked)}
onChange={(e) => {
setAiQuickCreateEnabled(e.target.checked)
if (!e.target.checked) setAiQuickCreateModalOpen(false)
}}
/>
<span className="exercises-ai-assistant-toggle__track" aria-hidden="true" />
<span>Neu mit KI-Assistent</span>
</label>
<NavStateLink
to="/exercises/new"
returnContext={exercisesModuleReturnContext}
className="btn btn-primary"
>
+ Neu
</NavStateLink>
{aiQuickCreateEnabled ? (
<button
type="button"
className="btn btn-primary"
onClick={() => setAiQuickCreateModalOpen(true)}
>
+ Neue Übung mit KI
</button>
) : (
<NavStateLink
to="/exercises/new"
returnContext={exercisesModuleReturnContext}
className="btn btn-primary"
>
+ Neu
</NavStateLink>
)}
</div>
) : (
<span aria-hidden="true" />
@@ -644,6 +681,16 @@ function ExercisesListPageRoot() {
) : (
<>
<ExerciseListSearchBar
kiSearchMode={aiQuickCreateEnabled}
planningSearchInput={planningKi.searchInput}
onPlanningSearchInputChange={planningKi.setSearchInput}
onSubmitPlanningSearch={() => planningKi.submitSearch()}
planningSearchLoading={planningKi.loading}
planningHasSearched={planningKi.hasSearched}
planningRetrievalPhase={planningKi.retrievalPhase}
planningContextSummary={planningKi.contextSummary}
planningTargetProfileSummary={planningKi.targetProfileSummary}
planningSearchError={planningKi.error}
searchTitleSuggestions={searchTitleSuggestions}
searchInput={searchInput}
onSearchInputChange={setSearchInput}
@@ -654,30 +701,15 @@ function ExercisesListPageRoot() {
onOpenFilter={() => setFilterModalOpen(true)}
filterChips={filterChips}
onResetAllFilters={resetAllFilters}
exerciseCount={exercises.length}
exerciseCount={exercisesForDisplay.length}
allOnPageSelected={allOnPageSelected}
onToggleSelectAllPage={toggleSelectAllPage}
/>
{showQuickCreateOffer ? (
<ExerciseAiQuickCreateOffer
searchLabel={debouncedSearch || undefined}
title={quickTitle}
onTitleChange={setQuickTitle}
sketch={quickSketch}
onSketchChange={setQuickSketch}
focusAreaId={quickFocusAreaId}
onFocusAreaChange={setQuickFocusAreaId}
focusAreas={catalogs.focusAreas}
catalogsReady={catalogsReady}
busy={quickSaving}
error={quickAiError}
onRunAi={runQuickCreateAiSuggest}
hint={
aiQuickCreateEnabled
? 'Titel aus Suche oder manuell; Kurzbeschreibung optional — leer für freien KI-Vorschlag, ausgefüllt als deine Ausgangsidee.'
: undefined
}
{showKiCreateTeaser ? (
<ExerciseAiQuickCreateTeaser
onExpand={() => setAiQuickCreateModalOpen(true)}
disabled={quickSaving}
/>
) : null}
@@ -762,22 +794,36 @@ function ExercisesListPageRoot() {
onClose={() => setPeekExercise(null)}
/>
{listFetching && exercises.length === 0 && selectedEntries.length === 0 ? (
{listFetchingDisplay && exercisesForDisplay.length === 0 && selectedEntries.length === 0 ? (
<div className="card empty-state" style={{ padding: '2rem 1rem' }}>
<div className="spinner" />
<p className="muted" style={{ marginTop: '12px' }}>
Lade Übungen…
{aiQuickCreateEnabled ? 'Planungs-KI lädt Vorschläge…' : 'Lade Übungen…'}
</p>
</div>
) : exercises.length === 0 && selectedEntries.length === 0 && !showQuickCreateOffer ? (
) : exercisesForDisplay.length === 0 && selectedEntries.length === 0 ? (
<div className="card">
<p className="exercises-empty-text">
{debouncedSearch.length >= 3
? 'Keine Übungen gefunden.'
: 'Keine Übungen gefunden — Suchbegriff eingeben oder Filter anpassen.'}
{aiQuickCreateEnabled
? planningKi.hasSearched
? 'Keine passenden Übungen — neue Übung mit KI anlegen?'
: 'Planungs-Anfrage formulieren und „Vorschläge laden“ klicken — oder „Neue Übung mit KI“ oben.'
: debouncedSearch.length >= 3
? 'Keine Übungen gefunden.'
: 'Keine Übungen gefunden — Suchbegriff eingeben oder Filter anpassen.'}
</p>
{aiQuickCreateEnabled && planningKi.hasSearched ? (
<button
type="button"
className="btn btn-secondary"
style={{ marginTop: '12px' }}
onClick={() => setAiQuickCreateModalOpen(true)}
>
Neue Übung mit KI …
</button>
) : null}
</div>
) : exercises.length === 0 && selectedEntries.length === 0 && showQuickCreateOffer ? null : (
) : (
<>
{selectedEntries.length > 0 ? (
<section className="exercises-selection-section" data-testid="exercises-selection-section">
@@ -812,13 +858,14 @@ function ExercisesListPageRoot() {
) : null
) : (
<>
{listFetching ? (
{listFetchingDisplay ? (
<p className="exercises-meta-line exercises-meta-line--muted">Aktualisiere Treffer…</p>
) : null}
<p className="exercises-meta-line">
{filterResultExercises.length} Treffer
{aiQuickCreateEnabled ? ' (Planungs-KI)' : ''}
{selectedEntries.length > 0 ? ' (ohne bereits Ausgewählte)' : ''}
{hasMore ? ' · es gibt weitere Einträge' : ''}
{hasMoreDisplay ? ' · es gibt weitere Einträge' : ''}
</p>
<div className="exercises-list-grid" data-testid="exercises-list-grid">
{filterResultExercises.map((exercise) => (
@@ -833,7 +880,7 @@ function ExercisesListPageRoot() {
/>
))}
</div>
{hasMore && (
{hasMoreDisplay && (
<div className="exercises-load-more">
<button type="button" className="btn btn-secondary" disabled={loadingMore} onClick={loadMore}>
{loadingMore ? 'Laden…' : 'Mehr laden'}
@@ -845,6 +892,27 @@ function ExercisesListPageRoot() {
</>
)}
<ExerciseAiQuickCreateModal
open={aiQuickCreateModalOpen}
onClose={() => {
if (!quickSaving) setAiQuickCreateModalOpen(false)
}}
searchLabel={
planningKi.submittedQuery || planningKi.searchInput || debouncedSearch || undefined
}
title={quickTitle}
onTitleChange={setQuickTitle}
sketch={quickSketch}
onSketchChange={setQuickSketch}
focusAreaId={quickFocusAreaId}
onFocusAreaChange={setQuickFocusAreaId}
focusAreas={catalogs.focusAreas}
catalogsReady={catalogsReady}
busy={quickSaving}
error={quickAiError}
onRunAi={runQuickCreateAiSuggest}
/>
<ExerciseAiSuggestPreviewModal
draft={quickCreateDraft}
onDraftChange={setQuickCreateDraft}