Add lesson attendance from presence (present/late/absent).

Co-authored-by: Cursor <cursoragent@cursor.com>

tests/HSchool.People.Tests/AttendanceMemoryTests.cs

@@ -0,0 +1,136 @@
+using HSchool.Content;
+
+namespace HSchool.People.Tests;
+
+public class AttendanceMemoryTests
+{
+    [Fact]
+    public void OverCeiling_DropsTheOldest()
+    {
+        var person = Blank("a");
+        var rules = Rules(max: 2);
+        var t0 = new DateTime(2012, 4, 3, 10, 0, 0, DateTimeKind.Utc);
+        Assert.True(AttendanceMemory.Record(person, "Mathematics", AttendanceStatuses.Present, t0, 1, rules));
+        Assert.True(AttendanceMemory.Record(person, "Literature", AttendanceStatuses.Late, t0.AddMinutes(1), 2, rules));
+        Assert.True(AttendanceMemory.Record(person, "History", AttendanceStatuses.Absent, t0.AddMinutes(2), 3, rules, AbsenceReasons.Truancy));
+
+        Assert.Equal(2, person.Attendance!.Count);
+        Assert.Equal("Literature", person.Attendance[0].Subject);
+        Assert.Equal("History", person.Attendance[1].Subject);
+        Assert.Equal(AbsenceReasons.Truancy, person.Attendance[1].AbsenceReason);
+    }
+
+    [Fact]
+    public void AbsentUpgradesToPresent_SameSlot()
+    {
+        var person = Blank("a");
+        var rules = Rules(max: 40);
+        var t0 = new DateTime(2012, 4, 3, 8, 30, 0, DateTimeKind.Utc);
+        Assert.True(AttendanceMemory.Record(person, "Mathematics", AttendanceStatuses.Absent, t0, 1, rules));
+        Assert.True(AttendanceMemory.Record(person, "Mathematics", AttendanceStatuses.Present, t0.AddMinutes(2), 1, rules));
+        Assert.Single(person.Attendance!);
+        Assert.Equal(AttendanceStatuses.Present, person.Attendance![0].Status);
+        Assert.Null(person.Attendance[0].AbsenceReason);
+    }
+
+    [Fact]
+    public void RosterJson_RoundTripsAttendance_AndOmitsEmpty()
+    {
+        var roster = Fixtures.Generate(Fixtures.Classrooms(4));
+        var pupil = roster.People.First(person => person.IsStudent && !person.IsParent);
+        var time = new DateTime(2012, 4, 3, 11, 20, 0, DateTimeKind.Utc);
+        AttendanceMemory.Record(pupil, "Mathematics", AttendanceStatuses.Late, time, period: 1, Rules(max: 40));
+
+        var json = RosterJson.Serialize(RosterDocument.From(1, roster));
+        Assert.Contains("\"attendance\"", json, StringComparison.Ordinal);
+        Assert.Contains("\"status\": \"late\"", json, StringComparison.Ordinal);
+        Assert.Contains("\"subject\": \"Mathematics\"", json, StringComparison.Ordinal);
+
+        var without = roster.People.First(person => person.Attendance is null || person.Attendance.Count == 0);
+        var withoutSlice = PersonJsonSlice(json, without.Id);
+        Assert.DoesNotContain("\"attendance\"", withoutSlice, StringComparison.Ordinal);
+
+        var loaded = RosterJson.Parse(json).ToRoster();
+        var loadedPupil = loaded.People.First(person => person.Id.Equals(pupil.Id, StringComparison.Ordinal));
+        Assert.NotNull(loadedPupil.Attendance);
+        Assert.Single(loadedPupil.Attendance!);
+        Assert.Equal(AttendanceStatuses.Late, loadedPupil.Attendance[0].Status);
+        Assert.Equal("Mathematics", loadedPupil.Attendance[0].Subject);
+        Assert.Equal(1, loadedPupil.Attendance[0].Period);
+        Assert.Equal(time, loadedPupil.Attendance[0].Time);
+        Assert.Null(loadedPupil.Attendance[0].AbsenceReason);
+    }
+
+    [Fact]
+    public void RosterJson_RoundTripsAbsentReason()
+    {
+        var roster = Fixtures.Generate(Fixtures.Classrooms(4));
+        var pupil = roster.People.First(person => person.IsStudent && !person.IsParent);
+        var time = new DateTime(2012, 4, 3, 11, 20, 0, DateTimeKind.Utc);
+        AttendanceMemory.Record(
+            pupil,
+            "Mathematics",
+            AttendanceStatuses.Absent,
+            time,
+            period: 1,
+            Rules(max: 40),
+            AbsenceReasons.Truancy);
+
+        var loaded = RosterJson.Parse(RosterJson.Serialize(RosterDocument.From(1, roster))).ToRoster();
+        var loadedPupil = loaded.People.First(person => person.Id.Equals(pupil.Id, StringComparison.Ordinal));
+        Assert.Equal(AttendanceStatuses.Absent, loadedPupil.Attendance![0].Status);
+        Assert.Equal(AbsenceReasons.Truancy, loadedPupil.Attendance[0].AbsenceReason);
+    }
+
+    private static string PersonJsonSlice(string json, string personId)
+    {
+        var marker = $"\"id\": \"{personId}\"";
+        var start = json.IndexOf(marker, StringComparison.Ordinal);
+        Assert.True(start >= 0);
+        var end = json.IndexOf("},", start, StringComparison.Ordinal);
+        if (end < 0)
+        {
+            end = json.Length;
+        }
+
+        return json[start..end];
+    }
+
+    private static BehaviorDef Rules(int max) => new()
+    {
+        DefName = "Behavior",
+        AttendanceMax = max,
+        LessonLateMinutes = 5f,
+        LessonMarkWhenLate = true,
+    };
+
+    private static Person Blank(string id)
+    {
+        var cases = new CaseTable
+        {
+            Nom = id,
+            Gen = id,
+            Dat = id,
+            Acc = id,
+            Ins = id,
+            Pre = id,
+        };
+        return new Person
+        {
+            Id = id,
+            FamilyId = "f",
+            Female = false,
+            BirthDate = new DateTime(2000, 1, 1, 0, 0, 0, DateTimeKind.Utc),
+            Name = new PersonName(id, id, id, cases, cases, cases),
+            IsStudent = true,
+            IsStaff = false,
+            IsParent = false,
+            Numbers = new Dictionary<string, int>(StringComparer.Ordinal),
+            Choices = new Dictionary<string, string>(StringComparer.Ordinal),
+            Skills = new Dictionary<string, int>(StringComparer.Ordinal),
+            Traits = [],
+            Needs = new Dictionary<string, float>(StringComparer.Ordinal),
+            Opinions = new Dictionary<string, int>(StringComparer.Ordinal),
+        };
+    }
+}