Diseño técnico - RTM

Objetivo

Documentar el diseño técnico del proceso RTM - Visita Clientes, incluyendo la arquitectura identificada, las dimensiones consumidas, el modelo de datos, las relaciones, llaves y dependencias necesarias para la generación de la tabla Silver as4_rtm_visita_clientes.

Alcance

Dentro del alcance

• Arquitectura técnica identificada para el proceso RTM.
• Dimensiones consumidas por el notebook NB_Silver_DS_RTM.dbc.
• Modelo de datos asociado a la fact principal as4_rtm_visita_clientes.
• Relaciones, llaves y dependencias documentadas.

Fuera del alcance

• Diseño funcional del proceso.
• Descripción detallada de fuentes de datos.
• Reglas de negocio.
• Gobierno y trazabilidad.
• Runbook operativo.
• Validaciones de calidad de datos.
• YAML del proceso.

Contenido principal

Descripción general

Este documento concentra el diseño técnico del proceso RTM - Visita Clientes, incluyendo la arquitectura identificada, componentes principales, modelo de datos, relaciones y dependencias técnicas necesarias para la generación de as4_rtm_visita_clientes.

El proceso parte de fuentes as4_* y dimensiones snw_*, contruye vistas temporales de procesamiento RTM y finaliza con la carga de la tabla Delta Silver as4_rtm_visita_clientes.

Arquitectura del Proceso.

Dimensiones utilizadas

Dimensión consumida	Notebook DBC	Uso	Llaves
snw_dim_clientes	NB_Silver_DS_Client.dbc	Razón social y canal SOP del cliente	ID_CTE/NUMCTE, ID_SUC/NUMSUC
snw_dim_depositos	Dim_depositos.dbc	Descripción de depósito	ID_DEPOSITO
snw_dim_canal	NB_Silver_DS_Channel.dbc	ID_CANAL y descripción de canal	CVE_CANAL

Consideración

El DBC de depósitos observado escribe cat_master_alpura.sch_bronze_layer.snw_deposit, mientras que RTM consume snw_dim_depositos en el esquema destino configurado. Validar alineación de nombres en operación.

Modelo de Datos

Fact principal:

• cat_master_alpura.sch_silver_layer.as4.rtm_visita_clientes

Dimensiones:

• snw_dim_clientes
• snw_dim_depositos
• snw_dim_canal

Relación	Llave	Tipo
Fact RTM → Cliente	NUMCTE + NUMSUC	LEFT JOIN en etapa base
Fact RTM → Depósito	ID_DEPOSITO	LEFT JOIN en etapa base
Fact RTM → Canal	CVE_CANAL	LEFT JOIN en etapa final
Visita → Ruta cliente	CVEDEP + NUM_RUTA + FECHA/FECINI + HORA_INI	LEFT JOIN
Ruta cliente → Calendario de visita	CVEDEP + NUM_RUTA + NUMCTE + NUMSUC	LEFT JOIN

Llaves identificadas:

• FECHA
• NUMCTE
• NUMSUC
• ID_DEPOSITO
• NUM_RUTA
• IDVISI
• VENDOR
• _row_hash como hash técnico de trazabilidad

Dependencias

Tipo	Dependencia	Observación
Parámetro	w_StartDate, w_EndDate	Obligatorios, formato yyyyMMdd.
Parámetro	w_catalog, w_schema_origin, w_schema_destiny	Usados para resolver nombres de objetos.
Fuente	as4_* Silver	Deben existir antes de RTM.
Dimensión	snw_dim_clientes, snw_dim_depositos, snw_dim_canal	Deben estar actualizadas antes de ejecutar RTM.
Output	as4_rtm_visita_clientes	Tabla Delta final.

Clasificación de Objetos

Dimensiones documentadas:

• Dim_depositos.dbc
• NB_Silver_DS_Channel.dbc
• NB_Silver_DS_Client.dbc

Tablas migradas consumidas:

• as4_hhdplad
• as4_adasirut
• as4_mcterut
• as4_admotiv
• as4_mctecomp
• as4_cat_historico_ctes

Consideraciones Técnicas

• El DBC de depósitos observado escribe cat_master_alpura.sch_bronze_layer.snw_deposit, mientras que RTM consume snw_dim_depositos en el esquema destino configurado.
• Se indica validar la alineación de nombres entre los objetos de depósitos utilizados por el proceso.
• La variable de vista vw_as4_rtm_visita_clientes se encuentra definida, pero en el DBC proporcionado no se identificó una sentencia efectiva CREATE VIEW.
• Las fuentes as4_* Silver deben existir antes de la ejecución del proceso RTM

Artefactos relacionados

Artefacto	Descripción
Diseño Funcional - RTM	Describe el objetivo funcional, alcance y flujo funcional del proceso
Fuentes - RTM	Describe las fuentes de información consumidos por el proceso.
Operación - RTM	Documenta consideraciones operativas, Runbook L1 y soporte.
Pipelines - RTM	Describe la secuencia de ejecución y procesamiento de datos.
Reglas de Negocio - RTM	Contiene las reglas aplicadas durante el procesamiento.
Tablas - RTM	Documenta las tablas origen, dimensiones y tabla final.
Validaciones - RTM	Describe validaciones identificadas.

Próximos pasos

• Validar la alineación de nombres entre snw_dim_depositos y cat_master_alpura.sch_bronze_layer.snw_deposit.
• Confirmar si existe una sentencia efectiva CREATE VIEW para vw_as4_rtm_visita_clientes