# Índice de documentación — Traductor Digixop Pro

Mapa de la documentación del repositorio (versión del plugin **2.0.11** y entorno de producción actual).  
El **README de distribución** del ZIP comercial está en inglés (`README.md` en la raíz del repositorio, copiado al ZIP por `build.sh`); esta carpeta **`docs/`** recoge el detalle operativo en español.

---

## Manuales (usuario y desarrollador)

| Documento | Formato | Contenido |
|-----------|---------|-----------|
| **[MANUAL-USUARIO-TRADUCTOR-DIGIXOP-PRO.md](./MANUAL-USUARIO-TRADUCTOR-DIGIXOP-PRO.md)** | Markdown | Manual de usuario: resumen en un minuto, flujos claros (DTL/BYO, saldo, memoria, web completa, menús, taxonomías, Elementor), FAQ y cierre. **Referencia principal** para clientes y soporte. |
| **[manual-digixop-translator-pro/manual-usuario.html](./manual-digixop-translator-pro/manual-usuario.html)** | HTML | Resumen en una página (lectura rápida, imprimible). |
| **[manual-digixop-translator-pro/manual-usuario-completo.html](./manual-digixop-translator-pro/manual-usuario-completo.html)** | HTML | **Mismo nivel de detalle que el Markdown**, FAQ completa palabra por palabra (página larga). |
| **[MANUAL-DESARROLLADOR-TRADUCTOR-DIGIXOP-PRO.md](./MANUAL-DESARROLLADOR-TRADUCTOR-DIGIXOP-PRO.md)** | Markdown | Integración técnica **sin secretos**: arquitectura, opciones, constantes, BYO (Google Cloud), contrato DTL, AJAX, filtros, empaquetado. |
| **[manual-digixop-translator-pro/manual-desarrollador.html](./manual-digixop-translator-pro/manual-desarrollador.html)** | HTML | Resumen del manual de desarrollador con aviso de seguridad. |

> El HTML legacy **[manual-digixop-translator-pro/index.html](./manual-digixop-translator-pro/index.html)** (Reveal.js) se mantiene como archivo antiguo; las versiones actuales son los enlaces de la tabla anterior.

---

## Documentación técnica y de producto

| Documento | Contenido |
|-----------|-----------|
| **[README.md](../README.md)** (raíz) | Visión general del plugin (inglés), requisitos, memoria de traducción, glosario UI, progreso bulk, constantes, empaquetado y arquitectura. Va **dentro del ZIP** de venta. |
| **[CHANGELOG.md](../CHANGELOG.md)** | Historial de versiones y cambios relevantes. |
| **[TRADUCTOR-DIGIXOP-LITE.md](../TRADUCTOR-DIGIXOP-LITE.md)** | Aviso de archivo **histórico/legacy**; la referencia de usuario actual es el **manual** enlazado arriba + este índice + `README`. |

### Memoria de traducción (WordPress)

La caché vive **solo en la base de datos del sitio** (`{prefijo}dx_translations_cache`). No sustituye al proxy: reduce llamadas enviando a la API únicamente segmentos aún no guardados. Incluye:

- glosario UI editable (reglas `Origen -> Traducción`);
- invalidación selectiva por términos (sin vaciar toda la tabla);
- aprendizaje inverso de correcciones manuales en traducciones WPML.

Resumen en **[README.md](../README.md)**; contrato del proxy (campos que envía el plugin) en **[API-SAAS.md](./API-SAAS.md)**.

---

## Licencias, modos DTL/BYO y flujo WordPress

| Documento | Contenido |
|-----------|-----------|
| **[LICENCIAS.md](./LICENCIAS.md)** | Activación en WordPress vía API Digixop (`activate-license.php`), opciones guardadas, constantes, relación con el proxy y tabla `dx_licenses`. |
| **[COMO-FUNCIONA-LICENCIAS.md](./COMO-FUNCIONA-LICENCIAS.md)** | Flujo completo: licencia → `translation_mode` → proxy o Google BYO. |
| **[COMERCIALIZACION-PLUGIN.md](./COMERCIALIZACION-PLUGIN.md)** | Modelo comercial (ZIP oficial vs fork), URLs, empaquetado, checklist de publicación. |

---

## API del plugin y contrato del proxy

| Documento | Contenido |
|-----------|-----------|
| **[API-SAAS.md](./API-SAAS.md)** | Contrato HTTP del proxy DTL, payloads JSON (`google_format`, `system_prompt`), códigos de error, BYO Google v2; caché en WordPress (solo cliente). |
| **[SERVIDOR-API-DIGIXOP.md](./SERVIDOR-API-DIGIXOP.md)** | Despliegue en **api.digixop.com**: carpeta `dist-server/`, flujo de saldo, webhooks (Polar), esquema MySQL. |

---

## Calidad y pruebas

| Documento | Contenido |
|-----------|-----------|
| **[QA-CHECKLIST.md](./QA-CHECKLIST.md)** | Checklist previa a publicar una release del plugin. |
| **[PRUEBAS-2026-03-ELEMENTOR-DTL.md](./PRUEBAS-2026-03-ELEMENTOR-DTL.md)** | Bitácora de pruebas Elementor + DTL (referencia técnica). |
| **[SMOKE-TEST-PRODUCCION.md](./SMOKE-TEST-PRODUCCION.md)** | Runbook de validación en producción. |
| **[RELEASE-NOTES-v2.0.9.md](./RELEASE-NOTES-v2.0.9.md)** | Notas del corte billing Polar-native en servidor. |

---

## Código de ejemplo y referencia legacy

| Ubicación | Contenido |
|-----------|-----------|
| **[ejemplo-servidor-licencias/README.md](./ejemplo-servidor-licencias/README.md)** | Scripts de ejemplo (`license-api`, variantes de proxy, etc.). La **fuente de verdad para producción** en api.digixop.com es **`dist-server/`** (ver [SERVIDOR-API-DIGIXOP.md](./SERVIDOR-API-DIGIXOP.md)). |

---

## Material HTML legacy

| Recurso | Contenido |
|---------|-----------|
| **[manual-digixop-translator-pro/index.html](./manual-digixop-translator-pro/index.html)** | Presentación Reveal.js conservada como respaldo; el manual **actual** en Markdown es **[MANUAL-USUARIO-TRADUCTOR-DIGIXOP-PRO.md](./MANUAL-USUARIO-TRADUCTOR-DIGIXOP-PRO.md)**. |

---

## Carpetas del repositorio (no van en el ZIP del cliente)

| Carpeta / archivo | Uso |
|-------------------|-----|
| **`dist-server/`** | Archivos listos para desplegar en el servidor API (`translate-proxy.php`, `polar-webhook.php`, `activate-license.php`, `config.php`, `schema.sql`). |
| **`docs/`** | Documentación interna y guías (esta carpeta **no** se incluye en el ZIP generado por `build.sh`). |
| **`build.sh`** | Genera el ZIP comercial: copia **toda** la carpeta `includes/` (incl. `class-digixop-translation-cache.php`), más `assets/`, `languages/`, `traductor-digixop-pro.php`, `README.md`. |

---

## Constantes de producción (recordatorio)

- `DIGIXOP_SAAS_API_BASE` → `https://api.digixop.com` (endpoints en la raíz: `/translate`, etc.)
- `DIGIXOP_TDL_TRANSLATE_PROXY_URL` → `https://api.digixop.com/translate-proxy.php`
- `DIGIXOP_TDL_BUY_CREDITS_URL` → `https://digixop.com/plugin-traductor-pro/`

Definibles en `wp-config.php` si necesitas otro entorno o staging.