Test updates by AI

Back/skydiveLogs-api/Controllers/StatsController.cs

@@ -22,6 +22,10 @@ namespace skydiveLogs_api.Controllers
 
         #region Public Methods
 
+        /// <summary>
+        /// Retrieves statistics grouped by aircraft.
+        /// </summary>
+        /// <returns>A collection of StatisticResp objects containing aircraft statistics.</returns>
         [HttpGet("ByAircraft")]
         [EnableCors]
         public IEnumerable<StatisticResp> ByAircraft()
@@ -31,6 +35,10 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticResp>>(result);
         }
 
+        /// <summary>
+        /// Retrieves statistics grouped by drop zone.
+        /// </summary>
+        /// <returns>A collection of StatisticResp objects containing drop zone statistics.</returns>
         [HttpGet("ByDz")]
         [EnableCors]
         public IEnumerable<StatisticResp> ByDz()
@@ -40,6 +48,10 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticResp>>(result);
         }
 
+        /// <summary>
+        /// Retrieves statistics grouped by gear.
+        /// </summary>
+        /// <returns>A collection of StatisticResp objects containing gear statistics.</returns>
         [HttpGet("ByGear")]
         [EnableCors]
         public IEnumerable<StatisticResp> ByGear()
@@ -49,6 +61,10 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticResp>>(result);
         }
 
+        /// <summary>
+        /// Retrieves statistics grouped by jump type.
+        /// </summary>
+        /// <returns>A collection of StatisticResp objects containing jump type statistics.</returns>
         [HttpGet("ByJumpType")]
         [EnableCors]
         public IEnumerable<StatisticResp> ByJumpType()
@@ -58,6 +74,10 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticResp>>(result);
         }
 
+        /// <summary>
+        /// Retrieves statistics grouped by year.
+        /// </summary>
+        /// <returns>A collection of StatisticResp objects containing year statistics.</returns>
         [HttpGet("ByYear")]
         [EnableCors]
         public IEnumerable<StatisticResp> ByYear()
@@ -67,6 +87,10 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticResp>>(result);
         }
 
+        /// <summary>
+        /// Retrieves statistics for the last month grouped by drop zone and jump type.
+        /// </summary>
+        /// <returns>A StatisticForLastMonthResp object containing last month statistics.</returns>
         [HttpGet("ForLastMonth")]
         [EnableCors]
         public StatisticForLastMonthResp ForLastMonth()
@@ -81,6 +105,10 @@ namespace skydiveLogs_api.Controllers
             return result;
         }
 
+        /// <summary>
+        /// Retrieves statistics for the last year grouped by drop zone and jump type.
+        /// </summary>
+        /// <returns>A StatisticForLastYearResp object containing last year statistics.</returns>
         [HttpGet("ForLastYear")]
         [EnableCors]
         public StatisticForLastYearResp ForLastYear()
@@ -95,6 +123,10 @@ namespace skydiveLogs_api.Controllers
             return result;
         }
 
+        /// <summary>
+        /// Retrieves statistics by year grouped with jump type for chart visualization.
+        /// </summary>
+        /// <returns>A collection of StatisticForChartResp objects containing yearly jump type statistics.</returns>
         [HttpGet("ByYearByJumpType")]
         [EnableCors]
         public IEnumerable<StatisticForChartResp> ByYearByJumpType()
@@ -104,6 +136,9 @@ namespace skydiveLogs_api.Controllers
             return _mapper.Map<IEnumerable<StatisticForChartResp>>(result);
         }
 
+        /// <summary>
+        /// Resets all statistics to their initial state.
+        /// </summary>
         [HttpGet("Reset")]
         [EnableCors]
         public void Reset()
@@ -111,6 +146,10 @@ namespace skydiveLogs_api.Controllers
             _statsService.Reset();
         }
 
+        /// <summary>
+        /// Retrieves a simple summary of all statistics.
+        /// </summary>
+        /// <returns>A SimpleSummaryResp object containing the simple summary statistics.</returns>
         [HttpGet("Simple")]
         [EnableCors]
         public SimpleSummaryResp Simple()
@@ -129,4 +168,4 @@ namespace skydiveLogs_api.Controllers
 
         #endregion Private properties
     }
-}
+}