Especificación · PolariScore
Rutas de acceso
Dos aplicaciones, dos conjuntos de URL. Comparten nombres de vista, así que la única forma de saber dónde estás es mirar el dominio.
Cómo distinguirlas de un vistazo: si la URL empieza por
planitone.co/polariscore/ estás en la estable (oficial). Si empieza por
polariscore.planitone.co/ estás en la v1. Ver
Las dos versiones.Versión estable — planitone.co/polariscore Oficial
Nginx reenvía todo /polariscore/ al servicio interno en el puerto 3121.
| Ruta | Archivo | Qué es |
|---|---|---|
/polariscore/ | index.html | Índice de políticas con KPIs y podio. |
/polariscore/dashboard | dashboard.html | Tablero general de cumplimiento. |
/polariscore/politicas | politicas.html | Listado de políticas. |
/polariscore/politica | politica.html | Ficha de una política: gauge, cumplimiento por años, curva S, programación ponderada y tabla exportable. |
/polariscore/accion | accion.html | Ficha de una acción: KPIs, evidencias, evaluación por año e historial. |
/polariscore/cargar | cargar.html | Módulo de carga de evidencias. |
/polariscore/actualizacion | actualizacion.html | Carga masiva por Excel. |
/polariscore/wizard | wizard.html | Asistente de creación de políticas. |
/polariscore/temporal | temporal.html | Vista heredada, aún servida. |
/polariscore/health | — | Sonda de salud; responde ok. |
Cualquiera de estas rutas con barra final redirige (301) a la versión sin barra.
Copias muertas en el repositorio. Junto a los archivos vivos conviven
accion copy.html, accion copy 2.html, accion copy 3.html y
wizard copy.html. No están enlazados desde ninguna parte y no reciben cambios: son una fuente frecuente
de trabajo perdido, porque una búsqueda por texto los encuentra primero. Confirma qué archivo sirve la ruta antes de
editar.Versión v1 — polariscore.planitone.co v1.0
Subdominio dedicado, servido en la raíz desde el puerto 3101. Si llega una URL con el prefijo
/polariscore —un enlace antiguo—, el servidor lo retira y sigue funcionando.
| Ruta | Qué es |
|---|---|
/ · /inicio · /landing | Landing institucional. |
/index · /app · /home | Índice de políticas con KPIs, podio y tabla filtrable. |
/login | Acceso con Google. Acepta ?next= para volver a donde ibas. |
/dashboard | Tablero con seis KPIs, podio, radar por política y curva S. |
/politicas | Índice de políticas. |
/politica | Ficha de política. Se sirve la versión anterior: la reescritura no replicaba las gráficas críticas. |
/accion | Ficha de acción con evaluación por año. |
/cargar | Carga de evidencias. Acepta modo emergente con ?popup=1. |
/actualizacion · /observaciones | Carga masiva por Excel. |
/wizard | Asistente de creación de políticas, en siete pasos. |
/evidencias | Solo v1 Centro de trazabilidad: todas las cargas, filtrables por política, acción, usuario, ciclo y fecha. |
/notificaciones | Solo v1 Bandeja y panel de configuración de los correos de aviso. |
/admin | Solo v1 Feed en vivo de notificaciones y estado del envío de correo. |
/about | Solo v1 Créditos, stack y notas de la versión. |
/health · /api/version | Estado del servicio y versión desplegada. |
Parámetros de la v1
| Parámetro | Efecto |
|---|---|
?v0=1 | Sirve la vista anterior de esa pantalla, por compatibilidad. |
?v1=1 | Alias explícito de la versión nueva (hoy es la predeterminada). |
?next= | En /login: a dónde volver tras autenticarse. Se valida que sea del mismo origen. |
?popup=1 | En /cargar: interfaz sin menú lateral, pensada para abrirse desde otra ventana. |
?id= | En /accion: identificador de la acción a mostrar. |
Endpoints de la v1
| Endpoint | Qué hace |
|---|---|
GET /health | Estado, versión y qué vistas están servidas en v1. |
GET /api/version | Nombre, versión y marca de arranque del proceso. |
POST /api/notify | Encola el correo de aviso a los destinatarios configurados. Es de mejor esfuerzo: nunca devuelve error al cliente. |
GET /api/brevo/status | Estado de la conexión con el proveedor de correo. |
Artefactos de aplicación instalable
La v1 se puede instalar como aplicación: sirve /manifest.webmanifest y un trabajador de servicio en
/sw.js que cachea los recursos compilados y deja pasar las peticiones a Firebase.
Documentación y su API
Este portal vive en docs.planitone.co/polariscore/ y publica una API de solo lectura con la
proyección pública de las políticas:
| Endpoint | Devuelve |
|---|---|
/api/polariscore/stats | Conteos, cumplimiento promedio, ciclos y estados de carga. |
/api/polariscore/politicas | Las políticas con sus totales. Con ?detalle=1 incluye objetivos y acciones. |
/api/polariscore/politicas/:id | Una política con su detalle completo. |
/api/polariscore/acciones | Índice plano de acciones, para búsqueda. |
/api/polariscore/diagnostico | Hallazgos de consistencia y cobertura del seguimiento. |
Todos son de solo lectura, con cache de 5 minutos, y nunca incluyen datos personales ni URLs de archivos.