exams setup

packages/api/prisma/schema/exam.prisma

@@ -0,0 +1,6 @@
+model Exam {
+  id          String       @id @default(dbgenerated("uuidv7()"))
+  date        DateTime     @db.Date
+  title       String       @db.VarChar
+  memberExams MemberExam[]
+}

packages/api/prisma/schema/member.prisma

@@ -13,4 +13,5 @@ model Member {
   kuendigungzum  DateTime?    @db.Date
   marker         Boolean?
   creationDate   DateTime?    @default(now()) @db.Date
+  memberExams    MemberExam[]
 }

packages/api/prisma/schema/memberExam.prisma

@@ -0,0 +1,13 @@
+model MemberExam {
+  id          String @id @default(dbgenerated("uuidv7()")) @db.Uuid
+  targetGrade String @db.VarChar
+
+  memberId String @db.Uuid
+  member   Member @relation(fields: [memberId], references: [id])
+
+  examId String @db.Uuid
+  exam   Exam   @relation(fields: [examId], references: [id])
+
+  passed  Boolean?
+  comment String?  @db.VarChar
+}

packages/api/src/controllers/examsController.ts

@@ -0,0 +1,39 @@
+import express from "express";
+import { Body, Controller, Get, Path, Post, Query, Request, Route } from "tsoa";
+import type {
+    ExamCreationDto,
+    ExamDto,
+    ExamWithMembersDto,
+    MemberExamCreationDto,
+    MemberExamDto,
+} from "../dtos/examDto.js";
+import { inject } from "../infrastructure/di/index.js";
+import { ExamsService } from "../services/examsService.js";
+
+@Route("exams")
+export class ExamsController extends Controller {
+    private readonly examsService = inject(ExamsService);
+
+    @Post()
+    public async createExam(
+        @Request() request: express.Request,
+        @Body() newExam: ExamCreationDto,
+    ): Promise<ExamDto> {
+        return await this.examsService.createExam(newExam, request);
+    }
+
+    @Get("latest")
+    public async getLatestExam(
+        @Request() request: express.Request,
+    ): Promise<ExamWithMembersDto | null> {
+        return await this.examsService.getLatest(request);
+    }
+
+    @Post("register/{examId}")
+    public async registerForExam(
+        @Request() request: express.Request,
+        @Body() newRegistration: MemberExamCreationDto
+    ): Promise<MemberExamDto> {
+        return await this.examsService.register(newRegistration, request);
+    }
+}

packages/api/src/dtos/examDto.ts

@@ -0,0 +1,40 @@
+import {
+    type ExamModel,
+    type MemberExamModel,
+} from "../generated/prisma/models.js";
+
+export class ExamCreationDto implements Omit<ExamModel, "id"> {
+    date!: Date;
+    title!: string;
+}
+
+export class ExamDto implements ExamModel {
+    id!: string;
+    date!: Date;
+    title!: string;
+}
+
+export class MemberExamDto implements MemberExamModel {
+    id!: string;
+    targetGrade!: string;
+    memberId!: string;
+    examId!: string;
+    passed!: boolean | null;
+    comment!: string | null;
+}
+
+export class ExamWithMembersDto implements ExamModel {
+    id!: string;
+    date!: Date;
+    title!: string;
+    memberExams!: MemberExamDto[];
+}
+
+export class MemberExamCreationDto implements Omit<
+    MemberExamModel,
+    "id" | "passed" | "comment"
+> {
+    targetGrade!: string;
+    memberId!: string;
+    examId!: string;
+}

packages/api/src/services/examsService.ts

@@ -0,0 +1,57 @@
+import type { Request } from "express";
+import type {
+    ExamCreationDto,
+    ExamDto,
+    ExamWithMembersDto,
+    MemberExamCreationDto,
+    MemberExamDto,
+} from "../dtos/examDto.js";
+import { inject } from "../infrastructure/di/index.js";
+import { Injectable } from "../infrastructure/di/injectable-decorator.js";
+import { DatabaseService } from "./db/prisma.js";
+
+@Injectable()
+export class ExamsService {
+    private readonly db = inject(DatabaseService);
+    public async createExam(
+        newExam: ExamCreationDto,
+        request: Request,
+    ): Promise<ExamDto> {
+        return await this.db.doRequest(
+            async prisma =>
+                prisma.exam.create({
+                    data: newExam,
+                }),
+            request,
+        );
+    }
+    public async getLatest(
+        request: Request,
+    ): Promise<ExamWithMembersDto | null> {
+        return await this.db.doRequest(
+            async prisma =>
+                prisma.exam.findFirst({
+                    orderBy: { date: "desc" },
+                    include: { memberExams: true },
+                }),
+            request,
+        );
+    }
+
+    public async register(
+        creationDto: MemberExamCreationDto,
+        request: Request,
+    ): Promise<MemberExamDto> {
+        return await this.db.doRequest(
+            async prisma =>
+                prisma.memberExam.create({
+                    data: {
+                        examId: creationDto.examId,
+                        memberId: creationDto.memberId,
+                        targetGrade: creationDto.targetGrade,
+                    },
+                }),
+            request,
+        );
+    }
+}