Boarding, payment methods, journey direction on seat hold, and more updates

apps/edr-passenger-api/src/modules/tickets/tickets.controller.ts

@@ -39,6 +39,7 @@ export class TicketsController {
   @ApiQuery({ name: 'arrivalDate', required: false })
   @ApiQuery({ name: 'dateFrom', required: false })
   @ApiQuery({ name: 'dateTo', required: false })
+  @ApiQuery({ name: 'coachId', required: false })
   @ApiQuery({ name: 'skip', required: false })
   @ApiQuery({ name: 'take', required: false })
   listTickets(
@@ -49,6 +50,7 @@ export class TicketsController {
     @Query('arrivalDate') arrivalDate?: string,
     @Query('dateFrom') dateFrom?: string,
     @Query('dateTo') dateTo?: string,
+    @Query('coachId') coachId?: string,
     @Query('skip') skip?: string,
     @Query('take') take?: string,
   ) {
@@ -60,6 +62,7 @@ export class TicketsController {
       arrivalDate,
       dateFrom,
       dateTo,
+      coachId,
       skip: skip ? parseInt(skip) : 0,
       take: take ? parseInt(take) : 50,
     });
@@ -83,6 +86,31 @@ export class TicketsController {
     return this.service.getByRef(ref); 
   }
   
+  @Post('scan-board/:qrCodeOrRef')
+  @UseGuards(JwtGuard)
+  @ApiBearerAuth('JWT-auth')
+  @ApiOperation({
+    summary: 'Scan QR code or booking ref and automatically board ticket',
+    description: 'Scans ticket QR code or booking reference and automatically boards the passenger. Handles errors like expired tickets, already used tickets, etc. Designed for mobile boarding interface.'
+  })
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['validatorId'],
+      properties: {
+        validatorId: { type: 'string', example: 'agent-uuid' },
+        gateId: { type: 'string', example: 'gate-01' },
+      },
+    },
+  })
+  scanAndBoard(
+    @Param('qrCodeOrRef') qrCodeOrRef: string,
+    @Body('validatorId') validatorId: string,
+    @Body('gateId') gateId?: string,
+  ) {
+    return this.service.scanAndBoard(qrCodeOrRef, validatorId, gateId);
+  }
+
   @Post(':bookingRef/validate')
   @UseGuards(JwtGuard)
   @ApiBearerAuth('JWT-auth')