CI / build-and-test (push) Canceled after 0s
Dashboard warnings (attendance, homework, lateness) get a "Details" flyout with key figures, a list of dates and the compact month calendar from the class teacher overview, now extracted as a shared control. The calendar now aligns days under their weekday (Mo-So header, blank leading cells). Creating Vorgänge and documentation is supported by quick blocks with the current figures, dated standard phrases (e.g. "Klassenleitung informiert") and documentation templates (status snapshot, conversation, informing the class/subject teachers, parent call, parent letter). The class teacher Vorgänge tab uses WebUntis figures (absences across all subjects, class register) for the same blocks and templates. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
106 lines
6.8 KiB
C#
106 lines
6.8 KiB
C#
using System.Text;
|
||
using LehrerApp.Core.Models;
|
||
using LehrerApp.Desktop.ViewModels.Students;
|
||
|
||
namespace LehrerApp.Desktop.ViewModels.ClassTeacher;
|
||
|
||
/// <summary>
|
||
/// WebUntis-Stand einer/eines Schüler*in der eigenen Klasse für Schnellbausteine und Vorlagen im
|
||
/// Klassenlehrer-"Vorgänge"-Tab — Gegenstück zu StudentWarningEvidence im Schülerdetail. Dort zählen
|
||
/// nur die lokal erfassten Mitarbeits-Einträge der eigenen Stunden; die Klassenleitung braucht
|
||
/// dagegen die Fehlzeiten über alle Fächer und die Klassenbucheinträge der Kolleg*innen, die
|
||
/// WebUntis ohnehin liefert (und <see cref="Services.UntisReportCacheService"/> für das laufende
|
||
/// Schuljahr bereits gecacht hat). Rein aus schon geladenen Zeilen berechnet, testbar ohne Untis.
|
||
/// </summary>
|
||
/// <param name="NaturalName">"Vorname Nachname" aus dem lokalen Schülerdatensatz — der Untis-Anzeigename
|
||
/// hat je nach Schule eine andere Reihenfolge und taugt nicht für eine Briefanrede.</param>
|
||
public sealed record ClassTeacherStudentFacts(StudentOption Student, string NaturalName, string SchoolYear, DateOnly AsOf,
|
||
IReadOnlyList<ClassAbsenceDaySummaryRow> AbsenceDays, IReadOnlyList<ClassAbsenceDaySummaryRow> LateDays,
|
||
IReadOnlyList<ClassTeacherClassRegisterRow> RegisterEntries)
|
||
{
|
||
public const int MaxListed = 15;
|
||
|
||
public int AbsentPeriods => AbsenceDays.Sum(d => d.TotalAbsentPeriods);
|
||
public int FullDays => AbsenceDays.Count(d => d.CountsAsFullDay);
|
||
public int UnexcusedDays => AbsenceDays.Count(d => d.IsUnexcused);
|
||
public int NegativeRegisterCount => RegisterEntries.Count(r => r.IsDangerStatus);
|
||
public IReadOnlyList<ClassTeacherClassRegisterRow> HomeworkEntries => RegisterEntries
|
||
.Where(r => ($"{r.CategoryName} {r.Text}").Contains("Hausauf", StringComparison.OrdinalIgnoreCase)).ToList();
|
||
|
||
private string Stand => $"WebUntis-Stand {AsOf:dd.MM.yyyy}";
|
||
|
||
public string AbsenceShort =>
|
||
$"{AbsentPeriods} Fehlstunde{(AbsentPeriods == 1 ? "" : "n")} an {AbsenceDays.Count} Tag{(AbsenceDays.Count == 1 ? "" : "en")} " +
|
||
$"im Schuljahr {SchoolYear} (davon {UnexcusedDays} Tag{(UnexcusedDays == 1 ? "" : "e")} unentschuldigt, " +
|
||
$"{FullDays} ganze Fehltag{(FullDays == 1 ? "" : "e")})";
|
||
public string LatenessShort => $"{LateDays.Count} Verspätung{(LateDays.Count == 1 ? "" : "en")} im Schuljahr {SchoolYear}";
|
||
public string RegisterShort =>
|
||
$"{RegisterEntries.Count} Klassenbucheintr{(RegisterEntries.Count == 1 ? "ag" : "äge")} im Schuljahr {SchoolYear}, davon {NegativeRegisterCount} negativ";
|
||
public string HomeworkShort => $"{HomeworkEntries.Count} Klassenbucheintr{(HomeworkEntries.Count == 1 ? "ag" : "äge")} zu Hausaufgaben im Schuljahr {SchoolYear}";
|
||
|
||
public string AbsenceBlock => $"{Stand}: {AbsenceShort}.\n" + List("Fehltage", AbsenceDays.Select(d =>
|
||
$"{d.DateLabel}: {d.KindLabel} · {d.FriendlyStatusLabel}" +
|
||
(string.IsNullOrWhiteSpace(d.DetailLabel) ? "" : $" · {d.DetailLabel}")).ToList());
|
||
public string LatenessBlock => $"{Stand}: {LatenessShort}.\n" + List("Termine", LateDays.Select(d =>
|
||
$"{d.DateLabel}: {d.KindLabel}").ToList());
|
||
public string RegisterBlock => $"{Stand}: {RegisterShort}.\n" + List("Einträge", RegisterEntries.Select(RegisterLine).ToList());
|
||
public string HomeworkBlock => $"{Stand}: {HomeworkShort}.\n" + List("Einträge", HomeworkEntries.Select(RegisterLine).ToList());
|
||
|
||
private static string RegisterLine(ClassTeacherClassRegisterRow r) =>
|
||
$"{r.DateLabel}" + (string.IsNullOrWhiteSpace(r.Subject) ? "" : $" · {r.Subject}") + ": " +
|
||
string.Join(" – ", new[] { r.CategoryName, r.Text }.Where(v => !string.IsNullOrWhiteSpace(v)));
|
||
|
||
private static string List(string header, IReadOnlyList<string> lines)
|
||
{
|
||
var sb = new StringBuilder($"{header}:");
|
||
foreach (var line in lines.Take(MaxListed)) sb.Append("\n- ").Append(line);
|
||
if (lines.Count > MaxListed) sb.Append($"\n- … und {lines.Count - MaxListed} weitere");
|
||
return sb.ToString();
|
||
}
|
||
|
||
/// Nur Bausteine mit Inhalt. Mit <paramref name="withName"/> (mehrere Beteiligte ausgewählt)
|
||
/// tragen Label und Text den Namen, sonst wäre unklar, wessen Zahlen gerade eingefügt werden.
|
||
public IEnumerable<VorgangQuickBlock> QuickBlocks(bool withName)
|
||
{
|
||
string L(string label) => withName ? $"{label} · {Student.Name}" : label;
|
||
string T(string text) => withName ? $"{Student.Name} – {text}" : text;
|
||
if (AbsenceDays.Count > 0) yield return new(L("Fehlzeiten"), T(AbsenceBlock));
|
||
if (LateDays.Count > 0) yield return new(L("Verspätungen"), T(LatenessBlock));
|
||
if (HomeworkEntries.Count > 0) yield return new(L("Hausaufgaben (Klassenbuch)"), T(HomeworkBlock));
|
||
if (RegisterEntries.Count > 0) yield return new(L("Klassenbucheinträge"), T(RegisterBlock));
|
||
}
|
||
|
||
/// Anlass-Zeilen passend zu den Vorgangs-Tags; ohne passendes Tag (z.B. "Konflikte") dienen die
|
||
/// negativen Klassenbucheinträge als Anlass, sofern vorhanden.
|
||
public VorgangTemplateContext TemplateContext(Vorgang vorgang)
|
||
{
|
||
var lines = new List<string>();
|
||
foreach (var tag in vorgang.Tags.Select(t => t.ToLowerInvariant()).Distinct())
|
||
{
|
||
if (tag == "absentismus" && AbsenceDays.Count > 0) lines.Add(AbsenceShort);
|
||
if (tag == "verspätungen" && LateDays.Count > 0) lines.Add(LatenessShort);
|
||
if (tag == "hausaufgaben" && HomeworkEntries.Count > 0) lines.Add(HomeworkShort);
|
||
}
|
||
if (lines.Count == 0 && NegativeRegisterCount > 0) lines.Add(RegisterShort);
|
||
|
||
return new VorgangTemplateContext(Student.Id, NaturalName, AsOf, lines,
|
||
new Dictionary<string, VorgangSnapshot>
|
||
{
|
||
[VorgangDocumentationTemplates.UntisAbsenceStatus] = new($"Fehlzeiten-Stand (WebUntis) {AsOf:dd.MM.yyyy}", AbsenceBlock),
|
||
[VorgangDocumentationTemplates.LatenessStatus] = new($"Verspätungs-Stand (WebUntis) {AsOf:dd.MM.yyyy}", LatenessBlock),
|
||
[VorgangDocumentationTemplates.ClassRegisterStatus] = new($"Klassenbuch-Stand {AsOf:dd.MM.yyyy}", RegisterBlock),
|
||
});
|
||
}
|
||
|
||
public static ClassTeacherStudentFacts Build(StudentOption student, string naturalName, string schoolYear, DateOnly asOf,
|
||
IReadOnlyList<ClassAbsenceDaySummaryRow> classAbsenceDays, IReadOnlyList<ClassTeacherClassRegisterRow> classRegister)
|
||
{
|
||
var own = classAbsenceDays.Where(a => UntisNameMatching.NamesMatch(a.StudentName, student.Name))
|
||
.OrderByDescending(a => a.Date).ToList();
|
||
var register = classRegister.Where(r => UntisNameMatching.NamesMatch(r.StudentName, student.Name))
|
||
.OrderByDescending(r => r.Date).ToList();
|
||
return new ClassTeacherStudentFacts(student, naturalName, schoolYear, asOf,
|
||
own.Where(a => !a.IsLate).ToList(), own.Where(a => a.IsLate).ToList(), register);
|
||
}
|
||
}
|