Funcionalidade integracao - BrunodosSantosVaz/big-bang GitHub Wiki
Integração da unidade de release
Funcionalidade BB-F-037 · requisito RF-BB-037 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.
Finalidade
Integrar épicos, bugs ou dependências em uma release coerente com SemVer e registrar changelog versionado.
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 tarefas e dependências; mesclar em ordem; calcular versão; gravar arquivo de versão, milestone e changelog; enviar release e preparar candidata.
Validações
Épico sem-release vai a develop e ao fluxo sem release; artefatos novos não chegam a develop antes de produção; changelog público gera proposta Wiki.
Alternativas e erros
Conflito é abortado; versão manual incoerente exige confirmação; Wiki com mudança concorrente precisa de nova proposta.
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: Integrar épicos, bugs ou dependências em uma release coerente com SemVer e registrar changelog versionado. 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.
integrar-release.sh
candidata-preparar.sh
Cenários e rastreabilidade
.bigbang/tests/test_integrar_publicar.py:test_epico_vira_release_a_partir_da_main.bigbang/tests/test_integrar_publicar.py:test_primeira_release_sem_nenhuma_tag.bigbang/tests/test_integrar_publicar.py:test_versao_informada_diferente_exige_confirmacao.bigbang/tests/test_integrar_publicar.py:test_epico_incompleto.bigbang/tests/test_integrar_publicar.py:test_dependencia_nao_publicada.bigbang/tests/test_integrar_publicar.py:test_varios_epicos_numa_release_mesmo_dependentes.bigbang/tests/test_integrar_publicar.py:test_sprint_pega_os_epicos_em_andamento.bigbang/tests/test_integrar_publicar.py:test_sem_release_nao_entra_numa_release_de_varios.bigbang/tests/test_integrar_publicar.py:test_epico_sem_release_vai_para_a_develop.bigbang/tests/test_integrar_publicar.py:test_sem_release_que_muda_o_artefato_e_recusado.bigbang/tests/test_integrar_publicar.py:test_conflito_marca_o_epico.bigbang/tests/test_integrar_publicar.py:test_bug_sobe_o_ultimo_numero.bigbang/tests/test_integrar_publicar.py:test_varios_bugs_numa_release.bigbang/tests/test_integrar_publicar.py:test_simular_nao_envia.bigbang/tests/test_integrar_publicar.py:test_devolve_para_develop_e_epicos_e_marca_conflito.bigbang/tests/test_integrar_publicar.py:test_branch_apagada_depois_do_ultimo_fetch_e_ignorada.bigbang/tests/test_integrar_publicar.py:test_avanca_a_main_e_conclui_o_epico.bigbang/tests/test_integrar_publicar.py:test_recusa_com_artefato_ou_ci_vermelha.bigbang/tests/test_integrar_publicar.py:test_simular.bigbang/tests/test_integrar_publicar.py:test_encerrar_sprint_mantem_os_cartoes.bigbang/tests/test_integrar_publicar.py:test_encerrar_versao_exige_publicacao.bigbang/tests/test_integrar_publicar.py:test_encerrar_versao_limpa_com_travas.bigbang/tests/test_integrar_publicar.py:test_ver_paineis
Requisitos · Matriz de rastreabilidade · Referência CLI