🛠️ Diseño del Módulo de Soporte al Usuario
Documento técnico de arquitectura — Nivel Desarrollador
Versión: 3.0 | Fecha: 08 de junio de 2026
Nivel: Desarrollador (N6)
URL pública actual: aeroidea.net/soporte2/
Plataforma actual: WordPress 6.x + BetterDocs Pro
1. Niveles de este Módulo
El Módulo de Soporte al Usuario, como todo módulo del Ecosistema ERP de IDEA, se documenta en niveles de profundidad según la audiencia:
| Nivel | Audiencia | ¿Qué documenta? | Ubicación |
|---|---|---|---|
| N1-N4 | Usuarios finales (alumnos, pilotos, clientes) | Los artículos publicados que el usuario lee directamente en el Centro de Soporte (soporte2.aeroidea.net) | Centro de Soporte público |
| N5 | Coordinadores y administradores | Procedimientos de gestión de trámites, flujos de trabajo del equipo de soporte, instructivos operativos | Producción (este manual) |
| N6 — Este documento | Desarrolladores y arquitectos | Arquitectura técnica completa del módulo: estructura de bases de conocimiento, configuración de plugins, API, chatbot IA, categorías internas, paleta de diseño y stack tecnológico | Producción (este manual) |
Todo lo que contiene este artículo es información de Nivel Desarrollador (N6). Describe la estructura interna, los IDs de categorías, la configuración del chatbot y los endpoints de API que un desarrollador necesita para mantener, extender o migrar el Centro de Soporte.
2. Visión Pre-ERP vs. ERP
El Centro de Soporte que se describe en este documento es la versión Pre-ERP: la implementación actual que opera sobre WordPress + BetterDocs Pro en el subdominio aeroidea.net/soporte2/.
| Aspecto | Versión Pre-ERP (Actual) | Versión ERP (Futura) |
|---|---|---|
| Plataforma | WordPress + BetterDocs Pro | Ecosistema ERP (Supabase + Frontend propio) |
| URL | aeroidea.net/soporte2/ | Por definir dentro del ERP |
| Contenido | 571 artículos en 5 bases de conocimiento | Migración completa del contenido actual |
| IA | BetterDocs AI (OpenAI GPT-4o) | Agente propio del ecosistema ERP |
| Datos | Base de datos WordPress (MySQL) | Supabase (PostgreSQL relacional) |
Principio rector: La versión ERP será esencialmente una copia funcional de lo que existe hoy. Toda la estructura de secciones, categorías, artículos, chatbot e identidad visual que se documenta aquí será replicada y mejorada dentro del Ecosistema ERP. Este documento sirve como el blueprint de referencia para esa migración.
3. Concepto General del Centro de Soporte
El Centro de Soporte es una interfaz web autoservicio que centraliza toda la información que un alumno, representante, piloto o cliente necesita consultar. No es un simple blog de artículos, sino un sistema de base de conocimiento estructurada con múltiples bases independientes, búsqueda inteligente, chatbot con IA y navegación por pestañas que segmenta la audiencia y el tipo de contenido.
4. Anatomía de la Interfaz
La interfaz se compone de 4 zonas visuales que el usuario percibe al ingresar:
- Barra de navegación superior (Accesos Directos): Header fijo con enlaces a los sistemas críticos del ecosistema: Portal Académico, Reporte de Pago, MIP, Catálogo de Productos y Expediente Digital. Se gestiona desde
Apariencia → Menúsen el panel de administración. - Barra de búsqueda: Campo de texto prominente con búsqueda en vivo (Live Search) que filtra todos los artículos de todas las bases de conocimiento en tiempo real.
- Pestañas + Grid de categorías: 5 botones horizontales que representan las 5 bases de conocimiento. Al activar una pestaña, se despliega un layout masonry de 4 columnas con las categorías y artículos correspondientes.
- Chatbot flotante (esquina inferior derecha): Ícono circular verde (
#00b682) con el logo de IDEA que despliega un panel de chat con IA (GPT-4o).
5. Las 5 Secciones Principales
El contenido del Centro de Soporte está organizado en 5 bases de conocimiento independientes (pestañas), cada una orientada a una audiencia distinta:
| # | Pestaña | Slug | Arts | Audiencia |
|---|---|---|---|---|
| 1 | Términos y Condiciones | tyc | 137 | Alumnos y representantes |
| 2 | Manual del Usuario | manual-del-usuario | 84 | Alumnos activos |
| 3 | Zona de Pilotos | manual-del-piloto | 221 | Estudiantes de aviación |
| 4 | Información General | preguntas-frecuentes | 126 | Público general |
| 5 | Aerotienda | aerotienda | 3 | Compradores |
| TOTAL | 571 |
El desglose detallado de categorías internas, Cat IDs y estado de auditoría de cada sección se encuentra en el instructivo «Estructura de la Base de Conocimientos (Asignación Departamental)», disponible en esta misma categoría del módulo. Este documento no duplica esa información.
6. Chatbot e Inteligencia Artificial
El Centro de Soporte cuenta con dos capas de asistencia inteligente integradas por el plugin BetterDocs Pro:
Capa 1: Chatbot IA (esquina inferior derecha)
| Parámetro | Valor |
|---|---|
| Proveedor / Modelo | OpenAI GPT-4o |
| Embeddings | text-embedding-3-large |
| Contenido indexado | post, page, docs, betterdocs_faq |
| Max tokens | 15,000 |
| Mensaje de bienvenida | Hola, bienvenido a Soporte 👋 Estás hablando con un agente de IA. |
| Color launcher | #00b682 (verde) — Logo IDEA como ícono |
| Email contacto | admin@aeroidea.net |
Pipeline técnico (RAG): Cuando el usuario escribe una pregunta, BetterDocs genera embeddings con text-embedding-3-large, busca artículos por similitud vectorial y pasa el contexto a GPT-4o para generar una respuesta conversacional basada exclusivamente en la base de conocimiento.
Capa 2: Instant Answers (Widget de Ayuda)
| Pestaña | Función |
|---|---|
| 🏠 Inicio | Búsqueda en artículos + FAQ |
| 💬 Pregunta | Chat IA con GPT-4o |
| 📚 Recursos | Navegación por categorías, subcategorías y FAQ |
Visible en todas las páginas (singles, archives, pages, taxonomías). Reacciones (útil/no útil) y upload de archivos habilitados. Branding BetterDocs desactivado.
7. Configuración Técnica de BetterDocs
| Parámetro | Valor |
|---|---|
| Stack | WordPress 6.x + BetterDocs Pro + Twenty Twenty-Five + Inter (Google Fonts) |
| Multiple KB | ✅ 5 bases activas |
| Búsqueda | ✅ Live Search + Avanzada |
| Layout | Masonry, 4 columnas, 9 posts/categoría |
| Single Doc | TOC sticky (H1-H6), breadcrumbs, nav anterior/siguiente, sidebar, tags, tiempo lectura, imprimir, docs relacionados |
| Feedback | ✅ Shortcode [betterdocs_feedback_form] → admin@aeroidea.net |
| Permalinks | Docs: docs/ | Categoría: docs-category | Tag: docs-tag |
8. Diseño Premium — Identidad Visual
Paleta de colores de marca
| Color | Hex | Uso |
|---|---|---|
| 🔵 Celeste IDEA | #00b5dd | Botones, pasos, links |
| 🔷 Azul IDEA | #0170B9 | Headers, callouts info |
| ⬛ Dark Navy | #1e1f26 | Gradiente de headers |
| 🟢 Verde | #f0fdf4 / #15803d | Cards positivas |
| 🔴 Rojo | #fef2f2 / #dc2626 | Cards negativas |
| 🟡 Amarillo | #fef3c7 / #f59e0b | Alertas y advertencias |
Indicador de rediseño: Un artículo tiene diseño Premium si su contenido contiene linear-gradient(135deg
Progreso del rediseño visual
| Categoría | Total | Rediseñados | % |
|---|---|---|---|
| Trámites (75) | 21 | 21 | ✅ 100% |
| Preguntas Frecuentes (182) | 59 | 59 | ✅ 100% |
| Soporte General (90) | 61 | 61 | ✅ 100% |
| T&C Administrativas (41) | 26 | 6 | 🔄 23% |
| Resto | ~404 | 0 | ⬜ 0% |
| TOTAL | 571 | 147 | 26% |
9. API y Acceso Programático
| Endpoint | URL |
|---|---|
| Docs (CRUD) | aeroidea.net/soporte2/index.php/wp-json/wp/v2/docs |
| Categorías | aeroidea.net/soporte2/index.php/wp-json/wp/v2/doc_category |
| Knowledge Bases | aeroidea.net/soporte2/index.php/wp-json/wp/v2/knowledge_base |
| Settings | aeroidea.net/soporte2/index.php/wp-json/betterdocs/v1/settings |
Autenticación: Basic Auth con Application Password de WordPress
