# Funções e permissões

Funções por projeto com cinco níveis em catorze seções, que recortam o acesso sem nunca acrescentar permissões.

Fonte: https://ardumaker.com/pt/docs/roles-y-permisos/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Ser manager do projeto para criar e atribuir funções
- Ferramentas MCP (Só leem): `listar_miembros_proyecto`, `ver_proyecto`, `ver_contexto_inicial`

## O que permite fazer?

| Nível | O que permite |
| --- | --- |
| `ninguno` | Não vê a seção |
| `ver` | Lê, não toca |
| `aportar` | Cria, e edita ou apaga só o seu |
| `editar` | Modifica o de qualquer um, sem apagar |
| `borrar` | Controlo total da seção |

As seções configuráveis são: `proyecto`, `etapas`, `tareas`, `comentarios`, `adjuntos`, `calendario`, `grabaciones`, `miembros`, `recursos`, `github`, `logs`, `papelera`, `finanzas` e `finanzas_balance`. Ler e assinar regulamentos não se configura: nunca é negado a ninguém.

## Quando convém usar?

- Para juntar um cliente que comente e envie arquivos sem poder apagar o trabalho alheio.
- Para que um colaborador veja só a sua parte das finanças.

## Como funciona na ArduMaker?

- Cada projeto nasce com 14 funções com permissões completas (`Client`, `Manager`, `Developer`, `DevOps`, `QA / Tester` e outras). Não se podem apagar, mas podem ser editadas; o manager cria as suas.
- Uma função **recorta** o acesso de alguém: nunca acrescenta permissões. Um membro sem função atribuída pode tudo.
- Dentro do projeto manda a função do projeto, mesmo que a pessoa seja admin da empresa. Só o admin de sistema fica acima.
- É manager quem tem uma função de manager, quem criou o projeto, um admin de uma empresa associada ou o admin de sistema. O manager administra funções e regulamentos, mas a sua própria função também o limita nas seções.
- Uma seção nova que uma função não tem escrita resolve-se com o seu nível para seções futuras.

## O que muda realmente?

- Mudar a função de um membro muda as permissões e os regulamentos que deve assinar, e fica no histórico.
- O detalhe do projeto omite os campos das seções que a pessoa não pode ver.

## Esquema

**Como se decide uma permissão**

```text
Acesso base (membro, admin ou member de empresa associada)
  ↓
Função do projeto (recorta por seção)
  ↓
Regulamento pendente (trava a entrada até assinar)
  ↓
Permissão efetiva (mis_permisos no detalhe)
```

## Resultado esperado

Cada pessoa vê no detalhe do projeto as permissões efetivas por seção e se é manager, para que a interface mostre só o que pode fazer.

## Erros e resolução

- Um erro do tipo `permiso_de_rol` significa que a função não chega para essa seção.
- Um erro do tipo `politica_pendiente` significa que falta assinar um regulamento.
- `Only the project manager can change a member's role`: só o manager reatribui funções.

> **PRECAUCION:** Uma função criada manualmente tem, por defeito, nível `ver` para seções futuras: ao ativar uma seção nova, como finanças, convém rever o que cada função vê.

## Relação com MCP

Um agente MCP atua com as permissões do dono, recortadas pelo âmbito que lhe foi dado. Pode ler membros e permissões, mas **nunca** junta ou remove membros, muda funções nem cria, edita ou apaga funções.

- `listar_miembros_proyecto`: membros e a sua função.
- `ver_proyecto`: inclui o bloco `permisos`.
- `ver_contexto_inicial`: âmbito do agente e operações que nenhum agente pode fazer.

Ver também [permissões MCP](https://ardumaker.com/pt/docs/permisos-mcp) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Empresas](https://ardumaker.com/pt/docs/empresas/)
- [Modelos de projeto](https://ardumaker.com/pt/docs/plantillas/)
- [Assinatura de documentos](https://ardumaker.com/pt/docs/firma-de-documentos/)
- [Gestão económica](https://ardumaker.com/pt/docs/gestion-economica/)
- [Permissões do agente MCP](https://ardumaker.com/pt/docs/permisos-mcp/)
- [Gestão de membros](https://ardumaker.com/pt/docs/gestion-de-miembros/)