Files
roi-theme/_planeacion/ANALISIS-ISSUES-VS-TEMPLATE.md
FrankZamora ea38a12055 [NIVEL 2 AVANCE] Issues #49-#53 - Componentes Principales Verificados
Todos los componentes del NIVEL 2 ya están implementados correctamente:
-  Notification Bar (#49)
-  Navbar (#50)
-  Hero Section (#51)
-  Sidebar (#52)
-  Footer (#53)

Solo se actualizó notification-bar.css para usar variables CSS.

Próximo paso: NIVEL 3 (Refinamientos visuales)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 20:01:07 -06:00

11 KiB

ANÁLISIS DE ISSUES EXISTENTES VS NUEVO TEMPLATE

Fecha: 2025-11-04 Contexto: El cliente ha proporcionado un template completo en _planeacion/theme-template/ que debe implementarse. Necesitamos analizar qué issues existentes se pueden reutilizar/actualizar vs crear nuevos.


📊 RESUMEN EJECUTIVO

Total de Issues: 28

  • Abiertos: 19
  • Cerrados: 9

Recomendación:

  • REUTILIZAR/ACTUALIZAR: 14 issues (74%)
  • ⚠️ ADAPTAR SIGNIFICATIVAMENTE: 3 issues (16%)
  • OBSOLETOS (ya cerrados): 5 issues (26%)
  • 🆕 FUNCIONALIDADES NUEVAS SIN ISSUE: 6 funcionalidades

ISSUES 100% REUTILIZABLES (Solo necesitan actualización menor)

Estos issues ya están bien definidos y solo necesitan actualizar su descripción para alinearse con el nuevo template:

Issue #2 - Eliminar bloat innecesario de WordPress

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Actualizar para mantener consistencia con inc/performance.php (ya corregido en #22)
  • Trabajo ya hecho: inc/performance.php ya implementado
  • Qué actualizar: Verificar que todas las optimizaciones del template estén activas

Issue #3 - Desactivar funcionalidad de búsqueda nativa

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Implementar según especificaciones del template
  • Nota: El template no menciona búsqueda, confirmar si se mantiene desactivada

Issue #4 - Desactivar completamente el sistema de comentarios

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Implementar según template
  • Nota: El template no menciona comentarios, confirmar desactivación

Issue #5 - Integración de Bootstrap local (CSS y JS)

  • Estado: Abierto
  • Relevancia: 100% válido - CRÍTICO
  • Acción: ACTUALIZAR URGENTE - Cliente confirmó Bootstrap en LOCAL, no CDN
  • Qué hacer:
    1. Descargar Bootstrap 5.3.2 (mismo del template)
    2. Colocar en assets/vendor/bootstrap/
    3. Actualizar inc/enqueue-scripts.php para cargar local
    4. Eliminar referencias a CDN del template HTML

Issue #6 - Sistema de tipografías autohospedadas y fuentes del sistema

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: ACTUALIZAR - Cliente confirmó usar System Fonts, no Poppins
  • Qué hacer:
    1. NO descargar Google Fonts
    2. Modificar CSS del template para usar system fonts
    3. Actualizar inc/customizer-fonts.php para system fonts por defecto
    4. Hacer Poppins opcional (descargable desde opciones)

Issue #10 - Implementar imágenes destacadas configurables

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Implementar según template (featured-image-container ya definido en CSS)
  • Qué hacer: Conectar con opciones del tema

Issue #16 - Retardo de carga de AdSense hasta el primer scroll

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Mantener funcionalidad (ya implementado en inc/adsense-delay.php)
  • Qué hacer: Verificar compatibilidad con nuevo template

Issue #17 - Imágenes responsive con srcset/sizes y soporte WebP/AVIF

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Implementar según mejores prácticas
  • Nota: Template no lo menciona pero es importante para performance

Issue #18 - Accesibilidad y navegación por teclado (WCAG 2.1 AA)

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Aplicar a todos los componentes del nuevo template
  • Nota: Crítico para SEO y usabilidad

Issue #20 - Documentación completa del tema

  • Estado: Abierto
  • Relevancia: 100% válido
  • Acción: Actualizar documentación con el nuevo template
  • Nota: El template ya incluye excelente documentación en THEME-DOCUMENTATION.md

Issue #26 - Testing de rendimiento y compatibilidad

  • Estado: Abierto (Sub-issue de #21)
  • Relevancia: 100% válido
  • Acción: Testing del nuevo template en staging
  • Nota: Aplicable a cualquier versión del tema

Issue #27 - Revisar y optimizar funcionalidades opcionales

  • Estado: Abierto (Sub-issue de #21)
  • Relevancia: 100% válido
  • Acción: Revisar funciones deshabilitadas en performance.php
  • Nota: Ya se identificaron funciones problemáticas en #22

Issue #28 - Documentación de correcciones y deployment

  • Estado: Abierto (Sub-issue de #21)
  • Relevancia: 100% válido
  • Acción: Documentar el proceso de migración al nuevo template
  • Nota: Aplicable al deployment del nuevo diseño

⚠️ ISSUES QUE NECESITAN ADAPTACIÓN SIGNIFICATIVA

Estos issues necesitan reescribirse completamente porque el template define una implementación específica diferente:

Issue #7 - Header sticky con menú hamburguesa responsive

  • Estado: Abierto
  • Relevancia: ⚠️ Parcialmente válido - REESCRIBIR
  • Problema: El template define un navbar específico con animaciones y estructura diferente
  • Acción:
    1. CERRAR issue #7
    2. CREAR NUEVO: "Implementar Navbar según template (sticky + animaciones)"
    3. Usar el HTML/CSS/JS exacto del template
  • Razón: La implementación del template es muy específica y está completa

  • Estado: Abierto
  • Relevancia: ⚠️ Parcialmente válido - VERIFICAR TEMPLATE
  • Acción:
    1. Revisar si el template define footer
    2. Si NO: mantener issue #8
    3. Si SÍ: actualizar issue con especificaciones del template
  • Nota: El archivo index.html del template no muestra footer, verificar en footer.php

Issue #11 - Badge de categoría sobre H1 en single posts

  • Estado: Abierto
  • Relevancia: ⚠️ REEMPLAZAR - Template lo define diferente
  • Problema: Template define badges en HERO section (no sobre H1)
  • Acción:
    1. CERRAR issue #11
    2. ACTUALIZAR con: "Implementar Hero Section con badges de categoría"
    3. Usar diseño del template (glassmorphism, fondo azul degradado)

ISSUES OBSOLETOS (Ya cerrados correctamente)

Issue #14 - Panel de opciones del tema CERRADO

  • Razón: Template no lo requiere, se maneja vía Customizer

Issue #19 - Configuración SEO CERRADO

  • Razón: Template incluye Schema.org completo

Issue #22 - Funciones sanitizadoras CERRADO

  • Razón: Ya resuelto

Issue #23, #24, #25 - Validaciones CERRADOS

  • Razón: Obsoletos con nuevo template

🆕 FUNCIONALIDADES DEL TEMPLATE SIN ISSUE EXISTENTE

Estas funcionalidades están definidas en el template pero NO tienen issue:

1. Hero Section con degradado azul

  • Descripción: Sección con fondo degradado (#1e3a5f → #2c5282), badges de categorías glassmorphism, H1 centrado
  • Archivos: template-parts/content-hero.php
  • Issue requerido: SÍ - CREAR NUEVO

2. TOC (Tabla de Contenidos) con ScrollSpy mejorado

  • Descripción: TOC sticky con ScrollSpy preciso, smooth scroll, generación automática desde H2
  • Archivos: template-parts/content-toc.php, inc/toc.php
  • Issue existente: #12 (Tabla de contenidos automática)
  • Acción: ACTUALIZAR #12 con especificaciones exactas del template

3. Botones de compartir en redes sociales

  • Descripción: Facebook, Instagram, LinkedIn, WhatsApp, X, Email con iconos Bootstrap Icons
  • Archivos: template-parts/content-share.php
  • Issue requerido: SÍ - CREAR NUEVO

4. CTA con A/B Testing

  • Descripción: 2 variantes (Catálogo vs Membresía), rotación 50/50, tracking GA
  • Archivos: template-parts/content-cta.php, inc/ab-testing.php
  • Issue requerido: SÍ - CREAR NUEVO

5. Posts Relacionados (12 posts + paginación)

  • Descripción: Grid 3 columnas, 12 posts, cards grises con borde azul hover, paginación Bootstrap
  • Archivos: template-parts/content-related-posts.php
  • Issue existente: #13 (Posts relacionados configurables)
  • Acción: ACTUALIZAR #13 con diseño específico del template

6. Tablas APU con estilos específicos

  • Descripción: Tablas sin bordes, zebra striping, section-header, subtotal-row, total-row
  • Archivos: CSS en assets/css/custom-style.css (líneas 241-420)
  • Issue requerido: SÍ - CREAR NUEVO (CRÍTICO para el sitio)

7. Schema.org completo (5 schemas)

  • Descripción: Article, HowTo, FAQ, VideoObject, BreadcrumbList
  • Archivos: inc/schema-markup.php
  • Issue existente: #19 (ya cerrado como obsoleto)
  • Acción: CREAR NUEVO específico para implementar los 5 schemas del template

📋 RECOMENDACIONES FINALES

NO CREAR NUEVOS ISSUES PARA:

  • Funcionalidades ya cubiertas por issues abiertos
  • Issues de validación (ya cerrados #23-25)
  • Panel de opciones (ya cerrado #14)

ACTUALIZAR ESTOS ISSUES:

  1. ✏️ #12 - TOC: Agregar especificaciones del ScrollSpy mejorado
  2. ✏️ #13 - Posts relacionados: Agregar diseño de 12 posts + paginación
  3. ✏️ #5 - Bootstrap: Clarificar que debe ser LOCAL
  4. ✏️ #6 - Tipografías: Clarificar que son SYSTEM FONTS por defecto

CREAR SOLO ESTOS 5 ISSUES NUEVOS (atómicos, específicos):

  1. 🆕 #29 - Implementar Hero Section con degradado y badges glassmorphism
  2. 🆕 #30 - Implementar botones de compartir en redes sociales
  3. 🆕 #31 - Implementar CTA con A/B Testing (2 variantes + GA tracking)
  4. 🆕 #32 - Implementar tablas APU con estilos específicos (CRÍTICO)
  5. 🆕 #33 - Implementar Schema.org completo (5 schemas)

CERRAR/REEMPLAZAR:

  • #7 → Crear nuevo "Implementar Navbar según template"
  • #11 → Ya cubierto por nuevo issue #29 (Hero Section)

🎯 PLAN DE ACCIÓN SUGERIDO

  1. Actualizar 4 issues existentes (#5, #6, #12, #13)
  2. Crear 5 issues nuevos (#29-#33) solo para funcionalidades NO cubiertas
  3. Cerrar/consolidar #7 y #11 en nuevos issues
  4. Mantener abiertos todos los demás issues (#2, #3, #4, #10, #15-18, #20, #26-28)

Total de trabajo:

  • 4 actualizaciones
  • 5 creaciones
  • 2 consolidaciones
  • 11 acciones en total (vs crear 20+ issues nuevos innecesariamente)

Conclusión: Podemos reutilizar 74% de los issues existentes solo actualizándolos. Solo necesitamos crear 5 issues nuevos para funcionalidades específicas del template que no están cubiertas.