SOURCE-003 Pilot Load Prepared CSV 001¶

Fecha local: 2026-06-11 19:08:37 -03:00

Estado: CSV PREPARADO GENERADO / VALIDADO / FUERA DE GIT

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-PILOT-LOAD-PREPARED-CSV-001.md

1. Objetivo¶

Generar el CSV preparado exacto de 83 columnas destino requerido para una futura carga piloto minima de SOURCE-003-SNAPSHOT-001 en la DB dedicada openclaw_business_observer_dev, sin ejecutar SQL y sin tocar PostgreSQL.

2. Safe point¶

Control	Resultado
rama	`main`
`git status -sb`	`## main...origin/main`
`git rev-parse HEAD`	`8796345e7877fab627d1b5da496066593579a90f`
`git ls-remote origin main`	`8796345e7877fab627d1b5da496066593579a90f`
ultimo commit esperado	`docs: record source 003 pilot load execution`
decision	`SAFE POINT PASS`

3. Raw snapshot usado¶

Campo	Valor
fuente congelada	`SOURCE-003-SNAPSHOT-001`
archivo raw	`C:\APV\openclawai\snapshots\source-003\SOURCE-003-TABLA2-V2-2026-06-09_20260610-210406-0300.csv`
sha256 raw esperado	`07092c284b5b636b8a31cd616ef5b4fa5d0ce499b81c767437842b1f7edfcbc3`
sha256 raw observado	`07092c284b5b636b8a31cd616ef5b4fa5d0ce499b81c767437842b1f7edfcbc3`
validacion raw	`PASS`

4. CSV preparado generado¶

Campo	Valor
archivo preparado	`C:\APV\openclawai\snapshots\source-003\prepared\SOURCE-003-PILOT-LOAD-DEDICATED-DB-2026-06-09.csv`
sha256 preparado	`3f16a957a79fc84d4ca37930988287cb81f05166210d057fcf8b45007f184afe`
bytes	`1995826`
encoding	`UTF-8`
formato	`CSV`, delimitador `,`, header `true`
columnas	`83`
filas de datos	`1886`
ventana	`2026-06-09` a `2026-06-09`
archivo versionado en Git	`NO`
regla `.gitignore`	`.gitignore:9:snapshots/*`

5. Metadata preparada¶

Campo	Valor
`tenant_id`	`alpuntodeventa`
`source_system`	`snapshot:SOURCE-003-SNAPSHOT-001`
`source_object`	`SOURCE-003 / Tabla 2 V2`
`source_query_version`	`SOURCE-003-VENTAS-VNEXT-TABLA2-AUTHORITY-V2`
`sync_batch_id`	`1827f887-9499-4579-b4f3-234d54f41f7f`
`extracted_at`	`2026-06-10T21:04:06-03:00`
`last_seen_at`	`2026-06-10T21:04:06-03:00`
`created_at`	`2026-06-10T21:04:06-03:00`
`updated_at`	`2026-06-10T21:04:06-03:00`
`record_status`	`active`

Nota operativa: una futura ejecucion del candidate debe pasar el mismo SOURCE_003_SYNC_BATCH_ID registrado arriba. No se ejecuto la carga en esta tarea.

6. Reglas de preparacion¶

Header destino tomado del \copy del candidate 004_source_003_dedicated_db_pilot_load_candidate.sql.
Las 68 columnas reales se mapearon segun SOURCE-003-SALES-ITEMS-COLUMN-MAPPING.md.
line_sequence_v1 se genero por particion documental y orden canonico vigente.
line_key contiene line_key_v4 como sha256 canonico.
source_row_hash contiene source_row_hash_v1 calculado sobre las 68 columnas reales del snapshot.
id se genero como UUID deterministico de pipeline a partir del contexto preparado y line_key.
descuento_item se preparo como consolidacion tecnica de total_desc_neto_linea + total_desc_neto_al_pie + total_desc_np.

7. Validaciones¶

Control	Resultado
archivo preparado existe	`PASS`
tamano mayor a cero	`PASS`
header con `83` columnas	`PASS`
header coincide con `\copy` candidate	`PASS`
filas de datos `1886`	`PASS`
fecha unica `2026-06-09`	`PASS`
`tenant_id` exacto	`PASS`
`source_system` exacto	`PASS`
`source_object` exacto	`PASS`
`source_query_version` exacto	`PASS`
`sync_batch_id` unico y no vacio	`PASS`
`record_status = active`	`PASS`
nulos criticos	`0`
`source_row_hash` vacios	`0`
`line_key` vacios	`0`
duplicados `(tenant_id, line_key)`	`0`
`line_key` distintos	`1886`
`Hora` formato `HHMMSS`	`1886`
importe total	`48087486.83`
`CMV` total	`37881269.3025`
clientes unicos	`173`
vendedores unicos	`25`
`SKU` unicos	`180`
comprobantes unicos	`428`
CSV ignorado por Git	`PASS`

8. Confirmaciones de alcance¶

Restriccion	Resultado
SQL ejecutado	`NO`
PostgreSQL tocado	`NO`
preflight DB ejecutado	`NO`
candidate load ejecutado	`NO`
post-checks DB ejecutados	`NO`
rollback ejecutado	`NO`
datos cargados	`0`
`gestion_de_negocios_core` tocada	`NO`
VPS tocado	`NO`
Docker tocado	`NO`
OpenClaw tocado	`NO`
NPM tocado	`NO`
push/deploy	`NO`

9. Decision¶

text CSV PREPARADO GENERADO / VALIDADO / FUERA DE GIT

La carga piloto minima sigue sin ejecutarse. El artefacto preparado queda disponible localmente para una futura tarea autorizada que repita SAFE POINT, verifique el raw snapshot, valide el CSV preparado y recien entonces decida si corresponde ejecutar el preflight DB.

10. Proximo paso recomendado¶

Repetir SAFE POINT y ejecutar solamente el preflight autorizado de artefacto y DB en una tarea separada de carga piloto minima dedicada, usando el sync_batch_id documentado en este artefacto preparado. Mantener bloqueadas sync diaria, carga masiva, produccion final, VPS, Docker, OpenClaw, NPM, push y deploy.