Saltar a contenido

SOURCE-003 Importer Generate Prepared 001

Fecha local: 2026-06-15

Estado: GENERATE-PREPARED IMPLEMENTADO / NO DB

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-IMPORTER-GENERATE-PREPARED-001.md

1. Objetivo

Implementar el comando seguro:

text python scripts/source_003_importer.py generate-prepared

El comando orquesta el generador local existente scripts/source_003_prepare_csv.py para producir un CSV prepared nuevo en una ruta ignorada por Git, sin tocar PostgreSQL, sin ejecutar SQL, sin llamar al runner y sin reemplazar el CSV prepared historico validado.

2. Output generado

Ruta generada:

text snapshots/source-003/prepared/generated/SOURCE-003-PILOT-LOAD-DEDICATED-DB-2026-06-09.generated.csv

La ruta queda fuera de Git por .gitignore:

  • git_ignored=true
  • git_tracked=false
  • outside_git=true

3. Validaciones del comando

El comando valida:

  • raw snapshot existente: snapshots/source-003/SOURCE-003-TABLA2-V2-2026-06-09_20260610-210406-0300.csv
  • raw sha256: 07092c284b5b636b8a31cd616ef5b4fa5d0ce499b81c767437842b1f7edfcbc3
  • filas generated: 1886
  • columnas generated: 83
  • fecha unica: 2026-06-09
  • batch: 1827f887-9499-4579-b4f3-234d54f41f7f
  • record_status = active
  • source_row_hash no vacio
  • line_key no vacio
  • output generado fuera de Git

4. Comparacion contra prepared validado

CSV prepared validado de referencia:

text snapshots/source-003/prepared/SOURCE-003-PILOT-LOAD-DEDICATED-DB-2026-06-09.csv

Resultado:

text REPRODUCIBLE ESTRUCTURAL ACEPTADO

Evidencia:

  • columnas coincidentes: 82/83
  • columna diferente esperada: id
  • razon aceptada: UUID v5 deterministico del generador
  • filas comparadas: 1886
  • CSV historico validado reemplazado: false

5. Salida validada

Salida relevante del comando:

json { "command": "generate-prepared", "result": "PASS", "output_path": "snapshots/source-003/prepared/generated/SOURCE-003-PILOT-LOAD-DEDICATED-DB-2026-06-09.generated.csv", "rows": 1886, "columns": 83, "sha256_generated": "6fb44d9870a567e728df9bbdcc6b83279d84791bd732626c9e19ccf3a28dc903", "comparison_status": "REPRODUCIBLE ESTRUCTURAL ACEPTADO", "db_touched": false, "sql_executed": false, "data_written": false, "sync_enabled": false }

6. Restricciones preservadas

Esta etapa preserva:

  • sin PostgreSQL;
  • sin SQL;
  • sin psql;
  • sin runner;
  • sin carga de datos;
  • sin reemplazar el CSV prepared validado;
  • sin commitear CSV ni snapshots;
  • sin sync diaria;
  • sin carga masiva;
  • sin produccion final;
  • sin OpenClaw;
  • sin NPM;
  • sin VPS;
  • sin Docker;
  • sin push;
  • sin deploy.

7. Decision

text GENERATE-PREPARED IMPLEMENTADO / NO DB

generate-prepared queda habilitado como comando seguro del importer SOURCE-003: genera un prepared CSV reproducible estructuralmente en ruta ignorada por Git, compara contra el CSV historico validado y mantiene bloqueadas todas las operaciones de DB, SQL, runner, carga y sync.