Panel de Valor

El Panel de Valor es la primera pantalla que ves al entrar a Rela AI. En un solo vistazo responde la pregunta clave: ¿vale la pena lo que pago? Consolida nueve widgets que muestran el retorno real (en USD y en tiempo) que Rela AI genera sobre tu operación.

Resumen ejecutivo

El cambio de juego: tu dashboard dejó de mostrar cuántos tokens Gemini consumiste (métrica útil para nosotros) y pasó a mostrar cuánto downtime evitaste, cuántas intervenciones predictivas disparamos y cuál es tu ROI real vs el costo del plan.

¿Para qué sirve?

Con pricing por-máquina, los tokens se volvieron un problema interno nuestro (lo maneja el admin panel). El cliente paga un fee fijo y necesita una respuesta rápida a cuatro preguntas:

1. ¿Estoy usando lo que pagué? (Utilización del plan)
2. ¿Está funcionando el sistema? (Salud operacional + Impacto de los agentes)
3. ¿Dónde hay plata que estoy dejando en la mesa? (Alertas de valor perdido)
4. ¿Cómo me comparo con el mercado y estoy en el plan correcto? (Benchmark de industria + Plan fit)

El Panel de Valor responde las cuatro en menos de 30 segundos.

¿Cómo funciona?

flowchart LR
  A[Datos reales del tenant] --> B[Agregaciones<br/>cross-collection]
  B --> C[Benchmarks económicos<br/>del tenant]
  C --> D[Hero ROI]
  C --> E[Lost-value alerts]
  B --> F[Plan utilization]
  B --> G[Ops health / Agent impact /<br/>Proactive vs Reactive / Inventory]
  B --> H[Industry benchmark]
  B --> I[Plan fit]
  D & E & F & G & H & I --> J[Panel de Valor]

Cada widget consulta un endpoint del backend que agrega datos transversales: _assets para máquinas activas, _machine_events para eventos del mes, _asset_kpis para OEE/MTTR/MTBF, _tenant_benchmarks para costos del cliente, _subscription_plans para precio y límites.

Las cifras en USD se calculan multiplicando métricas físicas (horas de downtime evitadas, horas de técnico ahorradas) por los supuestos económicos que el tenant configuró en /settings/benchmarks. Si aún no los configuró, los widgets muestran métricas físicas sin USD y un CTA para completarlos.

Widgets del panel

1. Hero "Valor generado este mes"

La tarjeta más importante: arriba del fold, full-width.

Modo configurado (benchmarks listos):

• Ahorro neto grande (ahorro total − costo del plan).
• Delta ▲/▼ vs mes anterior.
• 6 métricas: ahorro total, costo del plan, ROI como multiplicador, downtime evitado (h), horas de técnico ahorradas, link "Ajustar supuestos".
• Badge del plan actual (Essential/Professional/Enterprise).

Modo fallback (sin benchmarks): card ámbar con métricas físicas (downtime evitado, horas técnico) y CTA "Configurar supuestos" → /settings/benchmarks. Nunca inventamos cifras en USD sin datos reales del cliente.

Endpoint: GET /api/v1/roi/hero.

2. Alertas de valor perdido

Widget full-width justo debajo del Hero. Convierte datos pasivos en acciones rentables:

Cada card tiene CTA inline que lleva al path correspondiente (/assets, /parts, /tasks?filter=overdue).

Endpoint: GET /api/v1/roi/lost-value.

3. Utilización del plan

Reemplaza la vista vieja de tokens. Muestra:

• Plan actual (Essential / Professional / Enterprise) + precio/mes.
• Barras de progreso: Máquinas (assets), Agentes (WhatsApp + Email), Interacciones (eventos del mes).
• Fecha de próxima facturación.

Endpoint: GET /api/v1/billing/overview (nuevo servicio composite).

4. Salud operacional

Cockpit de 6 métricas en grid 3×2 con tokens de severidad canónicos:

• Alarmas críticas activas (emergency + critical).
• Alarmas warning activas.
• Eventos últimas 24 h.
• Cumplimiento de mantenimiento (%).
• SLA completion (%).
• Tiempo medio de resolución.

Endpoint: GET /api/v1/dashboard/kpis + GET /api/v1/dashboard/sla.

5. Impacto de los agentes IA

Métricas del core value de la suscripción:

• Agentes activos vs totales (WhatsApp + Email combinados).
• Conversaciones manejadas (últimos 30 días).
• Mensajes gestionados.
• Última actividad con tiempo relativo.
• Split WhatsApp vs Email en el footer.

6. Proactivo vs reactivo

Narrativa del cambio cultural hacia mantenimiento planificado:

• Porcentaje de mantenimientos planificados a tiempo.
• OTs vencidas.
• Tareas en curso.
• Tareas completadas.
• Barra segmentada con mix de priorities (urgent/high/medium/low).

7. Inventario + compras

• Valor total de inventario (sum de unit_cost * quantity_on_hand).
• Partes registradas.
• Partes bajo mínimo (con link a /parts?filter=low).
• Partes sin stock (con link a /parts?filter=zero).
• Footer con POs abiertas por estado + valor comprometido.

8. Benchmark vs industria

Compara los KPIs del tenant contra baselines curados para 7 sectores:

Tolerancia ±5 %: better / worse / on_par / no_data.

9. ¿Estoy en el plan correcto?

Heurística que detecta features tier-gated en uso y sugiere upgrade o downgrade:

• Upgrade: el tenant usa prognostics, anomaly_detection, energy_monitoring o extraction pero está en Essential. O usa oee, sso, audit_trail pero no está en Enterprise.
• Downgrade: el tenant tiene Professional o Enterprise pero no toca los gates exclusivos.
• Fit: el plan está alineado con el uso real.

Confianza: high (≥2 features), medium (1), low (downgrade).

Endpoint compartido con el benchmark: GET /api/v1/roi/insights.

¿Cómo usarlo?

1. Entra al home (/dashboard). Es la primera pantalla que ves.
2. Revisa el Hero para el número titular del mes.
3. Si ves alertas de valor perdido en ámbar, haz clic en la que te interese. Cada una tiene un CTA directo a la acción rentable.
4. Revisa Utilización del plan para saber si te acercas a un límite.
5. Ops Health + Proactivo/Reactivo resumen el estado físico. Si ves críticas activas, pasa al inbox operativo con el botón "Ver operaciones".
6. Benchmark vs industria y Plan fit son contextuales — revísalos cada 2-3 meses para calibrar expectativas y asegurarte de estar en el tier correcto.

Configuración de supuestos económicos

Para desbloquear el Hero en USD, el tenant debe llenar los supuestos en /settings/benchmarks:

Mientras no estén configurados, los widgets relevantes muestran métricas físicas (horas, counts) y el Hero adopta el modo fallback ámbar.

Endpoint: GET/PATCH/POST /api/v1/tenant-benchmarks (+ /reset).

Casos de uso

1. Supervisor de mantenimiento, lunes 7 AM. Entra al Panel de Valor, ve el Hero con "Ahorro neto $33,200 este mes, +12 % vs mes anterior". Luego escanea las alertas de valor perdido, encuentra "3 activos degradados — potencial $12 500", hace clic y crea OTs para la semana.
2. Gerente de planta, revisión mensual. Abre el panel, confirma que el ROI se mantiene sobre 15×. Revisa el Benchmark vs Industria para validar que su OEE de 78 % sigue sobre el promedio del sector (alimentos: 65 %). Exporta una captura para el comité.
3. Onboarding de un cliente nuevo. Durante la primera semana ven el Hero en modo fallback con solo métricas físicas. Terminan el wizard de benchmarks el viernes y a partir del lunes el Hero muestra USD reales.

Limitaciones y supuestos

• Las cifras en USD dependen 100 % de que el tenant haya configurado sus benchmarks. Si los valores son imprecisos, el ROI también lo es.
• El benchmark vs industria usa baselines públicos fijos (no es el promedio en vivo del sector). Se usa como referencia directional, no como ranking exacto.
• El widget "Plan fit" es una heurística basada en detección de features tier-gated. No considera volumen (número de eventos, llamadas, etc.).
• Los widgets cachean por petición — no usan websockets. Un reload trae lo más fresco.
• Aún no hay versión móvil optimizada específica; se ve bien en tablet y desktop.

Beneficios clave

• El cliente entiende en 30 segundos cuánto le está dando Rela AI este mes.
• Las alertas proactivas transforman el dashboard de pasivo a activo — cada card tiene CTA directo a la acción rentable.
• El Plan fit previene churn por under-utilización y destapa upgrades orgánicos.
• El Hero con ROI real justifica la renovación anual con un número verificable.
• La separación Value Dashboard vs Operational Dashboard respeta la ley de una sola responsabilidad por pantalla.

Endpoints resumen