DL-classes

Material de estudo gerado a partir das aulas gravadas da pós em Deep Learning.

Cada aula vira uma página com resumo, conceitos, avisos de entrega, flashcards de recuperação ativa e um podcast. O objetivo é substituir a revisão da gravação: 4h07 de aula em 20 minutos de leitura ou 12 de áudio.

Os vídeos originais nunca entram no repositório — só a transcrição e o material.

Abrir o material

git clone https://github.com/Warpedro1/DL-classes.git

Abra site/index.html no navegador. Não precisa de servidor, build ou dependência: os dados vêm em dados.js via <script>, justamente para funcionar em file://.

Estrutura

O repositório atende várias cadeiras, cada uma com várias aulas. A unidade é a aula: uma página, um podcast. Se a gravação veio partida em seis .mkv, isso é detalhe de armazenamento e não aparece na navegação.

Cadeiras/Eng-SW-AI/Aula1/ entrada: transcricao.txt (versionada) + os .mkv (ignorados)
estudo/Eng-SW-AI/
  index.html              índice das aulas da cadeira
  aula-01/
    index.html            a página da aula
    dados.js              todo o material
    podcast.mp3           o episódio da aula
site/
  cadeiras.js             o registro — cadeiras e aulas
  indices.js              gera os índices a partir do registro
  app.js, estilos.css     a página de aula
scripts/                  fatiamento, geração de podcast e teste de fumaça
.claude/                  a skill e os comandos que mantêm o padrão entre aulas

Cadeiras:

Slug	Cadeira
Eng-SW-AI	Engenharia de Software para IA
Mat-Cien-Dados	Matemática para Ciência de Dados

O slug é o nome da pasta. O nome por extenso vive só em site/cadeiras.js, que é o único arquivo a editar quando entra uma cadeira ou uma aula — os índices são gerados a partir dele, nenhum se escreve à mão.

Processar uma aula nova

Coloque os .mkv e o transcricao.txt em Cadeiras/<Cadeira>/<pasta da aula>/ e, no Claude Code:

/nova-aula Eng-SW-AI 2

O comando lê a transcrição inteira, filtra o conteúdo, escreve a página, atualiza o registro e gera o podcast.

Cadeira nova: crie a pasta Cadeiras/<Cadeira>/Aula1/, acrescente a entrada em site/cadeiras.js e copie estudo/Eng-SW-AI/index.html para estudo/<Cadeira>/index.html, trocando o slug e o título.

Para estudar com tutoria em vez de só ler:

/estudar Eng-SW-AI 1

Rodar os scripts na mão

python scripts/fatiar_transcricao.py Cadeiras/Eng-SW-AI/Aula1/transcricao.txt

node scripts/verificar.mjs

python scripts/gerar_podcast.py

O verificar.mjs executa o app.js e o indices.js de verdade num DOM mínimo, sem navegador. Além de conferir que as páginas se montam, ele checa se o tempo de leitura anunciado bate com o texto, se os timestamps cobrem todos os arquivos da gravação, e se o registro e os arquivos em disco se desencontraram — material gerado que ninguém cadastrou (fica invisível no site) ou aula marcada como pronta sem dados.js (vira link quebrado).

O gerar_podcast.py precisa de pip install edge-tts e de internet. Os MP3 ficam versionados, então depois do clone o áudio já está lá.

Como os timestamps funcionam

A transcrição cobre a aula inteira com tempo contínuo, mas a gravação vem partida em vários .mkv. Todo timestamp exibido é o da aula, e a página converte para arquivo e posição: clicar copia algo como Eng-AI-Aula-1-002.mkv @ 2:05.