Implemened verifayda and currency modules

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

@@ -1,5 +1,5 @@
 import { Body, Controller, Delete, Get, Param, Post, Patch, UseGuards } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { ApiTags, ApiOperation, ApiBearerAuth, ApiResponse } from '@nestjs/swagger';
 import { BookingsService } from './bookings.service';
 import { CreateBookingDto, ModifyBookingDto, CancelBookingDto } from './bookings.dto';
 import { JwtGuard } from '../../common/jwt.guard';
@@ -12,25 +12,51 @@ export class BookingsController {
   constructor(private service: BookingsService) {}
   
   @Post()
-  @ApiOperation({ summary: 'Create booking from seat hold' })
+  @ApiOperation({ 
+    summary: 'Create booking with age-based pricing and Verifayda verification',
+    description: `Creates a booking with the following features:
+    - Age-based pricing: CHILD (<5 years) first child free, ADULT (>=5 years) full fare
+    - Ethiopian nationals: Verified via Verifayda 2.0 (national ID NOT stored)
+    - Non-Ethiopians: Passport required, no verification
+    - Multi-currency: Display in ETB, DJF, or USD (transaction always in ETB)
+    - All passengers require dateOfBirth for age calculation`
+  })
+  @ApiResponse({ status: 201, description: 'Booking created with fare breakdown' })
+  @ApiResponse({ status: 400, description: 'Verifayda verification failed or invalid passenger data' })
+  @ApiResponse({ status: 404, description: 'Trip or seat hold not found' })
   create(@Body() dto: CreateBookingDto) { 
     return this.service.create(dto); 
   }
   
   @Get(':bookingRef')
-  @ApiOperation({ summary: 'Get booking by reference' })
+  @ApiOperation({ 
+    summary: 'Get booking details by reference',
+    description: 'Returns booking with passenger categories, Verifayda verification status, and multi-currency amounts'
+  })
+  @ApiResponse({ status: 200, description: 'Booking details with adult/child counts and currency conversion' })
+  @ApiResponse({ status: 404, description: 'Booking not found' })
   getByRef(@Param('bookingRef') ref: string) { 
     return this.service.getByRef(ref); 
   }
   
   @Patch(':bookingRef/modify')
-  @ApiOperation({ summary: 'Modify booking seats or trip' })
+  @ApiOperation({ 
+    summary: 'Modify booking seats or trip',
+    description: 'Allows modification of confirmed bookings before departure'
+  })
+  @ApiResponse({ status: 200, description: 'Booking modified successfully' })
+  @ApiResponse({ status: 400, description: 'Cannot modify cancelled or past bookings' })
   modify(@Body() dto: ModifyBookingDto) {
     return this.service.modify(dto);
   }
   
   @Delete(':bookingRef')
-  @ApiOperation({ summary: 'Cancel booking' })
+  @ApiOperation({ 
+    summary: 'Cancel booking with refund',
+    description: 'Cancels booking and processes refund (80% for confirmed bookings)'
+  })
+  @ApiResponse({ status: 200, description: 'Booking cancelled with refund amount' })
+  @ApiResponse({ status: 400, description: 'Booking already cancelled' })
   cancel(@Param('bookingRef') ref: string, @Body() dto: CancelBookingDto) { 
     return this.service.cancel(ref, dto.reason); 
   }