# Projetos e quadro kanban

Projetos com etapas e tarefas em um quadro de seis colunas, avanço calculado e apagamento reversível.

Fonte: https://ardumaker.com/pt/docs/proyectos-kanban/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Uma conta ArduMaker; Para associar empresas ao criar: ser admin dessas empresas
- Ferramentas MCP (Só leem): `listar_proyectos`, `ver_proyecto`, `buscar_en_proyecto`, `listar_proyectos_eliminados`
- Ferramentas MCP (Escrevem ou modificam): `crear_proyecto`, `crear_proyecto_con_etapas`, `editar_proyecto`

## O que permite fazer?

Um projeto agrupa etapas e tarefas, com membros, funções, anexos, calendário e recursos vinculados. Etapas e tarefas são mostradas em um quadro tipo kanban.

| Coluna | Como se chega |
| --- | --- |
| `backlog` | Automática com avanço 0 |
| `listo` | Só movendo o cartão manualmente |
| `en_curso` | Automática com avanço entre 1 e 99 |
| `en_revision` | Só manualmente |
| `testing` | Só manualmente |
| `hecho` | Automática com avanço 100 |

## Quando convém usar?

- Para organizar o trabalho de um cliente ou produto em etapas e tarefas.
- Para dar a um agente de IA um lugar onde ler e atualizar o estado do trabalho.
- Para arquivar um projeto terminado sem o apagar.

## Como funciona na ArduMaker?

1. Ao criar o projeto, a ArduMaker semeia 14 funções com permissões completas, adiciona quem o cria com a função `Manager` e cria "Etapa 1" com "Tarea 1" para que não comece vazio.
2. Se forem associadas empresas, é preciso ser admin de cada uma. Por defeito aplica-se o [modelo](https://ardumaker.com/pt/docs/plantillas) marcado como predefinido de cada empresa.
3. O avanço sobe de baixo para cima: o de uma tarefa é manual ou vem da checklist; o de uma etapa é a média das tarefas; o do projeto, a média das etapas.
4. Enquanto ninguém mover um cartão, a coluna deduz-se do avanço. Movê-lo manualmente fixa-o; voltar a `auto` devolve-o ao cálculo.

O estado do projeto é `active` ou `archived`. Arquivar retira-o da lista por defeito sem apagar nada.

## O que muda realmente?

- Criar um projeto cria as funções, a pertença do criador, uma etapa e uma tarefa.
- Todo o apagamento é lógico: o projeto, uma etapa ou uma tarefa vão para a lixeira 30 dias e podem ser restaurados por inteiro.
- Cada criação, edição ou apagamento fica no [histórico do projeto](https://ardumaker.com/pt/docs/auditoria-de-acciones).

## Esquema

**Como sobe o avanço**

```text
Checklist (itens feitos / total)
  ↓
Tarefa (avanço 0-100)
  ↓
Etapa (média das tarefas)
  ↓
Projeto (média das etapas)
```

A coluna do quadro deduz-se desse avanço salvo se alguém mover o cartão.

## Resultado esperado

O projeto fica visível para os membros e para os membros e admins das empresas associadas, cada um com o que a sua [função](https://ardumaker.com/pt/docs/roles-y-permisos) permite.

## Erros e resolução

| Mensagem | Causa |
| --- | --- |
| `nombre is required` | O nome chegou vazio. |
| `Template not found` | O modelo pedido não existe ou está desativado. |
| `That template belongs to a company that is not part of this project` | Escolheu-se um modelo de uma empresa não associada. |

Se o modelo falhar, o projeto já ficou criado: o modelo aplica-se depois e fora da criação.

## Relação com MCP

Um agente MCP lista, cria e edita projetos dentro do âmbito que o dono lhe deu. **Nunca pode apagar um projeto inteiro.**

- Leitura: `listar_proyectos`, `ver_proyecto`, `buscar_en_proyecto`, `listar_proyectos_eliminados`.
- Escrita: `crear_proyecto` (aceita `plantilla_id`), `crear_proyecto_con_etapas` e `editar_proyecto` (inclui arquivar).
- `crear_proyecto_con_etapas` cria o projeto e as etapas em uma chamada; se as etapas falharem, o projeto fica criado e a resposta informa-o em `residuo`.

> **INFO:** As ferramentas de criação aceitam `idempotency_key`: se uma chamada for cortada, repete-se com a mesma chave sem duplicar o projeto.

Mais em [/mcp/proyectos](https://ardumaker.com/pt/mcp/proyectos) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Etapas](https://ardumaker.com/pt/docs/etapas/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Modelos de projeto](https://ardumaker.com/pt/docs/plantillas/)
- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Calendário de projeto](https://ardumaker.com/pt/docs/calendario-de-proyecto/)
- [Lixo](https://ardumaker.com/pt/docs/papelera/)