Como o site é feito
Um site feito a quatro mãos
O joinet.org foi construído, e é mantido, com um método que combina ferramentas tradicionais de desenvolvimento de software com um assistente de inteligência artificial.
A IA não substitui a engenharia: trabalha dentro dela, sob as mesmas regras de código, teste e documentação que um projeto profissional seguiria. Toda mudança é proposta e explicada pela IA, e só é executada com a aprovação explícita do responsável pelo site.
A base tradicional
O alicerce é um conjunto de tecnologias consolidadas, escolhidas por serem simples de manter por uma pessoa só:
-
Python e Django — a linguagem e o framework que montam as páginas e a área de administração.
-
PostgreSQL — o banco de dados onde ficam artigos, páginas e o contador de leituras.
-
HTML, CSS e JavaScript simples — o visual em tema escuro, sem bibliotecas pesadas.
-
Git e GitHub — o histórico de cada alteração, guardado num repositório privado.
-
Railway — a hospedagem: cada nova versão enviada ao GitHub entra no ar sozinha.
-
Amazon Web Services — o domínio joinet.org e o armazenamento das imagens de capa.
Onde entra a IA
O código é escrito com o Claude Code, assistente de programação da Anthropic, que roda dentro do editor VS Code. Ele escreve código, gera testes automáticos e documentação, mas não trabalha de improviso: lê primeiro um arquivo de instruções do próprio projeto, que registra o estado do site, as convenções de escrita do código e a regra de aprovação. Funciona como a memória de longo prazo do projeto.
Adicionalmente são mantidos:
-
Registro de decisões — cada escolha técnica relevante (ex: por que esta hospedagem, por que este formato de página) é escrita com o contexto, as alternativas e as consequências, para que a decisão não seja refeita por esquecimento.
-
Testes automáticos — cerca de duzentos testes são rodados a cada mudança, confirmando o que já funcionava e o que continua funcionando.
-
Documentação viva — arquitetura, banco de dados e roteiro de publicação são atualizados na mesma etapa em que o código muda.
Duas IAs, dois papéis
Os artigos não são escritos aqui. Eles nascem em outro ambiente, o Claude.ai, num projeto com regras editoriais próprias (veja Como os artigos são produzidos). O site apenas publica. A ponte entre os dois é automática:
-
O artigo aprovado é gravado numa pasta do computador do editor.
-
Um vigia do sistema operacional percebe a gravação.
-
Um pequeno programa compara o que mudou e envia ao site só os artigos novos ou alterados, por um canal protegido por senha.
-
O site confere, grava e publica — em segundos, sem ação manual.
Já as páginas institucionais, como esta, são arquivos de texto guardados junto com o código e entram no ar a cada nova versão do site.
O que esse arranjo garante
-
Controle humano — nada vai ao ar, nem código nem conteúdo, sem aprovação.
-
Rastreabilidade — cada alteração fica no histórico do Git, e cada decisão tem registro escrito.
-
Simplicidade — primeiro o essencial; recursos avançados esperam a vez, e nenhuma dependência entra sem necessidade.
-
Resiliência — produção editorial e site são independentes. Se o site sair do ar, nada se perde: o vigia reenvia na rodada seguinte.
-
Privacidade — o contador de leituras é próprio do site e não usa cookies nem guarda o endereço de quem visita.