Funcionalidade workflows gerados - BrunodosSantosVaz/big-bang GitHub Wiki
Workflows do sistema
Funcionalidade BB-F-046 · requisito RF-BB-046 · versão documentada 3.0.1 · código 371a61ae5c993f6ba3fde76e77f91e64f0bf9c42.
Finalidade
Orquestrar eventos de CI, sprint, kanban, revisão, entrega, posse e recuperação pelos contratos do framework.
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
Gerar Actions do núcleo e do perfil com parâmetros do projeto; aplicar permissões, concorrência e runners; chamar scripts versionados e manter decisões no Python.
Validações
Fontes dos templates são operacionais e permanecem no repositório; documentação canônica é verificada em CI e produção; ações externas usam SHA fixado.
Alternativas e erros
Configuração ou workflow inválido bloqueia geração/verificação; execução reprovada não move o card para concluído.
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: Orquestrar eventos de CI, sprint, kanban, revisão, entrega, posse e recuperação pelos contratos do framework. 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.
bb-bug.yml
bb-documentacao.yml
bb-epico.yml
bb-fundacao.yml
bb-tarefa.yml
bb-teste-aceite.yml
config.yml
bb-ci.yml
bb-codeql.yml
bb-criar-branches.yml
bb-encerrar.yml
bb-faxina.yml
bb-iniciar-sprint.yml
bb-integrar-release.yml
bb-kanban.yml
bb-mesclar-pr.yml
bb-posses.yml
bb-publicar-sem-release.yml
bb-regras-pr.yml
bb-seguranca.yml
bb-tarefa-de-correcao.yml
bb-ver-paineis.yml
bb-candidata.yml.tmpl
bb-voltar-versao.yml.tmpl
bb-candidata.yml.tmpl
dependabot.yml.tmpl
bb-publicar-producao.yml.tmpl
Cenários e rastreabilidade
.bigbang/tests/test_workflows.py:test_wiki_verification_has_only_read_token_at_its_step.bigbang/tests/test_workflows.py:test_existe_a_ci_do_framework.bigbang/tests/test_workflows.py:test_nome_com_prefixo_bb.bigbang/tests/test_workflows.py:test_actions_fixadas_por_sha_com_versao_em_comentario.bigbang/tests/test_workflows.py:test_runner_em_versao_fixa.bigbang/tests/test_workflows.py:test_permissoes_minimas_no_topo.bigbang/tests/test_workflows.py:test_regras_do_bb_verificar.bigbang/tests/test_workflows.py:test_sem_pull_request_target.bigbang/tests/test_workflows.py:test_concorrencia_sem_cancelar.bigbang/tests/test_workflows.py:test_jobs_do_framework_so_rodam_no_repositorio_do_big_bang.bigbang/tests/test_workflows.py:test_kanban_nao_descarta_eventos_diferentes.bigbang/tests/test_workflows.py:test_regras_julga_com_a_ponta_atual_do_destino.bigbang/tests/test_workflows.py:test_recusa_tag_e_aceita_sha.bigbang/tests/test_workflows.py:test_comentario_de_versao.bigbang/tests/test_workflows.py:test_separa_jobs.bigbang/tests/test_workflows.py:test_nenhum_grep_q_no_fim_de_pipeline
Requisitos · Matriz de rastreabilidade · Referência CLI
Fontes rastreadas
.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-bug.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-documentacao.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-epico.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-fundacao.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-tarefa.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/bb-teste-aceite.yml.bigbang/esteira/nucleo/arquivos/.github/ISSUE_TEMPLATE/config.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-ci.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-codeql.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-criar-branches.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-encerrar.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-faxina.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-iniciar-sprint.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-integrar-release.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-kanban.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-mesclar-pr.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-posses.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-publicar-sem-release.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-regras-pr.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-seguranca.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-tarefa-de-correcao.yml.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-ver-paineis.yml.bigbang/esteira/perfis/deploy/arquivos/.github/workflows/bb-candidata.yml.tmpl.bigbang/esteira/perfis/deploy/arquivos/.github/workflows/bb-voltar-versao.yml.tmpl.bigbang/esteira/perfis/compilado/arquivos/.github/workflows/bb-candidata.yml.tmpl.bigbang/esteira/nucleo/arquivos/.github/dependabot.yml.tmpl.bigbang/esteira/nucleo/arquivos/.github/workflows/bb-publicar-producao.yml.tmpl