SnakeAid Release: The Snake Catching and Rescue Pairing

.vscode/launch.json

@@ -33,7 +33,7 @@
             "cwd": "${workspaceFolder}/SnakeAid.Api",
             "stopAtEntry": false,
             "serverReadyAction": {
-                "pattern": "Now listening on:\\s+(https://[^\\s]+:7026)",
+                "pattern": "Now listening on:\\s+(https://[^\\s]+:8081)",
                 "uriFormat": "%s",
                 "action": "openExternally"
             },
@@ -58,7 +58,7 @@
             "cwd": "${workspaceFolder}/SnakeAid.Api",
             "stopAtEntry": false,
             "serverReadyAction": {
-                "pattern": "Now listening on:\\s+(http://[^\\s]+:5009)",
+                "pattern": "Now listening on:\\s+(http://[^\\s]+:8080)",
                 "uriFormat": "%s",
                 "action": "openExternally"
             },
@@ -83,7 +83,7 @@
             "cwd": "${workspaceFolder}/SnakeAid.Api",
             "stopAtEntry": false,
             "serverReadyAction": {
-                "pattern": "Now listening on:\\s+(https://[^\\s]+:7026)",
+                "pattern": "Now listening on:\\s+(https://[^\\s]+:8081)",
                 "uriFormat": "%s",
                 "action": "openExternally"
             },

SnakeAid.Api/Controllers/CatchingMissionDetailController.cs

@@ -0,0 +1,52 @@
+using MapsterMapper;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using SnakeAid.Core.Meta;
+using SnakeAid.Core.Requests.SnakeCatchingMission;
+using SnakeAid.Core.Responses.SnakeCatchingMission;
+using SnakeAid.Core.Validators;
+using SnakeAid.Service.Interfaces;
+using Swashbuckle.AspNetCore.Annotations;
+
+namespace SnakeAid.Api.Controllers
+{
+    [Route("api/catchingmission/details")]
+    [ApiController]
+    [Authorize]
+    public class CatchingMissionDetailController : BaseController<CatchingMissionDetailController>
+    {
+        private readonly ICatchingMissionDetailService _catchingMissionDetailService;
+
+        public CatchingMissionDetailController(
+            ILogger<CatchingMissionDetailController> logger,
+            IHttpContextAccessor httpContextAccessor,
+            IMapper mapper,
+            ICatchingMissionDetailService catchingMissionDetailService)
+            : base(logger, httpContextAccessor, mapper)
+        {
+            _catchingMissionDetailService = catchingMissionDetailService;
+        }
+
+        /// <summary>
+        /// Create a new catching mission detail
+        /// </summary>
+        /// <remarks>
+        /// Records the details of snakes caught during a mission, including species and quantity.
+        /// This should be called when recording the results of a catching mission.
+        /// </remarks>
+        [HttpPost]
+        [ValidateModel]
+        [SwaggerOperation(
+            Summary = "Create Catching Mission Detail",
+            Description = "Create a new catching mission detail record for snakes caught during a mission")]
+        [SwaggerResponse(200, "Created successfully", typeof(ApiResponse<CatchingMissionDetailResponse>))]
+        [SwaggerResponse(400, "Validation error or invalid data")]
+        [SwaggerResponse(401, "Unauthorized")]
+        [SwaggerResponse(404, "Mission or snake species not found")]
+        public async Task<IActionResult> CreateCatchingMissionDetail([FromBody] CreateCatchingMissionDetailRequest request)
+        {
+            var result = await _catchingMissionDetailService.CreateCatchingMissionDetailAsync(request);
+            return Ok(ApiResponseBuilder.BuildSuccessResponse(result, "Catching mission detail created successfully!"));
+        }
+    }
+}

SnakeAid.Api/Controllers/MonitoringController.cs

@@ -0,0 +1,86 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using SnakeAid.Core.Meta;
+using SnakeAid.Service.Interfaces;
+using Swashbuckle.AspNetCore.Annotations;
+
+namespace SnakeAid.Api.Controllers
+{
+    [Route("api/monitoring")]
+    [ApiController]
+    // [Authorize] // Only authenticated users can access monitoring
+    public class MonitoringController : ControllerBase
+    {
+        private readonly ISessionTimeoutService _timeoutService;
+        private readonly ILogger<MonitoringController> _logger;
+
+        public MonitoringController(
+            ISessionTimeoutService timeoutService,
+            ILogger<MonitoringController> logger)
+        {
+            _timeoutService = timeoutService;
+            _logger = logger;
+        }
+
+
+        /// Get session timeout service status
+        [HttpGet("session-timeout-status")]
+        [SwaggerOperation(Summary = "Session Timeout Status", Description = "Get current status of session timeout monitoring service")]
+        [SwaggerResponse(200, "Service status retrieved", typeof(ApiResponse<object>))]
+        public IActionResult GetSessionTimeoutStatus()
+        {
+            try
+            {
+                var (totalSessions, expiredCount, pendingCount) = _timeoutService.GetQueueStatus();
+                var isHealthy = _timeoutService.IsHealthy();
+
+                var status = new
+                {
+                    IsHealthy = isHealthy,
+                    TotalSessionsMonitored = totalSessions,
+                    ExpiredSessionsInQueue = expiredCount,
+                    PendingSessionsInQueue = pendingCount,
+                    CheckedAt = DateTime.UtcNow,
+                    ServiceStatus = isHealthy ? "Healthy" : "Unhealthy"
+                };
+
+                var response = ApiResponseBuilder.BuildSuccessResponse(status, "Session timeout service status retrieved");
+                return Ok(response);
+            }
+            catch (Exception ex)
+            {
+                _logger.LogError(ex, "Error retrieving session timeout status: {Message}", ex.Message);
+                var response = ApiResponseBuilder.BuildErrorResponse("Failed to retrieve session timeout status");
+                return StatusCode(500, response);
+            }
+        }
+
+
+        /// Health check endpoint for session timeout service
+        [HttpGet("health/session-timeout")]
+        [SwaggerOperation(Summary = "Session Timeout Health Check", Description = "Simple health check for session timeout monitoring")]
+        [SwaggerResponse(200, "Service is healthy")]
+        [SwaggerResponse(503, "Service is unhealthy")]
+        public IActionResult SessionTimeoutHealthCheck()
+        {
+            try
+            {
+                var isHealthy = _timeoutService.IsHealthy();
+
+                if (isHealthy)
+                {
+                    return Ok(new { Status = "Healthy", CheckedAt = DateTime.UtcNow });
+                }
+                else
+                {
+                    return StatusCode(503, new { Status = "Unhealthy", CheckedAt = DateTime.UtcNow });
+                }
+            }
+            catch (Exception ex)
+            {
+                _logger.LogError(ex, "Session timeout health check failed: {Message}", ex.Message);
+                return StatusCode(503, new { Status = "Unhealthy", Error = ex.Message, CheckedAt = DateTime.UtcNow });
+            }
+        }
+    }
+}