Serviço de Aluguel de Veículos

Vamos criar um sistema de Serviço de Aluguel de Veículos que gerencia uma frota de veículos, acompanha os aluguéis dos clientes e calcula os preços com base no tipo de veículo. Este desafio abrangente reúne herança, interfaces, encapsulamento e o padrão State para criar uma aplicação realista de gerenciamento de aluguéis.

Você organizará seu código em sete arquivos:

• VehicleState.php: defina uma interface VehicleState que represente os diferentes estados em que um veículo pode estar. Inclua dois métodos: getStatus(): string e canRent(): bool. Em seguida, crie três classes que implementem essa interface:
  • AvailableState: retorna "Available" e true
  • RentedState: retorna "Rented" e false
  • MaintenanceState: retorna "Maintenance" e false
• Vehicle.php: inclua o arquivo VehicleState. Crie uma classe abstrata Vehicle com promoção de construtor para licensePlate (string, public readonly), brand (string, public readonly) e dailyRate (float, protected). Armazene o estado atual em uma propriedade privada, com valor padrão AvailableState. Implemente:
  • getState(): VehicleState: retorna o estado atual
  • setState(VehicleState $state): void: altera o estado
  • getStatus(): string: delega para o getStatus() do estado
  • canRent(): bool: delega para o canRent() do estado
  • abstract calculateCost(int $days): float: cada tipo de veículo calcula de uma forma diferente
  • getType(): string: retorna o nome da classe usando static::class
• Vehicles.php: inclua o arquivo Vehicle. Crie três classes concretas de veículos:
  • Car: estende Vehicle; calculateCost() retorna dailyRate * days
  • Motorcycle: estende Vehicle; calculateCost() retorna dailyRate * days * 0.8 (desconto de 20%)
  • Van: estende Vehicle com um parâmetro adicional $mileageRate (float); calculateCost(int $days, int $miles = 0) retorna (dailyRate * days) + (mileageRate * miles)
• Customer.php: crie uma classe Customer com promoção de construtor para id (int, public readonly) e name (string, public readonly). Acompanhe o histórico de aluguéis em um array privado. Implemente:
  • addRental(string $vehiclePlate, float $cost): void: adiciona ao histórico
  • getRentalCount(): int: retorna o número de aluguéis
  • getTotalSpent(): float: retorna a soma de todos os custos de aluguel
• Rental.php: inclua os arquivos Vehicle e Customer. Crie uma classe Rental que vincule um cliente a um veículo. Use promoção de construtor para customer (Customer, public readonly), vehicle (Vehicle, public readonly), days (int, private) e, opcionalmente, miles (int, private, padrão 0). Implemente:
  • calculateTotal(): float: se o veículo for uma Van, passe miles para calculateCost(); caso contrário, passe apenas days
  • complete(): string: calcula o total, adiciona ao histórico do cliente, define o veículo como AvailableState e retorna "Rental completed: $[total]" (com 2 casas decimais)
• RentalService.php: inclua os arquivos Rental e Vehicles. Crie uma classe RentalService que gerencie a frota. Armazene os veículos em um array privado indexado pela placa. Implemente:
  • addVehicle(Vehicle $vehicle): void: adiciona à frota
  • findVehicle(string $plate): ?Vehicle: retorna o veículo ou null
  • getAvailableVehicles(): array: retorna os veículos para os quais canRent() é true
  • rentVehicle(Customer $customer, string $plate, int $days, int $miles = 0): string|Rental: se o veículo não for encontrado, retorna "Vehicle not found"; se não estiver disponível, retorna "Vehicle is not available"; caso contrário, define o veículo como RentedState e retorna um novo objeto Rental
  • setMaintenance(string $plate): string: define o veículo como MaintenanceState; retorna "[plate] set to maintenance" ou "Vehicle not found"
• main.php: inclua os arquivos RentalService e Customer. Você receberá três entradas: dados da frota (JSON), dados do cliente (JSON) e operações (JSON).

  Formato do JSON da frota:

  [{"type": "car", "plate": "CAR-001", "brand": "Toyota", "rate": 50}, {"type": "van", "plate": "VAN-001", "brand": "Ford", "rate": 80, "mileage_rate": 0.25}]

  Formato do JSON do cliente:

  {"id": 1, "name": "Alice"}

  Formato do JSON das operações:

  [{"op": "available"}, {"op": "rent", "plate": "CAR-001", "days": 3}, {"op": "complete", "plate": "CAR-001"}, {"op": "maintenance", "plate": "VAN-001"}, {"op": "customer_stats"}]

  Crie o serviço de aluguel, adicione todos os veículos à frota e crie o cliente. Acompanhe os aluguéis ativos por placa. Processe cada operação:

  • "available": imprima "Available vehicles: [count]"
  • "rent": alugue o veículo; se for bem-sucedido, armazene o Rental e imprima "Rented [plate] for [days] days"; se for uma Van, inclua miles da operação; caso contrário, imprima a mensagem de erro
  • "complete": conclua o aluguel armazenado para essa placa; imprima o resultado
  • "maintenance": imprima o resultado de setMaintenance()
  • "status": imprima "[plate]: [status]" para a placa informada
  • "customer_stats": imprima "[name]: [count] rentals, $[total] spent" (com 2 casas decimais)

  Imprima cada resultado em uma nova linha.

Este sistema demonstra como o padrão State lida elegantemente com a disponibilidade dos veículos sem condicionais complexas, como a herança cria uma hierarquia de veículos organizada com preços polimórficos e como o encapsulamento protege a integridade dos dados de aluguel durante todo o fluxo de trabalho.