Files

T

Mireya Cueto Garrido ca6d370585 Fix production base path and ProxyPass docs for /generadorexamenesllm.

This removes the incorrect /deckofcars prefix, aligns CI/build defaults with the real public URL, and adds an Apache ProxyPass snippet so the request is routed to the Docker frontend instead of the Sinbad2 site.

2026-06-02 13:26:34 +02:00

3.1 KiB

Raw Blame History

GenExámenes IA — Frontend

Interfaz web en React + Vite para el generador de exámenes con IA. Consume la API del backend (FastAPI) y cubre todo el flujo: autenticación, plantillas, material de contexto, imágenes, generación con IA, gestión de preguntas y exportación a Moodle.

Stack

React 18 + React Router 6
Vite 5 (build y dev server)
Axios con interceptores para el token JWT y el manejo unificado de errores HTTP

Estructura

src/
  api/         Cliente axios y un módulo por recurso (auth, templates, materials, images, ...)
  components/  Componentes reutilizables (UI, layout, AuthImage, QuestionCard, ...)
  context/     AuthContext (sesión) y ToastContext (notificaciones)
  hooks/       useGoogleSignIn (login con Google opcional)
  pages/       Páginas y pestañas del detalle de plantilla
  utils/       Constantes y formateadores

Desarrollo local

Requisitos: Node 20+ y el backend corriendo en http://sinbad2.ujaen.es:8074.

cd frontend
cp .env.example .env      # ajusta VITE_API_URL si es necesario
npm install
npm run dev               # http://sinbad2.ujaen.es:8075

Variables de entorno

Variable	Descripción
`VITE_APP_BASE_PATH`	Base pública de la SPA (debe terminar en `/`). En producción UJA: `/generadorexamenesllm/`.
`VITE_API_URL`	URL base de la API. Si se deja vacía, usa la misma base pública de la app.
`VITE_GOOGLE_CLIENT_ID`	(Opcional) Client ID de Google. Si está vacío, se oculta el botón de Google.

Las variables VITE_* se incrustan en el build, por lo que apuntan al backend tal y como lo verá el navegador del usuario.

Build de producción

npm run build     # genera dist/
npm run preview   # sirve el build localmente

Docker

El docker-compose.yml de la raíz construye el frontend con un build multi-stage (Node → Nginx) y lo publica en http://sinbad2.ujaen.es:8075:

docker compose up --build

Las variables VITE_APP_BASE_PATH, VITE_API_URL y VITE_GOOGLE_CLIENT_ID pueden pasarse como variables de entorno al ejecutar docker compose.

Despliegue HTTPS en subruta (Sinbad2)

La app no va bajo /deckofcars/ (eso es otro sitio). La URL pública es:

https://sinbad2.ujaen.es/generadorexamenesllm/

En Apache del servidor deben existir estas líneas (el prefijo se quita al llegar al contenedor en el puerto 8075):

ProxyPass        /generadorexamenesllm  http://host.docker.internal:8075/
ProxyPassReverse /generadorexamenesllm  http://host.docker.internal:8075/

Build:

VITE_APP_BASE_PATH=/generadorexamenesllm/
VITE_API_URL=

Si Apache no tiene ese ProxyPass, el navegador verá la web principal de Sinbad2 en lugar de esta app.

Manejo de errores

Todas las respuestas de error del backend siguen el formato { "error": { "code", "message", "details" } }. El interceptor de Axios las normaliza a una ApiError y la UI las muestra mediante toasts. Un 401 global cierra la sesión automáticamente.

3.1 KiB Raw Blame History