Saltar a contenido

PDF-009K - WooCommerce Marca Terms Controlled Write

Fecha: 2026-06-22

Estado: WRITE CONTROLADO / TERMINOS MARCA CREADOS / SIN PRODUCTOS

portal_visible = yes

Scope: tenant

tenant_id: alpuntodeventa

Destino funcional: La Directa WooCommerce

Owner: Gabi / Carlos Canu

A. SAFE POINT inicial

Control Resultado
git status -sb ## main...origin/main
git rev-parse HEAD f67bd60374663e058384e19eb85f7432f97dfcaa
git rev-parse origin/main f67bd60374663e058384e19eb85f7432f97dfcaa
git log -3 --oneline f67bd60 docs: add pdf-009j marca attribute controlled write; aaf5c43 docs: add pdf-009i marca media library discovery; 9aa230a docs: add pdf-009h frontend images performance contract
git diff --check inicial PASS

Safe point esperado confirmado: HEAD local y origin/main iniciaron alineados en f67bd60374663e058384e19eb85f7432f97dfcaa, con repo limpio.

B. Variables WooCommerce

.env existe localmente y esta ignorado por Git mediante .gitignore.

No se imprimio contenido de .env ni valores de secretos.

Variable Estado
LADIRECTA_WC_BASE_URL PRESENT
LADIRECTA_WC_CONSUMER_KEY PRESENT
LADIRECTA_WC_CONSUMER_SECRET PRESENT

C. GET atributo Marca antes del write

Control Resultado
Endpoint products/attributes?per_page=100
HTTP 200
Atributos globales existentes 1
Coincidencias Marca o pa_marca 1
attribute_id 1
name Marca
slug pa_marca
type select
order_by name
has_archives true

D. Terminos existentes antes del write

Control Resultado
Endpoint products/attributes/1/terms?per_page=100&page=1&hide_empty=false
HTTP 200
Terminos existentes 0

E. Marcas SOURCE-002 detectadas

Fuente local segura:

  • snapshots/source-002/SOURCE-002-PRODUCTS-RUNTIME-PREFLIGHT-20260620-173614.csv
  • SHA256 observado: c961ffc2b352b6bb3dd0d59bf3d8b7c0f7facff58a9201f7cf45e290141b704f

Inventario:

Metrica Resultado
filas SOURCE-002 snapshot 314
columnas snapshot 81
columna de marca Marca
marcas unicas detectadas 49
marcas candidatas a crear 48
marcas bloqueadas 1

Normalizacion aplicada: trim, colapso de espacios internos, preservacion del nombre comercial visible y slug ASCII en minusculas con guiones. No se ejecuto SQL, no se consulto PostgreSQL y no se toco SOURCE-002 productivo.

F. Matriz CREATE_TERM / SKIP / BLOCKED

Marca fuente Productos Termino Woo esperado Slug esperado Existe en Woo Accion Motivo
100 DUCADOS 5 100 DUCADOS 100-ducados NO CREATE_TERM OK
ALWA 4 ALWA alwa NO CREATE_TERM OK
ARROCITAS 2 ARROCITAS arrocitas NO CREATE_TERM OK
BALDO 2 BALDO baldo NO CREATE_TERM OK
CACHAFAZ 12 CACHAFAZ cachafaz NO CREATE_TERM OK
CAFE 5 HISPANOS 11 CAFE 5 HISPANOS cafe-5-hispanos NO CREATE_TERM OK
CANARIAS 4 CANARIAS canarias NO CREATE_TERM OK
CANDELA 10 CANDELA candela NO CREATE_TERM OK
CASTILLO DULCE 3 CASTILLO DULCE castillo-dulce NO CREATE_TERM OK
CELOSAS 2 CELOSAS celosas NO CREATE_TERM OK
DEC 6 DEC dec NO CREATE_TERM OK
DON SATUR 1 DON SATUR don-satur NO CREATE_TERM OK
DOS HERMANOS ARROZ 8 DOS HERMANOS ARROZ dos-hermanos-arroz NO CREATE_TERM OK
DOS HERMANOS GALLETAS 1 DOS HERMANOS GALLETAS dos-hermanos-galletas NO CREATE_TERM OK
DOS HERMANOS SNACKS 8 DOS HERMANOS SNACKS dos-hermanos-snacks NO CREATE_TERM OK
DOS HERMANOS TOSTADITAS 2 DOS HERMANOS TOSTADITAS dos-hermanos-tostaditas NO CREATE_TERM OK
GLINS 2 GLINS glins NO CREATE_TERM OK
GOOD SHOW 30 GOOD SHOW good-show NO CREATE_TERM OK
GORDINFLON 1 GORDINFLON gordinflon NO CREATE_TERM OK
GUAYMALLEN 4 GUAYMALLEN guaymallen NO CREATE_TERM OK
HEREDERO 4 HEREDERO heredero NO CREATE_TERM OK
JORGELIN 2 JORGELIN jorgelin NO CREATE_TERM OK
JORGITO 5 JORGITO jorgito NO CREATE_TERM OK
KRACHITOS 47 KRACHITOS krachitos NO CREATE_TERM OK
LA BUSTINCERA 3 LA BUSTINCERA la-bustincera NO CREATE_TERM OK
LA FRANCISCANA 1 LA FRANCISCANA la-franciscana NO CREATE_TERM OK
LA HOGAREÑA 1 LA HOGAREÑA la-hogarena NO CREATE_TERM OK
LA PROVIDENCIA 2 LA PROVIDENCIA la-providencia NO CREATE_TERM OK
MACRITAS 10 MACRITAS macritas NO CREATE_TERM OK
MACROBIOTICAS 3 MACROBIOTICAS macrobioticas NO CREATE_TERM OK
MANI KING 27 MANI KING mani-king NO CREATE_TERM OK
MANITOON 2 MANITOON manitoon NO CREATE_TERM OK
MANOLITO 5 MANOLITO manolito NO CREATE_TERM OK
MARUCHAN 10 MARUCHAN maruchan NO CREATE_TERM OK
MINIARROCITAS 3 MINIARROCITAS miniarrocitas NO CREATE_TERM OK
MOLINOS DEL BOSQUE 5 MOLINOS DEL BOSQUE molinos-del-bosque NO CREATE_TERM OK
MUFASO 3 MUFASO mufaso NO CREATE_TERM OK
NISSIN 8 NISSIN nissin NO CREATE_TERM OK
NO APLICA 3 NO APLICA no-aplica NO BLOCKED Marca dudosa/no comercial: requiere revision manual.
NUESTROS SABORES 9 NUESTROS SABORES nuestros-sabores NO CREATE_TERM OK
OKKI 2 OKKI okki NO CREATE_TERM OK
PRO DE MAN 1 PRO DE MAN pro-de-man NO CREATE_TERM OK
RASTA 4 RASTA rasta NO CREATE_TERM OK
RECOLETA 3 RECOLETA recoleta NO CREATE_TERM OK
REI VERDE 8 REI VERDE rei-verde NO CREATE_TERM OK
TAKIS 1 TAKIS takis NO CREATE_TERM OK
TOSTEX 17 TOSTEX tostex NO CREATE_TERM OK
TUNKIPOP 4 TUNKIPOP tunkipop NO CREATE_TERM OK
WAMPA 3 WAMPA wampa NO CREATE_TERM OK

Resumen: 48 CREATE_TERM, 0 SKIP_ALREADY_EXISTS, 1 BLOCKED.

G. Writes ejecutados

Se ejecutaron 48 POST autorizados contra products/attributes/1/terms, uno por cada termino faltante. Todos respondieron HTTP 201.

Rango ID Woo Resultado
16 a 63 48 terminos creados y confirmados

No se creo el termino NO APLICA.

H. GET terminos despues del write

Control Resultado
Endpoint products/attributes/1/terms?per_page=100&page=1&hide_empty=false
HTTP 200
Terminos existentes despues del write 48
Terminos creados confirmados 48/48
Terminos bloqueados no creados 1

Todos los terminos creados quedaron con count=0, esperado porque no se crearon ni actualizaron productos.

I. Evidencia no sensible

  • .env fue validado como ignorado por Git, sin imprimir su contenido.
  • Las variables requeridas fueron validadas solo como PRESENT.
  • Marca / pa_marca fue confirmado con attribute_id=1.
  • GET previo de terminos devolvio 0 terminos.
  • SOURCE-002 local seguro devolvio 49 marcas candidatas.
  • NO APLICA quedo BLOCKED / MANUAL_REVIEW.
  • Se crearon 48 terminos faltantes bajo attribute_id=1.
  • GET posterior confirmo 48 terminos.
  • No se registraron, imprimieron ni versionaron secretos.

J. Archivos creados/modificados

Creado:

  • docs/tenants/alpuntodeventa/business-observer/production/PDF-009K-WOOCOMMERCE-MARCA-TERMS-CONTROLLED-WRITE.md

Actualizados:

  • docs/tenants/alpuntodeventa/business-observer/production/README.md
  • docs/PROJECT-STATE.md
  • docs/ROADMAP.md
  • docs/governance/ACTIVE-CONTEXT.md
  • mkdocs.yml

K. Validaciones

Validaciones ejecutadas:

  • git diff --check inicial -> PASS.
  • git diff --check posterior -> PASS sin errores; solo warnings LF/CRLF esperados en Windows.
  • .\.venv-portal\Scripts\mkdocs.exe build --strict -> PASS.

L. Estado final Git

Estado esperado antes de commit:

  • rama main...origin/main;
  • cambios documentales locales;
  • sin commit, sin push y sin deploy en este gate.

M. Recomendacion de commit

Commit recomendado si las validaciones pasan:

docs: add pdf-009k marca terms controlled write

No hacer commit sin autorizacion posterior.

N. Proximo paso recomendado

Abrir gate separado para categorias WooCommerce o para un payload de producto dry-run que use Marca / pa_marca con los terminos ya creados, manteniendo productos, categorias e imagenes bloqueados hasta autorizacion explicita.

O. Cierre de restricciones

Durante este gate no se crearon productos, no se actualizaron productos, no se borraron productos, no se crearon categorias, no se actualizaron categorias, no se subieron imagenes, no se modifico Media Library, no se toco PostgreSQL, no se ejecuto SQL, no se toco VPS, no se toco Docker, no se imprimieron secretos, no se mostro .env, no se hizo push, no se hizo deploy, no se ejecuto sync, no se ejecuto scheduler, no se ejecuto cron y no se ejecutaron pipelines.