Arquitetura Hexagonal

// Porta de saída (driven): o domínio declara o que precisa
interface RepositorioPedido {
  salvar(pedido: Pedido): Promise<void>;
}

// Porta de entrada (driving): caso de uso
interface CriarPedido {
  executar(cmd: { itens: string[] }): Promise<string>;
}

// Domínio: depende só das interfaces
class ServicoPedido implements CriarPedido {
  constructor(private repo: RepositorioPedido) {}
  async executar(cmd: { itens: string[] }) {
    const pedido = Pedido.novo(cmd.itens);
    await this.repo.salvar(pedido);
    return pedido.id;
  }
}

// Adaptador driven: implementa a porta com infra concreta
class RepositorioSQL implements RepositorioPedido {
  async salvar(pedido: Pedido) { /* INSERT ... */ }
}

from typing import Protocol

# Porta de saída (driven)
class RepositorioPedido(Protocol):
    def salvar(self, pedido: "Pedido") -> None: ...

# Domínio depende só da abstração
class ServicoPedido:
    def __init__(self, repo: RepositorioPedido):
        self._repo = repo
    def criar(self, itens: list[str]) -> str:
        pedido = Pedido.novo(itens)
        self._repo.salvar(pedido)
        return pedido.id

# Adaptador driven concreto
class RepositorioSQL:
    def salvar(self, pedido: "Pedido") -> None:
        ...  # INSERT ...

# Em teste, injeta-se um dublê sem tocar no domínio
class RepositorioFake:
    def __init__(self):
        self.itens = []
    def salvar(self, pedido):
        self.itens.append(pedido)