From 6463f799e122779c0da887019acc3c3e3e445efc Mon Sep 17 00:00:00 2001
From: Hamid Reza Mohammadi <mohammadi.hr@gmail.com>
Date: Thu, 24 Feb 2022 20:24:55 +0330
Subject: [PATCH] docs: #285 CRUD for FAQItem records

---
 RMuseum/DbContext/RMuseumDbContext.cs         |  5 ++
 RMuseum/RMuseum.xml                           | 59 ++++++++++++--
 RMuseum/Services/IFAQService.cs               | 28 ++++++-
 RMuseum/Services/Implementation/FAQService.cs | 81 ++++++++++++++++++-
 4 files changed, 161 insertions(+), 12 deletions(-)

diff --git a/RMuseum/DbContext/RMuseumDbContext.cs b/RMuseum/DbContext/RMuseumDbContext.cs
index 352b45a7..be882941 100644
--- a/RMuseum/DbContext/RMuseumDbContext.cs
+++ b/RMuseum/DbContext/RMuseumDbContext.cs
@@ -446,5 +446,10 @@ namespace RMuseum.DbContext
         /// </summary>
         public DbSet<FAQCategory> FAQCategories { get; set; }
 
+        /// <summary>
+        /// faq items
+        /// </summary>
+        public DbSet<FAQItem> FAQItems { get; set; }
+
     }
 }
diff --git a/RMuseum/RMuseum.xml b/RMuseum/RMuseum.xml
index dc671e19..c2940772 100644
--- a/RMuseum/RMuseum.xml
+++ b/RMuseum/RMuseum.xml
@@ -2650,6 +2650,11 @@
             faq categories
             </summary>
         </member>
+        <member name="P:RMuseum.DbContext.RMuseumDbContext.FAQItems">
+            <summary>
+            faq items
+            </summary>
+        </member>
         <member name="T:RMuseum.Models.Accounting.DonationExpenditure">
             <summary>
             donation expenditures
@@ -9976,21 +9981,42 @@
         </member>
         <member name="M:RMuseum.Services.IFAQService.AddCategoryAsync(RMuseum.Models.FAQ.FAQCategory)">
             <summary>
-            add faq category
+            add a new faq category
             </summary>
             <param name="cat"></param>
             <returns></returns>
         </member>
         <member name="M:RMuseum.Services.IFAQService.UpdateCategoryAsync(RMuseum.Models.FAQ.FAQCategory)">
             <summary>
-            update faq cateory
+            update an existing faq category
             </summary>
             <param name="cat"></param>
             <returns></returns>
         </member>
         <member name="M:RMuseum.Services.IFAQService.DeleteCategoryAsync(System.Int32)">
             <summary>
-            delete faq category
+            delete a faq category
+            </summary>
+            <param name="id"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IFAQService.AddItemAsync(RMuseum.Models.FAQ.FAQItem)">
+            <summary>
+            add a new faq item
+            </summary>
+            <param name="item"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IFAQService.UpdateItemAsync(RMuseum.Models.FAQ.FAQItem)">
+            <summary>
+            update an existing faq item
+            </summary>
+            <param name="item"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.IFAQService.DeleteItemAsync(System.Int32)">
+            <summary>
+            delete a faq item
             </summary>
             <param name="id"></param>
             <returns></returns>
@@ -11912,21 +11938,42 @@
         </member>
         <member name="M:RMuseum.Services.Implementation.FAQService.AddCategoryAsync(RMuseum.Models.FAQ.FAQCategory)">
             <summary>
-            add faq category
+            add a new faq category
             </summary>
             <param name="cat"></param>
             <returns></returns>
         </member>
         <member name="M:RMuseum.Services.Implementation.FAQService.UpdateCategoryAsync(RMuseum.Models.FAQ.FAQCategory)">
             <summary>
-            update faq cateory
+            update an existing faq category
             </summary>
             <param name="cat"></param>
             <returns></returns>
         </member>
         <member name="M:RMuseum.Services.Implementation.FAQService.DeleteCategoryAsync(System.Int32)">
             <summary>
-            delete faq category
+            delete a faq category
+            </summary>
+            <param name="id"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.FAQService.AddItemAsync(RMuseum.Models.FAQ.FAQItem)">
+            <summary>
+            add a new faq item
+            </summary>
+            <param name="item"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.FAQService.UpdateItemAsync(RMuseum.Models.FAQ.FAQItem)">
+            <summary>
+            update an existing faq item
+            </summary>
+            <param name="item"></param>
+            <returns></returns>
+        </member>
+        <member name="M:RMuseum.Services.Implementation.FAQService.DeleteItemAsync(System.Int32)">
+            <summary>
+            delete a faq item
             </summary>
             <param name="id"></param>
             <returns></returns>
diff --git a/RMuseum/Services/IFAQService.cs b/RMuseum/Services/IFAQService.cs
index 49f1d97e..c51cf9b4 100644
--- a/RMuseum/Services/IFAQService.cs
+++ b/RMuseum/Services/IFAQService.cs
@@ -11,24 +11,46 @@ namespace RMuseum.Services
     public interface IFAQService
     {
         /// <summary>
-        /// add faq category
+        /// add a new faq category
         /// </summary>
         /// <param name="cat"></param>
         /// <returns></returns>
         Task<RServiceResult<FAQCategory>> AddCategoryAsync(FAQCategory cat);
 
         /// <summary>
-        /// update faq cateory
+        /// update an existing faq category
         /// </summary>
         /// <param name="cat"></param>
         /// <returns></returns>
         Task<RServiceResult<bool>> UpdateCategoryAsync(FAQCategory cat);
 
         /// <summary>
-        /// delete faq category
+        /// delete a faq category
         /// </summary>
         /// <param name="id"></param>
         /// <returns></returns>
         Task<RServiceResult<bool>> DeleteCategoryAsync(int id);
+
+        /// <summary>
+        /// add a new faq item
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns></returns>
+        Task<RServiceResult<FAQItem>> AddItemAsync(FAQItem item);
+
+        /// <summary>
+        /// update an existing faq item
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns></returns>
+        Task<RServiceResult<bool>> UpdateItemAsync(FAQItem item);
+
+        /// <summary>
+        /// delete a faq item
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
+        Task<RServiceResult<bool>> DeleteItemAsync(int id);
+
     }
 }
diff --git a/RMuseum/Services/Implementation/FAQService.cs b/RMuseum/Services/Implementation/FAQService.cs
index d5f535c7..2a9a5ad6 100644
--- a/RMuseum/Services/Implementation/FAQService.cs
+++ b/RMuseum/Services/Implementation/FAQService.cs
@@ -16,7 +16,7 @@ namespace RMuseum.Services.Implementation
     {
 
         /// <summary>
-        /// add faq category
+        /// add a new faq category
         /// </summary>
         /// <param name="cat"></param>
         /// <returns></returns>
@@ -36,7 +36,7 @@ namespace RMuseum.Services.Implementation
         }
 
         /// <summary>
-        /// update faq cateory
+        /// update an existing faq category
         /// </summary>
         /// <param name="cat"></param>
         /// <returns></returns>
@@ -61,7 +61,7 @@ namespace RMuseum.Services.Implementation
         }
 
         /// <summary>
-        /// delete faq category
+        /// delete a faq category
         /// </summary>
         /// <param name="id"></param>
         /// <returns></returns>
@@ -81,6 +81,81 @@ namespace RMuseum.Services.Implementation
             }
         }
 
+        /// <summary>
+        /// add a new faq item
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns></returns>
+        public async Task<RServiceResult<FAQItem>> AddItemAsync(FAQItem item)
+        {
+            try
+            {
+                _context.FAQItems.Add(item);
+                await _context.SaveChangesAsync();
+
+                return new RServiceResult<FAQItem>(item);
+            }
+            catch (Exception exp)
+            {
+                return new RServiceResult<FAQItem>(null, exp.ToString());
+            }
+        }
+
+        /// <summary>
+        /// update an existing faq item
+        /// </summary>
+        /// <param name="item"></param>
+        /// <returns></returns>
+        public async Task<RServiceResult<bool>> UpdateItemAsync(FAQItem item)
+        {
+            try
+            {
+                var dbModel = await _context.FAQItems.Where(i => i.Id == item.Id).SingleAsync();
+                dbModel.Question = item.Question;
+                dbModel.AnswerExcerpt = item.AnswerExcerpt;
+                dbModel.FullAnswer = item.FullAnswer;
+                dbModel.Pinned = item.Pinned;
+                dbModel.PinnedItemOrder = item.PinnedItemOrder;
+                dbModel.CategoryId = item.CategoryId;
+                dbModel.ItemOrderInCategory = item.ItemOrderInCategory;
+                dbModel.ContentForSearch = item.ContentForSearch;
+                dbModel.HashTag1 = item.HashTag1;
+                dbModel.HashTag2 = item.HashTag2;
+                dbModel.HashTag3 = item.HashTag3;
+                dbModel.HashTag4 = item.HashTag4;
+                dbModel.Published = item.Published;
+                _context.Update(dbModel);
+                await _context.SaveChangesAsync();
+
+                return new RServiceResult<bool>(true);
+            }
+            catch (Exception exp)
+            {
+                return new RServiceResult<bool>(false, exp.ToString());
+            }
+        }
+
+        /// <summary>
+        /// delete a faq item
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
+        public async Task<RServiceResult<bool>> DeleteItemAsync(int id)
+        {
+            try
+            {
+                var dbModel = await _context.FAQItems.Where(i => i.Id == id).SingleAsync();
+                _context.Remove(dbModel);
+                await _context.SaveChangesAsync();
+
+                return new RServiceResult<bool>(true);
+            }
+            catch (Exception exp)
+            {
+                return new RServiceResult<bool>(false, exp.ToString());
+            }
+        }
+
 
         /// <summary>
         /// Database Context