Baustein 9: Auswertung, Rahmenplanabdeckung, Feedbackgespraech

Die Abdeckung des Ausbildungsrahmenplans ist die Ansicht, die gegenueber
der IHK zaehlt. Sie unterscheidet vier Lagen statt "erledigt/offen":

  vermittelt   eine abgenommene Aufgabe oder ein abgeschlossener
               Checklisten-Durchlauf, oder zwei gelesene Handouts
  angefangen   etwas erledigt, aber noch nicht genug
  geplant      Inhalt vorhanden, nichts davon bearbeitet
  ohne Inhalt  zu dieser Position gibt es im Lehrgang gar nichts

Die vierte Lage ist die wichtigste: Sie ist keine Luecke beim Azubi,
sondern eine im Lehrgang, und wird getrennt ausgewiesen. Die Regel steht
als reine Funktion in src/lib/auswertung/abdeckung.ts, mit 17 Tests.

Das Feedbackgespraech laesst beide Seiten getrennt bewerten. Wo sie um
zwei Stufen oder mehr auseinanderliegen, wird das hervorgehoben - in der
Ansicht, in der Uebersicht und im PDF, alle drei ueber dieselbe Funktion
liegtWeitAuseinander(). Nach beidseitiger Bestaetigung ist das Gespraech
unveraenderlich und wird nur noch gelesen.

Durchstich in scripts/pruefungen/baustein-9.mjs: alle fuenf Luecken
erkannt, getrennte Spalten, Sperre serverseitig, PDF nur mit Anmeldung,
ein fremder Azubi bekommt 404 - auch auf das PDF.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-11 14:08:49 +02:00
co-authored by Claude Opus 5
parent d226a6bae8
commit be2a674c7a
53 changed files with 3138 additions and 4 deletions
+152
View File
@@ -0,0 +1,152 @@
import type { Metadata } from 'next';
import Link from 'next/link';
import { erfordereBenutzer } from '@/lib/auth/rechte';
import { ausbildungenVonAusbilder, ausbildungNachAzubi } from '@/lib/repos/ausbildung';
import { inhalte } from '@/lib/inhalte';
import { gespraecheVon, inhaltVon } from '@/lib/repos/feedback';
import { istAbgeschlossen, zusammenfassung } from '@/lib/feedback/inhalt';
import { alsDatumText, heute, montagDerWoche } from '@/lib/zeit';
import { gespraechAnlegen } from './aktionen';
export const metadata: Metadata = { title: 'Feedbackgespräche' };
export const dynamic = 'force-dynamic';
export default async function FeedbackSeite() {
const benutzer = await erfordereBenutzer();
const vorlage = inhalte().feedback;
const beteiligte =
benutzer.rolle === 'ausbilder'
? ausbildungenVonAusbilder(benutzer.id).map(({ azubi, ausbildung }) => ({ azubi, ausbildung }))
: (() => {
const ausbildung = ausbildungNachAzubi(benutzer.id);
return ausbildung ? [{ azubi: benutzer, ausbildung }] : [];
})();
return (
<div className="stapel">
<div>
<h1>Feedbackgespräche</h1>
<p className="leise">
Monatlich, mit Leitfaden und Bewertungsbogen. Von beiden Seiten bestätigt und danach unveränderlich –
für die Ausbildungsakte.
</p>
</div>
{beteiligte.length === 0 ? (
<p className="hinweis hinweis-warnung">
{benutzer.rolle === 'ausbilder' ? (
<>
Noch kein Azubikonto. <Link href="/verwaltung">Jetzt eines anlegen</Link>.
</>
) : (
'Zu deinem Konto ist noch keine Ausbildung hinterlegt.'
)}
</p>
) : (
beteiligte.map(({ azubi, ausbildung }) => {
const gespraeche = gespraecheVon(ausbildung.id);
const letztes = gespraeche[0];
const faellig =
!letztes || montagDerWoche(letztes.datum) < montagDerWoche(vorMonaten(heute(), 1));
return (
<section key={ausbildung.id} className="stapel" aria-labelledby={`azubi-${azubi.id}`}>
<div className="reihe" style={{ justifyContent: 'space-between' }}>
<h2 id={`azubi-${azubi.id}`} style={{ margin: 0 }}>
{benutzer.rolle === 'ausbilder' ? azubi.name : 'Deine Gespräche'}
</h2>
{benutzer.rolle === 'ausbilder' ? (
<form action={gespraechAnlegen}>
<input type="hidden" name="azubiId" value={azubi.id} />
<input type="hidden" name="datum" value={heute()} />
<button type="submit" className={`knopf ${faellig ? 'knopf-akzent' : 'knopf-zweit'}`}>
Neues Gespräch anlegen
</button>
</form>
) : null}
</div>
{faellig && benutzer.rolle === 'ausbilder' ? (
<p className="hinweis hinweis-warnung" style={{ marginBottom: 0 }}>
{letztes
? `Das letzte Gespräch war am ${alsDatumText(letztes.datum)} – das ist über einen Monat her.`
: 'Es gab noch kein Feedbackgespräch.'}
</p>
) : null}
{gespraeche.length === 0 ? (
<p className="karte" style={{ marginBottom: 0 }}>
Noch kein Gespräch geführt.
</p>
) : (
<ul className="gespraechsliste">
{gespraeche.map((gespraech) => {
const inhalt = inhaltVon(gespraech, vorlage);
const summe = zusammenfassung(inhalt);
const fertig = istAbgeschlossen({
bestaetigtAzubi: gespraech.bestaetigtAzubi === 1,
bestaetigtAusbilder: gespraech.bestaetigtAusbilder === 1,
});
return (
<li key={gespraech.id}>
<Link href={`/feedback/${gespraech.id}`} className="gespraechszeile">
<span className="gespraech-datum">{alsDatumText(gespraech.datum)}</span>
<span className="gespraech-inhalt">
{summe.bewertet} von {summe.gesamt} Kriterien bewertet
<span className="leise" style={{ display: 'block', fontWeight: 400 }}>
{summe.schnittAusbilder !== null
? `Ausbilder ⌀ ${zahl(summe.schnittAusbilder)}`
: 'noch keine Einschätzung'}
{summe.schnittAzubi !== null ? ` · Selbsteinschätzung ⌀ ${zahl(summe.schnittAzubi)}` : ''}
{summe.abweichungen.length > 0
? ` · ${summe.abweichungen.length} unterschiedliche Sicht${summe.abweichungen.length === 1 ? '' : 'en'}`
: ''}
</span>
</span>
<span className="reihe" style={{ gap: '0.35rem' }}>
<span
className="marke-status"
data-ton={gespraech.bestaetigtAusbilder === 1 ? 'gut' : 'neutral'}
>
{gespraech.bestaetigtAusbilder === 1 ? '✓' : '○'} Ausbilder
</span>
<span
className="marke-status"
data-ton={gespraech.bestaetigtAzubi === 1 ? 'gut' : 'neutral'}
>
{gespraech.bestaetigtAzubi === 1 ? '✓' : '○'} Azubi
</span>
{fertig ? (
<span className="marke-status" data-ton="gut">
🔒 abgeschlossen
</span>
) : null}
</span>
</Link>
</li>
);
})}
</ul>
)}
</section>
);
})
)}
</div>
);
}
function vorMonaten(datum: string, monate: number): string {
const d = new Date(`${datum}T12:00:00Z`);
d.setUTCMonth(d.getUTCMonth() - monate);
return d.toISOString().slice(0, 10);
}
function zahl(wert: number): string {
return wert.toString().replace('.', ',');
}