Funcionalidade homologacao - BrunodosSantosVaz/big-bang GitHub Wiki
Homologação e correções
Funcionalidade BB-F-038 · requisito RF-BB-038 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Apresentar candidata e critérios ao dono, registrar reprovação e criar uma tarefa de correção no mesmo épico.
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
Mover unidade para Homologação, comentar a candidata e seus critérios e abrir PR de release para main; em reprovação criar tarefa com motivo, dependências, Sprint e branch, produzindo rc seguinte.
Validações
Uma correção não cria outra release estável antes da unidade já planejada; candidata usada pelo dono é a que será promovida.
Alternativas e erros
Decisão sem autorização não é aplicada; repetir evento não duplica PR nem tarefa; falha de API impede avançar o estado.
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: Apresentar candidata e critérios ao dono, registrar reprovação e criar uma tarefa de correção no mesmo épico. 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.
homologar.sh
tarefa-de-correcao.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