Update SwaggerResponseProperty types in serializers, add summary and description

src/common/serializers/exercise.serialization.ts

@@ -22,6 +22,16 @@ class Media {
   url: string;
 }
 
+class TargetMuscles {
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  primary: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  secondary: string;
+}
+
 export class ExerciseSerialization {
   @Expose({ name: "_id" })
   @SwaggerResponseProperty({ type: "string" })
@@ -61,7 +71,7 @@ export class ExerciseSerialization {
   benefits: string;
 
   @Expose()
-  @SwaggerResponseProperty({ type: ["string"] })
+  @SwaggerResponseProperty({ type: [TargetMuscles] })
   targetMuscles: any;
 
   @Expose()

src/common/serializers/exercisePopulate.serialization.ts

@@ -0,0 +1,87 @@
+import { Expose, Transform } from "class-transformer";
+import { serialize } from "@helpers/serialize";
+import { EquipmentSerialization } from "./muscle.serialization";
+import { MuscleSerialization } from "./equipment.serialization";
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+
+class ExpectedDurationRangePopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  min: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  max: number;
+}
+
+class MediaPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  type: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  url: string;
+}
+
+class TargetMusclesPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: MuscleSerialization })
+  primary: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: MuscleSerialization })
+  secondary: string;
+}
+
+export class ExercisePopulateSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  category: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  duration: number | null;
+
+  @Expose({ name: "expectedDurationRange" })
+  @SwaggerResponseProperty({ type: ExpectedDurationRangePopulate })
+  @Transform(({ value }) => serialize(value, ExpectedDurationRangePopulate))
+  expectedDurationRange: object;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  reps: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  sets: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  instructions: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  benefits: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: [TargetMusclesPopulate] })
+  targetMuscles: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: [EquipmentSerialization] })
+  equipments: any;
+
+  @Expose({ name: "media" })
+  @SwaggerResponseProperty({ type: MediaPopulate })
+  @Transform(({ value }) => serialize(value, MediaPopulate))
+  media: object;
+}

src/common/serializers/meal-plan.serialization.ts

@@ -9,7 +9,7 @@ class MealPlanDays {
   title: string;
 
   @Expose({ name: "meals" })
-  @SwaggerResponseProperty({ type: {} })
+  @SwaggerResponseProperty({ type: ["string"] })
   meals: any;
 }
 
@@ -19,7 +19,7 @@ class MealPlanKeyFeatures {
   day_number: number;
 
   @Expose({ name: "description" })
-  @SwaggerResponseProperty({ type: {} })
+  @SwaggerResponseProperty({ type: "string" })
   description: any;
 }
 

src/common/serializers/meal-planPopulate.serialization.ts

@@ -0,0 +1,66 @@
+import { Expose, Transform } from "class-transformer";
+import { serialize } from "@helpers/serialize";
+import { MealSerialization } from './meal.serialization';
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+
+
+class MealPlanDaysPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  title: string;
+
+  @Expose({ name: "meals" })
+  @SwaggerResponseProperty({ type: MealSerialization })
+  meals: any;
+}
+
+class MealPlanKeyFeaturesPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  day_number: number;
+
+  @Expose({ name: "description" })
+  @SwaggerResponseProperty({ type: "string" })
+  description: any;
+}
+
+export class MealPlanPopulateSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  image: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  description: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  Duration: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  Level: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  your_Journey: string;
+
+  @Expose({ name: "key_Features" })
+  @SwaggerResponseProperty({ type: [MealPlanKeyFeaturesPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, MealPlanKeyFeaturesPopulate)
+  )
+  key_Features: any;
+
+  @Expose({ name: "days" })
+  @SwaggerResponseProperty({ type: [MealPlanDaysPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, MealPlanDaysPopulate)
+  )
+  days: any;
+
+}

src/common/serializers/meal.serialization.ts

@@ -1,6 +1,5 @@
 import { Expose } from "class-transformer";
 import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
-import { IngredientSerialization } from "./ingredient.serialization";
 
 
 export class MealSerialization {
@@ -13,7 +12,7 @@ export class MealSerialization {
   created_at: Date;
 
   @Expose()
-  @SwaggerResponseProperty({ type: [IngredientSerialization] })
+  @SwaggerResponseProperty({ type: ["string"] })
   ingredients: any;
 
   @Expose()

src/common/serializers/mealPopulate.serialization.ts

@@ -0,0 +1,38 @@
+import { Expose } from "class-transformer";
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+import { IngredientSerialization } from "./ingredient.serialization";
+
+
+export class MealPopulateSerialization {
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  created_at: Date;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: [IngredientSerialization] })
+  ingredients: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  calories: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  carbs: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  proteins: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  fats: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  type: string;
+}

src/common/serializers/templatePopulate.serialization.ts

@@ -0,0 +1,25 @@
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+import { Expose } from "class-transformer";
+import { ExerciseSerialization } from "./exercise.serialization";
+
+export class TemplatePopulateSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  user: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "Date" })
+  creationDate: Date;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: [ExerciseSerialization] })
+  exercises: any;
+}

src/common/serializers/user-registered-meal-plan.serialization.ts

@@ -10,7 +10,7 @@ class MealDays {
   day_number: number;
 
   @Expose({ name: "meals" })
-  @SwaggerResponseProperty({ type: {} })
+  @SwaggerResponseProperty({ type: ["string"] })
   meals: any;
 
   @Expose()

src/common/serializers/user-registered-meal-planPopulate.serialization.ts

@@ -0,0 +1,76 @@
+import { Expose, Transform } from "class-transformer";
+import { serialize } from "@helpers/serialize";
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+import { MealSerialization } from "./meal.serialization";
+import { MealPlanSerialization } from "./meal-plan.serialization";
+import { UserSerialization } from "./user.serialization";
+
+
+
+class MealDaysPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  day_number: number;
+
+  @Expose({ name: "meals" })
+  @SwaggerResponseProperty({ type: [MealSerialization] })
+  meals: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  is_eaten: boolean;
+
+}
+
+export class UserRegisteredMealPlansPopulateSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  user: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: MealPlanSerialization })
+  meal_plan: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  isActive: boolean;
+
+  @Expose({ name: "days" })
+  @SwaggerResponseProperty({ type: [MealDaysPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, MealDaysPopulate)
+  )
+  days: any;
+
+}
+
+
+export class UserRegisteredMealPlansPopulateUserSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: UserSerialization })
+  user: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: MealPlanSerialization })
+  meal_plan: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  isActive: boolean;
+
+  @Expose({ name: "days" })
+  @SwaggerResponseProperty({ type: [MealDaysPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, MealDaysPopulate)
+  )
+  days: any;
+
+}

src/common/serializers/user-registered-workout.serialization.ts

@@ -1,7 +1,6 @@
 import { Expose, Transform } from "class-transformer";
 import { serialize } from "@helpers/serialize";
 import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
-import { ExerciseSerialization } from "./exercise.serialization";
 
 class MyWorkoutDays {
   @Expose()
@@ -17,7 +16,7 @@ class MyWorkoutDays {
   day_type: string;
 
   @Expose({ name: "exercises" })
-  @SwaggerResponseProperty({ type: [ExerciseSerialization] })
+  @SwaggerResponseProperty({ type: ["string"] })
   exercises: any;
 
   @Expose()
@@ -70,3 +69,5 @@ export class UserRegisteredWorkoutsSerialization {
   @Transform(({ value }) => serialize(value, MyWorkoutWeeks))
   weeks: any;
 }
+
+

src/common/serializers/user-registered-workoutPopulate.serialization.ts

@@ -0,0 +1,74 @@
+import { Expose, Transform } from "class-transformer";
+import { serialize } from "@helpers/serialize";
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+import { ExerciseSerialization } from "./exercise.serialization";
+import { WorkoutSerialization } from "./workout.serialization";
+
+
+class MyWorkoutDaysPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  day_number: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  total_number_exercises: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  day_type: string;
+
+  @Expose({ name: "exercises" })
+  @SwaggerResponseProperty({ type: [ExerciseSerialization] })
+  exercises: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  is_done: Boolean;
+}
+
+class MyWorkoutWeeksPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  week_number: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  week_name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  week_description: string;
+
+  @Expose({ name: "days" })
+  @SwaggerResponseProperty({ type: [MyWorkoutDaysPopulate] })
+  @Transform(({ value }) => serialize(value, MyWorkoutDaysPopulate))
+  days: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  is_done: Boolean;
+}
+
+export class UserRegisteredWorkoutsPopulateSerialization {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  user: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: WorkoutSerialization })
+  workout: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "boolean" })
+  is_active: Boolean;
+
+  @Expose({ name: "weeks" })
+  @SwaggerResponseProperty({ type: [MyWorkoutWeeksPopulate] })
+  @Transform(({ value }) => serialize(value, MyWorkoutWeeksPopulate))
+  weeks: any;
+}

src/common/serializers/workout.serialization.ts

@@ -18,7 +18,7 @@ class WorkoutDays {
   day_type: string;
 
   @Expose({ name: "exercises" })
-  @SwaggerResponseProperty({ type: {} })
+  @SwaggerResponseProperty({ type: ["string"] })
   exercises: any;
 }
 

src/common/serializers/workoutPopulate.serialization.ts

@@ -0,0 +1,99 @@
+import { Expose, Transform } from "class-transformer";
+import { serialize } from "@helpers/serialize";
+import { SwaggerResponseProperty } from "@lib/decorators/swagger-response-property.decorator";
+import { ExerciseSerialization } from "./exercise.serialization";
+
+
+
+class WorkoutDaysPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  day_number: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  total_number_exercises: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  day_type: string;
+
+  @Expose({ name: "exercises" })
+  @SwaggerResponseProperty({ type: [ExerciseSerialization] })
+  exercises: any;
+}
+
+class WorkoutTemplateWeeksPopulate {
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  week_number: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  week_name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  week_description: string;
+
+  @Expose({ name: "days" })
+  @SwaggerResponseProperty({ type: [WorkoutDaysPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, WorkoutDaysPopulate)
+  )
+  days: any;
+}
+
+export class WorkoutSerializationPopulate {
+  @Expose({ name: "_id" })
+  @SwaggerResponseProperty({ type: "string" })
+  id: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  name: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  description: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  type: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  image: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  created_by: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  fitness_level: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  fitness_goal: string;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "string" })
+  place: any;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  min_per_day: number;
+
+  @Expose()
+  @SwaggerResponseProperty({ type: "number" })
+  total_number_days: number;
+
+  @Expose({ name: "template_weeks" })
+  @SwaggerResponseProperty({ type: [WorkoutTemplateWeeksPopulate] })
+  @Transform(
+    ({ value }) => serialize(value, WorkoutTemplateWeeksPopulate)
+  )
+  template_weeks: any;
+
+}

src/modules/console/modules/admins/controllers/admins.controller.ts

@@ -26,7 +26,6 @@ import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
 import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
-import { SwaggerQuery } from "@lib/decorators/swagger-query.decorator";
 
 @Controller("/console/admins")
 @ControllerMiddleware(AdminGuardMiddleware({ roles: [Role.SUPER_ADMIN] }))
@@ -56,8 +55,8 @@ export class AdminsController extends BaseController {
 
   @SwaggerGet()
   @SwaggerResponse([AdminSerialization])
-  @SwaggerSummary("List all admins")
-  @SwaggerDescription("List all admins")
+  @SwaggerSummary("List admins")
+  @SwaggerDescription("List all admins in the system")
   list = async (
     req: Request,
     res: Response<IJSONSuccessResponse<AdminSerialization[]>>
@@ -79,8 +78,8 @@ export class AdminsController extends BaseController {
 
   @SwaggerGet("/:id")
   @SwaggerResponse(AdminSerialization)
-  @SwaggerSummary("Get admin by id")
-  @SwaggerDescription("Get admin by id")
+  @SwaggerSummary("Get admin")
+  @SwaggerDescription("Get an admin by id")
   get = async (
     req: Request<{ id: string }>,
     res: Response<IJSONSuccessResponse<AdminSerialization>>
@@ -121,7 +120,7 @@ export class AdminsController extends BaseController {
   @SwaggerResponse(AdminSerialization)
   @SwaggerRequest(createAdminSchema)
   @SwaggerSummary("Update admin")
-  @SwaggerDescription("Updates an admin")
+  @SwaggerDescription("Updates an admin by id")
   update = async (
     req: Request<{ id: string }, {}, ICreateAdmin>,
     res: Response<IJSONSuccessResponse<AdminSerialization>>
@@ -144,7 +143,7 @@ export class AdminsController extends BaseController {
   @SwaggerDelete("/:id")
   @SwaggerResponse(AdminSerialization)
   @SwaggerSummary("Delete admin")
-  @SwaggerDescription("Deletes an admin")
+  @SwaggerDescription("Delete an admin by id")
   delete = async (
     req: Request<{ id: string }>,
     res: Response<IJSONSuccessResponse<AdminSerialization>>

src/modules/console/modules/auth/controllers/auth.controller.ts

@@ -11,6 +11,8 @@ import { AdminSerialization } from "modules/console/common/serializers/admin.ser
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerPost } from "@lib/decorators/swagger-routes.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/auth")
 export class ConsoleAuthController extends BaseController {
@@ -27,6 +29,8 @@ export class ConsoleAuthController extends BaseController {
   @SwaggerPost('/login')
   @SwaggerRequest(loginValidationSchema)
   @SwaggerResponse(AdminSerialization)
+  @SwaggerSummary("Login an admin")
+  @SwaggerDescription("Login an admin")
   login = async (req: Request, res: Response): Promise<Response> => {
     const { admin, token } = await this.authService.login(req.body);
 

src/modules/console/modules/equipments/controllers/equipments.controller.ts

@@ -9,7 +9,7 @@ import { serialize } from "@helpers/serialize";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { AdminGuardMiddleware } from "modules/console/common/guards/admins.guard";
 import { EquipmentsService } from "../services/equipments.service";
-import { createEquipmentchema } from "../validations/create-equipment.validation";
+import { createEquipmentSchema } from "../validations/create-equipment.validation";
 import { updateEquipmentSchema } from "../validations/update-equipment.validation";
 import { EquipmentSerialization } from "@common/serializers/muscle.serialization";
 import {
@@ -20,7 +20,8 @@ import {
 } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
-
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 @Controller("/console/equipments")
 @ControllerMiddleware(AdminGuardMiddleware({}))
 export class EquipmentsController extends BaseController {
@@ -31,7 +32,7 @@ export class EquipmentsController extends BaseController {
     this.router.get("/:id", paramsValidator("id"), asyncHandler(this.get));
     this.router.post(
       "/",
-      bodyValidator(createEquipmentchema),
+      bodyValidator(createEquipmentSchema),
       asyncHandler(this.create)
     );
     this.router.patch(
@@ -49,6 +50,8 @@ export class EquipmentsController extends BaseController {
 
   @SwaggerGet()
   @SwaggerResponse([EquipmentSerialization])
+  @SwaggerSummary("List equipments")
+  @SwaggerDescription("List all equipments in the system")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.equipmentsService.list(
@@ -67,6 +70,8 @@ export class EquipmentsController extends BaseController {
 
   @SwaggerGet("/{id}")
   @SwaggerResponse(EquipmentSerialization)
+  @SwaggerSummary("Get equipment")
+  @SwaggerDescription("Get a single equipment by id")
   get = async (req: Request, res: Response) => {
     const data = await this.equipmentsService.findOneOrFail({
       _id: req.params.id,
@@ -81,7 +86,9 @@ export class EquipmentsController extends BaseController {
 
   @SwaggerPost()
   @SwaggerResponse(EquipmentSerialization)
-  @SwaggerRequest(createEquipmentchema)
+  @SwaggerRequest(createEquipmentSchema)
+  @SwaggerSummary("Create equipment")
+  @SwaggerDescription("Create a new equipment")
   create = async (req: Request, res: Response) => {
     const data = await this.equipmentsService.create(req.body);
     return JsonResponse.success(
@@ -96,6 +103,8 @@ export class EquipmentsController extends BaseController {
   @SwaggerPatch("/{id}")
   @SwaggerResponse(EquipmentSerialization)
   @SwaggerRequest(updateEquipmentSchema)
+  @SwaggerSummary("Update equipment")
+  @SwaggerDescription("Update a equipment by id")
   update = async (req: Request, res: Response) => {
     const data = await this.equipmentsService.updateOne(
       { _id: req.params.id },
@@ -111,6 +120,8 @@ export class EquipmentsController extends BaseController {
 
   @SwaggerDelete("/{id}")
   @SwaggerResponse(EquipmentSerialization)
+  @SwaggerSummary("Delete equipment")
+  @SwaggerDescription("Delete a equipment by id")
   delete = async (req: Request, res: Response) => {
     const data = await this.equipmentsService.deleteOne({ _id: req.params.id });
     return JsonResponse.success(

src/modules/console/modules/equipments/validations/create-equipment.validation.ts

@@ -6,7 +6,7 @@ export interface ICreateEquipment{
     image: string;
 }
 
-export const createEquipmentchema = createSchema<ICreateEquipment>({
+export const createEquipmentSchema = createSchema<ICreateEquipment>({
     name: joi.string().empty().required().messages({
         "string.base": "please enter a valid name",
         "any.required": "name is required",

src/modules/console/modules/exercises/controllers/exercises.controller.ts

@@ -8,6 +8,7 @@ import { Controller } from "@lib/decorators/controller.decorator";
 import { JsonResponse } from "@lib/responses/json-response";
 import { AdminGuardMiddleware } from "modules/console/common/guards/admins.guard";
 import { ExercisesService } from "../services/exercises.service";
+import { ExercisePopulateSerialization } from "@common/serializers/exercisePopulate.serialization";
 import { Request, Response } from "express";
 import { serialize } from "@helpers/serialize";
 import { createExerciseSchema } from "../validations/create-excercise.validation";
@@ -15,6 +16,8 @@ import { updateExerciseSchema } from "../validations/update-excercise.validation
 import { SwaggerDelete, SwaggerGet, SwaggerPatch, SwaggerPost } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/exercises")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -43,12 +46,21 @@ export class ExercisesController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([ExerciseSerialization])
+  @SwaggerResponse([ExercisePopulateSerialization])
+  @SwaggerSummary("List exercises")
+  @SwaggerDescription("List all exercises in the system")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.exercisesService.list(
       {},
-      paginationQuery
+      paginationQuery,
+      {
+        populateArray: [
+          { path: "targetMuscles.primary" },
+          { path: "targetMuscles.secondary" },
+          { path: "equipment" },
+        ],
+      }
     );
 
     return JsonResponse.success(
@@ -61,11 +73,22 @@ export class ExercisesController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(ExerciseSerialization)
+  @SwaggerResponse(ExercisePopulateSerialization)
+  @SwaggerSummary("Get exercise")
+  @SwaggerDescription("Get a single exercise by id")
   get = async (req: Request, res: Response) => {
-    const data = await this.exercisesService.findOneOrFail({
-      _id: req.params.id,
-    });
+    const data = await this.exercisesService.findOneOrFail(
+      {
+        _id: req.params.id,
+      },
+      {
+        populateArray: [
+          { path: "targetMuscles.primary" },
+          { path: "targetMuscles.secondary" },
+          { path: "equipment" },
+        ],
+      }
+    );
     return JsonResponse.success(
       {
         data: serialize(data.toJSON(), ExerciseSerialization),
@@ -77,6 +100,8 @@ export class ExercisesController extends BaseController {
   @SwaggerPost()
   @SwaggerResponse(ExerciseSerialization)
   @SwaggerRequest(createExerciseSchema)
+  @SwaggerSummary("Create exercise")
+  @SwaggerDescription("Create a new exercise")
   create = async (req: Request, res: Response) => {
     const data = await this.exercisesService.create(req.body);
     return JsonResponse.success(
@@ -90,6 +115,8 @@ export class ExercisesController extends BaseController {
   @SwaggerPatch("/:id")
   @SwaggerRequest(updateExerciseSchema)
   @SwaggerResponse(ExerciseSerialization)
+  @SwaggerSummary("Update exercise")
+  @SwaggerDescription("Update a single exercise by id")
   update = async (req: Request, res: Response) => {
     const data = await this.exercisesService.updateOne(
       { _id: req.params.id },
@@ -105,6 +132,8 @@ export class ExercisesController extends BaseController {
 
   @SwaggerDelete("/:id")
   @SwaggerResponse({})
+  @SwaggerSummary("Delete exercise")
+  @SwaggerDescription("Delete a single exercise by id")
   delete = async (req: Request, res: Response) => {
     await this.exercisesService.deleteOne({ _id: req.params.id });
     return JsonResponse.success({}, res);

src/modules/console/modules/ingredients/controller/ingredients.controller.ts

@@ -15,6 +15,8 @@ import { IngredientSerialization } from "@common/serializers/ingredient.serializ
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerGet, SwaggerPost, SwaggerPatch, SwaggerDelete } from "@lib/decorators/swagger-routes.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/ingredients")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -42,6 +44,8 @@ export class AdminsIngredientsController extends BaseController {
 
     @SwaggerGet()
     @SwaggerResponse([IngredientSerialization])
+    @SwaggerSummary("List ingredients")
+    @SwaggerDescription("List all ingredients in the system")
     list = async (req: Request, res: Response) => {
         const paginationQuery = parsePaginationQuery(req.query);
         const { docs, paginationData } = await this.ingredientsService.list(
@@ -60,6 +64,8 @@ export class AdminsIngredientsController extends BaseController {
 
     @SwaggerGet('/:id')
     @SwaggerResponse(IngredientSerialization)
+    @SwaggerSummary('Get ingredient')
+    @SwaggerDescription('Get ingredient by id')
     get = async (req: Request, res: Response) => {
         const data = await this.ingredientsService.findOneOrFail({
             _id: req.params.id,
@@ -75,6 +81,8 @@ export class AdminsIngredientsController extends BaseController {
     @SwaggerPost()
     @SwaggerRequest(createIngredientsSchema)
     @SwaggerResponse(IngredientSerialization)
+    @SwaggerSummary('Create ingredient')
+    @SwaggerDescription('Create a new ingredient')
     create = async (req: Request, res: Response) => {
         const data = await this.ingredientsService.create(req.body);
         return JsonResponse.success(
@@ -89,6 +97,8 @@ export class AdminsIngredientsController extends BaseController {
     @SwaggerPatch('/:id')
     @SwaggerRequest(updateIngredientsSchema)
     @SwaggerResponse(IngredientSerialization)
+    @SwaggerSummary('Update ingredient')
+    @SwaggerDescription('Update an ingredient by id')
     update = async (req: Request, res: Response) => {
         const data = await this.ingredientsService.updateOne(
             { _id: req.params.id },
@@ -104,6 +114,8 @@ export class AdminsIngredientsController extends BaseController {
 
     @SwaggerDelete('/:id')
     @SwaggerResponse(IngredientSerialization)
+    @SwaggerSummary('Delete ingredient')
+    @SwaggerDescription('Delete an ingredient by id')
     delete = async (req: Request, res: Response) => {
         const data = await this.ingredientsService.deleteOne({ _id: req.params.id });
         return JsonResponse.success(

src/modules/console/modules/meal-plans/controller/meal-plans.controller.ts

@@ -11,10 +11,13 @@ import { AdminGuardMiddleware } from "modules/console/common/guards/admins.guard
 import { MealPlansService } from "../services/meal-plans.service";
 import { CreateMealPlan } from "../validations/create-meal-plan.validation";
 import { UpdateMealPlan } from "../validations/update-meal-plan.validation";
-import { MealPlanSerialization } from "@common/serializers/meal-plan.serialization"; 
+import { MealPlanSerialization } from "@common/serializers/meal-plan.serialization";
+import { MealPlanPopulateSerialization } from "@common/serializers/meal-planPopulate.serialization";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerGet, SwaggerPost, SwaggerPatch, SwaggerDelete } from "@lib/decorators/swagger-routes.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/mealPlans")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -41,12 +44,19 @@ export class AdminsMealPlansController extends BaseController {
     }
 
     @SwaggerGet()
-    @SwaggerResponse([MealPlanSerialization])
+    @SwaggerResponse([MealPlanPopulateSerialization])
+    @SwaggerSummary("List meal plans")
+    @SwaggerDescription("List all meal plans in the system")
     list = async (req: Request, res: Response) => {
         const paginationQuery = parsePaginationQuery(req.query);
         const { docs, paginationData } = await this.mealPlansService.list(
             {},
-            paginationQuery
+            paginationQuery,
+            {
+                populateArray: [
+                    { path: "days.meals" }
+                ],
+            }
         );
 
         return JsonResponse.success(
@@ -59,11 +69,20 @@ export class AdminsMealPlansController extends BaseController {
     };
 
     @SwaggerGet('/:id')
-    @SwaggerResponse(MealPlanSerialization)
+    @SwaggerResponse(MealPlanPopulateSerialization)
+    @SwaggerSummary('Get meal plan')
+    @SwaggerDescription('Get meal plan by id')
     get = async (req: Request, res: Response) => {
-        const data = await this.mealPlansService.findOneOrFail({
-            _id: req.params.id,
-        });
+        const data = await this.mealPlansService.findOneOrFail(
+            {
+                _id: req.params.id,
+            },
+            {
+                populateArray: [
+                    { path: "days.meals" }
+                ],
+            }
+        );
         return JsonResponse.success(
             {
                 data: serialize(data.toJSON(), MealPlanSerialization),
@@ -75,6 +94,8 @@ export class AdminsMealPlansController extends BaseController {
     @SwaggerPost()
     @SwaggerRequest(CreateMealPlan)
     @SwaggerResponse(MealPlanSerialization)
+    @SwaggerSummary('Create meal plan')
+    @SwaggerDescription('Create a new meal plan')
     create = async (req: Request, res: Response) => {
         const data = await this.mealPlansService.create(req.body);
         return JsonResponse.success(
@@ -89,6 +110,8 @@ export class AdminsMealPlansController extends BaseController {
     @SwaggerPatch('/:id')
     @SwaggerRequest(UpdateMealPlan)
     @SwaggerResponse(MealPlanSerialization)
+    @SwaggerSummary('Update meal plan')
+    @SwaggerDescription('Update a meal plan by id')
     update = async (req: Request, res: Response) => {
         const data = await this.mealPlansService.updateOne(
             { _id: req.params.id },
@@ -104,6 +127,8 @@ export class AdminsMealPlansController extends BaseController {
 
     @SwaggerDelete('/:id')
     @SwaggerResponse(MealPlanSerialization)
+    @SwaggerSummary('Delete meal plan')
+    @SwaggerDescription('Delete a meal plan by id')
     delete = async (req: Request, res: Response) => {
         const data = await this.mealPlansService.deleteOne({ _id: req.params.id });
         return JsonResponse.success(

src/modules/console/modules/meals/controller/meals.controller.ts

@@ -12,9 +12,12 @@ import { MealsService } from "../services/meals.service";
 import { createMealSchema } from "../validations/create-meals.validation";
 import { updateMealSchema } from "../validations/update-meals.validation";
 import { MealSerialization } from "@common/serializers/meal.serialization";
+import { MealPopulateSerialization } from "@common/serializers/mealPopulate.serialization";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerGet, SwaggerPost, SwaggerPatch, SwaggerDelete } from "@lib/decorators/swagger-routes.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/meals")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -41,17 +44,24 @@ export class AdminsMealsController extends BaseController {
     }
 
     @SwaggerGet()
-    @SwaggerResponse([MealSerialization])
+    @SwaggerResponse([MealPopulateSerialization])
+    @SwaggerSummary("List meals")
+    @SwaggerDescription("List all meals in the system")
     list = async (req: Request, res: Response) => {
         const paginationQuery = parsePaginationQuery(req.query);
         const { docs, paginationData } = await this.mealsService.list(
             {},
-            paginationQuery
+            paginationQuery,
+            {
+                populateArray: [
+                    { path: "ingredients" }
+                ],
+            }
         );
 
         return JsonResponse.success(
             {
-                data: serialize(docs, MealSerialization),
+                data: serialize(docs, MealPopulateSerialization),
                 meta: paginationData,
             },
             res
@@ -59,14 +69,23 @@ export class AdminsMealsController extends BaseController {
     };
 
     @SwaggerGet('/:id')
-    @SwaggerResponse(MealSerialization)
+    @SwaggerResponse(MealPopulateSerialization)
+    @SwaggerSummary('Get meal')
+    @SwaggerDescription('Get meal by id')
     get = async (req: Request, res: Response) => {
-        const data = await this.mealsService.findOneOrFail({
-            _id: req.params.id,
-        });
+        const data = await this.mealsService.findOneOrFail(
+            {
+                _id: req.params.id,
+            },
+            {
+                populateArray: [
+                    { path: "ingredients" }
+                ],
+            }
+        );
         return JsonResponse.success(
             {
-                data: serialize(data.toJSON(), MealSerialization),
+                data: serialize(data.toJSON(), MealPopulateSerialization),
             },
             res
         );
@@ -75,6 +94,8 @@ export class AdminsMealsController extends BaseController {
     @SwaggerPost()
     @SwaggerRequest(createMealSchema)
     @SwaggerResponse(MealSerialization)
+    @SwaggerSummary('Create meal')
+    @SwaggerDescription('Create a new meal')
     create = async (req: Request, res: Response) => {
         const data = await this.mealsService.create(req.body);
         return JsonResponse.success(
@@ -89,6 +110,8 @@ export class AdminsMealsController extends BaseController {
     @SwaggerPatch('/:id')
     @SwaggerRequest(updateMealSchema)
     @SwaggerResponse(MealSerialization)
+    @SwaggerSummary('Update meal')
+    @SwaggerDescription('Update a meal by id')
     update = async (req: Request, res: Response) => {
         const data = await this.mealsService.updateOne(
             { _id: req.params.id },
@@ -104,6 +127,8 @@ export class AdminsMealsController extends BaseController {
 
     @SwaggerDelete('/:id')
     @SwaggerResponse(MealSerialization)
+    @SwaggerSummary('Delete meal')
+    @SwaggerDescription('Delete a meal by id')
     delete = async (req: Request, res: Response) => {
         const data = await this.mealsService.deleteOne({ _id: req.params.id });
         return JsonResponse.success(

src/modules/console/modules/muscles/controllers/muscles.controller.ts

@@ -15,6 +15,8 @@ import { MuscleSerialization } from "@common/serializers/equipment.serialization
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerGet, SwaggerPost, SwaggerPatch, SwaggerDelete } from "@lib/decorators/swagger-routes.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/muscles")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -42,6 +44,8 @@ export class MusclesController extends BaseController {
 
     @SwaggerGet()
     @SwaggerResponse([MuscleSerialization])
+    @SwaggerSummary("List muscles")
+    @SwaggerDescription("List all muscles in the system")
     list = async (req: Request, res: Response) => {
         const paginationQuery = parsePaginationQuery(req.query);
         const { docs, paginationData } = await this.musclesService.list(
@@ -60,6 +64,8 @@ export class MusclesController extends BaseController {
 
     @SwaggerGet('/:id')
     @SwaggerResponse(MuscleSerialization)
+    @SwaggerSummary("Get muscle")
+    @SwaggerDescription("Get muscle by id")
     get = async (req: Request, res: Response) => {
         const data = await this.musclesService.findOneOrFail({
             _id: req.params.id,
@@ -75,6 +81,8 @@ export class MusclesController extends BaseController {
     @SwaggerPost()
     @SwaggerRequest(createMusclechema)
     @SwaggerResponse(MuscleSerialization)
+    @SwaggerSummary("Create muscle")
+    @SwaggerDescription("Create a new muscle")
     create = async (req: Request, res: Response) => {
         const data = await this.musclesService.create(req.body);
         return JsonResponse.success(
@@ -89,6 +97,8 @@ export class MusclesController extends BaseController {
     @SwaggerPatch('/:id')
     @SwaggerRequest(updateMuscleSchema)
     @SwaggerResponse(MuscleSerialization)
+    @SwaggerSummary("Update muscle")
+    @SwaggerDescription("Update a muscle by id")
     update = async (req: Request, res: Response) => {
         const data = await this.musclesService.updateOne(
             { _id: req.params.id },
@@ -104,6 +114,8 @@ export class MusclesController extends BaseController {
 
     @SwaggerDelete('/:id')
     @SwaggerResponse(MuscleSerialization)
+    @SwaggerSummary("Delete muscle")
+    @SwaggerDescription("Delete a muscle by id")
     delete = async (req: Request, res: Response) => {
         const data = await this.musclesService.deleteOne({ _id: req.params.id });
         return JsonResponse.success(

src/modules/console/modules/users/controllers/users.controller.ts

@@ -8,6 +8,8 @@ import { serialize } from "@helpers/serialize";
 import { UserSerialization } from "@common/serializers/user.serialization";
 import { SwaggerPost } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/users")
 export class AdminUsersController extends BaseController {
@@ -19,6 +21,8 @@ export class AdminUsersController extends BaseController {
 
   @SwaggerPost("/create")
   @SwaggerResponse(UserSerialization)
+  @SwaggerSummary("Create user")
+  @SwaggerDescription("Create a new user")
   create = async (req: Request, res: Response): Promise<Response> => {
     let user = await this.usersService.create(req.body);
 

src/modules/console/modules/workouts/controllers/workouts.controller.ts

@@ -10,6 +10,7 @@ import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
 import { WorkoutSerialization } from "@common/serializers/workout.serialization";
+import { WorkoutSerializationPopulate } from "@common/serializers/workoutPopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { AdminGuardMiddleware } from "modules/console/common/guards/admins.guard";
 import {
@@ -20,6 +21,8 @@ import {
 } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/console/workouts")
 @ControllerMiddleware(AdminGuardMiddleware({}))
@@ -48,17 +51,22 @@ export class WorkoutController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([WorkoutSerialization])
+  @SwaggerResponse([WorkoutSerializationPopulate])
+  @SwaggerSummary("List workouts")
+  @SwaggerDescription("List all workouts in the system")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.workoutsService.list(
       {},
-      paginationQuery
+      paginationQuery,
+      {
+        populateArray: [{ path: "exercises" }],
+      }
     );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, WorkoutSerialization),
+        data: serialize(docs, WorkoutSerializationPopulate),
         meta: paginationData,
       },
       res
@@ -66,14 +74,21 @@ export class WorkoutController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(WorkoutSerialization)
+  @SwaggerResponse(WorkoutSerializationPopulate)
+  @SwaggerSummary("Get workout")
+  @SwaggerDescription("Get workout by id")
   get = async (req: Request, res: Response) => {
-    const data = await this.workoutsService.findOneOrFail({
-      _id: req.params.id,
-    });
+    const data = await this.workoutsService.findOneOrFail(
+      {
+        _id: req.params.id,
+      },
+      {
+        populateArray: [{ path: "exercises" }],
+      }
+    );
     return JsonResponse.success(
       {
-        data: serialize(data.toJSON(), WorkoutSerialization),
+        data: serialize(data.toJSON(), WorkoutSerializationPopulate),
       },
       res
     );
@@ -82,6 +97,8 @@ export class WorkoutController extends BaseController {
   @SwaggerPost()
   @SwaggerResponse(WorkoutSerialization)
   @SwaggerRequest(createWorkoutSchema)
+  @SwaggerSummary("Create workout")
+  @SwaggerDescription("Create a new workout")
   create = async (req: Request, res: Response) => {
     const data = await this.workoutsService.create(req.body);
     return JsonResponse.success(
@@ -96,6 +113,8 @@ export class WorkoutController extends BaseController {
   @SwaggerPatch("/:id")
   @SwaggerResponse(WorkoutSerialization)
   @SwaggerRequest(updateWorkoutSchema)
+  @SwaggerSummary("Update workout")
+  @SwaggerDescription("Update a workout by id")
   update = async (req: Request, res: Response) => {
     const data = await this.workoutsService.updateOne(
       { _id: req.params.id },
@@ -111,6 +130,8 @@ export class WorkoutController extends BaseController {
 
   @SwaggerDelete("/:id")
   @SwaggerResponse(WorkoutSerialization)
+  @SwaggerSummary("Delete workout")
+  @SwaggerDescription("Delete a workout by id")
   delete = async (req: Request, res: Response) => {
     const data = await this.workoutsService.deleteOne({ _id: req.params.id });
     return JsonResponse.success(

src/modules/users/modules/auth/controllers/auth.controller.ts

@@ -16,6 +16,7 @@ import { SwaggerPost } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/user/auth")
 export class UsersAuthController extends BaseController {
@@ -38,6 +39,7 @@ export class UsersAuthController extends BaseController {
   @SwaggerRequest(userRegisterSchema)
   @SwaggerResponse(UserSerialization)
   @SwaggerSummary("Register a new user")
+  @SwaggerDescription("Register a new user")
   register = async (req: Request, res: Response) => {
     const user = await this.authService.register(req.body as IUserRegister);
 
@@ -53,6 +55,7 @@ export class UsersAuthController extends BaseController {
   @SwaggerRequest(loginValidationSchema)
   @SwaggerResponse(UserSerialization)
   @SwaggerSummary("Login a user")
+  @SwaggerDescription("Login a user")
   login = async (req: Request, res: Response): Promise<Response> => {
     const { user, token } = await this.authService.login(req.body);
 

src/modules/users/modules/exercises/controllers/exercises.controller.ts

@@ -7,16 +7,17 @@ import { paramsValidator } from "@helpers/validation.helper";
 import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
-import { ExerciseSerialization } from "@common/serializers/exercise.serialization";
+import { ExercisePopulateSerialization } from "@common/serializers/exercisePopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import { SwaggerGet } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/user/exercises")
 @ControllerMiddleware(UsersGuardMiddleware())
-export class ExerciseController extends BaseController {
+export class UsersExerciseController extends BaseController {
   private exercisesService = new ExerciseService();
 
   setRoutes(): void {
@@ -26,18 +27,26 @@ export class ExerciseController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([ExerciseSerialization])
-  @SwaggerSummary("List all exercises for the user")
+  @SwaggerResponse([ExercisePopulateSerialization])
+  @SwaggerSummary("List exercises")
+  @SwaggerDescription("List all exercises")
   list = async (req: Request, res: Response): Promise<Response> => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.exercisesService.list(
       {},
-      paginationQuery
+      paginationQuery,
+      {
+        populateArray: [
+          { path: "targetMuscles.primary" },
+          { path: "targetMuscles.primary" },
+          { path: "equipments" }
+        ]
+      }
     );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, ExerciseSerialization),
+        data: serialize(docs, ExercisePopulateSerialization),
         meta: paginationData,
       },
       res
@@ -45,24 +54,35 @@ export class ExerciseController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(ExerciseSerialization)
-  @SwaggerSummary("Get a single exercise")
+  @SwaggerResponse(ExercisePopulateSerialization)
+  @SwaggerSummary("Get exercise")
+  @SwaggerDescription("Get a single exercise")
   get = async (req: Request, res: Response): Promise<Response> => {
-    const data = await this.exercisesService.findOneOrFail({
-      _id: req.params.id,
-    });
+    const data = await this.exercisesService.findOneOrFail(
+      {
+        _id: req.params.id,
+      },
+      {
+        populateArray: [
+          { path: "targetMuscles.primary" },
+          { path: "targetMuscles.primary" },
+          { path: "equipments" }
+        ]
+      }
+    );
 
     return JsonResponse.success(
       {
-        data: serialize(data, ExerciseSerialization),
+        data: serialize(data, ExercisePopulateSerialization),
       },
       res
     );
   };
 
   @SwaggerGet()
-  @SwaggerResponse([ExerciseSerialization])
-  @SwaggerSummary("Search for exercises")
+  @SwaggerResponse([ExercisePopulateSerialization])
+  @SwaggerSummary("Search")
+  @SwaggerDescription("Search for exercises")
   search = async (req: Request, res: Response): Promise<Response> => {
     const paginationQuery = parsePaginationQuery(req.query);
     let query = {};
@@ -101,12 +121,19 @@ export class ExerciseController extends BaseController {
 
     const { docs, paginationData } = await this.exercisesService.search(
       query,
-      paginationQuery
+      paginationQuery,
+      {
+        populateArray: [
+          { path: "targetMuscles.primary" },
+          { path: "targetMuscles.primary" },
+          { path: "equipments" }
+        ]
+      }
     );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, ExerciseSerialization),
+        data: serialize(docs, ExercisePopulateSerialization),
         meta: paginationData,
       },
       res

src/modules/users/modules/ingredients/controller/ingredients.controller.ts

@@ -28,7 +28,7 @@ export class UsersIngredientsController extends BaseController {
   @SwaggerGet()
   @SwaggerResponse([IngredientSerialization])
   @SwaggerSummary("list ingredients")
-  @SwaggerDescription("list ingredients")
+  @SwaggerDescription("List all ingredients")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.ingredientsService.list(

src/modules/users/modules/meal-plans/controller/{meals.controller.ts → meal-plans.controller.ts}

@@ -1,5 +1,5 @@
 import { MealPlansService } from "../services/meal-plans.service";
-import { MealPlanSerialization } from "@common/serializers/meal-plan.serialization";
+import { MealPlanPopulateSerialization } from "@common/serializers/meal-planPopulate.serialization";
 import { Request, Response } from "express";
 import { JsonResponse } from "@lib/responses/json-response";
 import { parsePaginationQuery } from "@helpers/pagination";
@@ -25,9 +25,9 @@ export class UsersMealPlansController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([MealPlanSerialization])
+  @SwaggerResponse([MealPlanPopulateSerialization])
   @SwaggerSummary("list meal plans")
-  @SwaggerDescription("list meal plans")
+  @SwaggerDescription("List all meal plans")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.mealPlansService.list(
@@ -35,14 +35,14 @@ export class UsersMealPlansController extends BaseController {
       paginationQuery,
       {
         populateArray: [
-          { path: "days.meals", select: "name ingredients calories carbs proteins fats type" }
+          { path: "days.meals" }
         ],
       }
     );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, MealPlanSerialization),
+        data: serialize(docs, MealPlanPopulateSerialization),
         meta: paginationData,
       },
       res

src/modules/users/modules/meals/controller/meals.controller.ts

@@ -1,5 +1,5 @@
 import { MealsService } from "../services/meals.service";
-import { MealSerialization } from "@common/serializers/meal.serialization";
+import { MealPopulateSerialization } from "@common/serializers/mealPopulate.serialization";
 import { Request, Response } from "express";
 import { JsonResponse } from "@lib/responses/json-response";
 import { parsePaginationQuery } from "@helpers/pagination";
@@ -25,9 +25,9 @@ export class UsersMealsController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([MealSerialization])
+  @SwaggerResponse([MealPopulateSerialization])
   @SwaggerSummary("list meals")
-  @SwaggerDescription("list meals")
+  @SwaggerDescription("List all meals")
   list = async (req: Request, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.mealsService.list(
@@ -41,7 +41,7 @@ export class UsersMealsController extends BaseController {
 
     return JsonResponse.success(
       {
-        data: serialize(docs, MealSerialization),
+        data: serialize(docs, MealPopulateSerialization),
         meta: paginationData,
       },
       res

src/modules/users/modules/templates/controllers/templates.controller.ts

@@ -8,6 +8,7 @@ import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
 import { TemplateSerialization } from "@common/serializers/template.serialization";
+import { TemplatePopulateSerialization } from "@common/serializers/templatePopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import {
@@ -18,7 +19,7 @@ import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
 import { createTemplatesSchema } from "../validations/create-templates.validation";
-import { updateTemplatesSchema } from "../validations/update-templates.validation";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 
 interface userRequest extends Request {
@@ -41,8 +42,9 @@ export class templateController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([TemplateSerialization])
-  @SwaggerSummary("List all templates for the user")
+  @SwaggerResponse([TemplatePopulateSerialization])
+  @SwaggerSummary("List my custom plans")
+  @SwaggerDescription("List all custom plans created by the user logged in")
   list = async (req: userRequest, res: Response): Promise<Response> => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.templatesService.list(
@@ -50,14 +52,14 @@ export class templateController extends BaseController {
       paginationQuery,
       {
         populateArray: [
-          { path: "exercises", select: "name duration reps sets" },
+          { path: "exercises" },
         ],
       }
     );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, TemplateSerialization),
+        data: serialize(docs, TemplatePopulateSerialization),
         meta: paginationData,
       },
       res
@@ -65,8 +67,9 @@ export class templateController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(TemplateSerialization)
-  @SwaggerSummary("Get a single template")
+  @SwaggerResponse(TemplatePopulateSerialization)
+  @SwaggerSummary("Get custom plan")
+  @SwaggerDescription("Get a single custom plan created by the user logged in")
   get = async (req: userRequest, res: Response): Promise<Response> => {
     const data = await this.templatesService.findOneOrFail(
       {
@@ -75,13 +78,13 @@ export class templateController extends BaseController {
       },
       {
         populateArray: [
-          { path: "exercises", select: "name duration reps sets" },
+          { path: "exercises" },
         ],
       });
 
     return JsonResponse.success(
       {
-        data: serialize(data, TemplateSerialization),
+        data: serialize(data, TemplatePopulateSerialization),
       },
       res
     );
@@ -90,7 +93,8 @@ export class templateController extends BaseController {
   @SwaggerPost()
   @SwaggerResponse(TemplateSerialization)
   @SwaggerRequest(createTemplatesSchema)
-  @SwaggerSummary("Create a new template plan")
+  @SwaggerSummary("Create custom plan")
+  @SwaggerDescription("Create a new custom plan")
   create = async (req: userRequest, res: Response) => {
     const data = await this.templatesService.create(req.body);
     return JsonResponse.success(

src/modules/users/modules/user-registered-meal-plans/controller/user-registered-meal-plans.controller.ts

@@ -1,13 +1,11 @@
 import { UserRegisteredMealPlansService } from "../services/user-registered-meal-plans.service";
 import { Request, Response } from "express";
 import { JsonResponse } from "@lib/responses/json-response";
-import { parsePaginationQuery } from "@helpers/pagination";
 import { asyncHandler } from "@helpers/async-handler";
-import { paramsValidator } from "@helpers/validation.helper";
 import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
-import { UserRegisteredMealPlansSerialization } from "@common/serializers/user-registered-meal-plan.serialization";
+import { UserRegisteredMealPlansPopulateSerialization } from "@common/serializers/user-registered-meal-planPopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import { SwaggerGet } from "@lib/decorators/swagger-routes.decorator";
@@ -28,22 +26,22 @@ export class UsersRegisteredMealPlansController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse(UserRegisteredMealPlansSerialization)
-  @SwaggerSummary("my meal plan")
-  @SwaggerDescription("Get the meal plan that the user is currently registered to")
+  @SwaggerResponse(UserRegisteredMealPlansPopulateSerialization)
+  @SwaggerSummary("get my meal plan")
+  @SwaggerDescription("Get the meal plan that the user is currently using")
   get = async (req: userRequest, res: Response): Promise<Response> => {
     const data = await this.userRegisteredMealPlansService.findOneOrFail(
       { user: req.jwtPayload._id, isActive: true },
       {
         populateArray: [
-          { path: "mealPlan", select: "image description Duration Level your_Journey key_Features" },
-          { path: "days.meals", select: "name ingredients calories carbs proteins fats type" }
+          { path: "meal_plan" },
+          { path: "days.meals"}
         ],
       });
 
     return JsonResponse.success(
       {
-        data: serialize(data, UserRegisteredMealPlansSerialization),
+        data: serialize(data, UserRegisteredMealPlansPopulateSerialization),
       },
       res
     );

src/modules/users/modules/user-registered-workouts/controllers/user-registered-workouts.controller.ts

@@ -8,10 +8,10 @@ import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
 import { UserRegisteredWorkoutsSerialization } from "@common/serializers/user-registered-workout.serialization";
+import { UserRegisteredMealPlansPopulateSerialization, UserRegisteredMealPlansPopulateUserSerialization } from "@common/serializers/user-registered-meal-planPopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import { createUserRegisteredWorkoutsSchema } from "../validations/create-user-registered-workouts.validation";
-import { updateUserRegisteredWorkoutsSchema } from "../validations/update-user-registered-workouts.validation";
 import {
   SwaggerGet,
   SwaggerPost,
@@ -19,7 +19,8 @@ import {
 import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
 import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
-import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";
+import { SwaggerRequest } from "@lib/decorators/swagger-request.decorator";4
+
 
 interface userRequest extends Request {
   jwtPayload?: any;
@@ -46,7 +47,8 @@ export class userRegisteredWorkoutsController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([UserRegisteredWorkoutsSerialization])
+  @SwaggerResponse([UserRegisteredMealPlansPopulateSerialization])
+  @SwaggerSummary("List my workouts")
   @SwaggerDescription("List all user registered workouts (workouts that the user had started)")
   list = async (req: userRequest, res: Response) => {
     const paginationQuery = parsePaginationQuery(req.query);
@@ -56,15 +58,15 @@ export class userRegisteredWorkoutsController extends BaseController {
         paginationQuery,
         {
           populateArray: [
-            { path: "workout", select: "-templateWeeks -created_by" },
-            { path: "weeks.days.exercises", select: "name media reps sets" },
+            { path: "workout" },
+            { path: "weeks.days.exercises" },
           ],
         }
       );
 
     return JsonResponse.success(
       {
-        data: serialize(docs, UserRegisteredWorkoutsSerialization),
+        data: serialize(docs, UserRegisteredMealPlansPopulateSerialization),
         meta: paginationData,
       },
       res
@@ -72,43 +74,47 @@ export class userRegisteredWorkoutsController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(UserRegisteredWorkoutsSerialization)
+  @SwaggerResponse(UserRegisteredMealPlansPopulateSerialization)
+  @SwaggerSummary("Get a workout")
   @SwaggerDescription("Get a single workout from user registered workouts (workouts that the user had started)")
   get = async (req: userRequest, res: Response) => {
     const data = await this.userRegisteredWorkoutsService.findOneOrFail(
       { _id: req.params.id },
       {
         populateArray: [
-          { path: "workout", select: "-template_weeks -created_by" },
-          { path: "weeks.days.exercises", select: "name media reps sets" },
+          { path: "workout" },
+          { path: "weeks.days.exercises" },
         ],
       }
     );
     return JsonResponse.success(
       {
-        data: serialize(data.toJSON(), UserRegisteredWorkoutsSerialization),
+        data: serialize(data.toJSON(), UserRegisteredMealPlansPopulateSerialization),
       },
       res
     );
   };
 
   @SwaggerGet("/home/:userId")
-  @SwaggerResponse(UserRegisteredWorkoutsSerialization)
-  @SwaggerSummary("Get the home page for the user")
+  @SwaggerResponse(UserRegisteredMealPlansPopulateUserSerialization)
+  @SwaggerSummary("Get home page")
+  @SwaggerDescription("Get the home page for the user")
   getHomePage = async (req: userRequest, res: Response) => {
+    console.log(req.params);
+    
     const data = await this.userRegisteredWorkoutsService.findOneOrFail(
       { user: req.params.userId },
       {
         populateArray: [
-          { path: "workout", select: "-template_weeks -created_by" },
-          { path: "weeks.days.exercises", select: "name media reps sets" },
-          { path: "user", select: "name preferences" },
+          { path: "workout" },
+          { path: "weeks.days.exercises" },
+          { path: "user" },
         ],
       }
     );
     return JsonResponse.success(
       {
-        data: serialize(data.toJSON(), UserRegisteredWorkoutsSerialization),
+        data: serialize(data.toJSON(), UserRegisteredMealPlansPopulateUserSerialization),
       },
       res
     );
@@ -117,7 +123,8 @@ export class userRegisteredWorkoutsController extends BaseController {
   @SwaggerPost()
   @SwaggerResponse(UserRegisteredWorkoutsSerialization)
   @SwaggerRequest(createUserRegisteredWorkoutsSchema)
-  @SwaggerSummary("Create a workout for the user")
+  @SwaggerSummary("Create workout")
+  @SwaggerDescription("Create a new workout for the user")
   create = async (req: userRequest, res: Response) => {
     const data = await this.userRegisteredWorkoutsService.create(req.body);
     return JsonResponse.success(

src/modules/users/modules/users/controllers/users.controller.ts

@@ -12,6 +12,8 @@ import { ControllerMiddleware } from "@lib/decorators/controller-middleware.deco
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import { SwaggerGet, SwaggerPut } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
+import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 @Controller("/users")
 @ControllerMiddleware(UsersGuardMiddleware())
@@ -26,6 +28,8 @@ export class UsersController extends BaseController {
 
     @SwaggerGet("/:id")
     @SwaggerResponse(UserSerialization)
+    @SwaggerSummary("Get my account")
+    @SwaggerDescription("Get a my account details")
     get = async (req: Request, res: Response): Promise<Response> => {
         const data = await this.userService.findOneOrFail({
             _id: req.params.id,
@@ -41,6 +45,8 @@ export class UsersController extends BaseController {
 
     @SwaggerPut("/:id")
     @SwaggerResponse(UserSerialization)
+    @SwaggerSummary("Update my account")
+    @SwaggerDescription("Update my account details")
     update = async (req: Request, res: Response): Promise<Response> => {
         const data = await this.userService.updateOne(
             {

src/modules/users/modules/workouts/controllers/workouts.controller.ts

@@ -7,12 +7,13 @@ import { paramsValidator } from "@helpers/validation.helper";
 import { BaseController } from "@lib/controllers/controller.base";
 import { Controller } from "@lib/decorators/controller.decorator";
 import { serialize } from "@helpers/serialize";
-import { WorkoutSerialization } from "@common/serializers/workout.serialization";
+import { WorkoutSerializationPopulate } from "@common/serializers/workoutPopulate.serialization";
 import { ControllerMiddleware } from "@lib/decorators/controller-middleware.decorator";
 import { UsersGuardMiddleware } from "modules/users/common/guards/users.guard";
 import { SwaggerGet } from "@lib/decorators/swagger-routes.decorator";
 import { SwaggerResponse } from "@lib/decorators/swagger-response.decorator";
 import { SwaggerSummary } from "@lib/decorators/swagger-summary.decorator";
+import { SwaggerDescription } from "@lib/decorators/swagger-description.decorator";
 
 
 @Controller("/user/workouts")
@@ -26,8 +27,9 @@ export class UsersWorkoutController extends BaseController {
   }
 
   @SwaggerGet()
-  @SwaggerResponse([WorkoutSerialization])
-  @SwaggerSummary("List all workouts for the user")
+  @SwaggerResponse([WorkoutSerializationPopulate])
+  @SwaggerSummary("List workouts")
+  @SwaggerDescription("List all workouts in the system")
   list = async (req: Request, res: Response): Promise<Response> => {
     const paginationQuery = parsePaginationQuery(req.query);
     const { docs, paginationData } = await this.workoutsService.list(
@@ -37,7 +39,7 @@ export class UsersWorkoutController extends BaseController {
 
     return JsonResponse.success(
       {
-        data: serialize(docs, WorkoutSerialization),
+        data: serialize(docs, WorkoutSerializationPopulate),
         meta: paginationData,
       },
       res
@@ -45,8 +47,9 @@ export class UsersWorkoutController extends BaseController {
   };
 
   @SwaggerGet("/:id")
-  @SwaggerResponse(WorkoutSerialization)
-  @SwaggerSummary("Get a single workout")
+  @SwaggerResponse(WorkoutSerializationPopulate)
+  @SwaggerSummary("Get  workout")
+  @SwaggerDescription("Get a single workout")
   get = async (req: Request, res: Response): Promise<Response> => {
     const data = await this.workoutsService.findOneOrFail(
       { _id: req.params.id },
@@ -58,7 +61,7 @@ export class UsersWorkoutController extends BaseController {
 
     return JsonResponse.success(
       {
-        data: serialize(data, WorkoutSerialization),
+        data: serialize(data, WorkoutSerializationPopulate),
       },
       res
     );