docs: v1.0.1 — ajustar MDs a estado real del proyecto (WP 7.0, producción .3, symlinks relativos, favicon, changelog)

This commit is contained in:
2026-06-05 13:48:21 -05:00
parent 2fc1db8c6c
commit 2dad4a0197
4 changed files with 60 additions and 32 deletions
+31 -25
View File
@@ -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) |