Diseño técnico - DS Client

Objetivo

Documentar el diseño técnico del proceso DS Client, incluyendo la arquitectura, parámetros, staging temporal, modelo de datos, relaciones identificadas, dependencias y consideraciones técnicas asociadas a la construcción y/o actualización de la dimensión cat_master_alpura.sch_bronze_layer.snw_dim_clientes.

Alcance

Dentro del alcance

• Arquitectura técnica del proceso NB_Silver_DS_Client.
• Notebook principal y capa lógica.
• Widgets identificados.
• Staging temporal.
• Output Delta.
• Modelo de datos.
• Relaciones y joins identificados.
• Llaves identificadas.
• Dependencias técnicas.
• Consideraciones técnicas identificadas.

Fuera del alcance

• Diseño funcional del proceso.
• Flujo paso a paso completo del pipeline.
• Reglas de negocio detalladas.
• Runbook L1.
• Validaciones no especificadas.
• Cardinalidad exacta de relaciones.
• Inventario completo de columnas y alias.

Contenido principal

Descripción general

Este documento concentra el diseño técnico del proceso DS Client, documentado como proceso de dimensión en capa lógica Silver.

El proceso se ejecuta mediante el notebook NB_Silver_DS_Client, utiliza los staging temporales TEMP_CLI y TEMP_CLIENTES, consume fuentes AS400 y dimensiones relacionadas, aplica joins para comparar, homologar o enriquecer la información y persiste el resultado en cat_master_alpura.sch_bronze_layer.snw_dim_clientes mediante saveAsTable.

Arquitectura del Proceso.

Elemento	Valor
Notebook Databricks	NB_Silver_DS_Client
Proceso	NB_Silver_DS_Client
Tipo de objeto	Dimensión
Capa lógica	Silver
Nivel de documentación	DIM
Comandos exportados	11
Staging temporal	TEMP_CLI, TEMP_CLIENTES
Output Delta	cat_master_alpura.sch_bronze_layer.snw_dim_clientes

Widgets Identificados

El proceso utiliza los siguientes widgets:

• w_StartDate
• w_EndDate
• w_catalog
• w_schema origin
• w_schema destiny

Modelo de Datos

Campo	Valor
Fact principal	No aplica; proceso documentado como dimensión.
Dimensión principal	cat_master_alpura.sch_bronze_layer.snw_dim_clientes
Dimensiones relacionadas	cat_master_alpura.sch_bronze_backup.snw_dim_clientes, cat_master_alpura.sch_bronze_layer.snw_dim_canal, cat_master_alpura.sch_bronze_layer.snw_dim_ejecutivos_vtas, cat_master_alpura.sch_bronze_layer.snw_dim_estado, cat_master_alpura.sch_bronze_layer.snw_dim_estatus, cat_master_alpura.sch_bronze_layer.snw_dim_gpo_comercial, cat_master_alpura.sch_bronze_layer.snw_dim_grupo_cliente, cat_master_alpura.sch_bronze_layer.snw_dim_grupo_sop, cat_master_alpura.sch_bronze_layer.snw_dim_subcanal, cat_master_alpura.sch_bronze_layer.snw_dim_subgpo_comercial, cat_master_alpura.sch_bronze_layer.snw_dim_tipo_venta
Relaciones	Relaciones detectadas a partir de joins del DBC; la cardinalidad exacta debe validarse contra los datos fuente. Joins relevantes: LEFT OUTER JOIN {v_catalog}.{v_schema_origin}.as4_mctenc M | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_tipo_venta tv | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_gpo_comercial gc | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_subgpo_comercial sgc | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_canal c | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_subcanal sc | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_canal cs | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_subcanal scs | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_grupo_sop gs | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_grupo_cliente gcli | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_ejecutivos_vtas ej | LEFT JOIN cat_master_alpura.sch_bronze_layer.snw_dim_estado est
Llaves identificadas	CVE_CANAL, CVE_SUBCANAL, CVE_CTE, ID_CTE, CVE_ESTADO, CVE_GPOCOM, ID_PLADIS, CVE_ZONA

Dependencias Técnicas

• /Workspace/Shared/Alpura_DEV/00_Framework/NB_FRAMEWORK_LIBRARIES
• cat_master_alpura.sch_bronze_backup.snw_dim_clientes
• cat_master_alpura.sch_bronze_layer.snw_dim_canal
• cat_master_alpura.sch_bronze_layer.snw_dim_clientes
• cat_master_alpura.sch_bronze_layer.snw_dim_ejecutivos_vtas
• cat_master_alpura.sch_bronze_layer.snw_dim_estado
• cat_master_alpura.sch_bronze_layer.snw_dim_estatus
• cat_master_alpura.sch_bronze_layer.snw_dim_gpo_comercial
• cat_master_alpura.sch_bronze_layer.snw_dim_grupo_cliente
• cat_master_alpura.sch_bronze_layer.snw_dim_grupo_sop
• cat_master_alpura.sch_bronze_layer.snw_dim_subcanal
• cat_master_alpura.sch_bronze_layer.snw_dim_subgpo_comercial
• cat_master_alpura.sch_bronze_layer.snw_dim_tipo_venta
• {v_catalog}.{v_schema_origin}.as4_mctenc
• {v_catalog}.{v_schema_origin}.as4_mctencj0

Output Principal

Objeto	Tipo
cat_master_alpura.sch_bronze_layer.snw_dim_clientes	Dimensión / Output Delta

Consideraciones Técnicas

• Validar valores de widgets antes de ejecutar:
  • w_StartDate
  • w_EndDate
  • w_catalog
  • w_schema origin
  • w_schema destiny
• Validar permisos de escritura y existencia del catálogo / esquema destino antes de ejecutar saveAsTable.
• Revisar volumen de comparación full join para evitar degradación de performance.
• Validar owner técnico y permisos sobre fuentes y outputs.
• No documentar ni exponer lógica no presente en el DBC.
• La cardinalidad exacta de las relaciones debe validarse contra los datos fuente.

Artefactos relacionados

Artefacto	Descripción
Diseño Funcional - DS_Client	Describe el objetivo funcional, alcance y descripción general del proceso
Fuentes - DS_Client	Documenta las fuentes de datos utilizadas por el proceso.
Operación - DS_Client	Documenta consideraciones operativas, Runbook L1 y soporte.
Pipelines - DS_Client	Describe la secuencia de ejecución del proceso.
Reglas de Negocio - DS_Client	Contiene las reglas identificadas para el procesamiento.
Tablas - DS_Client	Documenta dimensión principal, objetos relacionados y llaves identificadas.
Validaciones - DS_Client	Describe menciones relacionadas con validaciones, revisión de fallos y acciones básicas.

Próximos pasos

• Validar la cardinalidad exacta contra los datos fuente.
• Validar owner técnico del proceso.
• Validar permisos sobre fuentes y outputs.
• Revisar volumen de comparación full join para evitar degradación de performance.