ReC/src/ReC.API/Controllers/RecActionController.cs

using MediatR;
using Microsoft.AspNetCore.Mvc;
using ReC.API.Extensions;
using ReC.Application.Common.Procedures.InsertProcedure;
using ReC.Application.RecActions.Commands;
using ReC.Application.RecActions.Queries;

namespace ReC.API.Controllers;

[Route("api/[controller]")]
[ApiController]
public class RecActionController(IMediator mediator, IConfiguration config) : ControllerBase
{
    /// <summary>
    /// Invokes a batch of RecActions for a given profile.
    /// </summary>
    /// <param name="profileId">The ID of the profile.</param>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>An HTTP 202 Accepted response indicating the process has been started.</returns>
    [HttpPost("invoke/{profileId}")]
    [ProducesResponseType(StatusCodes.Status202Accepted)]
    public async Task<IActionResult> Invoke([FromRoute] int profileId, CancellationToken cancel)
    {
        await mediator.InvokeBatchRecActionView(profileId, cancel);
        return Accepted();
    }

    /// <summary>
    /// Invokes a batch of RecActions for a fake/test profile.
    /// </summary>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>An HTTP 202 Accepted response indicating the process has been started.</returns>
    [HttpPost("invoke/fake")]
    [ProducesResponseType(StatusCodes.Status202Accepted)]
    public async Task<IActionResult> Invoke(CancellationToken cancel)
    {
        await mediator.InvokeBatchRecActionView(config.GetFakeProfileId(), cancel);
        return Accepted();
    }

    #region CRUD
    /// <summary>
    /// Gets all RecActions for a given profile.
    /// </summary>
    /// <param name="query"></param>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>A list of RecActions for the specified profile.</returns>
    [HttpGet]
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<IActionResult> Get([FromQuery] ReadRecActionViewQuery query, CancellationToken cancel) => Ok(await mediator.Send(query, cancel));

    /// <summary>
    /// Gets all RecActions for a fake/test profile.
    /// </summary>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <param name="invoked"></param>
    /// <returns>A list of RecActions for the fake profile.</returns>
    [HttpGet("fake")]
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<IActionResult> Get(CancellationToken cancel, [FromQuery] bool invoked = false) => Ok(await mediator.Send(new ReadRecActionViewQuery()
    {
        ProfileId = config.GetFakeProfileId(),
        Invoked = invoked
    }, cancel));

    /// <summary>
    /// Creates a new RecAction.
    /// </summary>
    /// <param name="command">The command containing the details for the new RecAction.</param>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>An HTTP 201 Created response.</returns>
    [HttpPost]
    [ProducesResponseType(StatusCodes.Status201Created)]
    public async Task<IActionResult> CreateAction([FromBody] InsertActionProcedure command, CancellationToken cancel)
    {
        await mediator.ExecuteInsertProcedure(command, config["AddedWho"], cancel);

        return StatusCode(StatusCodes.Status201Created);
    }

    /// <summary>
    /// Deletes all RecActions associated with a specific profile.
    /// </summary>
    /// <param name="cmd"></param>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>An HTTP 204 No Content response upon successful deletion.</returns>
    [HttpDelete]
    [ProducesResponseType(StatusCodes.Status204NoContent)]
    [Obsolete("Use the related procedure.")]
    public async Task<IActionResult> Delete([FromQuery] DeleteRecActionsCommand cmd, CancellationToken cancel)
    {
        await mediator.Send(cmd, cancel);
        return NoContent();
    }

    /// <summary>
    /// Deletes all RecActions for a fake/test profile.
    /// </summary>
    /// <param name="cancel">A token to cancel the operation.</param>
    /// <returns>An HTTP 204 No Content response upon successful deletion.</returns>
    [HttpDelete("fake")]
    [ProducesResponseType(StatusCodes.Status204NoContent)]
    [Obsolete("Use the related procedure.")]
    public async Task<IActionResult> Delete(CancellationToken cancel)
    {
        await mediator.Send(new DeleteRecActionsCommand()
        {
            ProfileId = config.GetFakeProfileId()
        }, cancel);

        return NoContent();
    }
    #endregion CRUD
}