Coaches, seats, schedules, and pricing related updates

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

@@ -1,7 +1,7 @@
 import { Body, Controller, Delete, Get, Param, Patch, Post, Query, ParseIntPipe, UseGuards } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth, ApiParam, ApiQuery, ApiResponse } from '@nestjs/swagger';
 import { SchedulesService } from './schedules.service';
-import { CreateScheduleDto, CreateFareRuleDto, UpdateScheduleStatusDto, UpdateStopTimeDto, ListSchedulesDto } from './schedules.dto';
+import { CreateScheduleDto, UpdateScheduleDto, CreateFareRuleDto, UpdateScheduleStatusDto, UpdateStopTimeDto, ListSchedulesDto, BulkCreateSchedulesDto, BulkSchedulesResponseDto } from './schedules.dto';
 import { JwtGuard } from '../../common/jwt.guard';
 import { TripStatus } from '@prisma/client';
 
@@ -10,14 +10,23 @@ import { TripStatus } from '@prisma/client';
 export class SchedulesController {
   constructor(private service: SchedulesService) {}
 
+  @Post('bulk-generate')
+  @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
+  @ApiOperation({
+    summary: 'Bulk generate repetitive schedules',
+    description: 'Creates multiple schedules automatically by repeating every X days for the next Y days. Example: repeat every 2 days for 30 days = 15 schedules.',
+  })
+  @ApiResponse({ status: 201, description: 'Schedules generated successfully' })
+  @ApiResponse({ status: 400, description: 'Invalid parameters or route not found' })
+  bulkGenerateSchedules(@Body() dto: BulkCreateSchedulesDto) {
+    return this.service.bulkGenerateSchedules(dto);
+  }
+
   @Post()
   @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
   @ApiOperation({
     summary: 'Create a train schedule from a route template',
-    description: `Creates a schedule by referencing a Route (routeId).
-Stops are automatically copied from the route's RouteStop definitions.
-You supply the actual planned arrival/departure times per stop sequence.
-Origin and destination are derived from the first and last route stop — no need to specify them manually.`,
+    description: `Creates a schedule by referencing a Route (routeId).\nStops are automatically copied from the route's RouteStop definitions.\nYou supply the actual planned arrival/departure times per stop sequence.\nOrigin and destination are derived from the first and last route stop — no need to specify them manually.`,
   })
   @ApiResponse({ status: 201, description: 'Schedule created with stops copied from route template' })
   @ApiResponse({ status: 400, description: 'Invalid times, inactive route, or missing planned times for some stops' })
@@ -40,13 +49,42 @@ Origin and destination are derived from the first and last route stop — no nee
     return this.service.listSchedules({ date, routeId, trainId, status });
   }
 
-  // Static routes before parameterised ones
+  // ===== SPECIFIC ROUTES (must come BEFORE generic :id routes) =====
+
   @Post('fares')
   @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
   @ApiOperation({ summary: 'Create a fare rule scoped to a schedule or route code' })
   @ApiResponse({ status: 201, description: 'Fare rule created' })
   createFareRule(@Body() dto: CreateFareRuleDto) { return this.service.createFareRule(dto); }
 
+  @Post('segment-fares')
+  @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
+  @ApiOperation({ summary: 'Create a segment fare rule (stop-to-stop pricing on a route)' })
+  @ApiResponse({ status: 201, description: 'Segment fare rule created' })
+  createSegmentFareRule(@Body() dto: any) { return this.service.createSegmentFareRule(dto); }
+
+  @Get('routes/:routeId/segment-fares')
+  @ApiOperation({ summary: 'List all segment fare rules for a route' })
+  @ApiParam({ name: 'routeId', description: 'Route UUID' })
+  @ApiResponse({ status: 200, description: 'List of segment fare rules' })
+  getSegmentFares(@Param('routeId') routeId: string) { return this.service.getSegmentFares(routeId); }
+
+  @Patch('segment-fares/:id')
+  @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
+  @ApiOperation({ summary: 'Update a segment fare rule' })
+  @ApiParam({ name: 'id', description: 'SegmentFareRule UUID' })
+  @ApiResponse({ status: 200, description: 'Segment fare rule updated' })
+  updateSegmentFareRule(@Param('id') id: string, @Body() dto: any) { return this.service.updateSegmentFareRule(id, dto); }
+
+  @Delete('segment-fares/:id')
+  @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
+  @ApiOperation({ summary: 'Delete a segment fare rule' })
+  @ApiParam({ name: 'id', description: 'SegmentFareRule UUID' })
+  @ApiResponse({ status: 200, description: 'Segment fare rule deleted' })
+  deleteSegmentFareRule(@Param('id') id: string) { return this.service.deleteSegmentFareRule(id); }
+
+  // ===== PARAMETRIZED ROUTES (generic :id routes come AFTER specific routes) =====
+
   @Get(':id')
   @ApiOperation({ summary: 'Get schedule with train, coaches, seats, and stop timeline' })
   @ApiParam({ name: 'id', description: 'TrainSchedule UUID' })
@@ -56,12 +94,12 @@ Origin and destination are derived from the first and last route stop — no nee
 
   @Patch(':id')
   @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
-  @ApiOperation({ summary: 'Update a schedule' })
+  @ApiOperation({ summary: 'Update a schedule (partial update - times, status, coaches)' })
   @ApiParam({ name: 'id', description: 'TrainSchedule UUID' })
   @ApiResponse({ status: 200, description: 'Schedule updated' })
   @ApiResponse({ status: 404, description: 'Schedule not found' })
-  updateSchedule(@Param('id') id: string, @Body() dto: CreateScheduleDto) {
-    return this.service.updateSchedule(id, dto);
+  updateSchedule(@Param('id') id: string, @Body() dto: UpdateScheduleDto) {
+    return this.service.updateSchedulePartial(id, dto);
   }
 
   @Patch(':id/status')
@@ -84,8 +122,6 @@ Origin and destination are derived from the first and last route stop — no nee
     return this.service.deleteSchedule(id);
   }
 
-  // ── Stop Times ─────────────────────────────────────────────────────────────
-
   @Get(':id/stops')
   @ApiOperation({ summary: 'List all stops for a schedule ordered by sequence' })
   @ApiParam({ name: 'id', description: 'TrainSchedule UUID' })
@@ -106,8 +142,6 @@ Origin and destination are derived from the first and last route stop — no nee
     @Body() dto: UpdateStopTimeDto,
   ) { return this.service.updateStop(id, sequence, dto); }
 
-  // ── Fares ──────────────────────────────────────────────────────────────────
-
   @Get(':scheduleId/fares')
   @ApiOperation({ summary: 'Get fare for a schedule and seat class from the fare engine' })
   @ApiParam({ name: 'scheduleId', description: 'TrainSchedule UUID' })
@@ -151,8 +185,6 @@ Origin and destination are derived from the first and last route stop — no nee
     return this.service.syncFaresFromEngine(id);
   }
 
-  // ── Coach Assignments ──────────────────────────────────────────────────────
-
   @Post(':id/coaches')
   @UseGuards(JwtGuard) @ApiBearerAuth('JWT-auth')
   @ApiOperation({