Admin - Dashboard Global
Requiere rol global_admin. Métricas y estadísticas globales del sistema para el panel de administración.
GET /api/global-dashboard/stats/time-range
Obtiene métricas globales del sistema en un rango temporal (todos los clientes).
GET
/api/global-dashboard/stats/time-rangeHeaders
Authorization: Bearer JWT_TOKENQuery Parameters
start_date: (obligatorio) Fecha inicio YYYY-MM-DDend_date: (obligatorio) Fecha fin YYYY-MM-DDgranularity: (opcional) Granularidad: dia, semana, mes. Por defecto: dia
Ejemplos
curl -X GET "https://api-docmind.devol.es/api/global-dashboard/stats/time-range?start_date=2025-01-01&end_date=2025-06-30&granularity=mes" \
-H "Authorization: Bearer JWT_TOKEN"Respuesta
{
"data": [
{"periodo": "2025-01", "total": 1200, "completadas": 1100, "errores": 30, "clientes_activos": 15},
{"periodo": "2025-02", "total": 1500, "completadas": 1400, "errores": 25, "clientes_activos": 18}
],
"totals": {"total": 8500, "completadas": 8000, "errores": 150}
}Métricas agregadas de todos los clientes por período.
Errores
400Bad RequestFechas inválidas.
{"error": "Formato de fecha inválido"}403ForbiddenRequiere global_admin.
{"msg": "Acceso denegado"}GET /api/global-dashboard/stats/{client_id}/time-range
Obtiene métricas de un cliente específico en un rango temporal.
GET
/api/global-dashboard/stats/{client_id}/time-rangeHeaders
Authorization: Bearer JWT_TOKENQuery Parameters
start_date: (obligatorio) Fecha inicio YYYY-MM-DDend_date: (obligatorio) Fecha fin YYYY-MM-DD
Ejemplos
curl -X GET "https://api-docmind.devol.es/api/global-dashboard/stats/CLIENT_ID/time-range?start_date=2025-01-01&end_date=2025-06-30" \
-H "Authorization: Bearer JWT_TOKEN"Respuesta
{
"client": {"id": "uuid", "nombre": "Empresa A"},
"data": [{"periodo": "2025-01", "total": 200, "completadas": 190}],
"totals": {"total": 1200, "completadas": 1150}
}Métricas del cliente especificado con desglose temporal.
Errores
400Bad RequestFechas inválidas.
{"error": "Formato de fecha inválido"}403ForbiddenRequiere global_admin.
{"msg": "Acceso denegado"}404Not FoundCliente no encontrado.
{"error": "Cliente no encontrado"}