Saltar al contenido principal
Datos abiertos · Consulta pública

Traducción automática, nnojotsü aapünüin. Tü ashajuushikat oficial shia tü español. Airüin tü püshikat español.

Gobierno de Colombia · Ministerio de Comercio, Industria y Turismo
iNNpulsa Colombia
Ruta Milagro - Regiones Más Competitivas

Convenio NPA-045-2026 · Componente 3 — Actualización de Visores

Ficha técnica del proyecto

Qué es la plataforma de los Visores Territoriales, su arquitectura tecnológica, metodología de datos oficiales y fuentes verificables, y las respuestas a las preguntas más frecuentes.

Ruta Milagro - Regiones Más Competitivas

kanakiasü projietachi

Identificación de la plataforma y su marco contractual. Corte de datos vigente: 2025.

anüliaaVisores Territoriales — Ruta Milagro - Regiones Más Competitivas
aashaje'eraaBien público digital (nota al pie 8 del convenio): acceso, uso y aprovechamiento libre por los territorios, con consulta organizada, actualizada y trazable.
makuwa'ayawataliiConvenio NPA-045-2026 (iNNpulsa Colombia · FUNDETEC), Componente 3 «Actualización de Visores», páginas 22–24; en el marco de Ruta Milagro - Regiones Más Competitivas del MinCIT.
aja'apüüyaawaseCinco Visores de Apoyo: V1 Economía, empleo y productividad · V2 Brechas de competitividad (IDC) · V3 Caracterización sectorial · V4 Brechas y vocaciones territoriales · V5 Cadenas productivas. Serie 2016–2025, 32 departamentos y Bogotá D.C.
anaajaaleevisores.regionesmascompetitivas.co (HTTPS, certificado automático Let's Encrypt)
achikijiaakuwa'ipaPHP 8.3 con arquitectura MVC (Composer, PSR-4) · Base de datos MariaDB · Servidor Caddy + PHP-FPM · ETL en Python (APIs Socrata de datos.gov.co, DIAN, GEIH, CPC, SECOP) · Visualización con Chart.js, exportación a Excel con ExcelJS y a PDF con jsPDF, y mapa coroplético SVG propio sobre GeoJSON · API REST v1. Detalle por capa en la sección 2.
anüliaaCada conjunto de datos vive como una tabla propia en la base: hoy 24 tablas con 693.607 filas consultables por SQL y por la API, y su diccionario de columnas registrado. Los archivos de datos versionados con integridad sha256 son respaldo derivado, no la fuente de servicio. Los visores nunca leen archivos Excel. Detalle vivo en la aa'insekiiwaa y en anüliaaDANE · DNP (Observatorio del Sistema de Ciudades) · Consejo Privado de Competitividad (IDC e ICC) · CRC/MinTIC · DIAN · UPRA · SECOP · registros sectoriales — conforme a la nota al pie 9 del convenio, con trazabilidad y consistencia metodológica.
akaralaajiSesiones endurecidas, contraseñas ARGON2ID, CSRF, CSP con nonce, rate limiting, roles (admin/editor/lector), API keys con hash SHA-256 y auditoría de acciones.
anüliaaManual instructivo + un manual por visor · Informe de actualización (E10) · Arquitectura, ETL, API y guía de transferencia en el repositorio del proyecto.
anüliaaAPI REST pública (/api/v1/capabilities), export CSV/JSON para Power BI y Tableau y llms.txt para navegación agéntica.

2 · Arquitectura de la solución, stack y sostenibilidad

Cómo se procesa y se actualiza la información de extremo a extremo, con qué tecnología, y por qué la actualización se sostiene sola una vez cerrado el convenio.

2.1 · Flujo de procesamiento y actualización (enfoque ETL)

Arquitectura de la solución de los Visores Territoriales: el camino del dato desde las fuentes oficiales hasta los cinco visores web, que son el entregable, y hacia los canales de consumo opcionales que se conectan a la misma API. Cinco etapas encadenadas de izquierda a derecha: 1, fuentes oficiales (datos.gov.co, DANE, DIAN, Consejo Privado de Competitividad, UPRA, DNP, SECOP y el Ministerio TIC, en formatos API, CSV, XLSX y ZIP); 2, procesamiento que extrae y valida el dato, unifica los municipios con el código DIVIPOLA, depura duplicados, y carga y versiona cada archivo con su huella digital (sha256); 3, una sola base de datos con una tabla propia por cada conjunto de datos (más de medio millón de filas consultables por SQL y por la API), y los archivos de datos versionados con huella digital como respaldo; 4, publicación por la API de datos abiertos (JSON y CSV), filtrando al corte de vigencia público y con roles y claves de acceso; 5, el entregable: los cinco visores web, construidos a la medida con la librería gráfica Chart.js y un mapa SVG propio, enlazables desde competitivas.gov.co. Aparte del flujo principal, dibujados con trazo discontinuo para indicar que no son entregables equivalentes, los canales de consumo opcionales —Power BI, Tableau, Excel y otros portales y tableros— que se alimentan de la misma API mediante una clave de acceso. Un proceso programado semanal detecta si una fuente publicó un corte nuevo y avisa; la carga la decide el equipo. La actualización se hace desde el panel de gestión sin perfil técnico: formulario dato a dato o archivo Excel/CSV con la plantilla del conjunto, validado antes de aplicar; todo queda versionado, auditado y es reversible. Vigilancia semanal detecta un corte nuevo y avisa 1 · Fuentes oficiales datos.gov.co (Socrata) DANE · GEIH · DIAN CPC (IDC · ICC) · UPRA DNP · SECOP · MinTIC API · CSV · XLSX · ZIP 2 · Procesamiento extrae y valida unifica municipios depura duplicados carga y versiona huella digital (sha256) 3 · Base de datos una sola fuente de verdad una tabla por cada conjunto de datos +500 000 filas respaldo: archivos versionados (sha256) 4 · Publicación API de datos abiertos JSON · CSV filtra al corte público roles y claves de acceso 5 · Entregable 5 visores web a la medida (Chart.js) mapa SVG propio competitivas.gov.co Canales opcionales Power BI · Tableau Excel · CSV portales y tableros vía API con clave Vías 2 y 3 · Actualización sin perfil técnico formulario dato a dato · archivo Excel/CSV validado todo queda versionado, auditado y es reversible
Flujo de una actualización, de extremo a extremo. El bloque sólido del final es el entregable: los cinco visores web. El bloque de trazo discontinuo son canales de consumo opcionales —Power BI, Tableau, Excel u otros portales— que se alimentan de la misma API con una clave de acceso; no son el instrumento en el que se construyeron los visores. Las vías de entrada —la vigilancia automática (vía 1) y la actualización desde el panel, por formulario o por archivo (vías 2 y 3)— convergen en la misma base de datos y salen por la misma capa de publicación: no hay caminos paralelos ni copias fuera de control. Descripción textual completa a continuación.
  1. Extracción. Los extractores en Python consultan las APIs Socrata de datos.gov.co y descargan los archivos publicados por DANE (GEIH, EVA), DIAN, el Consejo Privado de Competitividad (base del IDC), SECOP y MinTIC. Cada fuente está registrada —con su URL, su identificador y su campo de vigencia— en un catálogo administrable desde el panel: agregar o cambiar una fuente no exige tocar código.
  2. Transformación. Se homologan los nombres de departamento contra DIVIPOLA, se tipan y deduplican los registros, se valida cada fila contra el contrato de columnas del dataset y se calcula el sha256 del artefacto resultante. Toda transformación es reproducible: mismo insumo, mismo hash.
  3. Carga. Cada conjunto se proyecta a su propia tabla en MariaDB —con los nombres de columna, los tipos y la columna de vigencia registrados—, y esa tabla es la fuente que sirve al visor y a la API. El archivo versionado con su sha256 queda como respaldo, para descargas en bloque y para restaurar una versión exacta. La poda al corte público es una condición de la consulta, no un segundo archivo que pueda quedar desincronizado. Ningún visor lee jamás un archivo Excel.
  4. Publicación. La API REST v1 y el gateway de datos sirven lo que hay en la base, aplicando la poda por corte de vigencia público, los roles y las claves de API. Cada publicación genera una versión reversible.
  5. Consumo. El entregable del convenio son los cinco visores web, construidos a la medida con una librería gráfica (Chart.js) y un mapa coroplético propio sobre la base de datos. Power BI, Tableau y Excel no son el instrumento en el que se construyeron: son canales de consumo opcionales que se conectan a la misma API con una clave de acceso, en JSON o CSV, igual que cualquier otro portal o tablero. Todos leen exactamente la misma fuente de verdad.
  6. Vigilancia. Un proceso programado semanal compara la vigencia cargada contra la disponible en cada fuente oficial y, si detecta un corte nuevo, lo avisa y deja el resultado verificable en un registro de chequeos. La incorporación es una decisión del equipo: se carga desde el panel, con validación previa y versión reversible. Así, ningún año nuevo entra al visor sin que alguien lo haya revisado.

2.2 · De dónde sale el dato: fuentes oficiales verificadas

Las fuentes que alimentan los visores, con la dirección exacta de donde se lee cada dato y la vigencia que aporta cada una. Todas son públicas y ninguna requiere credenciales. Esta tabla se imprime desde el mismo registro que administra la vista Fuentes oficiales del panel, de modo que no puede declarar una fuente distinta de la que está en uso; si una entidad cambia una dirección, se corrige en un formulario — sin desarrollador y sin despliegue. La misma información, fuente por fuente y con la explicación de cómo se obtuvo, está en Metodología y fuentes.

akuyawajiaaanüliaae'rajaaleeanaajaaleewünaaVigencia que aporta
Todos Libros MÁgil — insumo oficial de los 5 visores iNNpulsa Colombia · MinCIT innpulsacolombia.com Página oficial V1 2016–2023 (8 años) · V2 2018–2023 (6) · V3 2023 · V4 y V5 sin año
1 PIB departamental por actividad económica DANE — Dirección de Síntesis y Cuentas Nacionales dane.gov.co Descarga oficial 2005–2025 (anexo 2025 preliminar)
1 Personas ocupadas por departamento y rama (GEIH) DANE — Gran Encuesta Integrada de Hogares dane.gov.co Descarga oficial 2016–2025
1 Mercado laboral · año móvil de las 32 ciudades DANE — Gran Encuesta Integrada de Hogares dane.gov.co Descarga oficial 2016–2025 (año móvil)
2 Índice Departamental de Competitividad (IDC) Consejo Privado de Competitividad · U. del Rosario compite.com.co Página oficial edición 2026 (datos 2019–2025)
3 GEIH — ocupados (microdatos) DANE microdatos.dane.gov.co Página oficial 2024–2025 (12 meses por año)
3 Exportaciones — microdatos EXPO DIAN · DANE microdatos.dane.gov.co Página oficial 2021–2025 (12 meses por año)
3 Exportaciones agrícolas por departamento Ministerio de Agricultura y Desarrollo Rural datos.gov.co API de datos abiertos 2024–2025
3 Importaciones — microdatos IMPO DIAN · DANE microdatos.dane.gov.co Página oficial 2021–2025 (12 meses por año)
4 Evaluaciones Agropecuarias (EVA) UPRA · Ministerio de Agricultura y Desarrollo Rural upra.gov.co Descarga oficial 2019–2025 (base agrícola)
4 Cobertura móvil por centro poblado y operador CRC · Ministerio TIC — POSTDATA postdata.gov.co Descarga oficial 2023-T1 a 2025-T4 (cargados los cierres 2023, 2024 y 2025)
4 Observatorio del Sistema de Ciudades DNP — Departamento Nacional de Planeación osc.dnp.gov.co Página oficial sin vigencia anual (estructural)
4 Índice de Competitividad de Ciudades (ICC) Consejo Privado de Competitividad · U. del Rosario compite.com.co Descarga oficial edición 2025
5 SECOP II — procesos de contratación Colombia Compra Eficiente datos.gov.co API de datos abiertos 2024–2025

Un proceso semanal compara el año que está en el visor contra el año que ya publicó la fuente y avisa cuando aparece un corte nuevo; la carga la decide y la hace el equipo desde el panel. Varias de estas fuentes no admiten consulta automatizada —el DANE rechaza los accesos de programas y publica sus anexos para descarga; el Consejo Privado de Competitividad publica por informe anual—: se supervisan a mano y su archivo se carga por el panel, que es la vía prevista para la actualización.

anajiaapülee

Todas las piezas son software de código abierto, sin costo ni renovación de licencia para el Estado. Cada capa es reemplazable de forma independiente: ninguna decisión ata a un proveedor.

kulaalatekkonolüjiajüpüshuwa'a
Ingesta / ETL Python 3 — extractores por fuente (cliente Socrata/SoQL, lectores CSV/XLSX/ZIP) + vigilante de cortes Estándar de facto de la analítica pública; scripts legibles y reejecutables desde consola por cualquier equipo técnico. Licencias permisivas. Sin herramienta ETL propietaria: no hay servidor de orquestación que licenciar ni renovar.
Persistencia MariaDB — una tabla propia por conjunto de datos (24 hoy) con su diccionario de columnas versionado, más los indicadores como registros ordenados (una fila por año, territorio e indicador) y los archivos de datos versionados con sha256 como respaldo SQL estándar, respaldable con mysqldump y restaurable en cualquier motor compatible. Esquema versionado en migraciones idempotentes. GPL v2 — sin costo.
Aplicación PHP 8.3, arquitectura MVC propia (Composer, PSR-4) — visores públicos, panel de gestión y asistente de carga Sin framework pesado ni dependencias con ciclo de vida corto: el código es el propio activo transferible y auditable.
Servidor Caddy + PHP-FPM, TLS automático (Let's Encrypt) awalaajiaakuwa'ipaashajeerülee
Visualización Chart.js 4.4.3 (series y tableros) + ExcelJS 4.4.0 (libro de Excel multihoja) + jsPDF 2.5.2 con autotable (PDF con membrete institucional), ambos de carga perezosa + mapa coroplético SVG propio sobre GeoJSON DIVIPOLA — y salida nativa a Power BI, Tableau y Excel vía API JSON/CSV Doble vía deliberada: el visor público no exige al ciudadano ninguna licencia; el analista del Ministerio conecta Power BI a la misma API sin duplicar el dato (Obtener datos → Web). La definición del motor exigible (consulta RT‑4) sigue abierta en la mesa técnica: la arquitectura admite cualquiera sin rehacer la ingesta.
Interoperabilidad API REST v1 autodescriptiva · gateway de datos · llms.txt Enlazable y federable desde competitivas.gov.co por URL estable. La API es el contrato: cualquier consumidor futuro (un portal, un tablero, otra plataforma) se conecta sin tocar la plataforma.
Automatización cron del sistema (vigilancia semanal de cortes) + despliegue automático por webhook Sin planificador propietario: una línea de cron que cualquier administrador entiende, migra y audita.

2.4 · Quién actualiza los datos y qué necesita saber

La mesa técnica pidió (RF‑3) que una persona responsable pudiera actualizar la información sin conocimientos de SQL. Se implementaron dos formas, no una, porque no es lo mismo corregir un dato que cargar una vigencia completa. Ninguna exige perfil técnico:

✍️ Dato a dato, en un formulario

En la vista Registros del panel, el funcionario ve los datos del visor en una tabla con filtros y corrige un valor en la misma fila, agrega un registro o lo elimina. Todo por formulario: sin archivos, sin plantillas, sin instalar nada.

El formulario está hecho para que sea imposible equivocarse en lo técnico: el indicador y el departamento se eligen de listas; los municipios se filtran solos según el departamento; el código DIVIPOLA se llena automáticamente (nadie lo escribe); y la unidad, si se deja vacía, la hereda del catálogo. Al eliminar, la plataforma describe en palabras qué se va a borrar. El visor se actualiza solo: no hay un paso de «publicar» que se pueda olvidar.

📄 Muchos datos, con la plantilla del visor

Para cargar muchos registros de una vez, la plataforma entrega la plantilla ya hecha: al elegir el visor en el asistente de carga aparecen los botones de descarga en Excel (XLSX) y CSV, ajustados a ese conjunto de datos.

Cada plantilla se genera desde la definición real del conjunto —por eso no puede quedar desactualizada— y trae las columnas exactas en su orden, hasta cinco filas reales de ejemplo y una hoja «Instrucciones» que explica, columna por columna, el tipo de dato, si es obligatoria y cómo diligenciarla. Se llena en Excel, se sube, y la plataforma valida antes de aplicar: si algo está mal, no habilita el botón y dice qué corregir.

En ambos casos el cambio queda versionado, auditado y es reversible: el costo de equivocarse es un clic, no un incidente. En resumen, quien actualiza no necesita saber qué es una base de datos, ni SQL, ni abrir una consola, ni conocer los códigos del territorio: necesita un navegador y, para la carga masiva, Excel. Los términos técnicos de esta página están explicados en el glosario.

awalaajiaakuwa'ipaashaje'eraa

El requisito no es que la plataforma funcione al cierre, sino que siga actualizándose sin el operador. La arquitectura ataca las dependencias que suelen matar una plataforma de datos: la persona que sabía, el proveedor que licenciaba, el archivo que nadie encuentra y el proceso que nadie documentó.

wanaawashi

La vía principal de actualización es automática: el proceso programado semanal detecta el corte nuevo en la fuente oficial, lo ingesta y regenera los artefactos públicos. Si nadie hace nada, la plataforma igual se entera de que hay dato nuevo y deja el hallazgo registrado.

🙋 No exige perfil técnico

Las dos vías del día a día —formulario y plantilla— las opera cualquier funcionario autorizado con un navegador (ver 2.4). Para los cambios de fondo queda una tercera vía: un equipo de TI reejecuta los procesos documentados, sin depender del operador actual.

🔓 No depende de un proveedor

Cero licencias comerciales en toda la pila. Las fuentes oficiales se administran desde el panel (URL, identificador y campo de vigencia), no desde el código: si una entidad cambia una URL, se corrige en un formulario, sin desarrollador y sin despliegue.

epü'ipajülü

Los activos se transfieren desbloqueados (págs. 40–43 del convenio): código fuente, scripts y consultas, DDL y dumps, modelo ETL documentado, manuales y acta firmada. Cualquier equipo puede levantar la plataforma completa en infraestructura propia siguiendo la guía de transferencia.

memüyaapülee

Todo el conocimiento operativo está escrito y versionado junto al código: documentos de arquitectura, ETL, API, manual del administrador y catálogo de scripts. La documentación viaja con la plataforma, no en un correo.

🛡️ No depende del azar

La verdad publicada es reproducible: cada dato declara su fuente, cada artefacto su sha256 y cada publicación su versión. Una discrepancia futura se audita, no se discute — y se corrige por carga versionada.

Los puntos de gobernanza que no son técnicos —quién aloja (RG‑1) y quién administra la plataforma tras la entrega (RG‑2)— son decisiones institucionales de MinCIT/iNNpulsa que siguen abiertas. La plataforma está construida para soportar cualquiera de los escenarios: subdominio propio del Ministerio, infraestructura de iNNpulsa o continuidad del alojamiento actual, sin cambios en la ingesta ni en la API.

2.6 · Seguridad y disposición al escaneo de vulnerabilidades

La plataforma se diseñó bajo el supuesto de que sería auditada. El operador queda a disposición de la Oficina de Sistemas de Información del Ministerio para el escaneo de vulnerabilidades que esta disponga —en la ventana, con la herramienta y bajo las reglas que el Ministerio defina— y para la remediación de los hallazgos dentro del convenio. Controles ya implementados:

a'wanajiaakuwa'ipaHTTPS obligatorio con certificado automático, HSTS, redirección forzada desde HTTP y cabeceras nosniff, frame-ancestors y referrer-policy.
aküliayuushiContent Security Policy estricta: sin 'unsafe-inline' ni en scripts ni en estilos — cada script en línea va firmado con nonce por petición y cada estilo heredado con su hash SHA-256. Cero manejadores de eventos en línea.
ejepilüsqlAcceso a datos exclusivamente por consultas parametrizadas (PDO sin emulación de prepares). Los identificadores de tabla y columna nunca provienen de la petición.
akülikainchiContraseñas con ARGON2ID, sesiones endurecidas (cookie __Host-, HttpOnly, SameSite, almacén aislado), protección CSRF por formulario y límite de tasa en los puntos sensibles.
akaratüliasaRoles admin / editor / lector; claves de API con alcances y cuota, guardadas solo como hash SHA-256 (el valor en claro se muestra una única vez). Los artefactos nunca se sirven estáticos: pasan por un gateway con cierre por defecto ante error.
anüliaaBitácora de auditoría de las acciones del panel, versionado de cada carga con reversión e integridad sha256 por artefacto.
ajapükajatüCredenciales y claves de proveedores solo en base de datos o en archivos fuera del árbol web con permisos restringidos; jamás en el repositorio, en los registros ni en la auditoría.
a'latüleePanel y API de gestión detrás de autenticación; directorios sensibles no servibles; el subdominio no envía correo (SPF -all + DMARC p=reject + CAA).
anaatuprüleeLa plataforma fue sometida a una auditoría técnica externa de seguridad, rendimiento, accesibilidad y buenas prácticas, con resultado satisfactorio en todos los pilares y sin recomendaciones abiertas. Es un antecedente, no un sustituto del escaneo oficial de la OSI.

Entregable asociado: la documentación técnica completa (arquitectura, modelo ETL, API, esquema de base de datos, manual del administrador, catálogo de scripts y guía de transferencia) se entrega versionada junto al código y hace parte del acta de entrega, conforme a las páginas 40–43 del convenio.

Supervisión y cumplimiento contractual

La matriz técnica de cumplimiento punto por punto del Convenio 521 de 2025 / NPA-045-2026, los entregables (E10, E11, E12) y los requerimientos funcionales de la mesa técnica han sido consolidados en el módulo interno de supervisión.

Para mantener la experiencia ciudadana y territorial enfocada en los visores, los datos abiertos y la metodología, todos los aspectos demostrativos del convenio se encuentran disponibles en la vista interna de gestión para la interventoría, supervisión del MinCIT e iNNpulsa Colombia.

5 · Manual de estilo: alineación con los sitios GOV.CO

La plataforma aplica el Kit de interfaz de usuario del Estado, en su versión 9.2, y las guías de accesibilidad y usabilidad de la Agencia Nacional Digital:

🏛️ Barra superior GOV.CO

Todas las páginas llevan la barra institucional con el logotipo de GOV.CO enlazado al portal único del Estado, en el color y las medidas que fija el Kit. Los controles de accesibilidad —contraste y tamaño de texto— van en ella, en todas las páginas.

ee'iyalaayawüinkat

Declara la entidad responsable con sus datos de contacto, código postal, horario, conmutador, línea gratuita, línea anticorrupción y correo de notificaciones judiciales; el bloque de Políticas · Mapa del sitio · Términos y condiciones · Accesibilidad; y los logotipos de GOV.CO y de la marca país Colombia.

ajapüüshiwa'a

El color asignado al Ministerio de Comercio, Industria y Turismo en el Manual de imagen de Gobierno, y las dos únicas familias tipográficas que admite el Kit: Nunito Sans para títulos y Verdana para el texto. Ambas se sirven desde el propio servidor, sin depender de terceros.

♿ Accesibilidad nivel AA

Conforme al artículo 3 de la Resolución 1519 de 2020: salto al contenido principal, navegación completa por teclado, foco visible, contraste verificado y estructura semántica. El estado, los pendientes y el canal de reporte están en la Declaración de Accesibilidad.

anakiaapala

HTTPS obligatorio con certificados automáticos, cabeceras de seguridad estrictas (CSP con nonce, HSTS, nosniff), protección de formularios y auditoría — prácticas exigibles a un servicio ciudadano digital.

anüliaapülaa

Alineado con la política nacional de datos abiertos: consulta libre sin registro, API pública autodescriptiva, exportes reutilizables (CSV/JSON) y metadatos de fuente por cada dato publicado.

6 · El panel de gestión y el glosario

Qué vistas tiene la plataforma para administrarla, y qué significa cada término técnico o sigla que aparece en esta página.

laülikanaapüüyaawaseis

El panel de gestión requiere cuenta y tiene tres roles: administrador (todo), editor (datos y cargas) y lector (solo consulta). Ninguna de estas vistas exige conocimientos técnicos, salvo donde se indica.

anainjaanüliaajara
Panelnüyaallu'inkatükajatüsüpüshuwa'a
RegistrosVer, corregir, agregar y eliminar datos dato a dato, por visor y con filtros. La vía del día a día (ver 2.4).achiiruaajiaa
Cargar archivoAsistente de 3 pasos (visor → vigencia → archivo) con descarga de la plantilla del visor, validación previa con semáforo y aplicación reversible.achiiruaajiaa
Historial de cargasQué se cargó, cuándo, quién y en qué estado; permite revertir.süpüshuwa'a
VisoresEstado, cifras y analítica de cada visor; edición de su ficha.achiiruaajiaa
IndicadoresEl catálogo oficial de indicadores por visor. Es la lista que alimenta el formulario de Registros: si un indicador no está aquí, no se puede cargar. Uno inactivo deja de ofrecerse sin borrar su historia.anüliaa
Fuentes oficialesAdministra de dónde sale el dato (nombre, entidad, visor, dirección y campo del año) y prueba la conexión en vivo, listando las vigencias disponibles (ver 2.2).te'ejenaallii
Página públicaEdita los textos de la portada, el pie y las tarjetas de los visores, y sube los manuales en PDF. Un campo vacío devuelve el texto original. La marca institucional no es editable.amüinirajülü
Conjuntos de datosInventario técnico completo; ofrece las plantillas por conjunto.süpüshuwa'a
Usuariosanüliaaküliakaiwaanüliaa
Claves de APIGenera y revoca claves para consumo programático (Power BI, Tableau, otros sistemas), y decide si el acceso a los datos se hace con clave o abierto sin credencial —esto último cuando la supervisión lo autorice—. En la base solo queda el resumen cifrado de cada clave.anüliaa
Proveedores de IAEnciende o apaga la ayuda opcional de IA. Hoy está apagada: es un valor agregado que la supervisión del convenio todavía no ha autorizado. Si se autoriza, funciona con un modelo instalado en el propio servidor y ninguna consulta sale de él.anüliaa
Estadoaapajülü', palvelatüjatü, laülaaweepalaakuwa'ipiaasepaanüliaa
AuditoríaQuién hizo qué y cuándo, con el antes y el después de cada edición.süpüshuwa'a

anüliaamaajatü

Esta página está escrita para que la entienda cualquier lector, sea o no del área técnica. Aquí se explica, en lenguaje llano, cada término especializado que aparece en ella.

anüliaapala'ajatü

MinCITMinisterio de Comercio, Industria y Turismo.
iNNpulsa ColombiaEntidad del Gobierno para el emprendimiento y la competitividad; suscribe el convenio y supervisa.
Ruta Milagro - Regiones Más CompetitivasEstrategia del MinCIT para la planeación del desarrollo productivo regional.
Convenio NPA-045-2026El convenio de cooperación que enmarca este trabajo. Su «Componente 3» es la actualización de los visores.
CRCIComisiones Regionales de Competitividad e Innovación: las instancias regionales que usan los visores.
magüliMetodología Ágil Ajustada, la metodología de la estrategia. Los «libros MÁgil» son los archivos Excel que iNNpulsa entregó como insumo oficial.
DANEDepartamento Administrativo Nacional de Estadística: la autoridad estadística del país.
DNPejepüsepe'ülaawase
DIANDirección de Impuestos y Aduanas Nacionales.
MinTIC · UPRAMinisterio de Tecnologías de la Información y las Comunicaciones · Unidad de Planificación Rural Agropecuaria.
CPCConsejo Privado de Competitividad: entidad privada que publica el IDC.
yolu'uchonniConfederación de Cámaras de Comercio; opera el RUES.

Fuentes, índices y datos del territorio

DIVIPOLADivisión Político-Administrativa: el catálogo oficial del DANE que asigna un código único a cada departamento y municipio. Sirve para que «Bogotá D.C.», «Bogota» y «11» se entiendan como el mismo territorio. Quien carga datos nunca lo escribe: elige el municipio de una lista y el código se llena solo.
karaloutashajaaReconocer que dos formas de escribir un mismo territorio son la misma (p. ej. «Valle» y «Valle del Cauca») y unificarlas al código oficial.
PIBProducto Interno Bruto: el valor de lo que produce un territorio.
IDCÍndice Departamental de Competitividad, del Consejo Privado de Competitividad y la Universidad del Rosario: mide la competitividad de los 32 departamentos y Bogotá D.C. y es la fuente de las brechas del Visor 2.
GEIHGran Encuesta Integrada de Hogares (DANE): de ahí sale el empleo.
Población en edad de trabajarLas personas de 15 años o más, que son a quienes la encuesta de hogares pregunta si trabajan. No incluye a los menores de esa edad.
a'wanülüüpiakatüDe cada 100 personas en edad de trabajar, cuántas tienen trabajo. Es un porcentaje, no un número de personas.
a'yataalaaQuienes tenían un trabajo o estaban trabajando en el periodo de referencia. Es la medida de empleo que usan los visores.
akatkulaajiaaDistintivo que el visor pone a una cifra que calcula esta plataforma en vez de tomarla publicada. Aparece, por ejemplo, en el empleo de los territorios donde la encuesta de hogares solo tiene muestra en la capital: allí la cifra se reconstruye a partir de ella, con el método que declara el entregable original. Sirve para que nadie confunda un dato calculado con uno publicado por la fuente.
EVAEvaluaciones Agropecuarias Municipales (UPRA/MinAgricultura): área y producción agrícola.
RUES · CIIURegistro Único Empresarial y Social (el registro de empresas) · Clasificación Industrial Internacional Uniforme (el código de la actividad económica de una empresa).
SECOPSistema Electrónico de Contratación Pública: dónde queda registrada la contratación del Estado.
Julai - KalaEl año al que corresponde un dato. El «corte público» es hasta qué año ve el ciudadano.
anaatuushiDatos ya cargados que todavía no son públicos: esperan la validación de la mesa técnica.
anüliaakaiwa'aLa secuencia de años de un mismo indicador, que permite comparar en el tiempo.
anüliaaLo que se mide (p. ej. «PIB per cápita»). Solo existen los del catálogo oficial de cada visor.
a'wanajüleeLa tabla de datos de un visor, organizada como año × territorio × indicador.
aja'apüüyaawaseEl grupo temático al que pertenece un indicador. En el Visor 2, los 45 indicadores de competitividad se agrupan en 6 dimensiones (educación media y superior, capital humano, eficiencia del mercado y sistema financiero, infraestructura y adopción TIC, sostenibilidad ambiental, e innovación y dinámica empresarial). Cuando una gráfica muestra dimensiones, cada barra resume varios indicadores y lo declara entre paréntesis.
Grupo de comparación · estructuraCada departamento se compara con los que tienen una estructura productiva similar, no con todo el país. Son tres grupos definidos por el Ministerio de Comercio, Industria y Turismo según la densidad empresarial y la concentración institucional del departamento.
WünaapüüyaLa línea de referencia contra la que se mide un departamento. En el análisis estático es el promedio del indicador dentro de su grupo de comparación; en el dinámico es el departamento con el mejor puntaje del país en el último año medido.
achikanainjiaLa distancia entre el valor del departamento y la frontera de su grupo, en un año concreto. Negativa indica rezago; positiva, ventaja.
lüükajatüLa diferencia entre el ritmo de crecimiento del departamento y el del referente nacional, a lo largo de toda la serie. Dice si se está acercando o alejando, no dónde está hoy.
manatueje'eraaCómo se clasifica la brecha dinámica: converge si el departamento se acerca al referente, diverge si se aleja y mantiene el paso si crece a un ritmo similar. El umbral que separa los tres casos lo define la fuente.
Grupo de comparación · estructura CRCILos tres grupos en que el Ministerio de Comercio, Industria y Turismo reparte los departamentos según su densidad empresarial y su concentración institucional. Los visores comparan cada departamento con el promedio de su grupo, no con el país entero: es más justo medirse contra territorios parecidos.
ppü'uwainbaraliiLa región de referencia contra la que se mide cuánto produce en promedio cada trabajador. Un departamento se acerca a ella si su productividad crece más rápido, y se aleja si crece más despacio.
nonminasanainjiaLa productividad calculada dejando fuera el sector minero, cuyos ciclos de precios distorsionarían la comparación entre territorios. Es la medida que usan los visores.
Precios corrientes · precios constantesCorrientes: el valor a los precios del propio año; sirve para ver cuánto pesa cada actividad dentro de un año. Constantes: el valor descontando la inflación; sirve para comparar años entre sí.
anüliaapülaaCuando un sector pesa más dentro de un departamento de lo que pesa dentro del país. Señala en qué está especializado ese territorio.
eepüje'ewaiashajiaQué tan diverso y exclusivo es el conocimiento que hace falta para producir algo. Cuanto más complejo un producto, menos territorios saben hacerlo y más difícil es de imitar.
e'raajülüCombina la complejidad de un sector con la distancia: qué tan cerca están las capacidades que exige de las que el territorio ya tiene. Un sector complejo y cercano es una apuesta razonable; uno complejo y lejano, difícil.
anüliaamaaCuánto depende un sector de otros y cuántos dependen de él. A más encadenamientos, más arrastra al resto de la economía cuando crece.
a'yataaleAquello para lo que un territorio está mejor dotado, visto en dónde se concentran realmente sus empresas. Cruzarla con las brechas muestra qué apuesta productiva está frenada por un problema concreto.
ICC · Índice de Competitividad de CiudadesÍndice del Consejo Privado de Competitividad y la Universidad del Rosario que evalúa las 32 ciudades capitales y sus áreas metropolitanas. No es el mismo que el IDC, que mide departamentos: no son comparables entre sí.
pp.'üinkajatüLa unidad en que se expresan las brechas. Es la diferencia entre dos porcentajes: pasar del 10 % al 13 % es una subida de 3 puntos porcentuales, no del 3 %.
datos.gov.coEl portal de datos abiertos del Estado colombiano, de donde se leen varias fuentes.
Socrata · SoQLLa tecnología con la que funciona datos.gov.co y su forma de consultarla: permite pedir solo los datos necesarios, sin descargar todo.
anüliaaluwa'aUn grupo de datos que va junto y se consulta junto (por ejemplo, «PIB, ocupados y productividad por departamento»). Cada conjunto tiene su propia tabla en la base y su propio diccionario de columnas.
anüliaaLa columna que indica a qué año pertenece cada fila. No todos los conjuntos la tienen: en algunos el año va en el nombre de la columna (por ejemplo «ocupados 2025») y otros no tienen año porque son catálogos.
aipiaajatüLos registros uno por uno, sin agregar (por ejemplo, cada declaración de exportación). Se descargan completos para analizarlos; no se consultan dato a dato.

anakiaapalaalüinkaja

anüliaaExtraer, Transformar y Cargar: el proceso que toma el dato de la fuente oficial, lo ordena y lo guarda en la base de datos. Es «la tubería» del dato.
Base de datos · MariaDBDonde vive el dato de forma organizada y consultable. La nuestra es MariaDB, de código abierto.
anüliaaEl lenguaje con que se consulta una base de datos. Ningún funcionario necesita saberlo: para eso están el formulario y las plantillas.
API · API RESTUna «ventanilla» automática por la que otro programa (Power BI, Tableau, una página) pide los datos y los recibe al instante, sin intervención humana.
Clave de acceso · clave de APIUna contraseña larga que se entrega a cada entidad para consultar los datos por la ventanilla automática. No restringe el dato —que es público en origen— sino que atribuye cada consulta a quien la hizo, con su límite de uso y su registro, mientras la publicación abierta no esté formalizada. La plataforma guarda solo un resumen cifrado de la clave; el valor completo se muestra una única vez al crearla.
JSON · CSV · XLSX · ZIPFormatos de archivo. JSON: el que entienden los programas. CSV: texto separado por comas, lo abre Excel. XLSX: Excel. ZIP: archivo comprimido.
anüliaaEl archivo Excel o CSV que la plataforma genera con las columnas exactas de un visor, ejemplos e instrucciones, para que solo haya que llenarlo.
kontrakto'uyaaLa definición de qué columnas tiene un conjunto, en qué orden y de qué tipo. Es contra esto que se valida un archivo cargado.
a'ttaayaaEl archivo de datos que la plataforma guarda y versiona como respaldo. Desde julio de 2026 la fuente que sirve al visor es la tabla de la base de datos; el archivo se conserva para descargar un conjunto completo de una vez y para poder restaurar una versión exacta.
significadoUna «huella digital» del archivo: si cambia un solo carácter, la huella cambia. Sirve para probar que el dato no se alteró y para restaurar una versión exacta.
Versionado · revertirCada cambio queda guardado como una versión; «revertir» es volver a la anterior, con la huella verificada.
aluwataashajiaO se aplica todo el cambio, o no se aplica nada: nunca queda a medias.
a'ttaayaalaanüliaamaajatü
PHP · Python · JavaScriptLenguajes de programación. PHP: la aplicación web. Python: el ETL. JavaScript: los gráficos en el navegador.
MVCForma estándar de organizar el código para que otro equipo pueda leerlo y mantenerlo.
Caddy · PHP-FPMEl servidor web que atiende las visitas y renueva solo el certificado de seguridad.
Chart.js · ExcelJS · jsPDFLibrerías gratuitas: la primera dibuja los gráficos, la segunda genera el libro de Excel de descarga y la tercera el PDF con membrete.
kaa'ulapo'uleUna hoja de cálculo con reglas: cada columna tiene un nombre fijo y admite un solo tipo de dato, así que no se puede escribir una palabra donde va un número.
rülee - a'laülaaUna fila es un registro (por ejemplo, un departamento en un año). Una columna es el mismo dato en todas las filas (por ejemplo, el PIB).
anüliaaQué admite una columna: número entero, número con decimales, texto o año. Fijarlo evita que se cuele un valor imposible.
anüliaaLa lista de columnas de una tabla explicando qué contiene cada una. Se publica y se calcula en vivo en cómo funciona la plataforma.
emüjaachinEsquema: el conjunto de tablas y columnas de la base. Migración: un cambio de esa estructura, numerado y registrado, que se puede volver a aplicar sin duplicar nada.
anüliaaConvertir un archivo de datos en filas y columnas de la base, con su tipo correcto. Es el paso que hace que el visor no tenga que abrir ningún archivo.
alijunakaiEl modelo vigente desde julio de 2026: la base de datos es lo que se sirve al visor y a la API, y los archivos quedan como respaldo. Antes era al contrario.
anaapüjatüUn atajo interno para encontrar filas rápido, como el índice de un libro. No cambia el dato: cambia el tiempo que tarda en aparecer.
anainjaamaapüleeGeoJSON: el archivo con la forma de los departamentos. Coroplético: el mapa que colorea cada departamento según el valor del indicador.
Power BI · TableauHerramientas comerciales de tableros. Se conectan a la API y usan el mismo dato, sin duplicarlo.
ka'iwaEl «despertador» del servidor: ejecuta una tarea a una hora fija (aquí, la vigilancia semanal).
anaajaaleeEl archivo histórico del código, donde queda registrado cada cambio y quién lo hizo.
emüjaachiUn cambio versionado del esquema de la base de datos; se puede reejecutar sin romper nada.
ttaaDDL: las instrucciones que crean la base vacía. Dump: la copia completa de los datos. Con ambos se levanta la plataforma desde cero.
maimaputsuwaSoftware de uso libre, sin licencia que pagar ni renovar.

akaralo'ule

HTTPS · TLS · certificadoLa conexión cifrada entre el navegador y el servidor (el candado del navegador). El certificado se renueva solo.
anüliaaSi algo falla al comprobar un permiso, la plataforma no muestra el dato. Un error nunca abre la puerta: la deja cerrada.
aa'inmajülüEl punto único por el que salen los datos. Comprueba el permiso y aplica el corte de vigencia antes de entregar nada, así que no hay salidas paralelas.
letscrüptuaakalatüliiko'uluwa
pütchiwaaObliga al navegador a usar siempre la conexión cifrada.
CSPContent Security Policy: le dice al navegador exactamente qué código puede ejecutar. Es la defensa principal contra la inyección de código malicioso.
CSüRFAtaque que hace que un usuario autenticado ejecute una acción sin querer. Cada formulario lleva un código único que lo impide.
ejepilüsqlAtaque que intenta colar instrucciones en un formulario para manipular la base. Se previene con consultas parametrizadas.
hashiruaEl método con que se guardan las contraseñas: un resumen irreversible. Aunque alguien leyera la base, no puede deducirlas.
a'laalaEl permiso de cada cuenta: administrador, editor o lector.
Clave de APIUna credencial para que un programa consulte los datos. En la base solo se guarda su hash.
anüliaaUn tope de peticiones por minuto: evita abusos y caídas.
a'wanülüüpiakatükanaRevisión automatizada que busca fallas de seguridad conocidas.

karalo'ule eeraa

Respuestas directas para los territorios, las entidades y los equipos técnicos.

¿Qué son los Visores Territoriales?

Son cinco tableros públicos de información territorial (economía y empleo, competitividad, caracterización sectorial, brechas y vocaciones, y cadenas productivas) que apoyan la Metodología Ágil Ajustada (MÁA) de Ruta Milagro - Regiones Más Competitivas. Presentan datos oficiales por departamento y año para que las Comisiones Regionales de Competitividad e Innovación (CRCI) prioricen programas y proyectos.

¿Quién desarrolla y opera esta plataforma?

La plataforma es un bien público digital del Convenio NPA-045-2026 entre iNNpulsa Colombia y FUNDETEC, en el marco de Ruta Milagro - Regiones Más Competitivas del Ministerio de Comercio, Industria y Turismo. FUNDETEC, como aliado operador, aporta el diseño, la infraestructura y el soporte técnico como contrapartida, y al cierre del convenio transfiere la totalidad de los activos técnicos.

¿De dónde salen los datos y cómo sé que son confiables?

Exclusivamente de fuentes oficiales y técnicas públicas: DANE, DNP, Consejo Privado de Competitividad (Índice Departamental de Competitividad), MinTIC, DIAN, SECOP y registros sectoriales. Cada dato declara su fuente verificable (entidad, conjunto de datos, vigencia y enlace) y el puntaje del IDC publicado se corroboró 66/66 contra la base oficial del CPC.

¿Con qué frecuencia se actualizan los visores?

Los datos están al corte más reciente disponible (2024/2025 según la fuente). Un proceso de vigilancia revisa cada semana si las fuentes oficiales publicaron una vigencia nueva y avisa cuando aparece un corte; la incorporación la decide el equipo, que carga la vigencia desde el panel conservando la serie histórica desde 2016. La revisión es automática; la publicación de un año nuevo es una decisión, no un efecto secundario.

¿Necesito registrarme para usar los visores?

No. La consulta de los visores, los manuales y la API de datos abiertos son públicos y gratuitos. Solo el panel de gestión (carga de datos, usuarios, claves) requiere una cuenta con rol autorizado.

¿Puedo descargar los datos o conectarlos a Power BI / Tableau?

Sí. La API v1 entrega los panoramas en JSON (Power BI: Obtener datos → Web) y en CSV descargable (Tableau, Excel). El acceso a los datos se hace con una clave que se emite a cada entidad, con su límite de uso y su registro de consultas; la apertura sin credencial queda sujeta a la autorización de la supervisión del convenio. La autodescripción, que declara el modo vigente, está en /api/v1/capabilities y no requiere clave.

¿Cómo se cargan datos nuevos sin saber SQL?

Desde el panel de gestión, un usuario autorizado sube un archivo CSV o Excel; la plataforma lo valida contra el contrato de columnas del dataset (tipos, departamentos DIVIPOLA, vigencias, duplicados), muestra el resultado y solo entonces permite aplicar. Cada carga queda versionada, auditada y es reversible.

¿Cómo se relaciona esta plataforma con competitivas.gov.co?

Los visores hacen parte del ecosistema del Sistema Nacional de Competitividad e Innovación y están construidos para enlazarse desde el sitio institucional sin duplicar información. El alojamiento definitivo (dominio del Ministerio o infraestructura de iNNpulsa) es una decisión de gobernanza en curso; la arquitectura (subdominio + API + transferencia documentada) admite cualquiera de las opciones.

¿Qué recibe el MinCIT / iNNpulsa al cierre del convenio?

La totalidad de los activos técnicos, desbloqueados: código fuente, scripts y consultas, DDL y dumps de la base de datos, modelo ETL documentado, manuales y acta de entrega firmada — conforme a las páginas 40 a 43 del convenio. La guía de transferencia que acompaña la entrega inventaría cada activo.

¿Cómo se seguirá actualizando la plataforma cuando termine el convenio?

La actualización no depende de ninguna persona ni de ningún proveedor. La vía prevista es el panel de gestión, y admite dos formas sin escribir una línea de código: (1) corregir o agregar el dato uno a uno en un formulario con listas de indicadores, departamentos y municipios; (2) cargar el archivo de la vigencia nueva con la plantilla del propio conjunto, que se descarga desde el panel con sus columnas y sus ejemplos; la plataforma lo valida, muestra el resultado y solo entonces permite aplicar, con reversión en un clic. Además, un equipo técnico puede reejecutar los scripts documentados, y un proceso semanal avisa cuando una fuente publica un corte nuevo para que alguien decida cargarlo. Todo se entrega operativo, documentado y sin licencias comerciales de por medio. La designación de quién administra la plataforma tras la entrega es una decisión institucional de MinCIT e iNNpulsa.

¿La plataforma resiste un escaneo de vulnerabilidades?

Está construida para ello y el operador queda a disposición de la Oficina de Sistemas de Información del Ministerio para el escaneo que esta disponga, en la ventana y con la herramienta que defina, incluyendo la remediación de los hallazgos. Los controles ya implementados incluyen HTTPS obligatorio, Content Security Policy estricta sin código en línea sin firmar, contraseñas con ARGON2ID, protección CSRF, límite de tasa, roles, claves de API almacenadas solo como hash, auditoría de acciones y consultas parametrizadas contra inyección SQL. La plataforma ya superó una auditoría técnica externa sin recomendaciones abiertas.

¿A quién reporto un error o una inconsistencia en un dato?

Al canal del convenio con iNNpulsa Colombia o al correo institucional de Ruta Milagro - Regiones Más Competitivas. Toda corrección se traza: se identifica la fuente oficial, se corrige por carga versionada y queda registrada en la auditoría de la plataforma.

¿La plataforma cumple los lineamientos de los sitios GOV.CO?

La plataforma aplica el Kit de interfaz de usuario del Estado, en su versión 9.2, y las guías de accesibilidad y usabilidad de la Agencia Nacional Digital: barra superior con el logotipo de GOV.CO enlazado al portal único, pie de página institucional con los datos de contacto y el bloque de cierre obligatorio, el color asignado al Ministerio en el Manual de imagen de Gobierno, tipografías Nunito Sans y Verdana, lenguaje claro, HTML semántico y accesible en nivel AA, HTTPS con certificado automático y datos abiertos documentados. El detalle está en la sección de manual de estilo de esta misma página, y el estado de accesibilidad, con sus pendientes, en la página Declaración de Accesibilidad.

¿Tu pregunta no está aquí? Consulta los manuales, la autodescripción de la API o escribe al canal institucional de la Ruta Milagro - Regiones Más Competitivas.

8 · Cómo funciona por dentro: arquitectura, datos y tablas

Esta ficha afirma que la plataforma es trazable y transferible. Hay una página que lo demuestra: publica el modelo de datos, el inventario de tablas y el diccionario de columnas, todo medido en el momento de abrirla.

24tablas de datos
693.607filas consultables
200columnas descritas
45tablas en total

anaapüjatü

Cada conjunto de datos se proyecta a su propia tabla de la base, con los nombres de columna y los tipos registrados. Esa tabla —no un archivo— es lo que consultan el visor y la API. La conversión se comprobó valor por valor: el resultado reconstruido es idéntico al archivo de origen.

📖 Diccionario de datos publicado

Qué contiene cada columna de cada conjunto, con su nombre en lenguaje llano y su tipo de dato. Es la información que suele quedarse en un documento interno; aquí se publica y se calcula sola, así que no puede quedar desactualizada.

🔍 Quién ve qué, explicado

Qué se puede consultar sin cuenta, qué requiere una y hasta qué año llega cada vía. Con el recorrido de un dato real de principio a fin y enlaces para comprobar cada paso por cuenta propia.

El modelo de datos también se publica como datos consultables: así el Ministerio puede verificar la estructura con una consulta, en lugar de leyendo un diagrama.

ma'iijataa

Explora los cinco visores o conéctalos a tu herramienta de análisis.