🏗️ Arquitetura Atual da Plataforma: Portal Jekyll

Documenta a arquitetura de plataforma, o pipeline de CI/CD, os padrões de conteúdo e o Padrão Ouro Educacional que rege os 40 cursos do portal.

🏛️ Estrutura do Sistema e Diretórios

portal_jekyll/
├── _config.yml              # Configuração Jekyll (tema remoto, plugins, exclude, url/baseurl)
├── Gemfile / Gemfile.lock    # Dependências Ruby pinadas (Jekyll 4.4 + plugins)
├── package.json              # Marp CLI — geração de slides Reveal.js
├── _layouts/
│   ├── default.html          # Layout padrão: header, breadcrumb, conteúdo, nav prev/next, footer
│   └── slide.html            # Layout para apresentações técnicas interativas
├── _includes/
│   └── head-custom.html      # MathJax 3, Mermaid 10, botões de cópia de código e tema
├── _scripts/                 # Scripts de manutenção e hooks de automação
├── assets/                   # CSS customizado e downloads estáticos
├── .github/workflows/        # Pipeline GitHub Actions (jekyll-gh-pages.yml)
├── docs/                     # Governança técnica, ADRs, planos e auditorias
├── mod_01..14_*/             # 13 Módulos de Fundamentos da Computação e Engenharia (20 Caps cada)
├── spec_*/                   # 18 Trilhas Especializadas (Frontend, Backend, Sistemas, Mobile, Segurança) (20 Caps cada)
├── extra_*/                  # 8 Guias Extras e Ferramentas (Markdown, UML, Redes, IA, Linguagens) (20 Caps cada)
└── proj_aplicacoes_full_stack/
    ├── topicos/..quizzes/    # Trilha Canônica de Engenharia Full Stack (20 Capítulos)
    └── projetos/             # Super-Hub Geral de Projetos (158 Aplicações Integradas)

🔄 Fluxo de Integração Contínua e Deploy (CI/CD)

flowchart LR
    A["Push em main 🚀"] --> B["GitHub Actions: jekyll-gh-pages.yml ⚙️"]
    B --> C["Setup Ruby 3.3 + Bundler Cache 💎"]
    C --> D["bundle exec jekyll build --baseurl ... 🔨"]
    D --> E["Upload Pages Artifact 📦"]
    E --> F["Deploy Pages → GitHub Pages Live 🌐 ⚡"]

    style A fill:#ede7f6,stroke:#512da8,stroke-width:1.5px
    style B fill:#e1f5fe,stroke:#03a9f4,stroke-width:1.5px
    style C fill:#fff3e0,stroke:#ff9800,stroke-width:1.5px
    style D fill:#00897b,stroke:#004d40,stroke-width:2px,color:#ffffff
    style E fill:#e8f5e9,stroke:#4caf50,stroke-width:1.5px
    style F fill:#00897b,stroke:#004d40,stroke-width:2px,color:#ffffff

• Trigger: Disparado automaticamente a cada push na branch main ou via workflow_dispatch.
• Segurança: Permissões mínimas restritas (contents: read, pages: write, id-token: write).
• Tempo Médio de Build: ~20 a 25 segundos no GitHub Actions runner.

🏛️ A Matriz Canônica do Padrão Ouro (20 Capítulos • 5 Blocos)

Todos os 40 cursos do portal operam sob uma matriz canônica rigorosamente simétrica:

flowchart TD
    subgraph MODULO ["Estrutura Canônica de Cada Curso (40 Cursos)"]
        direction TB
        B1["Bloco 1: Fundamentos (Caps 01 a 04)"]
        B2["Bloco 2: Prática & Aprofundamento (Caps 05 a 08)"]
        B3["Bloco 3: Arquitetura & Integração (Caps 09 a 12)"]
        B4["Bloco 4: Escala & Infraestrutura (Caps 13 a 16)"]
        B5["Bloco 5: Deploy & Projetos Reais (Caps 17 a 20)"]
        
        B1 --> B2 --> B3 --> B4 --> B5
    end

    subgraph ARTIFACTS ["5 Artefatos Sincronizados por Capítulo (Total: 100 por Curso)"]
        direction LR
        T["1. topicos/*.md\n(Teoria + Mermaid)"]
        E["2. exercicios/*_exercicios.md\n(4 Níveis + Gabarito)"]
        X["3. exemplos/*_exemplos.md\n(Código Executável)"]
        S["4. slides/*_slides.md\n(Reveal.js Interativo)"]
        Q["5. quizzes/*_quiz.md\n(Feedback por Alternativa)"]
    end

    MODULO ==> ARTIFACTS

    style MODULO fill:#ede7f6,stroke:#512da8,stroke-width:1.5px
    style ARTIFACTS fill:#00897b,stroke:#004d40,stroke-width:2px,color:#ffffff

Regras de Simetria e Rastreabilidade 1-para-1:

1. topicos/ é a Base Única e Fonte da Verdade: Todo conceito e lição teórica reside em topicos/.
2. Correspondência 1-para-1 Obrigatória: Todas as outras 4 pastas (exercicios/, exemplos/, slides/, quizzes/) acompanham a numeração e escopo dos tópicos.
3. 6 Índices Mestres por Módulo:
   • index.md: Hub do curso com matriz dos 5 blocos.
   • topicos/index.md, exercicios/index.md, exemplos/index.md, slides/index.md, quizzes/index.md: Índices setoriais categorizados pelos 5 blocos.