feat(backend): Dashboard-Modul (Modul 13)

DashboardModule mit Kennzahlen-Übersicht sowie Alerts fuer
überfällige Aufgaben, auffällige Völker und Lagerartikel unter
Mindestbestand.

ApiCore-Backend/test/dashboard.e2e-spec.ts

@@ -0,0 +1,92 @@
+import { INestApplication } from '@nestjs/common';
+import * as bcrypt from 'bcryptjs';
+import request from 'supertest';
+import { App } from 'supertest/types';
+import { PrismaService } from '../src/prisma/prisma.service';
+import { createTestApp } from './utils/create-test-app';
+import { login } from './utils/api';
+
+interface SummaryBody {
+  apiariesActive: number;
+  coloniesActive: number;
+}
+
+interface AlertBody {
+  type: string;
+  relatedType: string;
+  relatedId: string;
+}
+
+describe('Dashboard (e2e)', () => {
+  let app: INestApplication<App>;
+  let prisma: PrismaService;
+  const readonlyEmail = `dashboard-e2e-readonly-${Date.now()}@example.com`;
+  const password = 'SuperSecret123!';
+  let readonlyId: string;
+  let readonlyToken: string;
+  let apiaryId: string;
+  let colonyId: string;
+
+  beforeAll(async () => {
+    app = await createTestApp();
+    prisma = app.get(PrismaService);
+
+    const passwordHash = await bcrypt.hash(password, 12);
+    const readonly = await prisma.user.create({
+      data: {
+        email: readonlyEmail,
+        passwordHash,
+        name: 'Readonly',
+        role: 'READONLY',
+      },
+    });
+    readonlyId = readonly.id;
+    readonlyToken = (await login(app, readonlyEmail, password)).accessToken;
+
+    const apiary = await prisma.apiary.create({
+      data: { name: `Stand ${Date.now()}` },
+    });
+    apiaryId = apiary.id;
+    const colony = await prisma.colony.create({
+      data: {
+        code: `V-${Date.now()}`,
+        apiaryId,
+        colonyType: 'PRODUCTION_COLONY',
+        status: 'WEAK',
+      },
+    });
+    colonyId = colony.id;
+  });
+
+  afterAll(async () => {
+    await prisma.colony.deleteMany({ where: { id: colonyId } });
+    await prisma.apiary.deleteMany({ where: { id: apiaryId } });
+    await prisma.refreshToken.deleteMany({ where: { userId: readonlyId } });
+    await prisma.auditLog.deleteMany({ where: { userId: readonlyId } });
+    await prisma.user.deleteMany({ where: { id: readonlyId } });
+    await app.close();
+  });
+
+  it('returns aggregate counts in the summary', async () => {
+    const response = await request(app.getHttpServer())
+      .get('/api/v1/dashboard/summary')
+      .set('Authorization', `Bearer ${readonlyToken}`)
+      .expect(200);
+    const summary = response.body as SummaryBody;
+    expect(summary.apiariesActive).toBeGreaterThanOrEqual(1);
+  });
+
+  it('flags a colony requiring attention in the alerts', async () => {
+    const response = await request(app.getHttpServer())
+      .get('/api/v1/dashboard/alerts')
+      .set('Authorization', `Bearer ${readonlyToken}`)
+      .expect(200);
+    const alerts = response.body as AlertBody[];
+    expect(
+      alerts.some(
+        (alert) =>
+          alert.relatedType === 'Colony' && alert.relatedId === colonyId,
+      ),
+    ).toBe(true);
+  });
+});