# SEO_STRATEGY

## Objetivo

Definir una estrategia SEO práctica para el rediseño frontend de `evangelizacion.org.mx`, de forma que el nuevo sitio no pierda posicionamiento durante la migración visual y, al mismo tiempo, quede listo para mejorar su rendimiento orgánico por tipo de página.

Este documento parte del estado real actual del proyecto y debe crecer junto con la migración de pantallas.

## Principio general

El SEO no debe tratarse como un ajuste final de meta tags.

En este proyecto, SEO debe resolverse en capas:

- SEO técnico compartido
- SEO estructural por plantilla
- SEO de contenido y enlazado interno
- SEO visual y rendimiento del frontend

## Estado actual detectado en el proyecto

Hoy el layout principal ya inyecta:

- `<title>`
- `meta description`
- `meta keywords`
- `og:title`
- `og:description`
- `og:image`
- `og:url`
- `twitter:card`
- `twitter:site`
- `twitter:title`
- `twitter:description`
- `twitter:image`

Punto central actual:

- `app/Views/Templates/main.php`

Fuente de datos SEO detectada:

- `app/Models/SeoModel.php`

## Huecos actuales que conviene cubrir

Aunque ya existe una base SEO, faltan o no están claramente resueltos:

- `canonical` por página
- `meta robots` renderizado realmente en el layout
- estrategia de `og:type` por tipo de página
- datos estructurados `JSON-LD`
- definición por plantilla de `title` y `description`
- política de indexación para páginas transaccionales o de bajo valor SEO
- criterio de imágenes OG por tipo de contenido
- validación explícita de headings semánticos en el nuevo frontend

## Objetivos SEO del rediseño

1. No perder señales SEO existentes durante la migración visual.
2. Mejorar consistencia técnica entre páginas.
3. Dejar una base lista para schema estructurado por tipo de contenido.
4. Evitar duplicidad de títulos, descripciones y URLs canónicas.
5. Mantener el sitio rápido y semánticamente claro tras la migración a TailwindCSS.

## Capa 1: SEO técnico compartido

Toda pantalla nueva o migrada debe revisar como mínimo:

- `title`
- `meta description`
- `canonical`
- `meta robots` si aplica
- `og:title`
- `og:description`
- `og:image`
- `og:url`
- `og:type`
- `twitter:card`
- `twitter:title`
- `twitter:description`
- `twitter:image`
- jerarquía correcta de headings

## Recomendación de implementación compartida

El layout principal debe evolucionar para soportar, idealmente desde un solo punto:

- `canonical`
- `robots`
- `og:type`
- `og:locale`
- `twitter:creator` si el negocio lo necesita
- `JSON-LD` inyectable por plantilla

Esto debe montarse sobre la lógica existente, no reescribirse sin razón.

## Reglas por tipo de metadato

### Title

- Debe ser único por página.
- Debe reflejar intención de búsqueda y contexto del contenido.
- Evitar títulos genéricos repetidos como solo "Evangelización Activa".

### Description

- Debe ser útil, específica y coherente con el contenido visible.
- No debe duplicarse masivamente entre pantallas distintas.
- No debe usarse solo texto institucional si la página es temática.

### Canonical

- Toda página indexable debe tener una URL canónica clara.
- La canonical debe apuntar a la versión final pública, sin parámetros innecesarios.

### Meta Robots

- No todas las pantallas merecen indexación.
- Páginas de error, pasos de checkout, respuestas transaccionales o confirmaciones deben evaluarse para `noindex`.

### Open Graph y Twitter

- Deben alinearse con el contenido y la imagen real de la página.
- No conviene que todo el sitio comparta una sola imagen si existen plantillas con valor editorial propio.

## Capa 2: SEO por plantilla

El proyecto no debe tratar todas las páginas igual.

## Tipos de página identificados en el proyecto

- Home
- Artículos
- Eventos
- Podcast
- Oraciones
- Lecturas
- Formación / academia
- Nosotros / políticas / contacto
- Donativos
- Lista de correo / páginas transaccionales

## Recomendaciones por plantilla

### Home

Objetivo:

- posicionamiento de marca
- comunicación de propuesta de valor
- distribución de autoridad interna hacia secciones clave

Recomendaciones:

- `Organization` y/o `WebSite` en schema
- heading principal claro
- bloques internos con enlaces visibles a contenido estratégico
- copy más orientado a intención de búsqueda y categorías reales del sitio

### Artículos

Objetivo:

- captar búsquedas informacionales
- fortalecer enlazado interno temático

Schema recomendado:

- `Article`

Revisar:

- título editorial limpio
- descripción única
- imagen destacada
- fecha si aplica
- enlazado a categorías, artículos relacionados, podcast relacionados o recursos relacionados

### Eventos

Schema recomendado:

- `Event`

Revisar:

- nombre del evento
- fecha
- ubicación o modalidad
- descripción clara
- estado del evento si aplica

### Podcast

Schema recomendado:

- `PodcastEpisode` o `AudioObject`

Revisar:

- título del episodio
- resumen
- imagen
- referencias cruzadas a categorías o temas

### Oraciones y Lecturas

Objetivo:

- captar búsquedas devocionales y litúrgicas

Revisar:

- títulos muy claros y específicos
- fecha cuando sea parte de la intención de búsqueda
- evitar duplicación excesiva entre páginas diarias
- enlazado entre tipos de lectura relacionados

### Formación

Objetivo:

- posicionar recursos evergreen y programas formativos

Revisar:

- taxonomía clara
- títulos descriptivos
- landing pages con estructura fuerte y CTA bien definidos

### Donativos y páginas transaccionales

Estas páginas no siempre deben tratarse como activos SEO primarios.

Revisar:

- qué páginas merecen indexarse
- qué páginas deberían ser `noindex`
- qué páginas solo existen para conversión y no para adquisición orgánica

## Capa 3: SEO de contenido

El rediseño no debe dejar fuera el contenido real.

Reglas:

- no crear headings solo por estética
- no esconder información clave en sliders difíciles de rastrear
- no depender de imágenes para comunicar lo importante
- no usar textos genéricos en bloques que podrían captar búsquedas reales

## Capa 4: SEO visual y rendimiento

El nuevo frontend con TailwindCSS debe cuidar:

- HTML semántico
- orden lógico de lectura
- LCP razonable
- imágenes optimizadas
- no cargar recursos innecesarios por pantalla
- evitar componentes visuales pesados sin beneficio real

El rediseño visual puede empeorar SEO si incrementa demasiado:

- peso de imágenes
- JavaScript innecesario
- layout shifts
- dependencia de sliders mal optimizados

## Home: estrategia inicial

Para la migración de `Home`, la revisión SEO mínima debería incluir:

- validar que el `title` actual siga siendo apropiado
- definir `canonical`
- agregar soporte a `meta robots` si no existe render
- definir `og:type` correcto
- decidir `JSON-LD` para `Organization` o `WebSite`
- revisar que haya un solo `h1`
- evitar que el hero dependa solo del carrusel para comunicar valor
- crear enlaces internos claros a:
  - formación
  - artículos
  - podcast
  - oraciones
  - donativos
  - nosotros

## Schema estructurado recomendado

## Fase inicial

- Home -> `Organization` y/o `WebSite`

## Fases siguientes

- Artículos -> `Article`
- Eventos -> `Event`
- Podcast -> `PodcastEpisode` o `AudioObject`
- Breadcrumbs en páginas internas -> `BreadcrumbList`

## Reglas para schema

- No agregar schema inventado o incompleto.
- No declarar datos que la página no muestra o no puede sostener.
- El schema debe salir de datos reales del sistema o de contenido confiable.

## Checklist SEO por pantalla nueva o migrada

- title único
- description útil
- canonical correcta
- robots definido si aplica
- og tags consistentes
- twitter tags consistentes
- un solo `h1`
- headings con jerarquía lógica
- enlaces internos relevantes
- imágenes con `alt` cuando aporten significado
- sin contenido clave oculto solo en imagen
- sin degradación clara de performance

## Qué no hacer

- No confiar en `meta keywords` como eje estratégico.
- No duplicar títulos y descripciones entre plantillas distintas.
- No indexar por default páginas de poco valor orgánico.
- No meter schema solo por checklist si no aporta valor real.
- No dejar SEO al final del rediseño.

## Decisiones futuras pendientes

Cuando avance la migración, este documento deberá ampliarse con:

- reglas de canonical por plantilla
- estrategia de `robots` por tipo de página
- templates de title y description
- política de imágenes OG
- implementación concreta de `JSON-LD`
- sitemap y prioridades reales del sitio

## Relación con otros documentos

- `AGENTS.md` define las reglas generales del proyecto
- `docs/FRONTEND_ARCHITECTURE.md` documenta la integración técnica
- `docs/FIGMA_ROUTE_MAPPING.md` mapea pantallas y rutas
- `docs/VISUAL_QA_CHECKLIST.md` valida implementación visual

Este documento agrega la capa SEO que debe acompañar cada pantalla migrada.