.github — Governança da Organização CerneBR

Este é o repositório central de governança da organização CerneBR. Os arquivos versionados aqui são herdados automaticamente por todos os repositórios da organização quando estes não definirem seus próprios.

📌 Este repositório não contém código de aplicação. Para o backend, veja gateway-nacional. Para o portal, veja gateway-nacional-web.

---

Estrutura

.github/
├── README.md                              # Você está aqui
├── CODE_OF_CONDUCT.md                     # Código de Conduta (Contributor Covenant 2.1)
├── CONTRIBUTING.md                        # Guia de contribuição organizacional
├── SECURITY.md                            # Política de segurança e divulgação responsável
├── SUPPORT.md                             # Canais de suporte e ajuda
│
├── profile/
│   └── README.md                          # Renderizado como capa da org em github.com/CerneBR
│
├── .github/
│   ├── PULL_REQUEST_TEMPLATE.md           # Template padrão de PR
│   ├── dependabot.yml                     # Template de Dependabot (copiar para cada repo)
│   └── ISSUE_TEMPLATE/
│       ├── config.yml                     # Links externos e bloqueio de Issue em branco
│       ├── bug_report.yml                 # Formulário estruturado de bug
│       ├── feature_request.yml            # Formulário estruturado de feature
│       └── enterprise_support.md          # Placeholder para suporte corporativo
│
└── docs/
    └── ORG_SETTINGS_GUIDE.md              # Guia operacional para Owners/Admins

---

Como o GitHub usa estes arquivos

Arquivo	Onde aparece
profile/README.md	Capa pública da org em https://github.com/CerneBR.
CODE_OF_CONDUCT.md / CONTRIBUTING.md / SECURITY.md / SUPPORT.md	Usados como fallback para repositórios que não definirem seus próprios.
.github/PULL_REQUEST_TEMPLATE.md	Pré-popula novos PRs em qualquer repo da org.
.github/ISSUE_TEMPLATE/*	Lista de templates ao abrir nova Issue em qualquer repo da org.
.github/dependabot.yml	⚠️ Não é herdado. É um template — copiar para cada repositório.

---

Para os mantenedores da CerneBR

• ✅ Toda mudança aqui é via Pull Request. Não há push direto em main. Veja CONTRIBUTING.md.
• ✅ O guia operacional (docs/ORG_SETTINGS_GUIDE.md) é o roteiro de configuração da organização no painel admin do GitHub — Branch Protection, Dependabot, Code Scanning, Teams.
• ✅ Quando um repositório precisar de regras específicas (ex.: o frontend exige checks de lint e typecheck que o backend não tem), defina-as dentro do repositório. Este .github é a base mínima compartilhada.

---

Para a comunidade

• 💬 Discussões técnicas: GitHub Discussions
• 🐛 Bugs e Features: abra Issue no repositório afetado (não aqui)
• 🔒 Vulnerabilidades: siga o processo privado em SECURITY.md
• 🌐 Portal oficial: https://cernebr.dev.br

---

_{© CerneBR · Distribuído sob a Licença Apache 2.0}