using System.ComponentModel; using System.Text; using LehrerApp.Core.Interfaces; namespace LehrerApp.Desktop.Services.Mcp.Tools; /// MCP-Tools für Lerngruppen (Klassen/Kurse). "get_groups" (Nutzer-Nachtrag: die GroupId, /// die praktisch jedes andere Tool als Pflichtparameter verlangt - get_grades, get_schedule, /// get_lesson_plans, get_untis_absence_rows usw. - war nirgends über MCP auflösbar; ein KI-Client /// kannte bestenfalls den Klarnamen einer Lerngruppe aus dem Gespräch, nie ihre Id) ist reiner /// Lesezugriff. "update_group_competency_version" ist das erste Schreib-Tool auf einem /// LearningGroup-Feld selbst (Nutzer-Nachtrag zur Bildungsplan-Versionierung) - deshalb bewusst eng /// auf genau dieses eine Feld geschnitten statt eines allgemeinen "update_group". public class GroupTools(IGroupRepository groups, ICompetencyCatalogVersionRepository versions, IMcpConfirmationService confirmation) { [Description("Listet Lerngruppen (Klassen/Kurse) mit ihrer Id - Voraussetzung, um andere Tools (z.B. get_grades, get_schedule, get_untis_absence_rows) für eine bestimmte Gruppe aufzurufen, wenn nur ihr Name bekannt ist. Ohne schoolYear werden alle Schuljahre zurückgegeben.")] public List GetGroups( [Description("Optionales Schuljahr zum Filtern, Format \"2025/26\". Ohne Angabe alle Schuljahre.")] string? schoolYear = null, [Description("Auch inaktive/archivierte Gruppen einbeziehen.")] bool includeInactive = false) { var list = schoolYear is null ? groups.GetAll(includeInactive) : groups.GetBySchoolYear(schoolYear, includeInactive); return list.Select(g => new GroupDto(g.Id, g.Name, g.Type, g.SchoolYear, g.GradeLevel, g.SubjectId, g.IsActive, g.CompetencyCatalogVersionId)).ToList(); } [Description("Setzt oder löscht die Bildungsplan-Version eines Kurses/einer Klasse (welcher Kompetenzkatalog für diese Gruppe gilt). Muss der Nutzer erst bestätigen.")] public async Task UpdateGroupCompetencyVersion( [Description("Gruppen-ID, aus get_groups.")] Guid groupId, [Description("Bildungsplan-Version, aus get_competency_plan_versions. Weglassen: zurück auf die Standardversion des Fachs.")] Guid? versionId = null, CancellationToken ct = default) { var group = groups.GetById(groupId); if (group is null) return new WriteResultDto(false, null, "Unbekannte Gruppen-ID."); if (versionId is Guid vid && versions.GetById(vid) is null) return new WriteResultDto(false, null, "Unbekannte Versions-ID."); var oldName = group.CompetencyCatalogVersionId is Guid oldId ? versions.GetById(oldId)?.Name ?? "unbekannt" : "Standardversion"; var newName = versionId is Guid newId ? versions.GetById(newId)?.Name ?? "unbekannt" : "Standardversion"; if (oldName == newName && group.CompetencyCatalogVersionId == versionId) return new WriteResultDto(true, group.Id, "Keine Änderung nötig."); var message = new StringBuilder($"Bildungsplan-Version von „{group.Name}“ ändern:\n{oldName} → {newName}"); if (!await confirmation.ConfirmAsync("Bildungsplan-Version ändern?", message.ToString(), ct)) return new WriteResultDto(false, null, "Vom Nutzer abgelehnt oder nicht bestätigt."); group.CompetencyCatalogVersionId = versionId; groups.Save(group); return new WriteResultDto(true, group.Id, "Bildungsplan-Version gespeichert."); } }