Domain-Driven Design em JavaScript: Código complexo? Colocando ordem como um profissional

Seu código JavaScript está virando um espaguete? Hora de implementar DDD

Você já se pegou pensando que seu projeto em JavaScript parece um prato de espaguete? Métodos se arrastam uns pelos outros, mudanças em um módulo quebram outros três, e a lógica de negócios está espalhada por controllers, services e utilitários. Familiar? Se seu projeto passou da fase de "apenas protótipo", está na hora de conhecer o Domain-Driven Design (DDD) — design orientado a domínio.

Muitos pensam que DDD é coisa de monstros em Java ou C#. Mas isso é um mito. Domain-Driven Design em JavaScript não só é possível, como é incrivelmente útil. Ele ajuda desenvolvedores e negócios a falarem a mesma língua, e o código se torna previsível e resistente a mudanças. Neste artigo, vamos explorar DDD na prática, com exemplos de código real, para que você possa aplicá-lo ainda hoje.

O que é DDD e por que um desenvolvedor JavaScript precisa dele?

DDD não é uma biblioteca nem um framework. É uma abordagem para design de software que coloca o domínio do negócio no centro. Em vez de pensar em tabelas de banco de dados ou REST API, você pensa nas entidades do negócio: "Pedido", "Cliente", "Fatura", "Regra de cálculo de desconto".

A principal dor que o DDD resolve é a complexidade. Quando a lógica de negócios vive em um lugar e os detalhes técnicos em outro, o projeto se torna frágil. O DDD oferece uma arquitetura clara que separa o joio do trigo.

Para JavaScript, onde frequentemente usamos tipagem dinâmica e protótipos, o DDD traz disciplina. Ele força a descrição explícita dos tipos de dados e regras de alteração, o que é crucial para aplicações escaláveis em Node.js ou aplicações client-side complexas.

Principais blocos de construção do DDD (com exemplos em JS)

Vamos ao que interessa — o código. Vamos escrever um sistema simples, mas ilustrativo, de gerenciamento de pedidos em um e-commerce. Usaremos JavaScript moderno (ES6+).

1. Value Object (Objeto de Valor)

É um objeto imutável definido por seus atributos, não por identidade. Dois Value Objects são iguais se tiverem os mesmos valores. Exemplo ideal: dinheiro, endereço, email.

// value-objects/Money.js\nclass Money {\n  constructor(amount, currency) {\n    // Validação — parte essencial do DDD\n    if (typeof amount !== 'number' || amount < 0) {\n      throw new Error('O valor deve ser um número positivo');\n    }\n    if (!['USD', 'BRL', 'EUR'].includes(currency)) {\n      throw new Error('Moeda não suportada');\n    }\n\n    this._amount = amount;\n    this._currency = currency;\n    // Congela o objeto para imutabilidade\n    Object.freeze(this);\n  }\n\n  get amount() { return this._amount; }\n  get currency() { return this._currency; }\n\n  // Método de negócio: soma de dinheiro\n  add(otherMoney) {\n    if (this.currency !== otherMoney.currency) {\n      throw new Error('Não é possível somar moedas diferentes');\n    }\n    return new Money(this.amount + otherMoney.amount, this.currency);\n  }\n\n  equals(other) {\n    return this.amount === other.amount && this.currency === other.currency;\n  }\n}\n\n// Uso\nconst price = new Money(100, 'USD');\nconst tax = new Money(20, 'USD');\nconst total = price.add(tax); // Money { _amount: 120, _currency: 'USD' }\nconsole.log(total);

Por que isso é legal? Agora o valor monetário não é apenas um número, mas uma entidade completa com regras. Você não conseguirá acidentalmente somar dólares com reais ou tornar o valor negativo.

2. Entity (Entidade)

Diferente do Value Object, uma Entidade tem identidade. Ela pode mudar ao longo do tempo, mas seu ID permanece o mesmo. Por exemplo, um usuário ou um pedido.

// entities/Order.js\nconst { v4: uuidv4 } = require('uuid'); // ou crypto.randomUUID()\n\nclass Order {\n  constructor(id