joinet.org

Como o site é feito

Atualizada em 16 de novembro de 2026

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:

  1. O artigo aprovado é gravado numa pasta do computador do editor.

  2. Um vigia do sistema operacional percebe a gravação.

  3. Um pequeno programa compara o que mudou e envia ao site só os artigos novos ou alterados, por um canal protegido por senha.

  4. 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.