{"id":7644,"date":"2026-03-18T08:26:57","date_gmt":"2026-03-18T13:26:57","guid":{"rendered":"https:\/\/observatorioarmenia.org\/site\/?page_id=7644"},"modified":"2026-03-18T08:26:59","modified_gmt":"2026-03-18T13:26:59","slug":"1-4-gobernanza-de-datos","status":"publish","type":"page","link":"https:\/\/observatorioarmenia.org\/site\/1-4-gobernanza-de-datos\/","title":{"rendered":"1.4 Gobernanza de Datos"},"content":{"rendered":"\n<p class=\"has-medium-font-size wp-block-paragraph\">La de \u201cEstructura de Datos\u201d para la Alcald\u00eda Municipal de Armenia, Quind\u00edo, ser\u00e1 dividida en cuatro capas:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>3.1 Datos Maestros (Master Data),<\/li>\n\n\n\n<li>3.2 Datos de Referencia (Reference Data),<\/li>\n\n\n\n<li>3.3 Datos transaccionales (Transactional Data)<\/li>\n\n\n\n<li>3.4 Metadata<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A partir de la estructura de datos de cada una de las etapas se derivar\u00e1 el modelo conceptual de Entidad\u2013Relaci\u00f3n y algunos lineamientos de implementaci\u00f3n.<\/p>\n\n\n\n<h2 class=\"wp-block-heading has-medium-font-size\">3.1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Datos Maestros (Master Data)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Establece la \u201c\u00fanica fuente de la verdad\u201d para las entidades centrales con las que opera la Alcald\u00eda. Garantiza que los datos cr\u00edticos (ciudadanos, predios, empresas, proveedores, empleados, programas, proyectos) est\u00e9n limpios, consolidados y normalizados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">La estructura de datos propuesta para la Alcald\u00eda de Armenia se condensa en el siguiente diagrama:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"612\" src=\"https:\/\/observatorioarmenia.org\/site\/wp-content\/uploads\/2025\/05\/GRAFICA-1024x612.jpeg\" alt=\"\" class=\"wp-image-5377\" srcset=\"https:\/\/observatorioarmenia.org\/site\/wp-content\/uploads\/2025\/05\/GRAFICA-1024x612.jpeg 1024w, https:\/\/observatorioarmenia.org\/site\/wp-content\/uploads\/2025\/05\/GRAFICA-300x179.jpeg 300w, https:\/\/observatorioarmenia.org\/site\/wp-content\/uploads\/2025\/05\/GRAFICA-768x459.jpeg 768w, https:\/\/observatorioarmenia.org\/site\/wp-content\/uploads\/2025\/05\/GRAFICA.jpeg 1136w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Fuente: Secretar\u00eda de Hacienda de Armenia (2025)<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Para la estructura de datos propuesta, se tiene la siguiente descripci\u00f3n de las entidades:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Entidad<\/strong><\/td><td><strong>Clave PK<\/strong><\/td><td><strong>Atributos clave<\/strong><\/td><td><strong>Relaci\u00f3n principal<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong>Ciudadano<\/strong><\/td><td>id_ciudadano<\/td><td>nombre, tipo_documento, n\u00famero_documento, fecha_nacimiento, direcci\u00f3n, contacto<\/td><td>\u2192 Predio, \u2192 Tr\u00e1mite, \u2192 Pago_Impuesto<\/td><\/tr><tr><td><strong>Predio<\/strong><\/td><td>id_predio<\/td><td>c\u00f3digo_catastral, ubicaci\u00f3n, \u00e1rea_m2, uso_suelo, id_ciudadano<\/td><td>\u2190 Ciudadano \u2192 Impuesto<\/td><\/tr><tr><td><strong>Empleado<\/strong><\/td><td>id_empleado<\/td><td>nombre, cargo, dependencia, fecha_ingreso, email, tel\u00e9fono<\/td><td>\u2192 Contrato<\/td><\/tr><tr><td><strong>Proveedor<\/strong><\/td><td>id_proveedor<\/td><td>raz\u00f3n_social, NIT, direcci\u00f3n, tel\u00e9fono, categor\u00eda_suministro<\/td><td>\u2190 Contrato<\/td><\/tr><tr><td><strong>Empresa<\/strong><\/td><td>id_empresa<\/td><td>nombre, NIT, tipo_empresa (p.ej. comercial, industrial), direcci\u00f3n, tel\u00e9fono, representante_legal<\/td><td>\u2192 Proyecto, \u2192 Programa<\/td><\/tr><tr><td><strong>Programa<\/strong><\/td><td>id_programa<\/td><td>nombre, descripci\u00f3n, objetivo, fecha_inicio, fecha_fin, dependencia_responsable<\/td><td>\u2190 Empresa, \u2192 Proyecto<\/td><\/tr><tr><td><strong>Proyecto<\/strong><\/td><td>id_proyecto<\/td><td>nombre, descripci\u00f3n, objeto, presupuesto, fecha_inicio, fecha_fin, estado, id_programa, id_empresa<\/td><td>\u2190 Programa, \u2190 Empresa<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Fuente: Secretar\u00eda de Hacienda de Armenia (2025)<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Para cada entidad se tienen las siguientes buenas pr\u00e1cticas:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ciudadano<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Es el eje central de la Alcald\u00eda.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Unicidad y validaci\u00f3n:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Validar tipo y n\u00famero de documento contra la Registradur\u00eda.<\/li>\n\n\n\n<li>Evitar duplicados con reglas de <strong>Match &amp; Merge<\/strong> (por ejemplo, comparar nombre y direcci\u00f3n).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Seguridad y privacidad:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Encriptar campos sensibles (n\u00famero de documento, direcci\u00f3n).<\/li>\n\n\n\n<li>Controlar acceso a datos personales v\u00eda roles (p.ej. s\u00f3lo Gesti\u00f3n Humana o Secretar\u00eda General).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Auditor\u00eda y versionamiento:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mantener campos created_by, created_at, modified_by, modified_at.<\/li>\n\n\n\n<li>Registrar estado de vigencia (activo\/inactivo) y fechas de cambio.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Predio<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Corresponde a las porciones de terreno de propiedad privada o p\u00fablica apropiadamente delimitada e identificada.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Integridad espacial:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Usar un sistema geoespacial (p.ej. PostGIS) para validar coordenadas y l\u00edmites.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>C\u00f3digo catastral \u00fanico:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Validar unicidad del c\u00f3digo catastral contra la base del IGAC.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Relaci\u00f3n con ciudadano:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Forzar FK a ciudadano vigente y activo.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Metadatos de uso de suelo:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Registrar clasificaci\u00f3n oficial (residencial, comercial, mixto) y fuente de la clasificaci\u00f3n.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Empleado<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Corresponde al funcionario p\u00fablico, de planta o de contrato, que labora para al Alcald\u00eda.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Control de claves:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Asignar un identificador interno distinto del documento personal.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Hist\u00f3rico de cargos y dependencias:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Versionar cargo (cargo_actual vs. cargos_previos) y dependencia.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Datos de contacto confiables:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Validar correo y tel\u00e9fono corporativo (dominio alcald\u00eda.gov.co).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Seguridad de acceso:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Integrar con Active Directory o IAM para gestionar permisos seg\u00fan rol.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Proveedor<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Son los agentes que proveen bienes y servicios a la Alcald\u00eda.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Validaci\u00f3n de NIT:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Comprobar vigencia y estado ante la DIAN (activo, inhabilitado).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Clasificaci\u00f3n de suministros:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Usar cat\u00e1logos estandarizados (CIIU 4.0) para tipo de bien o servicio.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Score de desempe\u00f1o:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mantener indicadores de cumplimiento de contratos (entregas a tiempo, calidad).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Auditor\u00eda de relaciones:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Registrar hist\u00f3rico de contratos y solicitudes de cotizaci\u00f3n.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Empresa<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Agente econ\u00f3mico natural o jur\u00eddico que genera ingresos en el territorio administrado por la Alcald\u00eda.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Unicidad y correspondencia:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Evitar que una misma empresa exista como Proveedor y como Empresa sin relaci\u00f3n; mapear NIT y RUT.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Clasificaci\u00f3n sectorial:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Definir sector econ\u00f3mico (comercial, industrial, ONG) con c\u00f3digos estandarizados.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Representante legal:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Versionar cambios de representante y sus periodos de vigencia.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Cumplimiento normativo:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Registrar certificaciones o registros especiales (p.ej. C\u00e1mara de Comercio, RUT actualizado).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading has-medium-font-size\">Programa<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Corresponde a la dimensi\u00f3n que pretende desarrollar el plan de gobierno que sali\u00f3 elegido.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Definici\u00f3n de alcance y KPIs:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Documentar objetivos SMART y m\u00e9tricas de \u00e9xito en el diccionario de datos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Cronograma y versiones:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Versionar versiones de alcance y presupuesto cuando haya ajustes.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Dependencia responsable:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Forzar FK a la dependencia (Secretar\u00eda, Unidad) que administra el programa.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Riesgos y alertas:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Asociar un plan de riesgos y registrar alertas de desviaci\u00f3n (plazos, costos)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Proyecto<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Corresponde a la programaci\u00f3n de las actividades que permite dar alcance a lo propuesto por el programa.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Fases y hitos:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Modelar fases (Iniciaci\u00f3n, Planeaci\u00f3n, Ejecuci\u00f3n, Cierre) con fechas de inicio y fin.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Presupuesto y ejecuciones:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Registrar presupuesto original vs. ejecuciones reales (forecast vs. actual).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Estado y gobernanza:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Definir estados estandarizados (planeado, en curso, en riesgo, cerrado).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Responsables:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Asociar usuarios internos (l\u00edder de proyecto, comit\u00e9 de seguimiento) y roles de aprobaci\u00f3n.<\/li>\n<\/ul>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>3.2 Datos de Referencia (Reference Data)<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Los datos de referencia se desarrollan para mantener cat\u00e1logos, c\u00f3digos y par\u00e1metros estandarizados que aseguren consistencia sem\u00e1ntica y operacional en todos los sistemas de la Alcald\u00eda.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Cat\u00e1logo \/ C\u00f3digo<\/strong><\/td><td><strong>Descripci\u00f3n<\/strong><\/td><td><strong>Ejemplo de Tabla<\/strong><\/td><td><strong>Atributos clave<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong>Ubicaci\u00f3n Geogr\u00e1fica<\/strong><\/td><td>Territorializaci\u00f3n oficial<\/td><td>Departamento, Municipio, Barrio<\/td><td>id_ubicaci\u00f3n, nombre, nivel, c\u00f3digo_DANE<\/td><\/tr><tr><td><strong>Tipos de Tr\u00e1mite<\/strong><\/td><td>Clasificaci\u00f3n de procesos ciudadanos<\/td><td>Tipo_Tramite<\/td><td>id_tipo_tramite, nombre, descripci\u00f3n, vigencia<\/td><\/tr><tr><td><strong>Categor\u00edas Presupuestales<\/strong><\/td><td>Clases y rubros de gasto seg\u00fan la ley<\/td><td>Clase_Gasto, Rubro_Presupuestal<\/td><td>id_clase, id_rubro, nombre, fuente_normativa<\/td><\/tr><tr><td><strong>M\u00e9todos de Pago<\/strong><\/td><td>Formas autorizadas para recaudos<\/td><td>Metodo_Pago<\/td><td>id_metodo_pago, nombre, detalle, activo<\/td><\/tr><tr><td><strong>Dependencias Internas<\/strong><\/td><td>Organismos y secretar\u00edas de la Alcald\u00eda<\/td><td>Dependencia<\/td><td>id_dependencia, nombre, nivel (Secretar\u00eda, Unidad)<\/td><\/tr><tr><td><strong>C\u00f3digos de Actividad Econ\u00f3mica<\/strong><\/td><td>Clasificaci\u00f3n Econ\u00f3mica (CIIU 4.0)<\/td><td>Codigo_CIIU<\/td><td>id_ciiu, c\u00f3digo, descripci\u00f3n, nivel<\/td><\/tr><tr><td><strong>Estados de Proyecto\/Programa<\/strong><\/td><td>Fases y estatus homog\u00e9neos para seguimiento<\/td><td>Estado_Entidad<\/td><td>id_estado, dominio (Proyecto\/Programa), nombre<\/td><\/tr><tr><td><strong>Categor\u00edas de Servicio<\/strong><\/td><td>Tipos de servicios ofrecidos (recolecci\u00f3n, infraestructura, etc.)<\/td><td>Categoria_Servicio<\/td><td>id_categoria, nombre, descripci\u00f3n<\/td><\/tr><tr><td><strong>M\u00e9tricas y KPIs<\/strong><\/td><td>Indicadores estandarizados para evaluaci\u00f3n<\/td><td>KPI_Definicion<\/td><td>id_kpi, nombre, unidad, f\u00f3rmula, frecuencia<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Fuente: Secretar\u00eda de Hacienda de Armenia (2025)<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Para que la capa de <strong>Reference Data<\/strong> proporcione la estructura sem\u00e1ntica y los controles necesarios para estandarizar, validar y gobernar todos los cat\u00e1logos que sustentan los procesos de la Alcald\u00eda municipal se recomienda:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Gobernanza de Cat\u00e1logos<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Establecer un comit\u00e9 de datos (Data Council) que apruebe cambios y nuevas versiones.<\/li>\n\n\n\n<li>Versionar cada cat\u00e1logo con fechas de vigencia y n\u00fameros de versi\u00f3n.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Distribuci\u00f3n y Sincronizaci\u00f3n<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Publicar cat\u00e1logos a trav\u00e9s de APIs RESTful (o OData) y exports peri\u00f3dicos (CSV\/JSON).<\/li>\n\n\n\n<li>Implementar mecanismos de \u201cpull\u201d en aplicaciones cliente para refrescar cat\u00e1logos (p.\u202fej. cada 24\u202fhrs).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Control de Calidad y Validaci\u00f3n<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Definir reglas de validaci\u00f3n en origen (front\u2011end o API) para impedir inserci\u00f3n de c\u00f3digos no existentes.<\/li>\n\n\n\n<li>Ejecutar pruebas automatizadas (unitarias) tras cada actualizaci\u00f3n de cat\u00e1logo.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Documentaci\u00f3n y Accesibilidad<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mantener un repositorio central (por ejemplo, en un Data Catalog o wiki interno) con definiciones, ejemplos y glosario.<\/li>\n\n\n\n<li>Publicar gu\u00edas de uso (p.\u202fej. \u201cC\u00f3mo referenciar el cat\u00e1logo de Tipo_Tramite en solicitudes\u201d).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Seguridad y Accesos<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Restringir cambios a usuarios o roles autorizados (Data Stewards).<\/li>\n\n\n\n<li>Registrar en logs qui\u00e9n hizo cada modificaci\u00f3n y cu\u00e1ndo.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Lineaje y Trazabilidad<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Documentar el origen de cada cat\u00e1logo (normativa, decreto, organismo externo).<\/li>\n\n\n\n<li>Asociar pol\u00edticas de retenci\u00f3n: algunos cat\u00e1logos pueden requerir hist\u00f3rico completo (p.\u202fej. tarifas).<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Integraci\u00f3n con Master y Transaccional<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Forzar claves for\u00e1neas en tablas transaccionales hacia los cat\u00e1logos.<\/li>\n\n\n\n<li>Auditar peri\u00f3dicamente la integridad referencial (no debe haber valores hu\u00e9rfanos).<\/li>\n<\/ul>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>3.3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Datos transaccionales (Transactional Data)<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Los datos transaccionales se encargan de capturar y almacenar todos los eventos operativos y de negocio que suceden de manera cotidiana en la Alcald\u00eda, incluyendo interacciones con ciudadanos, pagos, contratos, tr\u00e1mites, proyectos y programas. Esta capa alimenta tanto los procesos de operaci\u00f3n diaria como los sistemas anal\u00edticos (Data Warehouse, BI).<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Categor\u00eda<\/th><th>Ejemplos de Entidades \/ Tablas<\/th><th>Atributos clave<\/th><\/tr><\/thead><tbody><tr><td><strong>Pagos y Recaudos<\/strong><\/td><td>Pago_Impuesto, Pago_Servicio, Recaudo_Patrimonio<\/td><td>id_pago, id_ciudadano, id_predio, valor, fecha_pago, m\u00e9todo_pago, recibo_n\u00famero<\/td><\/tr><tr><td><strong>Tr\u00e1mites y Solicitudes<\/strong><\/td><td>Tr\u00e1mite, Solicitud, Registro_Ciudadano<\/td><td>id_tr\u00e1mite, id_ciudadano, id_tipo_tr\u00e1mite, fecha_solicitud, estado, observaciones<\/td><\/tr><tr><td><strong>Contrataci\u00f3n<\/strong><\/td><td>Contrato, Adici\u00f3n_Presupuestal, Acta_Vinculaci\u00f3n<\/td><td>id_contrato, id_empleado, id_proveedor, fecha_inicio, fecha_final, valor_contrato, objeto<\/td><\/tr><tr><td><strong>Servicios Ciudadanos<\/strong><\/td><td>Solicitud_Servicio, Atenci\u00f3n_Servicio, Cierre_Servicio<\/td><td>id_solicitud, id_servicio, id_ciudadano, fecha_inicio, fecha_cierre, estado, responsable<\/td><\/tr><tr><td><strong>Gesti\u00f3n de Proyectos<\/strong><\/td><td>Avance_Proyecto, Hito_Proyecto, Desembolso_Proyecto<\/td><td>id_avance, id_proyecto, fecha_registro, porcentaje_avance, comentario; id_hito, fecha_hito<\/td><\/tr><tr><td><strong>Ejecuci\u00f3n de Programas<\/strong><\/td><td>Desembolso_Programa, Informe_KPI_Programa, Registro_Actividad<\/td><td>id_desembolso, id_programa, fecha, monto; id_kpi, valor, fecha_medici\u00f3n; descripci\u00f3n_actividad<\/td><\/tr><tr><td><strong>Auditor\u00eda de Transacciones<\/strong><\/td><td>Log_Transacci\u00f3n<\/td><td>id_log, tabla_origen, operaci\u00f3n (I\/U\/D), usuario, timestamp, datos_previos, datos_posteriores<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Fuente: Secretar\u00eda de Hacienda de Armenia (2025)<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading has-medium-font-size\"><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">La capa de Datos Transaccionales cubre de manera integral no solo los pagos y tr\u00e1mites, sino tambi\u00e9n la gesti\u00f3n de proyectos y programas, garantizando un registro completo, normalizado y auditado de todas las operaciones municipales. Para garantizar una buena pr\u00e1ctica en el manejo de los datos transaccionales se debe tener en cuenta:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Modelado y Normalizaci\u00f3n<\/strong>\n<ul class=\"wp-block-list\">\n<li>Dise\u00f1ar cada \u00e1rea (pagos, tr\u00e1mites, contratos, proyectos, programas) en esquemas normalizados (3FN) para mantener integridad referencial.<\/li>\n\n\n\n<li>Separar tablas de \u201cdetalle\u201d (ej. Avance_Proyecto) de \u201ccabecera\u201d (Proyecto) para facilitar reportes y agregados.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Change Data Capture (CDC)<\/strong>\n<ul class=\"wp-block-list\">\n<li>Implementar mecanismos de CDC (p.ej. Debezium, triggers nativos) para replicar cambios en tiempo cercano a los sistemas de BI y Data Warehouse.<\/li>\n\n\n\n<li>Definir pol\u00edticas de retenci\u00f3n para los logs de CDC, equilibrando trazabilidad y espacio de almacenamiento.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Auditor\u00eda y Trazabilidad<\/strong>\n<ul class=\"wp-block-list\">\n<li>Registrar en cada tabla transaccional campos de auditor\u00eda: <code>created_by<\/code>, <code>created_at<\/code>, <code>modified_by<\/code>, <code>modified_at<\/code>.<\/li>\n\n\n\n<li>Centralizar los logs de transacciones cr\u00edticas (p.ej. pagos y contratos) en tablas de auditor\u00eda especializadas (Log_Transacci\u00f3n).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>SLAs de Disponibilidad<\/strong>\n<ul class=\"wp-block-list\">\n<li>Establecer metas de latencia: p.ej., que toda transacci\u00f3n quede disponible para an\u00e1lisis en m\u00e1ximo 15 minutos.<\/li>\n\n\n\n<li>Monitorizar procesos ETL\/ELT y alertar autom\u00e1ticamente en caso de fallos o demoras.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Integridad Referencial y Validaciones en Origen<\/strong>\n<ul class=\"wp-block-list\">\n<li>Forzar claves for\u00e1neas a Master Data y Reference Data para garantizar consistencia (p.ej. <code>id_ciudadano<\/code> siempre v\u00e1lido, <code>id_programa<\/code> activo).<\/li>\n\n\n\n<li>Validaciones en tiempo real en la capa de captura (front-end o API) para asegurar dominios y rangos correctos.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Seguridad y Acceso<\/strong>\n<ul class=\"wp-block-list\">\n<li>Definir roles y permisos granulares: p.ej., solo Tesorer\u00eda puede insertar o anular registros de pagos; Secretar\u00eda de Planeaci\u00f3n gestiona avances de proyectos.<\/li>\n\n\n\n<li>Encriptar datos sensibles en reposo y aplicar conexi\u00f3n TLS para las transacciones.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Monitoreo y Alertas<\/strong>\n<ul class=\"wp-block-list\">\n<li>Crear dashboards operativos que muestren vol\u00famenes de transacciones por canal (portal web, atenci\u00f3n presencial), estado de tr\u00e1mites, desviaciones de cronogramas de proyectos.<\/li>\n\n\n\n<li>Configurar alertas autom\u00e1ticas ante ca\u00eddas de procesos ETL, alta tasa de errores o incumplimientos de SLA.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\"><strong>3.4 Metadata<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Los metadatos proporcionan informaci\u00f3n sobre los datos mismos \u2014su contexto, origen, calidad, estructura y reglas de uso\u2014 para habilitar la gobernanza, trazabilidad y auto\u2011servicio.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Categor\u00eda<\/strong><\/td><td><strong>Descripci\u00f3n<\/strong><\/td><td><strong>Ejemplo de Elemento<\/strong><\/td><td><strong>Atributos Clave \/ Notas<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong>Diccionario de Datos<\/strong><\/td><td>Definiciones y propiedades de tablas y campos<\/td><td>Tabla: CIUDADANOCampo: numero_documento<\/td><td>tipo de dato, longitud, formato, dominio de valores<\/td><\/tr><tr><td><strong>Linaje de Datos<\/strong><\/td><td>Flujo de transformaci\u00f3n desde origen hasta destino<\/td><td>Origen: formulario web \u2192 ETL \u2192 DW<\/td><td>origen_sistema, proceso, timestamp, destino<\/td><\/tr><tr><td><strong>Pol\u00edticas de Retenci\u00f3n<\/strong><\/td><td>Reglas de conservaci\u00f3n y eliminaci\u00f3n de registros<\/td><td>Expedientes civiles: 20\u202fa\u00f1os<\/td><td>entidad, periodo_vigencia, responsable de eliminaci\u00f3n<\/td><\/tr><tr><td><strong>Cat\u00e1logo de Calidad<\/strong><\/td><td>Reglas y m\u00e9tricas para medir integridad, completitud, precisi\u00f3n<\/td><td>Completeness: % registros con email v\u00e1lido<\/td><td>m\u00e9trica, umbral_aceptable, frecuencia de c\u00e1lculo<\/td><\/tr><tr><td><strong>Configuraci\u00f3n ETL\/ELT<\/strong><\/td><td>Par\u00e1metros de extracci\u00f3n, transformaci\u00f3n y carga<\/td><td>Job: ETL_PREDIOS_DIARIO<\/td><td>frecuencia, par\u00e1metros, notificaciones, responsable<\/td><\/tr><tr><td><strong>Modelos y Esquemas<\/strong><\/td><td>Estructuras de datos f\u00edsicas y l\u00f3gicas<\/td><td>Esquema DW: estrella de \u201cRecaudaci\u00f3n\u201d<\/td><td>tablas_hecho, tablas_dimensi\u00f3n, relaciones<\/td><\/tr><tr><td><strong>Versionamiento de Cat\u00e1logos<\/strong><\/td><td>Historial de cambios en Reference Data<\/td><td>Versi\u00f3n 1.2 de Tipo_Tramite<\/td><td>versi\u00f3n, fecha_publicaci\u00f3n, autor_cambio<\/td><\/tr><tr><td><strong>Glosario de Negocio<\/strong><\/td><td>T\u00e9rminos y definiciones de negocio para alineaci\u00f3n sem\u00e1ntica<\/td><td>\u201cPrograma\u201d: iniciativa estrat\u00e9gica<\/td><td>t\u00e9rmino, definici\u00f3n, ejemplos de uso<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Fuente: Secretar\u00eda de Hacienda de Armenia (2025)<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para que la capa de metadata queda completamente alineada con las necesidades de gobernanza, trazabilidad y calidad de datos de la Alcald\u00eda municipal, facilitando la confianza y el acceso controlado para todos los usuarios de informaci\u00f3n de la entidad, se recomienda:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Centralizaci\u00f3n y Herramienta de Cat\u00e1logo<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Utilizar una plataforma de Data Catalog (p.ej. Apache Atlas, Alation) o repositorio interno para centralizar todos los metadatos.<\/li>\n\n\n\n<li>Proveer interfaz de b\u00fasqueda y navegaci\u00f3n para facilitar el descubrimiento.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Captura Autom\u00e1tica de Linaje<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Integrar conectores ETL y logs de base de datos que registren el flujo de datos sin intervenci\u00f3n manual.<\/li>\n\n\n\n<li>Visualizar mapas de linaje que muestren dependencias entre sistemas y procesos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Mantenimiento de la Calidad de Metadatos<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Definir indicadores de calidad de metadatos (por ejemplo, porcentaje de tablas documentadas).<\/li>\n\n\n\n<li>Ejecutar revisiones peri\u00f3dicas para detectar metadatos obsoletos o incompletos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Versionado y Gobernanza de Cambios<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Gestionar cambios en metadatos mediante control de versiones, con fechas de vigencia y autores.<\/li>\n\n\n\n<li>Aprobar modificaciones a trav\u00e9s de un <strong>Data Governance Board<\/strong>, registrando actas de decisiones.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Integraci\u00f3n con Seguridad y Privacidad<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Etiquetar metadatos relacionados con datos sensibles (PII) y enlazar con pol\u00edticas de encriptaci\u00f3n y acceso.<\/li>\n\n\n\n<li>Registrar en el cat\u00e1logo los roles y permisos asociados a cada conjunto de datos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Documentaci\u00f3n de Procesos ETL\/ELT<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Mantener descripciones detalladas de cada job (frecuencia, transformaciones aplicadas, excepciones).<\/li>\n\n\n\n<li>Asociar diagramas de flujo y scripts de referencia en el repositorio de metadatos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Auto\u2011Servicio y Capacitaci\u00f3n<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ofrecer gu\u00edas de uso y talleres de introducci\u00f3n al cat\u00e1logo de metadatos para usuarios t\u00e9cnicos y de negocio.<\/li>\n\n\n\n<li>Incluir tutoriales sobre c\u00f3mo interpretar linaje, diccionario y m\u00e9tricas de calidad.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uf0b7&nbsp; <strong>Monitoreo y Alertas de Metadatos<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Configurar notificaciones autom\u00e1ticas ante caducidad de cat\u00e1logos o desviaciones en SLAs de actualizaciones.<\/li>\n\n\n\n<li>Generar reportes ejecutivos de estado del cat\u00e1logo: porcentaje de campos documentados, cat\u00e1logos pendientes de versi\u00f3n.<\/li>\n<\/ul>\n\n\n\n<p class=\"has-large-font-size wp-block-paragraph\"><strong>4.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Modelo Conceptual (entidad-relaci\u00f3n)<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">El modelo conceptual de Entidad\u2013Relaci\u00f3n para la estructura de datos expuesta se despliega a continuaci\u00f3n.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">erDiagram<br>CIUDADANO ||&#8211;o{ PREDIO : posee<br>CIUDADANO ||&#8211;o{ TRAMITE : solicita<br>CIUDADANO ||&#8211;o{ PAGO_IMPUESTO : efect\u00faa<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>PREDIO     }o--o{ IMPUESTO        : genera<br>TRAMITE    }o--|{ TIPO_TRAMITE    : clasifica<br>PAGO_IMPUESTO }o--|| METODO_PAGO  : usa<br><br>EMPLEADO   ||--o{ CONTRATO        : firma<br>CONTRATO   }o--o{ PROVEEDOR       : relaciona<br><br>SERVICIO   ||--o{ SOLICITUD       : atiende<br>SOLICITUD  }o--|| CIUDADANO       : inicia<br><br>EMPRESA    ||--o{ PROGRAMA        : administra<br>EMPRESA    ||--o{ PROYECTO        : patrocina<br>PROGRAMA   ||--o{ PROYECTO        : contiene<br><br>%% Definici\u00f3n de entidades y atributos clave<br>CIUDADANO {<br>  int id_ciudadano PK<br>  string nombre<br>  string tipo_documento<br>  string numero_documento<br>  date fecha_nacimiento<br>  string direccion<br>  string email<br>  string telefono<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>PREDIO {<br>  int id_predio PK<br>  string codigo_catastral<br>  int id_ciudadano FK<br>  geometry ubicacion<br>  float area_m2<br>  string uso_suelo<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>TRAMITE {<br>  int id_tramite PK<br>  int id_ciudadano FK<br>  int id_tipo_tramite FK<br>  date fecha_solicitud<br>  string estado<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>PAGO_IMPUESTO {<br>  int id_pago PK<br>  int id_ciudadano FK<br>  int id_predio FK<br>  float valor<br>  date fecha_pago<br>  int id_metodo_pago FK<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>TIPO_TRAMITE {<br>  int id_tipo_tramite PK<br>  string nombre<br>  string descripcion<br>}<br>METODO_PAGO {<br>  int id_metodo_pago PK<br>  string nombre<br>  string detalle<br>}<br>EMPLEADO {<br>  int id_empleado PK<br>  string nombre<br>  string cargo_actual<br>  date fecha_ingreso<br>  int id_dependencia FK<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>CONTRATO {<br>  int id_contrato PK<br>  int id_empleado FK<br>  int id_proveedor FK<br>  date fecha_inicio<br>  date fecha_final<br>  float valor_contrato<br>  string objeto<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>PROVEEDOR {<br>  int id_proveedor PK<br>  string razon_social<br>  string nit<br>  string direccion<br>  string telefono<br>  string categoria_ciiu<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>SERVICIO {<br>  int id_servicio PK<br>  string nombre<br>  string descripcion<br>}<br>SOLICITUD {<br>  int id_solicitud PK<br>  int id_servicio FK<br>  int id_ciudadano FK<br>  date fecha_solicitud<br>  string estado<br>  text observaciones<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>EMPRESA {<br>  int id_empresa PK<br>  string nombre<br>  string nit<br>  string tipo_empresa<br>  string direccion<br>  string telefono<br>  string representante_legal<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>PROGRAMA {<br>  int id_programa PK<br>  string nombre<br>  string descripcion<br>  string objetivo<br>  date fecha_inicio<br>  date fecha_fin<br>  string dependencia_responsable<br>  int id_empresa FK<br>  audit created_by, created_at, modified_by, modified_at<br>}<br>PROYECTO {<br>  int id_proyecto PK<br>  string nombre<br>  string descripcion<br>  string objeto<br>  float presupuesto<br>  date fecha_inicio<br>  date fecha_fin<br>  string estado<br>  int id_programa FK<br>  int id_empresa FK<br>  audit created_by, created_at, modified_by, modified_at<br>}<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>La de \u201cEstructura de Datos\u201d para la Alcald\u00eda Municipal de Armenia, Quind\u00edo, ser\u00e1 dividida en cuatro capas: A partir de la estructura de datos de cada una de las etapas se derivar\u00e1 el modelo conceptual de Entidad\u2013Relaci\u00f3n y algunos lineamientos de implementaci\u00f3n. 3.1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Datos Maestros (Master Data) Establece la \u201c\u00fanica<\/p>\n<div class=\"continue-reading-wrapper\"><a href=\"https:\/\/observatorioarmenia.org\/site\/1-4-gobernanza-de-datos\/\" class=\"continue-reading\">Ampliar informaci\u00f3n<i class=\"ion-ios-arrow-right\"><\/i><\/a><\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-7644","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/pages\/7644","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/comments?post=7644"}],"version-history":[{"count":2,"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/pages\/7644\/revisions"}],"predecessor-version":[{"id":7646,"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/pages\/7644\/revisions\/7646"}],"wp:attachment":[{"href":"https:\/\/observatorioarmenia.org\/site\/wp-json\/wp\/v2\/media?parent=7644"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}