Especificación · SIG

Rutas de acceso

El dominio oficial del SIG es sigunitropico.co —siempre .co, nunca .com—. Esta página lista todas sus direcciones, cuáles son estables y citables, y cuáles conviene evitar.

Las que importan

RutaQué es¿Citable?
/ Portada del SIG: mapa de procesos, política y objetivos de calidad, partes interesadas, equipo y buscador de formatos institucionales.
/{proceso} Ficha de un proceso, con su listado de documentos. Los 16 códigos: git pet cli com gbc · for inc pso int · gth gma inf fnc jrd ifo · sct. Sí, y es la referencia más duradera
/descargar/{proceso}/{clave} Página de descarga de un documento concreto. Sí, pero caduca al cambiar la versión
/descargar/{clave} Forma antigua, sin proceso. Se conserva para no romper enlaces históricos. Solo si ya existía
/oferta Oferta académica: programas de pregrado.
/eventos Noticias y eventos institucionales.
/proceso Tabla resumen de los 16 procesos con su líder, su correo y sus oficinas.
/chatbot Panel de conversaciones del asesor virtual. Solo para administradores
/profile Perfil de la persona con sesión iniciada. No hace falta citarla
/contaduria/ Micrositio del programa de Contaduría Pública. Vive en el mismo dominio pero es otra aplicación.
No cites /about, /contact ni /service-1. Son páginas de la plantilla original sin personalizar: contienen contenido de demostración y datos que no corresponden a la Universidad. El contacto real es la sección de contacto de la portada y los correos de la División del SIG.

API

RutaQué devuelve
/sig/api/public/healthDisponibilidad y número de procesos cargados.
/sig/api/public/procesosLos 16 procesos con su slug, nombre y categoría.
/sig/api/public/formatos?slug=…Documentos de un proceso, con filtros.
/sig/api/public/formatos/{slug}Lo mismo, con el proceso en la ruta.
/healthEstado del servicio, para monitorización.

Detalle de parámetros y respuestas en API pública.

El prefijo /sig

La aplicación se escribió para vivir bajo un prefijo /sig y hoy sirve el dominio entero. Para reconciliarlo, el servidor retira el prefijo antes de resolver la ruta: las dos formas llegan al mismo sitio.

https://sigunitropico.co/gth          ─┐
                                       ├─► misma página
https://sigunitropico.co/sig/gth      ─┘

https://sigunitropico.co/api/public/procesos      ─┐
                                                   ├─► misma respuesta
https://sigunitropico.co/sig/api/public/procesos  ─┘

Los enlaces que genera el propio sistema —incluidos los del chatbot— usan la forma con prefijo (/sig/descargar/…). Ambas funcionan; conviene no mezclarlas dentro de un mismo documento.

Cómo se resuelve una petición

1

El proxy decide qué aplicación atiende

Todo el dominio va al SIG, salvo /contaduria/, que se desvía al micrositio del programa.

2

El servidor retira el prefijo /sig si viene

Ocurre antes de cualquier enrutamiento, de modo que las peticiones directas y las que llegan con prefijo se tratan igual.

3

Se buscan, en orden: API, estáticos, vistas y rutas especiales

  • Rutas de la API del chatbot y de la API pública.
  • Archivos estáticos (estilos, guiones, imágenes, documentos).
  • Vistas registradas: portada, proceso, oferta, eventos, panel, perfil…
  • Los 16 códigos de proceso, que sirven la misma vista con el proceso resuelto en el cliente.
  • Las dos formas de /descargar.
4

Se inyecta el widget del chat

Antes de entregar la página se le añade el guion del asesor virtual, excepto en el panel del chatbot y en el perfil. El resultado queda en caché en memoria.

5

Si nada coincide, la página de error

Cualquier ruta no reconocida termina en la vista 404.

Compatibilidad con enlaces antiguos

El sitio conserva varias comodidades para que los enlaces publicados en el pasado sigan funcionando.

Barra final

Las direcciones con barra al final redirigen permanentemente a la forma sin barra.

Sufijo .html

Las rutas de vista aceptan también su forma con extensión.

Rutas /pages/…

Se mantienen alias de la estructura anterior del sitio.

Descarga sin proceso

/descargar/{clave} sigue resolviendo los documentos registrados antes de la organización por proceso.

Por dónde seguir

Infraestructura

Qué hay detrás del proxy y cómo se despliega.

API pública

Los endpoints en detalle.

Enlaces de descarga

Cómo citar sin que la referencia se rompa.

Mapa del sitio

Toda esta documentación en una página.