5 pilares do software em produção:o framework para a IA

Os 5 pilares do software em produção separam o código que corre do software que funciona e dos produtos que escalam: arquitetura e base de dados, design de sistemas, segurança e confiança, pensamento de produto e saber trabalhar com a própria IA. A IA escreve o código em segundos. Os pilares são os vinte anos de critério que ela não consegue fornecer — condensados para que um fundador não técnico os possa aplicar desde o primeiro dia.

Este é o framework que está por baixo de tudo o que ensino sobre construir com IA. A IA consegue gerar milhares de linhas de código, mas não consegue perceber as consequências de negócio das decisões de arquitetura, prever como a dívida técnica se acumula, saber quando quebrar as suas próprias regras, pensar em casos-limite que ninguém descreveu ou equilibrar velocidade e correção em contexto. O código é gratuito. É isto que precisas mesmo de saber.

Pilar 1: arquitetura e base de dados

A fundação — erra aqui e tudo o resto é construído sobre areia. As regras centrais: mantém os teus dados organizados para que nada fique guardado duas vezes (mantém-te acima de 90% de normalização e desnormaliza de propósito, nunca por acidente). Põe uma coluna de organização em todas as tabelas desde o primeiro dia — acrescentar multi-tenancy mais tarde significa mexer em todas as tabelas; pergunta-me como sei. Ativa a segurança ao nível da linha, para que a própria base de dados se recuse a mostrar a um cliente os dados de outro, mesmo quando o teu código tem bugs. Nunca apagues nada de verdade — marca como apagado, para que os utilizadores possam anular. Regista quem criou e alterou cada registo. Indexa tudo o que consultas, porque a tua app é rápida com 100 registos e inutilizável com 100.000 sem índices.

Cada uma destas regras é invisível numa demonstração e existencial em produção. E a IA salta praticamente todas, a menos que as peças explicitamente.

Pilar 2: design de sistemas e escalabilidade

A forma como o teu código está organizado determina a velocidade a que consegues avançar. A espinha dorsal é a separação de responsabilidades: o ecrã fala com um hook, o hook fala com um serviço, só o serviço fala com a base de dados — nunca saltes camadas (dediquei um artigo inteiro a este padrão de 3 camadas). À volta dessa espinha: cada ecrã trata os estados de carregamento, de erro e vazio, não só o de sucesso; tudo o que é lento corre em segundo plano em vez de pôr os utilizadores à espera; os dados carregam em páginas de 20 a 50 itens em vez de todos de uma vez; os resultados que raramente mudam ficam em cache; e as operações comportam-se da mesma forma quer o utilizador clique uma vez quer, impaciente, cinco.

Nada disto é exótico. É a diferença entre uma app que impressiona numa gravação de ecrã e uma app que sobrevive ao seu centésimo cliente.

12 semanasA tua carreira corporativa nunca foi o planoCandidata-te ao Solopreneur Accelerator.Candidatar-me →

Pilar 3: segurança e confiança

Os utilizadores confiam-te os seus dados; o terceiro pilar é não quebrar essa confiança. A autenticação responde a quem alguém é — a autorização responde ao que pode fazer, e não são a mesma verificação. A defesa funciona em camadas: a base de dados aplica a segurança ao nível da linha, o serviço verifica as permissões de negócio, a API valida cada pedido e a interface esconde o que o utilizador não pode tocar — assim, quando uma camada falha, as outras aguentam. Cada dado introduzido pelo utilizador é validado antes de ser usado. Cada segredo vive na configuração, nunca no código. E o que o utilizador introduz nunca é colado diretamente em consultas à base de dados, que é a forma como os atacantes te apagam as tabelas.

É aqui que a IA é mais perigosa, porque o código inseguro parece idêntico ao código seguro quando corre. Funciona, faz boa figura na demonstração, e deixa escapar dados.

Pilar 4: pensamento de produto

O código funciona; os produtos são lançados. O quarto pilar é tudo o que os utilizadores sentem: as funcionalidades importantes ficam atrás de flags que podes desligar sem novo deploy, para que um lançamento avariado seja um interruptor e não uma emergência. Quando um serviço de terceiros vai abaixo, a funcionalidade degrada-se com elegância em vez de deitar a app inteira abaixo. Cada ação do utilizador tem resposta — um indicador de carregamento, uma confirmação, um erro com opção de tentar outra vez. E quando a velocidade e a correção entram em conflito, a correção ganha: rápido mas errado é pior do que lento mas certo, porque dados corrompidos são o único bug que não consegues corrigir com um remendo.

O hábito que alimenta este pilar é uma pergunta: e se? E se este registo tiver filhos? E se dois utilizadores o apagarem ao mesmo tempo? E se o pagamento tiver sucesso mas a confirmação falhar? Os casos-limite são onde os bugs se escondem, e a IA não os vai caçar por ti.

Pilar 5: trabalhar com a IA

A meta-competência: a IA é a ferramenta, tu és o artesão. Cinco disciplinas. Verifica tudo — a IA engana-se com toda a regularidade em segurança, casos-limite e desempenho, e soa confiante de qualquer maneira. Gere o contexto — dá-lhe as tuas regras de arquitetura e um ou dois exemplos, não a tua base de código inteira. Sê específico — dois minutos a escrever um prompt preciso poupam vinte minutos a corrigir um vago, e os prompts estruturados são exatamente o que o método PRP sistematiza. Valida em ciclos — verificações de tipos, testes e depois testes manuais, antes de qualquer commit. Constrói de forma incremental — primeiro a versão mais pequena que funciona, depois melhora, para teres sempre uma app a funcionar.

E quando a IA propõe algo que viola as tuas regras: contesta. O arquiteto és tu; a IA é o construtor — essa divisão de papéis é o jogo todo. Luta pela arquitetura, pela segurança e pela integridade dos dados. Larga as preferências de nomes e os pormenores de estilo. A direção é tua; a execução é dela.

Os 5 pilares do software em produção num relance

Este framework não é teórico. É assim que uma plataforma inteira foi construída por uma pessoa com IA — e é por isso que o resumo honesto de toda a abordagem cabe numa frase: tu dás a direção, a IA dá a execução. O código é gratuito. Os pilares são o que o deixa pronto para produção. Foi assim que uma plataforma de 2 milhões de euros foi construída por 3.250 €.

O livroThe Solopreneur RevolutionLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem deixar o emprego.Quero o livro →

Perguntas frequentes

Preciso de dominar os cinco pilares antes de construir o que quer que seja?

Não. Começa a construir de imediato, mas aplica o pilar 1 desde o primeiro prompt — as decisões de base de dados (coluna de organização, segurança ao nível da linha, eliminação lógica) são as que custam horrores a acrescentar depois. Os outros pilares podem ser introduzidos funcionalidade a funcionalidade, à medida que avanças.

Isto não é só engenharia de software — porquê enquadrá-lo para a IA?

É engenharia de software, destilada naquilo que mudou. Antes da IA, estes princípios eram-te inúteis sem os anos necessários para escrever o código. Agora o código é gratuito, por isso os princípios são o trabalho todo — e, ao contrário da sintaxe, o critério não leva vinte anos a aplicar quando alguém te entrega a lista de verificação.

Como faço a IA seguir os pilares sem os repetir em cada prompt?

Põe-nos num ficheiro de instruções permanentes que a tua ferramenta de IA lê em cada sessão, e refere-os quando revês o resultado. As correções mais comuns — todas as tabelas têm coluna de organização, todos os componentes tratam os quatro estados, nada de eliminações definitivas — tornam-se regras escritas uma vez. O artigo sobre os dez principais erros da IA em produção tem o bloco de regras pronto a usar.

Em que pilar é que os principiantes mais erram?

No pilar 5 — confiam no resultado da IA porque corre. Código que corre é a fasquia mais baixa que existe; a demonstração esconde tudo aquilo que os outros quatro pilares existem para apanhar. Os fundadores que têm sucesso leem o que a IA gera, perguntam "o que pode correr mal aqui?" e verificam antes de lançar. Confia, mas verifica.