Panel (Dashboard)¶

El Dashboard ofrece a cada usuario una vista rápida del estado operativo — métricas, alertas y actividad reciente — acotada a lo que su rol permite ver.

Acceso al Dashboard¶

Endpoint: GET /{slug}/api/v1/dashboard/

Todos los usuarios autenticados pueden acceder al Dashboard. Los datos devueltos se filtran por rol.

Enlace a la documentación en la aplicación¶

Cuando tiene sesión iniciada, use el enlace Docs en la navegación principal de la aplicación para abrir /docs/ directamente. No necesita cerrar sesión ni volver a la página pública de inicio para ver la documentación.

Estructura de la respuesta¶

{
  "metrics": {
    "bids": { "new_bid": 3, "awaiting_po": 2, "approved": 10, "rejected": 1, "cancelled": 0 },
    "jobs": { "ready": 5, "in_progress": 4, "needs_invoice": 2, "cancelled": 1 },
    "invoices": { "invoice_submitted": 3, "partially_paid": 1, "paid": 8, "workflow_complete": 2 }
  },
  "alerts": {
    "priority_bids": 1,
    "blocked_bids": 0,
    "priority_jobs": 2,
    "blocked_jobs": 1,
    "stale_jobs": 3
  }
}

Métricas por rol¶

Section	Roles que las ven
`metrics.bids`	Owner, PM, Accounting, Platform Admin
`metrics.invoices`	Owner, Accounting, Platform Admin
`metrics.jobs`	Todos los roles (Supervisor y Badge Worker solo sus propios Jobs)
`alerts.priority_bids` / `alerts.blocked_bids`	Owner, PM, Accounting, Platform Admin
`alerts.priority_jobs` / `alerts.blocked_jobs` / `alerts.stale_jobs`	Todos los roles (acotado)

Alertas¶

Stale Jobs¶

Un Job es stale cuando ha estado en estado Ready to Start más tiempo que el umbral configurado del inquilino. El umbral se define en Company Settings (stale_job_threshold_days, predeterminado 14 días).

Configurar el umbral de Jobs \"stale\"

Los Owners pueden ajustar el umbral en Company Settings para que coincida con su ritmo operativo.

Priority y Blocked¶

Priority bids/jobs — marcados por PM u Owners como alta prioridad.
Blocked bids/jobs — tienen un bloqueo activo que debe resolverse antes de que el trabajo pueda continuar.

Activity Feed¶

El Dashboard también incluye un Activity Feed acotado por rol en:

GET /{slug}/api/v1/activity/feed/dashboard/

Role	Alcance del feed
Owner, PM, Accounting	Toda la actividad
Supervisor	Solo sus Jobs asignados
Badge Worker	Jobs a los que está asignado