# Modelos de projeto

O molde de uma empresa para os seus projetos: funções, regulamentos, pastas e notas copiados ao criar cada um.

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

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Ser admin da empresa para criar ou editar modelos; Para aplicá-lo: a empresa tem de estar associada ao projeto
- Ferramentas MCP (Escrevem ou modificam): `crear_proyecto`, `crear_proyecto_con_etapas`

## O que permite fazer?

Um modelo é o molde com que arrancam os projetos de uma empresa. Pode ter:

- Funções com as permissões por seção já recortadas.
- Regulamentos (PDF ou texto) que é preciso assinar para entrar.
- Pastas e notas, links ou arquivos de base.

Uma empresa pode ter vários modelos e marcar um como predefinido.

## Quando convém usar?

- Quando a empresa monta projetos parecidos e repete sempre as mesmas funções e regulamentos.
- Para não se esquecer de fechar uma seção a uma função, como a de cliente.

## Como funciona na ArduMaker?

1. Um modelo novo arranca com as mesmas 14 funções que um projeto novo, com permissões completas, para recortar em vez de escrever do zero.
2. Ao criar um projeto aplica-se o modelo escolhido ou, se não se escolher, o predefinido de cada empresa associada. Também se pode criar sem modelo.
3. Ao juntar uma empresa a um projeto existente aplica-se o modelo predefinido, sem substituir as funções que o projeto já tem.

> **INFO:** O que se aplica é uma **cópia**: depois de aplicado, o projeto não guarda vínculo ao modelo. Alterá-lo não afeta os projetos que já arrancaram.

- Aplica-se em uma transação: entra por inteiro ou não entra.
- É idempotente por nome: aplicá-lo duas vezes completa o que falta sem duplicar.
- Os arquivos (PDF de regulamentos, anexos) são copiados, não compartilhados.

## O que muda realmente?

- No projeto: funções, regulamentos com a versão 1, pastas e anexos novos.
- Uma linha no histórico com o nome do modelo aplicado.
- Apagar um modelo desativa-o; não é eliminado.

## Esquema

**Aplicar um modelo**

```text
Modelo da empresa (funções, regulamentos, pastas, notas)
  ↓
Cópia em transação (idempotente por nome)
  ↓
Projeto (com cópias próprias, sem vínculo)
  ↓
Histórico (nome do modelo aplicado)
```

## Resultado esperado

O projeto nasce com as funções, os [regulamentos](https://ardumaker.com/pt/docs/firma-de-documentos) e o material do modelo, e a resposta de criação indica quantos itens de cada tipo deixou.

## Erros e resolução

| Mensagem | Causa |
| --- | --- |
| `Only an admin of this company can manage its project templates` | Quem o edita não é admin da empresa. |
| `Template not found` | Não existe ou está desativado. |
| `That template belongs to a company that is not part of this project` | O modelo é de uma empresa não associada ao projeto. |

Se aplicar o modelo falhar, o projeto fica criado na mesma, sem o modelo.

## Relação com MCP

Um agente MCP não cria nem edita modelos. Usa-os, sim, ao criar projetos:

- `crear_proyecto` aceita `plantilla_id`: `por_defecto` (como o formulário web), um id, ou `null` para não aplicar nenhum.
- `crear_proyecto_con_etapas` aplica sempre o modelo predefinido.

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

## Funcionalidades relacionadas

- [Empresas](https://ardumaker.com/pt/docs/empresas/)
- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Assinatura de documentos](https://ardumaker.com/pt/docs/firma-de-documentos/)
- [Anexos](https://ardumaker.com/pt/docs/archivos-adjuntos/)
- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)