feat: MCP-Tools für Mitarbeit-Sitzungen (ParticipationTools)

Mitarbeit-Sitzungen waren bisher komplett MCP-unerreichbar. Neue ParticipationTools-Klasse
exponiert get_participation_sessions (Datum, Kommentar, zugeordnete Kompetenzen) sowie
add_session_competency/remove_session_competency, nach demselben Einzel-Zuordnung-Muster wie
LessonPlanTools. Bewusst ohne die einzelnen Schülerbewertungen (ParticipationEntry) - die bleiben
personenbezogen und MCP-unerreichbar.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
adminandClaude Sonnet 5 committed 2026-09-19 00:54:19 +02:00
1 parent 845cc5fc4c
commit 51e55e1464
7 files changed
+195 -6

No files matched your search

@@ -0,0 +1,72 @@
using System.ComponentModel;
using LehrerApp.Core.Interfaces;
using LehrerApp.Core.Models;
namespace LehrerApp.Desktop.Services.Mcp.Tools;
/// <summary>MCP-Tools für Mitarbeit-Sitzungen (<see cref="ParticipationSession"/>) - Nutzer-Nachtrag.
/// Bewusst nur die Sitzung selbst (Datum, Kommentar, Kompetenzzuordnung), NICHT die einzelnen
/// Schülerbewertungen (<see cref="ParticipationEntry"/>/<see cref="AspectRating"/>): das wären
/// personenbezogene Bewertungsdaten je Schüler, analog zu Documentation/Vorgang bewusst nicht über
/// MCP erreichbar (siehe McpToolScope). "add_session_competency"/"remove_session_competency" folgen
/// demselben Muster wie LessonPlanTools.AddLessonCompetency/RemoveLessonCompetency: einzelne
/// Kompetenz statt ganze Liste ersetzen, um kein "letzter Schreiber gewinnt" zu riskieren, und mit
/// Katalog-Validierung der übergebenen itemId.</summary>
public class ParticipationTools(
IParticipationSessionRepository sessions, ICompetencyDomainRepository competencyDomains,
IMcpConfirmationService confirmation)
{
[Description("Listet Mitarbeit-Sitzungen einer Lerngruppe (Datum, Kommentar, zugeordnete Kompetenzen) - ohne die einzelnen Schülerbewertungen.")]
public List<ParticipationSessionDto> GetParticipationSessions(
[Description("Lerngruppen-ID, aus get_groups.")] Guid groupId) =>
sessions.GetByGroup(groupId).Select(ToDto).ToList();
[Description("Ordnet einer Mitarbeit-Sitzung eine Kompetenz aus dem Katalog zu (siehe get_competency_catalog). Muss der Nutzer erst bestätigen.")]
public async Task<WriteResultDto> AddSessionCompetency(
[Description("ID der Mitarbeit-Sitzung, aus get_participation_sessions.")] Guid sessionId,
[Description("ID der Einzelkompetenz, aus get_competency_catalog.")] Guid itemId,
CancellationToken ct = default)
{
var session = sessions.GetById(sessionId);
if (session is null) return new WriteResultDto(false, null, "Unbekannte Sitzungs-ID.");
var item = FindCompetencyItem(itemId);
if (item is null) return new WriteResultDto(false, null, "Unbekannte Kompetenz-ID.");
if (session.Competencies.Any(c => c.ItemId == itemId))
return new WriteResultDto(true, session.Id, "Kompetenz ist bereits zugeordnet.");
var message = $"Kompetenz „{item.Code}“ zur Mitarbeit-Sitzung vom {session.Date:dd.MM.yyyy} hinzufügen?";
if (!await confirmation.ConfirmAsync("Kompetenz zuordnen?", message, ct))
return new WriteResultDto(false, null, "Vom Nutzer abgelehnt oder nicht bestätigt.");
session.Competencies.Add(new CompetencyReference { ItemId = item.Id, Code = item.Code, Description = item.Description });
sessions.Save(session);
return new WriteResultDto(true, session.Id, "Kompetenz zugeordnet.");
}
[Description("Entfernt eine Kompetenz von einer Mitarbeit-Sitzung. Muss der Nutzer erst bestätigen.")]
public async Task<WriteResultDto> RemoveSessionCompetency(
[Description("ID der Mitarbeit-Sitzung.")] Guid sessionId,
[Description("ID der Einzelkompetenz, wie in get_participation_sessions hinterlegt.")] Guid itemId,
CancellationToken ct = default)
{
var session = sessions.GetById(sessionId);
if (session is null) return new WriteResultDto(false, null, "Unbekannte Sitzungs-ID.");
var existing = session.Competencies.FirstOrDefault(c => c.ItemId == itemId);
if (existing is null) return new WriteResultDto(false, null, "Diese Kompetenz ist dieser Sitzung nicht zugeordnet.");
var message = $"Kompetenz „{existing.Code}“ von der Mitarbeit-Sitzung vom {session.Date:dd.MM.yyyy} entfernen?";
if (!await confirmation.ConfirmAsync("Kompetenz entfernen?", message, ct))
return new WriteResultDto(false, null, "Vom Nutzer abgelehnt oder nicht bestätigt.");
session.Competencies.Remove(existing);
sessions.Save(session);
return new WriteResultDto(true, session.Id, "Kompetenz entfernt.");
}
private CompetencyItem? FindCompetencyItem(Guid itemId) =>
competencyDomains.GetAll().SelectMany(d => d.Items).FirstOrDefault(i => i.Id == itemId);
private static ParticipationSessionDto ToDto(ParticipationSession s) => new(
s.Id, s.GroupId, s.Date, s.LessonId, s.Comment,
s.Competencies.Select(c => new CompetencyReferenceDto(c.ItemId, c.Code, c.Description)).ToList());
}