Saltar a contenido

SOURCE-002 Query Recovery Report

Fecha: 2026-06-07

Estado: RECUPERACION DOCUMENTAL COMPLETADA

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

1. Objetivo

Recuperar y documentar, sin tocar runtime ni conexiones reales, la trayectoria documental de SOURCE-002 hasta su reemplazo por la nueva query completa aportada por Gabi para el maestro de productos de APV.

2. Lugares revisados

Repos revisados:

  • C:\APV\openclawai
  • C:\APV\gestor-de-negocios

Archivos y zonas revisadas:

  • docs/tenants/alpuntodeventa/business-observer/...
  • backend/app/scheduler/scripts/sync_catalogo_pedidos_whatsapp_sgc_core.py
  • backend/app/services/catalogo_pedidos_whatsapp_sync_service.py
  • backend/app/repositories/sqlserver/catalogo_pedidos_whatsapp_repo.py
  • backend/app/plugins/alpuntodeventa/scheduler_jobs.py
  • backend/app/core/connections_registry.py
  • docs/modulos/catalogo_pedidos_whatsapp/OPERATING-MODEL.md
  • docs/tenants/alpuntodeventa/APV-CONNECTIONS-DEPENDENCY-AUDIT.md
  • tests y archivos .env.example
  • archivos .env.* solo para detectar nombres de variables y tipos de wiring

3. Evidencia encontrada

Hallazgos confirmados:

  • el runner exige que la query llegue desde system_connections.config.catalogo_pedidos_whatsapp_sync_query o por JOB_ARGS
  • el repo SQL Server resuelve la query desde config y no la hardcodea
  • el scheduler APV usa la conexion mssql:mssql-sgc-ecommerce
  • la documentacion operativa del modulo publica la query real usada y nombra dbo.PRODUCTS
  • la auditoria de dependencias APV confirma que la conexion mssql:mssql-sgc-ecommerce tiene catalogo_pedidos_whatsapp_sync_query
  • la integracion WooCommerce consulta /wp-json/wc/v3/products y pide id, sku, images, date_modified, date_modified_gmt

4. Query real encontrada o no encontrada

Resultado: encontrada como evidencia documental de referencia

Situacion exacta:

  • no esta hardcodeada en el codigo del sync
  • no se releyo desde runtime en esta auditoria
  • si aparece documentada de forma explicita en el repo de referencia

Resumen de estructura recuperada:

  • existia una query anterior de catalogo por SKU documentada sobre dbo.PRODUCTS
  • al 2026-06-07 esa version queda supersedida por la nueva query completa preservada en source-authority/SOURCE-002-PRODUCTOS-PRODUCTS-AUTHORITY.sql
  • la autoridad vigente pasa a cubrir tambien proveedor, costos, descuentos de compra, IVA, precios finales, margenes, logistica de bultos/pallets y fechas operativas

5. Tabla o vista confirmada o pendiente

Confirmada documentalmente:

  • dbo.PRODUCTS

Pendiente de validacion humana:

  • confirmar con Gabi si sigue siendo la tabla vigente hoy

6. Columnas confirmadas

Columnas o campos de origen confirmados en la autoridad vigente:

  • SKU
  • name
  • Marca
  • Estado
  • Stock
  • Unidades_Bulto
  • CostoLista
  • descCompra1
  • descCompra2
  • descCompra3
  • Costo
  • Markup
  • tax
  • MaxDctoArticulo
  • Price_L1 a Price_L9
  • Price_OF
  • Margen_L1 a Margen_L9
  • UltimaCompra
  • UltimaVenta
  • UltCambioCosto
  • DiasSinComprar
  • DiasSinVender
  • DiasSinActCosto
  • CntVentaMin
  • CntVentaAgrupada
  • UnidadMedida
  • Peso
  • Volumen
  • BasePallet
  • AlturaPallet
  • PLU
  • PluBulto
  • Proveedor
  • RazonSocial
  • Category
  • SubCategory

7. Campos pendientes o a validar

Pendientes de validacion humana, no de cobertura documental:

  • continuidad operativa de la query vigente en runtime
  • tipo exacto de stock: teorico, disponible o vendible
  • vigencia operativa de la lista de SKU excluidos

8. Estado final

SOURCE-002 - SGC Productos

  • estado final: fuente real documentada con autoridad completa vigente
  • fundamento: existe query completa preservada, tabla documentada y alcance funcional ampliado a maestro de productos

SOURCE-002B - WooCommerce Imagenes

  • estado final: fuente complementaria real documentada
  • fundamento: existe contrato de llamada, lookup por SKU, campos pedidos y regla de featured image

9. Preguntas concretas para Gabi

  • la query documentada sigue siendo la activa hoy en mssql:mssql-sgc-ecommerce
  • dbo.PRODUCTS sigue siendo la fuente vigente o fue reemplazada
  • stock_quantity representa stock teorico, disponible o vendible
  • pack_quantity representa unidad por bulto comercial usable por observer
  • el filtro Estado = 'ACTIVO' alcanza o negocio necesita estado completo
  • el cruce por SKU con woo_api:woo-alpuntodeventa sigue siendo estable

10. Confirmacion de seguridad

  • no se expusieron passwords, tokens ni API keys en la documentacion creada
  • no se copiaron connection strings completas
  • no se ejecuto sync real
  • no se ejecutaron conexiones reales
  • no se llamo WooCommerce
  • no se tocaron secrets del runtime
  • no se diseño SQL definitivo
  • no se toco runtime
  • SGC y WooCommerce quedaron documentados por separado