Conceptos clave: roles, semaforo y flujo de datos

Antes de comenzar a trabajar con Plutto SPM, es importante comprender los conceptos fundamentales que sustentan la plataforma: los roles de usuario, el sistema de semaforo y como se calculan los puntajes de desempeno.

---

Roles del sistema

Plutto SPM define tres roles de usuario, cada uno con diferentes niveles de acceso:

Admin (Administrador)

Tiene control total sobre la plataforma. Puede crear y modificar proveedores, contratos, KPIs, familias y configurar SSO. Tambien puede cargar mediciones y forzar el recalculo de scores.

Gestor

Puede visualizar toda la informacion y cargar mediciones mensuales, pero no puede crear ni modificar proveedores, contratos o KPIs.

Viewer (Solo lectura)

Puede ver el dashboard, scores, snapshots y exportar datos en CSV, pero no puede modificar ninguna informacion ni cargar mediciones.

Tabla de permisos por rol

Accion	Admin	Gestor	Viewer
Crear/editar proveedores	Si	No	No
Crear/editar contratos	Si	No	No
Configurar KPIs y familias	Si	No	No
Cargar mediciones mensuales	Si	Si	No
Ver dashboard y scores	Si	Si	Si
Ver notificaciones	Si	Si	Si
Exportar datos (CSV)	Si	Si	Si
Forzar recalculo de snapshot	Si	No	No
Configurar SSO	Si	No	No

---

Sistema de semaforo

El semaforo es el sistema visual que Plutto SPM utiliza para indicar rapidamente el estado de desempeno de cada contrato. Se basa en el score global (puntaje de 0% a 100%) calculado automaticamente.

Score	Color	Significado
80% o mas	Verde	Buen desempeno. El proveedor cumple con lo esperado.
Entre 50% y 79%	Amarillo	Desempeno regular. Requiere atencion y seguimiento.
Menos de 50%	Rojo	Desempeno critico. Requiere accion inmediata.
Sin datos	Gris	No hay mediciones cargadas para el periodo.

En la vista Organizacion del Dashboard, podra ver un resumen con la cantidad de contratos en cada estado del semaforo:

Cada contrato muestra su score con un indicador de color junto al numero, y una etiqueta de estado (Verde, Amarillo, Rojo) en la columna correspondiente. Ademas, las tarjetas de unidades de negocio muestran barras de progreso coloreadas segun el semaforo.

---

Flujo de datos: de mediciones a scores

El calculo de scores en Plutto SPM sigue un flujo jerarquico de abajo hacia arriba:

Mediciones (valores mensuales por KPI)
    |
    v
Score por KPI (logro individual, 0-100%)
    |
    v
Score por Familia (promedio ponderado de KPIs en la familia)
    |
    v
Score Global del contrato (promedio ponderado de familias)
    |
    v
Snapshot (registro mensual del estado completo)

1. Mediciones

Cada mes, se registra un valor numerico para cada KPI del contrato. Por ejemplo, si el KPI es "Tasa de defectos" con meta de 2%, se registra el valor medido (ej. 2.7%).

2. Score por KPI (logro individual)

El sistema calcula automaticamente el porcentaje de logro de cada KPI comparando el valor medido contra el objetivo y el punto critico. El calculo usa interpolacion lineal entre ambos puntos.

En el detalle de un contrato, la tabla KPI por ambito muestra el valor medido, el punto critico (PC), la meta, el objetivo y el logro porcentual de cada KPI:

3. Score por Familia

Cada KPI pertenece a una familia (ej. Calidad, Eficiencia, Sustentabilidad). El score de la familia es el promedio ponderado de los scores de sus KPIs. En la tabla Logro por ambito (%) se muestra el resultado y desempeno de cada familia.

4. Score Global del contrato

El score global es el promedio ponderado de los scores de todas las familias, donde cada familia tiene un peso asignado que refleja su importancia relativa. Este es el numero grande que aparece en la esquina superior derecha del detalle del contrato (ej. 87.1).

5. Snapshot

Cada vez que se cargan mediciones, el sistema genera automaticamente un snapshot: una fotografia del estado completo del contrato en ese periodo. El snapshot almacena:

• El score global
• Los scores por familia
• Los scores por KPI
• La cantidad de KPIs evaluados vs. totales
• La fecha de calculo

Los snapshots permiten ver la evolucion historica del desempeno y comparar periodos.

---

Glosario de terminos

Termino	Definicion
Proveedor	Empresa externa que presta un servicio a su organizacion.
Contrato	Acuerdo formal entre su organizacion y un proveedor, con fechas de vigencia y un administrador responsable.
Familia de KPIs	Categoria que agrupa indicadores relacionados (ej. Calidad, Eficiencia). Cada familia tiene un peso dentro del contrato.
KPI	Indicador de desempeno especifico que se mide mensualmente. Tiene un valor objetivo (meta) y un punto critico (minimo aceptable).
Template de KPI	Plantilla de KPI predefinida que puede reutilizarse en varios contratos.
Medicion	Valor numerico registrado para un KPI en un mes determinado.
Score (puntaje)	Calificacion calculada automaticamente (0% a 100%) que refleja el nivel de cumplimiento.
Snapshot	Registro mensual que almacena todos los scores del contrato en un periodo especifico.
Semaforo	Sistema visual de colores (verde, amarillo, rojo, gris) que indica el nivel de desempeno segun el score.
Punto critico (PC)	Valor minimo aceptable de un KPI. Por debajo de este valor, el logro es 0%.
Meta (objetivo)	Valor ideal que se espera alcanzar en un KPI. Al alcanzarlo, el logro es 100%.
Interpolacion lineal	Metodo de calculo que determina el porcentaje de logro proporcionalmente entre el punto critico y la meta.

---

Resumen

• Plutto SPM tiene tres roles: Admin (control total), Gestor (carga mediciones) y Viewer (solo lectura).
• El semaforo clasifica el desempeno en cuatro estados segun el score: verde (>=80%), amarillo (50-79%), rojo (<50%) y gris (sin datos).
• El flujo de datos va de mediciones individuales a scores por KPI, por familia, y finalmente al score global del contrato.
• Los snapshots registran el estado completo de cada contrato mes a mes, permitiendo ver la evolucion historica.