Saltar a contenido

Source Authority Registry - APV Business Observer

Fecha: 2026-06-10

Estado: REGISTRO OFICIAL ACTUALIZADO / SOURCE-003 VNEXT V2 CANDIDATE PRESERVADA

Scope: tenant

tenant_id: alpuntodeventa

Version: v3

Owner: Gabi / Carlos Canu

1. Proposito

Consolidar el registro oficial de autoridad de fuentes para el Business Observer de APV, dejando trazabilidad explicita sobre que query o documento es autoridad vigente y que alcance funcional cubre cada fuente.

2. Regla central

Las queries autoridad no se reinterpretan.

Si Gabi entrega una nueva version completa de una query autoridad, esa nueva version reemplaza a la anterior como autoridad vigente y, cuando Gabi la confirma explicitamente, debe preservarse textual en el repositorio como nueva autoridad operativa.

No corresponde:

  • reescribir calculos
  • simplificar joins
  • cambiar filtros
  • asumir columnas faltantes
  • reemplazar salidas calculadas por fuentes crudas

3. SOURCE-001 Clientes

  • source_id: SOURCE-001
  • nombre funcional: Clientes / VCLIENTES
  • autoridad esperada: query o script completo sobre ecommerce.dbo.VCLIENTES
  • estado de preservacion: AUTORIDAD PREVIA PRESERVADA + VNEXT CANDIDATE PRESERVADA
  • archivo principal relevado: docs/tenants/alpuntodeventa/business-observer/sources/SOURCE-001-SGC-CLIENTES.md
  • archivo autoridad documental: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-001-CLIENTES-VCLIENTES-AUTHORITY.md
  • version: v1

Conclusion operativa:

  • SOURCE-001 queda preservada completa
  • sigue vigente la restriccion de no reinterpretar la SELECT_CUSTOMERS_SQL

4. SOURCE-002 Maestro de productos

  • source_id: SOURCE-002
  • nombre funcional: Maestro de productos
  • autoridad esperada: query completa aportada por Gabi sobre [ecommerce].[dbo].[PRODUCTS]
  • estado de preservacion: EXISTE COMPLETA
  • archivo principal relevado: docs/tenants/alpuntodeventa/business-observer/sources/SOURCE-002-SGC-PRODUCTOS.md
  • archivo autoridad documental: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-002-PRODUCTOS-PRODUCTS-AUTHORITY.sql
  • version: v2

Resultado de verificacion:

  • existe la query completa preservada y confirmada por Gabi como nueva autoridad vigente
  • la autoridad ya no es solo catalogo por SKU
  • la autoridad cubre producto, marca, estado, stock actual, stock en bultos, proveedor, costos, descuentos de compra, markup, precios netos y finales, IVA, descuento permitido, oferta, clasificacion, L1..L9, fechas operativas, dias sin movimiento, unidad de medida, peso, volumen, palletizado, categoria y subcategoria
  • la base sigue siendo [ecommerce].[dbo].[PRODUCTS]
  • SKU NOT IN ('0124', '3857', '3998', '3793') queda documentado como la primera lista conocida de exclusiones operativas
  • esa exclusion responde a una razon de negocio confirmada por Gabi: algunos articulos del SGC se usan para operaciones internas o no tradicionales de compra/venta y no deben importarse como productos comerciales normales
  • cualquier futuro script de sincronizacion debera tratar esa lista como una regla configurable y no como una rigidez opaca
  • SOURCE-002C y SOURCE-002D quedan explicitamente como capas futuras y no como fuente base de stock actual

Conclusion operativa:

  • SOURCE-002 queda cerrada como autoridad completa del maestro de productos
  • la confirmacion humana de continuidad operativa con Gabi queda cerrada

5. SOURCE-003 Ventas / Comprobantes calculados

  • source_id: SOURCE-003
  • nombre funcional: Ventas / Comprobantes calculados / Tabla 2 / BalanceCtaCteFinal
  • autoridad esperada: query completa compartida por Gabi con DECLARE @ShowTabla2 BIT = 1
  • estado de preservacion: EXISTE COMPLETA
  • archivo principal relevado: docs/tenants/alpuntodeventa/business-observer/sources/SOURCE-003-SGC-VENTAS-COMPROBANTES.md
  • archivo autoridad documental anterior: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-TABLA2-AUTHORITY.sql
  • archivo autoridad documental vNext candidate: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY.sql
  • archivo autoridad documental vNext candidate V2: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY-V2.sql
  • delta review V1 vs V2: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-QUERY-DELTA-REVIEW.md
  • version: vnext-candidate-v2-2026-06-10

Conclusion operativa:

  • la autoridad anterior de SOURCE-003 queda preservada sin reemplazo
  • la query vNext candidate previa queda preservada como V1
  • la query actual completa pegada por Gabi queda preservada como V2 candidata, con aclaracion humana de conservar Hora en la query definitiva
  • Tabla 2 queda documentada como salida canonica futura de sync
  • Tabla 1/3/4/5/6 quedan como referencias de calculo ERP y conciliacion
  • no debe reemplazarse por una lectura cruda del ERP
  • no corresponde marcar todavia V2 como autoridad final cerrada porque falta revalidacion real de Tabla 2 V2
  • el delta V1 vs V2 queda clasificado como MEDIO: preserva Hora, line_key_v4, source_row_hash_v1, joins, filtros y calculos, pero cambia flags de salida y puede devolver multiples resultsets por defecto

6. Estado resumido de preservacion

  • SOURCE-001: EXISTE COMPLETA
  • SOURCE-002: EXISTE COMPLETA / MAESTRO DE PRODUCTOS VIGENTE
  • SOURCE-003: AUTORIDAD PREVIA PRESERVADA + VNEXT V1 PRESERVADA + VNEXT V2 CANDIDATE / REVALIDACION PENDIENTE

7. Archivos donde queda guardada la autoridad

  • SOURCE-001: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-001-CLIENTES-VCLIENTES-AUTHORITY.md
  • SOURCE-002: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-002-PRODUCTOS-PRODUCTS-AUTHORITY.sql
  • SOURCE-003: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-TABLA2-AUTHORITY.sql
  • SOURCE-003 vNext candidate: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY.sql
  • SOURCE-003 vNext candidate V2: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY-V2.sql
  • SOURCE-003 query delta review: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-QUERY-DELTA-REVIEW.md

8. Reglas de cambio

  • no modificar la logica de una query autoridad sin nueva version entregada por Gabi
  • no reemplazar archivos autoridad por resumentes
  • si aparece una nueva version completa, preservarla textual y actualizar este registro en el mismo cambio
  • si una nueva version queda solo como candidata, registrarla como candidate y no como autoridad final hasta cerrar validacion real
  • SOURCE-002C y SOURCE-002D no deben promoverse como fuente base de stock actual mientras no exista una decision explicita que cambie esa frontera

9. Riesgos de usar otra fuente

  • leer clientes desde otra fuente puede romper identidad comercial y ownership
  • leer productos desde otra query puede alterar SKU, stock, proveedor, costos, precios, IVA y logistica comercial
  • leer stock actual desde SOURCE-002C o SOURCE-002D como si fueran la fuente maestra puede romper la distincion entre maestro vigente, historia diaria e intradia
  • leer ventas desde V_VENTAS cruda puede romper calculos sagrados de SOURCE-003

10. Proximos pasos

  • cuando exista script, parametrizar de forma configurable la primera lista de exclusiones operativas de SOURCE-002
  • ejecutar la revalidacion real pendiente de Tabla 2 V2 y cerrar si vNext candidate V2 pasa a autoridad final
  • no avanzar con snapshot, cargas ni sync hasta cerrar esa revalidacion
  • mantener este registro como punto unico de referencia antes de cualquier implementacion futura

11. Confirmaciones de esta auditoria

  • no se implemento codigo
  • no se crearon tablas
  • no se crearon scripts ejecutables
  • no se toco runtime
  • no se tocaron VPS, Docker ni OpenClaw
  • no se ejecutaron conexiones reales
  • no se diseno SQL nuevo
  • solo se preservo y documento autoridad funcional
  • no se avanzo con snapshots, cargas ni sync