Compare commits

...
2 Commits
Author SHA1 Message Date
adminandClaude Opus 5.5 9a84bbaa38 Gemeinsame Dokumentation für mehrere Beteiligte eines Vorgangs
CI / build-and-test (push) Canceled after 0s
Ein Dokumentationseintrag kann jetzt weitere Schüler*innen betreffen
(Documentation.AdditionalStudentIds, StudentId bleibt Hauptperson). Der
Eintrag existiert nur einmal, erscheint aber im Dokumentations-Tab jeder
beteiligten Person. Der Dokumentations-Dialog bietet in beiden
Vorgänge-Tabs "Betrifft außerdem" mit den Beteiligten des Vorgangs an.
Klassenlehrer-Listen, WebUntis-Abgleich, Löschfristen und
Referenzzählung berücksichtigen die weiteren Beteiligten.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 08:43:24 +02:00
admin e091b5c8de Stundenweise Fehlzeiten getrennt auswerten 2026-09-28 08:39:40 +02:00
25 changed files with 528 additions and 89 deletions

No files matched your search

+15
View File
@@ -3,7 +3,14 @@ namespace LehrerApp.Core.Models;
public class Documentation : IHasAttachments public class Documentation : IHasAttachments
{ {
public Guid Id { get; set; } = Guid.NewGuid(); public Guid Id { get; set; } = Guid.NewGuid();
/// <summary>Hauptperson des Eintrags (bei Gruppeneinträgen <see cref="Guid.Empty"/>).</summary>
public Guid StudentId { get; set; } public Guid StudentId { get; set; }
/// <summary>
/// Weitere betroffene Schüler*innen, z.B. bei einem Vorgang mit mehreren Beteiligten: der Eintrag
/// existiert nur einmal, erscheint aber bei jeder dieser Personen (siehe <see cref="Concerns"/>).
/// Enthält nie <see cref="StudentId"/> selbst.
/// </summary>
public List<Guid> AdditionalStudentIds { get; set; } = [];
public Guid? GroupId { get; set; } public Guid? GroupId { get; set; }
/// <summary>Unterrichtssitzung, in der die Beobachtung entstanden ist.</summary> /// <summary>Unterrichtssitzung, in der die Beobachtung entstanden ist.</summary>
public Guid? ParticipationSessionId { get; set; } public Guid? ParticipationSessionId { get; set; }
@@ -33,6 +40,14 @@ public class Documentation : IHasAttachments
// Löschen entfernt den Eintrag nicht hart, sondern markiert ihn nur (Nachvollziehbarkeit, 5.1.4). // Löschen entfernt den Eintrag nicht hart, sondern markiert ihn nur (Nachvollziehbarkeit, 5.1.4).
public bool IsDeleted { get; set; } public bool IsDeleted { get; set; }
public DateTime? DeletedAt { get; set; } public DateTime? DeletedAt { get; set; }
/// Ob der Eintrag diese Person betrifft — als Hauptperson oder als weitere Beteiligte.
public bool Concerns(Guid studentId) =>
studentId != Guid.Empty && (StudentId == studentId || AdditionalStudentIds.Contains(studentId));
/// Hauptperson (falls gesetzt) gefolgt von den weiteren Beteiligten.
public IEnumerable<Guid> InvolvedStudentIds() =>
(StudentId == Guid.Empty ? [] : new[] { StudentId }).Concat(AdditionalStudentIds);
} }
public class AbsenceData public class AbsenceData
{ {
+35
View File
@@ -1338,4 +1338,39 @@ public sealed class RepositoryTests
Assert.Null(repo.GetById(extra.Id)); Assert.Null(repo.GetById(extra.Id));
} }
[Fact]
public void DocumentationRepository_GetByStudent_FindetGemeinsamenEintragBeiAllenBeteiligten()
{
using var db = NewInMemoryContext();
var repo = new DocumentationRepository(db);
Guid anna = Guid.NewGuid(), ben = Guid.NewGuid(), cem = Guid.NewGuid();
var shared = new Documentation
{
StudentId = anna, AdditionalStudentIds = [ben], Title = "Konflikt", Type = DocumentationType.Incident,
};
repo.Save(shared);
Assert.Equal(shared.Id, Assert.Single(repo.GetByStudent(anna)).Id);
Assert.Equal(shared.Id, Assert.Single(repo.GetByStudent(ben)).Id);
Assert.Empty(repo.GetByStudent(cem));
Assert.Single(repo.GetByStudentAndType(ben, DocumentationType.Incident));
Assert.Empty(repo.GetByStudentAndType(ben, DocumentationType.Conversation));
}
[Fact]
public void StudentRepository_GetReferenceSummary_ZaehltAuchGemeinsameDokumentation()
{
using var db = NewInMemoryContext();
var students = new StudentRepository(db);
var ben = new Student { FirstName = "Ben", LastName = "Muster" };
students.Save(ben);
new DocumentationRepository(db).Save(new Documentation
{
StudentId = Guid.NewGuid(), AdditionalStudentIds = [ben.Id], Title = "Konflikt",
});
Assert.Equal(1, students.GetReferenceSummary(ben.Id).DocumentationEntries);
Assert.Throws<InvalidOperationException>(() => students.Delete(ben.Id));
}
} }
@@ -34,7 +34,7 @@ public class StudentRepository(LiteDbContext db) : IStudentRepository
db.Grades.Count(g => g.StudentId == studentId), db.Grades.Count(g => g.StudentId == studentId),
db.ReportGrades.Count(g => g.StudentId == studentId), db.ReportGrades.Count(g => g.StudentId == studentId),
db.ParticipationEntries.Count(e => e.StudentId == studentId), db.ParticipationEntries.Count(e => e.StudentId == studentId),
db.Documentation.Count(d => d.StudentId == studentId)); db.Documentation.FindAll().Count(d => d.Concerns(studentId)));
public void Save(Student s) public void Save(Student s)
{ {
s.ExternalIds ??= []; s.ExternalIds ??= [];
@@ -415,10 +415,13 @@ public class LessonRepository(LiteDbContext db) : ILessonRepository
public class DocumentationRepository(LiteDbContext db) : IDocumentationRepository public class DocumentationRepository(LiteDbContext db) : IDocumentationRepository
{ {
// Filter auf AdditionalStudentIds bewusst im Speicher statt als LiteDB-Ausdruck — die Menge
// an Dokumentation pro Lehrkraft ist klein, und so gilt exakt dieselbe Regel wie Documentation.Concerns.
public List<Documentation> GetByStudent(Guid id) => public List<Documentation> GetByStudent(Guid id) =>
db.Documentation.Find(d => d.StudentId == id && !d.IsDeleted).OrderByDescending(d => d.Date).ToList(); db.Documentation.Find(d => !d.IsDeleted).Where(d => d.Concerns(id))
.OrderByDescending(d => d.Date).ToList();
public List<Documentation> GetByStudentAndType(Guid sid, DocumentationType type) => public List<Documentation> GetByStudentAndType(Guid sid, DocumentationType type) =>
db.Documentation.Find(d => d.StudentId == sid && d.Type == type && !d.IsDeleted) db.Documentation.Find(d => d.Type == type && !d.IsDeleted).Where(d => d.Concerns(sid))
.OrderByDescending(d => d.Date).ToList(); .OrderByDescending(d => d.Date).ToList();
public List<Documentation> GetAll() => public List<Documentation> GetAll() =>
db.Documentation.Find(d => !d.IsDeleted).OrderByDescending(d => d.Date).ToList(); db.Documentation.Find(d => !d.IsDeleted).OrderByDescending(d => d.Date).ToList();
@@ -509,11 +509,14 @@ public sealed class ClassTeacherViewModelsTests
termStart: new DateOnly(2026, 8, 1))); termStart: new DateOnly(2026, 8, 1)));
Assert.True(row.HasYearSummary); Assert.True(row.HasYearSummary);
Assert.Equal(2, row.YearAbsenceDayCount); Assert.Equal(1, row.YearAbsenceDayCount);
Assert.Equal(1, row.YearUnexcusedDayCount); Assert.Equal(1, row.YearUnexcusedDayCount);
Assert.Equal(10, row.YearAbsenceRatePercent); Assert.Equal(2, row.YearAbsencePeriodCount);
Assert.Contains("10 %", row.YearSummaryLabel); Assert.Equal(2, row.YearExcusedPeriodCount);
Assert.Contains("2 von 20", row.YearSummaryTooltip); Assert.Equal(5, row.YearAbsenceRatePercent);
Assert.Contains("5 %", row.YearSummaryLabel);
Assert.Contains("1 von 20", row.YearSummaryTooltip);
Assert.Contains("2 Fehlstunden", row.YearSummaryTooltip);
Assert.Contains("seit 01.08.", row.YearSummaryTooltip); Assert.Contains("seit 01.08.", row.YearSummaryTooltip);
Assert.Contains("1 unentschuldigt", row.YearSummaryTooltip); Assert.Contains("1 unentschuldigt", row.YearSummaryTooltip);
} }
@@ -577,24 +580,30 @@ public sealed class ClassTeacherViewModelsTests
} }
[Fact] [Fact]
public void RosterBuild_UnentschuldigtUndVerspaetetZaehltAlsUnentschuldigtNichtAlsVerspaetung() public void RosterBuild_UnentschuldigteFehlstundeZaehltNichtAlsGanzerFehltag()
{ {
// Wer unentschuldigt UND verspätet ist, bleibt der schwerwiegendere Fall (dieselbe // Kernfall: Eine Schülerin fehlt aus Protest eine Unterrichtsstunde. Das bleibt
// Rangfolge wie AttentionRank/StatusKind/BuildTrend: Unentschuldigt vor Verspätet) — zählt // unentschuldigt und score-relevant, darf im Zeugnis-/Jahresstand aber nicht als ganzer
// deshalb weiter voll in die Quote statt in YearLateDayCount zu verschwinden. // unentschuldigter Fehltag erscheinen.
var students = new[] { Student(1001, "Ada Müller") }; var students = new[] { Student(1001, "Ada Müller") };
var yearAbsences = new[] var yearAbsences = new[]
{ {
new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 10), "Müller Ada", 1001, 0, 60, new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 10), "Müller Ada", 1001, 1, 45,
["Deu"], [1], ["nicht entsch."], ["Verspätung"], null, null, false), ["Deu"], [1], ["nicht entsch."], ["Absent"], "Aus Protest gegangen", null, false),
}; };
var row = Assert.Single(ClassTeacherRosterRow.Build(students, [], [], var row = Assert.Single(ClassTeacherRosterRow.Build(students, [], [],
new DateOnly(2026, 8, 26), yearAbsences, schoolDaysElapsed: 20, termStart: new DateOnly(2026, 8, 1))); new DateOnly(2026, 8, 26), yearAbsences, schoolDaysElapsed: 20, termStart: new DateOnly(2026, 8, 1)));
Assert.Equal(1, row.YearAbsenceDayCount); Assert.Equal(0, row.YearAbsenceDayCount);
Assert.Equal(1, row.YearUnexcusedDayCount); Assert.Equal(0, row.YearUnexcusedDayCount);
Assert.Equal(1, row.YearAbsencePeriodCount);
Assert.Equal(1, row.YearUnexcusedPeriodCount);
Assert.Equal(0, row.YearLateDayCount); Assert.Equal(0, row.YearLateDayCount);
Assert.Equal(0, row.YearAbsenceRatePercent);
Assert.Contains("1 Fehlstunde", row.YearSummaryLabel);
Assert.Contains("1 unentschuldigt", row.YearSummaryTooltip);
Assert.Equal(0.5, row.PatternScore, precision: 10); // 1 von typischerweise 6 Stunden × Tagesgewicht 3
} }
[Fact] [Fact]
@@ -754,7 +763,8 @@ public sealed class ClassTeacherViewModelsTests
var row = Assert.Single(ClassTeacherRosterRow.Build(students, [], [], new DateOnly(2026, 8, 26), var row = Assert.Single(ClassTeacherRosterRow.Build(students, [], [], new DateOnly(2026, 8, 26),
yearAbsences, schoolDaysElapsed: 10)); yearAbsences, schoolDaysElapsed: 10));
Assert.Equal(1, row.YearAbsenceDayCount); Assert.Equal(0, row.YearAbsenceDayCount);
Assert.Equal(2, row.YearAbsencePeriodCount);
} }
[Fact] [Fact]
@@ -963,9 +973,9 @@ public sealed class ClassTeacherViewModelsTests
var absences = new[] var absences = new[]
{ {
new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 24), "Fehlt Cem", 1001, 1, 45, new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 24), "Fehlt Cem", 1001, 1, 45,
["Deu"], [1], ["nicht entsch."], ["Absent"], null, null, false), ["Deu"], [1], ["nicht entsch."], ["Absent"], null, null, true),
new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 25), "Fehlt Cem", 1001, 1, 45, new ClassAbsenceDaySummaryRow(new DateOnly(2026, 8, 25), "Fehlt Cem", 1001, 1, 45,
["Deu"], [1], ["nicht entsch."], ["Absent"], null, null, false), ["Deu"], [1], ["nicht entsch."], ["Absent"], null, null, true),
}; };
var names = new Dictionary<string, string> { [UntisNameMatching.NameKey("Fehlt Cem")] = "Cem Fehlt" }; var names = new Dictionary<string, string> { [UntisNameMatching.NameKey("Fehlt Cem")] = "Cem Fehlt" };
@@ -978,6 +988,26 @@ public sealed class ClassTeacherViewModelsTests
Assert.False(notice.CanCreateReminder); Assert.False(notice.CanCreateReminder);
} }
[Fact]
public void DetectLatePatterns_StundenweisesUnentschuldigtesFehlenBleibtEigeneWarnstufe()
{
var absences = new[]
{
new ClassAbsenceDaySummaryRow(new DateOnly(2026, 9, 21), "Protest Ada", 1001, 1, 45,
["Deu"], [2], ["nicht entsch."], ["Absent"], null, null, false),
new ClassAbsenceDaySummaryRow(new DateOnly(2026, 9, 24), "Protest Ada", 1001, 1, 45,
["Mat"], [4], ["nicht entsch."], ["Absent"], null, null, false),
};
var names = new Dictionary<string, string>
{ [UntisNameMatching.NameKey("Protest Ada")] = "Ada Protest" };
var notice = Assert.Single(ClassTeacherOverviewViewModel.DetectLatePatterns(
absences, names, sevenDayStart: new DateOnly(2026, 9, 20)));
Assert.Contains("stundenweise unentschuldigte Fehlzeiten", notice.Message);
Assert.Equal(ClassTeacherStatusKind.Warning, notice.Kind);
}
// ── Aggregierte Klassenbuch-Kategorien (Feature-Idee 5) ────────────────── // ── Aggregierte Klassenbuch-Kategorien (Feature-Idee 5) ──────────────────
[Fact] [Fact]
@@ -1230,6 +1260,18 @@ public sealed class ClassTeacherViewModelsTests
Assert.Empty(result); Assert.Empty(result);
} }
[Fact]
public void FilterAvailableDocumentation_BeruecksichtigtWeitereBeteiligte()
{
Guid ada = Guid.NewGuid(), ben = Guid.NewGuid();
var shared = new Documentation { StudentId = Guid.NewGuid(), AdditionalStudentIds = [ben] };
var vorgang = new Vorgang { StudentIds = [ada, ben] };
var result = ClassTeacherCasesViewModel.FilterAvailableDocumentation([shared], vorgang);
Assert.Equal(shared.Id, Assert.Single(result).Id);
}
// ── Konfigurierbare Gewichtung + Dämpfung/Rückfall-Warnung nach geschlossenem Vorgang ───────── // ── Konfigurierbare Gewichtung + Dämpfung/Rückfall-Warnung nach geschlossenem Vorgang ─────────
[Fact] [Fact]
@@ -308,4 +308,89 @@ public sealed class DocumentationDialogViewModelTests
Assert.Null(storage.OpenRead(storageId)); Assert.Null(storage.OpenRead(storageId));
} }
// ── Weitere Beteiligte ("Betrifft außerdem") ─────────────────────────────
[Fact]
public void WeitereBeteiligte_NeuerEintrag_UebernimmtAuswahlOhneHauptperson()
{
var anna = new StudentOption(Guid.NewGuid(), "Anna Beispiel");
var ben = new StudentOption(Guid.NewGuid(), "Ben Muster");
var cem = new StudentOption(Guid.NewGuid(), "Cem Test");
var vm = new DocumentationDialogViewModel(anna.Id, null, new FakeAttachmentStorage(),
coStudentOptions: [anna, ben, cem])
{
Title = "Konflikt", TypeName = "Vorkommnis",
};
Assert.True(vm.HasCoStudents);
Assert.True(vm.CoStudents.Single(c => c.Id == anna.Id).IsPrimary);
foreach (var c in vm.CoStudents) c.IsSelected = true;
vm.SaveCommand.Execute(null);
Assert.Equal(anna.Id, vm.Result!.StudentId);
Assert.Equal([ben.Id, cem.Id], vm.Result.AdditionalStudentIds);
}
[Fact]
public void WeitereBeteiligte_NurHauptpersonAlsKandidat_BlendetAuswahlAus()
{
var anna = new StudentOption(Guid.NewGuid(), "Anna Beispiel");
var vm = new DocumentationDialogViewModel(anna.Id, null, new FakeAttachmentStorage(), coStudentOptions: [anna]);
Assert.False(vm.HasCoStudents);
}
[Fact]
public void WeitereBeteiligte_WechselDerHauptperson_VerschiebtAusblendung()
{
var anna = new StudentOption(Guid.NewGuid(), "Anna Beispiel");
var ben = new StudentOption(Guid.NewGuid(), "Ben Muster");
var vm = new DocumentationDialogViewModel(anna.Id, null, new FakeAttachmentStorage(), [anna, ben],
coStudentOptions: [anna, ben])
{
Title = "Konflikt", TypeName = "Vorkommnis",
};
vm.CoStudents.Single(c => c.Id == anna.Id).IsSelected = true;
vm.SelectedStudent = ben;
vm.SaveCommand.Execute(null);
Assert.True(vm.CoStudents.Single(c => c.Id == ben.Id).IsPrimary);
Assert.Equal(ben.Id, vm.Result!.StudentId);
Assert.Equal([anna.Id], vm.Result.AdditionalStudentIds);
}
[Fact]
public void WeitereBeteiligte_BearbeitenOhneKandidaten_BehaeltBestehendeBei()
{
Guid anna = Guid.NewGuid(), ben = Guid.NewGuid();
var existing = new Documentation { StudentId = anna, AdditionalStudentIds = [ben], Title = "Konflikt" };
var vm = new DocumentationDialogViewModel(ben, existing, new FakeAttachmentStorage());
vm.SaveCommand.Execute(null);
Assert.Equal(anna, vm.Result!.StudentId);
Assert.Equal([ben], vm.Result.AdditionalStudentIds);
}
[Fact]
public void WeitereBeteiligte_Bearbeiten_AbwahlEntferntNurAngeboteneKandidaten()
{
var anna = new StudentOption(Guid.NewGuid(), "Anna Beispiel");
var ben = new StudentOption(Guid.NewGuid(), "Ben Muster");
var outsider = Guid.NewGuid();
var existing = new Documentation
{
StudentId = anna.Id, AdditionalStudentIds = [ben.Id, outsider], Title = "Konflikt",
};
var vm = new DocumentationDialogViewModel(anna.Id, existing, new FakeAttachmentStorage(),
coStudentOptions: [anna, ben]);
Assert.True(vm.CoStudents.Single(c => c.Id == ben.Id).IsSelected);
vm.CoStudents.Single(c => c.Id == ben.Id).IsSelected = false;
vm.SaveCommand.Execute(null);
Assert.Equal([outsider], vm.Result!.AdditionalStudentIds);
}
} }
+2 -2
View File
@@ -320,9 +320,9 @@ public class FakeDocumentation : IDocumentationRepository
private readonly List<Documentation> _all = []; private readonly List<Documentation> _all = [];
public void Add(Documentation d) => _all.Add(d); public void Add(Documentation d) => _all.Add(d);
public List<Documentation> GetByStudent(Guid studentId) => public List<Documentation> GetByStudent(Guid studentId) =>
_all.Where(d => d.StudentId == studentId && !d.IsDeleted).ToList(); _all.Where(d => d.Concerns(studentId) && !d.IsDeleted).ToList();
public List<Documentation> GetByStudentAndType(Guid studentId, DocumentationType type) => public List<Documentation> GetByStudentAndType(Guid studentId, DocumentationType type) =>
_all.Where(d => d.StudentId == studentId && d.Type == type && !d.IsDeleted).ToList(); _all.Where(d => d.Concerns(studentId) && d.Type == type && !d.IsDeleted).ToList();
public List<Documentation> GetAll() => _all.Where(d => !d.IsDeleted).ToList(); public List<Documentation> GetAll() => _all.Where(d => !d.IsDeleted).ToList();
public void Save(Documentation doc) { _all.RemoveAll(d => d.Id == doc.Id); _all.Add(doc); } public void Save(Documentation doc) { _all.RemoveAll(d => d.Id == doc.Id); _all.Add(doc); }
public void Delete(Guid id) { var d = _all.FirstOrDefault(x => x.Id == id); if (d is not null) d.IsDeleted = true; } public void Delete(Guid id) { var d = _all.FirstOrDefault(x => x.Id == id); if (d is not null) d.IsDeleted = true; }
@@ -136,6 +136,38 @@ public sealed class StudentWarningEvidenceTests
Assert.False(vm.IsPersisted(draft)); Assert.False(vm.IsPersisted(draft));
} }
[Fact]
public async Task GemeinsamerVorgang_DokumentationFuerMehrereErscheintAuchBeimZweitenSchueler()
{
var ben = new Student { FirstName = "Ben", LastName = "Muster" };
var students = new FakeStudents([_student, ben]);
var vorgaenge = new FakeVorgangRepository();
var vorgang = new Vorgang { Title = "Streit", StudentIds = [_student.Id, ben.Id], Tags = ["Konflikte"] };
vorgaenge.Add(vorgang);
var documentation = new FakeDocumentation();
var vm = new StudentVorgaengeViewModel(vorgaenge, documentation, students);
vm.Load(_student.Id);
List<StudentOption> offered = [];
vm.OnEditDocumentation = (studentId, coStudents, _) =>
{
offered = coStudents;
return Task.FromResult<Documentation?>(new Documentation
{
StudentId = studentId, AdditionalStudentIds = [ben.Id], Title = "Gespräch mit beiden",
});
};
await vm.CreateAndLinkDocumentationCommand.ExecuteAsync(Assert.Single(vm.Cases));
Assert.Equal([_student.Id, ben.Id], offered.Select(o => o.Id));
var benView = new StudentVorgaengeViewModel(vorgaenge, documentation, students);
benView.Load(ben.Id);
var linked = Assert.Single(Assert.Single(benView.Cases).LinkedDocumentation);
Assert.Equal("Gespräch mit beiden", linked.Model.Title);
Assert.Contains("Muster", linked.StudentName);
Assert.Contains("Beispiel", linked.StudentName);
}
[Fact] [Fact]
public async Task VorlageAusVorgangstab_OeffnetEntwurfUndVerknuepftNachSpeichern() public async Task VorlageAusVorgangstab_OeffnetEntwurfUndVerknuepftNachSpeichern()
{ {
@@ -147,7 +179,7 @@ public sealed class StudentWarningEvidenceTests
var vm = new StudentVorgaengeViewModel(vorgaenge, documentation, new FakeStudents([_student]), BuildService()); var vm = new StudentVorgaengeViewModel(vorgaenge, documentation, new FakeStudents([_student]), BuildService());
vm.Load(_student.Id); vm.Load(_student.Id);
var wasDraft = false; var wasDraft = false;
vm.OnEditDocumentation = (_, editing) => vm.OnEditDocumentation = (_, _, editing) =>
{ {
wasDraft = vm.IsNewDocumentationDraft(editing!); wasDraft = vm.IsNewDocumentationDraft(editing!);
return Task.FromResult(editing); return Task.FromResult(editing);
@@ -83,10 +83,12 @@ public sealed class VorgangBausteineTests
Assert.Equal(8, facts.AbsentPeriods); Assert.Equal(8, facts.AbsentPeriods);
Assert.Equal(1, facts.UnexcusedDays); Assert.Equal(1, facts.UnexcusedDays);
Assert.Equal(2, facts.PartialAbsentPeriods);
Assert.Equal(0, facts.UnexcusedPartialPeriods);
Assert.Single(facts.LateDays); Assert.Single(facts.LateDays);
Assert.Equal(1, facts.NegativeRegisterCount); Assert.Equal(1, facts.NegativeRegisterCount);
Assert.Single(facts.HomeworkEntries); Assert.Single(facts.HomeworkEntries);
Assert.Contains("8 Fehlstunden an 2 Tagen", facts.AbsenceShort); Assert.Contains("1 ganzer Fehltag und 2 weitere Fehlstunden", facts.AbsenceShort);
var labels = facts.QuickBlocks(withName: true).Select(b => b.Label).ToList(); var labels = facts.QuickBlocks(withName: true).Select(b => b.Label).ToList();
Assert.Contains("Fehlzeiten · Beispiel Anna", labels); Assert.Contains("Fehlzeiten · Beispiel Anna", labels);
@@ -98,6 +100,23 @@ public sealed class VorgangBausteineTests
Assert.StartsWith("Sehr geehrte Erziehungsberechtigte von Anna Beispiel", letter.ParentLetterData!.DraftContent); Assert.StartsWith("Sehr geehrte Erziehungsberechtigte von Anna Beispiel", letter.ParentLetterData!.DraftContent);
} }
[Fact]
public void KlassenlehrerStand_UnentschuldigteFehlstundeWirdNichtAlsFehltagBezeichnet()
{
var student = new StudentOption(Guid.NewGuid(), "Beispiel Anna");
var today = new DateOnly(2026, 9, 28);
var facts = ClassTeacherStudentFacts.Build(student, "Anna Beispiel", "2026/27", today,
[Absence(today.AddDays(-4), "Anna Beispiel", 1, unexcused: true)], []);
Assert.Equal(0, facts.FullDays);
Assert.Equal(0, facts.UnexcusedDays);
Assert.Equal(1, facts.PartialAbsentPeriods);
Assert.Equal(1, facts.UnexcusedPartialPeriods);
Assert.Contains("0 ganze Fehltage und 1 weitere Fehlstunde", facts.AbsenceShort);
Assert.Contains("unentschuldigt: 0 ganze Tage, 1 Fehlstunde", facts.AbsenceShort);
Assert.Contains("1 Fehlstunde · Unentschuldigt", facts.AbsenceBlock);
}
[Fact] [Fact]
public void Vorlage_KlassenleitungInformieren() public void Vorlage_KlassenleitungInformieren()
{ {
@@ -22,7 +22,10 @@ public sealed record ClassTeacherStudentFacts(StudentOption Student, string Natu
public int AbsentPeriods => AbsenceDays.Sum(d => d.TotalAbsentPeriods); public int AbsentPeriods => AbsenceDays.Sum(d => d.TotalAbsentPeriods);
public int FullDays => AbsenceDays.Count(d => d.CountsAsFullDay); public int FullDays => AbsenceDays.Count(d => d.CountsAsFullDay);
public int UnexcusedDays => AbsenceDays.Count(d => d.IsUnexcused); 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 int NegativeRegisterCount => RegisterEntries.Count(r => r.IsDangerStatus);
public IReadOnlyList<ClassTeacherClassRegisterRow> HomeworkEntries => RegisterEntries public IReadOnlyList<ClassTeacherClassRegisterRow> HomeworkEntries => RegisterEntries
.Where(r => ($"{r.CategoryName} {r.Text}").Contains("Hausauf", StringComparison.OrdinalIgnoreCase)).ToList(); .Where(r => ($"{r.CategoryName} {r.Text}").Contains("Hausauf", StringComparison.OrdinalIgnoreCase)).ToList();
@@ -30,15 +33,17 @@ public sealed record ClassTeacherStudentFacts(StudentOption Student, string Natu
private string Stand => $"WebUntis-Stand {AsOf:dd.MM.yyyy}"; private string Stand => $"WebUntis-Stand {AsOf:dd.MM.yyyy}";
public string AbsenceShort => public string AbsenceShort =>
$"{AbsentPeriods} Fehlstunde{(AbsentPeriods == 1 ? "" : "n")} an {AbsenceDays.Count} Tag{(AbsenceDays.Count == 1 ? "" : "en")} " + $"{FullDayLabel(FullDays)} und " +
$"im Schuljahr {SchoolYear} (davon {UnexcusedDays} Tag{(UnexcusedDays == 1 ? "" : "e")} unentschuldigt, " + $"{PartialAbsentPeriods} weitere Fehlstunde{(PartialAbsentPeriods == 1 ? "" : "n")} " +
$"{FullDays} ganze Fehltag{(FullDays == 1 ? "" : "e")})"; $"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 LatenessShort => $"{LateDays.Count} Verspätung{(LateDays.Count == 1 ? "" : "en")} im Schuljahr {SchoolYear}";
public string RegisterShort => public string RegisterShort =>
$"{RegisterEntries.Count} Klassenbucheintr{(RegisterEntries.Count == 1 ? "ag" : "äge")} im Schuljahr {SchoolYear}, davon {NegativeRegisterCount} negativ"; $"{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 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 => public string AbsenceBlock => $"{Stand}: {AbsenceShort}.\n" + List("Fehlzeiten", AbsenceDays.Select(d =>
$"{d.DateLabel}: {d.KindLabel} · {d.FriendlyStatusLabel}" + $"{d.DateLabel}: {d.KindLabel} · {d.FriendlyStatusLabel}" +
(string.IsNullOrWhiteSpace(d.DetailLabel) ? "" : $" · {d.DetailLabel}")).ToList()); (string.IsNullOrWhiteSpace(d.DetailLabel) ? "" : $" · {d.DetailLabel}")).ToList());
public string LatenessBlock => $"{Stand}: {LatenessShort}.\n" + List("Termine", LateDays.Select(d => public string LatenessBlock => $"{Stand}: {LatenessShort}.\n" + List("Termine", LateDays.Select(d =>
@@ -50,6 +55,12 @@ public sealed record ClassTeacherStudentFacts(StudentOption Student, string Natu
$"{r.DateLabel}" + (string.IsNullOrWhiteSpace(r.Subject) ? "" : $" · {r.Subject}") + ": " + $"{r.DateLabel}" + (string.IsNullOrWhiteSpace(r.Subject) ? "" : $" · {r.Subject}") + ": " +
string.Join(" – ", new[] { r.CategoryName, r.Text }.Where(v => !string.IsNullOrWhiteSpace(v))); 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) private static string List(string header, IReadOnlyList<string> lines)
{ {
var sb = new StringBuilder($"{header}:"); var sb = new StringBuilder($"{header}:");
@@ -42,7 +42,8 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
public Func<List<StudentOption>, Vorgang?, Task<Vorgang?>>? OnEditVorgang { get; set; } public Func<List<StudentOption>, Vorgang?, Task<Vorgang?>>? OnEditVorgang { get; set; }
public Func<VorgangItem, Task<bool>>? OnConfirmDeleteVorgang { get; set; } public Func<VorgangItem, Task<bool>>? OnConfirmDeleteVorgang { get; set; }
public Func<Guid, List<StudentOption>, Documentation?, Task<Documentation?>>? OnEditDocumentation { get; set; } /// Parameter: Hauptperson, Bezug-Auswahl, Kandidaten für "Betrifft außerdem", bestehender Eintrag.
public Func<Guid, List<StudentOption>, List<StudentOption>, Documentation?, Task<Documentation?>>? OnEditDocumentation { get; set; }
public ClassTeacherCasesViewModel(IVorgangRepository vorgaenge, IDocumentationRepository documentation, public ClassTeacherCasesViewModel(IVorgangRepository vorgaenge, IDocumentationRepository documentation,
IStudentRepository students, UntisReportCacheService cache) IStudentRepository students, UntisReportCacheService cache)
@@ -110,9 +111,9 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
var linkedIds = vorgang.DocumentationIds.ToHashSet(); var linkedIds = vorgang.DocumentationIds.ToHashSet();
foreach (var doc in allDocs.Where(d => linkedIds.Contains(d.Id))) foreach (var doc in allDocs.Where(d => linkedIds.Contains(d.Id)))
item.LinkedDocumentation.Add(new DocumentationItem(doc, nameById.GetValueOrDefault(doc.StudentId, ""))); item.LinkedDocumentation.Add(new DocumentationItem(doc, InvolvedNames(doc, nameById)));
foreach (var doc in FilterAvailableDocumentation(allDocs, vorgang)) foreach (var doc in FilterAvailableDocumentation(allDocs, vorgang))
item.AvailableDocumentation.Add(new DocumentationItem(doc, nameById.GetValueOrDefault(doc.StudentId, ""))); item.AvailableDocumentation.Add(new DocumentationItem(doc, InvolvedNames(doc, nameById)));
foreach (var entry in vorgang.ClassRegisterEntries.OrderByDescending(e => e.Date)) foreach (var entry in vorgang.ClassRegisterEntries.OrderByDescending(e => e.Date))
item.ClassRegisterRows.Add(new VorgangClassRegisterEntryRow(entry)); item.ClassRegisterRows.Add(new VorgangClassRegisterEntryRow(entry));
@@ -125,6 +126,25 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
private void NotifyState() => OnPropertyChanged(nameof(HasCases)); private void NotifyState() => OnPropertyChanged(nameof(HasCases));
private static string InvolvedNames(Documentation doc, Dictionary<Guid, string> nameById) =>
string.Join(", ", doc.InvolvedStudentIds().Select(id => nameById.GetValueOrDefault(id, "")).Where(n => n != ""));
private List<StudentOption> VorgangStudentOptions(Vorgang vorgang) =>
_rosterStudentOptions.Where(s => vorgang.StudentIds.Contains(s.Id)).ToList();
/// "Betrifft außerdem"-Kandidaten beim Bearbeiten eines Eintrags: die Beteiligten aller angezeigten
/// Vorgänge, in denen der Eintrag verknüpft oder verknüpfbar ist, plus die schon Beteiligten —
/// bewusst nicht der ganze Klassen-Roster, damit die Liste kurz bleibt.
private List<StudentOption> CoStudentOptionsFor(Documentation doc)
{
var ids = Cases.Select(c => c.Model)
.Where(v => v.DocumentationIds.Contains(doc.Id) || v.StudentIds.Any(doc.Concerns))
.SelectMany(v => v.StudentIds)
.Concat(doc.InvolvedStudentIds())
.ToHashSet();
return _rosterStudentOptions.Where(s => ids.Contains(s.Id)).ToList();
}
/// Lädt Fehlzeiten und Klassenbucheinträge des laufenden Schuljahres (aus dem Untis-Cache, der /// Lädt Fehlzeiten und Klassenbucheinträge des laufenden Schuljahres (aus dem Untis-Cache, der
/// kalte Bereich ist dort dauerhaft gespeichert) und leitet daraus den Stand je Schüler*in ab. /// kalte Bereich ist dort dauerhaft gespeichert) und leitet daraus den Stand je Schüler*in ab.
/// Scheitert der Abruf (offline, Sitzung abgelaufen), gibt es eben nur die Standardformulierungen /// Scheitert der Abruf (offline, Sitzung abgelaufen), gibt es eben nur die Standardformulierungen
@@ -188,7 +208,7 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
_documentationDraftId = draft.Id; _documentationDraftId = draft.Id;
Documentation? result; Documentation? result;
try { result = await OnEditDocumentation(option.Id, [option], draft); } try { result = await OnEditDocumentation(option.Id, [option], VorgangStudentOptions(item.Model), draft); }
finally { _documentationDraftId = null; } finally { _documentationDraftId = null; }
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
@@ -242,9 +262,9 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
private async Task CreateAndLinkDocumentation(VorgangItem? item) private async Task CreateAndLinkDocumentation(VorgangItem? item)
{ {
if (item is null || OnEditDocumentation is null) return; if (item is null || OnEditDocumentation is null) return;
var studentOptions = _rosterStudentOptions.Where(s => item.Model.StudentIds.Contains(s.Id)).ToList(); var studentOptions = VorgangStudentOptions(item.Model);
var defaultStudentId = item.Model.StudentIds.FirstOrDefault(); var defaultStudentId = item.Model.StudentIds.FirstOrDefault();
var result = await OnEditDocumentation(defaultStudentId, studentOptions, null); var result = await OnEditDocumentation(defaultStudentId, studentOptions, studentOptions, null);
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
item.Model.DocumentationIds.Add(result.Id); item.Model.DocumentationIds.Add(result.Id);
@@ -259,19 +279,20 @@ public partial class ClassTeacherCasesViewModel : ObservableObject
private async Task EditDocumentation(DocumentationItem doc) private async Task EditDocumentation(DocumentationItem doc)
{ {
if (OnEditDocumentation is null) return; if (OnEditDocumentation is null) return;
var result = await OnEditDocumentation(doc.Model.StudentId, _rosterStudentOptions, doc.Model); var result = await OnEditDocumentation(doc.Model.StudentId, _rosterStudentOptions,
CoStudentOptionsFor(doc.Model), doc.Model);
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
await LoadInternal(); await LoadInternal();
} }
/// Dokumentation der Vorgangs-Schüler*innen, die noch nicht mit diesem Vorgang verknüpft ist — /// Dokumentation der Vorgangs-Schüler*innen (als Haupt- oder weitere Beteiligte), die noch nicht
/// reine, ohne Repository-Zugriff testbare Filterlogik (gleiches Muster wie /// mit diesem Vorgang verknüpft ist — reine, ohne Repository-Zugriff testbare Filterlogik
/// <see cref="ClassTeacherRosterRow.Build"/>). /// (gleiches Muster wie <see cref="ClassTeacherRosterRow.Build"/>).
public static List<Documentation> FilterAvailableDocumentation(IReadOnlyList<Documentation> allDocs, Vorgang vorgang) public static List<Documentation> FilterAvailableDocumentation(IReadOnlyList<Documentation> allDocs, Vorgang vorgang)
{ {
var linkedIds = vorgang.DocumentationIds.ToHashSet(); var linkedIds = vorgang.DocumentationIds.ToHashSet();
return allDocs.Where(d => vorgang.StudentIds.Contains(d.StudentId) && !linkedIds.Contains(d.Id)).ToList(); return allDocs.Where(d => vorgang.StudentIds.Any(d.Concerns) && !linkedIds.Contains(d.Id)).ToList();
} }
private async Task LinkDocumentation(VorgangItem item, DocumentationItem doc) private async Task LinkDocumentation(VorgangItem item, DocumentationItem doc)
@@ -66,6 +66,11 @@ public sealed record ClassAbsenceDaySummaryRow(DateOnly Date, string StudentName
IReadOnlyList<int> PeriodNumbers, IReadOnlyList<string> Statuses, IReadOnlyList<string> AbsenceReasons, IReadOnlyList<int> PeriodNumbers, IReadOnlyList<string> Statuses, IReadOnlyList<string> AbsenceReasons,
string? Note, string? ExcuseNote, bool CountsAsFullDay) string? Note, string? ExcuseNote, bool CountsAsFullDay)
{ {
/// Nur für die Gewichtung von stundenweisen Fehlzeiten im Auffälligkeitsscore. Zeugnis- und
/// Anzeigezahlen verwenden weiterhin die echten WebUntis-Felder CountsAsFullDay bzw.
/// TotalAbsentPeriods und rechnen keine Stunden künstlich in Fehltage um.
public const int TypicalPeriodsPerSchoolDayForScoring = 6;
public string DateLabel => Date.ToString("dd.MM.yyyy"); public string DateLabel => Date.ToString("dd.MM.yyyy");
public string StudentDisplayName public string StudentDisplayName
{ {
@@ -83,6 +88,11 @@ public sealed record ClassAbsenceDaySummaryRow(DateOnly Date, string StudentName
r.Contains("verspät", StringComparison.OrdinalIgnoreCase)); r.Contains("verspät", StringComparison.OrdinalIgnoreCase));
public bool IsUnexcused => Statuses.Any(s => public bool IsUnexcused => Statuses.Any(s =>
s.Contains("nicht entsch", StringComparison.OrdinalIgnoreCase)); s.Contains("nicht entsch", StringComparison.OrdinalIgnoreCase));
public bool IsPartialAbsence => !CountsAsFullDay && (!IsLate || IsUnexcused);
public double AbsenceDayEquivalentForScoring => IsLate && !IsUnexcused ? 0d : CountsAsFullDay ? 1d :
Math.Min(1d, (TotalAbsentPeriods > 0
? TotalAbsentPeriods
: TotalAbsentMinutes / 45d) / TypicalPeriodsPerSchoolDayForScoring);
public string KindLabel => IsLate ? $"{TotalAbsentMinutes} Min. verspätet" : public string KindLabel => IsLate ? $"{TotalAbsentMinutes} Min. verspätet" :
CountsAsFullDay ? "Ganzer Fehltag" : $"{TotalAbsentPeriods} Fehlstunde{(TotalAbsentPeriods == 1 ? "" : "n")}"; CountsAsFullDay ? "Ganzer Fehltag" : $"{TotalAbsentPeriods} Fehlstunde{(TotalAbsentPeriods == 1 ? "" : "n")}";
public string FriendlyStatusLabel => IsUnexcused ? "Unentschuldigt" : public string FriendlyStatusLabel => IsUnexcused ? "Unentschuldigt" :
@@ -454,7 +464,7 @@ public partial class ClassTeacherDetailsViewModel : ObservableObject
var matchedIds = rosterMatches.Select(m => m.StudentId).ToHashSet(); var matchedIds = rosterMatches.Select(m => m.StudentId).ToHashSet();
return all return all
.Where(d => !d.IsDeleted && .Where(d => !d.IsDeleted &&
(matchedIds.Contains(d.StudentId) || IsUnassignedClassDocumentation(d)) && (d.InvolvedStudentIds().Any(matchedIds.Contains) || IsUnassignedClassDocumentation(d)) &&
d.Date >= start && d.Date <= end) d.Date >= start && d.Date <= end)
.Where(d => MatchesOwnDocStudentFilter(d, rosterMatches, studentFilter)) .Where(d => MatchesOwnDocStudentFilter(d, rosterMatches, studentFilter))
.OrderByDescending(d => d.IsDraft).ThenByDescending(d => d.Date) .OrderByDescending(d => d.IsDraft).ThenByDescending(d => d.Date)
@@ -467,8 +477,10 @@ public partial class ClassTeacherDetailsViewModel : ObservableObject
if (string.IsNullOrWhiteSpace(studentFilter)) return true; if (string.IsNullOrWhiteSpace(studentFilter)) return true;
if (IsUnassignedClassDocumentation(d)) if (IsUnassignedClassDocumentation(d))
return d.Participants.Any(p => NameContainsSearchTerm(p, studentFilter)); return d.Participants.Any(p => NameContainsSearchTerm(p, studentFilter));
var name = rosterMatches.FirstOrDefault(m => m.StudentId == d.StudentId).DisplayName; // Gemeinsame Einträge (weitere Beteiligte) passen, sobald eine der beteiligten Personen passt.
return name is not null && NameContainsSearchTerm(name, studentFilter); return d.InvolvedStudentIds()
.Select(id => rosterMatches.FirstOrDefault(m => m.StudentId == id).DisplayName)
.Any(name => name is not null && NameContainsSearchTerm(name, studentFilter));
} }
private static bool IsUnassignedClassDocumentation(Documentation d) => private static bool IsUnassignedClassDocumentation(Documentation d) =>
@@ -485,8 +497,13 @@ public partial class ClassTeacherDetailsViewModel : ObservableObject
IReadOnlyList<(Guid StudentId, string DisplayName)> rosterMatches) IReadOnlyList<(Guid StudentId, string DisplayName)> rosterMatches)
{ {
if (d.StudentId != Guid.Empty) if (d.StudentId != Guid.Empty)
return rosterMatches.FirstOrDefault(m => m.StudentId == d.StudentId).DisplayName {
?? "Unbekannter Schülerbezug"; var names = d.InvolvedStudentIds()
.Select(id => rosterMatches.FirstOrDefault(m => m.StudentId == id).DisplayName)
.Where(n => n is not null)
.ToList();
return names.Count > 0 ? string.Join(", ", names) : "Unbekannter Schülerbezug";
}
return d.Participants.Count > 0 return d.Participants.Count > 0
? $"Ohne festen Bezug · {string.Join(", ", d.Participants)}" ? $"Ohne festen Bezug · {string.Join(", ", d.Participants)}"
: "Ohne Schülerbezug"; : "Ohne Schülerbezug";
@@ -81,21 +81,22 @@ public sealed record ClassTeacherRosterRow(string StudentName, int? ExternKey, b
/// Kumulierte Fehlzeiten seit Schuljahresbeginn (Nutzer-Feedback: der Heute-Snapshot allein /// Kumulierte Fehlzeiten seit Schuljahresbeginn (Nutzer-Feedback: der Heute-Snapshot allein
/// sagt für Zeugnis/Attestpflicht wenig aus). <see cref="SchoolDaysElapsed"/> zählt Werktage /// sagt für Zeugnis/Attestpflicht wenig aus). <see cref="SchoolDaysElapsed"/> zählt Werktage
/// abzüglich der über WebUntis geladenen Ferien (<see cref="ClassTeacherOverviewViewModel.CountSchoolWeekdays"/>). /// abzüglich der über WebUntis geladenen Ferien (<see cref="ClassTeacherOverviewViewModel.CountSchoolWeekdays"/>).
/// Zählt bewusst NUR echte Fehltage (unentschuldigt oder entschuldigt abwesend), keine reinen /// Zählt bewusst NUR von WebUntis als ganze Fehltage gekennzeichnete Tage. Stundenweises
/// Verspätungstage mehr — Nutzer-Feedback: die Quote behandelte "10× 5 Min. verspätet" bisher /// Fehlen bleibt davon getrennt in <see cref="YearAbsencePeriodCount"/> — auch wenn es
/// exakt wie "10× ganztägig unentschuldigt gefehlt", obwohl beides für die eigene Reaktion /// unentschuldigt ist. Reine Verspätung landet separat in <see cref="YearLateDayCount"/>.
/// (Elterngespräch vs. Achselzucken) grundverschieden ist. Reine Verspätung landet stattdessen
/// separat in <see cref="YearLateDayCount"/> (gleiche Kategorisierung wie schon länger im
/// Wochentrend, siehe <see cref="ClassTeacherOverviewViewModel.BuildTrend"/>: Unentschuldigt vor
/// Verspätet vor Entschuldigt, überschneidungsfrei).
public int YearAbsenceDayCount { get; init; } public int YearAbsenceDayCount { get; init; }
public int YearUnexcusedDayCount { get; init; } public int YearUnexcusedDayCount { get; init; }
/// Fehlstunden aus nicht ganztägigen Fehlzeiten. Ganze Fehltage werden nicht zusätzlich noch
/// einmal als ihre enthaltenen Unterrichtsstunden gezählt.
public int YearAbsencePeriodCount { get; init; }
public int YearUnexcusedPeriodCount { get; init; }
public int YearExcusedPeriodCount { get; init; }
/// Tage, die WebUntis als Verspätung führt (ohne Unentschuldigt-Status) — zählen bewusst nicht /// Tage, die WebUntis als Verspätung führt (ohne Unentschuldigt-Status) — zählen bewusst nicht
/// in <see cref="YearAbsenceDayCount"/>/<see cref="YearAbsenceRatePercent"/>, tragen aber mit /// in <see cref="YearAbsenceDayCount"/>/<see cref="YearAbsenceRatePercent"/>, tragen aber mit
/// reduziertem Gewicht zu <see cref="PatternScore"/> bei. /// reduziertem Gewicht zu <see cref="PatternScore"/> bei.
public int YearLateDayCount { get; init; } public int YearLateDayCount { get; init; }
/// Entschuldigt abwesende Tage (weder unentschuldigt noch nur verspätet) — Kehrwert von /// Entschuldigte ganze Fehltage — Gegenstück zu <see cref="YearUnexcusedDayCount"/> innerhalb
/// <see cref="YearUnexcusedDayCount"/> innerhalb von <see cref="YearAbsenceDayCount"/>. /// von <see cref="YearAbsenceDayCount"/>. Stunden stehen getrennt in den Period-Eigenschaften.
public int YearExcusedDayCount { get; init; } public int YearExcusedDayCount { get; init; }
/// Klassenbucheinträge anderer Lehrkräfte über das ganze bisherige Schuljahr mit /// Klassenbucheinträge anderer Lehrkräfte über das ganze bisherige Schuljahr mit
/// <c>CategoryGroup</c> "Negativ" (Nutzer-Feedback: sollen ebenfalls ins Auffälligkeitsbild /// <c>CategoryGroup</c> "Negativ" (Nutzer-Feedback: sollen ebenfalls ins Auffälligkeitsbild
@@ -121,23 +122,33 @@ public sealed record ClassTeacherRosterRow(string StudentName, int? ExternKey, b
/// die Korrektur passiert also am Startpunkt, nicht an abgezogenen Tagen mittendrin. /// die Korrektur passiert also am Startpunkt, nicht an abgezogenen Tagen mittendrin.
public DateOnly TermStart { get; init; } public DateOnly TermStart { get; init; }
public bool HasYearSummary => SchoolDaysElapsed > 0 && public bool HasYearSummary => SchoolDaysElapsed > 0 &&
(YearAbsenceDayCount > 0 || YearLateDayCount > 0 || YearNegativeClassRegisterCount > 0); (YearAbsenceDayCount > 0 || YearAbsencePeriodCount > 0 || YearLateDayCount > 0 ||
YearNegativeClassRegisterCount > 0);
public int YearAbsenceRatePercent => public int YearAbsenceRatePercent =>
SchoolDaysElapsed <= 0 ? 0 : (int)Math.Round(100d * YearAbsenceDayCount / SchoolDaysElapsed); SchoolDaysElapsed <= 0 ? 0 : (int)Math.Round(100d * YearAbsenceDayCount / SchoolDaysElapsed);
public string YearSummaryLabel => !HasYearSummary ? "" : public string YearSummaryLabel => !HasYearSummary ? "" :
YearAbsenceDayCount > 0 ? $"{YearAbsenceRatePercent} % Fehlzeit seit Schuljahresbeginn" YearAbsenceDayCount > 0 ? $"{YearAbsenceRatePercent} % ganze Fehltage" +
(YearAbsencePeriodCount > 0 ? $" · {PeriodLabel(YearAbsencePeriodCount)}" : "")
: YearAbsencePeriodCount > 0 ? $"{PeriodLabel(YearAbsencePeriodCount)} seit Schuljahresbeginn"
: YearLateDayCount > 0 ? $"{YearLateDayCount}× verspätet, keine Fehltage seit Schuljahresbeginn" : YearLateDayCount > 0 ? $"{YearLateDayCount}× verspätet, keine Fehltage seit Schuljahresbeginn"
: $"{YearNegativeClassRegisterCount} negative Klassenbucheinträge seit Schuljahresbeginn"; : $"{YearNegativeClassRegisterCount} negative Klassenbucheinträge seit Schuljahresbeginn";
public string? YearSummaryTooltip => !HasYearSummary ? null : public string? YearSummaryTooltip => !HasYearSummary ? null :
(YearAbsenceDayCount > 0 (YearAbsenceDayCount > 0
? $"{YearAbsenceDayCount} von {SchoolDaysElapsed} Schultagen seit {TermStart:dd.MM.} mit Fehlzeit" + ? $"{YearAbsenceDayCount} von {SchoolDaysElapsed} Schultagen seit {TermStart:dd.MM.} als ganzer Fehltag" +
(YearUnexcusedDayCount > 0 ? $" · {YearUnexcusedDayCount} unentschuldigt" : "") (YearUnexcusedDayCount > 0 ? $" · davon {YearUnexcusedDayCount} unentschuldigt" : "")
: $"Keine Fehltage seit {TermStart:dd.MM.}") + : $"Keine ganzen Fehltage seit {TermStart:dd.MM.}") +
(YearAbsencePeriodCount > 0
? $" · {PeriodLabel(YearAbsencePeriodCount)}" +
(YearUnexcusedPeriodCount > 0 ? $" ({YearUnexcusedPeriodCount} unentschuldigt)" : "")
: "") +
(YearLateDayCount > 0 ? $" · {YearLateDayCount} Tage verspätet (zählt nicht zur Quote)" : "") + (YearLateDayCount > 0 ? $" · {YearLateDayCount} Tage verspätet (zählt nicht zur Quote)" : "") +
(YearNegativeClassRegisterCount > 0 ? $" · {YearNegativeClassRegisterCount} negative Klassenbucheinträge" : "") + (YearNegativeClassRegisterCount > 0 ? $" · {YearNegativeClassRegisterCount} negative Klassenbucheinträge" : "") +
(HasSuspensionEntry ? " · Suspendierung vermerkt" : "") + (HasSuspensionEntry ? " · Suspendierung vermerkt" : "") +
(HolidayWeekdaysExcluded > 0 ? $" · {HolidayWeekdaysExcluded} Ferientage abgezogen" : ""); (HolidayWeekdaysExcluded > 0 ? $" · {HolidayWeekdaysExcluded} Ferientage abgezogen" : "");
private static string PeriodLabel(int count) =>
$"{count} Fehlstunde{(count == 1 ? "" : "n")}";
private static readonly string[] ConcerningKeywords = ["hausaufgabe", "mitarbeit"]; private static readonly string[] ConcerningKeywords = ["hausaufgabe", "mitarbeit"];
private static readonly string[] SuspensionKeywords = ["suspendier"]; private static readonly string[] SuspensionKeywords = ["suspendier"];
@@ -238,8 +249,10 @@ public sealed record ClassTeacherRosterRow(string StudentName, int? ExternKey, b
var attendanceCutoff = cutoffFor(VorgangScoreDomain.Attendance); var attendanceCutoff = cutoffFor(VorgangScoreDomain.Attendance);
var latenessCutoff = cutoffFor(VorgangScoreDomain.Lateness); var latenessCutoff = cutoffFor(VorgangScoreDomain.Lateness);
var classbookCutoff = cutoffFor(VorgangScoreDomain.Classbook); var classbookCutoff = cutoffFor(VorgangScoreDomain.Classbook);
var unexcused = yearEntries.Count(r => r.IsUnexcused && r.Date >= attendanceCutoff); var unexcused = yearEntries.Where(r => r.IsUnexcused && r.Date >= attendanceCutoff)
var excused = yearEntries.Count(r => !r.IsUnexcused && !r.IsLate && r.Date >= attendanceCutoff); .Sum(r => r.AbsenceDayEquivalentForScoring);
var excused = yearEntries.Where(r => !r.IsUnexcused && !r.IsLate && r.Date >= attendanceCutoff)
.Sum(r => r.AbsenceDayEquivalentForScoring);
var late = yearEntries.Count(r => !r.IsUnexcused && r.IsLate && r.Date >= latenessCutoff); var late = yearEntries.Count(r => !r.IsUnexcused && r.IsLate && r.Date >= latenessCutoff);
var classRegister = yearRegisterEntries var classRegister = yearRegisterEntries
.Where(e => TryDate(e.Date, out var d) && d >= classbookCutoff) .Where(e => TryDate(e.Date, out var d) && d >= classbookCutoff)
@@ -314,13 +327,17 @@ public sealed record ClassTeacherRosterRow(string StudentName, int? ExternKey, b
{ {
TodayAbsence = absence, TodayAbsence = absence,
HasClassRegisterToday = registerEntries.Any(e => TryDate(e.Date, out var date) && date == referenceDate), HasClassRegisterToday = registerEntries.Any(e => TryDate(e.Date, out var date) && date == referenceDate),
// Unentschuldigt vor Verspätet vor Entschuldigt, überschneidungsfrei — dieselbe // Ganze Fehltage und stundenweises Fehlen bleiben getrennt. Insbesondere macht
// Kategorisierung wie im Wochentrend (BuildTrend). Nur Verspätung (nicht auch // "unentschuldigt" aus einer einzelnen Fehlstunde keinen ganzen Fehltag.
// unentschuldigt) fällt bewusst aus YearAbsenceDayCount heraus, siehe dort. YearAbsenceDayCount = yearEntries.Count(r => !r.IsLate && r.CountsAsFullDay),
YearAbsenceDayCount = yearEntries.Count(r => r.IsUnexcused || !r.IsLate), YearUnexcusedDayCount = yearEntries.Count(r => !r.IsLate && r.CountsAsFullDay && r.IsUnexcused),
YearUnexcusedDayCount = yearEntries.Count(r => r.IsUnexcused), YearAbsencePeriodCount = yearEntries.Where(r => r.IsPartialAbsence).Sum(r => r.TotalAbsentPeriods),
YearUnexcusedPeriodCount = yearEntries.Where(r => r.IsPartialAbsence && r.IsUnexcused)
.Sum(r => r.TotalAbsentPeriods),
YearExcusedPeriodCount = yearEntries.Where(r => r.IsPartialAbsence && !r.IsUnexcused)
.Sum(r => r.TotalAbsentPeriods),
YearLateDayCount = yearEntries.Count(r => !r.IsUnexcused && r.IsLate), YearLateDayCount = yearEntries.Count(r => !r.IsUnexcused && r.IsLate),
YearExcusedDayCount = yearEntries.Count(r => !r.IsUnexcused && !r.IsLate), YearExcusedDayCount = yearEntries.Count(r => !r.IsUnexcused && !r.IsLate && r.CountsAsFullDay),
YearNegativeClassRegisterCount = yearRegisterEntries.Count(IsNegativeClassRegisterEntry), YearNegativeClassRegisterCount = yearRegisterEntries.Count(IsNegativeClassRegisterEntry),
HasSuspensionEntry = yearRegisterEntries.Any(e => MatchesAnyKeyword(e, SuspensionKeywords)), HasSuspensionEntry = yearRegisterEntries.Any(e => MatchesAnyKeyword(e, SuspensionKeywords)),
ClassRegisterScoreComponent = yearRegisterEntries.Sum(e => ClassRegisterEntryWeight(e, effectiveWeights)), ClassRegisterScoreComponent = yearRegisterEntries.Sum(e => ClassRegisterEntryWeight(e, effectiveWeights)),
@@ -1017,12 +1034,17 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
var displayName = displayNamesByKey.GetValueOrDefault(group.Key) ?? rows[0].StudentDisplayName; var displayName = displayNamesByKey.GetValueOrDefault(group.Key) ?? rows[0].StudentDisplayName;
var weekRows = rows.Where(row => row.Date >= sevenDayStart).ToList(); var weekRows = rows.Where(row => row.Date >= sevenDayStart).ToList();
var lateDaysWeek = weekRows.Count(row => row.IsLate); var lateDaysWeek = weekRows.Count(row => row.IsLate);
var unexcusedDaysWeek = weekRows.Count(row => row.IsUnexcused && !row.IsLate); var unexcusedDaysWeek = weekRows.Count(row => row.IsUnexcused && !row.IsLate && row.CountsAsFullDay);
var unexcusedPartialWeek = weekRows.Count(row => row.IsUnexcused && row.IsPartialAbsence);
var lateDaysYear = rows.Count(row => row.IsLate); var lateDaysYear = rows.Count(row => row.IsLate);
if (unexcusedDaysWeek >= 2) if (unexcusedDaysWeek >= 2)
notices.Add(new ClassTeacherPatternNotice(displayName, notices.Add(new ClassTeacherPatternNotice(displayName,
$"{unexcusedDaysWeek} unentschuldigte Fehltage in 7 Tagen", ClassTeacherStatusKind.Danger)); $"{unexcusedDaysWeek} unentschuldigte Fehltage in 7 Tagen", ClassTeacherStatusKind.Danger));
else if (unexcusedPartialWeek >= 2)
notices.Add(new ClassTeacherPatternNotice(displayName,
$"{unexcusedPartialWeek} stundenweise unentschuldigte Fehlzeiten in 7 Tagen",
ClassTeacherStatusKind.Warning));
else if (lateDaysYear >= lateYearEscalationThreshold) else if (lateDaysYear >= lateYearEscalationThreshold)
notices.Add(new ClassTeacherPatternNotice(displayName, notices.Add(new ClassTeacherPatternNotice(displayName,
$"{lateDaysYear} Verspätungen seit Schuljahresbeginn – Elterngespräch oder Brief erwägen", $"{lateDaysYear} Verspätungen seit Schuljahresbeginn – Elterngespräch oder Brief erwägen",
@@ -1157,7 +1179,8 @@ public partial class ClassTeacherOverviewViewModel : ObservableObject
.Where(s => s is not null) .Where(s => s is not null)
.Select(s => s!.Id) .Select(s => s!.Id)
.ToHashSet(); .ToHashSet();
var docs = _documentation.GetAll().Where(d => !d.IsDeleted && matchedIds.Contains(d.StudentId)).ToList(); var docs = _documentation.GetAll()
.Where(d => !d.IsDeleted && d.InvolvedStudentIds().Any(matchedIds.Contains)).ToList();
OwnDocumentationFollowUpCount = docs.Count(d => d.IsDraft); OwnDocumentationFollowUpCount = docs.Count(d => d.IsDraft);
OwnDocumentationCriticalCount = docs.Count(d => OwnDocumentationCriticalCount = docs.Count(d =>
d.Tags.Any(t => string.Equals(t, "Kritisch", StringComparison.OrdinalIgnoreCase))); d.Tags.Any(t => string.Equals(t, "Kritisch", StringComparison.OrdinalIgnoreCase)));
@@ -296,6 +296,7 @@ public partial class GroupOverviewViewModel : ObservableObject
{ {
DraftDocumentationCount = _students.GetByGroup(_groupId) DraftDocumentationCount = _students.GetByGroup(_groupId)
.SelectMany(s => _documentation.GetByStudent(s.Id)) .SelectMany(s => _documentation.GetByStudent(s.Id))
.DistinctBy(d => d.Id)
.Count(d => d.IsDraft && (d.GroupId is null || d.GroupId == _groupId)); .Count(d => d.IsDraft && (d.GroupId is null || d.GroupId == _groupId));
} }
@@ -313,7 +313,8 @@ public partial class SeatingPlanTabViewModel : ObservableObject
} }
entries.TryGetValue(studentId, out var entry); entries.TryGetValue(studentId, out var entry);
var tags = _documentation?.GetByStudent(studentId) var tags = _documentation?.GetByStudent(studentId)
.FirstOrDefault(d => d.IsDraft && d.ParticipationSessionId == SelectedSession.Id)?.Tags ?? []; .FirstOrDefault(d => d.IsDraft && d.StudentId == studentId && d.ParticipationSessionId == SelectedSession.Id)
?.Tags ?? [];
seat.SetLessonData(entry, tags); seat.SetLessonData(entry, tags);
} }
} }
@@ -340,8 +341,10 @@ public partial class SeatingPlanTabViewModel : ObservableObject
seat.SelectedOption.StudentId is not Guid studentId) return; seat.SelectedOption.StudentId is not Guid studentId) return;
var session = EnsureTodaySession(); var session = EnsureTodaySession();
if (session is null) return; if (session is null) return;
// Nur Entwürfe mit dieser Person als Hauptperson — ein gemeinsamer Eintrag (weitere Beteiligte)
// ist keine persönliche Sitzplan-Notiz.
var draft = _documentation.GetByStudent(studentId) var draft = _documentation.GetByStudent(studentId)
.FirstOrDefault(d => d.IsDraft && d.ParticipationSessionId == session.Id); .FirstOrDefault(d => d.IsDraft && d.StudentId == studentId && d.ParticipationSessionId == session.Id);
if (draft is null) if (draft is null)
{ {
draft = new Documentation draft = new Documentation
@@ -36,8 +36,8 @@ public partial class SettingsViewModel
var cutoff = _privacy.RetentionCutoff(); var cutoff = _privacy.RetentionCutoff();
foreach (var d in _documentation.GetAll().Where(d => d.CreatedAt < cutoff)) foreach (var d in _documentation.GetAll().Where(d => d.CreatedAt < cutoff))
{ {
var student = _students.GetById(d.StudentId); var names = d.InvolvedStudentIds().Select(id => _students.GetById(id)?.FullName ?? "?").ToList();
ExpiredDocuments.Add(new ExpiredDocumentItem(d, student?.FullName ?? "?")); ExpiredDocuments.Add(new ExpiredDocumentItem(d, names.Count > 0 ? string.Join("; ", names) : "?"));
} }
} }
@@ -104,6 +104,12 @@ public partial class DocumentationDialogViewModel : ObservableObject
[ObservableProperty] private StudentOption? _selectedStudent; [ObservableProperty] private StudentOption? _selectedStudent;
[ObservableProperty] private string _studentError = ""; [ObservableProperty] private string _studentError = "";
// Weitere Beteiligte (Documentation.AdditionalStudentIds) — nur angeboten, wenn der Aufrufer
// Kandidaten mitgibt (z.B. die übrigen Schüler*innen eines Vorgangs). Die Hauptperson steht
// mit in der Liste, wird aber ausgeblendet (CoStudentChoice.IsPrimary).
public List<CoStudentChoice> CoStudents { get; }
public bool HasCoStudents => CoStudents.Any(c => !c.IsPrimary);
[ObservableProperty] private string _typeName = DocumentationTypeDisplay.Options[0]; [ObservableProperty] private string _typeName = DocumentationTypeDisplay.Options[0];
[ObservableProperty] private string _dateText = DateOnly.FromDateTime(DateTime.Today).ToString("dd.MM.yyyy"); [ObservableProperty] private string _dateText = DateOnly.FromDateTime(DateTime.Today).ToString("dd.MM.yyyy");
[ObservableProperty] private string _title = ""; [ObservableProperty] private string _title = "";
@@ -163,8 +169,11 @@ public partial class DocumentationDialogViewModel : ObservableObject
public Documentation? Result { get; private set; } public Documentation? Result { get; private set; }
/// <param name="coStudentOptions">Kandidaten für "Betrifft außerdem" — ohne Angabe bleiben
/// bestehende weitere Beteiligte eines bearbeiteten Eintrags unverändert erhalten.</param>
public DocumentationDialogViewModel(Guid studentId, Documentation? editing, IAttachmentStorage attachmentStorage, public DocumentationDialogViewModel(Guid studentId, Documentation? editing, IAttachmentStorage attachmentStorage,
List<StudentOption>? studentOptions = null, Guid? contextGroupId = null, bool isNewDraft = false) List<StudentOption>? studentOptions = null, Guid? contextGroupId = null, bool isNewDraft = false,
List<StudentOption>? coStudentOptions = null)
{ {
_studentId = studentId; _studentId = studentId;
_editing = editing; _editing = editing;
@@ -174,8 +183,17 @@ public partial class DocumentationDialogViewModel : ObservableObject
_attachmentStorage = attachmentStorage; _attachmentStorage = attachmentStorage;
_contextGroupId = contextGroupId; _contextGroupId = contextGroupId;
StudentOptions = studentOptions ?? []; StudentOptions = studentOptions ?? [];
CoStudents = (coStudentOptions ?? [])
.Where(o => o.Id != Guid.Empty)
.DistinctBy(o => o.Id)
.Select(o => new CoStudentChoice(o.Id, o.Name)
{
IsSelected = editing?.AdditionalStudentIds.Contains(o.Id) == true,
})
.ToList();
if (CanPickStudent) if (CanPickStudent)
SelectedStudent = StudentOptions.FirstOrDefault(s => s.Id == studentId); SelectedStudent = StudentOptions.FirstOrDefault(s => s.Id == studentId);
UpdatePrimaryCoStudent();
if (editing is null) return; if (editing is null) return;
TypeName = DocumentationTypeDisplay.Label(editing.Type); TypeName = DocumentationTypeDisplay.Label(editing.Type);
@@ -212,6 +230,22 @@ public partial class DocumentationDialogViewModel : ObservableObject
foreach (var tag in editing.Tags) Tags.Add(tag); foreach (var tag in editing.Tags) Tags.Add(tag);
} }
// Beim Bearbeiten bleibt die Hauptperson die des bestehenden Eintrags (Save() übernimmt die
// Auswahl dann nicht), sonst folgt sie der Bezug-Auswahl.
private Guid PrimaryStudentId =>
_editing is not null && !_isNewDraft ? _editing.StudentId
: CanPickStudent ? SelectedStudent?.Id ?? Guid.Empty
: _editing?.StudentId ?? _studentId;
partial void OnSelectedStudentChanged(StudentOption? value) => UpdatePrimaryCoStudent();
private void UpdatePrimaryCoStudent()
{
var primary = PrimaryStudentId;
foreach (var c in CoStudents) c.IsPrimary = c.Id == primary;
OnPropertyChanged(nameof(HasCoStudents));
}
partial void OnTypeNameChanged(string value) partial void OnTypeNameChanged(string value)
{ {
OnPropertyChanged(nameof(IsConversation)); OnPropertyChanged(nameof(IsConversation));
@@ -348,6 +382,14 @@ public partial class DocumentationDialogViewModel : ObservableObject
var type = DocumentationTypeDisplay.FromLabel(TypeName); var type = DocumentationTypeDisplay.FromLabel(TypeName);
var effectiveStudentId = CanPickStudent ? SelectedStudent!.Id : _studentId; var effectiveStudentId = CanPickStudent ? SelectedStudent!.Id : _studentId;
Result = _editing ?? new Documentation { StudentId = effectiveStudentId, GroupId = _contextGroupId }; Result = _editing ?? new Documentation { StudentId = effectiveStudentId, GroupId = _contextGroupId };
// Nicht angebotene weitere Beteiligte bleiben erhalten (z.B. beim Bearbeiten aus dem Schülerdatensatz,
// wo keine Kandidaten bekannt sind), angebotene folgen der Auswahl.
var offered = CoStudents.Select(c => c.Id).ToHashSet();
Result.AdditionalStudentIds = Result.AdditionalStudentIds.Where(id => !offered.Contains(id))
.Concat(CoStudents.Where(c => c.IsSelected).Select(c => c.Id))
.Where(id => id != Result.StudentId && id != Guid.Empty)
.Distinct()
.ToList();
Result.Type = type; Result.Type = type;
Result.Date = date; Result.Date = date;
Result.Title = Title.Trim(); Result.Title = Title.Trim();
@@ -413,6 +455,14 @@ public partial class DocumentationDialogViewModel : ObservableObject
} }
} }
public partial class CoStudentChoice(Guid id, string name) : ObservableObject
{
public Guid Id { get; } = id;
public string Name { get; } = name;
[ObservableProperty] private bool _isSelected;
[ObservableProperty] private bool _isPrimary;
}
public class AttachmentItem(string storageId, string fileName, long sizeBytes, DateTime uploadedAt) public class AttachmentItem(string storageId, string fileName, long sizeBytes, DateTime uploadedAt)
{ {
public const string HazardAssessmentSuffix = ".gbu.json"; public const string HazardAssessmentSuffix = ".gbu.json";
@@ -458,6 +508,10 @@ public partial class DocumentationItem : ObservableObject
public string OtherGroupLabel { get; } public string OtherGroupLabel { get; }
/// Dimmt Einträge aus anderen Lerngruppen im Gruppen-Tab, ohne sie zu verstecken. /// Dimmt Einträge aus anderen Lerngruppen im Gruppen-Tab, ohne sie zu verstecken.
public double ContentOpacity => IsOwnGroup ? 1.0 : 0.55; public double ContentOpacity => IsOwnGroup ? 1.0 : 0.55;
/// Nur im Schülerdatensatz gefüllt: die übrigen Beteiligten eines gemeinsamen Eintrags
/// (Documentation.AdditionalStudentIds bzw. Hauptperson), damit er dort als geteilt erkennbar ist.
public string SharedWith { get; init; } = "";
public bool IsShared => SharedWith != "";
[ObservableProperty] private bool _isRevealed; [ObservableProperty] private bool _isRevealed;
@@ -334,7 +334,12 @@ public partial class StudentDetailViewModel : ObservableObject
if (Student is null) return; if (Student is null) return;
Documentation.Clear(); Documentation.Clear();
foreach (var d in _docs.GetByStudent(Student.Id)) foreach (var d in _docs.GetByStudent(Student.Id))
Documentation.Add(new DocumentationItem(d)); {
var others = d.InvolvedStudentIds().Where(id => id != Student.Id)
.Select(id => _students.GetById(id)?.FullName)
.Where(n => !string.IsNullOrEmpty(n));
Documentation.Add(new DocumentationItem(d) { SharedWith = string.Join("; ", others) });
}
} }
[RelayCommand] [RelayCommand]
@@ -39,7 +39,8 @@ public partial class StudentVorgaengeViewModel : ObservableObject
public Func<List<StudentOption>, Vorgang?, Task<Vorgang?>>? OnEditVorgang { get; set; } public Func<List<StudentOption>, Vorgang?, Task<Vorgang?>>? OnEditVorgang { get; set; }
public Func<VorgangItem, Task<bool>>? OnConfirmDeleteVorgang { get; set; } public Func<VorgangItem, Task<bool>>? OnConfirmDeleteVorgang { get; set; }
public Func<Guid, Documentation?, Task<Documentation?>>? OnEditDocumentation { get; set; } /// Parameter: Hauptperson, Kandidaten für "Betrifft außerdem", bestehender Eintrag.
public Func<Guid, List<StudentOption>, Documentation?, Task<Documentation?>>? OnEditDocumentation { get; set; }
/// Rückfrage vor dem automatischen Anlegen eines Vorgangs aus einer Dashboard-Warnung heraus /// Rückfrage vor dem automatischen Anlegen eines Vorgangs aus einer Dashboard-Warnung heraus
/// (siehe <see cref="HandleWarningNavigation"/>) — Parameter ist das gesuchte Tag. /// (siehe <see cref="HandleWarningNavigation"/>) — Parameter ist das gesuchte Tag.
public Func<string, Task<bool>>? OnConfirmCreateForWarning { get; set; } public Func<string, Task<bool>>? OnConfirmCreateForWarning { get; set; }
@@ -89,8 +90,8 @@ public partial class StudentVorgaengeViewModel : ObservableObject
IEnumerable<Vorgang> vorgaenge = _vorgaenge.GetByStudent(studentId); IEnumerable<Vorgang> vorgaenge = _vorgaenge.GetByStudent(studentId);
if (OnlyOpen) vorgaenge = vorgaenge.Where(v => v.Status == VorgangStatus.Open); if (OnlyOpen) vorgaenge = vorgaenge.Where(v => v.Status == VorgangStatus.Open);
// Nur die Dokumentation dieses einen Schülers (nicht GetAll()) — dieses Panel ist die Sicht // Nur die Dokumentation, die diesen Schüler betrifft (nicht GetAll()) — dieses Panel ist die
// "von diesem Schüler aus", nicht Vorgangsverwaltung für mehrere Beteiligte. // Sicht "von diesem Schüler aus"; gemeinsame Einträge mit weiteren Beteiligten zählen dazu.
var ownDocs = _documentation.GetByStudent(studentId); var ownDocs = _documentation.GetByStudent(studentId);
foreach (var vorgang in vorgaenge.OrderByDescending(v => v.UpdatedAt)) foreach (var vorgang in vorgaenge.OrderByDescending(v => v.UpdatedAt))
@@ -107,9 +108,9 @@ public partial class StudentVorgaengeViewModel : ObservableObject
var linkedIds = vorgang.DocumentationIds.ToHashSet(); var linkedIds = vorgang.DocumentationIds.ToHashSet();
foreach (var doc in ownDocs.Where(d => linkedIds.Contains(d.Id))) foreach (var doc in ownDocs.Where(d => linkedIds.Contains(d.Id)))
item.LinkedDocumentation.Add(new DocumentationItem(doc, _studentName)); item.LinkedDocumentation.Add(new DocumentationItem(doc, InvolvedNames(doc)));
foreach (var doc in ClassTeacherCasesViewModel.FilterAvailableDocumentation(ownDocs, vorgang)) foreach (var doc in ClassTeacherCasesViewModel.FilterAvailableDocumentation(ownDocs, vorgang))
item.AvailableDocumentation.Add(new DocumentationItem(doc, _studentName)); item.AvailableDocumentation.Add(new DocumentationItem(doc, InvolvedNames(doc)));
foreach (var entry in vorgang.ClassRegisterEntries.OrderByDescending(e => e.Date)) foreach (var entry in vorgang.ClassRegisterEntries.OrderByDescending(e => e.Date))
item.ClassRegisterRows.Add(new VorgangClassRegisterEntryRow(entry)); item.ClassRegisterRows.Add(new VorgangClassRegisterEntryRow(entry));
@@ -118,6 +119,27 @@ public partial class StudentVorgaengeViewModel : ObservableObject
OnPropertyChanged(nameof(HasCases)); OnPropertyChanged(nameof(HasCases));
} }
private string StudentName(Guid id) => id == _studentId ? _studentName : _students.GetById(id)?.FullName ?? "";
private string InvolvedNames(Documentation doc) =>
string.Join(", ", doc.InvolvedStudentIds().Select(StudentName).Where(n => n != ""));
private List<StudentOption> VorgangStudentOptions(Vorgang vorgang) => vorgang.StudentIds
.Select(id => new StudentOption(id, StudentName(id)))
.Where(o => o.Name != "")
.ToList();
/// "Betrifft außerdem"-Kandidaten beim Bearbeiten: Beteiligte der angezeigten Vorgänge, in denen der
/// Eintrag verknüpft oder verknüpfbar ist, plus die schon Beteiligten.
private List<StudentOption> CoStudentOptionsFor(Documentation doc) => Cases.Select(c => c.Model)
.Where(v => v.DocumentationIds.Contains(doc.Id) || v.StudentIds.Any(doc.Concerns))
.SelectMany(v => v.StudentIds)
.Concat(doc.InvolvedStudentIds())
.Distinct()
.Select(id => new StudentOption(id, StudentName(id)))
.Where(o => o.Name != "")
.ToList();
[RelayCommand] [RelayCommand]
private async Task AddVorgang() private async Task AddVorgang()
{ {
@@ -161,7 +183,7 @@ public partial class StudentVorgaengeViewModel : ObservableObject
private async Task CreateAndLinkDocumentation(VorgangItem? item) private async Task CreateAndLinkDocumentation(VorgangItem? item)
{ {
if (item is null || OnEditDocumentation is null) return; if (item is null || OnEditDocumentation is null) return;
var result = await OnEditDocumentation(_studentId, null); var result = await OnEditDocumentation(_studentId, VorgangStudentOptions(item.Model), null);
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
item.Model.DocumentationIds.Add(result.Id); item.Model.DocumentationIds.Add(result.Id);
@@ -179,7 +201,7 @@ public partial class StudentVorgaengeViewModel : ObservableObject
if (draft is null) return; if (draft is null) return;
_documentationDraftId = draft.Id; _documentationDraftId = draft.Id;
Documentation? result; Documentation? result;
try { result = await OnEditDocumentation(_studentId, draft); } try { result = await OnEditDocumentation(_studentId, VorgangStudentOptions(item.Model), draft); }
finally { _documentationDraftId = null; } finally { _documentationDraftId = null; }
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
@@ -193,7 +215,7 @@ public partial class StudentVorgaengeViewModel : ObservableObject
private async Task EditDocumentation(DocumentationItem doc) private async Task EditDocumentation(DocumentationItem doc)
{ {
if (OnEditDocumentation is null) return; if (OnEditDocumentation is null) return;
var result = await OnEditDocumentation(doc.Model.StudentId, doc.Model); var result = await OnEditDocumentation(doc.Model.StudentId, CoStudentOptionsFor(doc.Model), doc.Model);
if (result is null) return; if (result is null) return;
_documentation.Save(result); _documentation.Save(result);
Load(_studentId); Load(_studentId);
@@ -106,7 +106,7 @@ public partial class WebUntisDocumentationComparisonViewModel : ObservableObject
// Nur nach Schüler*in+Datum erkannt, nicht nach Wortlaut: ein lokaler Eintrag von vor dieser // Nur nach Schüler*in+Datum erkannt, nicht nach Wortlaut: ein lokaler Eintrag von vor dieser
// Funktion (oder frei formuliert) hat selten denselben Titel wie die WebUntis-Kategorie. // Funktion (oder frei formuliert) hat selten denselben Titel wie die WebUntis-Kategorie.
List<Documentation> LocalDocsFor(Guid studentId, DateOnly date) => List<Documentation> LocalDocsFor(Guid studentId, DateOnly date) =>
localDocs.Where(d => d.StudentId == studentId && d.Date == date).ToList(); localDocs.Where(d => d.Concerns(studentId) && d.Date == date).ToList();
foreach (var (entry, date) in ordered) foreach (var (entry, date) in ordered)
{ {
@@ -128,16 +128,21 @@ public partial class WebUntisDocumentationComparisonViewModel : ObservableObject
}); });
} }
// WebUntis-Klassenbucheinträge sind personenbezogen — ein gemeinsamer lokaler Eintrag
// (weitere Beteiligte) wird deshalb je beteiligter Person einzeln abgeglichen.
foreach (var doc in localDocs) foreach (var doc in localDocs)
{ {
if (doc.ExcludeFromWebUntisSync) continue; if (doc.ExcludeFromWebUntisSync) continue;
var coveredByReport = Rows.Any(r => r.AssignedStudent?.Id == doc.StudentId && r.Date == doc.Date); foreach (var studentId in doc.InvolvedStudentIds())
{
var coveredByReport = Rows.Any(r => r.AssignedStudent?.Id == studentId && r.Date == doc.Date);
if (coveredByReport) continue; if (coveredByReport) continue;
var student = ownStudents.FirstOrDefault(s => s.Id == doc.StudentId); var student = ownStudents.FirstOrDefault(s => s.Id == studentId);
if (student is null) continue; if (student is null) continue;
LocalOnlyRows.Add(new LocalOnlyDocumentationRow(student.FullName, doc.Date, LocalOnlyRows.Add(new LocalOnlyDocumentationRow(student.FullName, doc.Date,
doc.GroupId is { } groupId ? _groups.GetById(groupId)?.Name : null, doc.Title, doc.Content)); doc.GroupId is { } groupId ? _groups.GetById(groupId)?.Name : null, doc.Title, doc.Content));
} }
}
var unresolved = Rows.Count(x => x.AssignedStudent is null); var unresolved = Rows.Count(x => x.AssignedStudent is null);
var possibleDuplicates = Rows.Count(x => x.ExistingLocalEntry is not null); var possibleDuplicates = Rows.Count(x => x.ExistingLocalEntry is not null);
@@ -51,7 +51,8 @@ public partial class ClassTeacherCasesView : UserControl
} }
private async Task<Documentation?> ShowDocumentationDialog( private async Task<Documentation?> ShowDocumentationDialog(
Guid defaultStudentId, List<StudentOption> studentOptions, Documentation? editing) Guid defaultStudentId, List<StudentOption> studentOptions, List<StudentOption> coStudentOptions,
Documentation? editing)
{ {
var owner = TopLevel.GetTopLevel(this) as Window; var owner = TopLevel.GetTopLevel(this) as Window;
if (owner is null) return null; if (owner is null) return null;
@@ -59,7 +60,8 @@ public partial class ClassTeacherCasesView : UserControl
var isNewDraft = editing is not null var isNewDraft = editing is not null
&& (DataContext as ClassTeacherCasesViewModel)?.IsNewDocumentationDraft(editing) == true; && (DataContext as ClassTeacherCasesViewModel)?.IsNewDocumentationDraft(editing) == true;
var vm = new DocumentationDialogViewModel(defaultStudentId, editing, var vm = new DocumentationDialogViewModel(defaultStudentId, editing,
App.Services.GetRequiredService<IAttachmentStorage>(), studentOptions, isNewDraft: isNewDraft); App.Services.GetRequiredService<IAttachmentStorage>(), studentOptions, isNewDraft: isNewDraft,
coStudentOptions: coStudentOptions);
var dialog = new DocumentationDialog { DataContext = vm }; var dialog = new DocumentationDialog { DataContext = vm };
var saved = await dialog.ShowDialog<bool>(owner); var saved = await dialog.ShowDialog<bool>(owner);
if (!saved) vm.DiscardUnsavedAttachments(); if (!saved) vm.DiscardUnsavedAttachments();
@@ -21,6 +21,20 @@
IsVisible="{Binding StudentError, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/> IsVisible="{Binding StudentError, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
</StackPanel> </StackPanel>
<StackPanel Spacing="4" IsVisible="{Binding HasCoStudents}">
<TextBlock Text="Betrifft außerdem" FontSize="12" Opacity="0.7"/>
<TextBlock Text="Der Eintrag wird nur einmal gespeichert, erscheint aber auch in der Dokumentation der hier angehakten Schüler*innen."
FontSize="11" Opacity="0.55" TextWrapping="Wrap"/>
<ItemsControl ItemsSource="{Binding CoStudents}">
<ItemsControl.ItemTemplate>
<DataTemplate x:DataType="vm:CoStudentChoice">
<CheckBox Content="{Binding Name}" IsChecked="{Binding IsSelected}"
IsVisible="{Binding !IsPrimary}"/>
</DataTemplate>
</ItemsControl.ItemTemplate>
</ItemsControl>
</StackPanel>
<Grid ColumnDefinitions="*,12,140"> <Grid ColumnDefinitions="*,12,140">
<StackPanel Grid.Column="0" Spacing="4"> <StackPanel Grid.Column="0" Spacing="4">
<TextBlock Text="Titel *" FontSize="12" Opacity="0.7"/> <TextBlock Text="Titel *" FontSize="12" Opacity="0.7"/>
@@ -299,6 +299,8 @@
<TextBlock Text="{Binding StatusLabel}" FontSize="11" Opacity="0.55" <TextBlock Text="{Binding StatusLabel}" FontSize="11" Opacity="0.55"
IsVisible="{Binding StatusLabel, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/> IsVisible="{Binding StatusLabel, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
<TextBlock Text="📎 Anhang" FontSize="11" Opacity="0.55" IsVisible="{Binding HasAttachments}"/> <TextBlock Text="📎 Anhang" FontSize="11" Opacity="0.55" IsVisible="{Binding HasAttachments}"/>
<TextBlock Text="{Binding SharedWith, StringFormat='👥 gemeinsam mit {0}'}" FontSize="11"
Opacity="0.55" TextWrapping="Wrap" IsVisible="{Binding IsShared}"/>
</StackPanel> </StackPanel>
<ItemsControl ItemsSource="{Binding TagChips}" IsVisible="{Binding IsRevealed}"> <ItemsControl ItemsSource="{Binding TagChips}" IsVisible="{Binding IsRevealed}">
<ItemsControl.ItemsPanel> <ItemsControl.ItemsPanel>
@@ -105,7 +105,8 @@ public partial class StudentDetailView : UserControl
var info = new ConfirmDialogInfo var info = new ConfirmDialogInfo
{ {
Title = "Eintrag löschen?", Title = "Eintrag löschen?",
Message = $"\"{item.Model.Title}\" wird als gelöscht markiert und nicht mehr angezeigt.", Message = $"\"{item.Model.Title}\" wird als gelöscht markiert und nicht mehr angezeigt." +
(item.IsShared ? $" Der Eintrag verschwindet auch bei {item.SharedWith}." : ""),
ConfirmText = "Löschen", ConfirmText = "Löschen",
}; };
var dialog = new ConfirmDialog { DataContext = info }; var dialog = new ConfirmDialog { DataContext = info };
@@ -52,7 +52,8 @@ public partial class StudentVorgaengeTabView : UserControl
return owner is not null && await dialog.ShowDialog<bool>(owner); return owner is not null && await dialog.ShowDialog<bool>(owner);
} }
private async Task<Documentation?> ShowDocumentationDialog(Guid studentId, Documentation? editing) private async Task<Documentation?> ShowDocumentationDialog(
Guid studentId, List<StudentOption> coStudentOptions, Documentation? editing)
{ {
var owner = TopLevel.GetTopLevel(this) as Window; var owner = TopLevel.GetTopLevel(this) as Window;
if (owner is null) return null; if (owner is null) return null;
@@ -60,7 +61,8 @@ public partial class StudentVorgaengeTabView : UserControl
var isNewDraft = editing is not null var isNewDraft = editing is not null
&& (DataContext as StudentVorgaengeViewModel)?.IsNewDocumentationDraft(editing) == true; && (DataContext as StudentVorgaengeViewModel)?.IsNewDocumentationDraft(editing) == true;
var vm = new DocumentationDialogViewModel(studentId, editing, var vm = new DocumentationDialogViewModel(studentId, editing,
App.Services.GetRequiredService<IAttachmentStorage>(), isNewDraft: isNewDraft); App.Services.GetRequiredService<IAttachmentStorage>(), isNewDraft: isNewDraft,
coStudentOptions: coStudentOptions);
var dialog = new DocumentationDialog { DataContext = vm }; var dialog = new DocumentationDialog { DataContext = vm };
var saved = await dialog.ShowDialog<bool>(owner); var saved = await dialog.ShowDialog<bool>(owner);
if (!saved) vm.DiscardUnsavedAttachments(); if (!saved) vm.DiscardUnsavedAttachments();
+25
View File
@@ -2050,6 +2050,31 @@ eigenen Unterricht abfragt und deshalb mit den regulären Lehrkraft-Rechten funk
`ClassTeacherStudentFacts.TemplateContext`). Vorlagen im Klassenlehrer-Tab beziehen sich auf `ClassTeacherStudentFacts.TemplateContext`). Vorlagen im Klassenlehrer-Tab beziehen sich auf
die/den erste/n Beteiligte/n des Vorgangs, der Dokumentations-Dialog bietet dann nur diese Person die/den erste/n Beteiligte/n des Vorgangs, der Dokumentations-Dialog bietet dann nur diese Person
an (sonst passten die eingesetzten Zahlen nicht zur gewählten Person). an (sonst passten die eingesetzten Zahlen nicht zur gewählten Person).
- [x] **Vorgang mit mehreren Beteiligten — gemeinsame Dokumentation (September 2026):** Nutzer-
Feedback: ein Vorgang kann mehrere Schüler*innen umfassen, ein `Documentation`-Eintrag gehörte aber
immer genau einer Person — wer einen gemeinsamen Eintrag (z.B. Gespräch mit beiden
Streitparteien) bei jeder Person im Dokumentations-Tab sehen wollte, musste ihn mehrfach mit
identischem Inhalt anlegen. **Nutzer-Entscheidung: ein Eintrag, mehrere Personen** (statt
automatischer unabhängiger Kopien). `Documentation` bekommt `AdditionalStudentIds` (weitere
Beteiligte; `StudentId` bleibt Hauptperson, damit bestehende Daten, Sync-Events und Gruppeneinträge
mit `Guid.Empty` unverändert gelten) sowie `Concerns(id)`/`InvolvedStudentIds()` als einzige Regel
für "betrifft diese Person". `DocumentationRepository.GetByStudent`/`GetByStudentAndType` filtern
danach (im Speicher statt als LiteDB-Ausdruck), dadurch erscheint der Eintrag automatisch im
Dokumentations-Tab jeder beteiligten Person, im schülerbezogenen Vorgänge-Tab und im
Personendaten-Export. `GetReferenceSummary` zählt gemeinsame Einträge mit, damit eine beteiligte
Person nicht hart gelöscht werden kann (sonst bliebe eine verwaiste ID zurück).
Der `DocumentationDialog` hat einen neuen Bereich **"Betrifft außerdem"** (Checkboxen, optionaler
Parameter `coStudentOptions`, Hauptperson ausgeblendet). Angeboten wird er nur aus den beiden
Vorgänge-Tabs heraus, mit den Beteiligten des Vorgangs (beim Bearbeiten: Beteiligte aller
angezeigten Vorgänge, in denen der Eintrag verknüpft oder verknüpfbar ist). Beim Bearbeiten ohne
Kandidatenliste (z.B. aus dem Schülerdatensatz) bleiben bestehende weitere Beteiligte erhalten,
abgewählt werden nur angebotene. Im Schülerdatensatz zeigt ein gemeinsamer Eintrag
"👥 gemeinsam mit …", und die Lösch-Rückfrage weist darauf hin, dass er auch bei den anderen
verschwindet. Mitgezogen: Klassenlehrer-Dokumentationsliste und -Zähler, "verknüpfbare"
Dokumentation im Vorgang, WebUntis-Abgleich (gemeinsamer Eintrag wird je beteiligter Person
abgeglichen, da WebUntis-Klassenbucheinträge personenbezogen sind), Löschfristen-Liste (alle Namen).
**Bewusst unverändert:** Sitzplan-Entwürfe bleiben persönliche Notizen (nur Hauptperson), der
Gruppen-Dokumentations-Tab bietet (noch) keine weiteren Beteiligten an.
**Nachtrag zu 4.3, Bugfix Wochennavigation (September 2026):** Nutzer-Feedback: beim Planen der **Nachtrag zu 4.3, Bugfix Wochennavigation (September 2026):** Nutzer-Feedback: beim Planen der
nächsten Woche musste nach jedem kurzen Abstecher in einen anderen Bereich der Sidebar wieder nächsten Woche musste nach jedem kurzen Abstecher in einen anderen Bereich der Sidebar wieder