Forgejo e CI

O Forgejo é a forja Git da X-Adm: repositórios, issues, pull requests e CI (Forgejo Actions, sintaxe compatível com GitHub Actions).

Fluxo de trabalho

• master (ou main): código estável e implantável.
• Branches de trabalho: feature/nome-curto, fix/issue-123.
• Mudança nasce numa issue → branch → commits → pull request → revisão → merge. Doc da mudança vai no mesmo PR (ver constituição).

Quem não usa Git edita arquivos Markdown direto pela interface web do Forgejo (botão de editar no arquivo → commit na branch ou PR automático).

Deploy automático via webhook

Cada push na branch configurada pode rebuildar e redeployar o app no Coolify:

1. No Coolify: copiar a URL de webhook do recurso.
2. No Forgejo: Settings do repo → Webhooks → Add Webhook → colar a URL, content type application/json, evento Push.

Alternativa (usada no site de docs): o próprio workflow do Forgejo Actions chama o webhook com curl depois de validar o build — assim push com build quebrado não chega a deployar.

Secrets no CI

• Nunca commitar tokens, senhas de banco ou chaves — usar Settings → Actions → Secrets do repositório.
• Runners que rodam testes com Docker (Testcontainers) precisam de acesso ao Docker socket.

Checklist de PR

• [ ] Testes passam (./gradlew test, flutter test, conforme a stack)
• [ ] Mudou contrato/fluxo público → doc atualizada no mesmo PR
• [ ] Frontmatter válido nos .md novos/alterados
• [ ] Artefatos gerados (HTML de doc, relatórios) não commitados