Etapas

Fases que agrupan tareas, con orden, dependencias, columna en el tablero y avance promedio.

Categoría: Proyectos y empresas
Estado: Disponible
Requisitos: Un proyecto con acceso; Para crear o editar: nivel suficiente en la sección Etapas
Herramientas MCP (Solo leen): listar_etapas, ver_etapa
Herramientas MCP (Escriben o modifican): crear_etapa, editar_etapa, eliminar_etapa, editar_etapas_en_lote

¿Qué permite hacer?

Una etapa agrupa tareas de un proyecto: una fase, un entregable o un sprint. Tiene nombre, descripción, orden, dependencias y su propia columna en el tablero.

Crear, renombrar, reordenar y borrar etapas.
Marcar de qué otras etapas depende.
Moverla entre columnas del tablero.
Darle un slug propio, único en el proyecto entre etapas, tareas y adjuntos.

¿Cuándo conviene usarlo?

Para dividir un proyecto en fases con un avance que se pueda seguir.
Para atar un pago a un entregable desde la gestión económica.

¿Cómo funciona en ArduMaker?

El avance de una etapa es el promedio simple del avance de sus tareas.
Si nadie marcó dependencias a mano, el tablero las deduce de las tareas: si una tarea de esta etapa depende de otra de otra etapa, esta etapa espera a aquella.
Una dependencia que armaría un ciclo se rechaza.
Borrar una etapa se lleva sus tareas, checklists y comentarios a la papelera como una sola entrada.

¿Qué cambia realmente?

Crear o editar una etapa escribe una línea en el historial del proyecto.
Borrarla es reversible durante 30 días desde la papelera.

Resultado esperado

La etapa aparece en el tablero con su avance, su columna y la marca puede_completarse, que es verdadera cuando todas sus dependencias están al 100%.

Errores y resolución

Mensaje	Causa
`Adding '<etapa>' as a dependency would create a cycle`	La dependencia cerraría un círculo entre etapas.

Si se borró una etapa por error, se restaura desde la papelera; sus tareas vuelven con ella.

Relación con MCP

Lectura: listar_etapas (paginado, filtra por columna) y ver_etapa (incluye sus tareas y el bloque permisos).
Escritura: crear_etapa, editar_etapa y editar_etapas_en_lote (hasta 100 elementos por llamada, cada uno con su resultado).
eliminar_etapa es reversible: devuelve un operacion_id para restaurar_papelera.

Más en /mcp/proyectos y /mcp/docs.