Use Case Flow

Mapeamento do projeto

• Use cases: apps/api/src/<context_plural>/application/use-cases/*.use-case.ts
• Controllers: apps/api/src/<context_plural>/interfaces/http/*.controller.ts
• Repositories: apps/api/src/<context_plural>/infra/repositories/*-prisma.repository.ts
• Contratos de repositório: apps/api/src/<context_plural>/domain/repositories/*.repository.ts
• Schemas zod: packages/schemas/<entity_name>/*.schema.ts
• DTOs HTTP: apps/api/src/<context_plural>/interfaces/dto/**

Regras globais

• Contratos HTTP baseados em @repo/schemas via DTOs de interfaces/dto
• DTOs com createZodDto(...) e export de aliases *InputDto / *OutputDto
• Use cases devem consumir tipos de interfaces/dto/**, sem importar @repo/schemas diretamente
• Regra de negócio no domínio/use case, não no controller
• Repository sem validação HTTP
• Testes unitários ao lado dos arquivos (*.spec.ts)
• Stack: vitest, @nestjs/testing, vitest-mock-extended, supertest

Checklist final

• Schema criado e exportado em packages/schemas/index.ts
• Use case com @Injectable() e método execute()
• Contrato do repositório alinhado com o use case
• Repositório Prisma implementado/ajustado
• Controller + DTOs conectados ao schema
• Módulo Nest atualizado (providers e binding provide/useClass)
• Teste unitário de schema
• Teste unitário de use case
• Teste unitário de repositório
• Teste unitário de controller
• Validação final executada com pnpm build
• Validação final executada com pnpm test