Saltar a contenido

SOURCE-003 Build Mart Local Dev Closure 001

Fecha local: 2026-06-19

Estado: CERRADA / LOCAL-DEV COMPLETO / SIN ESCRITURAS NUEVAS

Scope: tenant

tenant_id: alpuntodeventa

batch autorizado: 1827f887-9499-4579-b4f3-234d54f41f7f

1. Objetivo

Cerrar formalmente el hito SOURCE-003 MART local-dev usando solo validacion de repo y controles read-only, sin ejecutar nuevas escrituras sobre openclaw_business_observer_dev.

Restricciones preservadas:

  • sin INSERT, COPY, UPDATE, DELETE
  • sin build-mart --execute
  • sin rollback SQL
  • sin tocar produccion
  • sin sync diaria, runner ni scheduler
  • sin tocar La Directa, runtime O4, VPS, Docker, NPM, Portainer
  • sin push ni deploy

2. Safe point

Control Valor
workspace C:\APV\openclawai
rama main
git status -sb inicial ## main...origin/main
git rev-parse HEAD inicial 36b23814021a02f3a5f3aa06aacf654ca45104c5
ultimo commit observado docs: add source 003 mart rollback candidate
decision SAFE POINT PASS

3. Evidencia publicada consolidada

Hito Documento Estado
first persistence docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-BUILD-MART-FIRST-PERSISTENCE-001.md PUBLICADO
post-write review docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-BUILD-MART-POST-WRITE-REVIEW-001.md PUBLICADO
idempotency execution docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-BUILD-MART-IDEMPOTENCY-EXECUTION-001.md PUBLICADO
rollback candidate docs/tenants/alpuntodeventa/business-observer/design/SOURCE-003-BUILD-MART-ROLLBACK-CANDIDATE-001.md PUBLICADO / NOT EXECUTED
rollback SQL docs/tenants/alpuntodeventa/business-observer/design/sql/008_source_003_build_mart_rollback_candidate.sql VERSIONADO / NOT EXECUTED

4. Validacion read-only actual

Fingerprint aprobado observado:

text ::1/128:5432|openclaw_business_observer_dev|postgres|PostgreSQL 15.15, compiled by Visual C++ build 1944, 64-bit

Controles confirmados:

  • DB actual: openclaw_business_observer_dev
  • postgres-sandbox: ausente
  • RAW total = 1886
  • RAW batch autorizado = 1886
  • CORE total = 1886
  • CORE batch autorizado = 1886
  • MART daily/seller/customer/sku = 1/25/173/180
  • batch autorizado presente en las cuatro MART: 1/25/173/180
  • filas fuera del batch autorizado: 0/0/0/0
  • duplicados por grain: 0/0/0/0

5. Rowcounts finales

Capa Tabla Valor final
RAW business_observer.raw_source_003_sales_items 1886
CORE business_observer.core_source_003_sales_items 1886
MART business_observer.mart_source_003_sales_daily 1
MART business_observer.mart_source_003_sales_by_seller 25
MART business_observer.mart_source_003_sales_by_customer 173
MART business_observer.mart_source_003_sales_by_sku 180

6. Limites vigentes

El cierre formal de local-dev no habilita:

  • produccion
  • sync diaria
  • scheduler
  • runner automatico
  • rollback automatico o manual dentro de esta tarea

Estado consolidado:

  • rollback candidate disponible pero no ejecutado
  • build-mart --execute no ejecutado en esta tarea
  • produccion y sync diaria siguen BLOCKED

7. Riesgos pendientes para produccion

  • falta Production Data Foundation
  • falta staging o validacion controlada en VPS
  • falta contrato operativo de sync diaria y scheduler
  • falta cierre formal de observabilidad, drift y rollback para entorno no local
  • el rollback actual esta definido solo para local-dev

8. Proximo paso recomendado

Abrir la siguiente linea de trabajo como tarea separada:

text Production Data Foundation / staging VPS

Objetivo recomendado:

  • preparar base de datos y gates de entorno no local
  • definir operacion segura previa a produccion
  • mantener SOURCE-003 sin sync diaria hasta cerrar staging, observabilidad e idempotencia operativa

9. Conclusion

text SOURCE-003 MART LOCAL-DEV CLOSURE PASS SAFE POINT = 36b23814021a02f3a5f3aa06aacf654ca45104c5 RAW = 1886 CORE = 1886 MART = 1 / 25 / 173 / 180 FIRST PERSISTENCE PUBLISHED POST-WRITE REVIEW PUBLISHED IDEMPOTENCY EXECUTION PUBLISHED ROLLBACK CANDIDATE PUBLISHED / NOT EXECUTED NO DB WRITES IN THIS CLOSURE PRODUCTION AND DAILY SYNC REMAIN BLOCKED NEXT STEP = PRODUCTION DATA FOUNDATION / STAGING VPS