Arquitetura e decisões

BeyondtheCode

Depois deste livro, você vai Parar de culpar
o framework — e começar a ver o que realmente está quebrando o sistema.

Explorar capítulos
ArquiteturaSistemas frontendTomada de decisãoTrade-offsDívida técnicaSenioridadeExemplos de códigoPlanilha de decisão

O insight central

O problema
não é técnico

Quando um sistema frontend fica difícil de evoluir, todos apontam para o framework. Mas frameworks não tomam decisões — oferecem abstrações.

A maioria dos problemas sérios vem de decisões feitas sem critérios explícitos — decisões com custos invisíveis, que só aparecem quando alguém tenta mudar algo.

Insight central · Frameworks não decidem
Trocar de framework muda a superfície do problema. A novidade traz alívio temporário. Mas a estrutura decisória permanece. As mesmas escolhas implícitas continuam sendo feitas — só que com outra sintaxe.

O e-book inclui 3 exemplos reais em TypeScript — abordagem errada vs. decisão estrutural consciente, com trade-offs documentados.

O que você vai aprender

10 capítulos +
Caso bônus

Cada capítulo constrói sobre o anterior — da mudança de mentalidade a uma ferramenta prática que você pode usar no time hoje.

O problema não é técnico
O problema não é técnico. É decisório.
Frontend também é um sistema
Ignorar a natureza sistêmica não reduz complexidade — só a esconde.
Decisões estruturais
Nem todas as decisões têm o mesmo peso.
O custo do tempo
Quando decisões viram restrições.
Trade-offs
O que você ganha e o que você perde.
O framework de decisão
Um jeito estruturado de decidir — as 5 Lentes.
Camadas e responsabilidades
Onde cada decisão pertence.
Arquitetura como contrato social
Arquitetura como acordo compartilhado do time.
Senioridade e julgamento
O que realmente define senioridade.
O que permanece quando o framework muda
O que fica quando a tecnologia muda.
No PDF
Bônus — caso real
340 tickets de suporte. Uma decisão sem dono. Uma história real com custo real.
No PDF
Planilha de decisão
As 5 Lentes na prática — uma ferramenta com pontuação para decisões reais.

O framework de decisão

As cinco
lentes

Sem um modelo explícito, decisões de arquitetura seguem intuição, preferência ou urgência. As 5 Lentes criam critérios compartilhados — para pessoas diferentes, em momentos diferentes, avaliarem escolhas parecidas com referências comparáveis.

Princípio
As lentes não existem para chegar a uma única resposta. Elas existem para criar tensão produtiva — e deixar o conflito visível.
5–7
Baixo risco
8–11
Moderado
12–15
Alto risco

Pontue suas decisões antes de comprometer — não depois

Acoplamento
Evolução no tempo
Pessoas e escala do time
Testabilidade
Independência de tecnologia

Capítulo bônus

A regra que
ninguém tinha dono

Um time de e-commerce médio. Uma regra de elegibilidade no checkout. Ninguém tinha dito onde ela deveria morar.

8%
Usuários afetados
340
Tickets de suporte
11
Dias em produção

Como uma única decisão sem dono virou 4 dias de engenharia — com linha do tempo completa e análise pelas 5 Lentes no e-book.

Princípio
O risco real não é errar. É errar sem saber por quê — para não poder defender, reverter ou aprender.

Tudo no livro

O que tem dentro

3 exemplos de código em camadas
Exemplos reais em TypeScript mostrando a abordagem errada vs. a decisão estrutural consciente — com impacto de negócio documentado.
A planilha de decisão
Uma ferramenta de pontuação para as 5 Lentes — use em revisões de time antes de comprometer decisões estruturais.
Arquitetura temporal
Como reconhecer inflexões arquiteturais antes de cruzá-las — e quais sinais observar.
Arquitetura como contrato social
Como a arquitetura cria linguagem compartilhada — e o que acontece com times quando o acordo nunca foi estabelecido.
Senioridade redefinida
Por que senioridade não é um nível — é uma forma de lidar com incerteza. As três dimensões que importam sob pressão.
Perguntas de reflexão
Cada capítulo termina com exercícios para revelar decisões invisíveis no seu código hoje.

"Frameworks passam.
Decisões permanecem.
E tudo que realmente importa em arquitetura começa beyond the code."

— Rodrigo Paixao, Frontend Society

Frontend Society · E-book grátis

Pare de culpar
o framework

35 páginas. 10 capítulos. 3 exemplos de código. 1 caso real. Uma planilha de decisão para usar no seu time hoje. Grátis.

Seguir @frontendsociety
35 páginasArquitetura e decisõesExemplos reais de códigoPlanilha para imprimir