feat(backend): Bienenstaende-Modul (Modul 2)

ApiariesModule: CRUD + Deactivate. Lesen fuer alle authentifizierten
Rollen offen, Schreiben (Anlegen/Aendern/Deaktivieren) auf ADMIN und
BEEKEEPER beschraenkt (Lastenheft §3.2: Imker verwaltet Bienenstaende).
Audit-Log-Eintraege bei Create/Update/Deactivate ueber AuditLogService.

4 Unit-Tests + 4 e2e-Tests (inkl. Rollenpruefung READONLY vs. BEEKEEPER),
Lint, Typecheck und Build gruen.

ApiCore-Backend/src/apiaries/apiaries.controller.ts

@@ -0,0 +1,51 @@
+import { Body, Controller, Get, Param, Patch, Post } from '@nestjs/common';
+import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
+import { Role } from '../../generated/prisma';
+import { Roles } from '../auth/decorators/roles.decorator';
+import { CurrentUser } from '../auth/decorators/current-user.decorator';
+import type { AuthenticatedUser } from '../auth/types/authenticated-user';
+import { CreateApiaryDto } from './dto/create-apiary.dto';
+import { UpdateApiaryDto } from './dto/update-apiary.dto';
+import { ApiariesService } from './apiaries.service';
+
+@ApiTags('apiaries')
+@ApiBearerAuth()
+@Controller('apiaries')
+export class ApiariesController {
+  constructor(private readonly apiariesService: ApiariesService) {}
+
+  @Get()
+  findAll() {
+    return this.apiariesService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id') id: string) {
+    return this.apiariesService.findById(id);
+  }
+
+  @Roles(Role.ADMIN, Role.BEEKEEPER)
+  @Post()
+  create(
+    @Body() dto: CreateApiaryDto,
+    @CurrentUser() actor: AuthenticatedUser,
+  ) {
+    return this.apiariesService.create(dto, actor.id);
+  }
+
+  @Roles(Role.ADMIN, Role.BEEKEEPER)
+  @Patch(':id')
+  update(
+    @Param('id') id: string,
+    @Body() dto: UpdateApiaryDto,
+    @CurrentUser() actor: AuthenticatedUser,
+  ) {
+    return this.apiariesService.update(id, dto, actor.id);
+  }
+
+  @Roles(Role.ADMIN, Role.BEEKEEPER)
+  @Post(':id/deactivate')
+  deactivate(@Param('id') id: string, @CurrentUser() actor: AuthenticatedUser) {
+    return this.apiariesService.deactivate(id, actor.id);
+  }
+}

ApiCore-Backend/src/apiaries/apiaries.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { ApiariesController } from './apiaries.controller';
+import { ApiariesService } from './apiaries.service';
+
+@Module({
+  controllers: [ApiariesController],
+  providers: [ApiariesService],
+  exports: [ApiariesService],
+})
+export class ApiariesModule {}

ApiCore-Backend/src/apiaries/apiaries.service.spec.ts

@@ -0,0 +1,78 @@
+import { NotFoundException } from '@nestjs/common';
+import { ApiariesService } from './apiaries.service';
+import { PrismaService } from '../prisma/prisma.service';
+import { AuditLogService } from '../audit/audit-log.service';
+
+describe('ApiariesService', () => {
+  let service: ApiariesService;
+  let prisma: {
+    apiary: {
+      findMany: jest.Mock;
+      findUnique: jest.Mock;
+      create: jest.Mock;
+      update: jest.Mock;
+    };
+  };
+  let auditLog: { record: jest.Mock };
+
+  const existingApiary = {
+    id: 'apiary-1',
+    name: 'Heimstand',
+    status: 'ACTIVE',
+    deactivatedAt: null,
+  };
+
+  beforeEach(() => {
+    prisma = {
+      apiary: {
+        findMany: jest.fn(),
+        findUnique: jest.fn(),
+        create: jest.fn(),
+        update: jest.fn(),
+      },
+    };
+    auditLog = { record: jest.fn().mockResolvedValue(undefined) };
+    service = new ApiariesService(
+      prisma as unknown as PrismaService,
+      auditLog as unknown as AuditLogService,
+    );
+  });
+
+  it('findById throws NotFoundException when missing', async () => {
+    prisma.apiary.findUnique.mockResolvedValue(null);
+    await expect(service.findById('missing')).rejects.toBeInstanceOf(
+      NotFoundException,
+    );
+  });
+
+  it('create persists the apiary and records an audit entry', async () => {
+    prisma.apiary.create.mockResolvedValue(existingApiary);
+
+    const result = await service.create({ name: 'Heimstand' }, 'user-1');
+
+    expect(result).toEqual(existingApiary);
+    expect(auditLog.record).toHaveBeenCalledWith(
+      expect.objectContaining({
+        entityType: 'Apiary',
+        action: 'CREATE',
+        userId: 'user-1',
+      }),
+    );
+  });
+
+  it('deactivate sets status to INACTIVE and records an audit entry', async () => {
+    prisma.apiary.findUnique.mockResolvedValue(existingApiary);
+    prisma.apiary.update.mockResolvedValue({
+      ...existingApiary,
+      status: 'INACTIVE',
+      deactivatedAt: new Date(),
+    });
+
+    const result = await service.deactivate('apiary-1', 'user-1');
+
+    expect(result.status).toBe('INACTIVE');
+    expect(auditLog.record).toHaveBeenCalledWith(
+      expect.objectContaining({ entityType: 'Apiary', action: 'DEACTIVATE' }),
+    );
+  });
+});

ApiCore-Backend/src/apiaries/apiaries.service.ts

@@ -0,0 +1,76 @@
+import { Injectable, NotFoundException } from '@nestjs/common';
+import { PrismaService } from '../prisma/prisma.service';
+import { AuditLogService } from '../audit/audit-log.service';
+import { Apiary } from '../../generated/prisma';
+import { CreateApiaryDto } from './dto/create-apiary.dto';
+import { UpdateApiaryDto } from './dto/update-apiary.dto';
+
+@Injectable()
+export class ApiariesService {
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly auditLog: AuditLogService,
+  ) {}
+
+  async findAll(): Promise<Apiary[]> {
+    return this.prisma.apiary.findMany({ orderBy: { name: 'asc' } });
+  }
+
+  async findById(id: string): Promise<Apiary> {
+    const apiary = await this.prisma.apiary.findUnique({ where: { id } });
+    if (!apiary) {
+      throw new NotFoundException('Apiary not found');
+    }
+    return apiary;
+  }
+
+  async create(dto: CreateApiaryDto, actingUserId: string): Promise<Apiary> {
+    const apiary = await this.prisma.apiary.create({ data: { ...dto } });
+    await this.auditLog.record({
+      entityType: 'Apiary',
+      entityId: apiary.id,
+      action: 'CREATE',
+      userId: actingUserId,
+      afterData: apiary,
+    });
+    return apiary;
+  }
+
+  async update(
+    id: string,
+    dto: UpdateApiaryDto,
+    actingUserId: string,
+  ): Promise<Apiary> {
+    const before = await this.findById(id);
+    const apiary = await this.prisma.apiary.update({
+      where: { id },
+      data: { ...dto },
+    });
+    await this.auditLog.record({
+      entityType: 'Apiary',
+      entityId: id,
+      action: 'UPDATE',
+      userId: actingUserId,
+      beforeData: before,
+      afterData: apiary,
+    });
+    return apiary;
+  }
+
+  async deactivate(id: string, actingUserId: string): Promise<Apiary> {
+    const before = await this.findById(id);
+    const apiary = await this.prisma.apiary.update({
+      where: { id },
+      data: { status: 'INACTIVE', deactivatedAt: new Date() },
+    });
+    await this.auditLog.record({
+      entityType: 'Apiary',
+      entityId: id,
+      action: 'DEACTIVATE',
+      userId: actingUserId,
+      beforeData: before,
+      afterData: apiary,
+    });
+    return apiary;
+  }
+}

ApiCore-Backend/src/apiaries/dto/create-apiary.dto.ts

@@ -0,0 +1,38 @@
+import { ApiPropertyOptional, ApiProperty } from '@nestjs/swagger';
+import { IsLatitude, IsLongitude, IsOptional, IsString } from 'class-validator';
+
+export class CreateApiaryDto {
+  @ApiProperty()
+  @IsString()
+  name!: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  description?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  location?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsLatitude()
+  latitude?: number;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsLongitude()
+  longitude?: number;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  address?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  notes?: string;
+}

ApiCore-Backend/src/apiaries/dto/update-apiary.dto.ts

@@ -0,0 +1,4 @@
+import { PartialType } from '@nestjs/swagger';
+import { CreateApiaryDto } from './create-apiary.dto';
+
+export class UpdateApiaryDto extends PartialType(CreateApiaryDto) {}

ApiCore-Backend/src/app.module.ts

@@ -6,6 +6,7 @@ import { HealthModule } from './health/health.module';
 import { AuditModule } from './audit/audit.module';
 import { UsersModule } from './users/users.module';
 import { AuthModule } from './auth/auth.module';
+import { ApiariesModule } from './apiaries/apiaries.module';
 import { JwtAuthGuard } from './auth/guards/jwt-auth.guard';
 import { RolesGuard } from './auth/guards/roles.guard';
 
@@ -17,6 +18,7 @@ import { RolesGuard } from './auth/guards/roles.guard';
     HealthModule,
     UsersModule,
     AuthModule,
+    ApiariesModule,
   ],
   controllers: [],
   providers: [