Nationality, guest booking, waafi adapter, overall booking flow updates

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

@@ -11,13 +11,25 @@ export class TicketsController {
   constructor(private service: TicketsService) {}
   
   @Get(':bookingRef')
-  @ApiOperation({ summary: 'Get ticket by booking reference' })
+  @ApiOperation({ 
+    summary: 'Get ticket with QR code and passenger details',
+    description: `Returns ticket information including:
+- QR code for gate scanning
+- Barcode for offline validation
+- Passenger details (name, age category, nationality)
+- Journey details (origin, destination, seat, coach)
+- Fare breakdown with currency
+- PDF download link`
+  })
   getByRef(@Param('bookingRef') ref: string) { 
     return this.service.getByRef(ref); 
   }
   
   @Post(':bookingRef/validate')
-  @ApiOperation({ summary: 'Validate ticket at gate (staff)' })
+  @ApiOperation({ 
+    summary: 'Validate ticket at gate with audit logging',
+    description: 'Validates ticket QR/barcode at station gate. Records validation in audit log with timestamp, gate, and validator.'
+  })
   validate(
     @Param('bookingRef') ref: string, 
     @Body('validatorId') validatorId: string,