Atlas do Aprender
Sistema de formação infantil da alfabetização ao 5º ano: trilhas de Português, Matemática e Ciências, livros paradidáticos, jogos, experimentos mão na massa e diário de aprendizagem.
Criado por Stephanie Kamarry.
Como funciona o acesso
- Todo o conteúdo é público. Qualquer pessoa vê trilhas, livros, jogos, experimentos e o guia, sem conta.
- O login só é pedido para registrar: marcar temas concluídos, marcar livros lidos e usar o diário.
- O login é por link no e-mail (sem senha), feito pelo Supabase.
- Cada pessoa só vê os próprios registros (regras de segurança no banco, em
supabase/schema.sql).
Rodar no computador
Requer Node.js 18.17 ou mais novo.
npm install
cp .env.example .env.local # e preencha com os dados do Supabase
npm run dev # abre em http://localhost:3000
Sem o .env.local, o site funciona só para leitura (sem login nem diário).
Ligar o Supabase (login e diário)
- Crie uma conta gratuita em https://supabase.com e um projeto novo.
- Em SQL Editor, cole o conteúdo de
supabase/schema.sql e clique em Run.
- Em Project Settings > API, copie a Project URL e a chave anon public para o
.env.local:
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
- Em Authentication > URL Configuration:
- Site URL: o endereço do site publicado (ex.:
https://atlasdoaprender.com.br).
- Redirect URLs: acrescente
https://atlasdoaprender.com.br/** e http://localhost:3000/**.
- Opcional: em Authentication > Email Templates, traduza o e-mail do link de acesso para português.
O e-mail padrão do Supabase tem limite baixo de envios por hora. Para muitos usuários, configure um SMTP próprio (Authentication > SMTP Settings), por exemplo com Resend ou Brevo. Consulte o manual completo em CONFIGURACOES_E_SEGURANCA.md.
Vercel Analytics
Já está no código (@vercel/analytics em app/layout.tsx). Para ativar: no projeto na Vercel, abra a aba Analytics e clique em Enable; depois faça um novo deploy. Não usa cookies, por isso funciona sem o aviso de cookies.
Links de afiliado da Amazon
A etiqueta fica em lib/afiliados.ts (AMAZON_TAG). Os botões “Ver na Amazon” aparecem nos livros das trilhas, na aba Livros e nos jogos que são vendidos. Eles abrem uma busca na Amazon com título e autor, para não quebrarem. Para tirar todos os botões, deixe AMAZON_TAG vazio. O aviso obrigatório do programa aparece no rodapé e na página de privacidade.
Google Analytics
- Em https://analytics.google.com, crie uma propriedade GA4 e um fluxo de dados Web com o endereço do site.
- Copie o ID da métrica (começa com
G-).
- Na Vercel, em Settings > Environment Variables, cadastre
NEXT_PUBLIC_GA_ID com esse ID e faça um novo deploy.
O Analytics só é carregado depois que a pessoa clica em Aceitar no aviso de cookies (LGPD). Quem recusa não é rastreado. A política fica em /privacidade, e o rodapé tem o link “Preferências de cookies” para mudar a escolha. Os dados do diário nunca vão para o Analytics.
Publicar na Vercel
- Em https://vercel.com, Add New > Project e importe este repositório do GitHub.
- Em Environment Variables, cadastre:
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEYCRON_SECRET (gerado aleatoriamente para proteger a rota keep-alive)
- Clique em Deploy.
- O Cron diário (
vercel.json) executará automaticamente a cada 24h para impedir a suspensão por inatividade do Supabase gratuito.
- Para usar um domínio próprio: Settings > Domains e siga as instruções de DNS.
- Detalhes completos de segurança e deploy no guia
CONFIGURACOES_E_SEGURANCA.md.
Onde fica cada coisa
| Caminho | O que é |
|---|
data/conteudo.json | Todo o conteúdo: trilhas, livros, jogos, experimentos e estante de formação |
app/trilhas/[materia]/[ano] | Páginas das trilhas (ex.: /trilhas/matematica/3-ano) |
app/livros, app/jogos, app/mao-na-massa | Abas de consulta |
app/diario, app/entrar | Diário e login |
app/api/keep-alive/route.ts | Rota de ping para manter o Supabase ativo |
vercel.json | Agendamento do Cron Job diário da Vercel |
components/Providers.tsx | Sessão, crianças, progresso e diário (Supabase) |
app/globals.css | Cores, tipografia e tema claro/escuro |
public/guia.pdf | Guia de uso em PDF |
components/Analytics.tsx, app/privacidade | Google Analytics com aviso de cookies e página de privacidade |
lib/afiliados.ts, components/Amazon.tsx | Links de afiliado da Amazon |
lib/contato.ts | E-mail, WhatsApp e Instagram para sugestões, mostrados no rodapé (os vazios não aparecem) |
supabase/schema.sql | Tabelas, regras de acesso (RLS) e restrições de integridade do banco |
CONFIGURACOES_E_SEGURANCA.md | Manual de implantação, Vercel, Supabase, SMTP e segurança |
Editar o conteúdo
Em data/conteudo.json, cada tema da trilha tem: t (título), o (objetivo), l (livros: [título, motivo]), m (material), e (exercícios), f (filmes), a (áudio), j (jogos) e p (mão na massa). A chave de progresso de um tema é materia + ano + "-" + posição (ex.: por3-0); mudar a ordem dos temas muda essa chave.
