Especificación · PolariScore

Las dos versiones

PolariScore no es una aplicación: son dos, corriendo a la vez sobre la misma base de datos. Saber cuál estás mirando explica la mayoría de las discrepancias que reporta la gente.

Regla corta: para trabajar y para citar cifras oficiales, usa planitone.co/polariscore. La v1 en polariscore.planitone.co aporta pantallas que la estable no tiene (trazabilidad de evidencias, panel de notificaciones, correos), pero tiene diferencias de comportamiento documentadas abajo.

Oficial

PolariScore estable

planitone.co/polariscore

Proceso: polariscore-estable
Puerto interno: 3121
Código: apps/polariscore-estable
Stack: HTML monolítico + Bootstrap

Es la que la comunidad conoce y la que enlaza el portal institucional.
Ficha de política completa: gauge, cumplimiento por años, curva S, programación ponderada y tabla exportable.
Ficha de acción con evaluación por año e historial versionado.
Ciclo de carga fijo 2026_1 en el módulo de carga.
No envía correos ni tiene panel de notificaciones.

v1.0

PolariScore v1

polariscore.planitone.co

Proceso: polariscore
Puerto interno: 3101
Código: apps/polariscore
Stack: Vite + Tailwind + Chart.js

Interfaz reconstruida con un design system propio; PWA instalable.
Pantallas exclusivas: centro de trazabilidad de evidencias, panel de administración y notificaciones.
Notificaciones en la campana de la suite + correo por Brevo en cada carga.
La ficha de política sigue sirviéndose en su versión anterior: la reescritura no replicaba las gráficas críticas.
El módulo de carga escribe el ciclo como año simple, no como semestre.

Diferencias que sí cambian lo que ves

Aspecto	Estable (oficial)	v1
Base de datos	La misma: `PolariScore/` en la RTDB de `sigunitropico`. Lo que se escribe en una se ve en la otra.
Ficha de política	5 gráficas + tabla con exportación.	La misma vista heredada: no se migró para no perder esas gráficas.
Ciclo al cargar evidencia	`AAAA_S` (fijo en `2026_1`).	`AAAA` (año actual, editable en el formulario).
Notificaciones	No tiene.	Campana de la suite + correo Brevo configurable.
Trazabilidad de evidencias	Por acción, dentro de cada ficha.	Vista global filtrable por política, acción, usuario, ciclo y fecha.
KPI global de cumplimiento	—	El tablero calcula el promedio con una base de años distinta (ver abajo).
Acceso sin sesión	Las vistas cargan y consultan.	Redirige a `/login` y vuelve con `?next=`.

El desajuste de ciclos, con números

Las cargas se guardan en …/uploads/{ciclo}. Las dos versiones no construyen esa clave igual, así que una carga hecha desde la v1 no aparece donde la estable la busca —y viceversa—.

Clave de ciclo	Cargas	Escrita por
Cargando…

Consecuencia práctica. Si un responsable sube su soporte desde polariscore.planitone.co y el líder lo busca en planitone.co/polariscore, el líder verá la evidencia como pendiente. No se perdió nada: está guardada bajo otra clave de ciclo. Acuerden una sola versión para el cargue de cada vigencia.

El KPI de cumplimiento del tablero v1

El tablero de la v1 calcula su cifra global recorriendo cada acción y comparando lo programado con lo ejecutado. Para saber a qué año corresponde cada posición del arreglo anios usa el año actual como punto de partida, en lugar del año de inicio de cada política.

Como las políticas arrancan en 2023 o 2024 y la ejecución está registrada en esos años, la lectura se desplaza y cae casi a cero:

…

KPI tal como lo calcula el tablero v1

…

Mismo cálculo con el año inicial de cada política

…

Promedio del total guardado por política

Al citar cifras, usa el total de cada política (totalPolitica), que es el valor que la ficha calcula y persiste, y que esta documentación verifica de forma independiente. El KPI global del tablero v1 no es comparable con él.

Por qué hay dos

La v1.0 se lanzó como reemplazo y estuvo sirviendo la ruta oficial. Poco después se decidió volver la ruta institucional a la versión anterior —que la comunidad ya conocía y cuyas gráficas de política eran más completas— y dejar la v1 en un subdominio propio para seguir madurando sin bloquear a nadie.

Consecuencias de esa decisión, que conviene tener presentes:

La v1 hardcodea su base en muchas referencias absolutas, por eso vive en subdominio y no en una subruta.
Las mejoras de datos hay que aplicarlas en las dos: comparten base pero no código.
La v1 conserva un modo de compatibilidad ?v0=1 que sirve sus vistas anteriores.

Cuál usar según lo que vayas a hacer

Tarea	Versión recomendada	Por qué
Consultar una política y sus gráficas	Estable	Es la que tiene las cinco gráficas y la tabla exportable.
Cargar evidencias de la vigencia	Estable	Escribe el ciclo en el formato que el resto del sistema espera.
Evaluar acciones y registrar ejecución	Estable	Es la ruta oficial y la que conoce el equipo.
Auditar qué se ha subido y quién	v1	El centro de trazabilidad no existe en la estable.
Configurar quién recibe los correos	v1	Solo la v1 tiene el panel y el envío por Brevo.
Citar el porcentaje de una política	Cualquiera: ambas leen el mismo `totalPolitica`.

Relacionado: Rutas de acceso · Infraestructura · Diagnóstico de datos.