juan.beldomenico
84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
# 📊 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)](https://www.chartjs.org/)
|
|
- **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
|
|
|
|
```bash
|
|
git clone https://git.beldo.duckdns.org/jpbeldomenico/dashboard-infra.git
|
|
cd dashboard-infra
|
|
```
|
|
|
|
### 2. Instalar dependencias Python
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### 3. Configurar Variables de Entorno
|
|
|
|
Copiá el archivo de ejemplo y completá con tus credenciales:
|
|
|
|
```bash
|
|
cp ex.env .env
|
|
```
|
|
|
|
Editá el `.env`:
|
|
|
|
```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
|
|
|
|
```bash
|
|
python server.py
|
|
```
|
|
|
|
Abrí el navegador en: `http://localhost:8888`
|
|
|
|
---
|
|
|
|
## 📁 Estructura del Proyecto
|
|
|
|
```text
|
|
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)
|