roscailleFOUNDATION
PT

Guia do site

Um site que podemos
continuar construindo.

Este guia guarda o que aprendemos ao dar forma ao nosso site. Queremos que qualquer pessoa que venha colaborar possa entendê-lo, cuidar dele e seguir construindo conosco. Você não precisa conhecer os termos técnicos: as palavras sublinhadas levam ao nosso dicionário.

Abrir espaço para o novo, cuidar do que já temos

Atualizar é incorporar melhorias sem perder as publicações, imagens e acessos que já fazem parte da roscaille. Primeiro, identifique se está atualizando a instalação existente ou preparando uma nova.

Antes de substituir um arquivo

A raiz da aplicação é a pasta com app.cjs e package.json. Confirme que seja a utilizada pela Spaceship e prepare um backup privado dos arquivos e dados. Guarde também a configuração do cPanel. O LEEME desta versão traz os passos para quem estiver ajudando na instalação.

Quando o site já está funcionando

  1. Pare temporariamente a aplicação no cPanel e execute a ferramenta de backup incluída. Aguarde a confirmação de que a cópia foi concluída.
  2. Preserve data, .env, .htaccess e as variáveis de ambiente. Se ROSCAILLE_DATA_DIR apontar para outra pasta, mantenha os dados dessa pasta.
  3. Para atualizar a partir de Alpha 1.0.0, use o ZIP de atualização, que substitui apenas os arquivos alterados. O ZIP completo permite consolidar a base ou preparar outra instalação. Extraia qualquer um deles na raiz da aplicação, sem criar uma pasta intermediária.
  4. Mantenha Node.js 24, app.cjs como arquivo de inicialização e o domínio HTTPS correto em PUBLIC_ORIGIN. A distribuição já está preparada: não é necessário executar npm install nem compilar para instalar esta entrega.
  5. Reinicie a aplicação. Confira as entradas, imagens e contas existentes; depois abra Candidaturas e o Guia do site.

Quando vamos para outro servidor

Prepare uma aplicação Node.js 24 e uma pasta persistente para os dados. Envie o pacote completo, configure PUBLIC_ORIGIN e inicie com app.cjs. Para levar o site exatamente como está hoje, você também precisa do backup privado da hospedagem. O pacote de código não contém as contas nem as candidaturas atuais.

O que encontramos no pacote

Além de código e recursos, o pacote completo mantém uma cópia pública inicial de 11 de setembro de 2026. Ela só é usada quando não existe uma base de dados. Não devemos substituir os dados atuais por essa cópia. Melhorias feitas diretamente nas imagens enviadas ou nos dados da hospedagem permanecem quando sua pasta de dados é preservada.

Se precisarmos revisar mais uma vez

Podemos voltar ao código anterior usando o backup. Antes de restaurar dados, confira se chegaram candidaturas ou publicações depois daquela cópia: elas também merecem ser preservadas. Corrigir uma instalação não exige começar de novo.

Alpha 1.5.3 · Um novo passo sobre a base de setembro de 2026