feat: platform backbone and field capture complete (checkpoint)

Platform backbone (plan 2026-10-13-plattform-rueckgrat), all tasks reviewed:
- webhooks with delivery table, retries and stable delivery id
- calendar handlers; a finished task removes its Outlook event
- tasks, automations, inspections, varroa, treatments, feedings,
  harvests, colonies, wintering, stock and bottling record domain events
  in the same transaction; legacy post-commit calls removed
- row locks through one helper (lockRowForUpdate, lockRowsForShare,
  lockRowsForUpdate)
- job framework with JobRun, cli exit codes, cleanup, task templates,
  daily evaluation, hourly app-backup and the rekey job
- system API and page "Verwaltung > System" with retry
- @nestjs/schedule removed, guard tests against in-process schedulers

Field capture T3 (plan 2026-10-13-t3-erfassung-am-stand), all tasks reviewed:
- inspection photo offline without metadata
- bulk capture for treatments, feedings and varroa (backend + frontend)
- offline stand mode with service worker, offline pages and packs
- offline session, cold start and logout on shared devices

Docs: ARCHITECTURE.md assumptions and sections updated, TASKS.md.
Gates: backend lint, typecheck, 1770 unit, 420 e2e, build, no schema
drift; frontend lint, typecheck, 913 tests, build. Not rolled out.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
This commit is contained in:
Nick SzaunigandClaude Opus 5.5 committed 2026-10-14 11:36:38 +02:00
1 parent c01a38835a
commit cdd30cf3ee
288 files changed
+39165 -2853

No files matched your search

+128 -1
View File
@@ -5,6 +5,7 @@ import { App } from 'supertest/types';
import { PrismaService } from '../src/prisma/prisma.service';
import { createTestApp } from './utils/create-test-app';
import { login } from './utils/api';
import { drainDomainEvents } from './utils/domain-events';
interface ColonyBody {
id: string;
@@ -35,6 +36,8 @@ describe('Colonies (e2e)', () => {
let colonyId: string;
let childColonyId: string;
let colonyToMergeId: string;
let healthColonyId: string;
let raceColonyId: string;
beforeAll(async () => {
app = await createTestApp();
@@ -74,13 +77,43 @@ describe('Colonies (e2e)', () => {
});
afterAll(async () => {
const colonyIds = [
colonyId,
childColonyId,
colonyToMergeId,
healthColonyId,
raceColonyId,
].filter(Boolean);
// Rule tasks are written without a user - their audit entry and
// TaskCreated are not covered by the userId cleanup below.
const ruleTaskIds = (
await prisma.task.findMany({
where: { relatedId: { in: colonyIds } },
select: { id: true },
})
).map((task) => task.id);
await prisma.auditLog.deleteMany({
where: { entityType: 'Task', entityId: { in: ruleTaskIds } },
});
await prisma.domainEvent.deleteMany({
where: {
OR: [
{ aggregateType: 'Colony', aggregateId: { in: colonyIds } },
{ aggregateType: 'Task', aggregateId: { in: ruleTaskIds } },
],
},
});
await prisma.task.deleteMany({ where: { id: { in: ruleTaskIds } } });
await prisma.notification.deleteMany({
where: { relatedId: { in: colonyIds } },
});
await prisma.colonyLineage.deleteMany({
where: { OR: [{ fromColonyId: colonyId }, { toColonyId: colonyId }] },
});
await prisma.colonyApiaryHistory.deleteMany({ where: { colonyId } });
await prisma.colony.deleteMany({
where: {
id: { in: [colonyId, childColonyId, colonyToMergeId].filter(Boolean) },
id: { in: colonyIds },
},
});
await prisma.apiary.deleteMany({
@@ -180,6 +213,11 @@ describe('Colonies (e2e)', () => {
.set('Authorization', `Bearer ${beekeeperToken}`)
.expect(200);
expect((merged.body as ColonyBody).status).toBe('MERGED');
const ended = await prisma.domainEvent.findMany({
where: { type: 'ColonyEnded', aggregateId: colonyToMergeId },
});
expect(ended.map((event) => event.payload)).toEqual([{ status: 'MERGED' }]);
});
it('dissolves the colony without deleting it', async () => {
@@ -189,6 +227,16 @@ describe('Colonies (e2e)', () => {
.expect(201);
expect((response.body as ColonyBody).status).toBe('DISSOLVED');
const events = await prisma.domainEvent.findMany({
where: { aggregateId: colonyId },
orderBy: { occurredAt: 'asc' },
});
expect(events.map((event) => event.type)).toEqual([
'ColonyStatusChanged',
'ColonyEnded',
]);
expect(events[1].payload).toEqual({ status: 'DISSOLVED' });
await request(app.getHttpServer())
.get(`/api/v1/colonies/${colonyId}`)
.set('Authorization', `Bearer ${staffToken}`)
@@ -230,4 +278,83 @@ describe('Colonies (e2e)', () => {
});
expect(colony.status).toBe('WEAK');
});
it('creates the COLONY_HEALTH_CRITICAL task only after the event is processed, and only on the transition', async () => {
const created = await request(app.getHttpServer())
.post('/api/v1/colonies')
.set('Authorization', `Bearer ${beekeeperToken}`)
.send({
code: `V-${Date.now()}-H`,
apiaryId: apiaryAId,
colonyType: 'PRODUCTION_COLONY',
})
.expect(201);
healthColonyId = (created.body as ColonyBody).id;
await request(app.getHttpServer())
.patch(`/api/v1/colonies/${healthColonyId}`)
.set('Authorization', `Bearer ${beekeeperToken}`)
.send({ healthStatus: 'CRITICAL' })
.expect(200);
const event = await prisma.domainEvent.findFirstOrThrow({
where: { type: 'ColonyStatusChanged', aggregateId: healthColonyId },
});
expect(event.payload).toEqual({
from: { status: 'ACTIVE', healthStatus: null },
to: { status: 'ACTIVE', healthStatus: 'CRITICAL' },
});
expect(
await prisma.task.count({ where: { relatedId: healthColonyId } }),
).toBe(0);
await drainDomainEvents(app, [healthColonyId]);
expect(
await prisma.task.count({ where: { relatedId: healthColonyId } }),
).toBe(1);
// Already critical: a further edit is no transition and opens no second task.
await request(app.getHttpServer())
.patch(`/api/v1/colonies/${healthColonyId}`)
.set('Authorization', `Bearer ${beekeeperToken}`)
.send({ notes: 'weiter kritisch' })
.expect(200);
await drainDomainEvents(app, [healthColonyId]);
expect(
await prisma.task.count({ where: { relatedId: healthColonyId } }),
).toBe(1);
});
it('two concurrent PATCHes into CRITICAL produce one transition event and one task', async () => {
const created = await request(app.getHttpServer())
.post('/api/v1/colonies')
.set('Authorization', `Bearer ${beekeeperToken}`)
.send({
code: `V-${Date.now()}-R`,
apiaryId: apiaryAId,
colonyType: 'PRODUCTION_COLONY',
})
.expect(201);
raceColonyId = (created.body as ColonyBody).id;
await Promise.all(
[1, 2].map(() =>
request(app.getHttpServer())
.patch(`/api/v1/colonies/${raceColonyId}`)
.set('Authorization', `Bearer ${beekeeperToken}`)
.send({ healthStatus: 'CRITICAL' })
.expect(200),
),
);
expect(
await prisma.domainEvent.count({
where: { type: 'ColonyStatusChanged', aggregateId: raceColonyId },
}),
).toBe(1);
await drainDomainEvents(app, [raceColonyId]);
expect(
await prisma.task.count({ where: { relatedId: raceColonyId } }),
).toBe(1);
});
});