feat: add public FAQ endpoints and queries for external users

Author: ahmed12348

backend/src/CCE.Api.External/Endpoints/FaqPublicEndpoints.cs

@@ -0,0 +1,26 @@
+using CCE.Api.Common.Extensions;
+using CCE.Application.PlatformSettings.Public.Queries.GetPublicFaqs;
+using MediatR;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+
+namespace CCE.Api.External.Endpoints;
+
+public static class FaqPublicEndpoints
+{
+    public static IEndpointRouteBuilder MapFaqPublicEndpoints(this IEndpointRouteBuilder app)
+    {
+        var faqs = app.MapGroup("/api/faqs").WithTags("FAQ");
+
+        faqs.MapGet("", async (IMediator mediator, CancellationToken ct) =>
+        {
+            var result = await mediator.Send(new GetPublicFaqsQuery(), ct).ConfigureAwait(false);
+            return result.ToHttpResult();
+        })
+        .AllowAnonymous()
+        .WithName("GetPublicFaqs");
+
+        return app;
+    }
+}

backend/src/CCE.Api.External/Program.cs

@@ -116,6 +116,7 @@
 app.MapHomepageSettingsPublicEndpoints();
 app.MapAboutSettingsPublicEndpoints();
 app.MapPoliciesSettingsPublicEndpoints();
+app.MapFaqPublicEndpoints();
 app.MapMediaPublicEndpoints();
 app.MapVerificationEndpoints();
 

backend/src/CCE.Application/PlatformSettings/Public/Dtos/PublicFaqDto.cs

@@ -0,0 +1,8 @@
+using CCE.Application.PlatformSettings.Dtos;
+
+namespace CCE.Application.PlatformSettings.Public.Dtos;
+
+public sealed record PublicFaqDto(
+    LocalizedTextDto Question,
+    LocalizedTextDto Answer,
+    int Order);

backend/src/CCE.Application/PlatformSettings/Public/Queries/GetPublicFaqs/GetPublicFaqsQuery.cs

@@ -0,0 +1,7 @@
+using CCE.Application.Common;
+using CCE.Application.PlatformSettings.Public.Dtos;
+using MediatR;
+
+namespace CCE.Application.PlatformSettings.Public.Queries.GetPublicFaqs;
+
+public sealed record GetPublicFaqsQuery : IRequest<Response<IReadOnlyList<PublicFaqDto>>>;

backend/src/CCE.Application/PlatformSettings/Public/Queries/GetPublicFaqs/GetPublicFaqsQueryHandler.cs

@@ -0,0 +1,38 @@
+using CCE.Application.Common;
+using CCE.Application.Common.Interfaces;
+using CCE.Application.Common.Pagination;
+using CCE.Application.Messages;
+using CCE.Application.PlatformSettings.Dtos;
+using CCE.Application.PlatformSettings.Public.Dtos;
+using MediatR;
+
+namespace CCE.Application.PlatformSettings.Public.Queries.GetPublicFaqs;
+
+public sealed class GetPublicFaqsQueryHandler
+    : IRequestHandler<GetPublicFaqsQuery, Response<IReadOnlyList<PublicFaqDto>>>
+{
+    private readonly ICceDbContext _db;
+    private readonly MessageFactory _msg;
+
+    public GetPublicFaqsQueryHandler(ICceDbContext db, MessageFactory msg)
+    {
+        _db = db;
+        _msg = msg;
+    }
+
+    public async Task<Response<IReadOnlyList<PublicFaqDto>>> Handle(
+        GetPublicFaqsQuery request, CancellationToken cancellationToken)
+    {
+        var faqs = await _db.Faqs
+            .OrderBy(f => f.Order)
+            .ToListAsyncEither(cancellationToken)
+            .ConfigureAwait(false);
+
+        var dtos = faqs.Select(f => new PublicFaqDto(
+            new LocalizedTextDto(f.Question.Ar, f.Question.En),
+            new LocalizedTextDto(f.Answer.Ar, f.Answer.En),
+            f.Order)).ToList();
+
+        return _msg.Ok<IReadOnlyList<PublicFaqDto>>(dtos, "ITEMS_LISTED");
+    }
+}