# hilanalegria/automatizacion-ia-gestion-proyectos-ti architecture

> Architecture diagram of the GitHub repository hilanalegria/automatizacion-ia-gestion-proyectos-ti, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti
- Repository: https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti

## Overview

##### 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.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    U["User (Browser)"]:::user

    %% Frontend Layer
    subgraph "Frontend SPA" 
        direction TB
        SPA(["Vue.js SPA"]):::frontend
        entryjs(["main.js"]):::frontend
        html(["index.html"]):::frontend
        router(["Vue Router\\nindex.js"]):::frontend
        apiSvc(["apiService.js"]):::frontend
        authStore(["authStore.js"]):::frontend
        chatStore(["chatStore.js"]):::frontend
        projectStore(["projectStore.js"]):::frontend
    end

    %% Backend Layer
    subgraph "Backend FastAPI App"
        direction TB
        mainApp(["main.py"]):::backend
        cfg(["config.txt"]):::backend
        deps(["dependencies.py"]):::backend
        IArouter(["IA Router\\nia.py"]):::backend
        JIRArouter(["JIRA Router\\njira.py"]):::backend
    end

    %% Batch Script
    script(["rag_api_jira_colab_scrum.py"]):::script

    %% External Services
    JIRAcloud(("JIRA Cloud API")):::external
    IAcloud(("IA Service API")):::external

    %% Connections
    U -->|"Uses SPA over HTTPS"| SPA
    SPA -->|"loads entrypoint"| entryjs
    SPA -->|"loads template"| html
    SPA -->|"configures routes"| router
    SPA -->|"calls REST"| apiSvc
    apiSvc -->|"POST /ia, /jira (JSON)"| mainApp
    mainApp -->|"includes config and deps"| cfg
    mainApp -->|"includes config and deps"| deps
    mainApp -->|"routes to IA"| IArouter
    mainApp -->|"routes to JIRA"| JIRArouter
    IArouter -->|"HTTPS/REST"| IAcloud
    JIRArouter -->|"HTTPS/REST"| JIRAcloud
    script -->|"batch RAG calls"| IAcloud
    script -->|"batch RAG calls"| JIRAcloud

    %% Click Events
    click script "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/rag_api_jira_colab_scrum.py"
    click mainApp "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-backend/main.py"
    click cfg "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-backend/config.txt"
    click deps "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-backend/app/dependencies.py"
    click IArouter "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-backend/app/routers/ia.py"
    click JIRArouter "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-backend/app/routers/jira.py"
    click entryjs "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/main.js"
    click html "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/public/index.html"
    click router "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/router/index.js"
    click apiSvc "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/services/apiService.js"
    click authStore "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/stores/authStore.js"
    click chatStore "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/stores/chatStore.js"
    click projectStore "https://github.com/hilanalegria/automatizacion-ia-gestion-proyectos-ti/blob/main/Proyecto/sinergia-frontend/src/stores/projectStore.js"

    %% Styles
    classDef user fill:#E3F2FD,stroke:#42A5F5,color:#0D47A1;
    classDef frontend fill:#BBDEFB,stroke:#2196F3,color:#0D47A1;
    classDef backend fill:#C8E6C9,stroke:#4CAF50,color:#1B5E20;
    classDef external fill:#FFE0B2,stroke:#FB8C00,color:#E65100;
    classDef script fill:#ECEFF1,stroke:#90A4AE,color:#37474F;
```
