feat: Kompetenzzuordnungen von Freitext-Code auf stabile CompetencyItem.Id umgestellt (TODO 16.5)

Unit/Lesson/ExamTask/ParticipationSession referenzierten Kompetenzen bisher per Freitext-Code,
case-insensitiv gegen den Katalog gematcht - fragil bei Umbenennungen und seit der
Bildungsplan-Versionierung nicht mehr eindeutig (zwei Versionen können denselben Code vergeben).
Neuer Werttyp CompetencyReference (ItemId + Code/Description-Momentaufnahme) löst das: solange die
Id noch im Katalog auflösbar ist, zählt die live Fassung (Rename wirkt sofort), sonst bleibt die
gespeicherte historische Fassung sichtbar statt spurlos zu verschwinden.

Migration (Schema-Version 6) löst bestehende Codes gegen den Katalog auf; die zuvor dreifach
duplizierte Kompetenz-Tag-UI ist jetzt in CompetencyTagGroupBuilder konsolidiert.
add_lesson_competency/remove_lesson_competency nehmen jetzt itemId statt code und validieren gegen
den Katalog (vorher ungeprüft).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
adminandClaude Sonnet 5 committed 2026-09-19 00:41:54 +02:00
1 parent f97edff2fe
commit dc2f58c4dc
28 files changed
+691 -202

No files matched your search

@@ -62,9 +62,16 @@ public sealed class PlanningExchangeService(IUnitRepository units, ILessonReposi
Title = document.Unit.Title.Trim(),
StartDate = document.Unit.StartDate,
EndDate = document.Unit.EndDate,
// Das Austauschformat überträgt bewusst nie interne DB-IDs ("jeder Import legt neue
// Objekte an", siehe Klassenkommentar) - jeder importierte Code wird deshalb als NICHT
// aufgelöste Referenz gespeichert (kein Matching gegen den Katalog der Zielinstallation,
// das wäre wieder dasselbe fragile Code-Matching, das TODO 16.5 vermeiden soll, nur
// installationsübergreifend). Die Tag-UI zeigt sie ehrlich als "Nicht mehr im Katalog";
// der Nutzer kann sie bei Bedarf manuell dem echten Katalogeintrag neu zuordnen.
Competencies = document.Unit.Competencies
.Where(c => !string.IsNullOrWhiteSpace(c)).Select(c => c.Trim())
.Distinct(StringComparer.OrdinalIgnoreCase).ToList(),
.Distinct(StringComparer.OrdinalIgnoreCase)
.Select(c => new CompetencyReference { ItemId = Guid.Empty, Code = c }).ToList(),
Status = document.Unit.Status,
Notes = Clean(document.Unit.Notes),
};
@@ -94,7 +101,7 @@ public sealed class PlanningExchangeService(IUnitRepository units, ILessonReposi
Title = unit.Title,
StartDate = unit.StartDate,
EndDate = unit.EndDate,
Competencies = [.. unit.Competencies],
Competencies = [.. unit.Competencies.Select(c => c.Code)],
Status = unit.Status,
Notes = unit.Notes,
Lessons = [.. unitLessons.Select(ToPayload)],