From 43f8c07e69fa1a125776110df22a644aac77ead4 Mon Sep 17 00:00:00 2001
From: Hamid Reza Mohammadi <mohammadi.hr@gmail.com>
Date: Fri, 28 Mar 2025 12:46:09 +0330
Subject: [PATCH] #478 museum links

---
 .../ContributionStatsController.cs            | 29 +++++-
 RMuseum/RMuseum.xml                           | 98 +++++++++++++++++++
 2 files changed, 125 insertions(+), 2 deletions(-)

diff --git a/RMuseum/Controllers/ContributionStatsController.cs b/RMuseum/Controllers/ContributionStatsController.cs
index 378afc24..6a287acb 100644
--- a/RMuseum/Controllers/ContributionStatsController.cs
+++ b/RMuseum/Controllers/ContributionStatsController.cs
@@ -30,6 +30,7 @@ namespace RMuseum.Controllers
         /// quoteds
         /// comments
         /// recitations
+        /// museumlinks
         /// </param>
         /// <param name="paging"></param>
         /// <param name="userId"></param>
@@ -101,6 +102,14 @@ namespace RMuseum.Controllers
                             pagedResult = res.Result;
                         }
                         break;
+                    case "museumlinks":
+                        {
+                            var res = await _service.GetApprovedMuseumLinksGroupedByDateAsync(paging, userId);
+                            if (!string.IsNullOrEmpty(res.ExceptionString))
+                                return BadRequest(res.ExceptionString);
+                            pagedResult = res.Result;
+                        }
+                        break;
                     default:
                         return BadRequest($"Invalid value for the paramater: dataType = {dataType}");
                 }
@@ -123,6 +132,7 @@ namespace RMuseum.Controllers
         /// quoteds
         /// comments
         /// recitations
+        /// museumlinks
         /// </param>
         /// <param name="paging"></param>
         /// <param name="day"></param>
@@ -194,7 +204,14 @@ namespace RMuseum.Controllers
                                 return BadRequest(res.ExceptionString);
                             pagedResult = res.Result;
                         }
-
+                        break;
+                    case "museumlinks":
+                        {
+                            var res = await _service.GetApprovedMuseumLinksGroupedByUserAsync(paging, day, userId);
+                            if (!string.IsNullOrEmpty(res.ExceptionString))
+                                return BadRequest(res.ExceptionString);
+                            pagedResult = res.Result;
+                        }
                         break;
                     default:
                         return BadRequest($"Invalid value for the paramater: dataType = {dataType}");
@@ -219,6 +236,7 @@ namespace RMuseum.Controllers
         /// quoteds
         /// comments
         /// recitations
+        /// museumlinks
         /// </param>        
         /// <returns></returns>
         [HttpGet("{dataType}")]
@@ -286,7 +304,14 @@ namespace RMuseum.Controllers
                                 return BadRequest(res.ExceptionString);
                             result = res.Result;
                         }
-
+                        break;
+                    case "museumlinks":
+                        {
+                            var res = await _service.GetApprovedMuseumLinksSummedUpStatsAsync();
+                            if (!string.IsNullOrEmpty(res.ExceptionString))
+                                return BadRequest(res.ExceptionString);
+                            result = res.Result;
+                        }
                         break;
                     default:
                         return BadRequest($"Invalid value for the paramater: dataType = {dataType}");
diff --git a/RMuseum/RMuseum.xml b/RMuseum/RMuseum.xml
index ef79c597..ca0f2bcd 100644
--- a/RMuseum/RMuseum.xml
+++ b/RMuseum/RMuseum.xml
@@ -774,6 +774,8 @@
             suggestedsongs
             quoteds
             comments
+            recitations
+            museumlinks
             </param>
             <param name="paging"></param>
             <param name="userId"></param>
@@ -791,6 +793,8 @@
             suggestedsongs
             quoteds
             comments
+            recitations
+            museumlinks
             </param>
             <param name="paging"></param>
             <param name="day"></param>
@@ -809,6 +813,8 @@
             suggestedsongs
             quoteds
             comments
+            recitations
+            museumlinks
             </param>        
             <returns></returns>
         </member>
@@ -16072,6 +16078,52 @@
             </summary>
             <returns></returns>
         </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedRecitationsGroupedByDateAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.Guid})">
+            <summary>
+            approved recitations daily
+            </summary>
+            <param name="paging"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedRecitationsGroupedByUserAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.DateTime},System.Nullable{System.Guid})">
+            <summary>
+            approved recitations grouped by user
+            </summary>
+            <param name="paging"></param>
+            <param name="day"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedRecitationsSummedUpStatsAsync">
+            <summary>
+            summed up stats of approved recitations
+            </summary>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedMuseumLinksGroupedByDateAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.Guid})">
+            <summary>
+            approved museum links daily
+            </summary>
+            <param name="paging"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedMuseumLinksGroupedByUserAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.DateTime},System.Nullable{System.Guid})">
+            <summary>
+            approved museum links grouped by user
+            </summary>
+            <param name="paging"></param>
+            <param name="day"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IContributionStatsService.GetApprovedMuseumLinksSummedUpStatsAsync">
+            <summary>
+            summed up stats of approved museum links
+            </summary>
+            <returns></returns>
+        </member>
         <member name="T:RMuseum.Services.IDonationService">
             <summary>
             donation service
@@ -19116,6 +19168,52 @@
             </summary>
             <returns></returns>
         </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedRecitationsGroupedByDateAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.Guid})">
+            <summary>
+            approved recitations daily
+            </summary>
+            <param name="paging"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedRecitationsGroupedByUserAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.DateTime},System.Nullable{System.Guid})">
+            <summary>
+            approved recitations grouped by user
+            </summary>
+            <param name="paging"></param>
+            <param name="day"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedRecitationsSummedUpStatsAsync">
+            <summary>
+            summed up stats of approved recitations
+            </summary>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedMuseumLinksGroupedByDateAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.Guid})">
+            <summary>
+            approved museum links daily
+            </summary>
+            <param name="paging"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedMuseumLinksGroupedByUserAsync(RSecurityBackend.Models.Generic.PagingParameterModel,System.Nullable{System.DateTime},System.Nullable{System.Guid})">
+            <summary>
+            approved museum links grouped by user
+            </summary>
+            <param name="paging"></param>
+            <param name="day"></param>
+            <param name="userId"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.ContributionStatsService.GetApprovedMuseumLinksSummedUpStatsAsync">
+            <summary>
+            summed up stats of approved museum links
+            </summary>
+            <returns></returns>
+        </member>
         <member name="F:RMuseum.Services.Implementation.ContributionStatsService._context">
             <summary>
             Database Context