> ## Documentation Index
> Fetch the complete documentation index at: https://reduardo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitácora (Log)

> Registro de auditoría de acciones del administrador

# Bitácora de Acciones (Log)

El sistema registra automáticamente todas las acciones realizadas por los administradores en una tabla de logs para fines de auditoría y trazabilidad.

## Modelo `LogModel`

```php theme={null}
class LogModel
{
    // Registrar una acción
    public function registrar(int $userId, string $userName, string $accion, string $detalle): bool;

    // Obtener logs paginados
    public function obtenerPaginado(int $pagina, int $porPagina): array;

    // Contar total de logs
    public function contarTotal(): int;
}
```

## Registro Automático

Las acciones se registran desde los controladores usando un método helper:

```php theme={null}
private function registrarLog(string $accion, string $detalle): void
{
    $logModel = new LogModel();
    $logModel->registrar(
        $_SESSION['admin']['id'],
        $_SESSION['admin']['nombre_completo'],
        $accion,
        $detalle
    );
}
```

## Acciones Registradas

| Acción | Detalle de ejemplo |
| - | - |
| Inicio de sesión | Usuario: admin |
| Cierre de sesión | Usuario: admin |
| Crear producto | SKU: SKU-001, Nombre: Laptop HP |
| Actualizar producto | ID: 1, SKU: SKU-001, Nombre: Laptop HP |
| Eliminar producto | ID: 1, SKU: SKU-001, Nombre: Laptop HP |

## Vista de Bitácora

La vista en `/logs` muestra los registros en una tabla con **badges de colores** por tipo de acción:

| Color | Acción |
| - | - |
| Verde | Crear |
| Azul | Actualizar |
| Rojo | Eliminar |
| Celeste | Inicio de sesión |
| Amarillo | Cierre de sesión |

La vista está paginada a **15 registros por página** y solo es accesible para administradores autenticados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.