Published

26/07/2026

Modified

26/07/2026

📚 Gemini.md - Diretrizes de Desenvolvimento e Módulos Externos

Este arquivo contém informações cruciais sobre a arquitetura do site (alessiojr.com) para orientação da inteligência artificial (Gemini / Antigravity Agent) e de desenvolvedores.

🎯 Arquitetura do Projeto

O site principal é construído utilizando Quarto CLI e possui uma arquitetura de módulos externos para a gestão do conteúdo das disciplinas ministradas.

Estrutura de Pastas e Módulos

  1. Pastas Fontes Externas (Master):
    • Localização: /mnt/arquivos/GDrive/Documents/Disciplinas/<nome_da_disciplina> (ex: clp, aed2, cg, compiladores, gps, tec-programacao, ia2, estagio).
    • Onde o conteúdo original da disciplina é criado e editado.
  2. Módulos Sincronizados no Site Principal (Cópia):
    • Localização: disciplines/<nome_da_disciplina> dentro deste repositório (alessiojr.com).
    • Gerados/atualizados via o script ./scripts/sync-modules.sh.

⚠️ Regras Obrigatórias para a IA e Desenvolvedores

1. Manutenção Dupla de Módulos (Master + Sincronizado)

REGRA CRÍTICA: Sempre que houver necessidade de ajustar, corrigir ou modificar arquivos de uma disciplina (estilos, scripts, .qmd, _metadata.yml, etc.): - A alteração DEVE ser feita na fonte externa (/mnt/arquivos/GDrive/Documents/Disciplinas/<modulo>). - E em seguida refletida/sincronizada no repositório principal via ./scripts/sync-modules.sh (ou modificada também em disciplines/<modulo>).

3. Pipeline de CI/CD e Script protect-site.sh

  • A proteção de páginas via StatiCrypt é executada no hook post-render do Quarto pelo script scripts/protect-site.sh.
  • O script trata a resolução de npx em ambientes com NVM/Node e possui fallback gracioso caso npx não esteja instalado no host do GitLab Runner.
Back to top