Feat/level

backend/src/main.ts

@@ -13,7 +13,6 @@ async function bootstrap() {
 
   app.enableCors();
   app.setGlobalPrefix('ProDeskApi');
-  app.useGlobalPipes(new ValidationPipe());
 
   const config = new DocumentBuilder()
     .setTitle('ProDesk')

backend/src/modules/auth/auth.service.ts

@@ -26,7 +26,7 @@ export class AuthService {
   }
 
   async register(user: Readonly<CreateUserDTO>): Promise<UserDetails | any> {
-    const { name, email, password, role, companyId, categories } = user;
+    const { name, email, password, role, companyId, categories, level } = user;
 
     const existingUser = await this.userService.findByEmail(email);
 
@@ -41,6 +41,7 @@ export class AuthService {
       role,
       companyId,
       categories,
+      level
     );
 
     return this.userService._getUser(newUser);

backend/src/modules/ticket/application/useCases/create/create.usecase.ts

@@ -10,6 +10,7 @@ export interface CreateTicketInput {
   title: string;
   description: string;
   clientId: string;
+  level?: number;
 }
 
 export interface CreateTicketOutput {
@@ -20,6 +21,7 @@ export interface CreateTicketOutput {
   clientId: string;
   fileUrls: string[];
   status: TicketStatus;
+  level: number;
   createdAt: Date;
 }
 
@@ -51,6 +53,7 @@ export class CreateTicketUseCase {
       clientId: primitives.clientId,
       fileUrls: primitives.fileUrls,
       status: primitives.status,
+      level: primitives.escalationLevel,
       createdAt: primitives.createdAt,
     };
   }

backend/src/modules/ticket/application/useCases/escalate/escalate.usecase.ts

@@ -9,6 +9,7 @@ export interface EscalateTicketInput {
   id: string;
   groupId: string;
   category: string;
+  whatWasDone: string;
 }
 
 export interface EscalateTicketOutput {
@@ -36,7 +37,7 @@ export class EscalateTicketUseCase {
       throw new Error('Ticket not found');
     }
 
-    foundedTicket.escalate(input.groupId, input.category);
+    foundedTicket.escalate(input.groupId, input.category, input.whatWasDone);
 
     const escalatedTicket = await this.repository.save(foundedTicket);
 

backend/src/modules/ticket/domain/entities/ticket.entity.ts

@@ -34,6 +34,7 @@ export enum TicketValidationErrors {
   ECALATE_WITH_NO_AGENT_ERROR = 'The ticket must be assigned to an agent before being escalated.',
   CLOSE_WITH_WRONG_STATUS_ERROR = 'A ticket can only be closed when in progress status.',
   CLOSE_WITH_NO_SOLUTION_ERROR = 'The solution cannot be empty.',
+  ESCALATION_LEVEL_MAX_ERROR = 'The ticket has reached the maximum escalation level.'
 }
 
 export type TicketHistoryEntry = {
@@ -100,6 +101,7 @@ export class Ticket {
     category: string;
     description: string;
     clientId: string;
+    level?: number;
   }): Ticket {
     const ticket = new Ticket(
       props.title,
@@ -110,6 +112,7 @@ export class Ticket {
 
     ticket._id = randomUUID();
     ticket.createdAt = new Date();
+    ticket.escalationLevel = props.level ?? 1;
 
     ticket.addHistory({
       event: TicketEvents.OPEN_NEW_TICKET,
@@ -180,6 +183,7 @@ export class Ticket {
       agentId: this._agentId,
       groupId: this._groupId,
       escalationLevel: this.escalationLevel,
+      history: this.history,
       createdAt: this.createdAt,
       updatedAt: this.updatedAt,
       closedAt: this.closedAt,
@@ -221,11 +225,15 @@ export class Ticket {
   }
 
   // Escalates the ticket to a new responsible group and optionally changes the category
-  escalate(groupId: string, category?: string): void {
+  escalate(groupId: string, category?: string, whatWasDone?: string): void {
     if (!this._agentId) {
       throw new Error(TicketValidationErrors.ECALATE_WITH_NO_AGENT_ERROR);
     }
 
+    if (this.escalationLevel >= 3) {
+      throw new Error(TicketValidationErrors.ESCALATION_LEVEL_MAX_ERROR);
+    }
+
     this.touch();
 
     this._groupId = groupId;
@@ -238,6 +246,7 @@ export class Ticket {
       responsibleAgent: this._agentId,
       status: TicketStatus.ESCALATED,
       message: TicketEventMessage.ESCALATE_MSG,
+      solution: whatWasDone ?? null
     });
   }
 

backend/src/modules/ticket/presentation/dtos/create.dto.ts

@@ -1,4 +1,4 @@
-import { IsNotEmpty, IsString } from 'class-validator';
+import { IsNotEmpty, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
 import { ApiProperty } from '@nestjs/swagger';
 
 export class CreateTicketRequest {
@@ -17,4 +17,11 @@ export class CreateTicketRequest {
   @IsString()
   @IsNotEmpty()
   clientId!: string;
+
+  @ApiProperty({ example: 1, description: 'Nível do chamado (1 a 3)' })
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Max(3)
+  level?: number;
 }

backend/src/modules/ticket/presentation/dtos/escalateTicket.dto.ts

@@ -8,11 +8,15 @@ export class EscalateTicketRequest {
   @IsNotEmpty()
   groupId!: string;
 
-  @ApiProperty({
-    example: 'web_app',
-    description: 'Categoria do ticket',
-  })
+  @ApiProperty({ example: 'web_app', description: 'Categoria do ticket' })
   @IsString()
   @IsNotEmpty()
   category!: string;
+
+  @ApiProperty({ 
+    example: 'Reiniciei o servidor e o problema persistiu.',
+    description: 'O que foi feito antes de escalonar' })
+  @IsString()
+  @IsNotEmpty()
+  whatWasDone!: string;
 }

backend/src/modules/ticket/presentation/mappers/ticket.mapper.ts

@@ -11,6 +11,7 @@ export class TicketMapper {
       title: req.title,
       description: req.description,
       clientId: req.clientId,
+      level: req.level
     };
   }
 
@@ -32,6 +33,7 @@ export class TicketMapper {
       id: id,
       groupId: req.groupId,
       category: req.category,
+      whatWasDone: req.whatWasDone
     };
   }
 }

backend/src/modules/user/dtos/createUserDTO.ts

@@ -6,6 +6,9 @@ import {
   IsStrongPassword,
   IsArray,
   IsMongoId,
+  IsNumber,
+  Min,
+  Max,
 } from 'class-validator';
 import { UserRole } from '../user.schema';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
@@ -57,6 +60,16 @@ export class CreateUserDTO {
   @IsArray()
   @IsMongoId({ each: true })
   categories?: string[];
+
+  @ApiPropertyOptional({
+    example: 1,
+    description: 'Nível do atendente (1 a 3)'
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Max(3)
+  level?: number;
 }
 
 export class CreateAdminDTO {
@@ -127,6 +140,16 @@ export class CreateSupportDTO {
   @IsArray()
   @IsMongoId({ each: true })
   categories?: string[];
+
+  @ApiPropertyOptional({
+    example: 1,
+    description: 'Nível do atendente (1 a 3)'
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Max(3)
+  level?: number;
 }
 
 export class CreateClientDTO {

backend/src/modules/user/dtos/updateUserDTO.ts

@@ -1,4 +1,4 @@
-import { IsEmail, IsString, IsOptional } from 'class-validator';
+import { IsEmail, IsString, IsOptional, IsNumber, Min, Max } from 'class-validator';
 import { ApiPropertyOptional } from '@nestjs/swagger';
 
 export class UpdateUserDTO {
@@ -16,4 +16,11 @@ export class UpdateUserDTO {
   @IsOptional()
   @IsString()
   companyId?: string;
+
+  @ApiPropertyOptional({ example: 1, description: 'Nível do atendente (1 a 3)' })
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Max(3)
+  level?: number;
 }

backend/src/modules/user/user.interface.ts

@@ -7,6 +7,7 @@ export interface UserDetails {
   name: string;
   email: string;
   role: UserRole;
+  level?: number;
   company?: CompanyDetails;
   categories?: CategoryDetails[];
   profileImage?: string;

backend/src/modules/user/user.schema.ts

@@ -29,6 +29,12 @@ export class User {
   })
   role: UserRole;
 
+  @Prop({
+    required: false,
+    default: 1
+  })
+  level: number;
+
   @Prop({
     type: Types.ObjectId,
     ref: 'Company',

backend/src/modules/user/user.service.ts

@@ -108,6 +108,7 @@ export class UserService {
     role: UserRole,
     companyId?: string,
     categories?: string[],
+    level?: number
   ): Promise<UserDocument> {
     if (companyId) {
       const company = await this.companyService.findById(companyId);
@@ -130,6 +131,7 @@ export class UserService {
       role,
       companyId,
       categories,
+      level
     });
 
     const savedUser = await newUser.save();
@@ -199,6 +201,7 @@ export class UserService {
       name: user.name,
       email: user.email,
       role: user.role,
+      level: user.level,
       profileImage: user.profileImage,
 
       company: user.companyId