feat: platform backbone and field capture, first part (checkpoint)

Platform backbone (plan 2026-10-13-plattform-rueckgrat), reviewed tasks:
- run roles api/worker/job/all with shared startup checks (Task 1)
- schema and migration for DomainEvent, deliveries, JobRun, ThrottlerHit (Task 2)
- audit, notifications and domain events written in the same transaction (Task 3)
- dispatcher with SKIP LOCKED claims, retries and stale release (Task 4)
- worker building blocks: tick, LISTEN/NOTIFY wake-up, health (Task 5)
- worker process and entry points (Task 6)
- throttler counters in Postgres (Task 19)
- separate keys per purpose with key ring (Task 20)
- public origin page without exact location (Task 22)
- shop keys split into read and write (Task 23)
- Kustomize base, components, overlay encry, CI validation (Task 26)

Field capture T3 (plan 2026-10-13-t3-erfassung-am-stand), reviewed tasks:
- brood frames, read endpoints, apiary overview and offline pack
- network basics, offline queue v3, navigation sheets, form building blocks
- new inspection with last-time hints and weather, varroa per day,
  treatment prefill, apiary page with round
- inspection photo (Task 10) is implemented, review pending

Not rolled out. Remaining tasks follow in later commits.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

ApiCore-Frontend/src/lib/documents/api.ts

@@ -1,11 +1,17 @@
 import { apiFetch, apiFetchBlob, apiFetchFormData } from "@/lib/auth/api-client";
 import { downloadBlob } from "@/lib/export/api";
+import { CreateOptions, idempotencyHeaders } from "@/lib/offline/idempotency";
 import {
   DocumentEntityType,
   DocumentSummary,
   UpdateDocumentInput,
 } from "./types";
 
+export interface UploadDocumentOptions extends CreateOptions {
+  /** Stored name; a File keeps its own name when this is left out. */
+  fileName?: string;
+}
+
 export function fetchDocuments(
   entityType: DocumentEntityType,
   entityId: string,
@@ -14,16 +20,28 @@ export function fetchDocuments(
   return apiFetch<DocumentSummary[]>(`/documents?${params.toString()}`);
 }
 
+/**
+ * Uploads one file. With an idempotency key (a photo sent from the offline
+ * queue) a repeated upload after a lost answer returns the first document
+ * instead of storing the photo twice.
+ */
 export function uploadDocument(
   entityType: DocumentEntityType,
   entityId: string,
-  file: File,
+  file: Blob,
+  options: UploadDocumentOptions = {},
 ): Promise<DocumentSummary> {
   const formData = new FormData();
-  formData.append("file", file);
+  if (options.fileName === undefined) {
+    formData.append("file", file);
+  } else {
+    formData.append("file", file, options.fileName);
+  }
   formData.append("entityType", entityType);
   formData.append("entityId", entityId);
-  return apiFetchFormData<DocumentSummary>("/documents", formData);
+  return apiFetchFormData<DocumentSummary>("/documents", formData, {
+    headers: idempotencyHeaders(options),
+  });
 }
 
 export function updateDocument(

ApiCore-Frontend/src/lib/documents/limits.ts

@@ -0,0 +1,5 @@
+/**
+ * The largest file the server accepts for a document - keep equal to
+ * MAX_FILE_SIZE_BYTES in the backend's documents.controller.ts.
+ */
+export const MAX_DOCUMENT_UPLOAD_BYTES = 10 * 1024 * 1024;