Pular para o conteúdo

Decisões

O que decidi
nos três cases

As decisões de arquitetura dos três cases num lugar só. Filtre por projeto ou estado.

Projeto
Estado

32 decisões

Plataforma de preços

8 decisões

  • Busca no PostgreSQL, sem LuceneImplementada. Descartei Lucene em disco.

    Levei a busca para full-text no PostgreSQL para deixar de manter o índice Lucene em disco fora do banco. Aceitei perder a tolerância a erros de digitação do legado para simplificar a operação da busca.

    Ver no case
  • Ingestão separada da APIImplementada. Descartei ingestão agendada dentro da API.

    Separei a coleta do PNCP em um worker para tirar esse trabalho do processo que atende os usuários. O worker tem agendamento próprio e grava no mesmo PostgreSQL que a API consulta.

    Ver no case
  • Autenticação própriaImplementada. Descartei Keycloak.

    Reaproveitei a autenticação do boilerplate com JWT, Argon2 e Redis para deixar de operar o Keycloak. Isso reduziu as dependências externas, mas deixou a manutenção dos fluxos de autenticação com a API.

    Ver no case
  • Cache Redis por móduloImplementada. Descartei cache desligado.

    Usei o Redis, que já atendia à autenticação, para evitar repetir consultas de listagem no banco. Cada módulo controla suas chaves, o prazo do cache e a invalidação quando altera os dados.

    Ver no case
  • PDF com PDFKit e react-pdfImplementada. Descartei JasperReports.

    Usei PDFKit para gerar PDFs na API Node e react-pdf no frontend, sem manter o JasperReports da aplicação Java. Os layouts passaram a ser mantidos no código TypeScript.

    Ver no case
  • Snapshots imutáveis de cotaçãoImplementada. Descartei cotação ligada apenas aos dados atuais dos itens.

    Copiei os itens para cotacao_item na geração para preservar a cotação mesmo se a origem mudar ou for removida. Para os documentos, que precisam de histórico de versões, usei documento_versao com novos registros a cada finalização.

    Ver no case
  • Dados de mercado em schema separadoImplementada. Descartei tudo no schema public.

    Separei os dados públicos do PNCP no schema licitacoes e mantive os dados das organizações no public. Assim, as tabelas de mercado ficam agrupadas à parte das tabelas que a organização usa para trabalhar.

    Ver no case
  • Monólito modularImplementada. Descartei arquitetura hexagonal com casos de uso por módulo.

    Mantive os módulos com rotas, services e repositories porque, com o time e o prazo que tínhamos, a camada extra de casos de uso não se pagava. Alinhei a documentação à estrutura que o código seguia.

    Ver no case
Ler o case

Atendimento API

18 decisões

  • Banco único com RLSADR-0001, aceita

    Escolhi banco compartilhado para simplificar a operação, com RLS como garantia de isolamento entre empresas. Testei essa separação com dois tenants no PostgreSQL real via Testcontainers.

    Ver no case
  • Empresa vem do token assinadoADR-0002, aceita

    Coloquei a empresa ativa no JWT assinado para usar uma única fonte de contexto nas operações autenticadas do tenant. A troca de empresa valida o vínculo e emite outro token; o webhook resolve a empresa pelo phone_number_id.

    Ver no case
  • Pacotes uniformes com entidades ricasADR-0003, aceita

    Organizei os pacotes por funcionalidade e mantive regras nas entidades JPA para evitar camadas duplicadas no prazo do teste técnico.

    Ver no case
  • Bootstrap do administradorADR-0004, aceita

    Criei a empresa e o vínculo administrativo na mesma transação para evitar um cadastro sem alguém capaz de administrá-lo.

    Ver no case
  • O webhook nunca reabre uma conversaADR-0005, aceita

    Criei uma nova conversa vinculada à anterior para preservar o encerramento feito pelo atendente sem perder a continuidade do histórico.

    Ver no case
  • Outbox com worker agendadoADR-0006, substituída pelo ADR-0011

    No desenho inicial, escolhi outbox no PostgreSQL com worker interno para tornar o processamento posterior durável sem operar um broker. Retirei esse mecanismo do desenho no ADR-0011.

    Ver no case
  • SSE com evento em processoADR-0007, adiada

    Planejei SSE com eventos locais para avisos unidirecionais sem adicionar um broker. A entrega ficou na API HTTP, sem SSE nem listener após commit, porque priorizei isolamento e testes no prazo do teste técnico.

    Ver no case
  • Escopo do administrador da plataformaADR-0008, aceita

    Limitei o administrador da plataforma à gestão de empresas para reduzir seus privilégios sobre conversas e dados dos clientes.

    Ver no case
  • WhatsApp Cloud API oficialADR-0009, adiada

    Escolhi a API oficial para reduzir riscos operacionais e implementei o recebimento do webhook com HMAC, testado só com payloads e assinaturas locais, sem mensagens reais da Meta. O envio pela Graph API ficou fora para priorizar isolamento e testes no prazo do teste técnico.

    Ver no case
  • Uma conta, várias empresasADR-0010, aceita

    Usei uma conta global para manter e-mail único e uma senha, com perfil e status no vínculo de cada empresa. Trocar de empresa reemite o token sem pedir a senha de novo.

    Ver no case
  • Remoção do OutboxADR-0011, aceita

    Retirei o outbox do desenho porque a mensagem já fica persistida e perder um aviso de tela não justificava manter tabela e worker. O aviso após commit que o substituiria ainda não foi implementado.

    Ver no case
  • Desativação de empresaADR-0012, aceita

    Reservei a desativação da empresa à plataforma porque a operação afeta todos os usuários dela. A saída voluntária do vínculo também estava prevista no ADR, mas ficou fora da entrega.

    Ver no case
  • Só a plataforma cria empresasADR-0013, aceita

    Restringi a criação de empresas à plataforma para manter o cadastro de clientes sob controle do operador. Consultar e editar dependem do recurso, e o administrador de uma empresa só mexe na dela.

    Ver no case
  • Autorização por rota e recursoADR-0014, aceita

    Usei o Spring Security para centralizar regras de rota e verificar acesso por recurso com @PreAuthorize e um avaliador em Java, sem criar um mecanismo próprio de autorização.

    Ver no case
  • Sem frontendADR-0015, aceita

    Concentrei o prazo do teste técnico na API, no isolamento e nos testes. A demonstração ficou em Scalar e um roteiro HTTP para os fluxos implementados.

    Ver no case
  • GitFlow enxuto com GHCR e DokployADR-0016, aceita

    Separei QA e produção por branches para organizar a entrega feita sozinho. Os workflows executam testes e lint, publicam imagens no GHCR com tags por commit e acionam o Dokploy.

    Ver no case
  • Modelo de leitura para empresas inativasADR-0017, aceita

    Criei um modelo JPA de leitura para consultar empresas inativas e validar CNPJ sem espalhar SQL nativo nem remover o filtro padrão de empresas ativas.

    Ver no case
  • Consulta entre empresas no loginADR-0018, adiada

    Adiei a consulta entre empresas por usuário para preservar o isolamento na entrega, aceitando percorrer as empresas ativas durante o login. O custo cresce com o total de empresas e ainda não foi medido.

    Ver no case
Ler o case

OPA

6 decisões

  • Uma pasta por seçãoImplementada. Descartei manter as seções no mesmo nível da pasta.

    A landing cresceu com os arquivos no mesmo nível, e ficou difícil encontrar onde mexer. Na refatoração, cada seção ganhou sua pasta, com componentes e dados juntos.

    Ver no case
  • Cache das consultas por cinco minutosImplementada. Descartei consultar a API em toda visita.

    Como os dados são públicos e iguais para todos, deixei a resposta guardada por cinco minutos. Alguns minutos de atraso são aceitáveis para uma vitrine como o observatório.

    Ver no case
  • Hero do observatório renderizado no servidorImplementada. Descartei renderizar o hero inteiro como componente de cliente.

    O texto e a imagem do topo chegam prontos do servidor. Só a animação dos números roda no navegador.

    Ver no case
  • Filtros na URLImplementada. Descartei manter o estado dos filtros só no navegador.

    Com os filtros na URL, um link compartilhado abre o observatório já filtrado, e o servidor monta a lista com esses parâmetros.

    Ver no case
  • Tokens de tipografia e espaçoImplementada. Descartei definir valores soltos em cada componente.

    Com tokens, tamanhos e espaçamentos se mantêm iguais entre as seções e podem ser ajustados em um só lugar.

    Ver no case
  • Acessibilidade na busca, nos filtros e na paginaçãoImplementada. Descartei manter os botões só com ícone e os controles sem rótulos acessíveis.

    O Lighthouse apontou botões sem nome acessível e falta de rótulos nos filtros e na paginação. Corrigi esses pontos para deixar os controles mais claros para quem navega pela interface.

    Ver no case
Ler o case