SOURCE-003 Mart DDL Local Dev Post-Forward Review¶

Fecha local: 2026-06-17 00:00:00 -03:00

Estado: MART LOCAL-DEV POST-FORWARD REVIEW PASS

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-MART-DDL-LOCAL-DEV-POST-FORWARD-REVIEW.md

1. Objetivo¶

Consolidar documentalmente la evidencia posterior al forward local-dev del paquete DDL MART candidato de SOURCE-003, sin ejecutar SQL, sin usar psql, sin tocar PostgreSQL y sin modificar datos ni codigo.

Esta review se apoya unicamente en evidencia ya publicada:

SOURCE-003-MART-DDL-LOCAL-DEV-FORWARD-001.md
SOURCE-003-MART-LOCAL-DEV-RUNTIME-READONLY-AUDIT-001.md
SOURCE-003-MART-DDL-CANDIDATE-TECHNICAL-REVIEW.md
SOURCE-003-IMPORTER-BUILD-MART-PLAN.md
SOURCE-003-MART-LAYER-CONTRACT.md

2. Safe point¶

Control	Resultado
rama esperada	`main limpio`
`HEAD/origin` informado	`592b56db8985a23dfaca775424efdc118579c3ac`
ultimo commit informado	`docs: record source 003 mart local dev readonly audit`
SQL ejecutado en esta review	`NO`
`psql` usado en esta review	`NO`
PostgreSQL tocado en esta review	`NO`
Python modificado	`NO`
decision	`SAFE POINT PASS`

3. Evidencia consolidada¶

3.1 Forward local-dev¶

La evidencia previa confirma que el forward local-dev del paquete DDL MART fue ejecutado correctamente y quedo cerrado con:

text PREFLIGHT PASS FORWARD OK POST-CHECKS PASS

Referencia: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-MART-DDL-LOCAL-DEV-FORWARD-001.md

3.2 Runtime read-only posterior¶

La auditoria runtime posterior, ejecutada en modo SELECT solamente, confirma que el estado observado despues del forward sigue consistente.

Referencia: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-MART-LOCAL-DEV-RUNTIME-READONLY-AUDIT-001.md

4. Estado de tablas y conteos¶

Objeto	Estado observado	Resultado
`business_observer.raw_source_003_sales_items`	`1886` filas	`PASS`
`business_observer.core_source_003_sales_items`	`1886` filas	`PASS`
`business_observer.source_003_sales_items`	existe separada y clasificada `PILOTO`	`PASS`
`business_observer.mart_source_003_sales_daily`	existe con `0` filas	`PASS`
`business_observer.mart_source_003_sales_by_seller`	existe con `0` filas	`PASS`
`business_observer.mart_source_003_sales_by_customer`	existe con `0` filas	`PASS`
`business_observer.mart_source_003_sales_by_sku`	existe con `0` filas	`PASS`

Lectura consolidada:

RAW final oficial preservada en 1886
CORE oficial preservada en 1886
tabla business_observer.source_003_sales_items distinguida correctamente como PILOTO
las cuatro tablas MART existen y permanecen vacias

5. Controles ya validados por evidencia previa¶

Los siguientes controles no se reejecutan en esta review porque ya quedaron validados por la evidencia tecnica previa del forward:

owner openclaw_bo_admin
grants de writer y reader
ausencia de privilegios PUBLIC
constraints requeridas 43/43
indexes requeridos 12/12

Conclusion documental:

text owner / grants / constraints / indexes ya validados en evidencia previa

6. Alcance preservado¶

No hay evidencia de carga MART ni de ejecucion operativa posterior. Queda preservado:

Restriccion	Resultado
carga MART ejecutada	`NO`
`build-mart` ejecutado	`NO`
runner ejecutado	`NO`
CSV generado	`NO`
produccion habilitada	`NO`
sync diaria habilitada	`NO`
cambios sobre RAW final	`NO`
cambios sobre CORE	`NO`
cambios sobre tabla piloto por esta review	`NO`

7. Riesgos vigentes¶

Siguen vigentes y sin resolver en esta etapa:

territory_key no implica vendedor responsable
CMV, costos y contribution_amount mantienen advertencia semantica
dashboards productivos siguen bloqueados
consultas LLM productivas siguen bloqueadas

Consecuencia:

las MART vacias no habilitan consumo ejecutivo ni productivo
cualquier build-mart futuro debe preservar reconciliacion, trazabilidad, warnings semanticos y gates separados

8. Lectura operativa¶

La evidencia consolidada permite afirmar:

el forward MART local-dev quedo ejecutado correctamente
la estructura MART candidata existe en local-dev
el estado posterior sigue vacio y estable
RAW final y CORE permanecen preservadas en 1886
la tabla piloto no debe confundirse con RAW final ni con MART

Tambien permite afirmar que todavia no existe evidencia de:

carga MART real
build-mart implementado o ejecutado
habilitacion de produccion
habilitacion de sync diaria

9. Conclusion¶

text MART LOCAL-DEV POST-FORWARD REVIEW PASS APTO PARA IMPLEMENTAR BUILD-MART SAFE MODE NO APTO PARA PRODUCCION NO APTO PARA SYNC DIARIA

El estado documental consolidado confirma que el DDL MART local-dev quedo aplicado correctamente, con las cuatro MART candidatas presentes y vacias, RAW final y CORE preservadas en 1886, y la tabla piloto correctamente distinguida.

La siguiente etapa posible queda limitada a implementar o gatear build-mart en safe mode, en una tarea separada, sin habilitar produccion, sync diaria, dashboards productivos ni consumo LLM operativo.