Playbook das Trilhas Educacionais

Este playbook documenta como funciona o sistema educacional deste site: os formatos de trilha, a anatomia de cada módulo, o método de curadoria por trás de cada vídeo e o princípio que guia tudo — levar quem estuda de junior a sênior.

É a fonte canônica para entender, usar e estender as trilhas.

Filosofia

O ensino aqui parte de três princípios:

1. Gratuito e multilíngue. Todo o conteúdo é curado de vídeos públicos do YouTube em português, inglês e espanhol. Sem paywall, sem login.
2. Curadoria, não acúmulo. O valor não está em listar mil vídeos, e sim em ordenar os certos numa sequência que faça sentido — dos fundamentos ao nível de entrevista sênior.
3. Links verificados. Cada vídeo tem o ID confirmado por API pública antes de entrar no catálogo. Sem link quebrado, sem título inventado.

Os dois formatos

O sistema educacional tem dois formatos complementares:

1. Trilhas YouTube (curadoria de vídeos)

Páginas autônomas que agregam vídeos curados do YouTube, organizados em módulos, com filtros por idioma/nível e progresso salvo no navegador.

Trilhas de linguagem (do junior ao sênior):

• Trilha React — React, JavaScript e TypeScript.
• Trilha Go (Golang) — dos fundamentos à arquitetura.
• Trilha Python — fundamentos, web, dados e deploy.
• Trilha Rust — ownership, async (Tokio), web e testes.
• Trilha Kotlin no Backend — Spring, Ktor, microsserviços.

Trilhas de IA / negócio:

• Engenheiro de IA — da engenharia de prompts ao treino de modelos.
• Cursos de Claude AI — construir e monetizar com Claude.

Todas têm card na Central de Trilhas e atalho no sidebar dos docs.

2. Hub de Treinamentos (trilhas autorais)

A página Treinamentos é um hub de trilhas técnicas autorais (IA, Dev, DevOps), com conteúdo escrito, checklists e paletas próprias — um formato mais estruturado e opinativo que a curadoria de vídeos.

Mapa das rotas educacionais

Os números de vídeos/cursos crescem com a curadoria; cada página exibe a contagem real (derivada do catálogo) no topo.

Anatomia de uma trilha YouTube

Toda trilha YouTube segue a mesma estrutura padronizada — é o que permite replicá-la para qualquer linguagem ou tema:

Cada trilha é uma rota Next.js autônoma com metadata completo, OG image própria (opengraph-image.tsx) e JSON-LD (ItemList, Course, BreadcrumbList) para SEO.

Método de curadoria (3 passos)

Este é o coração do sistema — o processo que garante qualidade e que cada vídeo é real.

Passo 1 — Descobrir IDs reais

Busca na web restrita ao domínio youtube.com, por tópico e por idioma (PT/EN/ES separados). Os links retornados pelo buscador são a fonte confiável de IDs — nunca se copia ID de texto em prosa (que pode alucinar identificadores).

Passo 2 — Validar via YouTube oEmbed

Cada ID candidato passa pelo endpoint público do YouTube (sem chave de API):

https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=ID&format=json

A resposta traz título e canal reais ou retorna 404. IDs com 404 (ou falha persistente) são descartados. O título usado no catálogo é o title retornado pelo oEmbed, verbatim — sem inventar.

Passo 3 — Montar os módulos

Os vídeos validados são distribuídos nos módulos por tópico, equilibrando idiomas e níveis, com checagem de IDs duplicados antes de publicar.

O mesmo método alimenta todas as trilhas YouTube — é o que torna o formato replicável para qualquer linguagem.

Princípio junior → sênior

As trilhas de linguagem não param no "olá mundo". Elas são desenhadas para cobrir toda a curva de senioridade:

• Fundamentos — sintaxe, tipos, estruturas básicas.
• Intermediário — concorrência, estado, APIs, banco de dados, testes.
• Sênior / entrevista — generics, performance/profiling, micro frontends, gRPC/microsserviços, arquitetura limpa, deploy.

A trilha React, por exemplo, vai de fundamentos a micro frontends, AWS, JavaScript avançado, TypeScript e testes. A trilha Go vai de goroutines a pprof e Clean Architecture. O objetivo declarado é fechar as lacunas que aparecem em entrevistas técnicas de nível pleno e sênior.

Como estender o catálogo

Para adicionar uma nova trilha YouTube (ex.: outra linguagem), o padrão é espelhar uma trilha existente:

1. Criar a rota src/app/<tema>-youtube/ com _data.ts (catálogo tipado), VideosGrid.tsx (grade com filtros/modal/progresso), useWatchedVideos.ts (chave de localStorage própria), page.tsx (server, com JSON-LD) e opengraph-image.tsx.
2. Curar os vídeos pelos 3 passos acima.
3. Registrar a rota em src/app/sitemap.ts.
4. Ajustar a cor de marca e os textos de branding.

Para adicionar uma trilha autoral, registrá-la no hub /treinamentos (manifesto + conteúdo por slug).

Resumo

O sistema educacional combina curadoria de vídeos (trilhas YouTube) com trilhas autorais (hub de treinamentos), ambos gratuitos e multilíngues. Cada vídeo é validado por oEmbed, cada trilha segue uma estrutura padronizada e o catálogo inteiro mira o caminho junior → sênior. O método é deliberadamente replicável: descobrir, validar, ordenar.