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-Backend/src/runtime/role.spec.ts

@@ -0,0 +1,58 @@
+import { resolveRole } from './role';
+
+describe('resolveRole', () => {
+  it('defaults per entry point outside production', () => {
+    expect(resolveRole('main', {})).toBe('all');
+    expect(resolveRole('worker', {})).toBe('worker');
+    expect(resolveRole('cli', {})).toBe('job');
+  });
+
+  it('treats a blank APICORE_ROLE as unset', () => {
+    expect(resolveRole('main', { APICORE_ROLE: '  ' })).toBe('all');
+  });
+
+  it('requires APICORE_ROLE in production', () => {
+    expect(() => resolveRole('main', { NODE_ENV: 'production' })).toThrow(
+      'APICORE_ROLE is required in production',
+    );
+  });
+
+  it('rejects all in production', () => {
+    expect(() =>
+      resolveRole('main', { NODE_ENV: 'production', APICORE_ROLE: 'all' }),
+    ).toThrow('APICORE_ROLE=all is for local development and tests only');
+  });
+
+  it('rejects an unknown role', () => {
+    expect(() => resolveRole('main', { APICORE_ROLE: 'admin' })).toThrow(
+      'APICORE_ROLE must be one of api, worker, job, all',
+    );
+  });
+
+  it('rejects a role that does not belong to the entry point', () => {
+    expect(() => resolveRole('main', { APICORE_ROLE: 'worker' })).toThrow(
+      'APICORE_ROLE=worker cannot start dist/main.js',
+    );
+    expect(() => resolveRole('worker', { APICORE_ROLE: 'api' })).toThrow(
+      'APICORE_ROLE=api cannot start dist/worker.js',
+    );
+    expect(() => resolveRole('cli', { APICORE_ROLE: 'all' })).toThrow(
+      'APICORE_ROLE=all cannot start dist/cli.js',
+    );
+  });
+
+  it('accepts api for main in production', () => {
+    expect(
+      resolveRole('main', { NODE_ENV: 'production', APICORE_ROLE: 'api' }),
+    ).toBe('api');
+  });
+
+  it('accepts worker and job for their entry points in production', () => {
+    expect(
+      resolveRole('worker', { NODE_ENV: 'production', APICORE_ROLE: 'worker' }),
+    ).toBe('worker');
+    expect(
+      resolveRole('cli', { NODE_ENV: 'production', APICORE_ROLE: 'job' }),
+    ).toBe('job');
+  });
+});