using System.Globalization;
using System.Text;
using LehrerApp.Core.Models;
using LehrerApp.Desktop.Services;
namespace LehrerApp.Desktop.ViewModels.Students;
/// Ein per Klick einfügbarer Textbaustein im Vorgang-Dialog (Nutzer-Feedback: Fehlquoten
/// etc. nicht von Hand abtippen müssen).
public sealed record VorgangQuickBlock(string Label, string Text);
///
/// Formuliert die Belege aus als deutschen Fließtext — für
/// Schnellbausteine im Vorgang-Dialog, die Vorbelegung eines aus einer Dashboard-Warnung heraus
/// angelegten Vorgangs und die Dokumentationsvorlagen ().
/// Jeder Block nennt das Stichtagsdatum, weil der Text eingefroren in Vorgang/Dokumentation landet,
/// während die Zahlen dahinter weiterlaufen.
///
public static class StudentEvidenceText
{
private static readonly CultureInfo De = new("de-DE");
/// Die Terminlisten sollen den Beleg stützen, nicht die Beschreibung fluten.
public const int MaxListedEvents = 15;
public static string AttendanceShort(StudentWarningEvidence e)
{
var b = e.Balance;
var absent = b.Excused + b.Unexcused + b.ExcusePending;
return $"Fehlquote {b.AbsenceRatePercent.ToString("0.#", De)} % im Schuljahr {e.SchoolYear} " +
$"({absent} von {b.TotalChecked} erfassten Stunden; entschuldigt {b.Excused}, " +
$"unentschuldigt {b.Unexcused}, Entschuldigung offen {b.ExcusePending})";
}
public static string HomeworkShort(StudentWarningEvidence e) =>
$"{e.MissingHomework.Count} nicht bzw. unvollständig erledigte Hausaufgabe{(e.MissingHomework.Count == 1 ? "" : "n")} im Schuljahr {e.SchoolYear}";
public static string LatenessShort(StudentWarningEvidence e) =>
$"{e.Lateness.Count} Verspätung{(e.Lateness.Count == 1 ? "" : "en")} im Schuljahr {e.SchoolYear}" +
(e.SignificantlyLateCount > 0 ? $" (davon {e.SignificantlyLateCount} erheblich)" : "");
public static string AttendanceBlock(StudentWarningEvidence e) =>
$"Stand {e.AsOf:dd.MM.yyyy}: {AttendanceShort(e)}.";
public static string AbsenceListBlock(StudentWarningEvidence e) => ListBlock("Fehltermine", e.Absences);
public static string HomeworkBlock(StudentWarningEvidence e) =>
$"Stand {e.AsOf:dd.MM.yyyy}: {HomeworkShort(e)}.\n" + ListBlock("Betroffene Termine", e.MissingHomework);
public static string LatenessBlock(StudentWarningEvidence e) =>
$"Stand {e.AsOf:dd.MM.yyyy}: {LatenessShort(e)}.\n" + ListBlock("Betroffene Termine", e.Lateness);
private static string ListBlock(string header, IReadOnlyList events)
{
var sb = new StringBuilder($"{header}:");
foreach (var ev in events.Take(MaxListedEvents)) sb.Append("\n- ").Append(ev.ListLine);
if (events.Count > MaxListedEvents) sb.Append($"\n- … und {events.Count - MaxListedEvents} weitere");
return sb.ToString();
}
/// Welcher Stand zu welchem Vorgangs-Schlagwort gehört — dieselben drei Tags, mit denen das
/// Dashboard seine Warnungen an Vorgänge knüpft (DashboardViewModel.AbsentismusTag usw.).
public static string? StatusBlockForTag(string tag, StudentWarningEvidence e) => tag.ToLowerInvariant() switch
{
"absentismus" => AttendanceBlock(e) + "\n" + AbsenceListBlock(e),
"hausaufgaben" => HomeworkBlock(e),
"verspätungen" => LatenessBlock(e),
_ => null,
};
/// Kurzfassungen für die Tags eines Vorgangs, z.B. als Anlass eines Gesprächs. Ohne passendes
/// Tag bleibt die Liste leer statt ungefragt alle Zahlen einzustreuen.
public static List ShortLinesForTags(IEnumerable tags, StudentWarningEvidence e)
{
var lines = new List();
foreach (var tag in tags.Select(t => t.ToLowerInvariant()).Distinct())
{
var line = tag switch
{
"absentismus" => AttendanceShort(e),
"hausaufgaben" => HomeworkShort(e),
"verspätungen" => LatenessShort(e),
_ => null,
};
if (line is not null) lines.Add(line);
}
return lines;
}
/// Schnellbausteine für den Vorgang-Dialog — nur solche mit tatsächlichem Inhalt, ein
/// "0 Verspätungen"-Baustein wäre nur Rauschen.
public static List QuickBlocks(StudentWarningEvidence e)
{
var blocks = new List();
if (e.Balance.TotalChecked > 0) blocks.Add(new("Fehlquote", AttendanceBlock(e)));
if (e.Absences.Count > 0) blocks.Add(new("Fehltermine", AbsenceListBlock(e)));
if (e.MissingHomework.Count > 0) blocks.Add(new("Hausaufgaben", HomeworkBlock(e)));
if (e.Lateness.Count > 0) blocks.Add(new("Verspätungen", LatenessBlock(e)));
return blocks;
}
/// Übersetzt die lokalen Mitarbeits-Belege in den neutralen Vorlagen-Kontext (die
/// Klassenlehreransicht baut ihren Kontext stattdessen aus WebUntis-Daten, siehe
/// ClassTeacherCaseFacts).
public static VorgangTemplateContext TemplateContext(Vorgang vorgang, StudentWarningEvidence e) => new(
e.StudentId, e.StudentNaturalName, e.AsOf, ShortLinesForTags(vorgang.Tags, e),
new Dictionary
{
[VorgangDocumentationTemplates.AttendanceStatus] = new($"Fehlzeiten-Stand {e.AsOf:dd.MM.yyyy}",
AttendanceBlock(e) + "\n\n" + AbsenceListBlock(e)),
[VorgangDocumentationTemplates.HomeworkStatus] = new($"Hausaufgaben-Stand {e.AsOf:dd.MM.yyyy}", HomeworkBlock(e)),
[VorgangDocumentationTemplates.LatenessStatus] = new($"Verspätungs-Stand {e.AsOf:dd.MM.yyyy}", LatenessBlock(e)),
});
}
/// Ein festhaltbarer Stand ("Fehlzeiten-Stand …") als fertiger Titel + Text.
public sealed record VorgangSnapshot(string Title, string Content);
/// Neutraler Zahlen-Kontext für — gespeist
/// entweder aus den lokalen Mitarbeits-Einträgen (Schülerdetail, )
/// oder aus WebUntis (Klassenlehrer-Vorgänge, siehe ClassTeacherCaseFacts). So bleiben die
/// Vorlagentexte an einer Stelle.
/// Kurzfassungen passend zu den Tags des Vorgangs (Anlass).
/// Je Vorlagen-Schlüssel ein festhaltbarer Stand.
public sealed record VorgangTemplateContext(Guid StudentId, string StudentNaturalName, DateOnly AsOf,
IReadOnlyList SituationLines, IReadOnlyDictionary Snapshots);
/// Standardformulierungen für den Vorgang-Dialog (Nutzer-Feedback: "den Klassenlehrer
/// informiert" u.ä. nicht jedes Mal tippen). Datumsgestempelt, weil sie als Verlaufsnotiz in der
/// Beschreibung landen. Getrennte Listen je Kontext: aus Sicht der Fachlehrkraft (Schülerdetail) wird
/// die Klassenleitung informiert, aus Sicht der Klassenleitung die Fachlehrkräfte.
public static class VorgangPhraseBlocks
{
public static IReadOnlyList ForStudent(DateOnly today) =>
[
new("Klassenleitung informiert", $"{today:dd.MM.yyyy}: Klassenleitung informiert."),
new("Eltern informiert", $"{today:dd.MM.yyyy}: Erziehungsberechtigte informiert."),
new("Gespräch geführt", $"{today:dd.MM.yyyy}: Gespräch mit der Schülerin/dem Schüler geführt."),
new("Vereinbarung getroffen", $"{today:dd.MM.yyyy}: Vereinbarung getroffen: "),
new("Weiter beobachten", $"{today:dd.MM.yyyy}: Weiter beobachten, Überprüfung am "),
];
public static IReadOnlyList ForClassTeacher(DateOnly today) =>
[
new("Fachlehrkräfte informiert", $"{today:dd.MM.yyyy}: Fachlehrkräfte der Klasse informiert."),
new("Eltern informiert", $"{today:dd.MM.yyyy}: Erziehungsberechtigte informiert."),
new("Gespräch geführt", $"{today:dd.MM.yyyy}: Gespräch mit der Schülerin/dem Schüler geführt."),
new("Attestpflicht angekündigt", $"{today:dd.MM.yyyy}: Attestpflicht angekündigt – Fehlzeiten gelten künftig nur mit ärztlichem Attest als entschuldigt."),
new("Schulsozialarbeit eingebunden", $"{today:dd.MM.yyyy}: Schulsozialarbeit/Beratung eingebunden."),
new("Schulleitung informiert", $"{today:dd.MM.yyyy}: Schulleitung informiert."),
new("Vereinbarung getroffen", $"{today:dd.MM.yyyy}: Vereinbarung getroffen: "),
new("Weiter beobachten", $"{today:dd.MM.yyyy}: Weiter beobachten, Überprüfung am "),
];
}
///
/// Standardisierte Dokumentationseinträge für einen Vorgang (Nutzer-Feedback: nicht jeden Eintrag
/// komplett von Hand anlegen). Erzeugt nur einen vorbefüllten, noch nicht gespeicherten Entwurf —
/// der landet anschließend im normalen Dokumentations-Dialog, gespeichert wird erst nach bewusster
/// Bestätigung dort.
///
public static class VorgangDocumentationTemplates
{
// Stand festhalten — lokal (Schülerdetail) …
public const string AttendanceStatus = "attendance";
public const string HomeworkStatus = "homework";
public const string LatenessStatus = "lateness";
// … bzw. aus WebUntis (Klassenlehrer-Vorgänge)
public const string UntisAbsenceStatus = "untisabsences";
public const string ClassRegisterStatus = "classregister";
public const string Conversation = "conversation";
public const string ParentCall = "parentcall";
public const string ParentLetter = "parentletter";
public const string InformClassTeacher = "informclassteacher";
public const string InformSubjectTeachers = "informsubjectteachers";
public static Documentation? Build(string key, Vorgang vorgang, StudentWarningEvidence e) =>
Build(key, vorgang, StudentEvidenceText.TemplateContext(vorgang, e));
public static Documentation? Build(string key, Vorgang vorgang, VorgangTemplateContext ctx)
{
var doc = new Documentation { StudentId = ctx.StudentId, Date = ctx.AsOf };
if (ctx.Snapshots.TryGetValue(key, out var snapshot))
{
doc.Type = DocumentationType.Incident;
doc.Title = snapshot.Title;
doc.Content = snapshot.Content;
doc.Tags = ["Beobachten"];
return doc;
}
switch (key)
{
case Conversation:
doc.Type = DocumentationType.Conversation;
doc.Title = $"Gespräch: {vorgang.Title}";
doc.Participants = [ctx.StudentNaturalName];
doc.Content = "Anlass:\n" + Occasion(vorgang, ctx) +
"\n\nSicht der Schülerin/des Schülers:\n\n\nVereinbarung:\n\n\nÜberprüfung am:\n";
return doc;
case InformClassTeacher:
case InformSubjectTeachers:
var who = key == InformClassTeacher ? "Klassenleitung" : "Fachlehrkräfte";
doc.Type = DocumentationType.Conversation;
doc.Title = $"{who} informiert: {vorgang.Title}";
doc.Participants = [who];
doc.Content = $"{who} am {ctx.AsOf:dd.MM.yyyy} informiert über:\n" + Occasion(vorgang, ctx) +
"\n\nWeg (persönlich / Nachricht / E-Mail):\n\n\nRückmeldung / Absprache:\n";
return doc;
case ParentCall:
doc.Type = DocumentationType.ParentCall;
doc.Title = $"Elternanruf: {vorgang.Title}";
var points = ctx.SituationLines.Select(l => $"Aktueller Stand: {l}").ToList();
if (points.Count == 0) points.Add($"Anlass schildern: {vorgang.Title}");
points.AddRange(["Sicht der Eltern / mögliche Gründe erfragen", "Unterstützung und Vereinbarung abstimmen",
"Nächsten Kontakt vereinbaren"]);
doc.ParentCallData = new ParentCallData
{ Points = points.Select(p => new ParentCallPoint { Text = p }).ToList() };
return doc;
case ParentLetter:
doc.Type = DocumentationType.ParentLetter;
doc.Title = $"Elternbrief: {vorgang.Title}";
doc.ParentLetterData = new ParentLetterData { DraftContent = LetterDraft(vorgang, ctx) };
return doc;
default:
return null;
}
}
private static string Occasion(Vorgang vorgang, VorgangTemplateContext ctx) =>
ctx.SituationLines.Count == 0 ? $"- {vorgang.Title}"
: string.Join("\n", ctx.SituationLines.Select(l => $"- {l} (Stand {ctx.AsOf:dd.MM.yyyy})"));
private static string LetterDraft(Vorgang vorgang, VorgangTemplateContext ctx)
{
var facts = ctx.SituationLines.Count == 0
? $"es gibt Anlass zur Sorge ({vorgang.Title})."
: $"mit Stand {ctx.AsOf:dd.MM.yyyy} ergibt sich folgendes Bild:\n" +
string.Join("\n", ctx.SituationLines.Select(l => $"- {l}"));
return $"Sehr geehrte Erziehungsberechtigte von {ctx.StudentNaturalName},\n\n" +
$"ich möchte Sie darüber informieren, dass {facts}\n\n" +
"Ich bitte Sie, mit Ihrem Kind darüber zu sprechen und sich bei Fragen mit mir in Verbindung zu setzen. " +
"Für ein gemeinsames Gespräch stehe ich gerne zur Verfügung.\n\n" +
"Mit freundlichen Grüßen";
}
}