◆ CHIHUAHUAS STUDIOS
PrivacidadeDados locais
◆ CHIHUAHUAS STUDIOS← ARQUITETURAS
TRILHA DE ARQUITETURA DE SOFTWAREDO OBJETO À ARQUITETURA.

Uma sequência de aprendizado: fundamentos, princípios de design, padrões e decisões de arquitetura. O C4 é uma ferramenta de visualização e fica em uma página separada.

01 / FUNDAMENTOS DE SOFTWARE

ORIENTAÇÃO A OBJETOS.

Comece pelos blocos fundamentais do design: como representar responsabilidades, encapsular estado e construir sistemas que evoluem sem espalhar dependências.

LABORATÓRIO INTERATIVO / POO

UM CONCEITO. DOIS CAMINHOS.

Selecione um fundamento e compare uma solução simples com uma escolha que aumenta o acoplamento ou a duplicação. São exemplos didáticos, não regras absolutas.

FUNDAMENTO 01

Classe e objeto

Classe é o modelo; objetos são instâncias independentes desse modelo.

CLASSE ÚNICAApolicenumero: stringvalor: numberaprovar(): void
OBJETO 01apolice1numero: "001"valor: R$ 1.500
OBJETO 02apolice2numero: "002"valor: R$ 3.200
Uma classe, duas instâncias

A mesma classe define o comportamento de ambos os objetos; cada instância guarda seus próprios dados.

Exemplo aplicado ao DevOps AI Agent

Uma política de aprovação encapsula a decisão. Coletores de evidência implementam um contrato e podem ser trocados sem alterar a política. Isso conecta POO, SOLID, Clean Architecture e DDD.

Próxima etapa: entender por que essas responsabilidades devem permanecer separadas.

02 / PRINCÍPIOS DE DESIGN

SOLID: CINCO PRINCÍPIOS, DEZ CAMINHOS.

Compare a decisão recomendada com uma armadilha concreta. Os diagramas e as consequências mudam ao alternar os botões.

PRINCÍPIO 1 / 5

S · Single Responsibility

Uma classe deve ter um motivo principal para mudar, ligado a uma responsabilidade bem definida.

✓ CAMINHO RECOMENDADO
RESPONSABILIDADE 01PedidoServiceorquestra a compra→ PedidoRepository→ Notificador
RESPONSABILIDADE 02PedidoRepositorysalva no bancomudanças de persistência
RESPONSABILIDADE 03Notificadorenvia confirmaçãomudanças de comunicação
Responsabilidades separadas

Alterar o banco ou o canal de notificação não exige reescrever as regras do pedido.

DESIGN PATTERNS / ARQUITETURAS · LAB

PADRÕES À ARQUITETURA.

Um mesmo case, DevOps AI Agent, em diferentes níveis de zoom. Selecione um padrão para explorar seus componentes e decisões de engenharia.

Exemplos didáticos. As arquiteturas distribuídas e alguns padrões representam possibilidades de evolução, não funcionalidades comprovadamente implantadas.

C3 · COMPONENTES

DESIGN PATTERNS

Strategy · Adapter · Factory · Dependency Injection

GitHub AdapterEvidênciasEvaluatorCaso de usoStrategySite / JogoDecisionPASS / BLOCK
Políticas extensíveis e integrações isoladas

Strategy varia a política; Adapter isola fornecedores; Factory monta dependências e DI facilita testes.

O mesmo motor avalia o deploy do site ou do jogo com políticas diferentes; adaptadores conectam fontes externas.

DECISÕES DE DESIGN

POR QUE IMPORTA

Políticas

Seleciona verificações obrigatórias conforme o alvo.

EXEMPLO TYPESCRIPT · StrategyConceitual · não é código literal do repositório
const policy = target === "site" ? sitePolicy : gamePolicy;
return policy.evaluate(checks);
EXPLORAR DEVOPS AI AGENT ↗

03 / SOFTWARE DESIGN

CLEAN ARCHITECTURE

Exemplo: checkout de uma loja. A regra de pagamento não precisa conhecer o SDK do provedor ou o banco de dados.

✓ BOA ESCOLHA · CAMINHO RECOMENDADO

DOMÍNIO · Pedidocalcula total e valida regras
CASO DE USO · PagarPedidoorquestra pagamento
PORTA · PagamentoGatewaycontrato cobrar(valor)
ADAPTER · PixGatewayintegra provedor externo
Dependências apontam para contratos internos

O caso de uso conhece uma interface; o adaptador concreto depende do contrato interno. Trocar o provedor não exige mudar as regras de negócio.

EXEMPLO RECOMENDADO · TYPESCRIPT
interface PagamentoGateway { cobrar(valor: number): Promise<boolean> }
class PagarPedido {
  constructor(private gateway: PagamentoGateway) {}
  async executar(pedido: Pedido) {
    if (!pedido.podePagar()) return false;
    return this.gateway.cobrar(pedido.total);
  }
}

✕ ARMADILHA · CAMINHO PROBLEMÁTICO

CheckoutControllerrecebe requisição HTTP
PagamentoServiceimporta SDK do provedor
ORM / Bancoconsultado dentro da regra
Provedor externomudança quebra o serviço
Regra de negócio presa à infraestrutura

O caso de uso importa diretamente ORM e SDK. Mudanças tecnológicas e testes de negócio ficam mais difíceis.

EXEMPLO PROBLEMÁTICO · TYPESCRIPT
class PagarPedido {
  async executar(pedidoId: string) {
    const pedido = await prisma.pedido.findUnique({where:{id:pedidoId}});
    return new ProvedorSDK(process.env.API_KEY).cobrar(pedido.total);
  }
}

Exemplos conceituais para estudo; não representam código de um projeto existente.

CONCEITOS ESSENCIAIS

Entities

Regras centrais independentes de HTTP, ORM e frameworks.

Use Cases

Coordenam ações e dependem de contratos.

Interface Adapters

Traduzem dados entre a aplicação e as ferramentas externas.

Dependency Rule

As dependências de código apontam para camadas mais internas.

As caixas mostram a organização conceitual. Chamadas de execução podem ir do caso de uso ao adaptador, mas a dependência de código é invertida por interfaces.

04 / DOMAIN-DRIVEN DESIGN

DDD NA PRÁTICA

Exemplo: loja virtual. O pedido é um agregado que protege regras de confirmação e pagamento; estoque e cobrança têm modelos próprios.

✓ BOA ESCOLHA · CAMINHO RECOMENDADO

CONTEXTO · VendasPedido / ItemPedido
AGREGADO · Pedidoconfirmar() valida itens
VALUE OBJECT · Dinheirovalor e moeda imutáveis
EVENTO · PedidoConfirmadointegra com Estoque
Domínio com regras e limites claros

O agregado protege invariantes; cada bounded context mantém sua linguagem e integra por contratos ou eventos.

EXEMPLO RECOMENDADO · TYPESCRIPT
class Pedido {
  private status = "RASCUNHO";
  constructor(private itens: ItemPedido[]) {}
  confirmar() {
    if (this.itens.length === 0) throw Error("Pedido vazio");
    this.status = "CONFIRMADO";
    return new PedidoConfirmado();
  }
}

✕ ARMADILHA · CAMINHO PROBLEMÁTICO

Tabela global · Pedidousada por todos os times
Controlleraltera status diretamente
Estoque / Financeiroeditam o mesmo registro
Inconsistênciapedido sem itens confirmado
Modelo único compartilhado por todos

Várias partes alteram o estado sem passar pelas regras. Compartilhar entidades entre contextos gera acoplamento e significados conflitantes.

EXEMPLO PROBLEMÁTICO · TYPESCRIPT
// Vários módulos editam o mesmo estado sem passar pelo domínio
await db.pedido.update({
  where: { id },
  data: { status: "CONFIRMADO" }
});
// Nenhuma regra verifica se há itens.

Exemplos conceituais para estudo; não representam código de um projeto existente.

CONCEITOS ESSENCIAIS

Domain

Linguagem e regras do negócio.

Entity

Objeto com identidade, como Pedido.

Value Object

Valor sem identidade, como Dinheiro.

Aggregate

Fronteira de consistência controlada pela raiz.

Repository

Abstração para carregar e persistir agregados.

Bounded Context

Limite onde um modelo tem significado consistente.

Domain Event

Fato ocorrido no negócio, como PedidoConfirmado.

DDD não exige microsserviços. Vendas, Estoque e Financeiro podem começar como módulos de um mesmo monólito.

05 / DISTRIBUTED SYSTEMS

MICROSSERVIÇOS

Exemplo: plataforma de pedidos com necessidades reais de evolução independente em Vendas, Pagamentos e Entregas.

✓ BOA ESCOLHA · CAMINHO RECOMENDADO

PEDIDOSdono dos pedidos
EVENT BUSoutbox / retry / DLQ
PAGAMENTOSdono das cobranças
ENTREGASdono das entregas
Serviços autônomos com comunicação confiável

Cada serviço controla seus dados; eventos, outbox, idempotência e observabilidade ajudam a lidar com falhas distribuídas.

EXEMPLO RECOMENDADO · TYPESCRIPT
// Serviço Pedidos: grava pedido e evento no mesmo commit
await transaction(async tx => {
  await tx.pedidos.save(pedido);
  await tx.outbox.add({ type: "PedidoCriado", id: pedido.id });
});
// Consumidores tratam reentrega com idempotência.

✕ ARMADILHA · CAMINHO PROBLEMÁTICO

API Pedidochama Pagamento síncrono
Pagamentochama Entrega síncrono
Entregaconsulta banco de Pedido
Falha em cascatauma indisponibilidade derruba tudo
Monólito distribuído com dependências frágeis

Chamadas síncronas em cadeia e banco compartilhado eliminam autonomia e ampliam falhas, latência e dificuldade de implantação.

EXEMPLO PROBLEMÁTICO · TYPESCRIPT
// Cadeia síncrona e banco compartilhado
const pagamento = await pagamentoApi.cobrar(pedido);
await entregaApi.criar(pagamento);
await sharedDb.pedidos.update({status:"FINALIZADO"});
// Timeout intermediário: estado incerto.

Exemplos conceituais para estudo; não representam código de um projeto existente.

CONCEITOS ESSENCIAIS

Autonomia

Deploy independente quando a necessidade justifica.

Dados isolados

Cada serviço é dono de seu armazenamento.

Resiliência

Timeouts, retries, circuit breakers e idempotência.

Observabilidade

Logs, métricas e tracing distribuído.

Consistência eventual

Estados podem convergir por eventos e compensações.

Microsserviços têm custo operacional. Para um produto pequeno ou equipe reduzida, um monólito modular costuma ser uma opção inicial melhor.

COMO AS TRÊS SE COMPLEMENTAM

DDDModela as regras e os limites do negócio.
CLEAN ARCHITECTUREOrganiza dependências para proteger as regras.
MICROSSERVIÇOSDistribui partes do sistema quando há necessidade real.
← VOLTAR ÀS ARQUITETURAS