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.

  • 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

Markdown

¿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.

TipoQué registra
CREATECreación
UPDATEEdición
DELETEBorrado lógico: va a la papelera y se puede deshacer
RESTORERestauración desde la papelera
PURGEBorrado 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.

¿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. Referencia: /mcp/docs.

Funciones relacionadas