New `brief` context — a letter-composition feature with a drafter/approver approval workflow, built as a teaching vertical slice on the repo's existing FP + Elm + atomic-design patterns (see plan in ~/.claude/plans). Domain (pure): - Rich text as a serialisable value tree (placeholders are first-class nodes), moved to @shared/kernel/rich-text.ts so the shared editor can use it. - lintPlaceholders: a pure, total content -> Diagnostic[] linter, derived never stored. - brief.machine.ts: status sum-type with guarded transitions; frozen-snapshot = deep value copy; derived diagnostics/editability. Full specs. Backend (.NET stub): - BriefStore + seed, GET/PUT /brief and submit/approve/reject/send endpoints, role via X-Role header (mirrors X-Admin), transition + approver!=drafter guards, audit logging. Regenerated typed client via gen:api. +6 backend tests. Seam: - brief.adapter.ts maps flat wire unions <-> domain discriminated unions at the parse boundary (+ spec). UI (atomic): - shared atoms: checkbox, placeholder-chip; molecule: rich-text-editor (no-dep contenteditable, DOM<->RichTextBlock round-trip tested). - brief/ui: letter-block, passage-picker, diagnostics-panel, rejection-comments, letter-section, letter-composer, letter-preview, brief.page + /brief route. - Dev-only ?role=drafter|approver toggle + roleInterceptor; dashboard nav link. Enforcement: @brief/* alias + eslint layer boundary (brief depends only on shared). Also included (same session): - Value-object specs (postcode/uren/big-nummer) — closes the "domain must have a spec" gap. - src/docs/ Storybook MDX foundation pages (atomic design, tokens, FP-in-UI). - .storybook/tsconfig.json: add @angular/localize to types (Storybook was fully broken — $localize unresolved — dev + build). Verified: 168 FE tests, 68 backend tests, lint/build/check:tokens green, Storybook boots, end-to-end HTTP smoke (self-approve 403, approver 200, full flow). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
138 lines
5.8 KiB
C#
138 lines
5.8 KiB
C#
using System.Net;
|
|
using System.Net.Http.Json;
|
|
using BigRegister.Api.Contracts;
|
|
using BigRegister.Api.Data;
|
|
using Microsoft.AspNetCore.Mvc.Testing;
|
|
|
|
namespace BigRegister.Tests;
|
|
|
|
/// <summary>
|
|
/// The brief is a single process-global demo entity, so each test resets it first
|
|
/// (tests within a class run sequentially in xUnit). Role is the dev-only X-Role
|
|
/// header: absent = drafter, "approver" = a different identity.
|
|
/// </summary>
|
|
public class BriefEndpointTests(WebApplicationFactory<Program> factory) : IClassFixture<WebApplicationFactory<Program>>
|
|
{
|
|
private readonly HttpClient _client = factory.CreateClient();
|
|
|
|
private static LetterBlockDto FreeText(string id) =>
|
|
new("freeText", id, new RichTextBlockDto(new[] { new ParagraphDto(new[] { new RichTextNodeDto("text", Text: "inhoud") }) }));
|
|
|
|
// Fill every REQUIRED section with a block so submit is allowed.
|
|
private static SaveBriefRequest FilledFrom(BriefDto brief)
|
|
{
|
|
var i = 0;
|
|
var sections = brief.Sections
|
|
.Select(s => new LetterSectionDto(s.SectionKey, s.Title, s.Required, s.Required ? new[] { FreeText($"local-{++i}") } : s.Blocks))
|
|
.ToList();
|
|
return new SaveBriefRequest(sections);
|
|
}
|
|
|
|
private async Task<BriefDto> Get()
|
|
{
|
|
BriefStore.Reset();
|
|
var view = await _client.GetFromJsonAsync<BriefViewDto>("/api/v1/brief");
|
|
return view!.Brief;
|
|
}
|
|
|
|
private HttpRequestMessage Post(string path, string? role = null, object? body = null)
|
|
{
|
|
var req = new HttpRequestMessage(HttpMethod.Post, path);
|
|
if (role is not null) req.Headers.Add("X-Role", role);
|
|
if (body is not null) req.Content = JsonContent.Create(body);
|
|
return req;
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Get_creates_a_draft_from_the_template_with_scoped_passages()
|
|
{
|
|
var brief = await Get();
|
|
Assert.Equal("draft", brief.Status.Tag);
|
|
Assert.Equal(new[] { "aanhef", "kern", "slot" }, brief.Sections.Select(s => s.SectionKey));
|
|
Assert.All(brief.Sections, s => Assert.Empty(s.Blocks));
|
|
|
|
var view = await _client.GetFromJsonAsync<BriefViewDto>("/api/v1/brief");
|
|
// global passages + the arts-scoped one; no other-beroep passages leak in.
|
|
Assert.Contains(view!.AvailablePassages, p => p.PassageId == "p-kern-arts");
|
|
Assert.All(view.AvailablePassages, p => Assert.True(p.Scope == "global" || p.Beroep == "arts"));
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Save_is_drafter_only()
|
|
{
|
|
var brief = await Get();
|
|
var save = FilledFrom(brief);
|
|
|
|
var approver = Post("/api/v1/brief", role: "approver");
|
|
approver.Method = HttpMethod.Put;
|
|
approver.Content = JsonContent.Create(save);
|
|
Assert.Equal(HttpStatusCode.Forbidden, (await _client.SendAsync(approver)).StatusCode);
|
|
|
|
Assert.Equal(HttpStatusCode.OK, (await _client.PutAsJsonAsync("/api/v1/brief", save)).StatusCode);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Submit_blocks_on_empty_required_section_then_succeeds_when_filled()
|
|
{
|
|
await Get();
|
|
// Nothing filled yet → required sections empty → 409.
|
|
Assert.Equal(HttpStatusCode.Conflict, (await _client.SendAsync(Post("/api/v1/brief/submit"))).StatusCode);
|
|
|
|
var brief = (await _client.GetFromJsonAsync<BriefViewDto>("/api/v1/brief"))!.Brief;
|
|
await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief));
|
|
|
|
var res = await _client.SendAsync(Post("/api/v1/brief/submit"));
|
|
res.EnsureSuccessStatusCode();
|
|
var submitted = await res.Content.ReadFromJsonAsync<BriefDto>();
|
|
Assert.Equal("submitted", submitted!.Status.Tag);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Drafter_cannot_approve_own_letter_but_a_different_reviewer_can()
|
|
{
|
|
var brief = await Get();
|
|
await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief));
|
|
await _client.SendAsync(Post("/api/v1/brief/submit"));
|
|
|
|
// drafter role approving own letter → 403
|
|
Assert.Equal(HttpStatusCode.Forbidden, (await _client.SendAsync(Post("/api/v1/brief/approve"))).StatusCode);
|
|
|
|
var res = await _client.SendAsync(Post("/api/v1/brief/approve", role: "approver"));
|
|
res.EnsureSuccessStatusCode();
|
|
Assert.Equal("approved", (await res.Content.ReadFromJsonAsync<BriefDto>())!.Status.Tag);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reject_returns_comments_and_editing_reopens_to_draft()
|
|
{
|
|
var brief = await Get();
|
|
await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief));
|
|
await _client.SendAsync(Post("/api/v1/brief/submit"));
|
|
|
|
var rejected = await (await _client.SendAsync(
|
|
Post("/api/v1/brief/reject", role: "approver", body: new RejectBriefRequest("Graag aanvullen.")))).Content.ReadFromJsonAsync<BriefDto>();
|
|
Assert.Equal("rejected", rejected!.Status.Tag);
|
|
Assert.Equal("Graag aanvullen.", rejected.Status.Comments);
|
|
|
|
// A drafter save on a rejected letter reopens it to draft.
|
|
var reopened = await (await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief))).Content.ReadFromJsonAsync<BriefDto>();
|
|
Assert.Equal("draft", reopened!.Status.Tag);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Send_only_from_approved()
|
|
{
|
|
var brief = await Get();
|
|
await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief));
|
|
await _client.SendAsync(Post("/api/v1/brief/submit"));
|
|
|
|
// submitted (not approved) → send 409
|
|
Assert.Equal(HttpStatusCode.Conflict, (await _client.SendAsync(Post("/api/v1/brief/send"))).StatusCode);
|
|
|
|
await _client.SendAsync(Post("/api/v1/brief/approve", role: "approver"));
|
|
var res = await _client.SendAsync(Post("/api/v1/brief/send"));
|
|
res.EnsureSuccessStatusCode();
|
|
Assert.Equal("sent", (await res.Content.ReadFromJsonAsync<BriefDto>())!.Status.Tag);
|
|
}
|
|
}
|