# Etapas

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

Fonte: https://ardumaker.com/pt/docs/etapas/

- 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](https://ardumaker.com/pt/docs/gestion-economica).

## 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](https://ardumaker.com/pt/mcp/proyectos) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Dependências](https://ardumaker.com/pt/docs/dependencias/)
- [Checklists](https://ardumaker.com/pt/docs/checklists/)
- [Lixo](https://ardumaker.com/pt/docs/papelera/)