helvecioneto.github.io
Página pessoal e portfólio acadêmico de Helvecio Bezerra Leal Neto — Professor do
Magistério Superior no Instituto de Engenharia e Geociências da Universidade Federal
do Oeste do Pará (UFOPA).
Site estático, sem build, servido pelo GitHub Pages em https://helvecioneto.github.io.
Estrutura
index.html página única, bilíngue (PT-BR / EN)
assets/css/style.css identidade visual institucional
assets/js/content.js CÓPIA DE RESERVA do conteúdo (gerada, não editar à mão)
assets/js/remote.js busca o conteúdo vivo no Supabase
assets/js/app.js renderização, troca de idioma, filtros e formulário
assets/img/ retrato e favicon
admin/ painel de edição (/admin)
scripts/sync-fallback.js regenera a cópia de reserva a partir do banco
supabase/migrations/ schema e carga inicial
Painel de edição
Em https://helvecioneto.github.io/admin/. Entre com helvecio.leal@ufopa.edu.br
e a senha definida no Supabase. O que sai de lá entra no ar na hora: o site lê
o conteúdo direto do banco, sem precisar de commit nem de novo deploy.
O menu do painel segue a mesma ordem das seções da página — Perfil, Formação,
Pesquisa, Publicações, Ensino, Produtos, Contato — para que editar seja procurar
pelo mesmo nome que se vê no site. Dentro de cada seção, os textos e as fichas
daquela parte aparecem juntos, em blocos. Um oitavo item, Geral, reúne o que
não pertence a nenhuma seção: título da aba do navegador, descrição para
buscadores, nomes do menu e rodapé.
A foto do topo é trocada em Perfil (seletor de arquivo; vazia, vale a do
deploy). A seção 08 — Agendamento, com a agenda de compromissos do Google
Calendar incorporada, é editada em Contato: ela e seu item de menu só
aparecem enquanto o link da agenda estiver preenchido.
As contagens dos filtros de publicação são somadas a partir dos registros — não
existem como campo, então nunca ficam dessincronizadas.
Atalhos: Ctrl/Cmd + S salva o registro em foco; a busca filtra a seção aberta;
as setas ▲▼ reordenam. Um registro alterado e ainda não salvo fica marcado em
âmbar, e a página avisa se você tentar sair com pendências.
Como a segurança funciona
A senha nunca é comparada no navegador. Ela é verificada pelo Supabase, e a
autorização vem do banco: as políticas de Row Level Security liberam leitura
para todo mundo (o site é público) e só aceitam escrita de um e-mail cadastrado
na tabela admins. A chave que aparece no código do cliente é a publicável — com
ela sozinha, um visitante lê, mas não altera nem apaga nada.
Para trocar a senha, use Authentication → Users no painel do Supabase. Para
autorizar outra pessoa a editar, insira o e-mail dela em admins e crie o usuário
correspondente — nenhuma dessas duas coisas basta sozinha.
Publicações e citações automáticas
Toda segunda-feira, 06:00 UTC, o workflow .github/workflows/sync-publications.yml
roda scripts/sync-publications.js, que busca trabalhos novos, atualiza as
contagens de citação, regenera a cópia de reserva e faz o commit se algo mudou.
Também dá para disparar à mão em Actions → Sincronizar publicações → Run
workflow, com a opção de simular sem gravar.
O Google Scholar não pode ser lido por robô. Ele não tem API pública e
devolve CAPTCHA a qualquer acesso automatizado — de um IP de datacenter, como o
do GitHub Actions, o bloqueio é ainda mais certo. Em lugar dele:
| Fonte |
Papel |
Custo |
| OpenAlex |
descobre trabalhos novos pelo ORCID e pelos IDs de autor |
grátis, sem chave |
| Semantic Scholar |
contagem de citações, mais alta e mais próxima da do Scholar |
grátis, sem chave |
| SerpApi |
opcional: números do próprio Google Scholar |
pago, 100 buscas/mês no plano grátis |
Para usar os números reais do Scholar, crie uma conta no SerpApi,
pegue a chave e guarde-a como segredo do repositório:
gh secret set SERPAPI_KEY
O script passa a preferi-la; sem ela, segue com Semantic Scholar e OpenAlex. Uma
sincronização semanal gasta cerca de 4 buscas por mês.
Regras que a rotina respeita:
- Publicação já cadastrada só tem as citações atualizadas. Título, veículo e
autores nunca são sobrescritos — podem ter sido corrigidos por você no painel.
- Nada é apagado. Um trabalho que suma do OpenAlex continua no site.
- O que você apaga no painel não volta. Toda exclusão fica registrada em
publications_dismissed, e a rotina não importa de novo o que estiver lá.
- Citação não cai por troca de fonte. Se o Semantic Scholar recusar a
consulta (ele responde 429 com frequência) e o OpenAlex trouxer um número
menor, fica o que já estava no banco.
- O que entra sozinho vem marcado como "importada" na lista do painel, para
se distinguir do que você cadastrou.
O casamento entre um trabalho de fora e um já existente é feito pelo DOI e, na
falta dele, pelo título normalizado — daí não surgirem duplicatas.
O banco manda, e a reserva o acompanha
O banco é a fonte de verdade. A cada visita o site busca o conteúdo vivo no
Supabase e redesenha com ele, então uma edição no painel vale imediatamente.
O que a página desenha antes de o banco responder segue esta ordem:
- O último conteúdo que aquele navegador recebeu do banco, guardado em
localStorage. É o caso normal de quem já visitou o site: a página abre já
com a versão do banco, sem piscar nada.
assets/js/content.js, o retrato embutido no deploy, na primeira visita
daquele navegador ou se a cópia guardada estiver ilegível.
Esse retrato também é a rede de segurança quando o Supabase está fora do ar,
bloqueado por rede corporativa ou pausado por inatividade — o plano gratuito
pausa projetos parados por cerca de uma semana. Nessa situação, quem já conhece o
site continua vendo a última versão do banco, e quem chega pela primeira vez vê o
retrato do deploy, em vez de uma página quebrada.
Para o retrato não envelhecer, .github/workflows/sync-content.yml o regenera de
hora em hora a partir do banco e só commita quando algo mudou. Depois de uma
rodada grande de edições, dá para não esperar: Actions → Sincronizar cópia de
reserva → Run workflow. À mão, o mesmo efeito:
node scripts/sync-fallback.js
git commit -am "Atualiza a cópia de reserva do conteúdo"
Formulário de contato
O formulário usa o Web3Forms — gratuito, sem backend e sem
limite mensal. Já está configurado: a Access Key fica no topo de
assets/js/app.js e as mensagens chegam em helvecio.leal@ufopa.edu.br com o
assunto no formato [Motivo do contato] Nome do remetente.
Motivos de contato disponíveis: Contato Institucional, Busca de Colaboração,
Orientações Acadêmicas, Parcerias Científicas e Outros.
A Access Key é um identificador público, feito para ficar visível no código do
cliente: ela só autoriza o envio para o e-mail já cadastrado e não dá acesso a
nenhuma conta. Para trocá-la, gere outra em https://web3forms.com e substitua o
valor de WEB3FORMS_KEY. Se o valor deixar de ser um UUID válido, o formulário
volta ao modo de reserva: monta um e-mail já preenchido e abre o programa de
e-mail do visitante.
Proteções já incluídas: validação de todos os campos no cliente, campo-armadilha
(honeypot) contra robôs e mensagens de erro traduzidas.
Atualizar o conteúdo
Pelo painel em /admin. As tabelas no Supabase são:
| Tabela |
O que guarda |
site_text |
todo texto da página, com pt e en lado a lado |
publications |
publicações, com autores, veículo, DOI e citações |
research_areas / research_groups |
linhas e grupos de pesquisa (com logo e site) |
courses |
disciplinas, com código, carga horária e tópicos |
software |
produtos, estrelas e links |
education |
linha do tempo da formação |
links |
botões de perfil do topo |
publications_dismissed |
publicações apagadas, que a sincronização não reimporta (invisível para o cliente) |
admins |
quem pode escrever (invisível para o cliente) |
Imagens enviadas pelo painel vão para o bucket media do Supabase Storage:
leitura pública, envio e remoção só para quem está em admins. O limite é 2 MB
por arquivo, em PNG, JPG, WebP, SVG ou GIF.
Ao cadastrar uma publicação, escreva seu nome exatamente como Leal Neto, H. B.
para que apareça em negrito na lista de autores. O campo type aceita journal,
conference, preprint, thesis e dataset — é ele que alimenta os filtros.
Mudanças no banco
Toda mudança de schema ou de dados em lote é uma migração numerada em
supabase/migrations/, aplicada com supabase db push. Antes de qualquer
push, confira supabase migration list e rode supabase db push --dry-run:
002_seed.sql começa com truncate, e reaplicá-lo apaga tudo o que foi editado
pelo painel (foi o que motivou 009_restore.sql).
Desenvolvimento local
python3 -m http.server 8000
# abra http://localhost:8000
Outras páginas do domínio
gp5.html — GP-5 USB-MIDI Tester
trackboard/ — visualização de trajetórias
windy/ — visualização meteorológica
Idioma
A página detecta o idioma do navegador e guarda a escolha em localStorage.
Também aceita ?lang=pt ou ?lang=en na URL.