How hilanalegria/automatizacion-ia-gestion-proyectos-ti works
Identificación del tipo de proyecto y su propósito
• El proyecto “SinergIA” es una aplicación full-stack orientada a la automatización de la Gestión de Proyectos TI mediante IA y la integración con JIRA.
• Backend en Python (FastAPI) expone endpoints para IA y JIRA.
• Frontend en Vue.js (SPA) provee interfaz de chat, visualización de métricas, selección de proyecto y login.
• Hay además un script suelto (rag_api_jira_colab_scrum.py) que orquesta un flujo RAG de IA–JIRA para pruebas o tareas batch.
Análisis de la estructura de archivos
• Top-level:
• rag_api_jira_colab_scrum.py (script independiente)
• sinergia-backend/ (FastAPI app)
– app/dependencies.py
– app/routers/ia.py
– app/routers/jira.py
– main.py
– config.txt (credenciales, endpoints)
• sinergia-frontend/ (Vue.js SPA)
– public/index.html
– src/
• components/ (botones, inputs, chat, layout, UI cards, IA sources)
• router/ (Vue Router)
• services/apiService.js (axios hacia backend)
• stores/ (Pinia stores: auth, chat, project)
• views/ (páginas: login, dashboard, chat IA Scrum/XP, reports)
– babel.config.js, vue.config.js, package.json
Insights del README
• Es un proyecto universitario con metodología PMBOK + SDLC + IA.
• Objetivo: generar chat interfaces con IA que analicen datos de JIRA y generen reportes tomando como base metodologías ágiles e híbridas.
Componentes principales para el diagrama
a. Usuario (navegador)
b. Frontend (Vue.js SPA)
c. Backend (FastAPI monolítico con dos routers lógicos: IA y JIRA)
d. Script RAG batch (rag_api_jira_colab_scrum.py)
e. Servicios externos:
• JIRA Cloud API
• Servicio de IA (OpenAI, Azure OpenAI u otro)
f. (Opcional) Cache / Base de datos / Almacenamiento de sesiones si aplica
Relaciones e interacciones
• El Usuario ↔ Frontend via HTTPS
• Frontend ↔ Backend (axios REST calls)
• /ia → router IA
• /jira → router JIRA
• Backend ↔ JIRA Cloud API (HTTP requests autenticados)
• Backend ↔ Servicio IA (HTTP/gRPC)
• Script RAG ↔ JIRA API y Servicio IA para procesamiento batch
Patrones y principios arquitectónicos
• Monolito modular (FastAPI con routers separados para dominios IA y JIRA)
• SPA desacoplada (Capa de presentación aislada)
• API-First (todos los flujos IA y JIRA expuestos vía REST endpoints)
• MVVM en frontend (Vue components + Pinia stores + Vue Router)
• Posible patrón RAG (Retrieval-Augmented Generation) en script
Tecnologías clave
• Python 3.x, FastAPI, Uvicorn (o similar)
• Vue.js 3, Vue Router, Pinia, axios
• JIRA REST API
• OpenAI API (u otro proveedor IA)
• JSON para assets y data mock en frontend
Guía para diseñar el diagrama
1. Dibujar cajas para:
• Web Browser (Vue SPA)
• FastAPI App (IA Router + JIRA Router)
• Batch Script (RAG orchestration)
• Servicios externos (JIRA API, IA API)
2. Conectar con flechas dirigidas que indiquen sentido de llamada/datos:
• Usuario → SPA → Backend → (JIRA / IA)
• Script → (JIRA / IA)
3. Etiquetar cada flecha con el protocolo (HTTPS/REST/JSON)
• Azul para componentes front-end
• Verde para backend/routers
• Naranja para servicios externos
• Gris para scripts batch
5. Formas:
• Rectángulos redondeados para aplicaciones web
• Rectángulos normales para servicios backend
• Nubes para APIs externas
Consejos de refinamiento
• Añadir notas de configuración (config.txt en el backend)
• Incluir leyenda de colores y formas
• Mostrar los stores (Pinia) como subcomponentes del SPA si se requiere nivel de detalle
• Si se incorpora base de datos o cache futura, dibujarla junto al backend
Elementos imprescindibles en el diagrama final
• Etiquetas claras (p. ej. “FastAPI/IA Router”)
• Flechas direccionales con anotaciones (p. ej. “POST /ia/chat → JSON”)
• Leyenda que explique colores, protocolos y acrónimos
Con esta guía, el diagrama de sistemas reflejará con precisión la arquitectura de “SinergIA”, mostrando separación de responsabilidades, flujos de datos y componentes externos críticos.