Performance Correlation Analysis

Overview

The correlation analysis system automatically analyzes the relationship between human resource metrics (motivation, satisfaction, training) and hospital performance indicators (patient satisfaction, clinical errors, wait times). It uses AI to generate strategic insights and recommendations.

Authentication

This endpoint requires authentication and admin role only.

Authorization: Bearer YOUR_JWT_TOKEN

Generate Monthly Metrics

Calculate correlation metrics for a specific hospital and time period.

Endpoint

POST /api/correlation/metrics/:hospitalId

Path Parameters

hospitalId

string

required

The unique identifier of the hospital

Request Body

year

number

required

Year for the metrics period (e.g., 2024)

month

number

required

Month for the metrics period (1-12)

Response

success

boolean

Indicates if metrics were generated successfully

data.metrics

object

Complete metrics object with HR data, hospital data, and correlations

Show metrics properties

hospitalId

string

Hospital identifier

period

object

Time period for these metrics

Show period properties

year

number

Year

month

number

Month (1-12)

hrMetrics

object

Human resources metrics

Show hrMetrics properties

totalEmployees

number

Total active employees

avgMotivation

number

Average motivation level (0-10)

avgSatisfaction

number

Average satisfaction level (0-10)

flightRiskEmployees

number

Number of employees at high flight risk

trainingHours

number

Total training hours completed

recognitionsGiven

number

Total recognitions awarded

surveyParticipation

number

Survey participation rate (%)

hospitalMetrics

object

Hospital performance metrics

Show hospitalMetrics properties

patientSatisfaction

number

Patient satisfaction score (0-10)

clinicalErrors

number

Number of clinical errors

readmissionRate

number

Readmission rate (%)

averageWaitTime

number

Average patient wait time (minutes)

consultationsPerDay

number

Average consultations per day

absenteeismRate

number

Employee absenteeism rate (%)

bedOccupancy

number

Bed occupancy rate (%)

emergencyResponseTime

number

Emergency response time (minutes)

correlations

array

Array of detected correlations

Show correlation properties

hrVariable

string

HR metric variable name (e.g., “avgMotivation”)

hospitalVariable

string

Hospital metric variable name (e.g., “clinicalErrors”)

correlation

number

Correlation coefficient (-1 to 1)

significance

string

Significance level: alta, media, baja

impact

string

Human-readable description of the correlation’s impact

calculatedAt

string

ISO 8601 timestamp of when metrics were calculated

Example Request

curl -X POST https://api.cuido.com/api/correlation/metrics/HOSPITAL_001 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2024,
    "month": 1
  }'

Response Example

{
  "success": true,
  "message": "Métricas mensuales generadas",
  "data": {
    "metrics": {
      "_id": "65a1b2c3d4e5f6a7b8c9d0e1",
      "hospitalId": "HOSPITAL_001",
      "period": {
        "year": 2024,
        "month": 1
      },
      "hrMetrics": {
        "totalEmployees": 85,
        "avgMotivation": 6.8,
        "avgSatisfaction": 7.2,
        "flightRiskEmployees": 12,
        "trainingHours": 340,
        "recognitionsGiven": 45,
        "surveyParticipation": 78
      },
      "hospitalMetrics": {
        "patientSatisfaction": 7.5,
        "clinicalErrors": 3,
        "readmissionRate": 8.5,
        "averageWaitTime": 35,
        "consultationsPerDay": 125,
        "absenteeismRate": 5.2,
        "bedOccupancy": 82.5,
        "emergencyResponseTime": 8
      },
      "correlations": [
        {
          "hrVariable": "avgSatisfaction",
          "hospitalVariable": "patientSatisfaction",
          "correlation": 0.8,
          "significance": "alta",
          "impact": "Personal satisfecho mejora la experiencia del paciente"
        }
      ],
      "calculatedAt": "2024-01-15T10:30:00.000Z"
    }
  }
}

Get Historical Metrics

Retrieve historical metrics for trend analysis.

Endpoint

GET /api/correlation/metrics/:hospitalId/history

Query Parameters

months

number

Number of months of history to retrieve. Default: 6

Response

data.metrics

array

Array of monthly metrics objects, sorted by most recent first

Example Request

curl -X GET "https://api.cuido.com/api/correlation/metrics/HOSPITAL_001/history?months=6" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Generate Strategic Report

Generate an AI-powered strategic report with insights and recommendations.

Endpoint

GET /api/correlation/report/:hospitalId

Query Parameters

year

number

required

Year for the report

month

number

required

Month for the report (1-12)

Response

data.report

object

AI-generated strategic report

Show report properties

period

string

Period string (e.g., “1/2024”)

hospitalId

string

Hospital identifier

generatedAt

string

ISO 8601 timestamp of report generation

metrics

object

The complete metrics object used for analysis

strategicAnalysis

string

AI-generated comprehensive analysis in Spanish

keyInsights

array

Array of extracted key insights (up to 5)

recommendations

array

Array of top 3 actionable recommendations

Example Request

curl -X GET "https://api.cuido.com/api/correlation/report/HOSPITAL_001?year=2024&month=1" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response Example

{
  "success": true,
  "message": "Reporte estratégico generado",
  "data": {
    "report": {
      "period": "1/2024",
      "hospitalId": "HOSPITAL_001",
      "generatedAt": "2024-01-15T10:30:00.000Z",
      "metrics": { /* full metrics object */ },
      "strategicAnalysis": "ESTADO GENERAL DEL HOSPITAL:\n\nEl Hospital 001 muestra un desempeño sólido con indicadores positivos en satisfacción del personal (7.2/10) y satisfacción del paciente (7.5/10). La correlación positiva entre estos factores (0.8) confirma que el bienestar del personal impacta directamente en la experiencia del paciente.\n\nÁREAS DE RIESGO INMEDIATO:\n\n1. Riesgo de fuga de talento: 12 empleados (14% del personal) identificados en alto riesgo\n2. Participación en encuestas: Aunque 78% es aceptable, el 22% restante representa voces no escuchadas\n3. Errores clínicos: 3 errores reportados requieren análisis de causa raíz\n\nOPORTUNIDADES DE MEJORA:\n\n1. Capitalizar la alta satisfacción del personal para programas de referidos\n2. Incrementar horas de capacitación (actualmente 340h/mes) en áreas de alto riesgo\n3. Replicar prácticas del sistema de reconocimiento (45 otorgados) en otros departamentos\n\nRECOMENDACIONES PRIORITARIAS:\n\n1. Plan de retención: Entrevistas 1-a-1 con los 12 empleados en riesgo de fuga para identificar causas y soluciones personalizadas\n2. Programa de capacitación: Aumentar 20% las horas de formación enfocadas en prevención de errores clínicos\n3. Sistema de escucha activa: Implementar encuestas breves semanales para aumentar participación al 90%\n\nINDICADORES A MONITOREAR EL PRÓXIMO MES:\n\n- Reducción de empleados en riesgo de fuga (meta: <10)\n- Incremento en participación de encuestas (meta: 85%)\n- Mantenimiento de cero errores clínicos graves\n- Satisfacción del paciente (mantener >7.5)",
      "keyInsights": [
        "La correlación positiva entre estos factores (0.8) confirma que el bienestar del personal impacta directamente en la experiencia del paciente.",
        "Riesgo de fuga de talento: 12 empleados (14% del personal) identificados en alto riesgo",
        "3 errores reportados requieren análisis de causa raíz"
      ],
      "recommendations": [
        "Plan de retención: Entrevistas 1-a-1 con los 12 empleados en riesgo de fuga para identificar causas y soluciones personalizadas",
        "Programa de capacitación: Aumentar 20% las horas de formación enfocadas en prevención de errores clínicos",
        "Sistema de escucha activa: Implementar encuestas breves semanales para aumentar participación al 90%"
      ]
    }
  }
}

Get Executive Dashboard

Get a summary dashboard with current metrics and trends.

Endpoint

GET /api/correlation/dashboard/:hospitalId

Response

data.dashboard

object

Executive dashboard with current period, metrics, trends, and alerts

Show dashboard properties

currentPeriod

object

Current year and month

metrics

object

Current month’s complete metrics or null if not calculated

trends

object

Month-over-month changes

Show trends properties

motivation

number

Change in average motivation

satisfaction

number

Change in average satisfaction

flightRisk

number

Change in flight risk employees count

keyAlerts

array

Array of high-significance correlations requiring attention

lastUpdated

string

ISO 8601 timestamp of last calculation

Example Request

curl -X GET https://api.cuido.com/api/correlation/dashboard/HOSPITAL_001 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Correlation Detection Algorithm

The system (src/services/correlationService.js:131) detects basic correlations:

Motivation vs Clinical Errors (inverse correlation)
- If avgMotivation < 5 AND clinicalErrors > 5
- Correlation: -0.7 (high significance)
Satisfaction vs Patient Satisfaction (positive correlation)
- If avgSatisfaction > 7 AND patientSatisfaction > 7
- Correlation: 0.8 (high significance)
Flight Risk vs Wait Time (positive correlation)
- If flightRiskEmployees > 20% of total employees
- Correlation: 0.6 (medium significance)

AI Integration

Strategic reports use Claude AI (src/services/correlationService.js:173) with:

Temperature: 0.4 (factual, less creative)
Max Tokens: 1500
System Prompt: Senior hospital management consultant
Output: Strategic analysis with 5 sections

Source Code References

Routes: src/routes/correlationRoutes.js:16-19
Controllers: src/controllers/correlationController.js
Service: src/services/correlationService.js:15
Correlation Logic: src/services/correlationService.js:131
AI Report: src/services/correlationService.js:173
Model: src/models/PerformanceMetric.js

Authentication

Employees

Diagnostic Module

Mentorship Module

Microlearning Module

Recognition Module

Correlation Module

Chat & Prompts

Performance Correlation Analysis

Overview

Authentication

Generate Monthly Metrics

Endpoint

Path Parameters

Request Body

Response

Example Request

Response Example

Get Historical Metrics

Endpoint

Query Parameters

Response

Example Request

Generate Strategic Report

Endpoint

Query Parameters

Response

Example Request

Response Example

Get Executive Dashboard

Endpoint

Response

Example Request

Correlation Detection Algorithm

AI Integration

Source Code References

Build docs developers (and LLMs) love

Authentication

Employees

Diagnostic Module

Mentorship Module

Microlearning Module

Recognition Module

Correlation Module

Chat & Prompts

​Overview

​Authentication

​Generate Monthly Metrics

​Endpoint

​Path Parameters

​Request Body

​Response

​Example Request

​Response Example

​Get Historical Metrics

​Endpoint

​Query Parameters

​Response

​Example Request

​Generate Strategic Report

​Endpoint

​Query Parameters

​Response

​Example Request

​Response Example

​Get Executive Dashboard

​Endpoint

​Response

​Example Request

​Correlation Detection Algorithm

​AI Integration

​Source Code References

Build docs developers (and LLMs) love

Overview

Authentication

Generate Monthly Metrics

Endpoint

Path Parameters

Request Body

Response

Example Request

Response Example

Get Historical Metrics

Endpoint

Query Parameters

Response

Example Request

Generate Strategic Report

Endpoint

Query Parameters

Response

Example Request

Response Example

Get Executive Dashboard

Endpoint

Response

Example Request

Correlation Detection Algorithm

AI Integration

Source Code References