Plataforma educacional · BNCC

Ensino fundamental interativo, do 6º ao 9º ano

Currículo BNCC completo com conteúdo HTML ilustrado em SVG, exercícios e quizzes, gamificação, painel do professor, painel admin e tutor IA com Claude.

# rodar localmente
pnpm install
pnpm dev
# abre em http://localhost:3000
O que é

Uma plataforma de aprendizado online completa

O INEMA Academia cobre as seis áreas do conhecimento da BNCC do 6º ao 9º ano, mais cursos extracurriculares importados do INEMA Club. Conteúdo rico, gamificação e painéis separados pra aluno, professor e admin.

🎓 Currículo BNCC

Matemática, Ciências, História, Geografia, Português e Inglês do 6º ao 9º ano, em hierarquia Matéria → Curso → Unidade → Lição, com ~154 lições com conteúdo.

🎓 Gamificação

Badges, ranking, XP e conquistas; estatísticas do aluno (streak, lições completas) pra manter o engajamento.

🎓 Tutor IA + PWA

Tutor inteligente com a API da Anthropic (Claude) pra tirar dúvidas, e PWA com suporte offline e notificações push.

Como funciona

Três papéis, uma plataforma

Aluno estuda e acumula progresso; professor cria turmas, atribui tarefas e vê relatórios; admin gerencia todo o conteúdo. A navegação de conteúdo segue a hierarquia da BNCC.

Matéria Curso Unidade Lição (artigo · vídeo · exercício · quiz) Progresso + badges

Aluno

Dashboard, matérias, lições, progresso, badges, ranking, tarefas, tutor IA e perfil.

Professor

Tudo do aluno + turmas, relatórios, atribuir tarefas e acompanhar os alunos.

Admin

Tudo + painel admin (CRUD de matérias, cursos, unidades, lições e exercícios).

Pré-requisitos

O que preparar antes do setup

O projeto é Next.js 15 + TypeScript + Supabase. Você precisa de Node 20+, pnpm e um projeto Supabase criado. A API da Anthropic é opcional (só pro tutor IA).

Node 20+ e pnpm

Clone o repositório e instale as dependências com pnpm.

git clone https://github.com/inematds/inemaacademia.git
cd inemaacademia
pnpm install

Variáveis de ambiente

Copie o exemplo e preencha com as credenciais do Supabase (e a chave Anthropic, se quiser o tutor).

cp .env.example .env.local
# NEXT_PUBLIC_SUPABASE_URL=
# NEXT_PUBLIC_SUPABASE_ANON_KEY=
# ANTHROPIC_API_KEY= (opcional)

Banco Supabase

Execute as migrações e seeds no SQL Editor do Supabase, na ordem indicada no README.

# no SQL Editor, em ordem
src/db/migrations/0001_schema.sql
sql/seed-materias.sql
Guia de uso · passo a passo

Do clone ao app rodando

Comandos reais do package.json. Depois do setup do banco, você sobe o app, popula o conteúdo e roda os testes quando precisar.

1

Instalar e configurar

Instale as dependências e preencha o .env.local com as credenciais do Supabase.

pnpm install
cp .env.example .env.local  # preencha as chaves
2

Aplicar migrações e seeds

Rode o schema e as policies de RLS no Supabase, depois os seeds de matérias e currículo.

# SQL Editor do Supabase, em ordem:
0001_schema.sql
0002_auth_trigger_and_rls.sql
seed-materias.sql
3

Subir o app em dev

Inicia o servidor Next em modo desenvolvimento.

pnpm dev  # http://localhost:3000
4

Popular conteúdo rico (opcional)

Scripts TS populam 7º–9º ano e os cursos extracurriculares do INEMA Club.

pnpm tsx seed-7-8-9ano.ts
pnpm tsx apply-extracurricular-seed.ts
5

Testar e fazer build

Rode os testes unitários (Vitest), os E2E (Playwright) e gere o build de produção.

pnpm test        # Vitest
pnpm test:e2e    # Playwright
pnpm build       # build de produção
Exemplos

O que cada papel faz na prática

A plataforma já tem ~60 unidades e ~154 lições com conteúdo, divididas entre o currículo BNCC e os cursos extracurriculares.

Aluno estuda uma lição

Em /licao/[id], lê o artigo HTML ilustrado com SVG, assiste ao vídeo, faz o exercício e o quiz — e ganha XP e badges no caminho.

Professor monta uma turma

Cria turmas, adiciona alunos, atribui tarefas e acompanha relatórios de progresso por aluno e por curso.

Admin edita o currículo

No painel admin faz CRUD de matérias, cursos, unidades e lições, ajustando o conteúdo da BNCC.

Tutor IA tira dúvidas

O endpoint /api/ai/chat conversa com Claude pra explicar conceitos e responder perguntas do aluno em tempo real.

Roadmap

Estado e próximos passos

A plataforma está em produção em inemaacademia.vercel.app. O conteúdo de 7º–9º ano e extracurricular já está rico em HTML+SVG; o 6º ano ainda tem só a estrutura.

Pronto
Plataforma + currículo ricoBNCC 7º–9º ano e extracurriculares com HTML+SVG, gamificação, três painéis, tutor IA e PWA, no ar na Vercel.
Em curso
Conteúdo do 6º ano6º ano tem ~15 unidades e 48 lições estruturadas; falta preencher o article_body com conteúdo rico.
Próximo
Mais avaliações e relatóriosAmpliar avaliações/provas e os relatórios do professor sobre o progresso das turmas.