GitScrum / Docs

Análisis

Accede a dashboards gerenciales e informes de proyectos. Salud, análisis de riesgos, flujo acumulativo e informes de actividad.

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Accede a dashboards gerenciales e informes a nivel de proyecto incluyendo salud del pulso, análisis de riesgos, diagramas de flujo acumulativo y resúmenes de actividad.

URL base: https://services.gitscrum.com

Todos los endpoints requieren el header Authorization: Bearer {token}.


Dashboard gerencial

Salud del pulso

GET /companies/manager-dashboard/pulse?company_slug={slug}

Devuelve el resumen de salud del workspace con indicadores clave de rendimiento.

ParámetroTipoDescripción
periodstringtoday, this-week, this-month, last-30-days
viewstringall, active, overdue

Respuesta

{
  "data": {
    "health_score": 85,
    "tasks_completed": 47,
    "tasks_in_progress": 23,
    "tasks_overdue": 5,
    "velocity": 52,
    "period": "this-week"
  }
}

Análisis de riesgos

GET /companies/manager-dashboard/risks?company_slug={slug}

Devuelve el análisis de riesgos en todos los proyectos del workspace.

ParámetroTipoDescripción
filterstringall, blocked, unassigned, stale, aging
severitystringall, critical, warning, info

Respuesta

{
  "data": {
    "total_risks": 12,
    "critical": 3,
    "warning": 5,
    "info": 4,
    "risks": [
      {
        "type": "blocked",
        "severity": "critical",
        "task": {
          "uuid": "task-abc-123",
          "title": "Payment integration"
        },
        "project": "web-app",
        "days_blocked": 5
      }
    ]
  }
}

Resumen general

GET /companies/manager-dashboard/overview?company_slug={slug}

Devuelve el resumen principal del dashboard gerencial con métricas agregadas de todos los proyectos.

Respuesta

{
  "data": {
    "projects_active": 8,
    "total_tasks": 342,
    "completed_this_week": 47,
    "team_members_active": 15,
    "overdue_tasks": 12
  }
}

Métricas de salud

GET /companies/manager-dashboard/health?company_slug={slug}

Devuelve métricas de salud agregadas del workspace incluyendo puntuaciones de salud a nivel de proyecto.

Respuesta

{
  "data": {
    "overall_score": 82,
    "projects": [
      {
        "slug": "web-app",
        "name": "Web App",
        "health_score": 90,
        "status": "healthy"
      },
      {
        "slug": "mobile-app",
        "name": "Mobile App",
        "health_score": 65,
        "status": "at_risk"
      }
    ]
  }
}

Análisis de bloqueos

GET /companies/manager-dashboard/blockers?company_slug={slug}

Devuelve análisis de bloqueos con categorización y evaluación de impacto.

Respuesta

{
  "data": {
    "total_blockers": 7,
    "by_project": [],
    "by_severity": {
      "critical": 2,
      "high": 3,
      "medium": 2
    },
    "average_blocked_days": 3.2
  }
}

Centro de comando

GET /companies/manager-dashboard/command-center?company_slug={slug}

Devuelve una vista consolidada de elementos que requieren atención del gerente.

Resumen de entradas de tiempo

GET /companies/manager-dashboard/time-entries?company_slug={slug}

Devuelve el resumen de entradas de tiempo en todo el workspace.

ParámetroTipoDescripción
time_filterstringtoday, thisweek, billable, nonbillable

Respuesta

{
  "data": {
    "total_hours": 245.5,
    "billable_hours": 198.0,
    "non_billable_hours": 47.5,
    "by_project": [],
    "by_member": []
  }
}

Informes de proyecto

Flujo acumulativo

GET /companies/reports/cumulative-flow?company_slug={slug}&project_slug={slug}

Devuelve datos del diagrama de flujo acumulativo mostrando la distribución de tareas en las etapas del workflow a lo largo del tiempo.

ParámetroTipoDescripción
daysintegerNúmero de días (predeterminado 30, máximo 90)

Respuesta

{
  "data": {
    "dates": ["2026-01-08", "2026-01-09", "2026-01-10"],
    "series": {
      "backlog": [45, 43, 40],
      "in_progress": [12, 14, 15],
      "done": [23, 25, 28]
    }
  }
}

Antigüedad de tareas

GET /companies/reports/project-age?company_slug={slug}&project_slug={slug}

Devuelve un informe de antigüedad de tareas mostrando cuánto tiempo llevan las tareas en su estado actual.

Respuesta

{
  "data": {
    "buckets": [
      { "range": "0-3 days", "count": 25 },
      { "range": "4-7 days", "count": 12 },
      { "range": "8-14 days", "count": 8 },
      { "range": "15-30 days", "count": 4 },
      { "range": "30+ days", "count": 2 }
    ],
    "average_age_days": 6.3
  }
}

Actividad semanal

GET /companies/reports/weekly-activity?company_slug={slug}&project_slug={slug}

Devuelve el resumen de actividad semanal incluyendo movimientos de tareas, comentarios y participación del equipo.

Respuesta

{
  "data": {
    "week": "2026-W06",
    "tasks_created": 18,
    "tasks_completed": 22,
    "tasks_moved": 45,
    "comments_added": 67,
    "active_members": 12
  }
}