Funcionalidade fundacao github - BrunodosSantosVaz/big-bang GitHub Wiki
Configuração inicial do GitHub
Funcionalidade BB-F-031 · requisito RF-BB-031 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Instalar labels, proteções, ambientes, variáveis e painéis coerentes com a configuração do projeto.
Atores
Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.
Pré-condições
Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.
Fluxo principal
Validar dono/repositório; criar labels e painéis de forma idempotente; auditar visibilidade real; habilitar Discussions e publicar boas-vindas; instalar proteções e relatar segredos por nome.
Validações
Projetos públicos precisam de painéis públicos após auditoria; revisão do dono e ambiente de produção permanecem separados.
Alternativas e erros
Plano GitHub sem determinada proteção é informado; segredos não são inventados nem exibidos; falha de comunidade interrompe configuração.
Permissões
Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.
Resultados
Resultado esperado: Instalar labels, proteções, ambientes, variáveis e painéis coerentes com a configuração do projeto. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.
Referência da implementação
Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.
configurar-repositorio.sh
criar-labels.sh
criar-paineis.sh
colunas.sh
Cenários e rastreabilidade
.bigbang/tests/test_configurar_repositorio.py:test_simular_nao_muda_nada.bigbang/tests/test_configurar_repositorio.py:test_aplica_protecoes.bigbang/tests/test_configurar_repositorio.py:test_checks_so_depois_da_esteira.bigbang/tests/test_configurar_repositorio.py:test_scripts_de_montagem_recusam_repositorio_sem_dono.bigbang/tests/test_configurar_repositorio.py:test_lista_so_os_segredos_que_faltam.bigbang/tests/test_configurar_repositorio.py:test_compilado_pede_os_segredos_de_assinatura.bigbang/tests/test_configurar_repositorio.py:test_avisa_quando_o_plano_nao_aplica_a_aprovacao
Requisitos · Matriz de rastreabilidade · Referência CLI