Upload files to "/"

init commit
2026-05-08 07:21:31 +00:00
commit 821eaf4fa3
5 changed files with 1268 additions and 0 deletions
@@ -0,0 +1,197 @@
+# 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