# Auditoria de ações

O histórico de cada projeto: quem criou, editou, apagou, restaurou ou purgou o quê e quando, pessoas e agentes MCP.

Fonte: https://ardumaker.com/pt/docs/auditoria-de-acciones/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Acesso de leitura à seção Histórico (`logs`) do projeto
- Ferramentas MCP (Só leem): `ver_logs_proyecto`, `listar_papelera`, `ver_papelera`
- Ferramentas MCP (Escrevem ou modificam): `restaurar_papelera`

## O que permite fazer?

Cada projeto guarda um registro do que acontece lá dentro: quem fez o quê e quando. Abrange o projeto, etapas, tarefas, checklist, comentários, membros, recursos vinculados, pastas e anexos com os seus comentários, reuniões do projeto e repos do GitHub vinculados.

| Tipo | O que registra |
| --- | --- |
| `CREATE` | Criação |
| `UPDATE` | Edição |
| `DELETE` | Apagamento lógico: vai para a lixeira e pode ser desfeito |
| `RESTORE` | Restauro a partir da lixeira |
| `PURGE` | Apagamento definitivo |
| `VIEW` | Última visita de cada pessoa |

## Quando convém usar?

- Para saber quem mudou uma tarefa ou apagou um anexo.
- Para rever o que um agente MCP fez em nome do dono.
- Para encontrar o que restaurar a partir da [lixeira](https://ardumaker.com/pt/docs/papelera).

## Como funciona na ArduMaker?

- As entradas listam-se da mais recente para a mais antiga, até 500 por consulta (100 por defeito).
- As visitas não acumulam uma linha por cada vez: atualiza-se a última visita dessa pessoa nesse projeto.
- Se a ação foi feita por um agente MCP, a entrada identifica-o e diz de quem é.
- Os commits do GitHub não geram entradas: o commit já guarda autor e data.

## O que muda realmente?

- O histórico vive enquanto o projeto vive: apagar o projeto (lógico) não o perde.
- Ao purgar um projeto definitivamente, o histórico vai com ele e fica só um registro permanente da purga, sem vínculo ao projeto.

## Resultado esperado

Cada entrada traz usuário, foto de perfil, descrição da ação, tipo, data e, quando aplicável, os dados do agente.

## Erros e resolução

- Sem nível suficiente na seção `logs`, o histórico não é mostrado.
- Um apagamento (`DELETE`) ainda pode ser desfeito; uma purga (`PURGE`) não.

## Relação com MCP

- `ver_logs_proyecto`: histórico com filtro opcional por tipo e `limit` (até 500).
- `listar_papelera` e `ver_papelera`: o que foi apagado, por quem e o que cada apagamento arrastou.
- `restaurar_papelera`: desfaz um apagamento (modifica, não destrói).

O que os agentes fazem também fica na sua própria [auditoria](https://ardumaker.com/pt/docs/auditoria-de-agentes). Referência: [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Lixo](https://ardumaker.com/pt/docs/papelera/)
- [Auditoria de agentes](https://ardumaker.com/pt/docs/auditoria-de-agentes/)
- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)