feat: Add request body validation with DTOs & Swagger docs to the routes

[ocsoares]

Essse PR adiciona a validação do corpo das requisições nas rotas, garantindo que apenas os dados solicitados pela aplicação sejam aceitos, com a tipagem correta. Foi utilizado as bibliotecas:

• @nestjs/swagger: Para a documentação automatizada da API
• class-validator: Para a validação dos dados
• class-transformer: Para a transformação dos dados

Essa validação ocorre antes do processamento dos dados pela aplicação, então só serão processados se todos os campos estiverem válidos.

Sem validação (ANTES):
Imagens

Com validação (DEPOIS):
Imagens

[MathiTz]

não deveria ser obrigatório? afinal estou criando um suprimento e estou dizendo que seu deve ser mínimo um

[ocsoares]

Eu apenas segui a lógica já implementada na aplicação, então nesse DTO a propriedade "quantity" deve ser opcional, como consta nos types

backend/src/shelter-supply/types.ts

Lines 5 to 25 in c40e724

	const ShelterSupplySchema = z.object({
	id: z.string(),
	shelterId: z.string(),
	supplyId: z.string(),
	priority: z.union([
	z.literal(SupplyPriority.UnderControl),
	z.literal(SupplyPriority.Remaining),
	z.literal(SupplyPriority.Needing),
	z.literal(SupplyPriority.Urgent),
	]),
	quantity: z.number().gt(0).nullable().optional(),
	createdAt: z.string(),
	updatedAt: z.string().nullable().optional(),
	});
	const CreateShelterSupplySchema = ShelterSupplySchema.pick({
	shelterId: true,
	supplyId: true,
	priority: true,
	quantity: true,
	});

[MathiTz]

Perfeito! Acredito que não era para ter esse 'estado' nos types mas como já é o formato antigo, tudo em ordem camarada