Schülerdokumentation: Einträge, Fehlzeitenbilanz, Datenschutz (Kapitel 5)

Dokumentationseinträge mit Typwahl (Gespräch, Vorkommnis, Förderplan, Fehlzeit, Elternanruf, Elternbrief), vertrauliche Einträge nur nach Bestätigung sichtbar, weiche Löschung mit Nachvollziehbarkeit. Fehlzeiten als Auswertung des bestehenden Anwesenheits-Trackings statt zweiter Erfassung, mit Schwellenwert-Warnung im Schülerdetail und Dashboard. Förderplan-Wiedervorlage als Dashboard-Karte. Datenschutz: Löschfristen mit manueller Bereinigung und DSGVO-Art.-15-Datenauskunft als Export. Auf Nutzer-Feedback hin ergänzt: Elternanruf mit begleitendem Gesprächsprotokoll-Dialog (Punkte abhaken, Eindrücke festhalten), Elternbrief mit Versand-/Rückmeldungs-Tracking, Datei-Anhänge über LiteDBs Dateispeicher, frei vergebbare Labels zur Nachverfolgung mit Dringlichkeits-Farbcodierung, sowie eine sichtbare Farblegende für das bestehende Notenentwicklungs-Diagramm. Dabei einen Absturz behoben: leere Textfelder lieferten über das Binding null statt "", was beim Speichern eine NullReferenceException auslöste. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-13 17:49:03 +02:00
parent 629b8d1bf0
commit d987b93315
36 changed files with 2395 additions and 62 deletions
@@ -0,0 +1,206 @@
+using LehrerApp.Core.Models;
+using LehrerApp.Desktop.ViewModels.Students;
+using Xunit;
+
+namespace LehrerApp.Desktop.Tests;
+
+public sealed class DocumentationDialogViewModelTests
+{
+    [Fact]
+    public void Save_ContentIstNull_WirftNichtUndSpeichertLeerenText()
+    {
+        // Regression: Avalonias TextBox.Text kann beim vollständigen Leeren des Felds über das
+        // Zwei-Wege-Binding null statt "" liefern (beobachtet bei einem Fehlzeit-Eintrag ohne
+        // Beschreibung) — Content.Trim() ohne Null-Schutz warf eine NullReferenceException.
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage())
+        {
+            Title = "Fehlt am Montag", TypeName = "Fehlzeit", Content = null!,
+        };
+
+        vm.SaveCommand.Execute(null);
+
+        Assert.NotNull(vm.Result);
+        Assert.Equal("", vm.Result!.Content);
+    }
+
+    [Fact]
+    public void Save_ElternbriefFelderSindNull_WirftNichtUndSpeichertLeerenText()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage())
+        {
+            Title = "Brief", TypeName = "Elternbrief",
+            LetterDraftContent = null!, LetterResponseNote = null!,
+        };
+
+        vm.SaveCommand.Execute(null);
+
+        Assert.NotNull(vm.Result);
+        Assert.Equal("", vm.Result!.ParentLetterData!.DraftContent);
+        Assert.Equal("", vm.Result.ParentLetterData.ResponseNote);
+    }
+
+    [Fact]
+    public void AddTag_NewTagIstNull_WirftNichtUndFuegtNichtsHinzu()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage())
+        {
+            NewTag = null!,
+        };
+
+        vm.AddTagCommand.Execute(null);
+
+        Assert.Empty(vm.Tags);
+    }
+
+    [Fact]
+    public void Save_UebernimmtHinzugefuegteLabelsUndVerhindertDuplikate()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage())
+        {
+            Title = "Vorfall im Unterricht", TypeName = "Vorkommnis",
+        };
+        vm.NewTag = "Kritisch";
+        vm.AddTagCommand.Execute(null);
+        vm.NewTag = "Kritisch"; // Duplikat, soll ignoriert werden
+        vm.AddTagCommand.Execute(null);
+        vm.NewTag = "Mit JGL abklären";
+        vm.AddTagCommand.Execute(null);
+
+        vm.SaveCommand.Execute(null);
+
+        Assert.Equal(["Kritisch", "Mit JGL abklären"], vm.Result!.Tags);
+    }
+
+    [Fact]
+    public void RemoveTag_EntferntDasLabelWiederAusDerListe()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage());
+        vm.NewTag = "Beobachten";
+        vm.AddTagCommand.Execute(null);
+
+        vm.RemoveTagCommand.Execute("Beobachten");
+
+        Assert.Empty(vm.Tags);
+    }
+
+    [Fact]
+    public void Save_Elternanruf_UebernimmtGeplanteGespraechspunkte()
+    {
+        var studentId = Guid.NewGuid();
+        var vm = new DocumentationDialogViewModel(studentId, null, new FakeAttachmentStorage())
+        {
+            Title = "Anruf wegen Hausaufgaben",
+            TypeName = "Elternanruf",
+        };
+        vm.NewCallPoint = "Hausaufgabensituation ansprechen";
+        vm.AddCallPointCommand.Execute(null);
+        vm.NewCallPoint = "Nächste Schritte vereinbaren";
+        vm.AddCallPointCommand.Execute(null);
+
+        vm.SaveCommand.Execute(null);
+
+        Assert.NotNull(vm.Result);
+        Assert.Equal(DocumentationType.ParentCall, vm.Result!.Type);
+        Assert.Equal(2, vm.Result.ParentCallData!.Points.Count);
+        Assert.All(vm.Result.ParentCallData.Points, p => Assert.False(p.IsDone));
+        Assert.False(vm.Result.ParentCallData.IsConducted);
+    }
+
+    [Fact]
+    public void Save_ElternanrufBearbeiten_BehaeltAbgehakteStatusFuerUnveraenderteePunkte()
+    {
+        var studentId = Guid.NewGuid();
+        var existing = new Documentation
+        {
+            StudentId = studentId,
+            Type = DocumentationType.ParentCall,
+            Title = "Anruf",
+            ParentCallData = new ParentCallData
+            {
+                Points = [new ParentCallPoint { Text = "Punkt A", IsDone = true }],
+                IsConducted = true,
+                ConductedDate = new DateOnly(2026, 1, 10),
+                Impressions = "Gut verlaufen",
+            },
+        };
+
+        var vm = new DocumentationDialogViewModel(studentId, existing, new FakeAttachmentStorage());
+        vm.NewCallPoint = "Punkt B";
+        vm.AddCallPointCommand.Execute(null);
+
+        vm.SaveCommand.Execute(null);
+
+        var points = vm.Result!.ParentCallData!.Points;
+        Assert.True(points.Single(p => p.Text == "Punkt A").IsDone);
+        Assert.False(points.Single(p => p.Text == "Punkt B").IsDone);
+        Assert.True(vm.Result.ParentCallData.IsConducted);
+        Assert.Equal("Gut verlaufen", vm.Result.ParentCallData.Impressions);
+    }
+
+    [Fact]
+    public void Save_Elternbrief_UebernimmtVersandUndRueckmeldung()
+    {
+        var studentId = Guid.NewGuid();
+        var vm = new DocumentationDialogViewModel(studentId, null, new FakeAttachmentStorage())
+        {
+            Title = "Brief wegen Verhalten",
+            TypeName = "Elternbrief",
+            LetterDraftContent = "Sehr geehrte...",
+            LetterSentDateText = "05.09.2025",
+            LetterResponseReceived = true,
+            LetterResponseDateText = "12.09.2025",
+            LetterResponseNote = "Termin vereinbart",
+        };
+
+        vm.SaveCommand.Execute(null);
+
+        var letter = vm.Result!.ParentLetterData!;
+        Assert.Equal(new DateOnly(2025, 9, 5), letter.SentDate);
+        Assert.True(letter.ResponseReceived);
+        Assert.Equal(new DateOnly(2025, 9, 12), letter.ResponseDate);
+        Assert.Equal("Termin vereinbart", letter.ResponseNote);
+    }
+
+    [Fact]
+    public void Save_UngueltigesDatumBeimElternbrief_SetztFehlerUndSpeichertNicht()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage())
+        {
+            Title = "Brief", TypeName = "Elternbrief", LetterSentDateText = "nicht-valide",
+        };
+
+        vm.SaveCommand.Execute(null);
+
+        Assert.Null(vm.Result);
+        Assert.NotEqual("", vm.LetterSentDateError);
+    }
+
+    [Fact]
+    public void AddAttachment_GroessereDateiAlsDasLimit_SetztFehlerUndFuegtNichtHinzu()
+    {
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, new FakeAttachmentStorage());
+        using var huge = new MemoryStream(new byte[LehrerApp.Core.Interfaces.IAttachmentStorage.MaxSizeBytes + 1]);
+
+        vm.AddAttachment("gross.bin", huge);
+
+        Assert.Empty(vm.Attachments);
+        Assert.NotEqual("", vm.AttachmentError);
+    }
+
+    [Fact]
+    public void DiscardUnsavedAttachments_EntferntNurNieGespeicherteAnhaenge()
+    {
+        var storage = new FakeAttachmentStorage();
+        var vm = new DocumentationDialogViewModel(Guid.NewGuid(), null, storage)
+        {
+            Title = "Brief", TypeName = "Elternbrief",
+        };
+        using var content = new MemoryStream([1, 2, 3]);
+        vm.AddAttachment("brief.pdf", content);
+        var storageId = vm.Attachments.Single().StorageId;
+
+        vm.DiscardUnsavedAttachments();
+
+        Assert.Null(storage.OpenRead(storageId));
+    }
+}
@@ -0,0 +1,23 @@
+using LehrerApp.Desktop.ViewModels.Students;
+using Xunit;
+
+namespace LehrerApp.Desktop.Tests;
+
+public sealed class DocumentationTagDisplayTests
+{
+    [Theory]
+    [InlineData("Kritisch", "#E53935")]
+    [InlineData("Erledigt", "#43A047")]
+    [InlineData("Beobachten", "#1E88E5")]
+    [InlineData("Mit JGL abklären", "#FB8C00")]
+    public void ColorHex_BekanntesLabel_GibtErwarteteFarbeZurueck(string tag, string expectedHex)
+    {
+        Assert.Equal(expectedHex, DocumentationTagDisplay.ColorHex(tag));
+    }
+
+    [Fact]
+    public void ColorHex_UnbekanntesLabel_GibtNeutraleFarbeZurueck()
+    {
+        Assert.Equal("#757575", DocumentationTagDisplay.ColorHex("Eigenes freies Label"));
+    }
+}
@@ -110,6 +110,44 @@ public class FakeSchemes : IGradingSchemeRepository
    public void Delete(Guid id) { }
 }

+public class FakeGroups(List<LearningGroup> all) : IGroupRepository
+{
+    public LearningGroup? GetById(Guid id) => all.FirstOrDefault(g => g.Id == id);
+    public List<LearningGroup> GetAll(bool includeInactive = false) => all;
+    public List<LearningGroup> GetBySchoolYear(string schoolYear, bool includeInactive = false) => all;
+    public void Save(LearningGroup group) { }
+    public void Delete(Guid id) { }
+}
+
+public class FakeDocumentation : IDocumentationRepository
+{
+    private readonly List<Documentation> _all = [];
+    public void Add(Documentation d) => _all.Add(d);
+    public List<Documentation> GetByStudent(Guid studentId) =>
+        _all.Where(d => d.StudentId == studentId && !d.IsDeleted).ToList();
+    public List<Documentation> GetByStudentAndType(Guid studentId, DocumentationType type) =>
+        _all.Where(d => d.StudentId == studentId && d.Type == type && !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 Delete(Guid id) { var d = _all.FirstOrDefault(x => x.Id == id); if (d is not null) d.IsDeleted = true; }
+    public void HardDelete(Guid id) => _all.RemoveAll(d => d.Id == id);
+}
+
+public class FakeAttachmentStorage : IAttachmentStorage
+{
+    private readonly Dictionary<string, byte[]> _blobs = [];
+    public string Upload(string fileName, Stream content)
+    {
+        using var ms = new MemoryStream();
+        content.CopyTo(ms);
+        var id = Guid.NewGuid().ToString("N");
+        _blobs[id] = ms.ToArray();
+        return id;
+    }
+    public Stream? OpenRead(string storageId) => _blobs.TryGetValue(storageId, out var b) ? new MemoryStream(b) : null;
+    public void Delete(string storageId) => _blobs.Remove(storageId);
+}
+
 public class FakeReportGrades : IReportGradeRepository
 {
    private readonly List<ReportGrade> _all = [];
@@ -0,0 +1,35 @@
+using LehrerApp.Core.Models;
+using LehrerApp.Desktop.ViewModels.Students;
+using Xunit;
+
+namespace LehrerApp.Desktop.Tests;
+
+public sealed class ParentCallSessionViewModelTests
+{
+    [Fact]
+    public void SaveProtocol_UebernimmtAbgehakteStatusUndEindruecke()
+    {
+        var pointId = Guid.NewGuid();
+        var documentation = new Documentation
+        {
+            Type = DocumentationType.ParentCall,
+            ParentCallData = new ParentCallData
+            {
+                Points = [new ParentCallPoint { Id = pointId, Text = "Hausaufgaben ansprechen" }],
+            },
+        };
+        var vm = new ParentCallSessionViewModel(documentation, "Anna Beispiel")
+        {
+            Impressions = "Eltern reagierten verständnisvoll.",
+        };
+        vm.Points.Single().IsDone = true;
+
+        vm.SaveProtocol();
+
+        Assert.NotNull(vm.Result);
+        Assert.True(vm.Result!.ParentCallData!.IsConducted);
+        Assert.Equal(DateOnly.FromDateTime(DateTime.Today), vm.Result.ParentCallData.ConductedDate);
+        Assert.True(vm.Result.ParentCallData.Points.Single(p => p.Id == pointId).IsDone);
+        Assert.Equal("Eltern reagierten verständnisvoll.", vm.Result.ParentCallData.Impressions);
+    }
+}
@@ -0,0 +1,45 @@
+using LehrerApp.Core.Models;
+using LehrerApp.Core.Services;
+using Xunit;
+
+namespace LehrerApp.Desktop.Tests;
+
+public sealed class PersonalDataExportServiceTests
+{
+    [Fact]
+    public void ExportAsJson_EnthaeltNotenMitarbeitUndDokumentationDesSchuelers()
+    {
+        var studentId = Guid.NewGuid();
+        var groupId = Guid.NewGuid();
+        var student = new Student { Id = studentId, FirstName = "Anna", LastName = "Beispiel" };
+
+        var students = new FakeStudents([student]);
+        var groups = new FakeGroups([new LearningGroup { Id = groupId, Name = "Q1 Chemie" }]);
+        var memberships = new FakeMemberships([new GroupMembership { StudentId = studentId, GroupId = groupId }]);
+        var grades = new FakeGrades();
+        grades.Add(new Grade { StudentId = studentId, GroupId = groupId, Value = "2", Category = GradeCategory.Oral });
+        var results = new FakeResults();
+        var entries = new FakeEntries();
+        entries.Add(new ParticipationEntry { StudentId = studentId, SessionId = Guid.NewGuid() });
+        var documentation = new FakeDocumentation();
+        documentation.Add(new Documentation { StudentId = studentId, Title = "Elterngespräch" });
+
+        var service = new PersonalDataExportService(students, groups, memberships, grades, results, entries, documentation);
+
+        var json = service.ExportAsJson(studentId);
+
+        Assert.Contains("Anna", json);
+        Assert.Contains("Elterngespräch", json);
+        Assert.Contains("\"Value\": \"2\"", json);
+    }
+
+    [Fact]
+    public void ExportAsJson_UnbekannterSchueler_WirftException()
+    {
+        var service = new PersonalDataExportService(
+            new FakeStudents([]), new FakeGroups([]), new FakeMemberships([]),
+            new FakeGrades(), new FakeResults(), new FakeEntries(), new FakeDocumentation());
+
+        Assert.Throws<InvalidOperationException>(() => service.ExportAsJson(Guid.NewGuid()));
+    }
+}