Publicação no GitHub Pages & CI/CD de Releases do Aplicativo

O projeto CGPDI.StudyLab conta com uma esteira completa de Integração e Entrega Contínuas (CI/CD) dividida em dois workflows:

Deploy Contínuo da Documentação: Compila o site Astro Starlight e publica no GitHub Pages.
Build & Release do Aplicativo Windows: Compila o .NET 10, empacota com Velopack (instalador + pacotes delta), gera o executável portátil (.zip) e publica no GitHub Releases.

🚀 1. Pipeline de Release do Aplicativo (`release-app.yml`)

O workflow .github/workflows/release-app.yml é disparado automaticamente ao criar uma tag (ex: v1.0.1) ou manualmente via workflow_dispatch:

graph TD
    A["Tag Git vX.Y.Z ou Disparo Manual"] --> B["GitHub Actions Windows Runner"]
    B --> C["Compilação .NET 10 Release"]
    C --> D["dotnet publish win-x64 Self-Contained"]
    D --> E["Compactação ZIP Portátil"]
    D --> F["vpk pack: instalador + pacotes delta + notas da release"]
    E --> G["GitHub Releases Oficial"]
    F --> G
    G --> H["Auto-Updater (Velopack) Notifica e Atualiza os Usuários"]

Artefatos Gerados em Cada Release:

Setup.exe: Instalador Velopack para Windows com atalhos na Área de Trabalho e Menu Iniciar. Instala em %LocalAppData% (sem UAC) ou para todos os usuários (requer administrador, ex.: laboratórios), com atualizações delta automáticas.
CGPDI-StudyLab-MachineWide.msi: Instalador MSI para implantação machine-wide via GPO/Intune pela equipe de TI (cria a tarefa SYSTEM de auto-update).
CGPDI-StudyLab-Portable-win-x64.zip: Versão portátil autônoma pronta para rodar sem necessidade de instalação ou direitos de administrador.
Pacotes .nupkg (full + delta): Usados pelo auto-updater para baixar apenas as alterações entre versões.

🔄 2. Sistema de Auto-Update Integrado

O aplicativo possui um sistema inteligente de verificação e atualização automática (UpdateManager.cs) baseado no Velopack:

Verificação em Segundo Plano: Ao iniciar, o app consulta o feed do Velopack no GitHub Releases de forma não bloqueante (com fallback para a API do GitHub em execuções portáteis).
Diálogo de Atualização: Se uma versão mais recente for encontrada (ex: v1.0.1 > v1.0.0), uma janela moderna exibe o changelog (extraído do CHANGELOG.md na release) e pergunta ao usuário se deseja atualizar.
Download Delta e Aplicação Automática:
- Instalado (Velopack, por usuário): Baixa apenas o pacote delta (alterações desde a versão atual), aplica e reinicia o app sem pedir permissão de administrador.
- Instalado (Velopack, todos os usuários): Sem privilégios de administrador, o app delega a atualização a um processo em segundo plano — pela tarefa agendada SYSTEM criada na instalação ou reiniciando-se elevado (UAC) — e aplica tudo sozinho, sem depender da TI.
- Portátil: Baixa o .zip, descompacta em segundo plano e reinicia a aplicação atualizada.
Preferências do usuário: “Lembrar mais tarde” adia a notificação por 7 dias e “Ignorar esta versão” oculta a versão, persistidos localmente.
Verificação Manual: O botão 🔔 Atualizações na barra superior permite checar novidades a qualquer momento.

🌐 3. Deploy da Documentação no GitHub Pages (`deploy-docs.yml`)

O repositório inclui o workflow .github/workflows/deploy-docs.yml que sincroniza a documentação a cada commit na branch main. O workflow gera o arquivo CNAME automaticamente, habilitando o domínio customizado.

A documentação está publicada em: 👉 https://cgpdi.gabrielfs.dev

Para que o domínio funcione, o DNS do provedor deve apontar para o GitHub Pages:

Tipo	Nome	Valor
`CNAME`	`cgpdi.gabrielfs.dev`	`gabriel-freitas-s.github.io`

Além do registro DNS, o domínio cgpdi.gabrielfs.dev deve estar cadastrado em Settings → Pages → Custom domain do repositório. O CNAME embutido no artefato de deploy garante que ele seja recriado a cada publicação.

💻 4. Geração Local de Release

Para compilar o pacote de release localmente sem enviar para o GitHub, basta executar o script PowerShell:

.\build_release.ps1 -Version "1.0.0"

Os arquivos finais serão gerados na pasta dist/.