feat: update version to 0.7.4 and enhance maturity model functionality
Deploy Development / deploy (push) Successful in 36s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 5s
Test Suite / playwright-tests (push) Failing after 1m59s

- Incremented application version to 0.7.4 and updated database schema version to 20260427027.
- Enhanced maturity model context bindings to support new filtering options for training styles.
- Introduced new API endpoints for importing and exporting maturity model bundles.
- Updated frontend components to include a matrix view and improved admin UI for managing maturity models.
- Documented changes in the changelog for version 0.7.4, detailing new features and improvements.
This commit is contained in:
Lars committed 2026-04-27 12:48:22 +02:00
1 parent 3397b2094d
commit f2c007cc68
8 files changed
+1043 -71

No files matched your search

@@ -0,0 +1,383 @@
import React, { useEffect, useMemo, useState } from 'react'
import api from '../../utils/api'
function downloadJson(obj, filename) {
const blob = new Blob([JSON.stringify(obj, null, 2)], {
type: 'application/json;charset=utf-8'
})
const url = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = url
a.download = filename
a.click()
URL.revokeObjectURL(url)
}
function groupModelSkills(model) {
if (!model?.model_skills?.length) return []
const groups = new Map()
for (const ms of model.model_skills) {
const main = ms.skill_main_category_name || '—'
const sub = ms.skill_subcategory_name || '—'
const k = `${main}\t${sub}`
if (!groups.has(k)) groups.set(k, { main, sub, skills: [] })
groups.get(k).skills.push(ms)
}
return Array.from(groups.values())
}
function cellMapForSkill(model, skillId) {
const m = {}
for (const sl of model.skill_levels || []) {
if (Number(sl.skill_id) === Number(skillId)) {
m[sl.level_number] = sl
}
}
return m
}
export default function MaturityMatrixToolsAdmin() {
const [focusAreas, setFocusAreas] = useState([])
const [styles, setStyles] = useState([])
const [trainingTypes, setTrainingTypes] = useState([])
const [models, setModels] = useState([])
const [focusId, setFocusId] = useState('')
const [styleId, setStyleId] = useState('')
const [typeId, setTypeId] = useState('')
const [matrix, setMatrix] = useState(null)
const [loading, setLoading] = useState(false)
const [error, setError] = useState('')
const [message, setMessage] = useState('')
const [importMode, setImportMode] = useState('create')
const [replaceModelId, setReplaceModelId] = useState('')
const [exportModelId, setExportModelId] = useState('')
const [importBindings, setImportBindings] = useState(true)
useEffect(() => {
let cancelled = false
;(async () => {
try {
const [fa, sd, tt, m] = await Promise.all([
api.listFocusAreas({}),
api.listStyleDirections({}),
api.listTrainingTypes({}),
api.listMaturityModels({})
])
if (!cancelled) {
setFocusAreas(fa)
setStyles(sd)
setTrainingTypes(tt)
setModels(m)
}
} catch (e) {
if (!cancelled) setError(e.message || String(e))
}
})()
return () => {
cancelled = true
}
}, [])
const groups = useMemo(() => (matrix ? groupModelSkills(matrix) : []), [matrix])
const levels = matrix?.levels || []
async function handleResolve() {
if (!focusId) {
setError('Fokusbereich wählen.')
return
}
setLoading(true)
setError('')
setMessage('')
setMatrix(null)
try {
const params = { focus_area_id: focusId }
if (styleId) params.style_direction_id = styleId
if (typeId) params.training_type_id = typeId
const m = await api.resolveMaturityModel(params)
setMatrix(m)
if (!m) setError('Keine Matrix für diesen Kontext.')
else setMessage('Matrix geladen.')
} catch (e) {
setError(e.message || String(e))
} finally {
setLoading(false)
}
}
async function handleExportResolved() {
if (!focusId) {
setError('Fokusbereich wählen.')
return
}
setError('')
setMessage('')
try {
const params = { focus_area_id: focusId }
if (styleId) params.style_direction_id = styleId
if (typeId) params.training_type_id = typeId
const bundle = await api.exportResolvedMaturityBundle(params)
downloadJson(bundle, 'faehigkeitsmatrix-aufgeloest.json')
setMessage('Export gestartet (Download).')
} catch (e) {
setError(e.message || String(e))
}
}
async function handleExportStored() {
if (!exportModelId) {
setError('Modell für Export auswählen.')
return
}
setError('')
setMessage('')
try {
const bundle = await api.exportMaturityModelBundle(parseInt(exportModelId, 10))
downloadJson(bundle, `reifegradmodell-${exportModelId}.json`)
setMessage('Export gestartet (Download).')
} catch (e) {
setError(e.message || String(e))
}
}
async function handleImportFile(e) {
const file = e.target.files?.[0]
if (!file) return
setError('')
setMessage('')
try {
const data = JSON.parse(await file.text())
const payload = { ...data, mode: importMode, import_bindings: importBindings }
if (importMode === 'replace') {
if (!replaceModelId) {
setError('Bei „Ersetzen“ die Ziel-Modell-ID angeben.')
e.target.value = ''
return
}
payload.replace_model_id = parseInt(replaceModelId, 10)
}
const res = await api.importMaturityModelBundle(payload)
setMessage(`Import erfolgreich. Modell-ID: ${res.id}`)
setModels(await api.listMaturityModels({}))
} catch (err) {
setError(err.message || String(err))
} finally {
e.target.value = ''
}
}
return (
<div className="admin-matrix-tools">
<p className="admin-matrix-tools__intro muted">
Matrix nach Kontext auflösen, hierarchisch nach Hauptkategorie und Kategorie darstellen, sowie JSON
exportieren oder importieren (gespeichertes Modell inkl. optional Kontext-Bindings, oder aufgelöste Matrix).
</p>
{error ? (
<div className="skills-catalog-admin__error" role="alert">
{error}
</div>
) : null}
{message ? <p className="muted admin-matrix-tools__msg">{message}</p> : null}
<section className="card admin-matrix-tools__section">
<h2 className="admin-matrix-tools__h2">Kontext und Anzeige</h2>
<div className="admin-matrix-tools__filters">
<div>
<label className="form-label">Fokusbereich</label>
<select
className="form-input"
value={focusId}
onChange={(e) => setFocusId(e.target.value)}
>
<option value="">— wählen —</option>
{focusAreas.map((f) => (
<option key={f.id} value={f.id}>
{f.name}
</option>
))}
</select>
</div>
<div>
<label className="form-label">Stilrichtung (optional)</label>
<select
className="form-input"
value={styleId}
onChange={(e) => setStyleId(e.target.value)}
>
<option value="">— alle / egal —</option>
{styles.map((s) => (
<option key={s.id} value={s.id}>
{s.name}
</option>
))}
</select>
</div>
<div>
<label className="form-label">Trainingsstil (optional)</label>
<select className="form-input" value={typeId} onChange={(e) => setTypeId(e.target.value)}>
<option value="">— alle / egal —</option>
{trainingTypes.map((t) => (
<option key={t.id} value={t.id}>
{t.name}
</option>
))}
</select>
</div>
</div>
<div className="admin-matrix-tools__actions">
<button type="button" className="btn btn-primary" disabled={loading} onClick={handleResolve}>
{loading ? 'Lade…' : 'Matrix auflösen & anzeigen'}
</button>
<button type="button" className="btn btn-secondary" onClick={handleExportResolved}>
Aufgelöste Matrix exportieren (JSON)
</button>
</div>
{matrix?.resolution ? (
<p className="muted admin-matrix-tools__meta">
Quelle:{' '}
{matrix.resolution.merged
? `zusammengeführt aus Modell-IDs ${(matrix.resolution.source_model_ids || []).join(', ')}`
: `Modell-ID ${matrix.id}`}
</p>
) : null}
</section>
{matrix ? (
<section className="card admin-matrix-tools__section admin-matrix-tools__visual">
<h2 className="admin-matrix-tools__h2">
{matrix.name}
<span className="muted admin-matrix-tools__subtitle">
{' '}
· {matrix.level_count} Stufen · {matrix.model_skills?.length || 0} Fähigkeiten
</span>
</h2>
{groups.map((g) => (
<div key={`${g.main}-${g.sub}`} className="admin-matrix-visual-group">
<h3 className="admin-matrix-visual-group__main">{g.main}</h3>
<h4 className="admin-matrix-visual-group__sub">{g.sub}</h4>
<div className="admin-matrix-visual-table-wrap">
<table className="admin-matrix-visual-table">
<thead>
<tr>
<th className="admin-matrix-visual-table__skill">Fähigkeit</th>
{levels.map((lv) => (
<th key={lv.level_number} className="admin-matrix-visual-table__level">
<span className="admin-matrix-visual-table__ln">{lv.level_number}</span>
<span className="admin-matrix-visual-table__lname">{lv.name}</span>
</th>
))}
</tr>
</thead>
<tbody>
{g.skills.map((ms) => {
const cells = cellMapForSkill(matrix, ms.skill_id)
return (
<tr key={ms.skill_id}>
<td className="admin-matrix-visual-table__skill-cell">{ms.skill_name}</td>
{levels.map((lv) => {
const c = cells[lv.level_number]
return (
<td key={lv.level_number} className="admin-matrix-visual-table__cell">
{c ? (
<>
<div className="admin-matrix-visual-table__goal">
{c.description || '—'}
</div>
{c.observable_criteria ? (
<div className="admin-matrix-visual-table__obs muted">
<strong>Beobachtung:</strong> {c.observable_criteria}
</div>
) : null}
</>
) : (
<span className="muted">—</span>
)}
</td>
)
})}
</tr>
)
})}
</tbody>
</table>
</div>
</div>
))}
</section>
) : null}
<section className="card admin-matrix-tools__section">
<h2 className="admin-matrix-tools__h2">Export / Import (JSON)</h2>
<div className="admin-matrix-tools__io-grid">
<div>
<h3 className="admin-matrix-tools__h3">Gespeichertes Modell exportieren</h3>
<p className="muted admin-matrix-tools__hint">
Enthält Stufen, Fähigkeiten, Zelltexte und die dem Modell zugeordneten Kontext-Bindings.
</p>
<label className="form-label">Modell</label>
<select
className="form-input"
value={exportModelId}
onChange={(e) => setExportModelId(e.target.value)}
>
<option value="">— wählen —</option>
{models.map((m) => (
<option key={m.id} value={m.id}>
{m.name} ({m.status})
</option>
))}
</select>
<button
type="button"
className="btn btn-secondary admin-matrix-tools__btn-mt"
onClick={handleExportStored}
>
JSON herunterladen
</button>
</div>
<div>
<h3 className="admin-matrix-tools__h3">Import</h3>
<p className="muted admin-matrix-tools__hint">
Datei <code className="admin-bindings__code">shinkan.maturity_model.v1</code> oder{' '}
<code className="admin-bindings__code">shinkan.maturity_matrix_resolved.v1</code>. Aufgelöste
Matrizen legen ein neues Modell an bzw. ersetzen den Inhalt des Zielmodells (ohne Bindings).
</p>
<label className="form-label">Modus</label>
<select
className="form-input"
value={importMode}
onChange={(e) => setImportMode(e.target.value)}
>
<option value="create">Neues Modell anlegen</option>
<option value="replace">Bestehendes Modell ersetzen (Matrix-Inhalt)</option>
</select>
{importMode === 'replace' ? (
<>
<label className="form-label">Ziel-Modell-ID</label>
<input
className="form-input"
type="number"
inputMode="numeric"
value={replaceModelId}
onChange={(e) => setReplaceModelId(e.target.value)}
placeholder="z. B. 3"
/>
</>
) : null}
<label className="form-label admin-matrix-tools__check">
<input
type="checkbox"
checked={importBindings}
onChange={(e) => setImportBindings(e.target.checked)}
/>{' '}
Kontext-Bindings mit importieren (nur bei <code className="admin-bindings__code">.maturity_model.v1</code>)
</label>
<label className="form-label">JSON-Datei</label>
<input type="file" accept="application/json,.json" onChange={handleImportFile} />
</div>
</div>
</section>
</div>
)
}
@@ -4,12 +4,16 @@ import api from '../../utils/api'
const TIER_LABEL = {
focus: 'Nur Fokusbereich',
focus_style: 'Fokus + Stilrichtung',
focus_training: 'Fokus + Trainingsstil',
focus_style_type: 'Fokus + Stilrichtung + Trainingsstil'
}
function tierFromRow(row) {
if (row.style_direction_id == null && row.training_type_id == null) return 'focus'
if (row.training_type_id == null) return 'focus_style'
const hs = row.style_direction_id != null
const ht = row.training_type_id != null
if (!hs && !ht) return 'focus'
if (hs && !ht) return 'focus_style'
if (!hs && ht) return 'focus_training'
return 'focus_style_type'
}
@@ -67,6 +71,8 @@ export default function MaturityModelBindingsAdmin() {
setFormTypeId('')
} else if (tier === 'focus_style') {
setFormTypeId('')
} else if (tier === 'focus_training') {
setFormStyleId('')
}
}, [tier])
@@ -87,7 +93,7 @@ export default function MaturityModelBindingsAdmin() {
}
payload.style_direction_id = parseInt(formStyleId, 10)
}
if (tier === 'focus_style_type') {
if (tier === 'focus_training' || tier === 'focus_style_type') {
if (!formTypeId) {
setError('Trainingsstil auswählen.')
return
@@ -125,16 +131,12 @@ export default function MaturityModelBindingsAdmin() {
return (
<div className="admin-bindings">
<p className="admin-bindings__intro muted">
<strong>Vererbung:</strong> Ein Modell auf Ebene „Fokusbereich“ gilt als Basis für diesen Fokus. Gibt es
eine spezifischere Zeile (Fokus + Stilrichtung oder + Trainingsstil), werden bei der Auflösung der Matrix{' '}
<strong>dieselben Fähigkeiten</strong> mit den Texten aus dem spezifischeren Modell überschrieben.
Zusätzliche Fähigkeiten aus einem Overlay-Modell erscheinen als weitere Zeilen. Stufen (Spalten) kommen
immer vom <strong>Basis-Modell</strong> (Fokus-Ebene).
</p>
<p className="admin-bindings__intro muted">
API <code className="admin-bindings__code">GET /api/maturity-models/resolve</code> berücksichtigt{' '}
<code className="admin-bindings__code">training_type_id</code> (Trainingsstil ={' '}
<em>training_types</em>, z. B. Leistungssport) zusätzlich zu Fokus und Stilrichtung.
<strong>Zusammenführung:</strong> Zu einem Fokus können mehrere Zeilen existieren (nur Fokus, Fokus +
Stilrichtung, Fokus + Trainingsstil ohne Stil, oder alle drei). Beim Aufruf von{' '}
<code className="admin-bindings__code">/maturity-models/resolve</code> werden alle zur Anfrage passenden
Zeilen ermittelt, nach Spezifität sortiert (weniger zuerst) und zu einer Matrix verbunden: spezifischere
Zuordnungen überschreiben Zelltexte gleicher Fähigkeit und Stufe. Stufen (Spalten) stammen vom{' '}
<strong>ersten</strong> (am wenigsten spezifischen) Modell in dieser Kette.
</p>
{error ? (
@@ -156,6 +158,7 @@ export default function MaturityModelBindingsAdmin() {
>
<option value="focus">{TIER_LABEL.focus}</option>
<option value="focus_style">{TIER_LABEL.focus_style}</option>
<option value="focus_training">{TIER_LABEL.focus_training}</option>
<option value="focus_style_type">{TIER_LABEL.focus_style_type}</option>
</select>
</div>
@@ -195,9 +198,9 @@ export default function MaturityModelBindingsAdmin() {
</select>
</div>
)}
{tier === 'focus_style_type' && (
{(tier === 'focus_training' || tier === 'focus_style_type') && (
<div>
<label className="form-label">Trainingsstil (z. B. Leistungssport)</label>
<label className="form-label">Trainingsstil (z. B. Breitensport)</label>
<select
className="form-input"
value={formTypeId}
@@ -255,8 +258,9 @@ export default function MaturityModelBindingsAdmin() {
{bindings.length === 0 ? (
<tr>
<td colSpan={6} className="muted">
Noch keine Einträge. Legen Sie mindestens eine Fokus-Basis-Zeile an, damit{' '}
<code>/maturity-models/resolve</code> die neue Logik nutzt.
Noch keine Einträge. Sobald hier Zeilen existieren und ein passender Kontext an{' '}
<code>/maturity-models/resolve</code> übergeben wird, werden diese Zuordnungen statt der
reinen Legacy-Suche verwendet.
</td>
</tr>
) : (