SOURCE-003 Data Layers Milestone¶

Fecha local: 2026-06-15

Estado: DOCUMENTADO / PUBLICADO / NO IMPLEMENTADO EN DB

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

Fuente de verdad: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-DATA-LAYERS-MILESTONE.md

1. Hito¶

SOURCE-003 Data Layers queda publicado documentalmente.

Este hito registra que las capas RAW, CORE y MART para SOURCE-003 / SGC Ventas / Tabla 2 V2 estan disenadas y publicadas como contratos documentales.

No estan implementadas en base de datos.

2. HEAD publicado¶

HEAD publicado de referencia:

text 8d08ec8f34dd5347833ff7e1cd632a88c0a04cb0

Ultimo commit publicado de referencia:

text docs: define source 003 mart layer contract

3. Contratos incluidos¶

Contratos incluidos en el hito:

RAW: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-RAW-LAYER-CONTRACT.md
CORE: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-CORE-LAYER-CONTRACT.md
MART: docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-MART-LAYER-CONTRACT.md

Estado consolidado:

text DOCUMENTADO / PUBLICADO / NO IMPLEMENTADO EN DB

4. Alcance logrado¶

El hito deja publicado el diseno documental de:

separacion raw / prepared CSV / core / mart;
trazabilidad por sync_batch_id, line_key y source_row_hash;
validaciones e idempotencia por capa;
rollback logico o rebuild por batch, segun corresponda a cada capa;
relacion futura con dashboards, reportes y consultas LLM;
frontera entre contratos documentales y futura implementacion controlada.

5. Estado de implementacion¶

Este hito no declara implementacion fisica nueva.

Estado por capa:

Capa	Estado documental	Estado DB
`RAW`	Publicado	No implementado en DB
`CORE`	Publicado	No implementado en DB
`MART`	Publicado	No implementado en DB

No se crean tablas raw, core ni mart.

No se crea DDL, migracion, vista fisica ni materializacion para estas capas.

6. Bloqueos preservados¶

Siguen bloqueados:

sync diaria;
carga masiva;
produccion final;
OpenClaw executor;
uso de postgres-sandbox como produccion;
ejecucion contra PostgreSQL sin gate separado;
cualquier load, promote-core, build-mart, status o rollback-batch que toque DB sin autorizacion explicita.

7. Lo que este hito no hace¶

Este documento no:

toca PostgreSQL;
ejecuta SQL;
crea DDL;
crea tablas;
ejecuta runner;
genera CSV;
carga datos;
toca VPS, Docker, OpenClaw, NPM ni Portainer;
hace push;
hace deploy.

8. Proximo paso recomendado¶

Disenar un plan controlado para load-raw del importer de SOURCE-003.

Ese plan debe seguir siendo documental o de gate previo hasta que exista una autorizacion explicita para ejecutar contra DB.

El plan recomendado debe definir, antes de cualquier ejecucion:

objetivo exacto de load-raw;
DB destino autorizada;
tabla o estructura esperada;
batch permitido;
fingerprint esperado;
preflight read-only;
rollback por batch;
evidencia a registrar;
criterios de corte;
validaciones git diff --check y mkdocs build --strict;
confirmacion explicita de que no se usa postgres-sandbox como produccion.

9. Decision de cierre¶

Decision:

text SOURCE-003 DATA LAYERS PUBLICADO / DOCUMENTADO / NO IMPLEMENTADO EN DB

Este hito cierra la publicacion documental de los contratos RAW, CORE y MART y deja preparado el proximo frente de diseno controlado para load-raw, todavia sin ejecucion contra DB.