Arquitetura dos arquivos e da plataforma
1. Estrutura atual
CURSO JOGOS DIGITAIS/
README.md ← porta de entrada
DIAGNOSTICO.md ← Etapa 1
PLANO_PEDAGOGICO.md ← objetivos, competências, metodologia
MATRIZ_CURRICULAR.md ← módulos, horas, conteúdos
FERRAMENTAS.md ← cada ferramenta com link e primeiro exercício
AVALIACAO.md ← instrumentos e rubricas
MODELO_DE_AULA.md ← padrão de 24 itens
PROJETOS.md ← plano dos projetos práticos
CRONOGRAMA.md ← calendário do curso e da produção
ACOMPANHAMENTO.md ← o que está pronto, testes, pendências
REFERENCIAS.md ← fontes oficiais
plataforma/ ← gerador do site do curso e arquivos de deploy (ver plataforma/README.md)
GUIA_DO_PROFESSOR.md ← preparação, condução das aulas, avaliação
GUIA_DO_ESTUDANTE.md ← como estudar com as aulas, diário, combinações
GLOSSARIO.md ← palavras do curso, com a aula de cada uma
ARQUITETURA.md ← este arquivo
modulos/
modulo-00-introducao/
plano.md
aulas/ ← aula-0-1 ... aula-0-6
atividades/ ← questionário diagnóstico, fichas
projetos/
caca-estrelas/ ← jogo de referência (.sb3) + README
modulo-01-logica/
plano.md
aulas/ ← aula-1-1 ... aula-1-11
atividades/ ← lista de exercícios, avaliação de saída
projetos/ ← 9 mini-jogos + quiz-sabidinho (Projeto 2)
modulo-02-game-design/
plano.md
aulas/ ← aula-2-1 ... aula-2-8
modelos/ ← GDD de uma página, ficha de teste com jogadores
atividades/ ← projeto do módulo e rubrica
projetos/trilha-do-mandacaru/ ← tabuleiro e histórico de balanceamento
modulo-03-gdevelop/
plano.md
aulas/ ← aula-3-1 ... aula-3-11
atividades/ ← Projeto 1 (requisitos, rubrica, questões de saída)
projetos/sementes-do-sertao/ ← jogo de referência (.json do GDevelop), imagens e sons
modulo-04-programacao-aplicada/
plano.md
aulas/ ← aula-4-1 ... aula-4-9
atividades/ ← Projeto 3 (requisitos, rubrica, questões de saída)
projetos/trilha-da-serra/ ← jogo de plataforma de referência, imagens e sons
modulo-05-arte-e-animacao/
plano.md
aulas/ ← aula-5-1 ... aula-5-8
atividades/ ← projeto do pacote de sprites
exemplos/ ← imagens de exemplo (paleta, grade, animação, tileset, interface)
modulo-06-fases-e-ia/
plano.md
aulas/ ← aula-6-1 ... aula-6-8
atividades/ ← Projeto 5 (requisitos, rubrica, questões de saída)
projetos/cajueiral/ ← jogo de fases de referência, imagens e sons
modulo-07-narrativa-audio/
plano.md
aulas/ ← aula-7-1 ... aula-7-8
atividades/ ← Projeto 4 (educativo)
projetos/feira-do-troco/ ← jogo educativo de referência, imagens e sons
modulo-08-godot/
plano.md
aulas/ ← aula-8-1 ... aula-8-10
atividades/ ← projeto do módulo (Sementes em Godot)
projetos/sementes-godot/ ← jogo de referência em Godot (abrir a pasta no Godot)
exemplos/laboratorio/ ← projeto Godot com um exemplo por aula
modulo-09-3d/
plano.md
aulas/ ← aula-9-1 ... aula-9-8
atividades/ ← Projeto 6 (labirinto 3D)
projetos/chave-da-porteira/ ← labirinto 3D de referência (cenas, scripts, materiais, modelos)
exemplos/laboratorio-3d/ ← eixos e materiais
modulo-10-publicacao/
plano.md
aulas/ ← aula-10-1 ... aula-10-8
atividades/ ← projeto do portfólio e modelos (plano de testes, relatório de falha, README)
exemplos/caca-aos-erros/ ← projeto Godot com 4 erros e gabarito
projetos/portfolio-modelo/ ← portfólio de exemplo (uma página)
ferramentas/quadros_para_gif.py ← quadros do Godot para GIF
modulo-11-projeto-integrador/
plano.md
aulas/ ← aula-11-1 ... aula-11-12
atividades/ ← projeto integrador (requisitos, rubrica da banca, gabarito)
modelos/ ← contrato, ficha do problema, relatório do ciclo, teste com usuários, autorização, divulgação, ficha da banca
kit/modelo-godot/ ← projeto Godot para a equipe copiar (início, pausa, fim, recorde)
kit/quadro-de-tarefas/ ← quadro de tarefas numa página
recursos/
imagens/scratch/ ← capturas reais do editor do Scratch
imagens/gdevelop/ ← capturas reais do GDevelop 5.6.285
imagens/godot/ ← capturas reais do Godot 4.7.2 e dos jogos rodando
diagramas/ ← diagramas originais em SVG
scripts/
sb3.py ← biblioteca para montar projetos Scratch em Python
gerar_caca_estrelas.py ← recria o .sb3 do Módulo 0
gerar_modulo_01.py ← recria os 10 .sb3 do Módulo 1
simular_trilha.py ← simula 8 versões de regras da Trilha do Mandacaru
gerar_tabuleiro_trilha.py ← gera o tabuleiro para imprimir
gdevelop.py ← biblioteca para montar projetos do GDevelop em Python
gerar_sementes_sertao.py ← recria o Sementes do Sertão (desenhos e sons originais)
gerar_trilha_da_serra.py ← recria a Trilha da Serra (Projeto 3)
gerar_arte_modulo_05.py ← recria as imagens de exemplo do Módulo 5
gerar_cajueiral.py ← recria O Cajueiral (Projeto 5)
gerar_feira_do_troco.py ← recria A Feira do Troco (Projeto 4)
testes/ ← testes no motor do Scratch (npm run testar) e no GDevelop (testes/gdevelop/) e no Godot (testes/godot/)Pastas de módulos seguintes só serão criadas quando houver conteúdo de verdade nelas.
2. Plataforma web do curso (feita em plataforma/; hospedagem decidida: subdomínio da ITA)
Objetivo: site simples, rápido e barato, que mostre as aulas com navegação, blocos de código com botão de copiar, checklists e progresso do aluno.
| Decisão | Escolha | Por quê |
|---|---|---|
| Fonte do conteúdo | os mesmos arquivos .md deste repositório | um só lugar para editar; nada duplicado |
| Geração | script Node.js que converte Markdown em HTML estático | sem servidor de aplicação, sem banco |
| Progresso do aluno | localStorage do navegador (checklists marcados) | sem login e sem dados pessoais guardados no servidor |
| Hospedagem | pasta estática servida pelo Nginx já existente no VPS da ITA, em um subdomínio próprio, ou GitHub Pages | custo zero adicional |
| Acessibilidade | HTML semântico, contraste alto, navegação por teclado, texto alternativo em toda imagem | requisito do curso |
A confirmar com o responsável antes de implementar: onde o site vai morar (subdomínio da ITA ou GitHub Pages) e se o curso deve aparecer dentro de alguma plataforma já existente do ecossistema.
3. Ferramentas de desenvolvimento do material
- Python 3: scripts de apoio (gerar arquivos de referência).
- Node.js: plataforma web (futuro).
- Nenhuma dependência paga.