Sync: guardar en el historial el trabajo de las ultimas semanas que solo vivia en el disco

Este repo local tenia origin apuntando al Gitea local (localhost:3000), que Rafa declaro archivado el 2026-06-28 (commit 962f33a, desarrollo movido a gitea.feadulta.com). Ese memo nunca llego a este checkout: main quedo congelado y todo el trabajo real de las ultimas 3+ semanas se fue commiteando solo en la rama fix/multiidioma-portada-132 (ya fusionada a main sin perdida, commit 2504666), mientras que ademas se acumulaban 78 cambios sin commitear en el working tree que nunca llegaron a NINGUN historial de git. Este commit consolida esos cambios sueltos: TTS multi-voz (tts_*.py), scripts de traduccion (translate_haiku.py, pretranslate_en_haiku.py, sync_translations_to_prod.py), mu-plugins nuevos desplegados a prod (fea-beta-feedback, fea-cloudflare-realip, fea-legacy-redirect, fea-gsc-verification, fea-support-campaign, fea-ui, etc.), scripts de mantenimiento de enlaces/cartas, capturas E2E (tools/e2e/shot_*.cjs) y documentacion de sesiones recientes. Excluido deliberadamente (no es codigo versionable): tts-voices/ (3.3GB de muestras de audio para clonacion de voz, anadido a .gitignore), logs/ (logs de ejecucion, anadido a .gitignore), y 2 ficheros vacios accidentales + 2 copias duplicadas sueltas en la raiz que ya existen en su ubicacion correcta.
2026-07-15 20:03:21 -04:00
parent 250466696b
commit 69e849d38e
72 changed files with 5413 additions and 220 deletions
@@ -19,11 +19,13 @@

 | Entorno | URL | Estado |
 |---------|-----|--------|
-| **Beta (actual)** | `https://wp-nuevo.feadulta.com` | Es donde se trabaja **ahora** |
-| Producción final | `https://feadulta.com` | Tras el "cutover" de DNS (cambiará la URL base) |
+| **Producción** | `https://www.feadulta.com` | El sitio en vivo, WordPress. Cutover completado el 2026-07-08 |
+| Legado Joomla | `https://antiguo.feadulta.com` | Solo contenido histórico no migrado. No se publica aquí |

-Mientras no se avise, **todo va a `wp-nuevo.feadulta.com`**. Cuando se haga el cambio de
-dominio, solo hay que sustituir la URL base en los ejemplos de abajo.
+**El cutover de dominio ya se hizo (2026-07-08):** `www.feadulta.com` es WordPress y es donde
+se publica siempre. `wp-nuevo.feadulta.com` (el subdominio de Beta) ha dejado de servir nada
+(el directorio que usaba se vació al mover los ficheros a la raíz del hosting) — si algún
+enlace o script antiguo todavía lo menciona, hay que cambiarlo a `www.feadulta.com`.

 ### 1.2 Acceso recomendado: API REST de WordPress + contraseña de aplicación

@@ -33,7 +35,7 @@ No hace falta SSH ni tocar la base de datos. WordPress trae una API REST y un si
 **Cómo obtener la credencial (lo hace Inma una sola vez):**
 Inma **ya tiene usuario con rol Editor** en el sitio (suficiente para crear, editar,
 publicar y programar entradas). Con ese usuario:
-1. Entrar en `https://wp-nuevo.feadulta.com/wp-admin`.
+1. Entrar en `https://www.feadulta.com/wp-admin`.
 2. Ir a **Usuarios → Perfil** → bajar hasta **"Contraseñas de aplicación"**.
 3. Escribir un nombre (p. ej. `cowork-cartas`) y pulsar **Añadir**.
 4. WordPress muestra una contraseña de 24 caracteres con espacios
@@ -45,10 +47,10 @@ usuario):

 ```bash
 curl -s -u "USUARIO:xxxx xxxx xxxx xxxx xxxx xxxx" \
-  https://wp-nuevo.feadulta.com/wp-json/wp/v2/users/me
+  https://www.feadulta.com/wp-json/wp/v2/users/me
 ```

-Base de la API para todo lo demás: `https://wp-nuevo.feadulta.com/wp-json/wp/v2/`
+Base de la API para todo lo demás: `https://www.feadulta.com/wp-json/wp/v2/`

 > **⚠️ Pendiente de configurar en Cloudflare (bloqueante).** Comprobado el **27/06/2026**: el
 > sitio está tras Cloudflare y devuelve **403 "Attention Required"** a **cualquier** petición
@@ -96,8 +98,8 @@ Las categorías se asignan por su **ID numérico** vía API (campo `categories:
 | ID | Nombre | Slug | Significado |
 |----|--------|------|-------------|
 | **6** | Carta de la semana | `cartasemana` | La carta **vigente**. Debe estar solo la actual. |
-| **22** | La semana pasada | `carta-semana-pasada` | La carta de la semana anterior. |
-| **21** | Cartas de otras semanas | `cartas-de-otras-semanas` | Histórico (todas las anteriores). |
+| **22** | La semana pasada | `carta-semana-pasada` | La carta de la semana anterior. Debe estar solo una. |
+| **21** | Cartas de otras semanas | `cartas-de-otras-semanas` | Histórico **acumulativo**: TODAS las cartas publicadas alguna vez, incluidas la vigente (6) y la anterior (22). No se quita nunca, solo se añade. Así el listado de "Otras Semanas" sirve para navegar por cualquier carta pasada sin tener que ir carta por carta. |

 ### 3.2 Categorías temáticas (para los artículos de dentro de la carta)

@@ -128,7 +130,7 @@ estén listos, publicarlos.

 ```bash
 curl -s -u "USUARIO:APP_PASSWORD" \
-  -X POST https://wp-nuevo.feadulta.com/wp-json/wp/v2/posts \
+  -X POST https://www.feadulta.com/wp-json/wp/v2/posts \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Título del artículo",
@@ -145,6 +147,56 @@ De la respuesta JSON interesan dos campos:

 Repetir para cada artículo, usando la categoría temática que corresponda (§3.2).

+> ⚠️ **No adivinéis la URL a partir del título — usad siempre el `link` real de la API,
+> y solo DESPUÉS de publicar.** En la carta 734 los artículos se quedaron en `draft` con el
+> título prefijado `[PRUEBA]`, y la carta se compuso enlazando slugs *adivinados* a mano
+> (`.../prueba-silencio/`, etc.) a partir de ese título provisional. Al publicar de verdad
+> con el título limpio, WordPress genera el slug desde el título final y **le añade un
+> sufijo (`-2`, `-4`…) si ya existe otro post con ese mismo slug** — algo frecuente en
+> temas recurrentes ("Silencio", "La palabra", "Te encontré"…). Resultado: 21 de 22
+> enlaces de la carta apuntaban a una URL que nunca existió. Regla: **publicad cada
+> artículo (quitando `[PRUEBA]` del título) en cuanto esté listo**, y componed los
+> enlaces de la carta con el `link` que devuelve la API **tras ese publish**, no antes.
+
+### Paso 1.5 — Asignar `_carta_id` a cada artículo de la semana (IMPORTANTE)
+
+Cada artículo de la semana debe llevar el meta `_carta_id` = ID del post de la carta a la
+que pertenece. **Sin esto, el sistema no puede localizar "todos los artículos de esta
+carta" para publicarlos/traducirlos/locutarlos en bloque.**
+
+`_carta_id` es un meta interno y **no se puede asignar por el endpoint estándar**
+`/wp/v2/posts/<id>` (WordPress lo bloquea por empezar por `_`). Para esto hay un
+**endpoint REST propio**, desplegado el 2026-07-07:
+
+```bash
+# Leer el _carta_id actual de un artículo
+curl -s -u "USUARIO:APP_PASSWORD" \
+  https://www.feadulta.com/wp-json/fea/v1/carta-id/ID_DEL_ARTICULO
+
+# Asignar (o corregir) el _carta_id de un artículo
+curl -s -u "USUARIO:APP_PASSWORD" \
+  -X POST https://www.feadulta.com/wp-json/fea/v1/carta-id/ID_DEL_ARTICULO \
+  -H "Content-Type: application/json" \
+  -d '{"carta_id": ID_DE_LA_CARTA}'
+
+# Borrar el _carta_id (si os habéis equivocado de artículo)
+curl -s -u "USUARIO:APP_PASSWORD" \
+  -X DELETE https://www.feadulta.com/wp-json/fea/v1/carta-id/ID_DEL_ARTICULO
+```
+
+Respuesta en los tres casos: `{"post_id": ID, "carta_id": ID|null}`.
+
+Notas:
+- Solo podéis asignar `_carta_id` a artículos **que ya podéis editar** (mismo criterio que
+  el resto de la API: vuestro usuario Editor).
+- `carta_id` tiene que ser el ID de **un post que exista** (normalmente el de la carta,
+  aunque en el momento de llamar a este endpoint la carta puede que aún esté en borrador —
+  eso no importa, solo tiene que existir el post).
+- Podéis llamarlo justo después de crear cada artículo (Paso 1) o al final, después de tener
+  el ID de la carta (Paso 3) — el orden entre pasos 1 y 1.5 y 3 no importa mientras al acabar
+  todos los artículos de la semana tengan el `_carta_id` correcto.
+- Código fuente: `wp-content/mu-plugins/fea-carta-id-api.php` (mu-plugin, activo siempre).
+
 ### Paso 2 — Componer el artículo-carta

 La carta es un post HTML con:
@@ -156,7 +208,9 @@ Ver §5 para el formato exacto de los encabezados y un ejemplo completo.

 ### Paso 3 — Publicar (o programar) la carta

-La carta va en la categoría **6** (`cartasemana`).
+La carta va en la categoría **6** (`cartasemana`) **y también en la 21** (`cartas-de-otras-semanas`)
+desde el primer momento — ver §3.1: la 21 es un histórico acumulativo que no se quita nunca, así
+que toda carta la lleva ya desde que se crea, no solo cuando se "degrada" en el Paso 4.

 - **Publicar ya:** `"status": "publish"`.
 - **Programar:** `"status": "future"` + `"date"` con la fecha/hora local del sitio en
@@ -164,35 +218,53 @@ La carta va en la categoría **6** (`cartasemana`).

 ```bash
 curl -s -u "USUARIO:APP_PASSWORD" \
-  -X POST https://wp-nuevo.feadulta.com/wp-json/wp/v2/posts \
+  -X POST https://www.feadulta.com/wp-json/wp/v2/posts \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Carta de la semana — 29 de junio",
    "content": "<p>…cuerpo de la carta con sus secciones y enlaces…</p>",
    "status": "future",
    "date": "2026-06-29T08:00:00",
-    "categories": [6]
+    "categories": [6, 21]
  }'
 ```

 ### Paso 4 — Rotar la carta anterior (IMPORTANTE, manual)

 Al entrar una carta nueva en la categoría **6**, hay que **degradar la anterior** para que la
-categoría "Carta de la semana" contenga **solo una** carta:
+categoría "Carta de la semana" contenga **solo una** carta. Esto es solo mover el marcador de
+**estado** (6 → 22 → ninguno): la categoría **21** ("Otras semanas") **no se toca en la
+rotación**, porque es acumulativa y ya la lleva cada carta desde que se publicó (Paso 3). Nunca
+se quita la 21 a una carta.

 1. A la carta que **dejaba** de ser actual: quitarle la categoría **6** y ponerle la **22**
-   ("La semana pasada").
-2. A la que estaba en **22**: pasarla a la **21** ("Cartas de otras semanas").
+   ("La semana pasada"). Mantiene la **21** que ya tenía.
+2. A la que estaba en **22**: quitarle la **22** sin más. Mantiene la **21** que ya tenía —
+   así queda solo en el histórico "Otras semanas", visible igual que todas las demás.

-Vía API se actualiza el array `categories` del post (sustituye al anterior):
+Vía API se actualiza el array `categories` del post (sustituye al anterior, así que hay que
+**incluir siempre la 21** en el array nuevo o se perdería):

 ```bash
+# 1. La carta que deja de ser actual: 6 → 22 (conserva 21)
 curl -s -u "USUARIO:APP_PASSWORD" \
-  -X POST https://wp-nuevo.feadulta.com/wp-json/wp/v2/posts/ID_DE_LA_CARTA_VIEJA \
+  -X POST https://www.feadulta.com/wp-json/wp/v2/posts/ID_DE_LA_CARTA_VIEJA \
  -H "Content-Type: application/json" \
-  -d '{"categories": [22]}'
+  -d '{"categories": [22, 21]}'
+
+# 2. La que estaba en 22: se queda solo con 21 (y las que no sean de estado, p.ej. 71)
+curl -s -u "USUARIO:APP_PASSWORD" \
+  -X POST https://www.feadulta.com/wp-json/wp/v2/posts/ID_DE_LA_CARTA_MAS_VIEJA \
+  -H "Content-Type: application/json" \
+  -d '{"categories": [21]}'
 ```

+> ⚠️ El endpoint `POST /wp/v2/posts/ID` con `categories` **sustituye** el array completo, no
+> añade. Antes de rotar, comprobar con `GET /wp-json/wp/v2/posts/ID_DE_LA_CARTA?_fields=categories`
+> qué categorías tiene ya el post (p. ej. si tiene además la 71 "Feadulta") e incluirlas todas
+> en el array nuevo — si no, se pierden categorías sin querer (esto pasó en la carta 733/734,
+> ver issue #159 y #161).
+>
 > Si se programa la carta nueva con `future`, esta rotación puede hacerse el mismo día en que
 > se publique. Si surge duda sobre qué carta está en qué categoría, consultar:
 > `GET /wp-json/wp/v2/posts?categories=6` (debe devolver solo una).
@@ -220,6 +292,12 @@ de portada indicado:
 - Los enlaces dentro de cada sección deben apuntar a **artículos que existan** en el sitio
  (las URLs del Paso 1). Enlaces a páginas externas se ignoran.
 - Si una sección no tiene enlaces, ese bloque de la portada queda vacío.
+- **"Noticias de alcance" NO se enlaza a mano en el cuerpo de la carta.** Si la semana
+  incluye una noticia de este tipo, el artículo va categorizado en la categoría **41**
+  ("Noticias de alcance") y **eso basta**: la portada tiene un bloque de footer aparte que
+  se alimenta solo de esa categoría. Si además se enlaza esa noticia dentro de "Artículos
+  seleccionados para la semana", **sale duplicada** en la portada (pasó en la carta 734,
+  ver issue #159).

 **Ejemplo mínimo de cuerpo de carta:**

@@ -228,23 +306,23 @@ de portada indicado:

 <p><strong style="color:red">Evangelio y comentarios al Evangelio</strong></p>
 <ul>
-  <li><a href="https://wp-nuevo.feadulta.com/comentario-evangelio-domingo/">Comentario al evangelio</a></li>
+  <li><a href="https://www.feadulta.com/comentario-evangelio-domingo/">Comentario al evangelio</a></li>
 </ul>

 <p><strong style="color:red">Artículos seleccionados para la semana</strong></p>
 <ul>
-  <li><a href="https://wp-nuevo.feadulta.com/articulo-uno/">Primer artículo</a></li>
-  <li><a href="https://wp-nuevo.feadulta.com/articulo-dos/">Segundo artículo</a></li>
+  <li><a href="https://www.feadulta.com/articulo-uno/">Primer artículo</a></li>
+  <li><a href="https://www.feadulta.com/articulo-dos/">Segundo artículo</a></li>
 </ul>

 <p><strong style="color:red">Para unas eucaristías más participativas y actuales</strong></p>
 <ul>
-  <li><a href="https://wp-nuevo.feadulta.com/eucaristia-domingo/">Material para la eucaristía</a></li>
+  <li><a href="https://www.feadulta.com/eucaristia-domingo/">Material para la eucaristía</a></li>
 </ul>

 <p><strong style="color:red">Material multimedia</strong></p>
 <ul>
-  <li><a href="https://wp-nuevo.feadulta.com/video-semana/">Vídeo de la semana</a></li>
+  <li><a href="https://www.feadulta.com/video-semana/">Vídeo de la semana</a></li>
 </ul>
 ```

@@ -276,31 +354,42 @@ de portada indicado:

 ---

-## 7. Traducción y audio automáticos (lado servidor — informativo)
+## 7. Traducción y audio (lado servidor — ⚠️ hoy es MANUAL, no automático)

-**Inma no tiene que traducir ni generar audio.** En el servidor hay (o habrá) un proceso
-programado (cron) que:
+**Corregido 2026-07-12: esto todavía NO es automático.** El cron que traduciría y generaría
+audio solo al publicar (issue [#23](https://gitea.feadulta.com/rafa/feadulta/issues/23)) sigue
+sin implementar — es una propuesta abierta, no algo que ya corra. Versiones anteriores de esta
+guía decían "hay (o habrá) un proceso programado" dando a entender que ya estaba activo o a
+punto; no lo está. **Inma NO tiene que traducir ni generar audio ella misma**, pero sí tiene que
+**pedirlo** — no llega solo.

-1. Detecta cartas y artículos nuevos publicados **en español** sin traducción.
-2. Los **traduce** a EN/FR/IT/PT y los enlaza como traducciones (Polylang).
-3. Genera el **audio TTS** (voz, MiniMax) de la carta y sus artículos.
+**Cómo pedirlo hoy:** escribir al grupo de WhatsApp mencionando "Hermes" (o por Telegram),
+indicando la carta/artículo. Hermes ejecuta los scripts correspondientes en el servidor de Rafa.
+Ver el runbook completo (motores de traducción, voces TTS por autor, tiempos, qué hacer si
+Hermes no responde) en `docs/guia-tts-traduccion-inma.md`.

-Por eso es importante: **subir siempre el contenido en español** y dejar que el proceso haga
-el resto. Si una carta urgente necesita traducción inmediata, avisar a Rafa.
+**Por eso sigue siendo importante subir siempre el contenido en español** — la traducción parte
+siempre del ES, pero hay que pedirla, no asumir que "ya llegará". Si una carta urgente necesita
+traducción inmediata, avisar a Rafa directamente además de pedírselo a Hermes.

-> *Este punto es responsabilidad de Rafa (infraestructura). Se incluye aquí solo para que el
-> asistente de Inma sepa que no debe duplicar ese trabajo.*
+> *Este punto es responsabilidad de Rafa (infraestructura). Se incluye aquí para que el
+> asistente de Inma sepa que el trabajo de traducir/locutar no lo tiene que hacer él mismo,
+> pero sí que tiene que solicitarlo activamente.*

 ---

 ## 8. Resumen rápido (checklist por carta)

- [ ] Crear cada artículo de la semana (borrador → publicado). Guardar su URL.
+- [ ] Crear cada artículo de la semana y **publicarlo** (no dejarlo en `draft`/`[PRUEBA]`).
+- [ ] Guardar la URL (`link`) de cada artículo **después** de publicarlo, no antes (el slug
+      puede cambiar por colisión con otro post del mismo título).
+- [ ] Asignar `_carta_id` a cada artículo con el endpoint de §1.5 (`fea/v1/carta-id/{id}`).
 - [ ] Componer la carta en HTML con los **encabezados exactos** de §5 y los enlaces a esos artículos.
- [ ] Publicar o programar la carta en la categoría **6**.
- [ ] Rotar la carta anterior: 6 → 22, y la de 22 → 21.
+- [ ] Publicar o programar la carta en las categorías **6 y 21** (§3.1, §4 Paso 3).
+- [ ] Rotar la carta anterior: quitar 6, poner 22 (conservando su 21). A la que estaba en 22,
+      quitarle solo la 22 (conservando su 21 — nunca se quita la 21 a nadie, §4 Paso 4).
 - [ ] Comprobar que la portada muestra las secciones (esperar hasta 15 min si hace falta).
- [ ] No traducir ni generar audio: lo hace el servidor.
+- [ ] No traducir ni generar audio a mano — pero SÍ pedirlo a Hermes (WhatsApp/Telegram, ver §7 y `docs/guia-tts-traduccion-inma.md`). No es automático todavía.

 ---

@@ -314,6 +403,9 @@ el resto. Si una carta urgente necesita traducción inmediata, avisar a Rafa.
 | Editar artículo/carta | `POST /wp-json/wp/v2/posts/{id}` |
 | Ver carta vigente | `GET /wp-json/wp/v2/posts?categories=6` |
 | Subir imagen | `POST /wp-json/wp/v2/media` (cabecera `Content-Disposition`) |
+| Leer `_carta_id` de un artículo | `GET /wp-json/fea/v1/carta-id/{id}` |
+| Asignar `_carta_id` a un artículo | `POST /wp-json/fea/v1/carta-id/{id}` con body `{"carta_id": N}` |
+| Borrar `_carta_id` de un artículo | `DELETE /wp-json/fea/v1/carta-id/{id}` |

 Campos útiles del post: `title`, `content` (HTML), `status` (`draft`/`publish`/`future`),
 `date` (ISO 8601 para programar), `categories` (array de IDs), `featured_media` (ID de adjunto).