Guía de Interfaz SPA & Entorno de Escritorio Nativo
Esta guía explica la arquitectura, características y modo de uso de la interfaz de usuario SPA (Single-Page Application) y el lanzador de escritorio nativo con PyWebView introducidos en ThesisForge v0.5.0.
1. Visión General de la Interfaz Visual
ThesisForge incluye una interfaz web moderna, reactiva y ligera construida con Tailwind CSS y Alpine.js, servida directamente por el backend de FastAPI sin necesidad de cadenas de compilación complejas ni dependencias de Node.js.
┌─────────────────────────────────────────────────────────────┐
│ Ventana Nativa (PyWebView) │
│ │
│ ┌─────────────────────── SPA Monomando ─────────────────┐ │
│ │ [Dashboard] [Asesor] [RAG] [Redacción] [Word] [Jury] │ │
│ │ │ │
│ │ • Telemetría de Proyecto & Métricas en Vivo │ │
│ │ • Stepper Metodológico de 9 Pasos │ │
│ │ • Búsqueda Federada & Subida Directa de PDFs │ │
│ │ • Streaming por WebSockets en Redacción │ │
│ │ • Descarga Directa de Manuscrito APA 7 (.docx) │ │
│ │ • Deliberación de Tribunal Doctoral y Defensa Oral │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
2. Lanzamiento del Entorno de Escritorio
Comando CLI de Escritorio
Para abrir ThesisForge en una ventana nativa independiente de escritorio:
Opciones Avanzadas del Lanzador
# Especificar puerto fijo o interfaz de red
thesisforge gui --port 8080 --host 127.0.0.1
# Habilitar herramientas de inspección y desarrollo (DevTools)
thesisforge gui --debug
Cómo Funciona Internamente el Lanzador
- Descubrimiento Dinámico de Puerto: El módulo
thesisforge.desktop.launcherbusca un puerto TCP libre en127.0.0.1si se especifica el puerto0(comportamiento por defecto). - Servidor en Hilo Daemon: Inicia la API de FastAPI / Uvicorn en un subproceso en segundo plano.
- Sondeo de Salud Asíncrono: Verifica la disponibilidad del endpoint
/healthantes de renderizar la ventana. - Contenedor PyWebView: Abre una ventana nativa del sistema operativo (usando WebView2 en Windows, WebKit2GTK en Linux o WebKit en macOS).
3. Módulos y Vistas de la SPA
A. Portafolio & Dashboard (gui/js/dashboard.js)
- Gestión centralizada de proyectos con tarjetas informativas.
- Indicadores de estado de avance, número de palabras redactadas y fuentes bibliográficas validadas.
- Creación rápida de proyectos con asignación de título, nivel académico (Pregrado, Maestría, Doctorado) y área de estudio.
B. Asesor Metodológico (gui/js/advisor.js)
- Flujo secuencial guiado por la máquina de estados finita.
- Validación interactiva de verbos taxonómicos en objetivos e hipótesis.
- Ficha de consistencia metodológica con aprobación formal.
C. Literatura & RAG Científico (gui/js/literature.js)
- Búsqueda académica federada en tiempo real en Semantic Scholar, ArXiv y CrossRef.
- Subida directa de archivos PDF e indexación vectorial automática en ChromaDB con extracción PyMuPDF.
- Validador de afirmaciones científicas (Citation Guard) para verificar respaldo probatorio contra la literatura indexada.
D. Redacción Capitular por Streaming (gui/js/drafting.js)
- Navegación interactiva por el esquema de 5 capítulos y 19 secciones temáticas.
- Generación con streaming en tiempo real mediante WebSockets (
ws://localhost:8000/api/drafting/ws/...). - Higiene estricta de conexiones: desconexión automática y nulificación de sockets al cambiar de sección para prevenir fugas de memoria.
- Aprobación de secciones con síntesis automática en la memoria jerárquica de 4 capas.
E. Compilación y Descarga APA 7 (gui/js/export.js)
- Formulario de metadatos institucionales (autor, afiliación, asesor, año).
- Opciones editoriales: inclusión de portada, tabla de contenidos (TOC) y referencias desduplicadas.
- Compilación y descarga directa del archivo
.docxformateado con márgenes de 2.54 cm, tipografía formal y sangría francesa.
F. Tribunal Multi-Agente & Sustentación Oral (gui/js/jury.js, gui/js/defense.js)
- Evaluación simultánea por los 4 jurados académicos doctorales.
- Rúbrica dimensional cuantitativa (0–100) y veredicto oficial.
- Simulador de sustentación socrática por turnos con retroalimentación inmediata.
G. Ajustes BYOK, Selección de Modelos y Seguridad (gui/js/settings.js)
- Modal para configurar claves de API de proveedores LLM (Google Gemini, OpenRouter, OpenAI, Groq, Anthropic) o servidor local Ollama (
http://localhost:11434). - Catálogo de Modelos Curado: Selección explícita entre modelos de Nivel Gratuito (Free Tier, ej.
gemini-2.5-flash,deepseek/deepseek-chat:free) y Nivel Superior (Superior Tier, ej.gemini-2.5-pro,anthropic/claude-3.5-sonnet,llama-3.3-70b-versatile). - Botón "Probar Conexión": Diagnóstico en vivo que envía una petición mínima de verificación (
POST /api/settings/test-connection) para comprobar la validez de la clave y medir la latencia antes de persistir. - Las credenciales se almacenan cifradas localmente con una clave Fernet de 256 bits (
LocalKeyVault).