Funcionalidade publicacao - BrunodosSantosVaz/big-bang GitHub Wiki
Publicação estável e alteração sem release
Funcionalidade BB-F-039 · requisito RF-BB-039 · versão documentada 3.0.1 · código 371a61ae5c993f6ba3fde76e77f91e64f0bf9c42.
Finalidade
Publicar somente unidade homologada, aprovada e com documentação publicada; entregar configuração ou manutenção sem reconstruir artefato.
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
Conferir versão, PR, homologação, checklist e Wiki publicada; promover a candidata em main; no fluxo sem release conferir develop, gates e merge permitido, depois sincronizar branches.
Validações
Produção exige ordem vigente do dono; a documentação é obrigatória inclusive Flash e sem-release; promoção usa bytes/digests já homologados.
Alternativas e erros
Pendência documental, teste, aprovação ou segurança impede entrega; retomada conclui a limpeza sem mover tag nem substituir artefato.
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: Publicar somente unidade homologada, aprovada e com documentação publicada; entregar configuração ou manutenção sem reconstruir artefato. 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.
publicar-producao.sh
publicar-sem-release.sh
devolver-main.sh
link-aprovacao.sh
Cenários e rastreabilidade
.bigbang/tests/test_publicar_producao.py:test_publica_os_mesmos_bytes.bigbang/tests/test_publicar_producao.py:test_mesmo_sha256_da_candidata.bigbang/tests/test_publicar_producao.py:test_simular_nao_muda_nada.bigbang/tests/test_publicar_producao.py:test_portao_recusa_cada_caso.bigbang/tests/test_publicar_producao.py:test_release_mudou_depois_da_candidata.bigbang/tests/test_publicar_producao.py:test_retomada_quando_ja_publicada.bigbang/tests/test_publicar_producao.py:test_production_refuses_candidate_changed_after_complete_tests.bigbang/tests/test_publicar_producao.py:test_cria_a_tarefa_no_epico_reprovado.bigbang/tests/test_publicar_producao.py:test_motivo_longo_vira_titulo_cortado_em_palavra_inteira.bigbang/tests/test_publicar_producao.py:test_recusa_epico_nao_reprovado
Requisitos · Matriz de rastreabilidade · Referência CLI