Enhance school creation and map management features by updating the API to support mod packs and map layouts. Introduce a new map snapshot protocol for efficient data handling during school sessions. Revise documentation to reflect these changes, including updates to the protocol and architecture documents. Improve UI components for mod selection and map editing, ensuring a better user experience. Update tests to validate new functionalities and ensure robustness.

tests/HSchool.AppHost.Tests/GameSocketTests.cs

@@ -89,6 +89,70 @@ public class GameSocketTests(AppHostFixture fixture)
         Assert.InRange(elapsed.TotalMinutes, 3, 8);
     }
 
+    [Fact]
+    public async Task OpeningASchool_SendsAMapSnapshot()
+    {
+        using var client = fixture.App.CreateHttpClient("server");
+        await SchoolApiTests.ResetAsync(client);
+        var school = await SchoolApiTests.CreateAsync(client, "Снимок карты", StartDate);
+
+        using var socket = await OpenSchoolAsync(school.Id);
+        var snapshot = ProtocolCodec.ReadMapSnapshot(await ReceiveUntilAsync(socket, MessageType.ServerMapSnapshot));
+
+        Assert.Equal(school.Id, snapshot.SchoolId);
+        Assert.Contains(snapshot.Nodes, node => node.Id == "yard" && node.Kind == 0);
+        var office = Assert.Single(snapshot.Nodes, node => node.Id == "principals-office");
+        Assert.Equal("Кабинет директора", office.Name);
+        Assert.Equal("floor-1", office.ParentId);
+        Assert.Contains("Директор", office.Positions);
+        Assert.NotEmpty(office.Items);
+    }
+
+    [Fact]
+    public async Task OpeningASchool_LabelsTheSnapshotInTheHelloLocale()
+    {
+        using var client = fixture.App.CreateHttpClient("server");
+        await SchoolApiTests.ResetAsync(client);
+        var school = await SchoolApiTests.CreateAsync(client, "English snapshot", StartDate);
+
+        using var socket = await OpenSchoolAsync(school.Id, ProtocolConstants.LocaleEnglish);
+        var snapshot = ProtocolCodec.ReadMapSnapshot(await ReceiveUntilAsync(socket, MessageType.ServerMapSnapshot));
+
+        Assert.Equal("Principal's office", Assert.Single(snapshot.Nodes, node => node.Id == "principals-office").Name);
+    }
+
+    [Fact]
+    public async Task OpeningASchool_WithACustomMap_ReturnsThatLayout()
+    {
+        using var client = fixture.App.CreateHttpClient("server");
+        await SchoolApiTests.ResetAsync(client);
+        var school = await SchoolApiTests.CreateWithMapAsync(client, "Упрощённая", StartDate, SchoolApiTests.SimpleCustomMap);
+
+        using var socket = await OpenSchoolAsync(school.Id);
+        var snapshot = ProtocolCodec.ReadMapSnapshot(await ReceiveUntilAsync(socket, MessageType.ServerMapSnapshot));
+
+        Assert.DoesNotContain(snapshot.Nodes, node => node.Id == "corridor-1");
+        var office = Assert.Single(snapshot.Nodes, node => node.Id == "office");
+        Assert.Equal("floor-1", office.ParentId);
+    }
+
+    [Fact]
+    public async Task ReloadFromDisk_RestoresACustomMap()
+    {
+        using var client = fixture.App.CreateHttpClient("server");
+        await SchoolApiTests.ResetAsync(client);
+        var school = await SchoolApiTests.CreateWithMapAsync(client, "Карта с диска", StartDate, SchoolApiTests.SimpleCustomMap);
+
+        using var reload = await client.PostAsync("/api/dev/reload-schools", content: null, TestContext.Current.CancellationToken);
+        reload.EnsureSuccessStatusCode();
+
+        using var socket = await OpenSchoolAsync(school.Id);
+        var snapshot = ProtocolCodec.ReadMapSnapshot(await ReceiveUntilAsync(socket, MessageType.ServerMapSnapshot));
+
+        Assert.Contains(snapshot.Nodes, node => node.Id == "office");
+        Assert.DoesNotContain(snapshot.Nodes, node => node.Id == "corridor-1");
+    }
+
     [Fact]
     public async Task Pausing_FreezesTheClock()
     {
@@ -280,7 +344,7 @@ public class GameSocketTests(AppHostFixture fixture)
 
         await SendAsync(socket, buffer => ProtocolCodec.WriteHello(
             buffer,
-            new ClientHelloMessage((byte)(ProtocolConstants.Version + 1))));
+            new ClientHelloMessage((byte)(ProtocolConstants.Version + 1), ProtocolConstants.LocaleRussian)));
 
         var buffer = new byte[ProtocolConstants.MaxMessageSize];
         var result = await socket.ReceiveAsync(buffer, TestContext.Current.CancellationToken);
@@ -301,19 +365,20 @@ public class GameSocketTests(AppHostFixture fixture)
         return school;
     }
 
-    private async Task<ClientWebSocket> OpenSchoolAsync(int schoolId)
+    private async Task<ClientWebSocket> OpenSchoolAsync(int schoolId, byte locale = ProtocolConstants.LocaleRussian)
     {
-        var socket = await ConnectAsync();
+        var socket = await ConnectAsync(locale);
         await ReceiveUntilAsync(socket, MessageType.ServerWelcome);
-        await SendAsync(socket, buffer => ProtocolCodec.WriteOpenSchool(buffer, new ClientOpenSchoolMessage(schoolId)));
+        await SendAsync(socket, buffer =>
+            ProtocolCodec.WriteOpenSchool(buffer, new ClientOpenSchoolMessage(schoolId)));
         return socket;
     }
 
-    private async Task<ClientWebSocket> ConnectAsync()
+    private async Task<ClientWebSocket> ConnectAsync(byte locale = ProtocolConstants.LocaleRussian)
     {
         var socket = await ConnectRawAsync();
         await SendAsync(socket, buffer =>
-            ProtocolCodec.WriteHello(buffer, new ClientHelloMessage(ProtocolConstants.Version)));
+            ProtocolCodec.WriteHello(buffer, new ClientHelloMessage(ProtocolConstants.Version, locale)));
         return socket;
     }