Etapas

Fases que agrupam tarefas, com ordem, dependências, coluna no quadro e avanço médio.

Categoria: Projetos e empresas
Estado: Disponível
Requisitos: Um projeto com acesso; Para criar ou editar: nível suficiente na seção Etapas
Ferramentas MCP (Só leem): listar_etapas, ver_etapa
Ferramentas MCP (Escrevem ou modificam): crear_etapa, editar_etapa, eliminar_etapa, editar_etapas_en_lote

O que permite fazer?

Uma etapa agrupa tarefas de um projeto: uma fase, uma entrega ou um sprint. Tem nome, descrição, ordem, dependências e a sua própria coluna no quadro.

Criar, renomear, reordenar e apagar etapas.
Marcar de que outras etapas depende.
Movê-la entre colunas do quadro.
Dar-lhe um slug próprio, único no projeto entre etapas, tarefas e anexos.

Quando convém usar?

Para dividir um projeto em fases com um avanço que se possa seguir.
Para associar um pagamento a uma entrega a partir da gestão económica.

Como funciona na ArduMaker?

O avanço de uma etapa é a média simples do avanço das tarefas.
Se ninguém marcou dependências manualmente, o quadro deduz-as das tarefas: se uma tarefa desta etapa depende de outra de outra etapa, esta etapa espera por aquela.
Uma dependência que criaria um ciclo é rejeitada.
Apagar uma etapa leva as tarefas, checklists e comentários para a lixeira como uma só entrada.

O que muda realmente?

Criar ou editar uma etapa escreve uma linha no histórico do projeto.
Apagá-la é reversível durante 30 dias a partir da lixeira.

Resultado esperado

A etapa aparece no quadro com o seu avanço, a sua coluna e a marca puede_completarse, que é verdadeira quando todas as dependências estão a 100%.

Erros e resolução

Mensagem	Causa
`Adding '<etapa>' as a dependency would create a cycle`	A dependência fecharia um círculo entre etapas.

Se uma etapa foi apagada por engano, restaura-se a partir da lixeira; as tarefas voltam com ela.

Relação com MCP

Leitura: listar_etapas (paginado, filtra por coluna) e ver_etapa (inclui as tarefas e o bloco permisos).
Escrita: crear_etapa, editar_etapa e editar_etapas_en_lote (até 100 elementos por chamada, cada um com o seu resultado).
eliminar_etapa é reversível: devolve um operacion_id para restaurar_papelera.

Mais em /mcp/proyectos e /mcp/docs.