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.

  • 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

Markdown

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.

TipoO que registra
CREATECriação
UPDATEEdição
DELETEApagamento lógico: vai para a lixeira e pode ser desfeito
RESTORERestauro a partir da lixeira
PURGEApagamento 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.

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. Referência: /mcp/docs.

Funcionalidades relacionadas