Data Needs - APV Business Observer

Fecha: 2026-06-08

Estado: ALINEADO CON AUDITORIA DE FUNDACION DE DATOS

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Objetivo

Consolidar, en version resumida, los datos funcionales que APV necesita para su Business Observer, alineados con:

• BUSINESS-OBSERVER-DATA-FOUNDATION-AUDIT-001.md
• UC001 a UC009
• la separacion Core vs Tenant
• la separacion APV vs La Directa

Este documento ya no es solo un listado preliminar.

Es una sintesis operativa de la auditoria de fundacion de datos.

El detalle contractual por dato, por UC y por futura preparacion de dataset queda ahora en:

• BUSINESS-OBSERVER-DATA-CONTRACT-001.md

Criterios oficiales

• no inventar datos
• declarar fuente esperada
• diferenciar dato real, relevado, estimado y calculado
• mantener fecha, origen y responsable cuando aplique
• no mezclar precios propios con competencia sin contexto
• no mezclar demanda confirmada con oportunidad estimada
• aplicar la regla historicos por valor de decision
• contemplar historico cuando un dato permita medir evolucion, detectar patrones, explicar tendencias, generar alertas, mejorar decisiones comerciales o alimentar aprendizaje futuro
• no guardar todo sin criterio; disenar historicos livianos, trazables y utiles
• para SOURCE-002, usar tenant_id + SKU como clave canonica del dominio producto
• para SOURCE-001, usar tenant_id + codigo_cliente como clave logica recomendada del dominio cliente derivado de VCLIENTES
• para SOURCE-001, canonicalizar codigo_cliente como NULLIF(LTRIM(RTRIM([Codigo])), '')
• para SOURCE-001, interpretar customers_core, customers_contact, customers_address, customers_tax, customers_commercial, customers_sales_owner y customers_visit_schedule como grupos logicos del mismo cliente y no como clientes distintos
• para SOURCE-002, interpretar articulo, marca, estado, stock, stock en bultos, costos, descuentos, precios, IVA, margenes, proveedor, categoria, unidad de medida, palletizado, fechas operativas e historicos utiles como datos asociados al SKU
• para SOURCE-002, distinguir explicitamente politica comercial, promociones, estrategia comercial, actividad comercial y volumetria / logistica como dominios propios del SKU
• no usar Proveedor solo como texto libre de clave analitica
• conservar Cod Proveedor como identificador de negocio del proveedor asociado al SKU
• conservar Marca como atributo comercial asociado al SKU
• si luego aparece codigo de marca, preservarlo junto con Marca
• para SOURCE-003, tratar Tabla 2 como unica salida sincronizable de ventas y comprobantes
• para SOURCE-003, tratar Tabla 1, Tabla 3, Tabla 4, Tabla 5 y Tabla 6 como reportes derivados reconstruibles desde Tabla 2
• para SOURCE-003, preservar contexto historico de la transaccion: costo, proveedor, marca, precio, descuentos, impuestos, peso, volumen y bultos
• para SOURCE-003, contemplar una futura line_key porque un comprobante podria repetir el mismo SKU
• para SOURCE-003, preservar precision suficiente para evitar diferencias futuras por redondeo

Datos que probablemente se necesitaran

• clientes
• vendedores
• productos
• marcas
• proveedores
• ventas historicas itemizadas desde SOURCE-003 / Tabla 2
• frecuencia de compra
• ultimas compras
• mix por cliente
• SKU comprados
• SKU no comprados
• categorias compradas
• categorias no compradas
• marcas estrategicas vigentes
• productos prioritarios vigentes
• relaciones de producto complementario, similar o sustituto cuando apliquen
• clientes similares por perfil comercial
• zonas
• supervisores
• objetivos comerciales
• campanas o acciones realizadas
• demanda no atendida reportada por vendedores
• causas comerciales u operativas de faltante
• aceptacion o rechazo de sustitutos
• pedidos de aviso por reposicion
• calendario del mes
• feriados
• dias laborables teoricos
• dias realmente trabajados
• comprobantes emitidos por fecha derivados desde SOURCE-003 / Tabla 2
• dias con facturacion
• ventas por fecha
• stock diario al cierre
• costos vigentes por fecha
• precios vigentes por fecha
• precios previos por fecha
• cambios intradiarios de costo o precio cuando existan
• cambios de listas de precio
• cambios de IVA
• cambios de margen y descuento cuando aporten valor de decision
• fecha de ultima actualizacion de costo
• fecha de ultima actualizacion de precio
• disponibilidad o stock observado
• inventario historico diario ideal
• eventos derivados de inventario, como quiebre, recuperacion y riesgo de faltante
• ingresos de mercaderia o recuperaciones detectables cuando sirvan para abastecimiento o aprendizaje
• relevamientos de mercado realizados por vendedores
• competencia observada
• marca competidora observada
• precio de compra informado por cliente
• precio de venta al publico informado
• precio esperado por cliente
• contexto de oferta, promocion o liquidacion
• clasificacion de precio comparable o no comparable
• recomendacion generada
• motivo o explicacion de recomendacion
• prioridad relativa de recomendacion
• urgencia temporal de recomendacion
• actor objetivo de recomendacion
• estado de ejecucion humana
• resultado posterior observado
• trazabilidad entre recomendado, ejecutado y resultado

Regla de lectura para producto:

• dentro de SOURCE-002, el producto se ancla en tenant_id + SKU
• los analisis por marca o proveedor deben derivarse desde los SKU asociados
• la cobertura campo por campo del SELECT vigente de SOURCE-002 queda cerrada documentalmente con 81 campos clasificados en SOURCE-002-FUTURE-LAYER-MAPPING.md
• no quedan campos de SOURCE-002 fuera de documentacion, sin capa futura o sin relacion clara con tenant_id + SKU

Clasificacion resumida

Datos minimos de primera implementacion futura

• clientes
• vendedores
• productos
• SKU
• marcas
• proveedores
• ventas historicas itemizadas
• comprobantes por fecha
• detalle itemizado de comprobantes desde SOURCE-003 / Tabla 2
• stock actual
• costos vigentes por fecha
• precios vigentes por fecha

Datos muy valiosos a validar despues

• stock historico
• costos historicos
• precios historicos
• impuestos historicos
• margenes y descuentos historicos
• quiebres y recuperaciones de stock historizados
• ingresos de mercaderia historizados cuando aporten valor de decision
• zonas
• supervisores
• categorias
• listas de precio
• unidades por bulto

Datos que deberan empezar a capturarse

• demanda no atendida reportada por vendedores
• productos reclamados
• relevamientos de precio y competencia
• precio esperado por cliente
• acciones comerciales realizadas
• resultado de acciones
• objetivos y compromisos comerciales

Datos calculados futuros

• riesgo comercial
• oportunidad economica perdida estimada
• score de prioridad
• cliente subdesarrollado
• recomendacion priorizada
• duracion estimada de quiebre

Lectura funcional esperada

Estos datos servirian para analizar, por ejemplo:

• riesgo comercial de clientes
• perdida de participacion de marca
• perdida de volumen
• oportunidades de siembra
• oportunidades de ampliacion
• impacto por vendedor o zona
• demanda confirmada no atendida
• oportunidad economica perdida estimada
• dias sin stock y faltantes repetidos
• productividad por dia trabajado
• proyeccion sobre dias efectivos de venta
• cobertura operativa real de stock
• brecha entre costo, precio propio y precio de mercado
• diferencias territoriales de precio
• comportamiento temporal de competidores
• efectividad de recomendaciones comerciales priorizadas
• huecos de surtido por cliente
• clientes subdesarrollados por vendedor, zona o canal
• SKU natural siguiente por cliente
• oportunidades de cross-selling, up-selling y ampliacion de marca
• productos reclamados por vendedor, cliente o zona
• impacto de abastecimiento por proveedor, marca y SKU critico

Aclaraciones obligatorias

• todavia no se disenan tablas
• todavia no se disenan APIs
• todavia no se conectan fuentes
• esto es preparacion funcional
• la fuente de verdad detallada pasa a ser: BUSINESS-OBSERVER-DATA-CONTRACT-001.md
• la auditoria de respaldo sigue siendo: BUSINESS-OBSERVER-DATA-FOUNDATION-AUDIT-001.md
• el estado de preservacion de queries autoridad queda en: source-authority/SOURCE-AUTHORITY-REGISTRY.md

Pendientes

Queda pendiente definir o validar:

• fuente real de productos documentada: SOURCE-002 - Maestro de productos / ecommerce.dbo.PRODUCTS
• confirmacion humana cerrada para SOURCE-002: la query nueva queda confirmada por Gabi como autoridad vigente
• primera lista conocida de exclusiones operativas para SOURCE-002: SKU NOT IN ('0124', '3857', '3998', '3793')
• razon de negocio documentada para esas exclusiones: algunos articulos del SGC pueden corresponder a operaciones internas o no tradicionales y no deben importarse como productos comerciales normales
• fuente complementaria real de imagenes documentada: SOURCE-002B - WooCommerce por SKU
• fuente real calculada documentada para ventas y comprobantes: SOURCE-003 - SGC ventas / comprobantes calculados desde query sagrada
• decision documental cerrada para SOURCE-003: sincronizar solo Tabla 2; Tabla 1/3/4/5/6 quedan como reportes derivados
• registro oficial de autoridad de fuentes: SOURCE-AUTHORITY-REGISTRY
• fuente funcional futura para snapshot diario de stock: SOURCE-002C - Snapshot diario de inventario a las 17:00
• fuente funcional futura para stock actual liviano: SOURCE-002D - Stock intradiario liviano cada 10 minutos
• documento conceptual futuro para separar SOURCE-002 en capas: SOURCE-002-FUTURE-LAYER-MAPPING
• documento especifico futuro para la capa economica y listas de precios normalizadas: SOURCE-002-ECONOMIC-LAYER
• capa funcional futura para eventos derivados de inventario: Inventory Events Layer - Eventos de inventario
• inventario real de fuentes existentes campo por campo
• calidad real de clientes, productos, marcas y SKU
• vigencia real de costos y precios
• ventana movil final para recalculo de ventas y comprobantes de SOURCE-003
• clave funcional final de Tabla 2 para SOURCE-003
• query completa autoridad de SOURCE-003
• unicidad real de Codigo en SOURCE-001
• semantica real de Estado en SOURCE-001
• calidad real de WhatsApp en SOURCE-001
• consistencia real de vendedor y Frecuencia en SOURCE-001
• documento futuro recomendado para SOURCE-003: SOURCE-003-PYTHON-POSTGRES-REPLICATION-DESIGN
• futura parametrizacion de la lista de exclusiones operativas de SOURCE-002 dentro del script de sincronizacion cuando esa implementacion exista
• criterio final de comparabilidad de UC006
• criterio final de dias reales trabajados para UC005
• disciplina minima de captura manual para UC003, UC004, UC006 y UC009
• taxonomia oficial de acciones comerciales
• taxonomia oficial de objetivos y compromisos
• historico diario de stock
• historico por cambio de precios, costos, impuestos, margenes y descuentos
• regla transversal de historizacion por valor de decision aplicada a costo, precio, IVA, margen, descuento, quiebres, recuperaciones, ingresos y snapshots utiles
• separacion operativa futura entre snapshot diario historico y stock intradiario frecuente
• auditabilidad completa de recomendado vs ejecutado vs resultado