# 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

---

### **Issue #8** - Footer con 4 áreas de widgets
- **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.