Saltar a contenido

PDF-008B - SOURCE-002 Products Full Use-Case Preflight

Fecha: 2026-06-20

Estado: PREFLIGHT DOCUMENTAL FULL USE-CASE / READ-ONLY / NO LOAD / SNAPSHOT PENDING_AUTHORIZATION

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Owner: Gabi / Carlos Canu

1. Contexto

PDF-008A dejo SOURCE-002 Productos como candidate WooCommerce-ready para una futura carga controlada en PostgreSQL produccion. Ese gate preparo autoridad, mapping y SQL candidate, pero su foco principal fue catalogo WooCommerce.

Este gate amplia el alcance antes de cualquier carga: SOURCE-002 no debe limitarse a WooCommerce. Debe cubrir catalogo, stock actual, snapshot diario, faltantes, activos/inactivos, precios, costos, margen, proveedor, logistica, integracion con ventas SOURCE-003, alertas comerciales y reposicion.

No se ejecuto carga, COPY, DML, SQL operativo, sync, scheduler, cron, pipeline ni llamada API WooCommerce.

2. Safe Point Inicial

Validacion Resultado
git status -sb ## main...origin/main
git rev-parse HEAD 3fdb51f8fb912edbb74f58d0d590d5463c858731
git rev-parse origin/main 3fdb51f8fb912edbb74f58d0d590d5463c858731
git log -1 --oneline 3fdb51f docs: prepare source-002 products woocommerce candidate
git diff --check PASS
..venv-portal\Scripts\mkdocs.exe build --strict PATH_NOT_FOUND desde C:\APV\openclawai
.\.venv-portal\Scripts\mkdocs.exe build --strict PASS

Metodo funcional usado para MkDocs:

  • C:\APV\openclawai\.venv-portal\Scripts\mkdocs.exe

3. Documentos Relevados

Documento Uso previsto Aplica a
docs/governance/PROJECT-CONSTITUTION.md Constitucion documental; evidencia antes de decision governance
CODEX.md Contrato operativo Codex; safe point y validaciones governance
docs/governance/ACTIVE-CONTEXT.md Router vigente; SOURCE-002 activo, carga y sync NO-GO governance
docs/governance/GOVERNANCE-CONTROL-TOWER.md Estado ejecutivo de plataforma y gates governance
docs/governance/VALIDATION-STATE.md Estado de validacion vigente governance
docs/governance/documentation/DOCUMENT-HIERARCHY.md Criterio portal_visible portal
docs/PROJECT-STATE.md Estado oficial PDF-008A y proximo gate PDF-008B estado
docs/ROADMAP.md Roadmap 17.5.98 y siguiente gate PDF-008B roadmap
docs/governance/operations/CURRENT-BASELINE.md Baseline operativo vigente baseline
production/PDF-008A-SOURCE-002-PRODUCTS-WOOCOMMERCE-READY-CANDIDATE.md Candidate WooCommerce-ready previo WooCommerce, catalogo
source-authority/SOURCE-002-PRODUCTOS-PRODUCTS-AUTHORITY.sql Autoridad SQL PRODUCTS; 81 campos catalogo, stock, costos, precios
sources/SOURCE-002-SGC-PRODUCTOS.md Fuente madre del maestro productos catalogo, stock, costos, proveedor
SOURCE-002-FUTURE-LAYER-MAPPING.md Separacion futura por ritmo de cambio stock, snapshot, economia, analisis
SOURCE-002-ECONOMIC-LAYER.md Semantica de costos, listas, IVA y margenes costos, precios, margen
blueprints/PRODUCT-BLUEPRINT.md Dominio funcional producto producto, ventas, IA/ML
sources/SOURCE-002B-WOOCOMMERCE-IMAGENES.md Fuente complementaria imagenes por SKU WooCommerce, catalogo visual
sources/SOURCE-002C-STOCK-DAILY-SNAPSHOT.md Necesidad futura de snapshot diario inventario, faltantes
sources/SOURCE-002D-STOCK-CURRENT-10MIN.md Necesidad futura de stock intradiario liviano stock actual, alertas
sources/SOURCE-002-QUERY-RECOVERY-REPORT.md Recuperacion de query y fuente dbo.PRODUCTS autoridad, gaps
infra/business-observer/production/postgres/products/PDF-008A/ SQL candidates previos raw -> core -> catalog DDL candidate

4. Usos Detectados

  1. Catalogo WooCommerce La Directa: cubierto como candidate por PDF-008A, usando SKU, Articulo, Marca, PrecioListaFinal, PrecioOfertaFinal, Stock, categoria raw y atributos logisticos.
  2. Actualizacion frecuente de stock actual: documentada como futura SOURCE-002D, liviana, cada 10 minutos como frecuencia inicial.
  3. Snapshot diario de inventario: documentado como futura SOURCE-002C, corte inicial recomendado 17:00 Argentina/Buenos Aires.
  4. Mercaderia faltante / quiebre de stock: requiere combinar stock actual, snapshot diario, ventas SOURCE-003 y futura capa de eventos.
  5. Productos activos/inactivos: la autoridad actual filtra Estado = 'ACTIVO', por lo que inactivos quedan como gap si no se habilita otra consulta.
  6. Precios/listas/descuentos/precio original: cubiertos por PrecioListaFinal, PrecioOfertaFinal, PrecioL1..L9, PrecioNetoL1..L9, IVAPrecioL1..L9, Descuento Permitido.
  7. Costos/margen/capa economica: cubiertos por CostoListaProveedor, Dcto Compra 1..3, Costo, Markup, MargenL1..L9.
  8. Pack/unidad minima/pallet/peso/volumen: cubiertos por CantVtaMin, CantVentaAgrupada, UnidadMedida, Unidades_x_Bulto, BasePallet, AlturaPallet, peso y volumen.
  9. Proveedor: cubierto por Cod Proveedor y Proveedor.
  10. Integracion futura con ventas SOURCE-003: cruce natural por tenant_id + sku; ventas aporta demanda real, cantidades, importes y CMV.
  11. Alertas comerciales y reposicion: dependen de SOURCE-002C, SOURCE-002D, ventas, rotacion y reglas de negocio.
  12. Relacion con SOURCE-002B/002C/002D: 002B imagenes, 002C historia diaria, 002D stock vivo.
  13. Relacion con PRODUCT-BLUEPRINT: tenant_id + sku es la identidad canonica del dominio producto.
  14. Relacion con WooCommerce API futura: solo mapping candidate; no se llamo la API.

5. Preflight Read-Only SOURCE-002

Estado: BLOCKED_SAFE_CREDENTIALS_NOT_AVAILABLE

Se valido el mecanismo seguro disponible en esta sesion:

  • no hay variables de entorno APV_SOURCE_002_MSSQL_* cargadas por nombre;
  • no se leyo .env;
  • no se leyeron secret files;
  • no se imprimieron passwords;
  • no se imprimieron connection strings;
  • no se ejecuto consulta real a SGC;
  • no se llamo WooCommerce.

Resultado de conteos reales solicitados:

Check Estado
fuente real DOCUMENTED: [ecommerce].[dbo].[PRODUCTS]; no revalidada en runtime
columnas reales DOCUMENTED: 81 por autoridad; no revalidado en runtime
cantidad de filas BLOCKED
productos activos BLOCKED; autoridad filtra activos
productos inactivos GAP; autoridad actual no los devuelve
productos con stock / sin stock BLOCKED
productos con precio / sin precio BLOCKED
productos con costo / sin costo BLOCKED
productos con proveedor / sin proveedor BLOCKED
campos WooCommerce DOCUMENTED
campos inventario/faltantes DOCUMENTED
campos capa economica DOCUMENTED

6. Snapshot Candidate

Estado: PENDING_AUTHORIZATION

No se genero snapshot porque no hay mecanismo seguro disponible sin leer secret files y no hay autorizacion explicita para usar credenciales locales.

Reglas que debe cumplir el gate futuro:

  • generar el archivo fuera de Git o en ruta ignorada;
  • registrar SHA256, tamanio, filas y columnas;
  • validar columnas contra SOURCE-002-PRODUCTOS-PRODUCTS-AUTHORITY.sql;
  • no versionar CSV;
  • no ejecutar carga a PostgreSQL;
  • no tocar WooCommerce.

7. Matriz De Usos SOURCE-002

Uso Campos disponibles Campos faltantes / reglas pendientes Capa recomendada
WooCommerce catalog SKU, Articulo, Marca, Stock, PrecioListaFinal, PrecioOfertaFinal, Category, SubCategoria, peso, volumen, pack wc_product_id, imagen principal validada, taxonomia final, moneda, regla final regular_price/sale_price, estado publish/draft catalog_source_002_products
Stock actual Stock, Stock en Bultos, Unidades_x_Bulto deposito, definicion vendible/teorico, frecuencia final inventory_source_002_current
Snapshot diario stock, bultos, contexto de SKU, marca, proveedor, categoria horario final, retencion, campos economicos de cierre inventory_source_002_daily_snapshot
Faltantes/quiebres stock cero, recuperacion por comparacion futura, ventas SOURCE-003 regla de quiebre, demanda no atendida, umbrales por rotacion mart_source_002_stock_alerts
Capa economica costo lista, descuentos compra, costo, markup, IVA, listas L1-L9, precio oferta vigencia, moneda, historico por cambio economic_source_002_products y price lists
Integracion ventas tenant_id + sku, marca, proveedor, categoria, costo/precio normalizacion SKU, productos vendidos ausentes del maestro, inactivos cruce core_source_003_sales_items + core_source_002_products

8. Gaps Detectados

  • La autoridad actual filtra Estado = 'ACTIVO'; no permite contar inactivos sin una autoridad complementaria.
  • Stock necesita definicion funcional: teorico, disponible o vendible.
  • No hay deposito ni ubicacion en la autoridad actual.
  • SOURCE-002B aporta imagenes por SKU, pero el cruce WooCommerce no fue revalidado en esta tarea.
  • Las categorias Category/SubCategoria no son taxonomia WooCommerce final.
  • regular_price, sale_price, moneda y estado WooCommerce siguen como decision de negocio pendiente.
  • No hay snapshot SOURCE-002 autorizado con filas/hash/columnas.
  • No hay conteos reales de productos, stock, precio, costo o proveedor en esta sesion.
  • La lista de exclusiones SKU NOT IN (...) debe externalizarse antes de cualquier sync.
  • La historia fina de precio/costo requiere diseno de vigencia.

9. Diseno Recomendado Por Fases

Fase Ahora - imprescindible para WooCommerce candidate

  • raw_source_002_products: preservar salida autoridad y metadata.
  • core_source_002_products: producto vigente por tenant_id + sku.
  • core_source_002_product_price_lists: listas L1..Ln normalizadas.
  • catalog_source_002_products: catalogo candidate para WooCommerce.

Fase Inventario / faltantes

  • inventory_source_002_current: ultima observacion liviana de stock.
  • inventory_source_002_daily_snapshot: foto diaria por tenant_id + sku + snapshot_date.
  • mart_source_002_stock_alerts: reglas de quiebre, recuperacion, reposicion y prioridad comercial.

Fase Economica avanzada

  • economic_source_002_products: costo/precio vigente y contexto economico.
  • economic_source_002_price_history: historico por cambio o vigencia.
  • economic_source_002_cost_history: historico de costo y descuentos.

10. GO / NO-GO

GO:

  • usar PDF-008B como relevamiento completo de usos de producto;
  • mantener SOURCE-002 como autoridad madre;
  • separar WooCommerce, stock actual, snapshot diario, alertas y economia;
  • abrir gate posterior para preflight real con credenciales seguras.

NO-GO:

  • carga real;
  • COPY;
  • INSERT/UPDATE/DELETE/TRUNCATE;
  • modificar PostgreSQL produccion o staging;
  • tocar sandbox;
  • llamar WooCommerce API;
  • modificar La Directa;
  • ejecutar sync, scheduler, cron o pipelines.

11. Proximo Gate Recomendado

PDF-008C SOURCE-002 products read-only runtime preflight + snapshot evidence

Requisitos:

  • autorizacion explicita para usar credenciales seguras sin imprimirlas;
  • variables o mecanismo seguro ya cargado en entorno;
  • solo SELECT read-only;
  • conteos reales y metadata;
  • snapshot fuera de Git con SHA256;
  • validacion de columnas contra autoridad;
  • cero carga y cero WooCommerce API.

12. Confirmacion De Alcance

Durante este gate:

  • no se ejecuto carga;
  • no se ejecuto SQL operativo contra SGC ni PostgreSQL;
  • no se ejecuto COPY;
  • no se ejecuto DML;
  • no se ejecuto sync, scheduler, cron ni pipelines;
  • no se llamo WooCommerce API;
  • no se modifico PostgreSQL produccion;
  • no se modifico PostgreSQL staging;
  • no se toco sandbox;
  • no se modifico La Directa;
  • no se leyeron secret files;
  • no se imprimieron passwords ni connection strings reales;
  • no se agregaron dumps, backups, snapshots ni CSV al repo.

13. Estado Final

Estado final: AMARILLO

Motivo:

  • VERDE para relevamiento documental full use-case y diseno por fases.
  • AMARILLO/BLOCKED para preflight real y snapshot por falta de mecanismo seguro disponible en la sesion sin leer secretos.