117 lines
7.4 KiB
C#
117 lines
7.4 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.CountsAsFullDay && d.IsUnexcused);
|
||
public int PartialAbsentPeriods => AbsenceDays.Where(d => !d.CountsAsFullDay).Sum(d => d.TotalAbsentPeriods);
|
||
public int UnexcusedPartialPeriods => AbsenceDays
|
||
.Where(d => !d.CountsAsFullDay && d.IsUnexcused).Sum(d => d.TotalAbsentPeriods);
|
||
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 =>
|
||
$"{FullDayLabel(FullDays)} und " +
|
||
$"{PartialAbsentPeriods} weitere Fehlstunde{(PartialAbsentPeriods == 1 ? "" : "n")} " +
|
||
$"an {AbsenceDays.Count} Tag{(AbsenceDays.Count == 1 ? "" : "en")} im Schuljahr {SchoolYear} " +
|
||
$"(unentschuldigt: {FullDayCountLabel(UnexcusedDays)}, " +
|
||
$"{UnexcusedPartialPeriods} Fehlstunde{(UnexcusedPartialPeriods == 1 ? "" : "n")})";
|
||
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("Fehlzeiten", 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 FullDayLabel(int count) =>
|
||
count == 1 ? "1 ganzer Fehltag" : $"{count} ganze Fehltage";
|
||
|
||
private static string FullDayCountLabel(int count) =>
|
||
count == 1 ? "1 ganzer Tag" : $"{count} ganze Tage";
|
||
|
||
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);
|
||
}
|
||
}
|