feat(tutorial): add /tutorial/update — echo step + persist to viewer

POST /tutorial/update echoes tutorial_step back and saves it to
Viewer.MissionData.TutorialState. is_skip=1 is handled server-side
by honoring whatever tutorial_step value the client sends (client
already sends 100 when skipping). Adds TutorialUpdateRequest DTO,
TutorialUpdateResponse DTO, injects SVSimDbContext into
TutorialController, and adds GetViewerTutorialStateAsync helper to
SVSimTestFactory.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
gamer147
2026-05-28 11:47:09 -04:00
parent 703f7ff3d7
commit bc9ffe1d31
5 changed files with 121 additions and 0 deletions

View File

@@ -33,4 +33,48 @@ public class TutorialControllerTests
Assert.That(doc.RootElement.EnumerateObject().Count(), Is.EqualTo(0),
"update_action returns empty data — client uses SkipAllNetworkChecks and reads nothing.");
}
[TestCase(11)]
[TestCase(21)]
[TestCase(31)]
public async Task Update_echoes_requested_step_and_persists(int step)
{
using var factory = new SVSimTestFactory();
long viewerId = await factory.SeedViewerAsync(tutorialState: 0);
using var client = factory.CreateAuthenticatedClient(viewerId);
var requestJson = $$"""
{"tutorial_step":{{step}},"is_skip":0,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}
""";
var response = await client.PostAsync("/tutorial/update",
new StringContent(requestJson, Encoding.UTF8, "application/json"));
Assert.That(response.StatusCode, Is.EqualTo(HttpStatusCode.OK));
using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
Assert.That(doc.RootElement.GetProperty("tutorial_step").GetInt32(), Is.EqualTo(step));
// Side effect: viewer state advanced.
Assert.That(await factory.GetViewerTutorialStateAsync(viewerId), Is.EqualTo(step));
}
[Test]
public async Task Update_with_is_skip_1_jumps_to_100()
{
using var factory = new SVSimTestFactory();
long viewerId = await factory.SeedViewerAsync(tutorialState: 0);
using var client = factory.CreateAuthenticatedClient(viewerId);
// The client sends the step it's MOVING TO. is_skip=1 means "skip the rest" — typically
// sent with tutorial_step=100 already (matches what `TutorialUpdateTask` does with the
// is_skip flag), so the server's job is just to honor whatever value is provided.
var requestJson = """{"tutorial_step":100,"is_skip":1,"viewer_id":"0","steam_id":0,"steam_session_ticket":""}""";
var response = await client.PostAsync("/tutorial/update",
new StringContent(requestJson, Encoding.UTF8, "application/json"));
using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
Assert.That(doc.RootElement.GetProperty("tutorial_step").GetInt32(), Is.EqualTo(100));
Assert.That(await factory.GetViewerTutorialStateAsync(viewerId), Is.EqualTo(100));
}
}