ProductionPlanController.cs

using Microsoft.AspNetCore.Mvc;
using PowerplantCodingChallenge.Application.DTOs;
using PowerplantCodingChallenge.Application.Interfaces;

namespace PowerplantCodingChallenge.API.Controllers;

/// <summary>
/// Controller for calculating the powerplant production plan
/// </summary>
[ApiController]
[Route("productionplan")]
[Produces("application/json")]
public class ProductionPlanController : ControllerBase
{
    private readonly IProductionPlanService _productionPlanService;
    private readonly ILogger<ProductionPlanController> _logger;

    public ProductionPlanController(
        IProductionPlanService productionPlanService,
        ILogger<ProductionPlanController> logger)
    {
        _productionPlanService = productionPlanService;
        _logger = logger;
    }

    /// <summary>
    /// Calculates the optimal production plan to satisfy the requested load
    /// </summary>
    /// <param name="request">Market data and powerplant configuration (load, fuel prices, available powerplants)</param>
    /// <returns>Production plan indicating the power (in MW) to be generated by each powerplant</returns>
    /// <remarks>
    /// Request example:
    /// 
    ///     POST /productionplan
    ///     {
    ///       "load": 910,
    ///       "fuels": {
    ///         "gas(euro/MWh)": 13.4,
    ///         "kerosine(euro/MWh)": 50.8,
    ///         "co2(euro/ton)": 20,
    ///         "wind(%)": 60
    ///       },
    ///       "powerplants": [
    ///         {
    ///           "name": "gasfiredbig1",
    ///           "type": "gasfired",
    ///           "efficiency": 0.53,
    ///           "pmin": 100,
    ///           "pmax": 460
    ///         }
    ///       ]
    ///     }
    /// 
    /// Expected response:
    /// 
    ///     [
    ///       {
    ///         "name": "gasfiredbig1",
    ///         "p": 460.0
    ///       }
    ///     ]
    /// 
    /// </remarks>
    /// <response code="200">Production plan calculated successfully</response>
    /// <response code="400">Invalid data or load cannot be satisfied</response>
    /// <response code="500">Internal server error</response>
    [HttpPost]
    [ProducesResponseType(typeof(List<ProductionPlanResponse>), StatusCodes.Status200OK)]
    [ProducesResponseType(typeof(object), StatusCodes.Status400BadRequest)]
    [ProducesResponseType(typeof(object), StatusCodes.Status500InternalServerError)]
    public ActionResult<List<ProductionPlanResponse>> Post([FromBody] ProductionPlanRequest request)
    {
        _logger.LogInformation("Received production plan request for load: {Load} MWh", request.Load);

        try
        {
            var result = _productionPlanService.CalculateProductionPlan(request);

            _logger.LogInformation("Production plan calculated successfully. Total plants: {Count}", result.Count);

            return Ok(result);
        }
        catch (InvalidOperationException ex)
        {
            _logger.LogWarning(ex, "Cannot satisfy load requirement");
            return BadRequest(new { error = ex.Message });
        }
        catch (ArgumentException ex)
        {
            _logger.LogWarning(ex, "Invalid argument in request");
            return BadRequest(new { error = ex.Message });
        }
    }
}