dashboard-infra/README.md

📊 Dashboard Infra — Tickets

Dashboard en tiempo real para visualizar la carga de trabajo y métricas del equipo de Infraestructura, usando datos extraídos directamente de la API de Jira.

---

🏗️ Stack Tecnológico

• Frontend: HTML5 + Vanilla JavaScript + Chart.js (v4.4.1)
• Backend: Python + Flask
• API: Integración directa con Jira REST API v3
• Autenticación: Basic Auth mediante Email y API Token de Jira

---

🚀 Instalación y Configuración Local

1. Clonar el repositorio

git clone https://git.beldo.duckdns.org/jpbeldomenico/dashboard-infra.git
cd dashboard-infra

2. Instalar dependencias Python

pip install -r requirements.txt

3. Configurar Variables de Entorno

Copiá el archivo de ejemplo y completá con tus credenciales:

cp ex.env .env

Editá el .env:

JIRA_HOST=invera.atlassian.net
JIRA_EMAIL=tu-email@dominio.com
JIRA_TOKEN=tu-jira-api-token
JIRA_PROJECT=IO
USE_TICKET_COUNT=true

Podés generar un API Token en: https://id.atlassian.com/manage-profile/security/api-tokens

4. Levantar el servidor

python server.py

Abrí el navegador en: http://localhost:8888

---

📁 Estructura del Proyecto

dashboard-infra/
├── index.html          # Frontend: layout y gráficos
├── js/
│   └── app.js          # Lógica del dashboard (Chart.js, KPIs, filtros)
├── css/
│   └── styles.css      # Estilos
├── server.py           # Backend Flask: fetch de Jira y endpoint /api/data
├── requirements.txt    # Dependencias Python
├── ex.env              # Ejemplo de variables de entorno
└── .gitignore

---

📊 Métricas disponibles

• Carga de trabajo actual: tickets En Progreso y Por Hacer por desarrollador
• Alertas de salud: tickets estancados, vencidos, sin asignar
• Resultados del período: tickets completados, promedio semanal, solicitudes por semana
• Filtro por desarrollador y por rango de tiempo (hoy, 7d, 30d, 90d, 1 año, histórico)