Catalogos Maestros

En el ecosistema tecnológico de Alpura, la consistencia y la integridad de la información son pilares fundamentales para la operación. Por ello, se ha establecido una arquitectura de Catálogos Maestros, cuyo propósito es centralizar, homologar y distribuir la información clave del negocio hacia todos los sistemas e integraciones satélites de la compañía.

El sistema core Oracle Cloud actúa como la fuente única de la verdad (Single Source of Truth). Ninguna integración modifica estos datos directamente; en su lugar, se implementa un pipeline de datos asíncrono y gobernado que extrae, transforma y expone esta información de manera segura.

1. Arquitectura y Flujo de Datos del Pipeline

El proceso de sincronización, transformación y disponibilidad de los catálogos maestros sigue un flujo estructurado y completamente aislado por entornos (DEV, UAT y PROD) a través de nuestra plataforma de datos de Alpura:

1. Extracción e Ingesta Nocturna (Oracle Cloud → Databricks): Diariamente, dentro de una ventana de tiempo que va de las 11:00 PM a las 03:00 AM, se ejecuta un proceso automatizado que extrae la información analítica y operativa desde Oracle Cloud hacia la base de datos de ingesta cat_master_oracle_fusion en Databricks. Los datos aterrizan en el esquema sch_gold_layer bajo una nomenclatura estricta que identifica el entorno de origen sin mezclar la información:

   • Ambiente DEV: Modela las tablas en su formato limpio e inicial (<Table>).
   • Ambiente UAT: Aplica un sufijo de preparación intermedia (<Table>_stg).
   • Ambiente PROD: Registra la data con sufijo de aislamiento productivo (<Table>_prd).

2. Capa de Aplicación en Databricks (cat_master_aplicaciones): Una vez hecha la ingesta en la base de cat_master_oracle_fusion, los datos son tomados a travez de vistas que se encuentran almacenadas dentro de la base de datos cat_master_aplicaciones, segmentando de manera estricta en el ciclo de vida del software, en tres esquemas clave:

   • 🥉 Schema Bronce: Destinado exclusivamente al ambiente de Desarrollo (DEV).
   • 🥈 Schema Silver: Reservado para el ambiente de Pruebas de Usuario o Pre-producción (UAT).
   • 🥇 Schema Gold: Contiene los catálogos maestros consolidados y validados para el entorno de Producción (PROD).

3. Réplica Matutina hacia Google Cloud (Databricks → GCP): En una ventana programada entre las 07:00 AM y las 08:00 AM, se disparan los procesos de réplica de Postgres. Estos transfieren la información de cada esquema de Databricks hacia la base de datos omnicanal alojada en GCP (Google Cloud Platform). Los datos se depositan de forma independiente dentro del schema general_catalogs de cada uno de los tres ambientes paralelos, asegurando que el entorno transaccional sea óptimo y esté aislado.

4. Capa de Exposición y Consumo de Clientes (GCP → APIs): Con la información fresca y disponible en el ecosistema de GCP, los datos se exponen de cara al consumo mediante Web Services (APIs HTTP) dedicados por ambiente (DEV, UAT, PROD). Las aplicaciones de Alpura (como el Tablero de Calidad o herramientas de plazos de crédito) realizan Peticiones Manuales/Bajo Demanda a estos servicios para obtener y consumir los catálogos maestros entregando la información en formato JSON.

---

2. Diagrama

2. Diccionario de Catálogos Maestros Disponibles

A continuación se detallan todos los catálogos originarios de Oracle Cloud que son procesados, integrados y expuestos a través de este pipeline para el ecosistema de aplicaciones de Alpura:

Catalogo Maestro	Módulo / Tipo	Descripción	Esquema de Destino (GCP)
alp_cat_ar_clientes	Cuentas por Cobrar (AR)	Maestro general de clientes, cuentas, direcciones y estados de cuenta comerciales.	general_catalogs
alp_cat_cdm_clientes	Gestión de Datos (CDM)	Customer Data Management: unificación de identidades de clientes y agrupaciones comerciales de Alpura.	general_catalogs
alp_cat_fnd_flex_fields	Fundacionales (FND)	Configuraciones de campos flexibles y parametrizaciones base del sistema ERP.	general_catalogs
alp_cat_fnd_lookups	Fundacionales (FND)	Catálogo maestro de llaves, códigos de referencia, listas de selección y valores del sistema.	general_catalogs
alp_cat_hcm_employees	Recursos Humanos (HCM)	Human Capital Management: Maestro de colaboradores, empleados, puestos e identificadores de nómina.	general_catalogs
alp_cat_inv_almacenes	Inventarios (INV)	Maestro de almacenes físicos, centros de distribución (CEDIS) y plantas de Alpura.	general_catalogs
alp_cat_inv_items	Inventarios (INV)	Catálogo maestro de artículos, SKUs, productos terminados, materias primas y unidades de medida.	general_catalogs
alp_cat_inv_localizadores	Inventarios (INV)	Detalle de localizadores, pasillos, racks y sub-inventarios dentro de los almacenes oficiales.	general_catalogs
alp_cat_qp_discount_list	Precios y Descuentos (QP)	Listados de descuentos comerciales autorizados, reglas de bonificación y promociones.	general_catalogs
alp_cat_qp_matriz_items_precios	Precios y Descuentos (QP)	Matriz cruzada que asocia la relación directa entre SKUs (artículos) y sus precios base de venta.	general_catalogs
alp_cat_qp_price_lists	Precios y Descuentos (QP)	Listas de precios oficiales por canal de venta, regiones geográficas y tipos de clientes.	general_catalogs
alp_cat_qp_pricing_assignments_strategy	Precios y Descuentos (QP)	Reglas de asignación estratégica de precios basadas en acuerdos comerciales específicos.	general_catalogs
alp_cat_qp_pricing_oracle	Precios y Descuentos (QP)	Motor de datos de precios nativos sincronizados desde el módulo de Advanced Pricing de Oracle.	general_catalogs
alp_cat_qp_pricing_profiles	Precios y Descuentos (QP)	Perfiles comerciales de clientes asignados para la segmentación y cálculo dinámico de precios.	general_catalogs
alp_cat_qp_pricing_segments	Precios y Descuentos (QP)	Segmentos de mercado y grupos tarifarios utilizados para aplicar políticas de precios en Alpura.	general_catalogs

Consejo de Mantenimiento

Si requieres añadir un nuevo catálogo, recuerda que primero debes crear la vista en la base cat_master_aplicaciones de Databricks respetando los componentes con los sufijos de ambiente (_stg, _prd) antes de generar la réplica hacia la base omnicanal en GCP.