As palavras também podem criar pontes
Você não precisa decorar estes termos. Eles estão aqui para acompanhar você quando uma instrução trouxer uma palavra desconhecida. Abra a definição, leia a explicação e volte ao assunto em que estava.
- HTML
É a linguagem que organiza uma página em títulos, parágrafos, imagens e links. Podemos imaginá-la como a estrutura de uma casa. Na roscaille, o servidor prepara esse conteúdo para o navegador mostrar.
← Voltar a Nosso percurso- CSS
Define a aparência da estrutura: cores, tipografia, espaços e disposição. Ajuda a manter nossa identidade em telas grandes e no celular. Mudar CSS não deve alterar o texto que alguém escreveu em uma publicação.
← Voltar a Nosso percurso- JavaScript
É uma linguagem para dizer a um programa o que fazer. No navegador, abre menus, organiza blocos e envia formulários. Também é usada no servidor, com Node.js, para atender pedidos e preparar páginas.
← Voltar a Nosso percurso- Node.js
É o programa que executa JavaScript no servidor. Nossa aplicação usa Node.js 24 para funcionar, receber formulários e consultar dados. Quem visita o site não precisa instalá-lo.
← Voltar a Nosso percurso- SQLite
É o sistema que guarda nossa base de dados em um arquivo. Entradas, contas e candidaturas ficam ali. Não é editado como um documento de texto: a aplicação consulta e atualiza as informações de forma organizada.
← Voltar a Nosso percurso- Base de dados
É uma coleção organizada das informações que o site precisa lembrar. A nossa usa SQLite. Preservá-la durante uma atualização mantém publicações, acessos e candidaturas anteriores.
← Voltar a Nosso percurso- Navegador
É o aplicativo usado para visitar sites, como Chrome, Safari ou Firefox. Ele mostra o que o servidor envia e permite interagir. Salvar algo apenas no navegador é diferente de guardá-lo no servidor.
← Voltar a Nosso percurso- Servidor
É o computador que mantém nossa aplicação disponível e responde quando alguém abre uma página ou envia um formulário. É diferente do computador de quem visita. A hospedagem oferece esse espaço e seus recursos.
← Voltar a Nosso percurso- Hospedagem
É o serviço onde nosso site fica para que outras pessoas possam acessá-lo. A roscaille usa Spaceship. Oferece espaço para código e dados; configurar um serviço de envio de e-mail é outra tarefa.
← Voltar a Nosso percurso- Spaceship
É o fornecedor escolhido para nosso domínio e hospedagem. Seu painel dá acesso às ferramentas de administração da instalação. As instruções deste guia se referem à nossa aplicação Node.js nesse ambiente.
← Voltar a Nosso percurso- cPanel
É o painel de controle da hospedagem. Nele podemos gerenciar arquivos e a aplicação Node.js. Não é o editor da roscaille: publicações e contas do site são gerenciadas dentro da nossa própria página.
← Voltar a Nosso percurso- Domínio
É o nome usado para encontrar um site na internet. O nosso é roscaillefoundation.lat. O domínio dá o endereço; a hospedagem guarda e executa o site.
← Voltar a Nosso percurso- URL
É o endereço completo de uma página ou recurso. Pode incluir domínio e caminho, como /blog/, ou indicar uma parte da página com um trecho que começa por #. É o que copiamos ao compartilhar um link.
← Voltar a Nosso percurso- HTTPS
Indica que a conexão entre navegador e site é criptografada. Isso importa ao entrar em uma conta ou enviar dados pessoais. Funciona junto com senhas e permissões, sem substituí-las.
← Voltar a Nosso percurso- Raiz da aplicação
É a pasta principal da instalação, com app.cjs, package.json e as demais pastas do site. Extrair um ZIP na raiz significa colocar os arquivos ali, sem uma pasta adicional por cima.
← Voltar a Nosso percurso- app.cjs
É o arquivo de inicialização da aplicação, a porta pela qual a hospedagem a coloca em funcionamento. O nome deve permanecer exatamente assim na configuração, mesmo quando o ZIP de entrega muda de nome.
← Voltar a Nosso percurso- Variáveis de ambiente
São configurações que indicam onde a aplicação funciona e quais serviços pode usar. PUBLIC_ORIGIN informa o domínio; ROSCAILLE_DATA_DIR informa a pasta de dados. Algumas podem conter chaves privadas e não devem aparecer em páginas públicas.
← Voltar a Nosso percurso- PUBLIC_ORIGIN
É a configuração com o endereço público principal, por exemplo https://roscaillefoundation.lat. Ajuda a montar links corretos e reconhecer pedidos da própria página. Deve corresponder ao domínio em uso.
← Voltar a Nosso percurso- ROSCAILLE_DATA_DIR
É a configuração que aponta para os dados privados da instalação. Quando definida, usa essa pasta no lugar da pasta data habitual. Preservar o caminho correto na atualização evita que o site pareça vazio.
← Voltar a Nosso percurso- Backup
É uma cópia que permite recuperar a instalação se algo falhar. Na roscaille, deve incluir código, base de dados, imagens enviadas e configuração. Pode conter dados pessoais e chaves, por isso fica fora das pastas públicas.
← Voltar a Nosso percurso- ZIP
É um arquivo que reúne outros arquivos e pastas, normalmente ocupando menos espaço. É preciso extrair o conteúdo para instalar. O pacote completo traz a aplicação; o de atualização contém apenas os arquivos alterados em relação à base indicada.
← Voltar a Nosso percurso- CSV
É um formato simples para abrir dados em uma planilha. Cada linha corresponde a um registro e cada coluna a um campo. A exportação de candidaturas inclui respostas e datas sem alterar nem excluir os dados do site.
← Voltar a Nosso percurso- API
É uma forma organizada de comunicação entre programas. Nosso site pode pedir uma tradução pela API do Google. A integração pode exigir uma chave e uma conta no serviço; é diferente de abrir uma página por um link.
← Voltar a Nosso percurso- Cloud Translation API Basic v2
É o serviço do Google que podemos conectar para gerar traduções dentro do site. Exige configuração e faturamento no Google Cloud. Sem ele, a página ainda pode oferecer o link externo do Google Translate.
← Voltar a Nosso percurso- Google Translate
É o tradutor do Google. Nosso botão abre a publicação ali e indica os idiomas de origem e destino quando conhecidos. A leitura acontece em um serviço externo e não substitui o original salvo na roscaille.
← Voltar a Nosso percurso- Zulip
É a plataforma de conversa que apoia nossa comunidade. Canais e assuntos ajudam a compartilhar o que criamos e organizar equipes. O link da roscaille abre nosso espaço ali; não é a base de dados nem o painel de administração do site.
← Voltar a Nosso percurso- Owner
É o papel da pessoa responsável por toda a instalação. Pode administrar outras contas e consultar candidaturas. Um manager não pode alterar nem excluir essa conta. É uma permissão atribuída a um usuário, não uma senha compartilhada.
← Voltar a Nosso percurso- Manager
É uma permissão de administração para o trabalho cotidiano. Permite gerenciar publicações e outras contas e consultar candidaturas, mantendo protegida a conta owner. Deve ser atribuída a quem precisa dessas responsabilidades.
← Voltar a Nosso percurso- Sessão
É o acesso temporário aberto depois de entrar com usuário e senha. Permite passar entre ferramentas sem repetir as credenciais. Sair encerra o acesso naquele navegador; desativar uma conta invalida suas sessões.
← Voltar a Nosso percurso- Editor por blocos
É o espaço em que organizamos uma publicação em partes, como parágrafos e imagens. Podemos mover blocos, formatar o texto e revisar o resultado. É diferente da permissão Editor, que define quem pode alterar entradas de outras pessoas.
← Voltar a Nosso percurso- Cache
É uma cópia temporária que ajuda a carregar conteúdo sem pedir tudo novamente. Às vezes mantém um recurso antigo, e atualizar ajuda a conferir uma mudança. Cache não substitui backup; páginas privadas de candidaturas orientam o navegador a não armazená-las.
← Voltar a Nosso percurso- SEO
É o conjunto de cuidados que ajuda buscadores a entender o site e mostrá-lo quando relevante, incluindo títulos, descrições e endereços claros. Não garante uma posição no Google nem mudanças imediatas nos resultados.
← Voltar a Nosso percurso- Metadados
São informações que descrevem uma página, como título e descrição para buscadores ou links compartilhados. Nem sempre aparecem no texto principal. Nelas mantemos roscaille foundation em minúsculas.
← Voltar a Nosso percurso- Sitemap
É uma lista de endereços públicos que ajuda buscadores a percorrer o site. Não é o mapa de La Estrella nem o menu de navegação. Ferramentas privadas de administração não devem aparecer ali como conteúdo público.
← Voltar a Nosso percurso- Compilar
É o processo de preparar arquivos de trabalho para a aplicação executar. Neste projeto, npm run build gera dist a partir de src e public. O pacote já inclui essa distribuição, sem exigir compilação na instalação.
← Voltar a Nosso percurso- Alpha
É o nome da base a partir da qual seguimos melhorando o site. O número identifica uma entrega. Alpha 1.1.0 continua Alpha 1.0.0 com candidaturas e este guia ampliado; não significa apagar a instalação anterior.
← Voltar a Nosso percurso- Terminal
É uma ferramenta para escrever instruções para o servidor. Quem instala pode executar npm run activate ali. Não é preciso usá-la para publicar ou consultar candidaturas: essas tarefas têm suas próprias telas no site.
← Voltar a Nosso percurso- npm
É uma ferramenta que acompanha Node.js e executa tarefas por nomes curtos. Nesta aplicação, npm run activate prepara o primeiro acesso, npm run backup faz uma cópia e npm run build prepara a distribuição. Execute na raiz da aplicação.
← Voltar a Nosso percurso- .env
É um arquivo opcional de configuração privada. Pode guardar variáveis de ambiente lidas ao iniciar. Preserve o existente na hospedagem durante atualizações. Não o publique nem inclua chaves reais no ZIP de distribuição.
← Voltar a Nosso percurso- .htaccess
É um arquivo de configuração que a hospedagem pode usar para direcionar visitas à aplicação. Não é uma página visível. Preserve o arquivo que já funciona na Spaceship para não alterar o acesso ao domínio.
← Voltar a Nosso percurso
Alpha 1.5.3 · Um novo passo sobre a base de setembro de 2026