Add EndpointsController for endpoint CRUD operations

Introduced EndpointsController with POST, PUT, and DELETE API endpoints for managing endpoints. Utilizes MediatR to handle insert, update, and delete procedures, and retrieves configuration values as needed. Includes proper routing and response type annotations.

src/ReC.API/Controllers/EndpointsController.cs

@@ -0,0 +1,56 @@
+using MediatR;
+using Microsoft.AspNetCore.Mvc;
+using ReC.Application.Common.Procedures.DeleteProcedure;
+using ReC.Application.Common.Procedures.InsertProcedure;
+using ReC.Application.Common.Procedures.UpdateProcedure;
+using ReC.Application.Endpoints.Commands;
+
+namespace ReC.API.Controllers;
+
+[Route("api/[controller]")]
+[ApiController]
+public class EndpointsController(IMediator mediator, IConfiguration config) : ControllerBase
+{
+    /// <summary>
+    /// Inserts an endpoint via the ENDPOINT insert procedure.
+    /// </summary>
+    /// <param name="procedure">InsertEndpointProcedure payload.</param>
+    /// <param name="cancel">A token to cancel the operation.</param>
+    /// <returns>The created ENDPOINT identifier.</returns>
+    [HttpPost]
+    [ProducesResponseType(StatusCodes.Status201Created)]
+    public async Task<IActionResult> Post([FromBody] InsertEndpointProcedure procedure, CancellationToken cancel)
+    {
+        var id = await mediator.ExecuteInsertProcedure(procedure, config["AddedWho"], cancel);
+        return StatusCode(StatusCodes.Status201Created, id);
+    }
+
+    /// <summary>
+    /// Updates an endpoint via the ENDPOINT update procedure.
+    /// </summary>
+    /// <param name="id">ENDPOINT identifier to update.</param>
+    /// <param name="procedure">UpdateEndpointProcedure payload.</param>
+    /// <param name="cancel">A token to cancel the operation.</param>
+    /// <returns>No content on success.</returns>
+    [HttpPut("{id:long}")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    public async Task<IActionResult> Put([FromRoute] long id, [FromBody] UpdateEndpointProcedure procedure, CancellationToken cancel)
+    {
+        await mediator.ExecuteUpdateProcedure(procedure, id, cancel: cancel);
+        return NoContent();
+    }
+
+    /// <summary>
+    /// Deletes endpoints via the ENDPOINT delete procedure for the specified id range.
+    /// </summary>
+    /// <param name="procedure">DeleteEndpointProcedure payload (Start, End, Force).</param>
+    /// <param name="cancel">A token to cancel the operation.</param>
+    /// <returns>No content on success.</returns>
+    [HttpDelete]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    public async Task<IActionResult> Delete([FromBody] DeleteEndpointProcedure procedure, CancellationToken cancel)
+    {
+        await mediator.ExecuteDeleteProcedure(procedure, cancel);
+        return NoContent();
+    }
+}