# Auditoría de acciones

El historial de cada proyecto: quién creó, editó, borró, restauró o purgó qué y cuándo, personas y agentes MCP.

Fuente: https://ardumaker.com/docs/auditoria-de-acciones/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Acceso de lectura a la sección Historial (`logs`) del proyecto
- Herramientas MCP (Solo leen): `ver_logs_proyecto`, `listar_papelera`, `ver_papelera`
- Herramientas MCP (Escriben o modifican): `restaurar_papelera`

## ¿Qué permite hacer?

Cada proyecto lleva un registro de lo que pasa adentro: quién hizo qué y cuándo. Cubre el proyecto, etapas, tareas, checklist, comentarios, miembros, recursos vinculados, carpetas y adjuntos con sus comentarios, reuniones del proyecto y repos de GitHub vinculados.

| Tipo | Qué registra |
| --- | --- |
| `CREATE` | Creación |
| `UPDATE` | Edición |
| `DELETE` | Borrado lógico: va a la papelera y se puede deshacer |
| `RESTORE` | Restauración desde la papelera |
| `PURGE` | Borrado definitivo |
| `VIEW` | Última visita de cada persona |

## ¿Cuándo conviene usarlo?

- Para saber quién cambió una tarea o borró un adjunto.
- Para revisar qué hizo un agente MCP en nombre de su dueño.
- Para encontrar qué restaurar desde la [papelera](https://ardumaker.com/docs/papelera).

## ¿Cómo funciona en ArduMaker?

- Las entradas se listan de la más reciente a la más vieja, con un tope de 500 por consulta (100 por defecto).
- Las visitas no acumulan una fila por cada vez: se actualiza la última visita de esa persona en ese proyecto.
- Si la acción la hizo un agente MCP, la entrada lo identifica y dice de quién es.
- Los commits de GitHub no generan entradas: el commit ya guarda autor y fecha.

## ¿Qué cambia realmente?

- El historial vive mientras vive el proyecto: borrar el proyecto (lógico) no lo pierde.
- Al purgar un proyecto definitivamente, su historial se va con él y queda solo un registro permanente de la purga, sin vínculo al proyecto.

## Resultado esperado

Cada entrada trae usuario, foto de perfil, descripción de la acción, tipo, fecha y, si corresponde, los datos del agente.

## Errores y resolución

- Sin nivel suficiente en la sección `logs`, el historial no se muestra.
- Un borrado (`DELETE`) todavía se puede deshacer; una purga (`PURGE`) no.

## Relación con MCP

- `ver_logs_proyecto`: historial con filtro opcional por tipo y `limit` (hasta 500).
- `listar_papelera` y `ver_papelera`: qué se borró, quién y qué arrastró cada borrado.
- `restaurar_papelera`: deshace un borrado (modifica, no destruye).

Lo que hacen los agentes también queda en su propia [auditoría](https://ardumaker.com/docs/auditoria-de-agentes). Referencia: [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Papelera](https://ardumaker.com/docs/papelera/)
- [Auditoría de agentes](https://ardumaker.com/docs/auditoria-de-agentes/)
- [Roles y permisos](https://ardumaker.com/docs/roles-y-permisos/)
- [Proyectos y tablero kanban](https://ardumaker.com/docs/proyectos-kanban/)