More AI changes

Lutra/Lutra.API/Controllers/HealthController.cs

@@ -1,14 +1,22 @@
-using Microsoft.AspNetCore.Http.HttpResults;
 using Microsoft.AspNetCore.Mvc;
 
 namespace Lutra.API.Controllers;
 
+/// <summary>
+/// Exposes a lightweight health check for the API.
+/// </summary>
 [ApiController]
 [Route("health")]
-public class HealthController : Controller
+[Produces("application/json")]
+[ProducesResponseType(StatusCodes.Status200OK)]
+public class HealthController : ControllerBase
 {
+    /// <summary>
+    /// Returns the API health status.
+    /// </summary>
+    [HttpGet]
     public IActionResult Index()
     {
         return Ok();
     }
-}
+}

Lutra/Lutra.API/Controllers/SupermarktenController.cs

@@ -0,0 +1,32 @@
+using Cortex.Mediator;
+using Lutra.Application.Supermarkten;
+using Lutra.Application.Verspakketten;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Lutra.API.Controllers;
+
+/// <summary>
+/// Provides a dedicated endpoint group for Supermarkt-related operations.
+/// </summary>
+/// <remarks>
+/// This controller is intentionally empty for now. Endpoints will be added when the Supermarkt
+/// use cases are implemented.
+/// </remarks>
+[ApiController]
+[Route("api/supermarkten")]
+[Produces("application/json")]
+public class SupermarktenController(IMediator mediator) : ControllerBase
+{ 
+    /// <summary>
+    /// Gets a page of supermarkten.
+    /// </summary>
+    /// <param name="skip">The number of items to skip.</param>
+    /// <param name="take">The maximum number of items to return.</param>
+    /// <returns>The requested verspakket page.</returns>
+    [HttpGet]
+    [ProducesResponseType(typeof(GetSupermarkten.Response), StatusCodes.Status200OK)]
+    public async Task<GetSupermarkten.Response> Get(int skip = 0, int take = 50)
+    {
+        return await mediator.SendQueryAsync<GetSupermarkten.Query, GetSupermarkten.Response>(new GetSupermarkten.Query(skip, take));
+    }
+}

Lutra/Lutra.API/Controllers/VerspakkettenController.cs

@@ -4,14 +4,25 @@ using Microsoft.AspNetCore.Mvc;
 
 namespace Lutra.API.Controllers
 {
+    /// <summary>
+    /// Provides read-only access to verspakket resources.
+    /// </summary>
     [ApiController]
     [Route("api/verspakketten")]
+    [Produces("application/json")]
     public class VerspakkettenController(IMediator mediator) : ControllerBase
     {
+        /// <summary>
+        /// Gets a page of verspakketten.
+        /// </summary>
+        /// <param name="skip">The number of items to skip.</param>
+        /// <param name="take">The maximum number of items to return.</param>
+        /// <returns>The requested verspakket page.</returns>
         [HttpGet]
-        public async Task<GetVerspakketten.Response> GetAll(int skip = 0, int take = 50)
+        [ProducesResponseType(typeof(GetVerspakketten.Response), StatusCodes.Status200OK)]
+        public async Task<GetVerspakketten.Response> Get(int skip = 0, int take = 50)
         {
             return await mediator.SendQueryAsync<GetVerspakketten.Query, GetVerspakketten.Response>(new GetVerspakketten.Query(skip, take));
         }
     }
-}
+}