Neue Bildungspläne wachsen je Fach klassenstufenweise hoch, sodass Kurse abhängig vom Einschulungsjahr entweder dem alten oder dem neuen Bildungsplan folgen. CompetencyCatalogVersion (Fach + Name + IsDefault) macht das abbildbar: CompetencyDomain bekommt eine VersionId, Kurse wählen über LearningGroup.CompetencyCatalogVersionId (null = Standardversion des Fachs) welche Version gilt. Migration legt für bestehende Kataloge automatisch eine Standardversion an, damit alte Datenbanken unverändert weiterlaufen. MCP: neue Tools für Versions-CRUD (get/create/update/delete_competency_plan_version, update_group_competency_version), get_competency_catalog/create_competency_domain um optionalen versionId-Parameter erweitert. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
54 lines
3.5 KiB
C#
54 lines
3.5 KiB
C#
using System.ComponentModel;
|
|
using System.Text;
|
|
using LehrerApp.Core.Interfaces;
|
|
|
|
namespace LehrerApp.Desktop.Services.Mcp.Tools;
|
|
|
|
/// <summary>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".</summary>
|
|
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<GroupDto> 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<WriteResultDto> 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.");
|
|
}
|
|
}
|