Zum Hauptinhalt springen

Akademie & Skill-Niveau-Progression — Architektur-Design (OP-R1-3)

Status: in Umsetzung — Architektur festgezurrt (#188) · Slice 1 ✅ (#189, v0.3.0) · Slice 2 ✅ (#190, v0.4.0: begründungspflichtige Beförderung [setSkillNiveau mit Pflicht-Grund] + append-only Beförderungs-/Audit-Historie + Anzeige auf der MA-Karte) · offen: Slice 3 (verwerfen/vertagen-Aktionen + Übersichts-Liste). Auslöser: Nutzer-Wunsch 06-25 (§2). Verbindlicher Entwurf; Abweichungen beim Bau hier nachziehen. · Bezug: OP-R1-3 (Owning) · erweitert OP-R1-2 (XP/Erfahrung + Niveau-Vorschläge, server/src/operativ/leistung.ts) · OP-AUDIT-1 · OP-AUTH-1 · OP-COMPLIANCE-1 · G-1 · Zielgruppe: IT-Dev/Architektur · True North: indirekt — genauere, vertrauenswürdigere Eignungsdaten → bessere Taktung (Auslastung · freie Kapazität); beantwortet keine Leitfrage selbst

Kernaussage. Mitarbeiter wachsen entlang eines Skill-Niveau-Modells (XP + begründungspflichtige Beförderung mit append-only Audit-Historie). Das gibt dem Scheduler genauere Eignung (bessere Taktung — True North 1/3) und bereitet niveau-gezielte Ausbildungsziele/Zertifizierung vor. Erweitert OP-R1-2.

1. Zweck & Abgrenzung​

Das Skill-Niveau (★1–3) ist heute schon ein hartes Planungs-Gate: ein Teilschritt wird nur von Mitarbeitenden mit Skill-Niveau ≥ gefordertem Niveau und Vertrauensstufe ≥ Güteklasse bearbeitet (identisch in TS-Scheduler schedule.ts und CP-SAT model.py, via vorab aufgelöste eligible). OP-R1-3 macht die Progression dieses Niveaus nachvollziehbar, gesteuert und audit-/zertifizierungsfähig.

  • True North: genauere, vertrauenswürdigere Eignungsdaten → bessere Taktung (Frage 1/Kapazität); sichtbares Kompetenz-Wachstum.
  • Abgrenzung: OP-R1-2 liefert die Fakten (Leistungsnachweise) + die abgeleitete XP/Statistik; OP-R1-3 ergänzt Ziel-Niveau, XP-Schwellen, begründete Beförderung, Todo. Heute schlägt niveauVorschlaege rein heuristisch vor (Anzahl/Nacharbeit/Bewertung) und befördert nichts.

2. Anforderungen (Nutzer 06-25)​

  1. Ausbildungsziele zielen auf eine bestimmte Stern-Stufe (z. B. „Keramik ★★"), nicht nur auf einen Skill.
  2. Nur noch nicht erreichte Lernziele anbieten (aktuelles Niveau < Ziel-Niveau).
  3. Jede Stern-Stufe erfordert eine gewisse XP (Erfahrung).
  4. Beförderung (Stufe vergeben) ist begründungspflichtig — z. B. externer Lehrgang, Manager-Entscheidung, XP-basiert; generell ist jede Niveau-Erhöhung zu begründen.
  5. Gesammelte XP als „beförderungsreif"-Todo — auf der MA-Karte und in der Übersicht.
  6. Offene Frage: anstehende Beförderungen auch als „zählt nicht" / „weitere XP erforderlich" behandelbar? → §5 (Vorschlag).

3. Datenmodell — Fakten (gespeichert) vs. abgeleitet (D-2)​

  • Ausbildungsziele niveau-gezielt: Mitarbeiter.ausbildungsZiele von string[] (Skill-IDs) auf { skillId, zielNiveau: SkillNiveau }[] heben (schemaVersion-Migration; Alt-Einträge → zielNiveau = aktuelles+1 oder 2). Angeboten/aktiv nur, solange MitarbeiterSkill.niveau < zielNiveau.
  • XP-Schwellen je Niveau (neu, Stammdaten): xpSchwellen (z. B. { '2': X, '3': Y }), admin-editierbar (G-1), optional je Skill überschreibbar. Single Source im DO-Blob (wandert mit OP-DATA-1).
  • Beförderungs-Historie (neu, append-only): je Niveau-Änderung ein unveränderlicher Eintrag { mitarbeiterId, skillId, vonNiveau, aufNiveau, grundKategorie, grundText?, akteurId, ts } — Muster wie die Abwesenheits-Historie (#183). Das aktuelle MitarbeiterSkill.niveau bleibt gespeicherter Zustand (von der Beförderung gesetzt); die Historie ist der Nachweis (= OP-AUDIT-1-Event).
  • Abgeleitet (D-2, nie gespeichert): XP je (Mitarbeiter × Skill) und der „beförderungsreif"-Status.

4. XP je Skill & Schwellen (Berechnung, abgeleitet)​

  • XP je Skill = erfahrungspunkte (OP-R1-2) gefiltert auf die Leistungsnachweise dieses Skills — gleiche Gewichtung: produktiv 10 / Helfer 5×lernanteil, „im Plan"-Bonus, güteklassen-Faktor (schwerere Fahrzeuge zählen mehr), minus Nacharbeit-Malus je Schwere. Heute ist erfahrungspunkte global je MA → für OP-R1-3 je Skill auswerten (gleiche pure Funktion, Filter auf skillId).
  • „beförderungsreif" auf Niveau N+1 ⟺ XP(skill) ≥ xpSchwelle(N+1). Entscheidung (Vorschlag): XP-Schwelle als primäres Gate, kombiniert mit den bestehenden Qualitäts-Gates aus niveauVorschlaege (Nacharbeit-Quote ≤ 15 %, Ø-Bewertung ≥ 80) — verfeinert die heutige reine Heuristik, statt sie zu ersetzen.
  • Alles abgeleitet (D-2): „beförderungsreif" wird nie gespeichert, sondern live aus XP ≥ Schwelle berechnet.

5. Beförderungs-Flow (manuell · begründet · auditiert) — Antwort auf die offene Frage​

  • Propose-not-execute: XP macht nur vorschlagsreif — es befördert nie automatisch.
  • „beförderungsreif"-Todo → drei Manager-Aktionen (= Auflösung der offenen Frage, Vorschlag):
    • Bestätigen → Niveau hoch; Pflicht-Begründung (Kategorie xp_basiert / externer_lehrgang / manager + optional Freitext, z. B. „Lehrgang Keramik-Profi"). → Beförderungs-/Audit-Eintrag.
    • Vertagen („weitere XP") → Vorschlag schlummert, XP sammelt weiter; optional individuell höhere Schwelle. XP wird NICHT genullt (XP = Fakt, D-2). → Audit-Eintrag (vertagt).
    • Verwerfen („zählt nicht") → Vorschlag verworfen mit Notiz (z. B. „XP aus zu leichten Aufträgen"). → Audit-Eintrag (verworfen).
  • Generell: jede Niveau-Erhöhung ist begründungspflichtig — auch eine direkte Manager-Vergabe ohne XP (reiner externer Lehrgang/Prüfung): Begründung = der Lehrgang, XP nicht erforderlich.

6. Sichtbarkeit & Rollen​

  • MA-Karte: je Skill der Fortschritt zum nächsten Stern („★★ reif" bzw. „N/M XP bis ★★") + die „beförderungsreif"-Markierung.
  • Übersicht: Liste aller anstehenden Beförderungen (Manager-Sicht) — ein True-North-naher „wer ist bereit"-Blick.
  • Rolle: Beförderung = Manager-Recht (hängt an OP-AUTH-1; interim server-seitiges Admin-Flag). Jede Vergabe/Vertagung/Verwerfung als OP-AUDIT-1-Event.

7. Akademie & Zertifizierungen (Vision — bereitet OP-R1-3 vor)​

  • Eine Stern-Stufe = interne Zertifizierung; die Begründung (externer Lehrgang/Prüfung) ist der Zertifikats-Nachweis. Die Beförderungs-Historie (OP-AUDIT-1) = lückenlose, nicht reverse-engineerbare Zertifizierungs-Historie → direkter Beleg für OP-COMPLIANCE-1 (ISO 27001 Kompetenz-/Schulungsnachweise).
  • Künftig (evtl. eigenes OP-ACADEMY-1): Lern-/Kurskatalog, externe Zertifikate mit Ablauf-/Rezertifizierungs-Datum, Skill-Matrix-Report, Pflicht-Schulungen je Gewerk.

8. Build-Slices (Vorschlag)​

  1. Slice 1 — Ziele & XP-Reife (baubar): ausbildungsZiele niveau-gezielt ({skillId, zielNiveau}) + „nur nicht erreichte" + XP-Schwellen-Stammdaten (G-1) + per-Skill-XP- Ableitung + „beförderungsreif"-Todo auf der MA-Karte. Pure Funktion + Self-Test (test:progression).
  2. Slice 2 — Begründete Beförderung + Audit + Manager-Aktionen: Pflicht-Begründung, Beförderungs-Historie als OP-AUDIT-1-Event, die drei Aktionen (bestätigen/vertagen/verwerfen) + Übersichts-Liste.
  3. Slice 3 — Akademie (OP-ACADEMY-1): Kurs-/Zertifikatskatalog, externe Zerts + Rezertifizierung, Skill-Matrix-Report.

9. Offene Punkte​

  • XP-Schwellen-Werte je Niveau (Default) + ob je Skill überschreibbar.
  • XP-Schwelle UND Qualitäts-Gate (kombiniert, §4) vs. nur XP — final beim Bau.
  • „Vertagen" = individuelle Schwellen-Anhebung oder reines Snooze (Default: Snooze + optionale Anhebung).
  • Migrationspfad der Alt-ausbildungsZiele (string[] → Ziel-Niveau-Default).

10. Bezüge​

OP-R1-2 (XP/Niveau-Basis, leistung.ts) · OP-AUDIT-1 (Beförderungs-/Zertifizierungs-Historie) · OP-AUTH-1 (Manager-Recht/Rollen) · OP-R3-3 (Skill-Anforderung je Teilschritt) · Güteklasse/Vertrauensstufe-Gate (höheres Niveau schaltet Premium-Arbeit frei) · OP-COMPLIANCE-1 (Schulungs-/Kompetenznachweis) · G-1 (editierbare Schwellen) · D-2 (XP/Reife abgeleitet) · True North (genauere Eignung → bessere Taktung).

↩ Zurück zur Doku-Landkarte · Lesepfade · Register (alle OPs)