[{"data":1,"prerenderedAt":451},["ShallowReactive",2],{"post-\u002Fblog\u002Fmonolito-modular-primeiro":3,"post-related-\u002Fblog\u002Fmonolito-modular-primeiro":416,"post-surround-\u002Fblog\u002Fmonolito-modular-primeiro":440},{"id":4,"title":5,"body":6,"category":399,"date":400,"description":401,"draft":402,"extension":403,"featured":402,"meta":404,"navigation":405,"path":406,"readingTime":96,"segment":407,"seo":408,"stem":409,"tags":410,"updated":414,"__hash__":415},"blog\u002Fblog\u002Fmonolito-modular-primeiro.md","Monólito modular primeiro: como estruturo um SaaS do zero sem me arrepender depois",{"type":7,"value":8,"toc":385},"minimark",[9,18,25,30,33,44,50,54,57,62,70,118,122,129,133,148,268,271,275,289,293,296,300,307,311,318,346,349,353,356,367,370,374,381],[10,11,12,13,17],"p",{},"Toda vez que começo um produto do zero, a tentação aparece: \"já vamos fazer em microsserviços, para escalar\". E toda vez a resposta é a mesma: ",[14,15,16],"strong",{},"escalar o quê?"," Um produto novo não tem problema de escala. Tem problema de descobrir se alguém quer usá-lo. A arquitetura certa para essa fase é a que deixa você mudar de ideia rápido.",[10,19,20,21,24],{},"Para mim, essa arquitetura é um ",[14,22,23],{},"monólito modular",": um único deploy, um único banco, mas dividido por domínio com fronteiras claras. Simples de operar hoje, fácil de quebrar amanhã se precisar.",[26,27,29],"h2",{"id":28},"por-que-não-microsserviços-logo-de-cara","Por que não microsserviços logo de cara",[10,31,32],{},"Microsserviços trocam complexidade de código por complexidade de operação. Você ganha deploys independentes e times autônomos, e paga com rede entre serviços, consistência eventual, observabilidade distribuída, versionamento de contratos e uma infraestrutura que exige gente para cuidar.",[10,34,35,36,39,40,43],{},"Esse preço vale quando você tem ",[14,37,38],{},"muitos times"," pisando no mesmo código ou ",[14,41,42],{},"partes do sistema com necessidades de escala muito diferentes",". Num produto com um time pequeno e poucas centenas de usuários, é só custo.",[45,46,47],"note",{},[10,48,49],{},"A pergunta útil não é \"monólito ou microsserviços?\", e sim \"onde estão as fronteiras do meu domínio?\". Se as fronteiras forem boas, extrair um serviço depois é uma tarefa. Se forem ruins, nem microsserviços salvam.",[26,51,53],{"id":52},"as-convenções-que-sustentam-o-monólito","As convenções que sustentam o monólito",[10,55,56],{},"Um monólito só vira novelo quando não tem regras. Estas são as que mais me ajudam, usando NestJS como exemplo (a ideia vale para qualquer stack):",[58,59,61],"h3",{"id":60},"_1-um-módulo-por-domínio","1. Um módulo por domínio",[10,63,64,65,69],{},"Cada domínio de negócio vive na sua pasta, com controller, service, entidades e testes juntos. Não existe pasta ",[66,67,68],"code",{},"services\u002F"," com tudo misturado.",[71,72,77],"pre",{"className":73,"code":74,"language":75,"meta":76,"style":76},"language-bash shiki shiki-themes material-theme-lighter github-light-default github-dark-default","src\u002Fmodules\u002F\n  auth\u002F\n  billing\u002F\n  projects\u002F\n  reports\u002F\n  mail\u002F\n","bash","",[66,78,79,88,94,100,106,112],{"__ignoreMap":76},[80,81,84],"span",{"class":82,"line":83},"line",1,[80,85,87],{"class":86},"seIyd","src\u002Fmodules\u002F\n",[80,89,91],{"class":82,"line":90},2,[80,92,93],{"class":86},"  auth\u002F\n",[80,95,97],{"class":82,"line":96},3,[80,98,99],{"class":86},"  billing\u002F\n",[80,101,103],{"class":82,"line":102},4,[80,104,105],{"class":86},"  projects\u002F\n",[80,107,109],{"class":82,"line":108},5,[80,110,111],{"class":86},"  reports\u002F\n",[80,113,115],{"class":82,"line":114},6,[80,116,117],{"class":86},"  mail\u002F\n",[58,119,121],{"id":120},"_2-módulos-não-são-globais","2. Módulos não são globais",[10,123,124,125,128],{},"Se o módulo de relatórios precisa do módulo de projetos, ele ",[14,126,127],{},"declara o import",". Parece burocracia, mas é o que torna as dependências visíveis. Quando o grafo começa a ficar estranho (todo mundo importando todo mundo), você enxerga antes de virar problema.",[58,130,132],{"id":131},"_3-um-contrato-http-único","3. Um contrato HTTP único",[10,134,135,136,139,140,147],{},"Toda resposta sai no mesmo envelope e todo erro no mesmo formato. Eu uso ",[66,137,138],{},"{ data, meta }"," para sucesso e ",[141,142,146],"a",{"href":143,"rel":144},"https:\u002F\u002Fwww.rfc-editor.org\u002Frfc\u002Frfc9457",[145],"nofollow","Problem Details"," para erro, aplicados globalmente. O controller retorna o dado cru e não se preocupa com formato.",[71,149,154],{"className":150,"code":151,"filename":152,"language":153,"meta":76,"style":76},"language-ts shiki shiki-themes material-theme-lighter github-light-default github-dark-default","@Get(':id')\nasync findOne(@Param('id') id: string, @CurrentBusinessId() businessId: string) {\n  \u002F\u002F Só o dado: o envelope { data, meta } é aplicado por um interceptor global\n  return this.reports.findOne(businessId, id)\n}\n","reports.controller.ts","ts",[66,155,156,183,224,230,263],{"__ignoreMap":76},[80,157,158,162,166,170,174,178,180],{"class":82,"line":83},[80,159,161],{"class":160},"sWneD","@",[80,163,165],{"class":164},"siEnl","Get",[80,167,169],{"class":168},"saDVj","(",[80,171,173],{"class":172},"sX5mu","'",[80,175,177],{"class":176},"sasMN",":id",[80,179,173],{"class":172},[80,181,182],{"class":168},")\n",[80,184,185,188,191,194,197,199,201,204,206,209,212,215,218,221],{"class":82,"line":90},[80,186,187],{"class":168},"async ",[80,189,190],{"class":164},"findOne",[80,192,193],{"class":168},"(@",[80,195,196],{"class":164},"Param",[80,198,169],{"class":168},[80,200,173],{"class":172},[80,202,203],{"class":176},"id",[80,205,173],{"class":172},[80,207,208],{"class":168},") id: string",[80,210,211],{"class":160},",",[80,213,214],{"class":168}," @",[80,216,217],{"class":164},"CurrentBusinessId",[80,219,220],{"class":168},"() businessId: string) ",[80,222,223],{"class":160},"{\n",[80,225,226],{"class":82,"line":96},[80,227,229],{"class":228},"siFmp","  \u002F\u002F Só o dado: o envelope { data, meta } é aplicado por um interceptor global\n",[80,231,232,236,240,243,246,248,250,253,256,258,261],{"class":82,"line":102},[80,233,235],{"class":234},"sqgCv","  return",[80,237,239],{"class":238},"sIfGp"," this",[80,241,242],{"class":160},".",[80,244,245],{"class":168},"reports",[80,247,242],{"class":160},[80,249,190],{"class":164},[80,251,169],{"class":252},"sZ24s",[80,254,255],{"class":168},"businessId",[80,257,211],{"class":160},[80,259,260],{"class":168}," id",[80,262,182],{"class":252},[80,264,265],{"class":82,"line":108},[80,266,267],{"class":160},"}\n",[10,269,270],{},"O front agradece: um único cliente HTTP, um único tratamento de erro.",[58,272,274],{"id":273},"_4-erros-esperados-têm-tipo-e-código","4. Erros esperados têm tipo e código",[10,276,277,280,281,284,285,288],{},[66,278,279],{},"throw new Error('não encontrado')"," vira 500 e esconde a intenção. Erro esperado é uma classe (",[66,282,283],{},"NotFoundError",", ",[66,286,287],{},"BusinessRuleError",") com um código estável, que o front pode traduzir e o suporte pode procurar no log.",[58,290,292],{"id":291},"_5-testes-de-contrato","5. Testes de contrato",[10,294,295],{},"Para cada rota, um teste grava a forma da resposta num arquivo de referência. Mudou o contrato sem querer? O teste falha. Mudou de propósito? Você regrava e revisa o diff do JSON no PR. É barato e pega exatamente o tipo de regressão que quebra o front em silêncio.",[26,297,299],{"id":298},"multi-tenant-desde-o-primeiro-dia","Multi-tenant desde o primeiro dia",[10,301,302,303,306],{},"Se o produto é B2B, uma regra vale ouro: ",[14,304,305],{},"o tenant nunca vem do cliente",". O id da empresa sai do vínculo do usuário autenticado, num decorator, e todo acesso a dado de domínio filtra por ele. Parece óbvio, mas é o tipo de coisa que, se não nasce na fundação, vira auditoria dolorosa depois.",[26,308,310],{"id":309},"documentação-que-vive-junto-do-código","Documentação que vive junto do código",[10,312,313,314,317],{},"Arquitetura que só existe na cabeça de alguém não é arquitetura, é folclore. Mantenho uma pasta ",[66,315,316],{},"docs\u002F"," no repositório com:",[319,320,321,328,334,340],"ul",{},[322,323,324,327],"li",{},[14,325,326],{},"Visão geral da arquitetura"," e as decisões que a sustentam;",[322,329,330,333],{},[14,331,332],{},"Checklists"," (o que toda rota nova precisa ter);",[322,335,336,339],{},[14,337,338],{},"Dívida técnica conhecida",", para ninguém assumir que algo funciona quando não funciona;",[322,341,342,345],{},[14,343,344],{},"Decisões (ADRs)",", curtas, com o contexto de quando foram tomadas.",[10,347,348],{},"Cada doc tem uma data de \"verificado em\". Mudou o comportamento? Atualiza o doc no mesmo commit. É isso que permite que outra pessoa (ou um agente de IA) trabalhe no código sem quebrar as regras.",[26,350,352],{"id":351},"quando-sair-do-monólito","Quando sair do monólito",[10,354,355],{},"Os sinais de que chegou a hora de extrair um serviço são concretos:",[319,357,358,361,364],{},[322,359,360],{},"Um módulo precisa escalar de forma muito diferente do resto (processamento pesado, filas, picos);",[322,362,363],{},"Times diferentes estão constantemente se bloqueando no mesmo deploy;",[322,365,366],{},"Um domínio tem requisitos de isolamento (segurança, compliance) que justificam a separação.",[10,368,369],{},"Se as fronteiras foram respeitadas, extrair esse módulo é mover uma pasta e trocar chamadas de função por chamadas de rede. Se não foram, você descobre que o \"módulo\" conversa com metade do sistema.",[26,371,373],{"id":372},"resumo","Resumo",[10,375,376,377,380],{},"Comece simples, mas com disciplina. Um monólito modular com módulos por domínio, dependências explícitas, contrato único, erros tipados, testes de contrato e documentação viva te dá a velocidade de que um produto novo precisa ",[14,378,379],{},"e"," a estrutura para crescer quando (e se) o produto pedir.",[382,383,384],"style",{},"html pre.shiki code .seIyd, html code.shiki .seIyd{--shiki-light:#E2931D;--shiki-default:#953800;--shiki-dark:#FFA657}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sWneD, html code.shiki .sWneD{--shiki-light:#39ADB5;--shiki-default:#1F2328;--shiki-dark:#E6EDF3}html pre.shiki code .siEnl, html code.shiki .siEnl{--shiki-light:#6182B8;--shiki-default:#8250DF;--shiki-dark:#D2A8FF}html pre.shiki code .saDVj, html code.shiki .saDVj{--shiki-light:#90A4AE;--shiki-default:#1F2328;--shiki-dark:#E6EDF3}html pre.shiki code .sX5mu, html code.shiki .sX5mu{--shiki-light:#39ADB5;--shiki-default:#0A3069;--shiki-dark:#A5D6FF}html pre.shiki code .sasMN, html code.shiki .sasMN{--shiki-light:#91B859;--shiki-default:#0A3069;--shiki-dark:#A5D6FF}html pre.shiki code .siFmp, html code.shiki .siFmp{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#6E7781;--shiki-default-font-style:inherit;--shiki-dark:#8B949E;--shiki-dark-font-style:inherit}html pre.shiki code .sqgCv, html code.shiki .sqgCv{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#CF222E;--shiki-default-font-style:inherit;--shiki-dark:#FF7B72;--shiki-dark-font-style:inherit}html pre.shiki code .sIfGp, html code.shiki .sIfGp{--shiki-light:#39ADB5;--shiki-default:#0550AE;--shiki-dark:#79C0FF}html pre.shiki code .sZ24s, html code.shiki .sZ24s{--shiki-light:#E53935;--shiki-default:#1F2328;--shiki-dark:#E6EDF3}",{"title":76,"searchDepth":96,"depth":96,"links":386},[387,388,395,396,397,398],{"id":28,"depth":90,"text":29},{"id":52,"depth":90,"text":53,"children":389},[390,391,392,393,394],{"id":60,"depth":96,"text":61},{"id":120,"depth":96,"text":121},{"id":131,"depth":96,"text":132},{"id":273,"depth":96,"text":274},{"id":291,"depth":96,"text":292},{"id":298,"depth":90,"text":299},{"id":309,"depth":90,"text":310},{"id":351,"depth":90,"text":352},{"id":372,"depth":90,"text":373},"arquitetura","2026-11-05","Microsserviços resolvem problemas que um produto novo ainda não tem. As convenções que uso para começar com um monólito bem dividido, que aguenta crescer e não vira um novelo.",false,"md",{},true,"\u002Fblog\u002Fmonolito-modular-primeiro","engenharia",{"title":5,"description":401},"blog\u002Fmonolito-modular-primeiro",[399,411,412,413],"nestjs","saas","monolito",null,"5hfIoritGpFfoK3J-JXFnoU-RXCCVV1K8oMojMDsr0g",[417,428],{"title":418,"description":419,"path":420,"date":421,"segment":407,"category":422,"tags":423,"featured":402,"readingTime":96},"Por dentro deste blog: Nuxt 4, Nuxt Content e markdown, tudo estático","Como este site foi construído: coleções tipadas, segmentos e categorias, capas geradas por código, RSS, sitemap e pré-renderização completa. Um guia prático para fazer o seu.","\u002Fblog\u002Fblog-estatico-com-nuxt-content","2026-11-12","frontend",[424,425,426,422,427],"nuxt","nuxt-content","vue","seo",{"title":429,"description":430,"path":431,"date":432,"segment":407,"category":433,"tags":434,"featured":402,"readingTime":102},"IA no produto sem hype: onde um assistente realmente ajuda o usuário","Colocar um chat em toda tela não é estratégia de IA. Um jeito de decidir onde a IA cria valor real no produto, como desenhar a experiência e quais cuidados de privacidade entram desde o começo.","\u002Fblog\u002Fia-no-produto-sem-hype","2026-09-17","ia-aplicada",[435,436,437,438,439],"ia","llm","produto","privacidade","ux",[441,446],{"title":442,"path":443,"stem":444,"description":445,"children":-1},"A jornada completa: por que engenharia, produto, dados e marketing precisam caber na mesma conversa","\u002Fblog\u002Fjornada-completa-de-um-produto","blog\u002Fjornada-completa-de-um-produto","Produto bom nasce quando quatro perguntas são feitas juntas: o que construir, como construir, como saber se deu certo e como chegar a quem precisa.",{"title":447,"path":448,"stem":449,"description":450,"children":-1},"North Star sem vaidade: como escolher a métrica que realmente orienta o produto","\u002Fblog\u002Fnorth-star-sem-vaidade","blog\u002Fnorth-star-sem-vaidade","Usuários cadastrados, pageviews e downloads fazem gráficos bonitos e decisões ruins. Um roteiro para escolher a métrica que importa e montar a árvore que liga o trabalho do time a ela.",1794916777227]