roi-theme/openspec/specs/adsense-javascript-first/test-plan.md

Plan de Pruebas: AdSense JavaScript-First Architecture

NOTA IMPORTANTE - PROTOCOLO DE PRUEBAS

Las pruebas se ejecutan en el servidor de PRODUCCION. Si hay algo que corregir, se modifica en LOCAL y luego se despliega.

PROHIBIDO: Modificar codigo directamente en produccion. PERMITIDO: Solo ejecutar pruebas y verificaciones en produccion.

Flujo correcto:

1. Ejecutar prueba en produccion
2. Si falla, corregir en local
3. Desplegar cambios a produccion
4. Re-ejecutar prueba

---

Resumen de Pruebas

ID	Categoria	Descripcion	Criterio de Aceptacion
T01	Endpoint REST	Endpoint registrado y accesible	HTTP 200 con JSON valido
T02	Endpoint REST	Headers anti-cache presentes	Cache-Control, Pragma, Expires
T03	Endpoint REST	Parametro post_id requerido	HTTP 400 sin post_id
T04	Endpoint REST	post_id=0 valido (archivos/home)	HTTP 200 con post_id=0
T05	Visibilidad	Componente deshabilitado	show_ads=false, reason=component_disabled
T06	Visibilidad	Usuario anonimo sin exclusiones	show_ads=true, reasons=[]
T07	Visibilidad	Usuario logueado excluido	show_ads=false, reason=logged_in_excluded
T08	Visibilidad	Rol excluido	show_ads=false, reason=role_excluded
T09	Visibilidad	Post excluido	show_ads=false, reason=post_excluded
T10	JavaScript	Script cargado en frontend	roiAdsenseConfig definido
T11	JavaScript	Cache localStorage funciona	Datos guardados correctamente
T12	JavaScript	Fallback cuando error	Ads se muestran en error
T13	Feature Flag	Modo deshabilitado = legacy	No llama endpoint
T14	Feature Flag	Modo habilitado = JS-First	Llama endpoint
T15	Clean Arch	Value Objects inmutables	No WordPress en Domain
T16	Clean Arch	Interface en Domain	AdsenseVisibilityCheckerInterface existe

---

Pruebas Detalladas

T01: Endpoint REST Registrado y Accesible

Categoria: Endpoint REST Prioridad: CRITICA Spec Reference: Requirement: Endpoint REST Visibility

Pasos:

1. Abrir navegador o usar curl
2. Acceder a: https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=1

Resultado Esperado:

• HTTP Status: 200
• Content-Type: application/json
• Body contiene: show_ads, reasons, cache_seconds, timestamp

Comando de Prueba:

curl -i "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=1"

Estado: [ ] Pendiente Resultado: Notas:

---

T02: Headers Anti-Cache Presentes

Categoria: Endpoint REST Prioridad: ALTA Spec Reference: Scenario: Headers anti-cache obligatorios

Pasos:

1. Hacer request al endpoint
2. Verificar headers de respuesta

Resultado Esperado:

• Cache-Control: no-store, no-cache, must-revalidate, max-age=0
• Pragma: no-cache
• Expires: Thu, 01 Jan 1970 00:00:00 GMT o 0
• Vary: Cookie

Comando de Prueba:

curl -I "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=1"

Estado: [ ] Pendiente Resultado: Notas:

---

T03: Parametro post_id Requerido

Categoria: Endpoint REST Prioridad: ALTA Spec Reference: Scenario: Parametros del endpoint

Pasos:

1. Hacer request SIN post_id
2. Verificar respuesta de error

Resultado Esperado:

• HTTP Status: 400 (Bad Request)
• Body contiene mensaje de error indicando que post_id es requerido

Comando de Prueba:

curl -i "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility"

Estado: [ ] Pendiente Resultado: Notas:

---

T04: post_id=0 Valido para Paginas de Archivo

Categoria: Endpoint REST Prioridad: ALTA Spec Reference: Scenario: Parametros del endpoint (validate_callback >= 0)

Pasos:

1. Hacer request con post_id=0
2. Verificar que responde correctamente

Resultado Esperado:

• HTTP Status: 200
• Body contiene decision de visibilidad valida

Comando de Prueba:

curl -i "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=0"

Estado: [ ] Pendiente Resultado: Notas:

---

T05: Componente Deshabilitado Retorna False

Categoria: Visibilidad Prioridad: ALTA Spec Reference: Scenario: Componente deshabilitado

Pre-condicion:

• Deshabilitar componente en admin (is_enabled = false)

Pasos:

1. Deshabilitar adsense-placement en admin
2. Hacer request al endpoint
3. Verificar respuesta

Resultado Esperado:

{
  "show_ads": false,
  "reasons": ["component_disabled"],
  "cache_seconds": 3600
}

Comando de Prueba:

curl "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=1"

Estado: [ ] Pendiente Resultado: Notas:

---

T06: Usuario Anonimo Sin Exclusiones Ve Ads

Categoria: Visibilidad Prioridad: CRITICA Spec Reference: Scenario: Usuario anonimo sin exclusiones

Pre-condicion:

• Componente habilitado
• javascript_first_mode habilitado
• Sin exclusiones configuradas
• No estar logueado

Pasos:

1. Abrir navegador en modo incognito
2. Acceder a un post del sitio
3. Verificar respuesta del endpoint

Resultado Esperado:

{
  "show_ads": true,
  "reasons": [],
  "cache_seconds": 60
}

Comando de Prueba:

curl "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=1"

Estado: [ ] Pendiente Resultado: Notas:

---

T07: Usuario Logueado Excluido

Categoria: Visibilidad Prioridad: ALTA Spec Reference: Scenario: Usuario logueado excluido

Pre-condicion:

• Activar "Ocultar para usuarios logueados" en admin

Pasos:

1. Loguearse en WordPress
2. Copiar cookies de sesion
3. Hacer request con cookies

Resultado Esperado:

{
  "show_ads": false,
  "reasons": ["logged_in_excluded"],
  "cache_seconds": 300
}

Verificacion Manual:

1. Loguearse en wp-admin
2. Visitar un post en el frontend
3. Abrir DevTools > Network
4. Buscar request a /visibility
5. Verificar respuesta

Estado: [ ] Pendiente Resultado: Notas:

---

T08: Rol Excluido

Categoria: Visibilidad Prioridad: ALTA Spec Reference: Scenario: Rol de usuario excluido

Pre-condicion:

• Agregar "administrator" a roles excluidos en admin

Pasos:

1. Loguearse como administrator
2. Visitar un post
3. Verificar respuesta del endpoint

Resultado Esperado:

{
  "show_ads": false,
  "reasons": ["role_excluded"],
  "cache_seconds": 300
}

Estado: [ ] Pendiente Resultado: Notas:

---

T09: Post Excluido por ID

Categoria: Visibilidad Prioridad: ALTA Spec Reference: Scenario: Post excluido por ID

Pre-condicion:

• Agregar un ID de post a "IDs de posts excluidos" en admin

Pasos:

1. Anotar el ID del post excluido (ej: 123)
2. Hacer request con ese post_id
3. Verificar respuesta

Resultado Esperado:

{
  "show_ads": false,
  "reasons": ["post_excluded"],
  "cache_seconds": 60
}

Comando de Prueba:

curl "https://analisisdepreciosunitarios.com/wp-json/roi-theme/v1/adsense-placement/visibility?post_id=123"

Estado: [ ] Pendiente Resultado: Notas:

---

T10: Script JavaScript Cargado

Categoria: JavaScript Prioridad: CRITICA Spec Reference: Scenario: Configuracion via wp_localize_script

Pre-condicion:

• javascript_first_mode habilitado

Pasos:

1. Visitar un post en el frontend
2. Abrir DevTools > Console
3. Escribir: window.roiAdsenseConfig

Resultado Esperado:

• Objeto definido con propiedades:
  • endpoint: URL del endpoint REST
  • postId: ID del post actual
  • nonce: String no vacio
  • featureEnabled: true
  • debug: boolean

Verificacion Alternativa:

// En consola del navegador
console.log(window.roiAdsenseConfig);
console.log(typeof window.roiAdsenseVisibility);

Estado: [ ] Pendiente Resultado: Notas:

---

T11: Cache localStorage Funciona

Categoria: JavaScript Prioridad: ALTA Spec Reference: Scenario: Cache en localStorage

Pasos:

1. Visitar un post (primera vez)
2. Abrir DevTools > Application > Local Storage
3. Buscar key roi_adsense_visibility
4. Recargar pagina
5. Verificar en Network que NO hay nueva llamada al endpoint

Resultado Esperado:

• localStorage contiene:

  {
    "show_ads": true,
    "reasons": [],
    "timestamp": 1733900000,
    "cache_seconds": 60
  }
  

• Segunda carga NO hace request al endpoint (usa cache)

Verificacion en Consola:

localStorage.getItem('roi_adsense_visibility');

Estado: [ ] Pendiente Resultado: Notas:

---

T12: Fallback en Error de Red

Categoria: JavaScript Prioridad: ALTA Spec Reference: Scenario: Fallback strategy cached-or-show

Pasos:

1. Limpiar localStorage
2. Abrir DevTools > Network
3. Habilitar "Offline" mode
4. Visitar un post
5. Verificar comportamiento

Resultado Esperado:

• Los ads se muestran (fallback = show)
• No hay error en consola (error manejado gracefully)

Verificacion Alternativa:

// Limpiar cache
window.roiAdsenseVisibility.clearCache();
// Recargar con network offline

Estado: [ ] Pendiente Resultado: Notas:

---

T13: Feature Flag Deshabilitado = Modo Legacy

Categoria: Feature Flag Prioridad: ALTA Spec Reference: Scenario: Feature flag deshabilitado

Pre-condicion:

• Deshabilitar javascript_first_mode en admin

Pasos:

1. Deshabilitar javascript_first_mode
2. Visitar un post
3. Verificar en Network que NO hay llamada al endpoint

Resultado Esperado:

• roiAdsenseConfig.featureEnabled = false
• No hay request a /visibility endpoint
• Ads se muestran inmediatamente (modo legacy)

Estado: [ ] Pendiente Resultado: Notas:

---

T14: Feature Flag Habilitado = JS-First

Categoria: Feature Flag Prioridad: ALTA Spec Reference: Scenario: Feature flag habilitado

Pre-condicion:

• Habilitar javascript_first_mode en admin

Pasos:

1. Habilitar javascript_first_mode
2. Limpiar cache (localStorage y pagina)
3. Visitar un post
4. Verificar en Network que SI hay llamada al endpoint

Resultado Esperado:

• roiAdsenseConfig.featureEnabled = true
• Request a /visibility endpoint presente
• Ads se muestran/ocultan segun respuesta

Estado: [ ] Pendiente Resultado: Notas:

---

T15: Value Objects Sin Dependencias WordPress

Categoria: Clean Architecture Prioridad: MEDIA Spec Reference: Scenario: Value Object VisibilityDecision en Domain

Verificacion: Revisar que los archivos NO contengan funciones de WordPress:

Archivos a verificar:

• Domain/ValueObjects/UserContext.php
• Domain/ValueObjects/VisibilityDecision.php
• Domain/ValueObjects/AdsenseSettings.php
• Domain/Contracts/AdsenseVisibilityCheckerInterface.php
• Application/UseCases/CheckAdsenseVisibilityUseCase.php

Resultado Esperado:

• Sin get_, wp_, is_user_logged_in, WP_* classes
• Solo PHP puro y tipos del proyecto

Estado: [ ] Pendiente Resultado: Notas:

---

T16: Interface en Domain

Categoria: Clean Architecture Prioridad: MEDIA Spec Reference: Scenario: Interface en Domain

Verificacion: El archivo Domain/Contracts/AdsenseVisibilityCheckerInterface.php debe:

• Existir en la ruta correcta
• Definir metodo check(int $postId, UserContext $userContext): VisibilityDecision
• NO referenciar WordPress

Estado: [ ] Pendiente Resultado: Notas:

---

Checklist de Despliegue Pre-Pruebas

Antes de ejecutar las pruebas, verificar:

• Codigo desplegado a produccion via FTP/SSH
• Cache de pagina limpiado
• javascript_first_mode habilitado en admin
• Componente adsense-placement habilitado
• Schema sincronizado en BD (campo javascript_first_mode existe)

---

Registro de Ejecucion

Fecha	Tester	Pruebas Ejecutadas	Pasadas	Fallidas	Notas

---

Defectos Encontrados

ID	Prueba	Descripcion	Severidad	Estado	Correccion

---

Historial de Versiones

Version	Fecha	Cambios
1.0	2025-12-11	Plan inicial basado en spec v1.5