Actualización de artefactos y código - SebaUSM/GRUPO02-2025-PROYINF GitHub Wiki
1. Introducción
Esta sección documenta la actualización realizada al sistema para integrar una funcionalidad de búsqueda semántica en los boletines PDF. El cambio introduce el uso de la API de OpenAI para extraer y filtrar información relevante a partir del contenido textual del boletín, y mostrar fragmentos clave en base a palabras clave.
No se han realizado modificaciones estructurales en los artefactos del sistema, ya que la funcionalidad agregada se integró de forma coherente con el diseño previamente establecido.
2. Cambios realizados
Cambio 1: Incorporación de búsqueda semántica en PDF
- Archivo modificado:
api.js - Líneas afectadas: Se agregó una nueva función y se integró al endpoint correspondiente.
- Motivación del cambio:
Mejorar la usabilidad del sistema al permitir identificar contenido importante dentro del boletín sin leerlo completamente. Esta necesidad surgió durante pruebas internas y análisis de necesidades de usuarios. - Detalle del cambio:
- Se extrae el texto desde archivos PDF.
- Se envía el texto y una consulta a la API de OpenAI.
- Se reciben fragmentos relevantes sobre ciertas palabras clave.
- El resultado se muestra en la interfaz del sistema o en consola.
- Impacto:
Mejora significativa en la experiencia de usuario, facilitando la exploración del boletín de forma rápida e inteligente. No se afectó la estructura general del sistema.
3. Rationale general
La decisión de integrar la API de OpenAI se basó en su capacidad para procesar lenguaje natural y entregar respuestas contextualizadas. Esto se alinea con los objetivos del sistema y con atributos de calidad como:
- Usabilidad: permite a los usuarios encontrar contenido relevante sin esfuerzo.
- Eficiencia: reduce el tiempo necesario para obtener información útil.
- Extensibilidad: abre la puerta a futuras mejoras como búsqueda por voz o recomendaciones inteligentes.
4. Artefactos del sistema (Diagrama de contexto y Modelo de dominio)
- Estado: Sin cambios.
- Justificación:
La funcionalidad implementada no alteró el flujo de actores, entidades ni procesos principales. Por tanto, el modelo de dominio, el diagrama de contexto y los demás artefactos previamente definidos siguen siendo vigentes y consistentes con el sistema actual.
5. Evidencia de versionamiento
Se actualizó el código trabajado según lo nuevos requisitos.
6. Conclusión
La actualización del código representa una mejora funcional clave, sin requerir ajustes en la estructura del sistema. Se mantiene la coherencia del diseño general y se documenta esta mejora como parte del avance del proyecto en este hito.