feat(enrich): add metadata enrichment queue UI

Home page shows "Needs metadata" card when incomplete documents exist.
/enrich list shows all incomplete documents; /enrich/[id] provides a
split PDF-preview + compact form view with Skip / Save / Save & reviewed
actions that auto-advance through the queue.

New document page gets Save vs Save & reviewed split. Edit page gets
"Mark for review" secondary button to push a document back into the queue.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

frontend/src/routes/documents/[id]/edit/+page.server.ts

@@ -60,6 +60,53 @@ export const actions = {
 		throw redirect(303, `/documents/${params.id}`);
 	},
 
+	markForReview: async ({
+		params,
+		fetch
+	}: {
+		params: { id: string };
+		fetch: typeof globalThis.fetch;
+	}) => {
+		const baseUrl = env.API_INTERNAL_URL || 'http://localhost:8080';
+		const api = createApiClient(fetch);
+
+		// Fetch current document to preserve all existing fields
+		const docResult = await api.GET('/api/documents/{id}', { params: { path: { id: params.id } } });
+		if (!docResult.response.ok) {
+			const code = (docResult.error as unknown as { code?: string })?.code;
+			return fail(docResult.response.status, { error: getErrorMessage(code) });
+		}
+
+		const doc = docResult.data!;
+		const formData = new FormData();
+		if (doc.title) formData.set('title', doc.title);
+		if (doc.documentDate) formData.set('documentDate', doc.documentDate);
+		if (doc.location) formData.set('location', doc.location);
+		if (doc.documentLocation) formData.set('documentLocation', doc.documentLocation);
+		if (doc.transcription) formData.set('transcription', doc.transcription);
+		if (doc.summary) formData.set('summary', doc.summary);
+		if (doc.sender?.id) formData.set('senderId', doc.sender.id);
+		if (doc.receivers?.length) {
+			doc.receivers.forEach((r: { id: string }) => formData.append('receiverIds', r.id));
+		}
+		if (doc.tags?.length) {
+			formData.set('tags', doc.tags.map((t: { name: string }) => t.name).join(','));
+		}
+		formData.set('metadataComplete', 'false');
+
+		const res = await fetch(`${baseUrl}/api/documents/${params.id}`, {
+			method: 'PUT',
+			body: formData
+		});
+
+		if (!res.ok) {
+			const backendError = await parseBackendError(res);
+			return fail(res.status, { error: getErrorMessage(backendError?.code) });
+		}
+
+		throw redirect(303, `/documents/${params.id}`);
+	},
+
 	delete: async ({ params, fetch }) => {
 		const baseUrl = env.API_INTERNAL_URL || 'http://localhost:8080';
 

frontend/src/routes/documents/[id]/edit/SaveBar.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 import { m } from '$lib/paraglide/messages.js';
+import { enhance } from '$app/forms';
 
 let { docId }: { docId: string } = $props();
 
@@ -54,7 +55,7 @@ let confirmDelete = $state(false);
 		{/if}
 	</div>
 
-	<!-- Right: cancel + save -->
+	<!-- Right: cancel + mark for review + save -->
 	<div class="flex items-center gap-4">
 		<a
 			href="/documents/{docId}"
@@ -62,6 +63,13 @@ let confirmDelete = $state(false);
 		>
 			{m.btn_cancel()}
 		</a>
+		<button
+			type="submit"
+			form="mark-for-review-form"
+			class="rounded-sm border border-gray-300 px-4 py-2 font-sans text-xs font-bold tracking-widest text-gray-600 uppercase transition-colors hover:bg-gray-50"
+		>
+			{m.btn_mark_for_review()}
+		</button>
 		<button
 			type="submit"
 			class="rounded bg-primary px-6 py-2 text-sm font-bold tracking-widest text-white uppercase transition-colors hover:bg-primary/80"
@@ -70,3 +78,5 @@ let confirmDelete = $state(false);
 		</button>
 	</div>
 </div>
+
+<form id="mark-for-review-form" method="POST" action="?/markForReview" use:enhance></form>

frontend/src/routes/documents/new/+page.server.ts

@@ -55,22 +55,41 @@ export async function load({
 	};
 }
 
+async function submitNewDocument(
+	request: Request,
+	fetch: typeof globalThis.fetch,
+	metadataComplete: boolean
+) {
+	const baseUrl = env.API_INTERNAL_URL || 'http://localhost:8080';
+	const formData = await request.formData();
+	formData.set('metadataComplete', String(metadataComplete));
+
+	const res = await fetch(`${baseUrl}/api/documents`, {
+		method: 'POST',
+		body: formData
+	});
+
+	if (!res.ok) {
+		const backendError = await parseBackendError(res);
+		return fail(res.status, { error: getErrorMessage(backendError?.code) });
+	}
+
+	const created = await res.json();
+	throw redirect(303, `/documents/${created.id}`);
+}
+
 export const actions = {
-	default: async ({ request, fetch }) => {
-		const baseUrl = env.API_INTERNAL_URL || 'http://localhost:8080';
-		const formData = await request.formData();
+	save: async ({ request, fetch }: { request: Request; fetch: typeof globalThis.fetch }) => {
+		return submitNewDocument(request, fetch, false);
+	},
 
-		const res = await fetch(`${baseUrl}/api/documents`, {
-			method: 'POST',
-			body: formData
-		});
-
-		if (!res.ok) {
-			const backendError = await parseBackendError(res);
-			return fail(res.status, { error: getErrorMessage(backendError?.code) });
-		}
-
-		const created = await res.json();
-		throw redirect(303, `/documents/${created.id}`);
+	saveReviewed: async ({
+		request,
+		fetch
+	}: {
+		request: Request;
+		fetch: typeof globalThis.fetch;
+	}) => {
+		return submitNewDocument(request, fetch, true);
 	}
 };

frontend/src/routes/documents/new/+page.svelte

@@ -62,12 +62,26 @@ let selectedReceivers: { id: string; firstName: string; lastName: string }[] = $
 			<a href="/" class="text-sm font-medium text-ink-2 transition-colors hover:text-ink">
 				{m.btn_cancel()}
 			</a>
-			<button
-				type="submit"
-				class="rounded bg-primary px-6 py-2 text-sm font-bold tracking-widest text-white uppercase transition-colors hover:bg-primary/80"
-			>
-				{m.btn_save()}
-			</button>
+			<div class="flex items-center gap-3">
+				<button
+					type="submit"
+					name="metadataComplete"
+					value="false"
+					formaction="?/save"
+					class="rounded-sm border border-gray-300 px-5 py-2 font-sans text-xs font-bold tracking-widest text-gray-600 uppercase transition-colors hover:bg-gray-50"
+				>
+					{m.btn_save()}
+				</button>
+				<button
+					type="submit"
+					name="metadataComplete"
+					value="true"
+					formaction="?/saveReviewed"
+					class="rounded-sm bg-brand-navy px-5 py-2 font-sans text-xs font-bold tracking-widest text-white uppercase transition-colors hover:bg-brand-navy/90"
+				>
+					{m.btn_save_and_mark_reviewed()}
+				</button>
+			</div>
 		</div>
 	</form>
 </div>