# Proyectos y tablero kanban

Proyectos con etapas y tareas en un tablero de seis columnas, avance calculado y borrado reversible.

Fuente: https://ardumaker.com/docs/proyectos-kanban/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Una cuenta de ArduMaker; Para asociar empresas al crear: ser admin de esas empresas
- Herramientas MCP (Solo leen): `listar_proyectos`, `ver_proyecto`, `buscar_en_proyecto`, `listar_proyectos_eliminados`
- Herramientas MCP (Escriben o modifican): `crear_proyecto`, `crear_proyecto_con_etapas`, `editar_proyecto`

## ¿Qué permite hacer?

Un proyecto agrupa etapas y tareas, con miembros, roles, adjuntos, calendario y recursos vinculados. Etapas y tareas se ven en un tablero tipo kanban.

| Columna | Cómo se llega |
| --- | --- |
| `backlog` | Automática con avance 0 |
| `listo` | Solo moviendo la tarjeta a mano |
| `en_curso` | Automática con avance entre 1 y 99 |
| `en_revision` | Solo a mano |
| `testing` | Solo a mano |
| `hecho` | Automática con avance 100 |

## ¿Cuándo conviene usarlo?

- Para ordenar el trabajo de un cliente o de un producto en etapas y tareas.
- Para darle a un agente de IA un lugar donde leer y actualizar el estado del trabajo.
- Para archivar un proyecto terminado sin borrarlo.

## ¿Cómo funciona en ArduMaker?

1. Al crear el proyecto, ArduMaker siembra 14 roles con permisos completos, agrega a quien lo crea con el rol `Manager` y crea "Etapa 1" con "Tarea 1" para que no arranque vacío.
2. Si se asocian empresas, hay que ser admin de cada una. Por defecto se aplica la [plantilla](https://ardumaker.com/docs/plantillas) marcada como predeterminada de cada empresa.
3. El avance sube de abajo hacia arriba: el de una tarea es manual o sale de su checklist; el de una etapa es el promedio de sus tareas; el del proyecto, el promedio de sus etapas.
4. Mientras nadie mueva una tarjeta, su columna se deduce del avance. Moverla a mano la fija; volver a `auto` la devuelve al cálculo.

El estado del proyecto es `active` o `archived`. Archivar lo saca del listado por defecto sin borrar nada.

## ¿Qué cambia realmente?

- Crear un proyecto crea sus roles, la membresía del creador, una etapa y una tarea.
- Todo borrado es lógico: el proyecto, una etapa o una tarea van a la papelera 30 días y se pueden restaurar enteros.
- Cada creación, edición o borrado queda en el [historial del proyecto](https://ardumaker.com/docs/auditoria-de-acciones).

## Esquema

**Cómo sube el avance**

```text
Checklist (ítems hechos / total)
  ↓
Tarea (avance 0-100)
  ↓
Etapa (promedio de sus tareas)
  ↓
Proyecto (promedio de sus etapas)
```

La columna del tablero se deduce de ese avance salvo que alguien mueva la tarjeta.

## Resultado esperado

El proyecto queda visible para sus miembros y para los miembros y admins de las empresas asociadas, cada uno con lo que su [rol](https://ardumaker.com/docs/roles-y-permisos) le permite.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `nombre is required` | El nombre llegó vacío. |
| `Template not found` | La plantilla pedida no existe o está desactivada. |
| `That template belongs to a company that is not part of this project` | Se eligió una plantilla de una empresa no asociada. |

Si falla la plantilla, el proyecto ya quedó creado: la plantilla se aplica después y fuera de la creación.

## Relación con MCP

Un agente MCP lista, crea y edita proyectos dentro del alcance que le dio su dueño. **Nunca puede borrar un proyecto entero.**

- Lectura: `listar_proyectos`, `ver_proyecto`, `buscar_en_proyecto`, `listar_proyectos_eliminados`.
- Escritura: `crear_proyecto` (acepta `plantilla_id`), `crear_proyecto_con_etapas` y `editar_proyecto` (incluye archivar).
- `crear_proyecto_con_etapas` crea el proyecto y sus etapas en una llamada; si fallan las etapas, el proyecto queda creado y la respuesta lo informa en `residuo`.

> **INFO:** Las herramientas de creación aceptan `idempotency_key`: si una llamada se corta, se reintenta con la misma clave sin duplicar el proyecto.

Más en [/mcp/proyectos](https://ardumaker.com/mcp/proyectos) y [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Etapas](https://ardumaker.com/docs/etapas/)
- [Tareas](https://ardumaker.com/docs/tareas/)
- [Plantillas de proyecto](https://ardumaker.com/docs/plantillas/)
- [Roles y permisos](https://ardumaker.com/docs/roles-y-permisos/)
- [Calendario de proyecto](https://ardumaker.com/docs/calendario-de-proyecto/)
- [Papelera](https://ardumaker.com/docs/papelera/)