Gerando Backend Module (NestJS)

Inicio rapido

Pedir o nome do modulo em kebab-case (ex: products, teams, reports). Gera:

apps/<backend-app>/src/<modulo>/
  dto/
    create-{module}.dto.ts
    update-{module}.dto.ts
    {module}-response.dto.ts
  {module}.service.ts
  {module}.controller.ts
  {module}.module.ts
  {module}.service.spec.ts   <- TDD: escrever ANTES do service

Ordem de geracao (obrigatoria)

1. Interface compartilhada: verificar/criar em @org/shared se ainda nao existe.
2. DTOs: create, update, response.
3. Testes (spec.ts): escrever ANTES do service (TDD Red).
4. Service: implementar ate os testes passarem (TDD Green).
5. Controller: conectar DTOs + Swagger.
6. Module: registrar controller + service e importar no modulo raiz.

Templates

• DTOs: DTOS
• Service: SERVICE
• Controller e Module: CONTROLLER
• Testes: TESTS

Checklist Swagger (por endpoint)

• @ApiOperation({ summary, description })
• @ApiResponse({ status: 200, type: ResponseDto })
• @ApiParam se a rota tem :id
• @ApiBody({ type: CreateDto }) em POST/PUT/PATCH
• Controller com @ApiTags, @ApiBearerAuth, @UseGuards(JwtAuthGuard)

Regras criticas

• Nunca throw new Error(): usar HttpException ou o helper de erro do BaseService.
• Nunca export default.
• Sempre excludeExtraneousValues: true na serializacao dos response DTOs.
• Importar tipos de @org/shared; nunca duplicar contrato publico.
• TDD: spec antes da implementacao.
• Banco em snake_case, JSON em camelCase (mapear com @Expose / @Transform ou no service).
• select explicito no Prisma: nunca retornar a linha inteira por padrao.

Placeholders

Pre-requisito: BaseService

Os templates assumem um BaseService com:

protected validateId(id: number): void;
protected validateExists<T>(entity: T | null, label: string, id: number): asserts entity is T;
protected handleServiceError(error: unknown, context: string): never;

Se o projeto destino nao tiver, criar antes ou trocar as chamadas por throw new HttpException(...) direto no service.

Alinhamento de arquitetura

Contratos HTTP publicos nascem na lib compartilhada, nunca duplicados entre front e back. Nao introduzir novos limites de rede (microservicos, BFF extra) sem aprovacao explicita.