fmorondo.github.io

Repositorio de frontends estaticos para utilidades internas de Diario de Navarra y proyectos relacionados. La mayor parte del codigo son paginas HTML autocontenidas; los dos servicios de PDF mas recientes estan hechos con React + Vite y se publican en subcarpetas.

Vision general

• index.html es la portada general y agrupa las herramientas por flujo de trabajo.
• redaccion.html y herramientaskoldo.html actuan como portales de acceso rapido.
• Hay dos familias de servicios:
  • Frontends 100% cliente: procesan texto, imagen o PDF en el navegador y no envian datos a terceros.
  • Frontends con backend: delegan trabajo en servicios Cloud Run para RAG, transcripcion, descarga de audio o carga a vector store.
• Los estilos compartidos viven en styles.css.
• lib/pdf.min.js y lib/pdf.worker.min.js se usan en la herramienta de portada para rasterizar PDF en cliente.

Mapa documental

Portales

• Portal de redaccion
• Herramientas Koldo

Asistentes y buscadores

• KoldoGPT
• Osasuna chat
• Osasuna prensa
• Asesor de cumplimiento

Transcripcion y audio

• Transcripciones
• Transcripciones (servicio antiguo, retirada prevista)
• Descargar audio
• Descargar video
• Descarga Parlamento de Navarra

Edicion y publicacion

• Conversor de comillas
• Teletipos a Xalok
• Teletipos a Xalok nuevo
• Generador UTM
• Descarga de noticias por Tag ID
• Subida CSV a vector store

Imagen y portada

• Compositor de fotos
• Ajuste vertical
• Portada para Twitter X

PDF

• PDF a JPG/PDF
• Fusionador PDF

Arquitectura del repositorio

Antes de crear un servicio nuevo, ver el criterio de decisión en docs/ARQUITECTURA.md: navegador primero, Cloud Run solo si hace falta, y OpenAI dentro de ese Cloud Run solo si la tarea requiere lenguaje/embeddings.

• HTML estatico en raiz:
  • Cada pagina tiene su propio script inline o un JS dedicado.
  • La publicacion es trivial: copiar archivos a hosting estatico.
• Microfrontends con Vite:
  • pdf-merger/
  • pdf-to-jpg/
  • Ambos usan base configurada para publicarse en subruta.
• Dependencias externas de frontend:
  • Google Fonts en la mayoria de paginas.
  • marked + DOMPurify en los chats RAG.
  • pdfjs-dist, pdf-lib y jszip en herramientas PDF.

Convenciones usadas en la documentacion

Cada README de docs/ responde a estas preguntas:

• Que problema resuelve el frontend.
• Si procesa datos localmente o los envia a backend.
• Cual es el flujo de usuario y la salida esperada.
• Que archivos implementan el servicio.
• Que integraciones, dependencias o limites operativos hay que conocer.

Quedan fuera de esta capa documental los servicios enlazados pero no versionados aqui, como GPTs externos o monitores alojados en otros dominios.

Observaciones de mantenimiento

• El repositorio mezcla codigo fuente y artefactos compilados, especialmente en pdf-to-jpg/.
• Algunas herramientas muestran fechas o mensajes de estado escritos a mano en la UI; conviene revisarlos periodicamente.
• Varias paginas dependen de endpoints de Cloud Run hardcodeados. Si cambian, hay que actualizar el frontend manualmente.