edr-platform/apps/edr-freight-api/src/modules/first-mile/first-mile.controller.ts

import {
  Body,
  Controller,
  Delete,
  Get,
  HttpCode,
  HttpStatus,
  Param,
  ParseUUIDPipe,
  Patch,
  Post,
  Query,
} from '@nestjs/common';
import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';

import { TrainSchedulingManage, TrainSchedulingView } from '../../common/booking-guards';

import { CreateFirstMileDto } from './dto/create-first-mile.dto';
import { UpdateFirstMileDto } from './dto/update-first-mile.dto';
import { AllocateFirstMileContainersDto } from './dto/allocate-containers.dto';
import { FirstMileStatus } from './entities/first-mile.entity';
import { FirstMileService } from './first-mile.service';
import { FirstMileInvoiceService } from './first-mile-invoice.service';
import { BillingService } from '../billing/billing.service';
import { BookingsService } from '../bookings/bookings.service';
import { Freight } from '@edr/types';

@ApiTags('first-mile')
@ApiBearerAuth()
@Controller('first-mile')
@TrainSchedulingView()
export class FirstMileController {
  constructor(
    private readonly firstMileService: FirstMileService,
    private readonly firstMileInvoiceService: FirstMileInvoiceService,
    private readonly billingService: BillingService,
    private readonly bookingsService: BookingsService
  ) { }

  @Get()
  @ApiOperation({ summary: 'List first-mile legs' })
  findAll(
    @Query('status') status?: string,
    @Query('bookingId') bookingId?: string,
    @Query('vehicleId') vehicleId?: string,
    @Query('page') page?: string,
    @Query('pageSize') pageSize?: string,
    @Query('sortBy') sortBy?: string,
    @Query('sortOrder') sortOrder?: 'ASC' | 'DESC',
  ) {
    return this.firstMileService.findAll({
      status: status as FirstMileStatus | undefined,
      bookingId,
      vehicleId,
      page: page ? parseInt(page, 10) : undefined,
      pageSize: pageSize ? parseInt(pageSize, 10) : undefined,
      sortBy,
      sortOrder,
    });
  }

  @Get(':id')
  @ApiOperation({ summary: 'Get a first-mile leg by ID' })
  findOne(@Param('id', ParseUUIDPipe) id: string) {
    return this.firstMileService.findById(id);
  }

  @Post('accept/:reference')
  @TrainSchedulingManage()
  @ApiOperation({ summary: 'Accept a paid booking and create a first-mile leg' })
  acceptBooking(@Param('reference') reference: string) {
    return this.firstMileService.acceptBookingByReference(reference);
  }

  @Post()
  @TrainSchedulingManage()
  @ApiOperation({ summary: 'Create a first-mile leg' })
  create(@Body() dto: CreateFirstMileDto) {
    return this.firstMileService.create(dto);
  }

  @Patch(':id')
  @TrainSchedulingManage()
  @ApiOperation({ summary: 'Update a first-mile leg' })
  async update(@Param('id', ParseUUIDPipe) id: string, @Body() dto: UpdateFirstMileDto) {
    const record = await this.firstMileService.update(id, dto);
    // Auto-generate invoice if distance or payment was updated
    const booking  = await this.bookingsService.findById(record.bookingId);
    if (dto.exactKm !== undefined || dto.exactKm != record.exactKm || dto.remainingPayment !== undefined || dto.remainingPayment !== record.remainingPayment) {
    await this.billingService.generateInvoice({
      source: Freight.InvoiceSource.FirstMile,
      sourceId: record.id,
      type: "FIRST_MILE",
      companyId: booking.companyId,
      companyProfileId: booking.companyProfileId,
      currency: "ETB",

      lines: [
        {
          chargeType: "FIRST_MILE",
          description: "First Mile Transportation Service",
          quantity: 1,
          unitRate: record.remainingPayment,
          amount: record.remainingPayment,
          currency: "ETB",
        },
      ],

      subtotalAmount: record.remainingPayment,
      taxAmount: 0, // Replace if VAT/tax applies
      totalAmount: record.remainingPayment,

      dueInDays: 7,
      status: Freight.InvoiceStatus.Pending,
    });
      await this.firstMileInvoiceService.ensureInvoiceFor(record);
    }
    return record;
  }

  @Delete(':id')
  @TrainSchedulingManage()
  @HttpCode(HttpStatus.NO_CONTENT)
  @ApiOperation({ summary: 'Soft-delete a first-mile leg' })
  remove(@Param('id', ParseUUIDPipe) id: string) {
    return this.firstMileService.remove(id);
  }

  @Post(':firstMileId/allocate-containers')
  @TrainSchedulingManage()
  @ApiOperation({ summary: 'Allocate containers to vehicles for a first-mile leg' })
  allocateContainers(
    @Param('firstMileId', ParseUUIDPipe) firstMileId: string,
    @Body() dto: AllocateFirstMileContainersDto,
  ) {
    return this.firstMileService.allocateContainers(firstMileId, dto.allocations);
  }
}