Funcionalidade compilados - BrunodosSantosVaz/big-bang GitHub Wiki
Candidata e promoção de binários
Funcionalidade BB-F-041 · requisito RF-BB-041 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Compilar cada sistema uma vez e promover os mesmos bytes após homologação.
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
Executar o build específico no runner configurado; nomear rc por sistema; registrar SHA-256, SBOM e notas; baixar candidata e conferir hashes; remover rc do nome e criar release estável.
Validações
Compilar e instalar são contratos diferentes; promoção não recompila; todos os sistemas devem concluir a candidata antes da pré-release.
Alternativas e erros
Arquivo ausente, build reprovado ou checksum diferente impede publicação; candidata existente é reutilizada sem sobrescrever seus assets.
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: Compilar cada sistema uma vez e promover os mesmos bytes após homologação. 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.
candidata-build.sh
candidata-publicar.sh
promover.sh
Cenários e rastreabilidade
.bigbang/tests/test_candidata.py:test_preparar_numera_as_candidatas.bigbang/tests/test_candidata.py:test_preparar_pula_ou_recusa.bigbang/tests/test_candidata.py:test_build_renomeia_e_soma.bigbang/tests/test_candidata.py:test_build_com_dois_arquivos_falha.bigbang/tests/test_candidata.py:test_publicar_cria_pre_release.bigbang/tests/test_candidata.py:test_epico_em_homologacao_e_pr_da_release
Requisitos · Matriz de rastreabilidade · Referência CLI