adminandClaude Sonnet 5
2c791258a1
CI / build-and-test (push) Canceled after 0s
Nutzer-Feedback aus echtem Live-Test der neuen Untis-MCP-Tools: groupId ist ueberall Pflichtparameter (get_grades, get_schedule, get_lesson_plans, get_untis_absence_rows, ...), war aber nirgends ueber MCP auflösbar - ein KI-Client kannte bestenfalls den Klarnamen einer Lerngruppe, nie ihre Id. - Neues GroupTools.cs mit get_groups (Read): listet Lerngruppen mit Id/Name/Typ/Schuljahr/ Klassenstufe/SubjectId/IsActive, optional nach Schuljahr gefiltert. - UntisHubStatusRowDto liefert zusaetzlich GroupId mit (null bei den drei dashboard-weiten Zeilen), damit fuer eine dort gelistete Gruppe nicht zusaetzlich get_groups noetig ist. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
109 lines
6.2 KiB
C#
109 lines
6.2 KiB
C#
using LehrerApp.Core.Models;
|
|
|
|
namespace LehrerApp.Desktop.Services.Mcp.Tools;
|
|
|
|
// Schlanke, bewusst nicht 1:1 zu den LiteDB-Entities gehaltene Rückgabetypen: verhindert, dass ein
|
|
// später zum Modell hinzugefügtes Feld (z.B. ein neues personenbezogenes Attribut) unbeabsichtigt
|
|
// über ein MCP-Tool nach außen dringt, nur weil es Teil der Entity-Klasse ist.
|
|
|
|
public record StudentDto(Guid Id, string FirstName, string LastName, bool IsActive);
|
|
|
|
public record ExamResultDto(Guid StudentId, double TotalPoints, string? Grade, bool Absent);
|
|
|
|
public record ExamDto(
|
|
Guid Id, Guid GroupId, string Title, DateOnly Date, ExamStatus Status, Niveau? Niveau,
|
|
List<ExamResultDto>? Results);
|
|
|
|
public record GradeDto(
|
|
Guid Id, Guid StudentId, Guid GroupId, GradeCategory Category, string Value, DateOnly Date,
|
|
double Weight, string? Note);
|
|
|
|
public record TimetableSlotDto(Guid Id, Guid GroupId, DayOfWeek Weekday, int PeriodNumber, string? Room);
|
|
|
|
public record TimeEntryDto(
|
|
Guid Id, Guid? TaskId, string Category, Guid? GroupId, DateOnly Date,
|
|
TimeOnly? StartTime, TimeOnly? EndTime, int DurationMinutes, string? Description);
|
|
|
|
public record LessonPhaseDto(Guid Id, string Name, int DurationMinutes, string Activity, string Material, string Shorthand);
|
|
|
|
public record LessonAttachmentDto(string StorageId, string FileName, long SizeBytes);
|
|
|
|
public record LessonDto(
|
|
Guid Id, Guid UnitId, Guid GroupId, DateOnly Date, int? LessonNumber, string Topic,
|
|
string? Homework, LessonStatus Status, List<string> Competencies, List<LessonPhaseDto> Phases,
|
|
List<LessonAttachmentDto> Attachments);
|
|
|
|
/// <summary>Ergebnis von "download_lesson_attachment": Inhalt Base64-kodiert, weil MCP-Tool-Antworten
|
|
/// als JSON/Text übertragen werden. Bewusst kein Ressourcen-URI-Mechanismus (siehe Planungsdokument) -
|
|
/// dafür müsste der Server MCP-Resources anbieten, was über den Rahmen dieses Tools hinausgeht;
|
|
/// stattdessen deckelt <see cref="LessonPlanTools.MaxInlineAttachmentBytes"/> die Größe.</summary>
|
|
public record AttachmentContentDto(string FileName, long SizeBytes, string Base64Content);
|
|
|
|
public record UnitDto(
|
|
Guid Id, Guid GroupId, string Title, DateOnly? StartDate, DateOnly? EndDate,
|
|
UnitStatus Status, List<string> Competencies);
|
|
|
|
public record LessonPlanResultDto(List<UnitDto> Units, List<LessonDto> Lessons);
|
|
|
|
public record SubjectDto(Guid Id, string Name, string ShortName);
|
|
|
|
public record CompetencyItemDto(Guid Id, string Code, string Description, int SortOrder);
|
|
|
|
public record CompetencyDomainDto(
|
|
Guid Id, Guid SubjectId, int GradeLevel, string Name, string Code, int SortOrder,
|
|
List<CompetencyItemDto> Items);
|
|
|
|
public record GroupMembershipDto(
|
|
Guid Id, Guid StudentId, Guid GroupId, MembershipPeriod Period,
|
|
DateOnly? JoinedAt, DateOnly? LeftAt, Niveau? Niveau);
|
|
|
|
/// <summary>Ergebnis eines Write-Tools (Phase 2, siehe Planungsdokument): <see cref="Applied"/> ist
|
|
/// nur dann true, wenn der Nutzer die Änderung im Bestätigungsdialog angenommen hat.</summary>
|
|
public record WriteResultDto(bool Applied, Guid? Id, string Message);
|
|
|
|
public record PlaceholderInfoDto(string Name, string Type, bool Required, bool IsConstant);
|
|
|
|
/// <summary>"Worksheets" aus der ursprünglichen Spec entsprechen im tatsächlichen Datenmodell den
|
|
/// importierten Elternbrief-Vorlagen (<c>.lavorlage</c>, <c>LehrerApp.Templating</c>) — es gibt kein
|
|
/// separates "Arbeitsblatt"-Konzept mit Fach/Klassenstufe-Metadaten. Siehe LetterTemplateTools.</summary>
|
|
public record LetterTemplateDto(string Id, string Name, string Description, List<PlaceholderInfoDto> Placeholders);
|
|
|
|
public record LetterRenderResultDto(bool Success, string Message, string? Base64Pdf, string? SuggestedFileName);
|
|
|
|
/// <summary>Eine Zeile des Untis-Hub (siehe UntisHubService) - "Kind"/"DueState" als Text statt
|
|
/// Enum-Wert, damit ein KI-Client sie ohne Kenntnis des internen Enums lesen kann. GroupId ist bei
|
|
/// den drei dashboard-weiten Zeilen (offene Stunden, Klassenbuch-/Hausaufgabenabgleich) null - siehe
|
|
/// UntisHubJobRow. Enthalten, damit ein KI-Client die Id nicht erst über get_groups nachschlagen
|
|
/// muss, um get_untis_absence_rows/get_named_untis_absence_pattern für eine hier gelistete Gruppe
|
|
/// aufzurufen (Nutzer-Feedback: die GroupId war nirgends exponiert).</summary>
|
|
public record UntisHubStatusRowDto(
|
|
string Kind, Guid? GroupId, string GroupName, string DueState, string DueLabel,
|
|
DateTime? LastRunAt, string? LastResultSummary);
|
|
|
|
/// <summary>Lerngruppe (Klasse oder Kurs) - siehe GroupTools.GetGroups. Bewusst kein Verweis auf
|
|
/// SubjectId->Name aufgelöst (dafür get_subjects), um nicht bei jeder Gruppe implizit einen ganzen
|
|
/// Fach-Datensatz mitzuschleppen.</summary>
|
|
public record GroupDto(
|
|
Guid Id, string Name, GroupType Type, string SchoolYear, int GradeLevel,
|
|
Guid? SubjectId, bool IsActive);
|
|
|
|
/// <summary>Anonymisierte Fehlzeiten-Diskrepanz (siehe UntisComparisonTools.GetUntisAbsenceRows):
|
|
/// bewusst KEIN Schülername/keine Klasse - <see cref="RowId"/> ist die einzige Kennung, über die
|
|
/// UntisComparisonTools.ApplyUntisAbsenceStatus später zurückordnet.</summary>
|
|
public record UntisAbsenceRowDto(
|
|
string RowId, DateOnly Date, string ReasonText, int AbsentMinutes, bool HandledOn,
|
|
bool? ExternKeyInParentheses, string CurrentLocalStatus, string CurrentGuessStatus);
|
|
|
|
/// <summary>Eine Zeile aus dem namentlichen Ausnahmeweg (get_named_untis_absence_pattern) - im
|
|
/// Unterschied zu <see cref="UntisAbsenceRowDto"/> bewusst MIT Schülername, da genau diese
|
|
/// Zusammenführung von Name und Fehlzeitendaten der Zweck des Aufrufs ist (z.B. Fehlmuster-Vergleich
|
|
/// zwischen zwei Schülern) und der Nutzer sie je Anfrage einzeln freigegeben hat.</summary>
|
|
public record NamedUntisAbsenceRowDto(
|
|
Guid StudentId, string StudentFullName, DateOnly Date, string ReasonText,
|
|
string CurrentLocalStatus, string CurrentGuessStatus);
|
|
|
|
/// <summary><see cref="Granted"/> ist false bei Ablehnung/Timeout oder wenn keine der angegebenen
|
|
/// Schüler-IDs bekannt war - <see cref="Rows"/> ist dann null, nicht nur leer, damit ein KI-Client
|
|
/// "abgelehnt" nicht mit "keine Fehlzeiten gefunden" verwechselt.</summary>
|
|
public record NamedUntisAbsenceResultDto(bool Granted, string Message, List<NamedUntisAbsenceRowDto>? Rows);
|