");
+
+ // --- letterhead ---
+ sb.Append("
");
+ return sb.ToString();
+ }
+
+ /// Exposed so LetterHtmlTests can assert every `letter`-prefixed class this
+ /// renderer emits also exists in the shared contract file — the fence against drift.
+ public static string StyleSheet => Css;
+
+ // No recipient address is tracked anywhere in this POC's brief domain (BRP lookup
+ // is out of scope here) — the canvas shows the same static placeholder text.
+ private const string RecipientPlaceholder = "Adres van de geadresseerde\n(wordt ingevuld bij verzending)";
+
+ private static void RenderParagraphs(
+ StringBuilder sb, IReadOnlyList");
+ if (template.LogoDocumentId is { } logoId && DocumentStore.Get(logoId) is { } logo)
+ {
+ sb.Append("![\"\"](\"data:").Append(logo.ContentType))
");
+ }
+ sb.Append("
");
+
+ // --- body: the case-type template's sections ---
+ sb.Append("").Append(Enc(template.OrgName)).Append("
"); + sb.Append("").Append(EncLines(template.ReturnAddress)).Append(""); + sb.Append("").Append(EncLines(RecipientPlaceholder)).Append(""); + sb.Append("- ");
+ sb.Append("
- Ons kenmerk
- ").Append(Enc(brief.BriefId)).Append("
- Datum
- ").Append(Enc(FormatDatumNl(at))).Append("
");
+ foreach (var section in brief.Sections)
+ {
+ sb.Append("
");
+
+ // --- signature ---
+ sb.Append("").Append(Enc(section.Title)).Append("
"); + foreach (var block in section.Blocks) + RenderParagraphs(sb, block.Content.Paragraphs, defs); + sb.Append("");
+ sb.Append("
");
+
+ // --- footer ---
+ sb.Append("");
+
+ if (watermark) sb.Append("").Append(Enc(template.SignatureClosing)).Append("
"); + sb.Append("").Append(Enc(template.SignatureName)).Append("
"); + sb.Append("").Append(Enc(template.SignatureRole)).Append("
"); + sb.Append("VOORBEELD
");
+
+ sb.Append("- " : "
- "); + foreach (var node in para.Nodes) RenderNode(sb, node, defs); + sb.Append(openList is null ? "" : " "); + } + if (openList is not null) sb.Append(openList == "bullet" ? "
- ");
+ openList = para.List;
+ }
+ sb.Append(openList is null ? "
" : "
"); + break; + case "placeholder": + var key = node.Key ?? ""; + var def = defs.GetValueOrDefault(key); + var label = def?.Label ?? key; + sb.Append(def is { AutoResolvable: true } ? Enc(ResolveAuto(key, label)) : Enc($"[NOG IN TE VULLEN: {label}]")); + break; + } + } + + // The only place a placeholder key gets a real value: seed/case data for the + // single demo applicant (SeedData.Registration — no per-brief resolved value is + // ever stored, see the class doc above). Falls back to the label itself for any + // other auto-resolvable key, mirroring the FE canvas' own `sampleFor` fallback. + private static string ResolveAuto(string key, string label) => key switch + { + "naam_zorgverlener" => SeedData.Registration.Naam, + "big_nummer" => SeedData.Registration.BigNummer, + "datum" => FormatDatumNl(DateTimeOffset.UtcNow.ToString("o")), + _ => label, + }; + + private static readonly CultureInfo Nl = CultureInfo.GetCultureInfo("nl-NL"); + private static string FormatDatumNl(string at) => DateTimeOffset.Parse(at).ToString("d MMMM yyyy", Nl); + + private static string MarginStyle(MarginsDto m) => + $"--letter-margin-top:{m.TopMm}mm;--letter-margin-right:{m.RightMm}mm;" + + $"--letter-margin-bottom:{m.BottomMm}mm;--letter-margin-left:{m.LeftMm}mm;"; + + private static string Enc(string s) => System.Net.WebUtility.HtmlEncode(s); + private static string EncLines(string s) => Enc(s).Replace("\n", "
"); + + // Walks up from the running assembly's own directory (NOT the process cwd, which + // varies by how `dotnet run`/docker/tests invoke it — see docs/backlog/WP-25) until + // it finds `public/letter.css`. docker-compose.yml bind-mounts `./public` under the + // api container's `/src` for exactly this walk to resolve there too. + private static string FindLetterCss() + { + for (var dir = new DirectoryInfo(AppContext.BaseDirectory); dir is not null; dir = dir.Parent) + { + var candidate = Path.Combine(dir.FullName, "public", "letter.css"); + if (File.Exists(candidate)) return candidate; + } + throw new FileNotFoundException( + $"public/letter.css not found by walking up from {AppContext.BaseDirectory} " + + "— check the docker bind mount or build output location."); + } + + // Backend-only concerns absent from the FE canvas (no live preview toggle for + // either): kept out of the shared contract file, not "letter"-prefixed so the + // class-parity test's scope doesn't need to widen for them. + private const string ExtraCss = """ + .preview-watermark { + position: fixed; + inset: 0; + display: flex; + align-items: center; + justify-content: center; + font-size: 72pt; + font-weight: 700; + color: rgb(200 30 30 / 0.18); + transform: rotate(-30deg); + pointer-events: none; + z-index: 3; + } + .org-logo { + display: block; + max-height: 18mm; + margin-block-end: 4mm; + } + """; +} diff --git a/backend/src/BigRegister.Api/Program.cs b/backend/src/BigRegister.Api/Program.cs index f269cc3..80b2f58 100644 --- a/backend/src/BigRegister.Api/Program.cs +++ b/backend/src/BigRegister.Api/Program.cs @@ -346,6 +346,31 @@ api.MapPost("/brief/send", (HttpContext ctx) => .Produces
BIG-register
Retouradres: Postbus 00000, 2500 AA Den HaagAdres van de geadresseerde(wordt ingevuld bij verzending)
- Ons kenmerk
- golden-brief-1
- Datum
- 5 juli 2026
Aanhef
Geachte heer/mevrouw Dr. A. (Anna) de Vries,
Kern van het besluit
Op
- Eerste punt: [NOG IN TE VULLEN: Reden besluit]
- Tweede punt
Slot
Met vriendelijke groet,
Met vriendelijke groet,
A. de Vries
Hoofd Registratie, BIG-register
("/api/v1/brief"))!.Brief;
+ await _client.PutAsJsonAsync("/api/v1/brief", FilledFrom(brief));
+ await _client.SendAsync(Req(HttpMethod.Post, "/api/v1/brief/submit"));
+ await _client.SendAsync(Req(HttpMethod.Post, "/api/v1/brief/approve", role: "approver"));
+ await _client.SendAsync(Req(HttpMethod.Post, "/api/v1/brief/send"));
+
+ var sentHtml = await (await _client.GetAsync("/api/v1/brief/preview")).Content.ReadAsStringAsync();
+ Assert.DoesNotContain("
())!.Draft;
+ await _client.SendAsync(new HttpRequestMessage(HttpMethod.Put, $"/api/v1/admin/org-template/{Registers}")
+ {
+ Headers = { { "X-Role", "admin" } },
+ Content = JsonContent.Create(new SaveOrgTemplateRequest(draft with { OrgName = "Hertitelde organisatie" })),
+ });
+ await _client.SendAsync(Req(HttpMethod.Post, $"/api/v1/admin/org-template/{Registers}/publish", role: "admin"));
+
+ // The sent brief's preview is unchanged — still the archived rendering.
+ var afterRepublish = await (await _client.GetAsync("/api/v1/brief/preview")).Content.ReadAsStringAsync();
+ Assert.Equal(sentHtml, afterRepublish);
+ Assert.DoesNotContain("Hertitelde organisatie", afterRepublish);
+ }
+
+ [Fact]
+ public async Task Proefbrief_is_admin_only_and_renders_the_draft_template()
+ {
+ ResetStores();
+ Assert.Equal(HttpStatusCode.Forbidden,
+ (await _client.GetAsync($"/api/v1/admin/org-template/{Registers}/preview")).StatusCode);
+
+ var res = await _client.SendAsync(Req(HttpMethod.Get, $"/api/v1/admin/org-template/{Registers}/preview", role: "admin"));
+ res.EnsureSuccessStatusCode();
+ var html = await res.Content.ReadAsStringAsync();
+ Assert.Contains("BIG-register", html);
+ Assert.Contains("
{
expect(store.lastError()).toBeNull();
});
});
+
+describe('BriefStore.previewLetter', () => {
+ // vi.spyOn reuses an existing spy (and its call history) if one is already on
+ // the property — window.open/URL.createObjectURL must be restored between tests.
+ afterEach(() => vi.restoreAllMocks());
+
+ it('opens the composed letter in a new tab on success', async () => {
+ const store = setup({
+ load: (): Promise> => Promise.resolve({ ok: true, value: view }),
+ });
+ await store.load();
+ const blob = new Blob([''], { type: 'text/html' });
+ vi.spyOn(URL, 'createObjectURL').mockReturnValue('blob:mock');
+ const open = vi.spyOn(window, 'open').mockImplementation(() => null);
+ vi.spyOn(TestBed.inject(LetterPreviewAdapter), 'preview').mockResolvedValue({
+ ok: true,
+ value: blob,
+ });
+
+ await store.previewLetter();
+ expect(open).toHaveBeenCalledWith('blob:mock', '_blank');
+ expect(store.lastError()).toBeNull();
+ });
+
+ it('surfaces the error without opening a tab on failure', async () => {
+ const store = setup({
+ load: (): Promise> => Promise.resolve({ ok: true, value: view }),
+ });
+ await store.load();
+ const open = vi.spyOn(window, 'open').mockImplementation(() => null);
+ vi.spyOn(TestBed.inject(LetterPreviewAdapter), 'preview').mockResolvedValue({
+ ok: false,
+ error: 'De voorvertoning kon niet worden geopend.',
+ });
+
+ await store.previewLetter();
+ expect(open).not.toHaveBeenCalled();
+ expect(store.lastError()).toBe('De voorvertoning kon niet worden geopend.');
+ });
+});
diff --git a/src/app/brief/application/brief.store.ts b/src/app/brief/application/brief.store.ts
index b9a3bf2..1271d0a 100644
--- a/src/app/brief/application/brief.store.ts
+++ b/src/app/brief/application/brief.store.ts
@@ -12,6 +12,7 @@ import {
import { BriefMsg, BriefState, initial, reduce } from '@brief/domain/brief.machine';
import { OrgTemplate } from '@brief/domain/org-template';
import { BriefAdapter, BriefView } from '@brief/infrastructure/brief.adapter';
+import { LetterPreviewAdapter } from '@brief/infrastructure/letter-preview.adapter';
/** Transient action state (submit/approve/reject/send/resetDemo) — one tagged union
instead of a busy boolean + a nullable error sitting side by side. */
@@ -35,6 +36,7 @@ type LoadedBriefState = Extract;
@Injectable({ providedIn: 'root' })
export class BriefStore {
private adapter = inject(BriefAdapter);
+ private previewAdapter = inject(LetterPreviewAdapter);
private store = createStore(initial, reduce);
readonly model = this.store.model;
@@ -147,6 +149,20 @@ export class BriefStore {
reject = (comments: string) => this.transition(() => this.adapter.reject(comments));
send = () => this.transition(() => this.adapter.send());
+ /** Explicit action, never a live re-render (PRD §8): opens the server-composed
+ letter in a new tab. ponytail: the blob URL is never revoked — it's cheap and
+ the tab outlives this call; not worth a teardown hook for a POC. */
+ async previewLetter() {
+ this.actionState.set({ tag: 'Busy' });
+ const r = await this.previewAdapter.preview();
+ if (!r.ok) {
+ this.actionState.set({ tag: 'Failed', error: r.error });
+ return;
+ }
+ this.actionState.set({ tag: 'Idle' });
+ window.open(URL.createObjectURL(r.value), '_blank');
+ }
+
// A transition: flush any pending save, call the server (authoritative), then mirror
// the returned status through the pure reducer's guarded transition.
private async transition(action: () => Promise>) {
diff --git a/src/app/brief/infrastructure/letter-preview.adapter.ts b/src/app/brief/infrastructure/letter-preview.adapter.ts
new file mode 100644
index 0000000..f474201
--- /dev/null
+++ b/src/app/brief/infrastructure/letter-preview.adapter.ts
@@ -0,0 +1,37 @@
+import { Injectable } from '@angular/core';
+import { Result, ok, err } from '@shared/kernel/fp';
+import { currentRole } from '@shared/infrastructure/role';
+import { problemDetail } from '@shared/infrastructure/api-error';
+import { environment } from '../../../environments/environment';
+
+const PREVIEW_FAILED = $localize`:@@brief.preview.failed:De voorvertoning kon niet worden geopend.`;
+
+/**
+ * `/brief/preview` returns `text/html`, not JSON, and is `.ExcludeFromDescription()`'d
+ * to keep the NSwag-generated client JSON-only (same seam as uploads) — so this is a
+ * hand-written fetch, not the `ApiClient`. That also means it bypasses `HttpClient`'s
+ * `roleInterceptor`, so `X-Role` is set here explicitly.
+ */
+@Injectable({ providedIn: 'root' })
+export class LetterPreviewAdapter {
+ async preview(): Promise> {
+ let res: Response;
+ try {
+ res = await fetch(`${environment.apiBaseUrl}/api/v1/brief/preview`, {
+ headers: { 'X-Role': currentRole() },
+ });
+ } catch {
+ return err(PREVIEW_FAILED);
+ }
+ if (!res.ok) return err(await errorMessage(res));
+ return ok(await res.blob());
+ }
+}
+
+async function errorMessage(res: Response): Promise {
+ try {
+ return problemDetail(await res.json(), PREVIEW_FAILED);
+ } catch {
+ return PREVIEW_FAILED;
+ }
+}
diff --git a/src/app/brief/ui/brief.page.ts b/src/app/brief/ui/brief.page.ts
index 7270afb..59ec5ed 100644
--- a/src/app/brief/ui/brief.page.ts
+++ b/src/app/brief/ui/brief.page.ts
@@ -63,6 +63,7 @@ import { LetterComposerComponent } from '@brief/ui/letter-composer/letter-compos
(approve)="store.approve()"
(reject)="store.reject($event)"
(send)="store.send()"
+ (preview)="store.previewLetter()"
/>
}
}
diff --git a/src/app/brief/ui/letter-composer/letter-composer.component.ts b/src/app/brief/ui/letter-composer/letter-composer.component.ts
index da72cb7..1415b6b 100644
--- a/src/app/brief/ui/letter-composer/letter-composer.component.ts
+++ b/src/app/brief/ui/letter-composer/letter-composer.component.ts
@@ -41,6 +41,11 @@ import { RejectionCommentsComponent } from '@brief/ui/rejection-comments/rejecti
flex-wrap: wrap;
margin-block-end: var(--rhc-space-max-lg);
}
+ .head-end {
+ display: flex;
+ align-items: center;
+ gap: var(--rhc-space-max-md);
+ }
.panel {
margin-block: var(--rhc-space-max-xl);
}
@@ -56,7 +61,12 @@ import { RejectionCommentsComponent } from '@brief/ui/rejection-comments/rejecti
template: `
{{ title() }}
- ();
reject = output();
send = output();
+ preview = output();
locate = output();
title = input($localize`:@@brief.title:Brief aan de zorgverlener`);
+ previewLabel = input($localize`:@@brief.preview.open:Voorbeeld`);
submitLabel = input($localize`:@@brief.submit:Indienen ter beoordeling`);
resubmitLabel = input($localize`:@@brief.resubmit:Opnieuw indienen`);
submitHint = input(
+ {{
+ previewLabel()
+ }}
+