SOURCE-003 Snapshot 001 - Tabla 2 V2¶

Fecha: 2026-06-10

Estado: SNAPSHOT CONTROLADO CAPTURADO / BASE CONGELADA CARGADA EN PILOTO LOCAL

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/SOURCE-003-SNAPSHOT-001.md

Fuente evaluada: docs/tenants/alpuntodeventa/business-observer/source-authority/SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY-V2.sql

1. Objetivo¶

Tomar un snapshot controlado de SOURCE-003 / Tabla 2 V2 con seleccion explicita de resultset, para congelar evidencia antes de cualquier nuevo intento de carga hacia PostgreSQL.

Este frente no ejecuto carga, sync, migracion, insert, upsert ni delete. La documentacion guarda solo agregados y evidencia tecnica del snapshot; no expone datos personales ni valores identificatorios de clientes o comprobantes.

2. Safe point¶

git status -sb: ## main...origin/main
git rev-parse HEAD: 2615e81aa4ac53f871a2c75baed8698398deb0c5

3. Alcance aplicado¶

modo: INVENTORY + VALIDATE
conexion SGC: solo lectura
SELECT 1 contra SGC: PASS, resultado 1
fuente: mssql:mssql-sgc-ecommerce
autoridad SQL: SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY-V2.sql
query sha256: f23b671e2ac6c20e0a62734124a279573a8153bc187082b2f5e1c75a078abf71
PostgreSQL: no tocado
VPS: no tocado
Docker: no tocado
OpenClaw: no tocado
migraciones: no creadas
datos destino: no insertados
sync: no ejecutada

La extraccion uso READ UNCOMMITTED, temporales de sesion de la autoridad SQL y cierre con rollback de la conexion de lectura. No se persistio ningun objeto en SGC.

4. Ventana elegida¶

Campo	Valor
`@FechaDesde`	`2026-06-09`
`@FechaHasta`	`2026-06-09`
fecha/hora local de extraccion	`2026-06-10T21:04:06-03:00`

Criterio:

la fecha local de trabajo era 2026-06-10
se excluyo 2026-06-10 por ser dia en curso
2026-06-09 era la fecha cerrada mas reciente disponible con filas activas
la ventana se mantuvo chica y controlada: un solo dia

5. Flags forzados¶

La corrida no dependio de los defaults de V2.

Flag	Valor
`@ShowTabla1`	`0`
`@ShowTabla2`	`1`
`@ShowTabla3`	`0`
`@ShowTabla4`	`0`
`@ShowTabla5`	`0`
`@ShowTabla6`	`0`

Resultado de resultsets:

Control	Resultado
resultsets totales	`1`
resultsets con filas	`1`
resultset seleccionado	`Tabla 2`
columnas observadas	`68`

6. Archivo de snapshot¶

El snapshot local queda fuera de Git por regla de .gitignore para snapshots/*.

Campo	Valor
path	`C:\APV\openclawai\snapshots\source-003\SOURCE-003-TABLA2-V2-2026-06-09_20260610-210406-0300.csv`
hash file	`C:\APV\openclawai\snapshots\source-003\SOURCE-003-TABLA2-V2-2026-06-09_20260610-210406-0300.csv.sha256`
filas	`1886`
bytes	`1169895`
sha256	`07092c284b5b636b8a31cd616ef5b4fa5d0ce499b81c767437842b1f7edfcbc3`

Regla de uso:

el archivo puede contener datos transaccionales de origen
no se versiona en Git
no se copian datos personales ni claves documentales en esta evidencia
el hash global del snapshot es el sha256 del archivo CSV

7. Agregados principales¶

Metrica	Resultado
filas totales	`1886`
importe total (`Importe_Total_Todos_los_Items`)	`48087486.83`
`CMV` total (`CMVBruto_Item`)	`37881269.3025`
clientes unicos	`173`
vendedores unicos	`25`
`SKU` unicos	`180`
comprobantes unicos	`428`

Tipos de comprobante:

Tipo de comprobante	Filas	Importe total	`CMV` total
`FACTURA A`	`273`	`10589652.84`	`7831169.5104`
`GUIA DE DESPACHO`	`1383`	`42534340.59`	`31097184.8359`
`N/C GUIA DE DESPACHO`	`221`	`-4840991.74`	`-922924.2528`
`NOTA CREDITO A`	`9`	`-195514.86`	`-124160.7910`

8. Control de Hora¶

Control	Resultado
columna `Hora` presente	`SI`
posicion `Hora` en `Tabla 2`	`2`
filas con `Hora` vacia o nula	`0`
filas con formato `HHMMSS`	`1886`
valores `Hora` distintos	`373`
`Hora` minima observada	`090443`
`Hora` maxima observada	`161739`

9. Identidad de linea¶

line_sequence_v1 se recalculo en memoria para esta validacion, sin persistirlo y sin usar IdFila.

Control	Resultado
duplicados `line_key_v3`	`0` grupos / `0` filas
particiones `line_sequence_v1`	`1886`
secuencia maxima	`1`
empates en `ORDER BY` tecnico	`0` grupos / `0` filas
duplicados `line_key_v4 + line_sequence_v1`	`0` grupos / `0` filas

Lectura:

line_key_v3 no duplica en esta ventana
line_key_v4 + line_sequence_v1 no duplica en esta ventana
la decision global de identidad sigue siendo AMARILLO ACEPTADO, no VERDE, por la evidencia historica de ocurrencias absolutamente identicas en ventanas mayores

10. Decision¶

Decision: SNAPSHOT VALIDO.

El snapshot queda valido como base congelada para un futuro intento de carga piloto porque:

se ejecuto V2 con Tabla 2 seleccionada explicitamente
la ventana fue un dia cerrado reciente
el resultset fue unico
Hora esta presente y completa
no hay duplicados de line_key_v4 + line_sequence_v1
el archivo local tiene hash global registrado
los agregados quedan documentados sin datos personales

Conviene usar esta misma ventana, 2026-06-09, para una carga piloto posterior solo si el siguiente gate usa este snapshot como baseline congelada. No debe usarse una relectura viva de SGC como expectativa implicita sin compararla contra este snapshot.

No se detecto deriva o inconsistencia nueva en esta corrida. Se mantiene el riesgo ya documentado de fuente viva y de identidad AMARILLO ACEPTADO.

11. Proximo paso recomendado¶

Preparar un intento de carga piloto hacia source_003_sales_items usando como baseline este snapshot 2026-06-09, con gate previo de hash/agregados y sin depender de SGC vivo como verdad historica no congelada.

12. Checklist¶

solo lectura SGC: SI
sin PostgreSQL: SI
sin cargas: SI
sin sync: SI
sin migraciones: SI
Tabla 2 V2 explicita: SI
snapshot local generado: SI
hash registrado: SI
agregados documentados: SI
datos personales documentados: NO

13. Uso posterior en carga piloto local¶

Referencia: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-SALES-ITEMS-PILOT-LOAD-001.md

El 2026-06-10 este snapshot fue usado como unica fuente para una carga piloto controlada en PostgreSQL local, tabla business_observer.source_003_sales_items, base gestion_de_negocios_core.

Controles de uso:

Control	Resultado
CSV usado	`SOURCE-003-TABLA2-V2-2026-06-09_20260610-210406-0300.csv`
sha256 verificado	`07092c284b5b636b8a31cd616ef5b4fa5d0ce499b81c767437842b1f7edfcbc3`
filas cargadas	`1886`
conciliacion de importe total	`PASS`
conciliacion de `CMV`	`PASS`
duplicados `line_key_v4`	`0`
`source_row_hash_v1` calculado con `68` columnas	`SI`
datos quedaron cargados	`SI`
rollback ejecutado	`NO`

La captura original de este snapshot sigue siendo evidencia de solo lectura contra SGC. El uso posterior no releyo SGC vivo para cargar y no habilita sync diaria, carga masiva ni produccion final.