Merge pull request #35 from Azm-Tech/feat/services-evaluation

Feat/services evaluation

Author: Rashed99Azm

backend/src/CCE.Api.Common/Localization/Resources.yaml

@@ -162,6 +162,10 @@ VALIDATION_REQUIRED_FIELD:
   ar: "هذا الحقل مطلوب"
   en: "This field is required"
 
+REQUIRED_FIELD:
+  ar: "هذا الحقل مطلوب"
+  en: "This field is required"
+
 VALIDATION_INVALID_EMAIL:
   ar: "البريد الإلكتروني غير صالح"
   en: "Invalid email format"
@@ -174,6 +178,10 @@ VALIDATION_MAX_LENGTH:
   ar: "القيمة طويلة جدًا"
   en: "Value is too long"
 
+MAX_LENGTH:
+  ar: "القيمة طويلة جدًا"
+  en: "Value is too long"
+
 VALIDATION_INVALID_FORMAT:
   ar: "التنسيق غير صالح"
   en: "Invalid format"
@@ -182,6 +190,10 @@ VALIDATION_INVALID_ENUM:
   ar: "القيمة المحددة غير صالحة"
   en: "Selected value is invalid"
 
+INVALID_ENUM:
+  ar: "القيمة المحددة غير صالحة"
+  en: "Selected value is invalid"
+
 # ─── Identity Bare Keys (errors) ───
 
 USER_NOT_FOUND:
@@ -456,3 +468,11 @@ NOTIFICATION_TEMPLATE_CREATED:
 NOTIFICATION_TEMPLATE_UPDATED:
   ar: "تم تحديث قالب الإشعار بنجاح"
   en: "Notification template updated successfully"
+
+EVALUATION_NOT_FOUND:
+  ar: "التقييم غير موجود"
+  en: "Evaluation not found"
+
+EVALUATION_SUBMITTED:
+  ar: "تم تقديم التقييم بنجاح"
+  en: "Evaluation submitted successfully"

backend/src/CCE.Api.Common/Middleware/ExceptionHandlingMiddleware.cs

@@ -93,9 +93,10 @@ private static async Task WriteValidationResultAsync(HttpContext ctx, Validation
 
         var fieldErrors = ex.Errors.Select(e =>
         {
-            var domainKey = e.ErrorMessage;
+            var domainKey = e.ErrorCode;
             var valCode = SystemCodeMap.ToSystemCode(domainKey);
             var valMsg = l?.GetString(domainKey) ?? domainKey;
+            if (valMsg == domainKey) valMsg = e.ErrorMessage;
             return new
             {
                 field = ToCamelCase(e.PropertyName),

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

@@ -0,0 +1,43 @@
+using CCE.Api.Common.Extensions;
+using CCE.Application.Evaluation.Commands.SubmitEvaluation;
+using CCE.Domain.Evaluation;
+using MediatR;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+
+namespace CCE.Api.External.Endpoints;
+
+public static class EvaluationEndpoints
+{
+    public static IEndpointRouteBuilder MapEvaluationEndpoints(this IEndpointRouteBuilder app)
+    {
+        var group = app.MapGroup("/api/evaluations").WithTags("Evaluations");
+
+        // POST /api/evaluations — public submit (visitors & authenticated users)
+        group.MapPost("", async (
+            SubmitEvaluationRequest body,
+            IMediator mediator,
+            CancellationToken ct) =>
+        {
+            
+            var cmd = new SubmitEvaluationCommand(
+                (EvaluationRating)body.OverallSatisfaction,
+                (EvaluationRating)body.EaseOfUse,
+                (EvaluationRating)body.ContentSuitability,
+                body.Feedback);
+            var result = await mediator.Send(cmd, ct).ConfigureAwait(false);
+            return result.ToHttpResult(StatusCodes.Status201Created);
+        })
+        .AllowAnonymous()
+        .WithName("SubmitEvaluation");
+
+        return app;
+    }
+}
+
+public sealed record SubmitEvaluationRequest(
+    int OverallSatisfaction,
+    int EaseOfUse,
+    int ContentSuitability,
+    string Feedback);

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

@@ -114,6 +114,7 @@
 app.MapAssistantEndpoints();
 app.MapKapsarcEndpoints();
 app.MapSurveysEndpoints();
+app.MapEvaluationEndpoints();
 app.MapHomepageSettingsPublicEndpoints();
 app.MapAboutSettingsPublicEndpoints();
 app.MapPoliciesSettingsPublicEndpoints();

backend/src/CCE.Api.Internal/Endpoints/EvaluationEndpoints.cs

@@ -0,0 +1,44 @@
+using CCE.Api.Common.Extensions;
+using CCE.Application.Evaluation.Queries.GetAllEvaluations;
+using CCE.Application.Evaluation.Queries.GetEvaluationById;
+using CCE.Domain;
+using MediatR;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+
+namespace CCE.Api.Internal.Endpoints;
+
+public static class EvaluationEndpoints
+{
+    public static IEndpointRouteBuilder MapEvaluationEndpoints(this IEndpointRouteBuilder app)
+    {
+        var group = app.MapGroup("/api/admin/evaluations").WithTags("Evaluations");
+
+        // GET /api/admin/evaluations — list all (admin only)
+        group.MapGet("", async (
+            int? page, int? pageSize,
+            IMediator mediator,
+            CancellationToken ct) =>
+        {
+            var result = await mediator.Send(new GetAllEvaluationsQuery(page ?? 1, pageSize ?? 20), ct).ConfigureAwait(false);
+            return result.ToHttpResult();
+        })
+        .RequireAuthorization(Permissions.Survey_ReadAll)
+        .WithName("GetAllEvaluations");
+
+        // GET /api/admin/evaluations/{id} — get by id (admin only)
+        group.MapGet("{id:guid}", async (
+            System.Guid id,
+            IMediator mediator,
+            CancellationToken ct) =>
+        {
+            var result = await mediator.Send(new GetEvaluationByIdQuery(id), ct).ConfigureAwait(false);
+            return result.ToHttpResult();
+        })
+        .RequireAuthorization(Permissions.Survey_ReadAll)
+        .WithName("GetEvaluationById");
+
+        return app;
+    }
+}

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

@@ -87,6 +87,7 @@
 app.MapPoliciesSettingsEndpoints();
         app.MapMediaEndpoints();
         app.MapCountryCodeEndpoints();
+        app.MapEvaluationEndpoints();
 
 // Sub-11d follow-up — dev sign-in shim. Mounts /dev/sign-in,
 // /dev/sign-out, /dev/whoami when Auth:DevMode=true. Production

backend/src/CCE.Application/Common/Behaviors/ResponseValidationBehavior.cs

@@ -47,9 +47,10 @@ public async Task<TResponse> Handle(
         {
             var fieldErrors = failures.Select(f =>
             {
-                var domainKey = f.ErrorMessage;
+                var domainKey = f.ErrorCode;
                 var valCode = SystemCodeMap.ToSystemCode(domainKey);
                 var msg = _l.GetString(domainKey);
+                if (msg == domainKey) msg = f.ErrorMessage;
                 return new FieldError(
                     ToCamelCase(f.PropertyName),
                     valCode,

backend/src/CCE.Application/Common/Errors.cs

@@ -55,6 +55,9 @@ public Error RegistrationFailed(IDictionary<string, string[]>? details = null)
     public Error PostNotFound()      => NotFound($"COMMUNITY_{ApplicationErrors.Community.POST_NOT_FOUND}");
     public Error ReplyNotFound()     => NotFound($"COMMUNITY_{ApplicationErrors.Community.REPLY_NOT_FOUND}");
 
+    // ─── Convenience: Evaluation domain ───
+    public Error EvaluationNotFound() => NotFound($"EVALUATION_{ApplicationErrors.Evaluation.EVALUATION_NOT_FOUND}");
+
     // ─── Convenience: Country domain ───
     public Error CountryNotFound()   => NotFound($"COUNTRY_{ApplicationErrors.Country.COUNTRY_NOT_FOUND}");
 

backend/src/CCE.Application/Common/Interfaces/ICceDbContext.cs

@@ -2,6 +2,7 @@
 using CCE.Domain.Audit;
 using CCE.Domain.Community;
 using CCE.Domain.Content;
+using CCE.Domain.Evaluation;
 using CCE.Domain.Identity;
 using CCE.Domain.InteractiveCity;
 using CCE.Domain.KnowledgeMaps;
@@ -80,6 +81,9 @@ public interface ICceDbContext
     IQueryable<OtpVerification> OtpVerifications { get; }
     IQueryable<UserVerification> UserVerifications { get; }
 
+    // ─── Evaluation ───
+    IQueryable<ServiceEvaluation> ServiceEvaluations { get; }
+
     // ─── Media ───
     IQueryable<MediaFile> MediaFiles { get; }
 

backend/src/CCE.Application/Errors/ApplicationErrors.cs

@@ -104,6 +104,12 @@ public static class InteractiveCity
         public const string TECHNOLOGY_NOT_FOUND = "TECHNOLOGY_NOT_FOUND";
     }
 
+    public static class Evaluation
+    {
+        public const string EVALUATION_NOT_FOUND = "EVALUATION_NOT_FOUND";
+        public const string EVALUATION_SUBMITTED = "EVALUATION_SUBMITTED";
+    }
+
     public static class Validation
     {
         public const string REQUIRED_FIELD = "REQUIRED_FIELD";