train

apps/edr-freight-api/src/modules/wagons/wagon-transfer-requests.controller.ts

@@ -0,0 +1,76 @@
+import { WagonTransferRequestStatus } from '@edr/types';
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Post,
+  Query,
+} from '@nestjs/common';
+import { ApiOperation, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { CurrentUser } from '@edr/api-common';
+import type { TCurrentUser } from '@tria-plc/api-common/modules/auth/types/current-user.type';
+
+import {
+  FleetManage,
+  FleetView,
+  WagonTransferFulfill,
+  WagonTransferRequest,
+} from '../../common/booking-guards';
+import { CreateTransferRequestDto } from './dto/create-transfer-request.dto';
+import { FulfillTransferRequestDto } from './dto/fulfill-transfer-request.dto';
+import { WagonTransferRequestsService } from './wagon-transfer-requests.service';
+
+/**
+ * Two-person wagon-transfer queue. Requester (transfer_request perm) files a
+ * count-only request; OCC (transfer_fulfill perm) picks the wagons and executes
+ * the move. Separate top-level path so it never collides with `wagons/:id`.
+ */
+@ApiTags('wagon-transfer-requests')
+@Controller('wagon-transfer-requests')
+@FleetView()
+export class WagonTransferRequestsController {
+  constructor(private readonly service: WagonTransferRequestsService) {}
+
+  @Post()
+  @WagonTransferRequest()
+  @ApiOperation({ summary: 'File a count-only wagon-transfer request' })
+  create(
+    @Body() dto: CreateTransferRequestDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.service.createRequest(dto, user?.id);
+  }
+
+  @Get()
+  @ApiQuery({ name: 'status', required: false, enum: WagonTransferRequestStatus })
+  @ApiOperation({ summary: 'List transfer requests (OCC queue: status=PENDING)' })
+  list(@Query('status') status?: WagonTransferRequestStatus) {
+    return this.service.listRequests(status);
+  }
+
+  @Get(':id')
+  @ApiOperation({ summary: 'Get one transfer request' })
+  findOne(@Param('id', ParseUUIDPipe) id: string) {
+    return this.service.findById(id);
+  }
+
+  @Post(':id/fulfill')
+  @WagonTransferFulfill()
+  @ApiOperation({ summary: 'OCC: pick wagons and execute the transfer' })
+  fulfill(
+    @Param('id', ParseUUIDPipe) id: string,
+    @Body() dto: FulfillTransferRequestDto,
+    @CurrentUser() user: TCurrentUser,
+  ) {
+    return this.service.fulfillRequest(id, dto, user?.id);
+  }
+
+  @Post(':id/cancel')
+  @FleetManage()
+  @ApiOperation({ summary: 'Withdraw a pending transfer request' })
+  cancel(@Param('id', ParseUUIDPipe) id: string) {
+    return this.service.cancelRequest(id);
+  }
+}