feat: implement rating summary service methods and integrate rating display components into the organization header and pending ratings page

server/src/Models/Ratings/Ratings.ts

@@ -9,16 +9,24 @@ import ServicesManager from "../Services/Service";
 import UsersManager from "../Users/Users";
 import { RatingsAdapterMongoose } from "./Ratings.Adapter.Mongoose";
 import {
+    CountRatingsByUserParams,
+    CountRatingsByUserResult,
     CreateRatingParams,
     IRating,
     IRatingsManager,
     PendingRatingItem,
     PendingRatingsByUserParams,
+    ProfessionalRatingSummaryByUserParams,
     RATING_COMMENT_MAX_LENGTH,
+    RatingTargetSummaryParams,
+    RatingTargetSummaryResult,
+    RatingTargetReviewItem,
+    RatingTargetReviewsParams,
     RatingTargetType,
 } from "./Ratings.Interface";
 
 const PENDING_RATINGS_APPOINTMENT_LIMIT = 50;
+const TARGET_REVIEWS_LIMIT = 20;
 
 class RatingsManager implements IRatingsManager {
     ratings: RatingsAdapterMongoose;
@@ -180,6 +188,52 @@ class RatingsManager implements IRatingsManager {
         return pendingItems;
     }
 
+    public async countByUser(data: CountRatingsByUserParams): Promise<CountRatingsByUserResult> {
+        await this.validateSessionUser(data.sessionUser);
+
+        return {
+            count: await this.ratings.count({ userId: data.sessionUser }),
+        };
+    }
+
+    public async professionalSummaryByUser(data: ProfessionalRatingSummaryByUserParams): Promise<RatingTargetSummaryResult> {
+        await this.validateSessionUser(data.sessionUser);
+
+        const employees = await EmployeesList.employees.find({
+            userId: data.sessionUser,
+            removed: { $ne: true },
+        } as any);
+        const employeeIds = employees.map((employee) => String(employee.id));
+
+        return this.ratings.summaryByTargets({
+            targetType: RatingTargetType.EMPLOYEE,
+            targetIds: employeeIds,
+        });
+    }
+
+    public async summaryByTarget(data: RatingTargetSummaryParams): Promise<RatingTargetSummaryResult> {
+        this.validateTargetType(data.targetType);
+
+        if (!Types.ObjectId.isValid(data.targetId)) {
+            throw new Error("No se ha proporcionado un objetivo válido.");
+        }
+
+        return this.ratings.summaryByTarget(data);
+    }
+
+    public async reviewsByTarget(data: RatingTargetReviewsParams): Promise<RatingTargetReviewItem[]> {
+        this.validateTargetType(data.targetType);
+
+        if (!Types.ObjectId.isValid(data.targetId)) {
+            throw new Error("No se ha proporcionado un objetivo válido.");
+        }
+
+        return this.ratings.reviewsByTarget({
+            ...data,
+            limit: Math.min(Math.max(data.limit || TARGET_REVIEWS_LIMIT, 1), TARGET_REVIEWS_LIMIT),
+        });
+    }
+
     private async validateSessionUser(sessionUser: string): Promise<void> {
         const user = await UsersManager.users.findOne({ _id: sessionUser });