SOURCE-003 Core DDL Local Dev Preflight 001¶

Fecha local: 2026-06-15 11:57:35 -03:00

Estado: PREFLIGHT PASS / DDL CORE FORWARD NO EJECUTADO

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-CORE-DDL-LOCAL-DEV-PREFLIGHT-001.md

1. Objetivo¶

Ejecutar solamente el preflight DDL CORE candidato de SOURCE-003 contra PostgreSQL local-dev para validar condiciones previas de catalogo y RAW antes de cualquier ejecucion futura y separada del forward.

Destino autorizado:

text database: openclaw_business_observer_dev schema: business_observer

Esta tarea no ejecuto forward, rollback, post-checks, CREATE TABLE, INSERT, UPDATE, DELETE, COPY, carga de datos, sync, runner, VPS, Docker, OpenClaw, NPM, Portainer, push ni deploy.

2. Safe point¶

Control	Resultado
rama	`main`
`git status --short`	sin salida
`git rev-parse HEAD`	`8df6bdcbe824f2c62a3796427bd358fad54365b2`
`git rev-parse origin/main`	`8df6bdcbe824f2c62a3796427bd358fad54365b2`
ultimo commit observado	`8df6bdc docs: review source 003 core ddl candidate`
decision	`SAFE POINT PASS`

3. SQL autorizado ejecutado¶

Se ejecuto unicamente:

text docs/tenants/alpuntodeventa/business-observer/design/sql/005_source_003_core_ddl_candidate_preflight.sql

Comando operativo sin secretos:

powershell C:\Program Files\PostgreSQL\15\bin\psql.exe -X -v ON_ERROR_STOP=1 -d openclaw_business_observer_dev -f docs/tenants/alpuntodeventa/business-observer/design/sql/005_source_003_core_ddl_candidate_preflight.sql

Notas de ejecucion:

Control	Resultado
binario `psql`	`C:\Program Files\PostgreSQL\15\bin\psql.exe`
`ON_ERROR_STOP`	`SI`
DB indicada en comando	`openclaw_business_observer_dev`
credenciales	variables locales no versionadas; secretos no impresos
`postgres-sandbox`	`NO USADO`
forward ejecutado	`NO`
rollback ejecutado	`NO`
post-checks ejecutados	`NO`
DDL ejecutado	`NO`
DML ejecutado	`NO`
carga de datos	`NO`
runner	`NO`

4. Resultado del preflight¶

Check	Observado	Esperado	Resultado
`current_database`	`openclaw_business_observer_dev`	`openclaw_business_observer_dev`	`PASS`
`schema_business_observer_exists`	`true`	`true`	`PASS`
`schema_business_observer_owner`	`openclaw_bo_admin`	`openclaw_bo_admin`	`PASS`
`required_roles_exist`	`3`	`3`	`PASS`
`required_roles_nologin/openclaw_bo_admin`	`false`	`false`	`PASS`
`required_roles_nologin/openclaw_bo_reader`	`false`	`false`	`PASS`
`required_roles_nologin/openclaw_bo_writer`	`false`	`false`	`PASS`
`raw_source_table_exists`	`true`	`true`	`PASS`
`core_candidate_table_absent_before_forward`	`true`	`true`	`PASS`
`raw_authorized_batch_row_count`	`1886`	`1886`	`PASS`
`raw_authorized_batch_critical_fields`	`0`	`0`	`PASS`
`raw_authorized_batch_duplicates`	`0`	`0`	`PASS`
`public_schema_privileges_absent`	`0`	`0`	`PASS`
`preflight_read_only_no_raw_modification`	`SELECT-only checks; no INSERT/UPDATE/DELETE/COPY/DDL against RAW`	RAW not modified and CORE not created by preflight	`PASS`

Resultado general:

text PREFLIGHT PASS

5. Evidencia de alcance¶

Restriccion	Resultado
DB correcta	`PASS`
schema `business_observer` existe	`PASS`
roles requeridos existen	`PASS`
roles requeridos son `NOLOGIN`	`PASS`
RAW source table `business_observer.raw_source_003_sales_items` existe	`PASS`
batch piloto autorizado	`1886` filas
campos criticos del batch piloto	`0` filas malas
duplicados por `tenant_id, line_key` en batch piloto	`0`
CORE candidata `business_observer.core_source_003_sales_items` existe antes del forward	`NO`
tabla piloto tocada por DDL/DML	`NO`
`postgres-sandbox` usado	`NO`
secretos impresos	`NO`
cambios en PostgreSQL	`NO`

La afirmacion de que la tabla piloto y RAW no se tocaron se basa en el alcance del SQL ejecutado: el preflight contiene solamente consultas SELECT de catalogo y conteos sobre business_observer.raw_source_003_sales_items. No se ejecuto ningun SQL adicional contra la DB.

6. Bloqueos preservados¶

Siguen bloqueados:

ejecucion de 005_source_003_core_ddl_candidate_forward.sql
ejecucion de 005_source_003_core_ddl_candidate_rollback.sql
ejecucion de 005_source_003_core_ddl_candidate_post_checks.sql
creacion de business_observer.core_source_003_sales_items
ejecucion de promote-core
modificaciones del importer Python
sync diaria, carga masiva y produccion final
VPS, Docker, OpenClaw, NPM, Portainer
push y deploy

7. Validaciones del repo¶

Validacion	Resultado
`git diff --check`	`PASS`
`.venv-portal\Scripts\mkdocs.exe build --strict`	`PASS`

8. Decision¶

text PREFLIGHT PASS / DDL CORE FORWARD NO EJECUTADO

El entorno local-dev cumple las condiciones previas verificadas por el preflight CORE candidato. Esto no crea la tabla CORE, no promueve datos desde RAW y no autoriza promote-core. Cualquier forward futuro requiere una tarea separada con SAFE POINT nuevo, autorizacion explicita y alcance propio.