06 / Artigos técnicos

Artigos & arquitetura

Explorações e notas de arquitetura que esclarecem trade-offs de software, ciclos de vida de estado e fronteiras de módulos para equipes de engenharia.

Visão geral de artigos técnicos

Arquitetura frontend & validaçãoVisão geral verificada

Arquitetura de formulários multi-schema com React Hook Form e Zod

Como estruturar formulários complexos com múltiplas etapas e condicionais usando uniões discriminadas do Zod, isolando o estado do formulário e preservando a inferência completa de tipos entre as fronteiras das etapas.

Principais insights arquiteturais:
  • Uniões discriminadas garantem que a validação em runtime corresponda às condições das etapas
  • Inferência de tipos elimina a duplicação manual de interfaces de formulário
  • Desacoplar o layout do formulário do schema de validação melhora a reusabilidade
Organização de código & manutenibilidadeVisão geral verificada

Organização frontend baseada em módulos para codebases em crescimento

Evolução de diretórios `/components` genéricos para fronteiras de módulos orientadas por funcionalidade, encapsulando estado, UI, contratos de API e testes em estruturas previsíveis.

Principais insights arquiteturais:
  • Pastas escopadas por funcionalidade reduzem o atrito da navegação entre arquivos
  • Exportações da API pública (`index.ts`) ajudam a preservar as fronteiras do módulo
  • Simplifica a refatoração e os testes isolados de componentes com Storybook e Vitest