# Plantillas de proyecto

El molde de una empresa para sus proyectos: roles, reglamentos, carpetas y notas que se copian al crear cada uno.

Fuente: https://ardumaker.com/docs/plantillas/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Ser admin de la empresa para crear o editar plantillas; Para aplicarla: que la empresa esté asociada al proyecto
- Herramientas MCP (Escriben o modifican): `crear_proyecto`, `crear_proyecto_con_etapas`

## ¿Qué permite hacer?

Una plantilla es el molde con el que arrancan los proyectos de una empresa. Puede tener:

- Roles con sus permisos por sección ya recortados.
- Reglamentos (PDF o texto) que hay que firmar para entrar.
- Carpetas y notas, links o archivos de base.

Una empresa puede tener varias plantillas y marcar una como predeterminada.

## ¿Cuándo conviene usarlo?

- Cuando la empresa arma proyectos parecidos y repite siempre los mismos roles y reglamentos.
- Para no olvidarse de cerrar una sección a un rol, como el de cliente.

## ¿Cómo funciona en ArduMaker?

1. Una plantilla nueva arranca con los mismos 14 roles que un proyecto nuevo, con permisos completos, para recortar en vez de escribir de cero.
2. Al crear un proyecto se aplica la plantilla elegida o, si no se elige, la predeterminada de cada empresa asociada. También se puede crear sin plantilla.
3. Al sumar una empresa a un proyecto existente se aplica su plantilla predeterminada, sin pisar los roles que el proyecto ya tiene.

> **INFO:** Lo que se aplica es una **copia**: después de aplicarla, el proyecto no guarda vínculo con la plantilla. Cambiarla no afecta a los proyectos que ya arrancaron.

- Se aplica en una transacción: entra entera o no entra.
- Es idempotente por nombre: aplicarla dos veces completa lo que falta sin duplicar.
- Los archivos (PDF de reglamentos, adjuntos) se copian, no se comparten.

## ¿Qué cambia realmente?

- En el proyecto: roles, reglamentos con su versión 1, carpetas y adjuntos nuevos.
- Una línea en el historial con el nombre de la plantilla aplicada.
- Borrar una plantilla la desactiva; no se elimina.

## Esquema

**Aplicar una plantilla**

```text
Plantilla de la empresa (roles, reglamentos, carpetas, notas)
  ↓
Copia en transacción (idempotente por nombre)
  ↓
Proyecto (con sus propias copias, sin vínculo)
  ↓
Historial (nombre de la plantilla aplicada)
```

## Resultado esperado

El proyecto nace con los roles, los [reglamentos](https://ardumaker.com/docs/firma-de-documentos) y el material de la plantilla, y la respuesta de creación indica cuántas cosas de cada tipo dejó.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `Only an admin of this company can manage its project templates` | Quien la edita no es admin de la empresa. |
| `Template not found` | No existe o está desactivada. |
| `That template belongs to a company that is not part of this project` | La plantilla es de una empresa no asociada al proyecto. |

Si aplicar la plantilla falla, el proyecto queda creado igual, sin la plantilla.

## Relación con MCP

Un agente MCP no crea ni edita plantillas. Sí las usa al crear proyectos:

- `crear_proyecto` acepta `plantilla_id`: `por_defecto` (como el formulario web), un id, o `null` para no aplicar ninguna.
- `crear_proyecto_con_etapas` aplica siempre la plantilla predeterminada.

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

## Funciones relacionadas

- [Empresas](https://ardumaker.com/docs/empresas/)
- [Roles y permisos](https://ardumaker.com/docs/roles-y-permisos/)
- [Firma de documentos](https://ardumaker.com/docs/firma-de-documentos/)
- [Archivos adjuntos](https://ardumaker.com/docs/archivos-adjuntos/)
- [Proyectos y tablero kanban](https://ardumaker.com/docs/proyectos-kanban/)