From 2dad4a01972cd8fbb67ea51dbb0a97fd89ed87b3 Mon Sep 17 00:00:00 2001 From: mgonzalez Date: Fri, 5 Jun 2026 13:48:21 -0500 Subject: [PATCH] =?UTF-8?q?docs:=20v1.0.1=20=E2=80=94=20ajustar=20MDs=20a?= =?UTF-8?q?=20estado=20real=20del=20proyecto=20(WP=207.0,=20producci=C3=B3?= =?UTF-8?q?n=20.3,=20symlinks=20relativos,=20favicon,=20changelog)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 12 +++++++++++ PROMPT_IA.md | 56 +++++++++++++++++++++++++++++----------------------- README.md | 22 +++++++++++++++------ VERSION | 2 +- 4 files changed, 60 insertions(+), 32 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e336ee8..80d76ab 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,18 @@ Formato: `X.Y.Z` según `VERSIONADO.md` --- +## [1.0.1] — 2026-06-05 + +### Correcciones post-deploy a producción + +- **Servicio PHP en `0.0.0.0`** — cambiado de `127.0.0.1` a `0.0.0.0:8081` para que NPM pueda alcanzarlo desde fuera del loopback. +- **Symlinks con ruta relativa** — `persona-cv`, `lumina` y `cvolio` en `wp-content/themes/` ahora usan `../../../../frontend/...` en vez de rutas absolutas del equipo de desarrollo; funcionan en cualquier servidor. +- **favicon.ico circular** — generado desde la foto de Patricia con ImageMagick, 16/32/48 px, alpha=0 en esquinas (círculo real sin fondo cuadrado). +- **NPM Cache Assets** — documentado el comportamiento de cachéo de errores 502/404 y su solución (toggle off/on). +- **`.gitignore`** — añadido `upgrade-temp-backup/` generado por WordPress. + +--- + ## [1.0.0] — 2026-06-05 ### Lanzamiento inicial completo diff --git a/PROMPT_IA.md b/PROMPT_IA.md index 70dce99..4aac8c2 100644 --- a/PROMPT_IA.md +++ b/PROMPT_IA.md @@ -23,51 +23,57 @@ Sitio web personal de **hoja de vida / currículum ejecutivo** de **Patricia Sol pflores.linkedcorp.net/ ├── backend/ │ ├── start-wordpress.sh # Arrancar el servidor PHP -│ └── wordpress/ # Instalación WordPress +│ └── wordpress/ # Instalación WordPress 7.0 │ ├── wp-config.php # Config dinámica (URL, auto-updates OFF) +│ ├── favicon.ico # Foto de Patricia, circular, 16/32/48px │ └── wp-content/ │ ├── plugins/ │ │ ├── cmb2/ # CMB2 — campos personalizados (GRATIS) +│ │ ├── wp-mail-smtp/ # Email SMTP (pendiente config) │ │ └── pflores-cv-fields/ │ │ ├── pflores-cv-fields.php # Menú admin + campos CMB2 │ │ ├── pdf-generator.php # Generador PDF con Chromium │ │ └── populate-data.php # Sembrador inicial (ejecutar 1 vez) │ └── themes/ -│ ├── persona-cv/ # ACTIVO — Personage-style, rojo, timeline central -│ ├── apex-cv/ # Dark, cian, sidebar fijo izquierdo -│ ├── lumina -> ../../frontend/lumina-cv-theme # symlink -│ ├── cvolio -> ../../frontend/cvfolio-theme # symlink -│ └── ... +│ ├── apex-cv/ # Directorio REAL — Dark, cian, sidebar fijo +│ ├── persona-cv -> ../../../../frontend/persona-cv-theme # symlink relativo +│ ├── lumina -> ../../../../frontend/lumina-cv-theme # symlink relativo +│ └── cvolio -> ../../../../frontend/cvfolio-theme # symlink relativo ├── frontend/ -│ ├── persona-cv-theme/ # Fuente del tema activo (usa symlink persona-cv) -│ │ ├── style.css # Solo cabecera del tema -│ │ ├── functions.php # Setup, enqueue, helpers -│ │ ├── header.php # Header con nav y botón PDF +│ ├── persona-cv-theme/ # ACTIVO — Personage-style, rojo, Raleway +│ │ ├── style.css +│ │ ├── functions.php +│ │ ├── header.php # Nav + botón "Descargar CV PDF" │ │ ├── footer.php -│ │ ├── front-page.php # PLANTILLA PRINCIPAL — toda la página CV -│ │ ├── index.php # Fallback -│ │ ├── assets/css/theme.css # Estilos completos -│ │ ├── assets/js/theme.js # JS (nav, scroll spy, animaciones) +│ │ ├── front-page.php # Plantilla principal del CV +│ │ ├── index.php +│ │ ├── assets/css/theme.css +│ │ ├── assets/js/theme.js │ │ ├── assets/images/ # patricia-flores-profile.jpeg, qr.png │ │ ├── assets/docs/ # CV_Patricia_Flores_Sanchez_ES_FINAL.docx │ │ └── inc/ │ │ ├── cv-data.php # Fallback hardcodeado (función persona_cv_data()) -│ │ ├── customizer.php # Campos Customizer (mínimos) -│ │ └── visits.php # Contador de visitas -│ ├── lumina-cv-theme/ # Tema claro teal+ámbar, sidebar izquierdo -│ ├── cvfolio-theme/ # Tema oscuro glassmorphism (original) -│ └── apex-cv-theme/ # OBSOLETO — usar wp-content/themes/apex-cv +│ │ ├── customizer.php +│ │ └── visits.php +│ ├── lumina-cv-theme/ # Claro, teal+ámbar, sidebar izquierdo +│ └── cvfolio-theme/ # Oscuro, glassmorphism original +├── otros/ # Archivos de referencia (foto, QR, docx original) ├── docs/ │ └── instalacion-wordpress.md -├── .env # Variables de entorno (DB, puerto, etc.) +├── .env # Local, no versionado +├── .env.example +├── VERSION +├── CHANGELOG.md +├── VERSIONADO.md +├── PRODUCCION.md +├── DEPLOY_WEB.md ├── PROMPT_IA.md # ESTE ARCHIVO └── README.md ``` -> **NOTA IMPORTANTE:** El tema `apex-cv` vive directamente en -> `backend/wordpress/wp-content/themes/apex-cv/` (directorio real, no symlink) -> porque el directorio `frontend/apex-cv-theme/` tiene un problema de persistencia. -> Los demás temas activos usan symlinks desde `wp-content/themes/` hacia `frontend/`. +> **Temas:** `apex-cv` vive en `wp-content/themes/apex-cv/` como directorio real (no symlink). +> Los otros 3 temas usan **symlinks con ruta relativa** (`../../../../frontend/...`) +> para funcionar tanto en desarrollo como en producción sin cambios. --- @@ -664,7 +670,7 @@ php -l /ruta/al/tema/functions.php | CMB2 / plugin no carga | Serialización incorrecta en `active_plugins` | Regenerar con `php -r "echo serialize([...]);"` | | `pflores_get_cv_data()` retorna vacío | Datos no guardados en BD | Re-ejecutar `populate-data.php?key=pflores2024` + limpiar caché | | Apex-cv vacío o sin archivos | Tema apex-cv depende de directorio real, no symlink | Los archivos van en `wp-content/themes/apex-cv/`, no en `frontend/` | -| CSS/JS con 404 tras clonar en servidor nuevo | Symlinks de temas usan ruta absoluta del equipo de dev | Recrear symlinks con ruta absoluta del servidor real (ver `PRODUCCION.md` → Problemas conocidos) | +| CSS/JS con 404 tras clonar en servidor nuevo | Symlinks corruptos o rotos | Los symlinks en git usan **ruta relativa** (`../../../../frontend/...`) — si están rotos, ver `PRODUCCION.md` → Problemas conocidos | | 502 persistente en favicon u otros estáticos tras haberlo corregido | NPM **Cache Assets** cachéo la respuesta 502/404 anterior | En NPM: desactivar Cache Assets → guardar → reactivar → guardar. Para CV puede quedar desactivado. | | PDF vacío o error 500 | Chromium no encontrado o falla | `which chromium chromium-browser google-chrome` | | `update_option` no guarda | Caché de WordPress | Limpiar transients (ver sección 17) | diff --git a/README.md b/README.md index 6227325..82aaf41 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,14 @@ Sitio web de currículum ejecutivo de **Patricia Soledad Flores Sánchez** — G ## Stack -- **CMS:** WordPress 6.x (PHP 8.4, servidor PHP integrado) -- **Base de datos:** MariaDB en `192.168.222.20` +- **CMS:** WordPress 7.0 (PHP 8.x, servidor PHP integrado) +- **BD desarrollo:** MariaDB en `192.168.222.20` +- **BD producción:** MariaDB en `192.168.222.32` - **Campos del CV:** CMB2 (100 % gratuito, GPL) - **PDF:** Chromium headless (`/?cv_pdf=1`) -- **Email:** WP Mail SMTP (configurable) -- **Deploy:** Debian 12 · Nginx Proxy Manager → `192.168.222.40:8081` -- **URL pública:** `https://pflores.linkedcorp.net` +- **Email:** WP Mail SMTP (pendiente configuración SMTP) +- **Servidor producción:** `192.168.222.3:8081` · Nginx Proxy Manager → `https://pflores.linkedcorp.net` +- **Servidor desarrollo:** `192.168.222.40:8081` ## Estructura @@ -24,14 +25,23 @@ pflores.linkedcorp.net/ │ ├── start-wordpress.sh │ └── wordpress/ │ ├── wp-config.php +│ ├── favicon.ico ← foto de Patricia, circular, 16/32/48px │ └── wp-content/ │ ├── plugins/pflores-cv-fields/ ← plugin propio: CMB2 + PDF -│ └── themes/apex-cv/ ← tema oscuro cian +│ └── themes/ +│ ├── apex-cv/ ← directorio real (tema oscuro cian) +│ ├── persona-cv → ../../../../frontend/persona-cv-theme +│ ├── lumina → ../../../../frontend/lumina-cv-theme +│ └── cvolio → ../../../../frontend/cvfolio-theme +├── otros/ ← archivos de referencia (foto, QR, docx original) ├── docs/ ├── .env ← local, no versionado ├── .env.example ├── VERSION ├── CHANGELOG.md +├── VERSIONADO.md +├── PRODUCCION.md +├── DEPLOY_WEB.md ├── PROMPT_IA.md ← guía completa para IA └── README.md ``` diff --git a/VERSION b/VERSION index 3eefcb9..7dea76e 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.0.0 +1.0.1