Arquitectura de la Capa de Integración de Datos

Un "sistema nervioso central" para los datos de la Gobernación, permitiendo un consumo de información estandarizado y seguro.

Diagrama de Arquitectura

MIAC y Otras Apps API Gateway (Puerta de Entrada) Capa de Microservicios Contribuyente Imp. Vehicular Imp. Consumo Tornaguía Documento Fuentes de Datos SIVERVCUND... GEVIR STTI SIANCO CONDOR 1 RUNT

1. API Gateway: La Puerta de Entrada Única y Segura

Actúa como el único punto de entrada para todas las solicitudes de datos. Ninguna aplicación externa se comunica directamente con los sistemas finales. Todas las peticiones pasan a través del Gateway.

Funciones Clave:

  • Seguridad y Autenticación: Primera línea de defensa. Valida que quien solicita los datos tiene los permisos para hacerlo.
  • Enrutamiento (Routing): Sabe a qué microservicio debe dirigir cada solicitud.
  • Orquestación Ligera: Puede combinar la respuesta de varios microservicios en una sola.
  • Monitoreo y Limitación de Tasa: Registra todas las solicitudes, permitiendo monitorear el uso y prevenir abusos.

2. Capa de Microservicios: Lógica de Negocio Desacoplada

En esta capa reside la inteligencia de negocio para cada dominio de datos. Se construyen pequeños servicios independientes, cada uno responsable de una única función o entidad de negocio.

Contribuyente-API

Responsabilidad: Ofrecer una visión de 360 grados de un ciudadano o empresa.
Fuentes: SIVERVCUNDINAMARCA, GEVIR, STTI.

Impuesto-Vehicular-API

Responsabilidad: Gestionar toda la lógica del impuesto vehicular.
Fuentes: SIVERVCUNDINAMARCA, RUNT.

Impuesto-Consumo-API

Responsabilidad: Centralizar la información del impuesto al consumo.
Fuentes: STTI, SIANCO.

Tornaguia-API

Responsabilidad: Manejar el ciclo de vida de las tornaguías.
Fuentes: STTI, SIANCO.

Documento-API

Responsabilidad: Servir como interfaz única para la gestión documental.
Fuentes: SGDEA / CONDOR 1, MERCURIO, SIPROJ.

Integración con MIAC y Otras Aplicaciones

Las aplicaciones consumidoras, como el MIAC, no necesitan saber la complejidad de los sistemas de fondo. Simplemente realizan llamadas seguras y estandarizadas a través del API Gateway.

Esto simplifica enormemente el desarrollo de los modelos de IA y otras aplicaciones, ya que interactúan con una única interfaz consistente y bien definida.

Ejemplo: MIAC llama a GET /vehiculos/{placa}/obligaciones sin preocuparse de si los datos provienen de Oracle o de un sistema antiguo.

Fuentes de Datos

Estos son los sistemas originales donde reside la información. La capa de microservicios actúa como un "traductor" o "wrapper" para exponer sus datos de una manera moderna y accesible a través de APIs RESTful.

  • SIVERVCUNDINAMARCA
  • GEVIR
  • STTI
  • SIANCO
  • SGDEA / CONDOR 1
  • RUNT
  • MERCURIO
  • SIPROJ

3. Implementación y Tecnologías

APIs

Estándar RESTful con formato JSON, el lenguaje universal de la web moderna.

API Gateway

Soluciones robustas como Amazon API Gateway, Azure API Management, o Kong.

Microservicios

Desarrollados en Python, Java (Spring Boot) o Node.js, y desplegados en contenedores (Docker).

Estrategia: La implementación debe ser iterativa, comenzando con los microservicios de mayor impacto (Contribuyente-API e Impuesto-Vehicular-API) para demostrar valor rápidamente.