usecase-design

Use Case Design (tRPC + Modules)

Overview

Use cases encapsulam lógica de negócio na camada application. tRPC routers são thin - apenas validam input e chamam use cases.

Estrutura: packages/api/src/modules/{module}/application/use-cases/

The Iron Law

ZERO LÓGICA DE NEGÓCIO NO TRPC ROUTER

O critério NÃO é contagem de linhas. É: pode um dev júnior entender o router em 5 segundos sem conhecer Prisma ou regras de negócio?

Se a resposta é não, refatore.

Quick Reference

Camada	Responsabilidade	Exemplo
Router (tRPC)	Validar input, chamar use case	orderRouter.ts
Use Case	Orquestrar lógica de negócio	CreateOrderUseCase.ts
Repository Interface	Contrato de acesso a dados	IOrderRepository.ts
Repository Impl	Implementação (Prisma, etc)	PrismaOrderRepository.ts

Estrutura de Módulo

packages/api/src/modules/orders/
├── application/
│   ├── use-cases/
│   │   ├── CreateOrderUseCase.ts
│   │   └── GetOrderUseCase.ts
│   ├── dtos/
│   │   ├── CreateOrderInput.ts
│   │   └── CreateOrderOutput.ts
│   └── ports/
│       └── IOrderRepository.ts
├── domain/
│   └── Order.ts
├── infrastructure/
│   └── PrismaOrderRepository.ts
└── presentation/
    └── order.router.ts

Padrão de Use Case

// application/use-cases/CreateOrderUseCase.ts
export class CreateOrderUseCase {
  constructor(
    private readonly orderRepository: IOrderRepository,
    private readonly productRepository: IProductRepository,
    private readonly userRepository: IUserRepository
  ) {}

  async execute(input: CreateOrderInput): Promise<CreateOrderOutput> {
    // 1. Validar usuário
    const user = await this.userRepository.findById(input.userId);
    if (!user) throw new UserNotFoundError(input.userId);

    // 2. Validar produtos e calcular
    const products = await this.productRepository.findByIds(input.productIds);
    const total = this.calculateTotal(products, input.items);

    // 3. Criar pedido
    const order = Order.create({ userId: user.id, items: input.items, total });
    await this.orderRepository.save(order);

    return { orderId: order.id, total };
  }

  private calculateTotal(products: Product[], items: OrderItem[]): number {
    // lógica de cálculo
  }
}