📌 Diretriz Oficial: Padrão 20/20/20/20/20 em Todos os Cursos
Data de Registro: 10 de Agosto de 2026
Status: Diretriz Ativa e Obrigatória
Aplica-se a: Todos os 50 Repositórios de Cursos do Portal
🎯 Regra de Ouro da Matriz Didática (20/20/20/20/20)
Todos os repositórios do Portal RicardoTecPro devem obrigatoriamente possuir exatamente 20 unidades em cada uma das 5 seções didáticas fundamentais:
| Seção Didática | Quantidade Exigida | Padrão de Nomenclatura | Conteúdo Obrigatório |
|---|---|---|---|
| Aulas | 20 | docs/aulas/aula-01.md a aula-20.md | Teoria concisa, diagramas Mermaid, exemplos de código de alta qualidade. |
| Exercícios | 20 | docs/exercicios/exercicio-01.md a exercicio-20.md | Exercícios práticos Bronze/Prata/Ouro alinhados com o tema da aula + Gabarito sanfonado retrátil (<details><summary>Gabarito Explicado</summary>). |
| Projetos | 20 | docs/projetos/projeto-01.md a projeto-20.md | Desafios práticos aplicados do mundo real correspondentes a cada aula. |
| Quizzes | 20 | docs/quizzes/quiz-01.md a quiz-20.md | Avaliações interativas de fixação (10 questões por quiz) alinhadas com cada aula. |
| Slides | 20 | docs/slides/slide-01.md a slide-20.md | Material de apresentação condensado e altamente visual para cada aula. |
🗺️ Estrutura em 5 Módulos Padronizados
Para comportar as 20 unidades sem poluir a navegação, todos os cursos dividem-se em 5 Módulos de 4 Aulas cada:
- Módulo 1 (Aulas 01 a 04): Fundamentos, Bases & Conceitos Iniciais
- Módulo 2 (Aulas 05 a 08): Arquitetura & Elementos Essenciais
- Módulo 3 (Aulas 09 a 12): Engenharia, Lógica & Aplicação Prática
- Módulo 4 (Aulas 13 a 16): Software, Ferramentas & Padrões
- Módulo 5 (Aulas 17 a 20): Tópicos Avançados & Projeto Capstone Integrador
🔍 Checklist de Validação de Links e Integridade
Nenhum repositório é considerado finalizado até que: 1. Os 20 arquivos de cada seção existam fisicamente em docs/. 2. As páginas de índice (exercicios/index.md, projetos/index.md, quizzes/index.md, slides/index.md) listem os 20 itens. 3. O mkdocs.yml declare todas as 20 entradas no menu de navegação (nav:). 4. O script scripts/check_links.py confirme 0 links quebrados.