Documentación técnica

Documentación de sigob.org. Arriba, qué trae la última entrega; abajo, la referencia de contenido, funcionalidades, tecnología y políticas. Actualizado al 31 de julio de 2026.

Estado actual

Sitio	www.sigob.org · WordPress 7.0.2 sobre PHP 8.5.6, IIS, infraestructura propia · solo HTTPS con HSTS
Contenido	24 soluciones · 9 casos de éxito · 3 publicaciones · 7 páginas
Asistente	Ito · índice de 707 fragmentos sobre 49 documentos · consulta pública con cupo diario
Portada	3,49 MB · evento `load` ~2,6 s
Accesibilidad	0 fallos de contraste WCAG AA · pendiente auditoría formal 2.1 AA

Cambios

31 de julio de 2026 — Documentos, difusión e interfaz móvil

Un solo subtítulo por solución, el mismo que muestra la portada. Antes convivían dos descripciones distintas del mismo módulo.
Requisitos de infraestructura retirados de las fichas de solución. Los campos siguen cargados, sin publicarse.
Fichas de documento con contenido propio: síntesis de dos párrafos, portada embebida —enlazada al PDF— y bloque de descarga con formato y peso.
El título de cada tarjeta del catálogo enlaza a la ficha del documento. Antes solo era clicable el botón, que en los PDF baja el archivo directo.
Compartir: menú flotante con copiar enlace, WhatsApp, LinkedIn y X, disponible en todas las páginas.
Formulario de contacto un 43% más compacto (903 → 517 px, mismos campos). El aviso de tratamiento de datos, que cruzaba la pantalla, quedó alineado con la columna de la página.
Columna de lectura de 820 px en las fichas de publicación, antes al ancho completo del contenedor.
Asistente renombrado a Ito. En la vista pública se retiraron la barra de pestañas de un solo elemento y la aclaración de alcance sobre soporte técnico.
Móvil: los tres botones flotantes quedaron alineados en una misma columna; el banner de consentimiento ya no los tapa; el selector de suites pasó de una fila con arrastre —que escondía cuatro de las seis suites— a una retícula de dos columnas.

29–30 de julio de 2026 — Rendimiento, seguridad, difusión y datos

Portada de 45,14 MB a 3,49 MB y de 36,9 s a ~2,6 s: video del hero recomprimido, imágenes a WebP y caché de estáticos. El tema versionaba sus estilos y scripts con time(), lo que anulaba por completo la caché del navegador.
Tres controles de seguridad que no protegían nada —CORS anulado por WordPress, bloqueo de acceso evadible sin cabecera Referer y enumeración de usuarios abierta— reimplementados y verificados. Se sumaron cabeceras de seguridad, CSP en modo observación y se retiraron 31 MB de archivos residuales descargables del directorio público.
Open Graph, meta descripción y JSON-LD. El sitio no emitía ninguna: cada enlace compartido aparecía sin título, sin imagen y sin descripción.
27 fallos de contraste WCAG AA a 0, más enlace de salto al contenido, etiquetas asociadas, nombres accesibles e indicadores de foco.
Formulario de contacto: cada consulta se guarda antes de intentar el envío y registra su origen; se instrumentaron eventos de analítica, que antes no existían.
Protección de datos: política publicada y consentimiento de cookies denegado por defecto con Consent Mode v2.
Asistente conversacional sobre la documentación del proyecto, con citación obligatoria de fuentes y cola de curación revisada por una persona.
Galerías de las fichas ocultas hasta renovar el material: las capturas corresponden a versiones antiguas de los sistemas. El contenido no se borró.

Métricas de la intervención

Indicador	Antes	Después
Peso de la portada en frío	45,14 MB	3,49 MB (−92,3%)
Evento `load`	36.863 ms	~2.600 ms
Video del hero	39,9 MB	2,43 MB (−93,6%)
Imágenes de soluciones	19,33 MB	6,38 MB (−67%)
Collage institucional	5,55 MB en PNG	419 KB en WebP (−92,4%)
Fallos de contraste (WCAG AA)	27	0
Alto del formulario de contacto	903 px	517 px (−43%)

Contenido y estructura

Tipo	Cantidad	Qué contiene
Soluciones	24	Reto, transformación, beneficiarios, ruta de implementación y experiencias por país
Proyectos	9	Casos de éxito con resultados medibles por país e institución
Publicaciones	3	Documentos institucionales y documentación técnica
Páginas	7	Inicio, Contacto, FAQ, Documentos, Espacio de conocimiento, Términos, Protección de datos

Taxonomías: sectores SIGOB (6 términos), países (15), líneas de trabajo (4), categorías de suite (6), tipos de documento (3) y tipos de institución.

Navegación: segmentada por tipo de institución —Presidencia, Ministerios, Gobiernos Locales, Sistema de Justicia, Parlamentos—, de modo que el visitante identifique de inmediato los casos afines a su entidad.

Funcionalidades

Ito, asistente sobre la documentación

Índice semántico de 707 fragmentos sobre 49 documentos, con gemini-embedding-001 a 768 dimensiones. Ingesta incremental cada hora.
Respuestas con gemini-3.5-flash. Si nada supera el umbral de similitud se contesta que no hay información, sin llamar al modelo.
Citación obligatoria de fuentes, agrupadas por documento.
Distingue si una repregunta se apoya en la anterior, y ofrece reiniciar el hilo.
Sugerencias de corrección a una cola de curación con registro de autoría, fecha y decisión.
Acumula 97 mensajes y 25 propuestas.

Catálogo de documentos

Reúne publicaciones, fichas de solución y casos. Buscador y filtros por tipo de documento, país e institución; los filtros de país e institución operan sobre pares de una misma implementación, para no devolver coincidencias que en realidad son dos hechos distintos. Las fichas y los casos usan portadas SVG generadas, con color según la suite.

Fichas de solución

Hasta cinco pestañas según el contenido cargado: resumen ejecutivo, experiencias destacadas, plataforma digital, ruta de implementación y galería (hoy oculta). Cada una lleva llamados a la acción que transportan la identidad de la solución hasta el formulario de contacto.

Fichas de documento

Resumen propio, portada embebida enlazada al archivo y bloque de descarga que anuncia formato y peso, generado a partir del archivo asociado.

Menú flotante en todas las páginas: copiar enlace, WhatsApp, LinkedIn y X. El enlace y el título se resuelven según la vista.

Formulario de contacto

Persiste cada consulta antes de intentar el envío por correo y registra su origen. Protegido con campo trampa, límite por IP y validación de sesión.

Servidor MCP

Expone el contenido publicado como base de conocimiento de solo lectura para clientes externos. Las garantías son de código y no de instrucciones: solo registra herramientas de lectura, consulta exclusivamente contenido publicado y aplica límite por dirección IP y topes de resultados.

Tecnología

Base

WordPress 7.0.2 · PHP 8.5.6 · IIS sobre infraestructura propia · HTTPS con HSTS.

Componentes propios

Componente	Función
SIGOB Theme	Identidad visual, plantillas de solución, caso y catálogo, pestañas, buscador, menú de compartir y componentes de portada
SIGOB Wiki	Ito: índice semántico, recuperación, generación, citas, curación y portadas generadas
SIGOB KB MCP	Servidor MCP de solo lectura sobre el contenido publicado
Formulario de contacto	Procesamiento, persistencia y envío de consultas
Acceso	Identidad en ingreso y registro; protección del alta contra automatización
Protección de datos	Consentimiento de cookies y señalización a los servicios de medición

Terceros

Advanced Custom Fields (campos estructurados de las fichas), Google Site Kit (medición) y WP Mail SMTP (correo institucional). Se retiraron los que no cumplían función: un plugin de caché para un servidor web distinto al que se usa, un formulario sin formularios creados y dos herramientas de migración activas en producción.

Operación

Ingesta del índice del asistente: tarea programada horaria, incremental por hash.
Versionado de estáticos por fecha de modificación del archivo, no por constante: con la caché de 30 días del servidor, un cambio de CSS podía tardar un mes en verse.
Respaldos por lote de despliegue, fuera del directorio público.

Políticas

Datos personales. La política publicada declara qué se recoge, con qué finalidad y hacia dónde se transfiere. Los datos llegan a Google —generación de respuestas y embeddings— bajo condiciones que excluyen su uso para entrenamiento, y a Microsoft 365 para la entrega de correo.
Medición. Denegada por defecto; se activa solo tras aceptación explícita. El rechazo es tan accesible como la aceptación.
Consulta. Ito es público, con tope diario global y por visitante. Las sugerencias de corrección requieren sesión iniciada, para preservar la trazabilidad de la cola.
Registro. Abierto por requisito histórico del asistente, con varias capas contra el alta automatizada.
Contenido. Todo cambio propuesto pasa por revisión humana antes de aplicarse. La cola es visible para el equipo; solo los curadores aprueban.

Pendientes

Renovación del material visual, para restituir las galerías de las fichas.
Unificación de dominio: el sitio responde bajo dos marcas con cadenas de redirección, lo que reparte la autoridad de búsqueda.
Motor de contenido: los nueve casos con resultados medibles son el activo más persuasivo y el menos explotado.
Embudo de conversión en la herramienta de analítica, sobre los eventos ya instrumentados.
Auditoría formal de accesibilidad conforme a WCAG 2.1 nivel AA.
Revisión legal de la política de protección de datos, hoy un borrador técnico redactado sobre el comportamiento real del sitio.

Notas técnicas

Comportamientos no evidentes, detectados al intervenir y conservados aquí porque volverían a costar tiempo:

El tipo MIME de WebP no estaba registrado en el servidor: cualquier imagen WebP devolvía 404 aunque el archivo existiera.
El protocolo de copia usado para administrar el servidor trunca las descargas en exactamente 204.800 bytes, dejando archivos que parecen válidos.
El tema impone estilos al elemento header de forma global y forzada: cualquier componente con cabecera propia los hereda.
Una transición sobre todas las propiedades congela lo que se aplique mientras el elemento está oculto. El botón de volver arriba declara transition: .3s a secas y arranca invisible: los desplazamientos que se le aplicaban en ese estado quedaban sin efecto, incluso forzados en línea.
Un ResizeObserver sin referencia guardada puede ser recolectado y dejar de avisar en silencio.
El formulario de contacto vive en el contenido de su página, así que pasa por wpautop: WordPress inserta un salto de línea tras cada etiqueta y envuelve piezas sueltas en párrafos que se vuelven celdas de la retícula.
El contenedor del tema no lleva relleno lateral en pantalla angosta: el texto llega pegado a los bordes salvo que la plantilla lo reponga.

Actualizado el 31 de julio de 2026.