jira-extractor/README.md

# Jira Ticket Extractor - Mise à jour

## Nouvelles fonctionnalités

### 1. Labels des tickets
Les labels sont maintenant automatiquement extraits et affichés dans le tableau avec un design visuel distinctif (badges verts).

**Affichage :**
- Chaque label apparaît comme un badge individuel
- Labels triés et espacés pour une meilleure lisibilité
- Si aucun label n'est présent, affiche " - "

**Statistiques :**
- **Labels différents** : Nombre total de labels uniques dans l'extraction
- **Avec labels** : Nombre de tickets qui ont au moins un label

### 2. Go Live Date (Champ personnalisé)
Le système supporte maintenant l'extraction et l'édition de dates personnalisées comme la "Go Live Date".

**Configuration :**

1. **Identifiez l'ID du champ personnalisé dans Jira :**
   - Allez dans un ticket Jira
   - Cliquez sur le paramètre de la date "Go Live Date"
   - Regardez l'URL ou l'inspecteur d'éléments pour trouver l'ID (ex: `customfield_10206`)
   - Ou demandez à votre administrateur Jira

2. **Configurez dans le formulaire d'extraction :**
   - Dans le champ "Champs personnalisés", entrez : `customfield_10206:Go Live Date`
   - Format : `customfield_ID:NomAffiché`
   - Pour plusieurs champs, séparez par des virgules :
     ```
     customfield_10206:Go Live Date, customfield_10002:Production Date, customfield_10003:Release Date
     ```

**Affichage automatique :**
- Les colonnes personnalisées sont automatiquement ajoutées au tableau
- Les champs contenant "date" dans le nom sont automatiquement formatés
- La date est affichée au format français (ex: 15 jan 2025)

### 3. Édition des dates (Due Date & Go Live Date) ⭐ NOUVEAU
Vous pouvez maintenant modifier les dates directement depuis l'interface et les mettre à jour dans Jira !

**Comment modifier les dates :**

1. **Extrayez d'abord les tickets** avec les champs personnalisés configurés
2. **Les colonnes de date sont maintenant éditables** :
   - **Due Date** : toujours éditable
   - **Go Live Date** (ou tout champ personnalisé contenant "date") : éditable
3. **Sélectionnez une nouvelle date** dans le sélecteur de date
4. **Cliquez sur le bouton "Update"** pour enregistrer les modifications dans Jira

**Fonctionnalités de mise à jour :**
- Le bouton "Update" est désactivé tant que vous ne modifiez aucune date
- Dès que vous changez une date, le bouton s'active
- Le bouton affiche un spinner pendant la mise à jour
- Un message de confirmation apparaît après une mise à jour réussie
- Les modifications sont appliquées en temps réel dans Jira

**Exemple :**
```
1. Entrez : customfield_10206:Go Live Date
2. Cliquez sur "Lancer l'extraction"
3. Modifiez la Due Date ou Go Live Date dans le tableau
4. Cliquez sur "Update" pour envoyer à Jira
```

### 4. Roadmap Draw.io ⭐ NOUVEAU
Générez une roadmap visuelle au format Draw.io (.drawio) importable dans draw.io/diagrams.net !

**Contenu de la roadmap :**
- **Ticket Key** : Identifiant du ticket (ex: PROJ-123)
- **Summary** : Titre/description du ticket
- **Status** : Statut avec code couleur
- **Assigné** : Personne responsable du ticket
- **Timeline** :
  - **Début** = Due Date
  - **Fin** = Go Live Date (customfield_10206)

**Comment utiliser :**

1. **Extrayez les tickets** avec au moins la Due Date et idéalement la Go Live Date
2. **Cliquez sur l'onglet "Roadmap"** dans l'interface
3. **Filtrez si nécessaire** :
   - "Tous les tickets" : Affiche tout
   - "En cours uniquement" : Seulement les tickets en cours (In Progress)
   - "Avec dates uniquement" : Seulement les tickets qui ont des dates
4. **Aperçu interactif** : La roadmap est affichée directement dans l'interface
5. **Téléchargez le .drawio** : Cliquez sur "Télécharger le .drawio"
6. **Importez dans Draw.io** : Ouvrez le fichier sur app.diagrams.net

**Fonctionnalités :**
- Preview interactive dans l'interface
- Code couleur selon le statut :
  - 🟢 Vert : Done/Fermé/Résolu
  - 🔵 Bleu : En cours/Review
  - 🟡 Orange : To Do/Open/Backlog
  - 🔴 Rouge : Bloqué
  - ⚪ Gris : Autre
- Timeline avec dates sur l'axe horizontal
- Chaque ticket affiche : Key, Summary, Assigné, Statut
- Format XML Draw.io standard, compatible avec draw.io/diagrams.net

**Exemple d'utilisation :**
```
1. Configurez : customfield_10206:Go Live Date
2. Cliquez sur "Lancer l'extraction"
3. Onglet "Roadmap" → Vous voyez la timeline
4. Filtrez si nécessaire (ex: "En cours uniquement")
5. Cliquez sur "Roadmap Draw.io" pour télécharger
6. Importez le fichier sur app.diagrams.net
```

## Tableau de bord mis à jour

Le tableau de statistiques affiche maintenant :
- **Tickets** : Nombre total de tickets extraits
- **Statuts** : Nombre de statuts différents
- **Non assignés** : Tickets sans assigné
- **En retard** : Tickets dépassés et non terminés
- **Labels différents** : Nombre de labels uniques
- **Avec labels** : Tickets ayant au moins un label

## Tableau amélioré

Nouvelles colonnes :
- **Due Date** : Maintenant éditable avec un sélecteur de date
- **Labels** : Affiche tous les labels du ticket sous forme de badges
- **Go Live Date** (ou autres champs date) : Éditable si configuré
- **Actions** : Bouton "Update" pour envoyer les modifications à Jira
- **Colonnes personnalisées** : S'ajoutent automatiquement selon la configuration

Nouveaux onglets :
- **Tableau** : Vue tabulaire des tickets avec édition des dates
- **Roadmap** : Visualisation timeline des tickets et export Draw.io
- **JSON Brut** : Données JSON brutes

## Recherche et filtrage

La barre de recherche fonctionne maintenant sur :
- Résumé, clé du ticket
- Statut, assigné, priorité
- **Labels** : Vous pouvez chercher un label spécifique
- **Go Live Date** et autres champs personnalisés

## JSON brut

Les données JSON incluent maintenant :
- `labels`: Tableau de tous les labels du ticket
- Tous les champs personnalisés configurés

## Exemple d'utilisation

### Extraction simple avec labels :
```
- Username: votre@email.com
- API Token: votre-token
- Clé du projet: PROJ
- Champ personnalisé: (laisser vide pour n'extraire que les labels)
```

### Extraction et édition avec Go Live Date :
```
- Username: votre@email.com
- API Token: votre-token
- Clé du projet: PROJ
- Champ personnalisé: customfield_10206:Go Live Date
```
Après extraction :
1. Modifiez les dates dans le tableau
2. Cliquez sur "Update" pour synchroniser avec Jira

### Extraction avec plusieurs champs personnalisés :
```
- Champ personnalisé: customfield_10206:Go Live Date, customfield_10002:Production Date, customfield_10003:Release Version
```

## Démarrage

```bash
# Installer les dépendances
npm install

# Démarrer le serveur
npm start
```

Puis ouvrez `index.html` dans votre navigateur.

## Notes importantes

- Le serveur (server.js) extrait déjà les labels automatiquement - aucune configuration nécessaire
- Les champs personnalisés doivent être explicitement configurés via l'option "customFields"
- Les champs personnalisés de type date sont automatiquement reconnus et formatés
- Pour modifier des dates dans Jira, assurez-vous que votre utilisateur a les droits d'**écriture** sur les tickets
- Les dates sont envoyées à Jira au format ISO (YYYY-MM-DD)
- Le bouton "Update" envoie uniquement les champs modifiés pour optimiser les performances