TASK-ID: Implementa funcionalidades de gerenciamento de todos

prisma/migrations/20250818161357_todo_migration/migration.sql

@@ -0,0 +1,10 @@
+-- CreateTable
+CREATE TABLE "todos" (
+    "id" SERIAL NOT NULL,
+    "text" TEXT NOT NULL,
+    "isCompleted" BOOLEAN NOT NULL DEFAULT false,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "todos_pkey" PRIMARY KEY ("id")
+);

prisma/migrations/20250818223047_add_map_decorator_to_is_completed/migration.sql

@@ -0,0 +1,9 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `isCompleted` on the `todos` table. All the data in the column will be lost.
+
+*/
+-- AlterTable
+ALTER TABLE "todos" DROP COLUMN "isCompleted",
+ADD COLUMN     "is_completed" BOOLEAN NOT NULL DEFAULT false;

prisma/schema.prisma

@@ -14,10 +14,20 @@ datasource db {
 }
 
 model Example {
-  id Int  @id @default(autoincrement())
-  text String
+  id        Int      @id @default(autoincrement())
+  text      String
   createdAt DateTime @default(now()) @map("created_at")
   updatedAt DateTime @default(now()) @updatedAt @map("updated_at")
 
   @@map("examples")
-}
+}
+
+model ToDo {
+  id          Int      @id @default(autoincrement())
+  text        String
+  isCompleted Boolean  @default(false) @map("is_completed")
+  createdAt   DateTime @default(now()) @map("created_at")
+  updatedAt   DateTime @default(now()) @updatedAt @map("updated_at")
+
+  @@map("todos")
+}

src/domain/entities/toDo.ts

@@ -0,0 +1,6 @@
+import { BaseEntity } from "./base";
+
+export interface ToDo extends BaseEntity {
+  text: string;
+  isCompleted: boolean;
+}

src/domain/repositories/toDo.ts

@@ -0,0 +1,12 @@
+import { ToDo } from "@domain/entities/toDo";
+
+export abstract class ToDoRepository {
+  abstract create(text: string): Promise<void>;
+  abstract findAll(filter?: string): Promise<ToDo[]>;
+  abstract findById(id: number): Promise<ToDo | null>;
+  abstract update(
+    id: number,
+    text: string,
+    isCompleted: boolean
+  ): Promise<void>;
+}

src/infra/config/main.ts

@@ -1,9 +1,19 @@
 import { NestFactory } from "@nestjs/core";
 import { AppModule } from "@infra/modules/app";
 import { SwaggerConfig } from "./swagger";
+import { ValidationPipe } from "@nestjs/common";
 
 async function bootstrap(): Promise<void> {
   const app = await NestFactory.create(AppModule);
+
+  app.useGlobalPipes(
+    new ValidationPipe({
+      transform: true,
+      forbidNonWhitelisted: true,
+      whitelist: true
+    })
+  );
+
   SwaggerConfig.config(app);
   await app.listen(3001);
 }

src/infra/config/swagger/responses/toDo/create.ts

@@ -0,0 +1,8 @@
+import { applyDecorators } from "@nestjs/common";
+import { ApiCreatedResponse } from "@nestjs/swagger";
+
+export const CreateToDoResponse = applyDecorators(
+  ApiCreatedResponse({
+    description: "ToDo criado com sucesso!"
+  })
+);

src/infra/config/swagger/responses/toDo/find-all.ts

@@ -0,0 +1,25 @@
+import { ToDo } from "@domain/entities/toDo";
+import { applyDecorators } from "@nestjs/common";
+import { ApiOkResponse, ApiProperty } from "@nestjs/swagger";
+
+const TODO: ToDo = {
+  id: 1,
+  text: "ToDo 1",
+  isCompleted: false,
+  createdAt: new Date(),
+  updatedAt: new Date()
+};
+
+export class ToDoReturnDto {
+  @ApiProperty({
+    example: [TODO, TODO]
+  })
+  toDos: ToDo[];
+}
+
+export const FindAllToDoResponses = applyDecorators(
+  ApiOkResponse({
+    description: "Todas os toDos foram encontrados",
+    type: ToDoReturnDto
+  })
+);

src/infra/config/swagger/responses/toDo/toggle.ts

@@ -0,0 +1,18 @@
+import { applyDecorators } from "@nestjs/common";
+import { ApiOkResponse, ApiParam, ApiNotFoundResponse } from "@nestjs/swagger";
+
+export const ToggleToDoResponses = applyDecorators(
+  ApiOkResponse({
+    description: "ToDo atualizado com sucesso!"
+  }),
+
+  ApiParam({
+    name: "id",
+    type: Number,
+    description: "ID do ToDo a ser atualizado"
+  }),
+
+  ApiNotFoundResponse({
+    description: "ToDo não encontrado"
+  })
+);

src/infra/controllers/toDo/dtos/create-toDo.ts

@@ -0,0 +1,11 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsNotEmpty, IsString } from "class-validator";
+
+export class CreateToDoDto {
+  @ApiProperty({
+    description: "Texto do ToDo"
+  })
+  @IsString()
+  @IsNotEmpty({ message: "Texto não pode ser vazio" })
+  text: string;
+}

src/infra/controllers/toDo/dtos/find-all-toDo.ts

@@ -0,0 +1,12 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsOptional, IsString } from "class-validator";
+
+export class FindAllToDoDto {
+  @ApiProperty({
+    description: "Filtro opcional para buscar toDos",
+    required: false
+  })
+  @IsOptional()
+  @IsString()
+  filter?: string;
+}

src/infra/controllers/toDo/index.ts

@@ -0,0 +1,48 @@
+import {
+  Body,
+  Controller,
+  Get,
+  Param,
+  Patch,
+  ParseIntPipe,
+  Post,
+  Query
+} from "@nestjs/common";
+import { CreateToDoDto } from "./dtos/create-toDo";
+import { CreateToDoUseCase } from "@use-cases/toDo/create";
+import { CreateToDoResponse } from "@infra/config/swagger/responses/toDo/create";
+import { ApiTags } from "@nestjs/swagger";
+import { FindAllToDoResponses } from "@infra/config/swagger/responses/toDo/find-all";
+import { ToDo } from "@domain/entities/toDo";
+import { FindAllToDoUseCase } from "@use-cases/toDo/find-all";
+import { ToggleToDoUseCase } from "@use-cases/toDo/toggle";
+import { ToggleToDoResponses } from "@infra/config/swagger/responses/toDo/toggle";
+import { FindAllToDoDto } from "./dtos/find-all-toDo";
+
+@ApiTags("ToDo")
+@Controller("to-do")
+export class ToDoController {
+  constructor(
+    private readonly createToDoUseCase: CreateToDoUseCase,
+    private readonly findAllToDoUseCase: FindAllToDoUseCase,
+    private readonly toggleToDoUseCase: ToggleToDoUseCase
+  ) {}
+
+  @Post()
+  @CreateToDoResponse
+  create(@Body() createToDoDto: CreateToDoDto): Promise<void> {
+    return this.createToDoUseCase.create(createToDoDto.text);
+  }
+
+  @Get()
+  @FindAllToDoResponses
+  findAll(@Query() { filter }: FindAllToDoDto): Promise<{ toDos: ToDo[] }> {
+    return this.findAllToDoUseCase.findAll({ filter });
+  }
+
+  @Patch(":id/toggle")
+  @ToggleToDoResponses
+  toggle(@Param("id", ParseIntPipe) id: number): Promise<void> {
+    return this.toggleToDoUseCase.toggle({ id });
+  }
+}

src/infra/modules/app/index.ts

@@ -1,7 +1,8 @@
 import { Module } from "@nestjs/common";
 import { ExampleModule } from "@infra/modules/example";
+import { ToDoModule } from "@infra/modules/toDo";
 
 @Module({
-  imports: [ExampleModule]
+  imports: [ExampleModule, ToDoModule]
 })
 export class AppModule {}

src/infra/modules/database/index.ts

@@ -2,19 +2,29 @@ import { PrismaExampleRepository } from "@infra/repositories/prisma/example";
 import { Module } from "@nestjs/common";
 import { ExampleRepository } from "@domain/repositories/example";
 import { Prisma } from "@infra/config/prisma";
+import { PrismaToDoRepository } from "@infra/repositories/prisma/toDo";
+import { ToDoRepository } from "@domain/repositories/toDo";
 
 @Module({
   providers: [
     Prisma,
     {
       useClass: PrismaExampleRepository,
       provide: ExampleRepository
+    },
+    {
+      useClass: PrismaToDoRepository,
+      provide: ToDoRepository
     }
   ],
   exports: [
     {
       useClass: PrismaExampleRepository,
       provide: ExampleRepository
+    },
+    {
+      useClass: PrismaToDoRepository,
+      provide: ToDoRepository
     }
   ]
 })

src/infra/modules/toDo/index.ts

@@ -0,0 +1,13 @@
+import { Module } from "@nestjs/common";
+import { CreateToDoUseCase } from "@use-cases/toDo/create";
+import { DatabaseModule } from "@infra/modules/database";
+import { ToDoController } from "@infra/controllers/toDo";
+import { FindAllToDoUseCase } from "@use-cases/toDo/find-all";
+import { ToggleToDoUseCase } from "@use-cases/toDo/toggle";
+
+@Module({
+  imports: [DatabaseModule],
+  controllers: [ToDoController],
+  providers: [CreateToDoUseCase, FindAllToDoUseCase, ToggleToDoUseCase]
+})
+export class ToDoModule {}

src/infra/repositories/prisma/toDo.ts

@@ -0,0 +1,47 @@
+import { ToDoRepository } from "@domain/repositories/toDo";
+import { Prisma } from "@infra/config/prisma";
+import { Injectable } from "@nestjs/common";
+import { ToDo } from "@domain/entities/toDo";
+
+@Injectable()
+export class PrismaToDoRepository implements ToDoRepository {
+  constructor(private readonly prisma: Prisma) {}
+
+  async create(text: string): Promise<void> {
+    await this.prisma.toDo.create({ data: { text } });
+
+    return;
+  }
+
+  async findAll(filter?: string): Promise<ToDo[]> {
+    if (filter) {
+      return this.prisma.toDo.findMany({
+        where: {
+          text: {
+            contains: filter,
+            mode: "insensitive"
+          }
+        }
+      });
+    }
+
+    return this.prisma.toDo.findMany();
+  }
+
+  async findById(id: number): Promise<ToDo | null> {
+    const toDo = await this.prisma.toDo.findUnique({ where: { id } });
+
+    if (!toDo) {
+      return null;
+    }
+
+    return toDo;
+  }
+
+  async update(id: number, text: string, isCompleted: boolean): Promise<void> {
+    await this.prisma.toDo.update({
+      where: { id },
+      data: { text, isCompleted }
+    });
+  }
+}

src/use-cases/toDo/create/create.spec.ts

@@ -0,0 +1,23 @@
+import { ToDoRepository } from "@domain/repositories/toDo";
+import { CreateToDoUseCase } from ".";
+import { ToDoRepositoryStub } from "@test/stubs/repositories/toDo";
+
+describe("Create ToDo Use Case", () => {
+  let sut: CreateToDoUseCase;
+  let toDoRepository: ToDoRepository;
+
+  beforeEach(() => {
+    toDoRepository = new ToDoRepositoryStub();
+    sut = new CreateToDoUseCase(toDoRepository);
+  });
+
+  it("should call a method that create a toDo", async () => {
+    jest.spyOn(toDoRepository, "create");
+
+    const TEXT = "text";
+
+    await sut.create(TEXT);
+
+    expect(toDoRepository.create).toHaveBeenCalledWith(TEXT);
+  });
+});

src/use-cases/toDo/create/index.ts

@@ -0,0 +1,11 @@
+import { ToDoRepository } from "@domain/repositories/toDo";
+import { Injectable } from "@nestjs/common";
+
+@Injectable()
+export class CreateToDoUseCase {
+  constructor(private readonly toDoRepository: ToDoRepository) {}
+
+  async create(text: string): Promise<void> {
+    return this.toDoRepository.create(text);
+  }
+}

src/use-cases/toDo/find-all/find-all.spec.ts

@@ -0,0 +1,31 @@
+import { FindAllToDoUseCase } from ".";
+import { ToDoRepositoryStub } from "@test/stubs/repositories/toDo";
+import { ToDoRepository } from "@domain/repositories/toDo";
+
+describe("Find All ToDo Use Case", () => {
+  let sut: FindAllToDoUseCase;
+  let toDoRepository: ToDoRepository;
+
+  beforeEach(() => {
+    toDoRepository = new ToDoRepositoryStub();
+    sut = new FindAllToDoUseCase(toDoRepository);
+  });
+
+  const TODO = {
+    id: 1,
+    text: "ToDo 1",
+    isCompleted: false,
+    createdAt: new Date(),
+    updatedAt: new Date()
+  };
+
+  const TODOS = [TODO, TODO, TODO];
+
+  it("should call a method that return a list of toDos", async () => {
+    jest.spyOn(toDoRepository, "findAll").mockResolvedValue(TODOS);
+
+    const result = await sut.findAll({ filter: "ToDo 1" });
+
+    expect(result).toStrictEqual({ toDos: TODOS });
+  });
+});