Saltar a contenido

SOURCE-003 Load Raw Local Dev Post Execution Review

Fecha: 2026-06-15

Estado: RAW LOCAL-DEV POST-EXECUTION REVIEW PASS

Alcance

Revision tecnica post-ejecucion de la carga RAW local-dev ya ejecutada para:

  • DB: openclaw_business_observer_dev
  • Tabla: business_observer.raw_source_003_sales_items
  • Batch: 1827f887-9499-4579-b4f3-234d54f41f7f
  • Filas esperadas: 1886

No se escribieron datos nuevos. No se ejecuto carga nueva efectiva. No se genero CSV. No se modifico Python. No se toco CORE/MART. No se uso VPS, Docker, OpenClaw, NPM, Portainer, produccion, sync diaria ni postgres-sandbox.

La query autoridad permanece fuera de alcance y no fue modificada:

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

Safe Point

Control Resultado
workspace C:\APV\openclawai
rama main
git status --short --branch inicial ## main...origin/main
git rev-parse HEAD inicial c8c475404ab1b3015322a39f82d7de1a955fa2c3
ultimo commit inicial c8c4754 tools: record source 003 load raw local dev execution
query autoridad SHA256 F23B671E2AC6C20E0A62734124A279573A8153BC187082B2F5E1C75A078ABF71
decision SAFE POINT PASS

Evidencia SELECT Read-Only

Consulta independiente ejecutada mediante psql read-only desde el entorno local autorizado:

json { "database": "openclaw_business_observer_dev", "fingerprint": "::1/128:5432|openclaw_business_observer_dev|postgres|PostgreSQL 15.15, compiled by Visual C++ build 1944, 64-bit", "raw_total_rows": 1886, "batch_rows": 1886, "duplicates": 0, "empty_source_row_hash_rows": 0, "empty_line_key_rows": 0, "null_loaded_at_rows": 0, "column_count": 84, "sync_enabled": false, "production": false }

Checks

Check Esperado Observado Resultado
RAW total rows 1886 1886 PASS
batch rows 1886 1886 PASS
duplicates tenant_id + line_key 0 0 PASS
source_row_hash vacio 0 0 PASS
line_key vacio 0 0 PASS
loaded_at nulo 0 0 PASS
columnas RAW 84 84 PASS
sync_enabled false false PASS
production false false PASS
postgres-sandbox no usado no observado PASS
query autoridad sin modificar sin diff, SHA256 estable PASS

Batch Duplicado

Se reejecuto el comando load-raw --execute con confirmaciones completas solo para verificar el guard de idempotencia. El comando quedo bloqueado antes de COPY/INSERT por batch ya existente.

Resultado:

  • result: BLOCKED
  • motivo: batch duplicado bloqueado: 1827f887-9499-4579-b4f3-234d54f41f7f ya tiene 1886 filas
  • db_write: false
  • sql_write: false
  • data_written: false
  • sync_enabled: false
  • rollback_executed: true
  • csv_generated: false

SELECT posterior al bloqueo duplicado:

json { "raw_total_rows": 1886, "batch_rows": 1886, "duplicates": 0 }

El bloqueo duplicado sigue activo y no altero el estado RAW.

Validaciones Ejecutadas

Validacion Resultado
python -m py_compile scripts/source_003_importer.py PASS
python scripts/source_003_importer.py validate-prepared PASS
python scripts/source_003_importer.py load-raw FAIL esperado post-carga: row_count RAW 1886 != 0; sin escritura
python scripts/source_003_importer.py load-raw --execute BLOCKED esperado sin confirmaciones; sin DB touch
python scripts/source_003_importer.py load-raw --execute ...confirmaciones completas... BLOCKED esperado por batch duplicado; sin data written
git diff --check PASS
.venv-portal\Scripts\mkdocs.exe build --strict PASS

Hallazgos

  • La carga RAW local-dev ya ejecutada conserva exactamente 1886 filas.
  • El batch autorizado contiene exactamente 1886 filas.
  • No hay duplicados por tenant_id + line_key dentro del batch.
  • No hay source_row_hash vacios, line_key vacios ni loaded_at nulos.
  • La ruta de idempotencia bloquea el batch duplicado antes de insertar datos.
  • El entorno observado es openclaw_business_observer_dev, no produccion.
  • sync_enabled=false; no hay habilitacion de sync diaria.
  • No se observo ni uso postgres-sandbox.
  • La query autoridad existe y permanece sin modificaciones.

Conclusion

text RAW LOCAL-DEV POST-EXECUTION REVIEW PASS APTO PARA DISEÑAR PROMOTE-CORE NO APTO PARA PRODUCCION NO APTO PARA SYNC DIARIA