Enhance Planning Catalog Context Integration in Progression Path
Deploy Development / deploy (push) Successful in 45s
Test Suite / pytest-backend (push) Successful in 43s
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 1m15s

- Updated `PROJECT_STATUS.md` to reflect the addition of the Planning AI Progression Graph and its context in the roadmap.
- Enhanced `DOMAIN_MODEL.md` with details on the new `planning_catalog_context` features, allowing trainers to manage curriculum stages and context.
- Added tests in `test_planning_catalog_context.py` to validate the separation of LLM highlights from fix hints during QA processes.
- Updated `HANDOVER.md` and `PLANNING_KI_ROADMAP.md` to reflect the latest app version and improvements in the planning context.
- Enhanced frontend components to support the new planning catalog context, including updates to `ExerciseProgressionPathBuilder` and `ProgressionGraphEditor`.
- Bumped version to 0.8.233 to reflect the new features and improvements.
This commit is contained in:
Lars committed 2026-06-12 12:25:52 +02:00
1 parent 6ab2f20f08
commit f3710ac0a1
11 files changed
+643 -198

No files matched your search

@@ -7,6 +7,16 @@ import api from '../utils/api'
import ExerciseAiQuickCreateModal from './exercises/ExerciseAiQuickCreateModal'
import ExerciseGapFillPrepModal from './exercises/ExerciseGapFillPrepModal'
import ExerciseAiSuggestPreviewModal from './ExerciseAiSuggestPreviewModal'
import PlanningCatalogContextFields from './PlanningCatalogContextFields'
import {
EMPTY_PLANNING_CATALOG_CONTEXT,
parsePlanningCatalogContextFromArtifact,
planningCatalogContextToApi,
pathQaQualityPercent,
pathQaShowsStrongResult,
setCatalogSelectItems,
splitPathQaHints,
} from '../utils/progressionGraphDraft'
import {
aiPreviewToQuickCreateDraft,
buildQuickCreateAiPreview,
@@ -449,9 +459,13 @@ function buildPlanningRoadmapArtifactSnapshot({
maxSteps,
progressionRoadmap,
pathSkillExpectations,
planningCatalogContext,
}) {
const q = (goalQuery || '').trim()
if (!q && !progressionRoadmap) return null
const catalogPayload = planningCatalogContextToApi(
planningCatalogContext || EMPTY_PLANNING_CATALOG_CONTEXT,
)
return {
schema_version: PLANNING_ARTIFACT_SCHEMA,
goal_query: q,
@@ -461,6 +475,9 @@ function buildPlanningRoadmapArtifactSnapshot({
max_steps: Number(maxSteps) || 5,
progression_roadmap: progressionRoadmap || null,
path_skill_expectations: pathSkillExpectations || null,
...(catalogPayload.planning_catalog_context
? { planning_catalog_context: catalogPayload.planning_catalog_context }
: {}),
}
}
@@ -544,6 +561,12 @@ export default function ExerciseProgressionPathBuilder({
const [startTargetAnalyzed, setStartTargetAnalyzed] = useState(false)
const loading = loadingRoadmap || loadingStartTarget || loadingMatch
const [focusAreas, setFocusAreas] = useState([])
const [styleDirections, setStyleDirections] = useState([])
const [trainingTypes, setTrainingTypes] = useState([])
const [targetGroups, setTargetGroups] = useState([])
const [planningCatalogContext, setPlanningCatalogContext] = useState(() => ({
...EMPTY_PLANNING_CATALOG_CONTEXT,
}))
const [skillsCatalog, setSkillsCatalog] = useState([])
const [generatingOfferId, setGeneratingOfferId] = useState(null)
@@ -571,6 +594,22 @@ export default function ExerciseProgressionPathBuilder({
[editableMajorSteps, pathSteps],
)
const catalogApiPayload = useMemo(
() => planningCatalogContextToApi(planningCatalogContext),
[planningCatalogContext],
)
const pathQaSplit = useMemo(() => splitPathQaHints(pathQa), [pathQa])
const pathQaHighlights = pathQaSplit.highlightTexts
const pathQaFixHints = pathQaSplit.fixHints
const patchCatalogDimension = useCallback((key, value) => {
setPlanningCatalogContext((prev) => ({
...prev,
[key]: setCatalogSelectItems(prev?.[key], value),
}))
}, [])
const buildPlanningArtifact = useCallback(
() =>
buildPlanningRoadmapArtifactSnapshot({
@@ -581,6 +620,7 @@ export default function ExerciseProgressionPathBuilder({
maxSteps,
progressionRoadmap,
pathSkillExpectations,
planningCatalogContext,
}),
[
goalQuery,
@@ -590,6 +630,7 @@ export default function ExerciseProgressionPathBuilder({
maxSteps,
progressionRoadmap,
pathSkillExpectations,
planningCatalogContext,
],
)
@@ -634,6 +675,9 @@ export default function ExerciseProgressionPathBuilder({
if (art.roadmap_notes) setRoadmapNotes(String(art.roadmap_notes))
if (art.max_steps) setMaxSteps(Number(art.max_steps))
if (art.path_skill_expectations) setPathSkillExpectations(art.path_skill_expectations)
if (art.planning_catalog_context) {
setPlanningCatalogContext(parsePlanningCatalogContextFromArtifact(art))
}
if (art.progression_roadmap) {
setProgressionRoadmap(art.progression_roadmap)
const majors = mapMajorStepsFromApi(art.progression_roadmap)
@@ -670,16 +714,25 @@ export default function ExerciseProgressionPathBuilder({
let cancelled = false
Promise.all([
api.listFocusAreas({ status: 'active' }),
api.listStyleDirections({ status: 'active' }),
api.listTrainingTypes({ status: 'active' }),
api.listTargetGroups({ status: 'active' }),
api.listSkillsCatalog({ status: 'active' }),
])
.then(([fa, sk]) => {
.then(([fa, sd, tt, tg, sk]) => {
if (cancelled) return
setFocusAreas(Array.isArray(fa) ? fa : [])
setStyleDirections(Array.isArray(sd) ? sd : [])
setTrainingTypes(Array.isArray(tt) ? tt : [])
setTargetGroups(Array.isArray(tg) ? tg : [])
setSkillsCatalog(Array.isArray(sk) ? sk : [])
})
.catch(() => {
if (!cancelled) {
setFocusAreas([])
setStyleDirections([])
setTrainingTypes([])
setTargetGroups([])
setSkillsCatalog([])
}
})
@@ -1095,6 +1148,7 @@ export default function ExerciseProgressionPathBuilder({
start_target_only: true,
progression_graph_id: Number(graphId),
...roadmapStructuredPayload(startSituation, targetState, roadmapNotes),
...catalogApiPayload,
})
applyStartTargetResponse(res)
} catch (e) {
@@ -1133,6 +1187,7 @@ export default function ExerciseProgressionPathBuilder({
roadmap_only: true,
progression_graph_id: Number(graphId),
...roadmapStructuredPayload(startSituation, targetState, roadmapNotes),
...catalogApiPayload,
})
const majors = mapMajorStepsFromApi(res?.progression_roadmap)
if (majors.length < 2) {
@@ -1204,6 +1259,7 @@ export default function ExerciseProgressionPathBuilder({
roadmap_override: override,
progression_graph_id: Number(graphId),
...roadmapStructuredPayload(startSituation, targetState, roadmapNotes),
...catalogApiPayload,
})
applyPathMatchResponse(res, q)
setMaxSteps(validSteps.length)
@@ -1406,6 +1462,16 @@ export default function ExerciseProgressionPathBuilder({
/>
</div>
</div>
<PlanningCatalogContextFields
catalogCtx={planningCatalogContext}
onPatchDimension={patchCatalogDimension}
focusAreas={focusAreas}
styleDirections={styleDirections}
trainingTypes={trainingTypes}
targetGroups={targetGroups}
disabled={disabled || loading || saving}
helperText="Planungskontext steuert Bibliotheks-Matching — wird mit dem Graph gespeichert."
/>
<p style={{ fontSize: '11px', color: 'var(--text3)', margin: '6px 0 0', lineHeight: 1.4 }}>
Optional zuerst „Start/Ziel analysieren“, anpassen, dann Roadmap-Stufen. Sind Start und Ziel leer,
geschieht die Analyse beim Roadmap-Vorschlag automatisch mit. Manuelle Eingaben haben immer Vorrang.
@@ -1826,11 +1892,40 @@ export default function ExerciseProgressionPathBuilder({
>
<strong>
Pfad-QS: {pathQa.overall_ok ? 'OK' : 'Hinweise'}
{pathQa.quality_score != null ? ` (${Math.round(Number(pathQa.quality_score) * 100)} %)` : ''}
{pathQaQualityPercent(pathQa) != null ? ` (${pathQaQualityPercent(pathQa)} %)` : ''}
</strong>
{pathQaShowsStrongResult(pathQa) ? (
<p style={{ margin: '6px 0 0', color: 'var(--accent-dark)', fontWeight: 600 }}>
Starker Pfad — KI-Highlights können Feinschliff oder optionale Vertiefung sein.
</p>
) : null}
{pathQa.topic_coverage ? (
<p style={{ margin: '6px 0 0', color: 'var(--text2)' }}>{pathQa.topic_coverage}</p>
) : null}
{pathQaHighlights.length > 0 ? (
<>
<p style={{ margin: '8px 0 4px', fontWeight: 600, color: 'var(--accent-dark)' }}>
KI-Highlights ({pathQaHighlights.length})
</p>
<ul style={{ margin: 0, padding: 0, listStyle: 'none', display: 'flex', flexDirection: 'column', gap: '6px' }}>
{pathQaHighlights.map((item, i) => (
<li
key={`hl-${i}-${item.text.slice(0, 24)}`}
style={{
padding: '8px 10px',
borderRadius: '6px',
border: '1px solid color-mix(in srgb, var(--accent) 35%, var(--border))',
background: 'color-mix(in srgb, var(--accent) 10%, var(--surface2))',
fontSize: '11px',
color: 'var(--text1)',
}}
>
{item.text}
</li>
))}
</ul>
</>
) : null}
{Array.isArray(pathQa.issues) && pathQa.issues.length > 0 ? (
<ul style={{ margin: '6px 0 0', paddingLeft: '16px', color: 'var(--text2)' }}>
{pathQa.issues.slice(0, 4).map((issue) => (
@@ -1838,6 +1933,21 @@ export default function ExerciseProgressionPathBuilder({
))}
</ul>
) : null}
{pathQaFixHints.length > 0 ? (
<>
<p style={{ margin: '8px 0 4px', fontWeight: 600, color: 'var(--text2)' }}>
Handlungsbedarf ({pathQaFixHints.length})
</p>
<ul style={{ margin: 0, paddingLeft: '16px', color: 'var(--text2)' }}>
{pathQaFixHints.slice(0, 6).map((hint, i) => (
<li key={`fix-${i}-${hint.issue}-${hint.step_index ?? 'x'}`}>
{hint.title ? `${hint.title}: ` : ''}
{hint.reason || hint.issue}
</li>
))}
</ul>
</>
) : null}
{Number(pathQa.bridge_insert_count) > 0 ? (
<p style={{ margin: '6px 0 0', color: 'var(--accent-dark)' }}>
{pathQa.bridge_insert_count} Brücken-Übung(en) aus der Bibliothek eingefügt.
@@ -0,0 +1,99 @@
/**
* Planungskontext — Katalog-Dimensionen für Progressionsgraph-Matching.
*/
import React from 'react'
import { getCatalogSelectId } from '../utils/progressionGraphDraft'
export default function PlanningCatalogContextFields({
catalogCtx,
onPatchDimension,
focusAreas = [],
styleDirections = [],
trainingTypes = [],
targetGroups = [],
disabled = false,
helperText = 'Planungskontext steuert Bibliotheks-Matching (Fokusbereich, Stil, Trainingsstil, Zielgruppe) — unabhängig von Technik-Pfaden.',
}) {
return (
<>
<div
style={{
display: 'grid',
gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))',
gap: '10px',
marginTop: '10px',
}}
>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Primärfokus</label>
<select
className="form-input"
disabled={disabled}
value={getCatalogSelectId(catalogCtx?.focusAreas)}
onChange={(e) => onPatchDimension('focusAreas', e.target.value)}
>
<option value="">— optional —</option>
{(focusAreas || []).map((fa) => (
<option key={fa.id} value={String(fa.id)}>
{fa.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Stilrichtung</label>
<select
className="form-input"
disabled={disabled}
value={getCatalogSelectId(catalogCtx?.styleDirections)}
onChange={(e) => onPatchDimension('styleDirections', e.target.value)}
>
<option value="">— optional —</option>
{(styleDirections || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Trainingsstil</label>
<select
className="form-input"
disabled={disabled}
value={getCatalogSelectId(catalogCtx?.trainingTypes)}
onChange={(e) => onPatchDimension('trainingTypes', e.target.value)}
>
<option value="">— optional —</option>
{(trainingTypes || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Zielgruppe</label>
<select
className="form-input"
disabled={disabled}
value={getCatalogSelectId(catalogCtx?.targetGroups)}
onChange={(e) => onPatchDimension('targetGroups', e.target.value)}
>
<option value="">— optional —</option>
{(targetGroups || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
</div>
{helperText ? (
<p style={{ fontSize: '11px', color: 'var(--text3)', margin: '8px 0 0', lineHeight: 1.4 }}>
{helperText}
</p>
) : null}
</>
)
}
@@ -10,8 +10,11 @@ import {
formatRematchLogEntry,
formatRefineLogEntry,
hasRematchSlotHints,
pathQaQualityPercent,
pathQaShowsStrongResult,
resolveHintSlotIndex,
resolveOfferSlotIndex,
splitPathQaHints,
} from '../utils/progressionGraphDraft'
function severityStyle(pathQa) {
@@ -164,10 +167,15 @@ export default function ProgressionFindingsPanel({
aiBusy = false,
evaluateDisabled = false,
}) {
const optimizationHints = Array.isArray(pathQa?.optimization_hints) ? pathQa.optimization_hints : []
const { fixHints: optimizationHints, highlightTexts } = useMemo(
() => splitPathQaHints(pathQa),
[pathQa],
)
const rematchLog = Array.isArray(pathQa?.rematch_log) ? pathQa.rematch_log : []
const refineLog = Array.isArray(pathQa?.refine_log) ? pathQa.refine_log : []
const showRematchAction = hasRematchSlotHints(pathQa) && typeof onRematchSlots === 'function'
const qualityPct = pathQaQualityPercent(pathQa)
const strongResult = pathQaShowsStrongResult(pathQa)
return (
<div className="card" style={{ position: 'sticky', top: '12px' }}>
@@ -204,13 +212,50 @@ export default function ProgressionFindingsPanel({
>
<strong>
Pfad-QS: {pathQa.overall_ok ? 'OK' : 'Hinweise'}
{pathQa.quality_score != null
? ` (${Math.round(Number(pathQa.quality_score) * 100)} %)`
: ''}
{qualityPct != null ? ` (${qualityPct} %)` : ''}
</strong>
{strongResult ? (
<p style={{ margin: '6px 0 0', color: 'var(--accent-dark)', fontWeight: 600 }}>
Starker Pfad — KI-Empfehlungen unten können Feinschliff oder optionale Vertiefung sein.
</p>
) : null}
{pathQa.topic_coverage ? (
<p style={{ margin: '6px 0 0', color: 'var(--text2)' }}>{pathQa.topic_coverage}</p>
) : null}
{highlightTexts.length > 0 ? (
<>
<p style={{ margin: '8px 0 4px', fontWeight: 600, color: 'var(--accent-dark)' }}>
KI-Highlights ({highlightTexts.length})
</p>
<ul
style={{
margin: 0,
padding: 0,
listStyle: 'none',
display: 'flex',
flexDirection: 'column',
gap: '6px',
}}
>
{highlightTexts.map((item, i) => (
<li
key={`hl-${i}-${item.text.slice(0, 24)}`}
style={{
padding: '8px 10px',
borderRadius: '6px',
border: '1px solid color-mix(in srgb, var(--accent) 35%, var(--border))',
background: 'color-mix(in srgb, var(--accent) 10%, var(--surface2))',
fontSize: '11px',
color: 'var(--text1)',
lineHeight: 1.45,
}}
>
{item.text}
</li>
))}
</ul>
</>
) : null}
{Array.isArray(pathQa.issues) && pathQa.issues.length > 0 ? (
<ul style={{ margin: '6px 0 0', paddingLeft: '16px', color: 'var(--text2)' }}>
{pathQa.issues.map((issue) => (
@@ -218,7 +263,9 @@ export default function ProgressionFindingsPanel({
))}
</ul>
) : null}
{Array.isArray(pathQa.recommendations) && pathQa.recommendations.length > 0 ? (
{Array.isArray(pathQa.recommendations) &&
pathQa.recommendations.length > 0 &&
highlightTexts.length === 0 ? (
<>
<p style={{ margin: '8px 0 4px', fontWeight: 600, color: 'var(--text2)' }}>Empfehlungen</p>
<ul style={{ margin: 0, paddingLeft: '16px', color: 'var(--text2)' }}>
@@ -265,7 +312,7 @@ export default function ProgressionFindingsPanel({
{optimizationHints.length > 0 ? (
<>
<p style={{ margin: '8px 0 4px', fontWeight: 600, color: 'var(--text2)' }}>
Optimierungspotenziale ({optimizationHints.length})
Handlungsbedarf ({optimizationHints.length})
</p>
<ul
style={{
@@ -8,6 +8,7 @@ import ExercisePickerModal from './ExercisePickerModal'
import ExerciseGapFillPrepModal from './exercises/ExerciseGapFillPrepModal'
import ProgressionSlotCard from './ProgressionSlotCard'
import ProgressionFindingsPanel from './ProgressionFindingsPanel'
import PlanningCatalogContextFields from './PlanningCatalogContextFields'
import {
aiPreviewToQuickCreateDraft,
buildQuickCreateAiPreview,
@@ -46,7 +47,6 @@ import {
syncProgressionRoadmapFromSlots,
syncSlotPhasesFromRoadmap,
EMPTY_PLANNING_CATALOG_CONTEXT,
getCatalogSelectId,
planningCatalogContextToApi,
setCatalogSelectItems,
} from '../utils/progressionGraphDraft'
@@ -909,83 +909,16 @@ export default function ProgressionGraphEditor({ graphId, embedded = false, onSa
/>
</div>
</div>
<div
style={{
display: 'grid',
gridTemplateColumns: 'repeat(auto-fit, minmax(180px, 1fr))',
gap: '10px',
marginTop: '10px',
}}
>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Primärfokus</label>
<select
className="form-input"
disabled={busy}
value={getCatalogSelectId(catalogCtx.focusAreas)}
onChange={(e) => patchCatalogDimension('focusAreas', e.target.value)}
>
<option value="">— optional —</option>
{(focusAreas || []).map((fa) => (
<option key={fa.id} value={String(fa.id)}>
{fa.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Stilrichtung</label>
<select
className="form-input"
disabled={busy}
value={getCatalogSelectId(catalogCtx.styleDirections)}
onChange={(e) => patchCatalogDimension('styleDirections', e.target.value)}
>
<option value="">— optional —</option>
{(styleDirections || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Trainingsstil</label>
<select
className="form-input"
disabled={busy}
value={getCatalogSelectId(catalogCtx.trainingTypes)}
onChange={(e) => patchCatalogDimension('trainingTypes', e.target.value)}
>
<option value="">— optional —</option>
{(trainingTypes || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
<div className="form-row" style={{ marginBottom: 0 }}>
<label className="form-label">Zielgruppe</label>
<select
className="form-input"
disabled={busy}
value={getCatalogSelectId(catalogCtx.targetGroups)}
onChange={(e) => patchCatalogDimension('targetGroups', e.target.value)}
>
<option value="">— optional —</option>
{(targetGroups || []).map((row) => (
<option key={row.id} value={String(row.id)}>
{row.name}
</option>
))}
</select>
</div>
</div>
<p style={{ fontSize: '11px', color: 'var(--text3)', margin: '8px 0 0', lineHeight: 1.4 }}>
Planungskontext steuert Bibliotheks-Matching (Fokusbereich, Stil, Trainingsstil, Zielgruppe) — unabhängig
von Technik-Pfaden wie Mae Geri. Wird mit dem Graph gespeichert.
</p>
<PlanningCatalogContextFields
catalogCtx={catalogCtx}
onPatchDimension={patchCatalogDimension}
focusAreas={focusAreas}
styleDirections={styleDirections}
trainingTypes={trainingTypes}
targetGroups={targetGroups}
disabled={busy}
helperText="Planungskontext steuert Bibliotheks-Matching (Fokusbereich, Stil, Trainingsstil, Zielgruppe) — unabhängig von Technik-Pfaden wie Mae Geri. Wird mit dem Graph gespeichert."
/>
<p style={{ fontSize: '11px', color: 'var(--text3)', margin: '8px 0 0', lineHeight: 1.4 }}>
Optional zuerst „Start/Ziel analysieren“, anpassen, dann Roadmap-Stufen. Sind Start und Ziel leer,
geschieht die Analyse beim Roadmap-Vorschlag automatisch. Manuelle Eingaben haben Vorrang.