Initial attendee management

apps/backend/src/modules/attendees/features/create/route.ts

@@ -0,0 +1,21 @@
+import { type CreateAttendee, CreateAttendeeSchema } from '@gruperly/shared';
+import { Hono } from 'hono';
+import { problemJson, resultJson, unauthorizedProblem } from '@/http/problem-details';
+import { validate } from '@/http/validate';
+import { CreateAttendeeUseCase } from './use-case';
+
+const route = new Hono();
+
+route.post('/:groupId/attendees', validate.json(CreateAttendeeSchema), async (c) => {
+  const user = c.get('user');
+  if (!user) {
+    return problemJson(c, unauthorizedProblem(c.req.path));
+  }
+  const groupId = c.req.param('groupId');
+  const body = c.req.valid('json') as CreateAttendee;
+  const useCase = new CreateAttendeeUseCase();
+  const result = await useCase.execute(groupId, user.id, body);
+  return resultJson(c, result, { status: 201 });
+});
+
+export default route;

apps/backend/src/modules/attendees/features/create/use-case.ts

@@ -0,0 +1,72 @@
+import type { PrismaClient } from '@generated/prisma/client';
+import type { AttendeeDto, CreateAttendee, ProblemDetails, Result } from '@gruperly/shared';
+import { err, ok } from '@gruperly/shared';
+import { conflictProblem, noGroupAccessProblem, notFoundResourceProblem } from '@/http/problem-builders';
+import prisma from '@/lib/prisma';
+import { type AttendeeRecord, normalizePhone, toAttendeeDto } from '../../lib/helpers';
+
+type CreateAttendeeDeps = {
+  db?: Pick<PrismaClient, 'group' | 'attendee'>;
+};
+
+export class CreateAttendeeUseCase {
+  constructor(private readonly deps: CreateAttendeeDeps = {}) {}
+
+  async execute(
+    groupId: string,
+    userId: string,
+    payload: CreateAttendee,
+  ): Promise<Result<AttendeeDto, ProblemDetails>> {
+    const db = this.deps.db ?? prisma;
+
+    const group = await db.group.findUnique({
+      where: { id: groupId },
+      include: {
+        members: { where: { userId } },
+      },
+    });
+
+    if (!group) {
+      return err(notFoundResourceProblem('Group', groupId));
+    }
+
+    const isOwner = group.createdById === userId;
+    const isMember = group.members.length > 0;
+    if (!isOwner && !isMember) {
+      return err(noGroupAccessProblem());
+    }
+
+    const phone = normalizePhone(payload.phone);
+    const existing = await db.attendee.findFirst({
+      where: {
+        groupId,
+        OR: [
+          { phone },
+          { phone: payload.phone.trim() },
+        ],
+      },
+    });
+
+    if (existing) {
+      return err(
+        conflictProblem({
+          detail: 'Ya existe un alumno registrado con este número de teléfono en este grupo.',
+          code: 'attendee_already_registered',
+        }),
+      );
+    }
+
+    const fullName = `${payload.firstName.trim()} ${payload.lastName.trim()}`.trim();
+    const attendee = await db.attendee.create({
+      data: {
+        groupId,
+        fullName,
+        phone,
+        email: payload.email?.trim() || null,
+        notes: payload.notes?.trim() || null,
+      },
+    });
+
+    return ok(toAttendeeDto(attendee as unknown as AttendeeRecord));
+  }
+}