# Assinatura de documentos

Regulamentos de projeto e documentos assinados com nome e rubrica, com versões imutáveis e PDF verificável.

Fonte: https://ardumaker.com/pt/docs/firma-de-documentos/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Uma conta ArduMaker; Para publicar regulamentos de um projeto: ser o seu manager
- Ferramentas MCP: Sem ferramentas MCP: usa-se a partir do painel.

## O que permite fazer?

- Permitir que o manager de um projeto publique **regulamentos** (PDF ou texto) que é preciso assinar para entrar, por função ou para todos.
- Assinar escrevendo o nome completo e, nos documentos, com uma rubrica guardada.
- Ver o que está pendente e transferir o PDF do que já foi assinado.
- Validar qualquer PDF assinado, sem conta, para saber se está intacto e quem assinou o quê.

| Âmbito | Quem o pede |
| --- | --- |
| `plataforma` | ArduMaker aos seus usuários (termos, privacidade) |
| `empresa` | Uma empresa aos seus membros |
| `proyecto` | Um projeto aos seus membros |

## Quando convém usar?

- Para que ninguém entre em um projeto de cliente sem aceitar as suas normas.
- Para ter um papel assinado que um terceiro possa verificar.

## Como funciona na ArduMaker?

### Regulamentos de projeto

- Uma versão é imutável e leva o seu `sha256`. Mudar o regulamento publica uma versão nova.
- Uma versão nova pede nova assinatura salvo se o manager indicar que foi uma mudança menor.
- Por defeito aplica-se só a quem entra depois da criação; pode estender-se aos membros atuais. Nunca se aplica ao manager.
- Quem não assinou não entra no projeto, mas pode sempre ler o regulamento, assiná-lo ou sair do projeto.
- Se o regulamento for um PDF, a ArduMaker tenta prepará-lo para assinatura com a ferramenta de assinatura; se não conseguir, publica-se na mesma e a assinatura fica registrada sem PDF.

### Documentos assinados

- Assinar deixa um PDF com a rubrica, a data, o usuário e um histórico interno que permite verificá-lo depois.
- Modo `individual`: cada pessoa assina a sua cópia. Modo `conjunto`: um só arquivo com vários signatários.
- Cada documento decide se **bloqueia** ou só **avisa**; por defeito avisa.
- Os documentos de plataforma e empresa são publicados pela ArduMaker a partir da sua administração.

## O que muda realmente?

- Assinar guarda a assinatura (com IP e navegador) associada à versão exata assinada.
- Uma assinatura nunca se apaga: nem ao desativar o regulamento, nem ao mudar de função, nem ao sair do projeto.
- Apagar um regulamento desativa-o; as assinaturas continuam guardadas.
- Validar um PDF não o guarda.

## Esquema

**Entrar em um projeto com regulamento**

```text
Membro novo (com uma função abrangida)
  ↓
Regulamento pendente (ler, assinar ou sair)
  ↓
Assinatura (nome escrito + versão exata)
  ↓
Projeto aberto (segundo a função)
```

## Resultado esperado

A pessoa entra no projeto e a assinatura aparece no livro de assinaturas do regulamento, que só o manager vê. Se houve PDF, fica disponível para transferir a partir dos assinados.

## Erros e resolução

- Um erro com tipo `politica_pendiente` indica que há um regulamento por assinar antes de continuar.
- Nos documentos, assinar duas vezes a mesma versão é rejeitado; em um regulamento de projeto, repetir a assinatura devolve a que já existia.
- A validação pública aceita arquivos até 20 MB e 10 pedidos por minuto por IP.
- Validar um PDF alterado não é um erro: a resposta diz que não está intacto e lista os problemas.

> **PRECAUCION:** Um regulamento com âmbito por funções precisa de pelo menos uma função escolhida; aplicá-lo aos membros atuais trava de imediato quem não assinou.

## Relação com MCP

Não há acesso MCP. Nenhum agente pode criar, editar ou apagar um regulamento, nem assinar um: assinar é um ato pessoal.

Referência completa de cada ferramenta: [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Modelos de projeto](https://ardumaker.com/pt/docs/plantillas/)
- [Empresas](https://ardumaker.com/pt/docs/empresas/)
- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)