# Référence des tickets

> Champs, valeurs, états, pièces jointes, notifications, conservation et droits du module de tickets de support.

Le module de tickets se pilote depuis la console Wakastart, menu **Projets** > **Liste des tickets**. Il n'a pas d'API publique.

## Écrans

| Écran | Adresse | Contenu |
|---|---|---|
| **Tickets** (sous-titre **Suivi post-livraison**) | `/tickets/listing` | Recherche par titre, filtres, colonnes **Identifiant**, **Titre**, **Type**, **Priorité**, **État**, **Responsable** ; bouton **Créer un ticket** |
| Fiche d'un ticket | `/tickets/{identifiant}` | En-tête (état, **Copier le libellé**, **Copier l'URL**, bascule de visibilité, **Supprimer**), cartes **Champs**, description, **Pièces jointes**, **Commentaires**, **Historique** |

## Champs d'un ticket

| Champ | Valeurs | Obligatoire |
|---|---|---|
| Identifiant | `<code de l'application>-<numéro>`, par exemple `APP-12` ; numéro attribué par application | Attribué |
| **Application** | Application sélectionnée dans le fil d'Ariane | Oui |
| **Titre** | 200 caractères au plus | Oui |
| **Description** | Texte mis en forme, images et vidéos ; 100 000 caractères au plus en modification | Oui |
| **Type** | **Bug**, **Fonctionnalité**, **Tâche**, **Assistance** | Oui |
| **Priorité** | **Urgent**, **Critique**, **Normal**, **Plus tard** | Oui |
| **Environnement** | `PROD`, `STAGING`, `DEV` | Oui |
| **Version** | 32 caractères au plus | Non |
| **État** | Voir le tableau suivant ; **Ouvert** par défaut | Product Owner seulement |
| **Responsable** | Administrateur habilité sur l'application | Product Owner seulement |
| Échéance | Date, ou aucune | Non |
| Visibilité | **Client** (par défaut) ou **Interne Waka** | — |

## États

| Libellé | Code |
|---|---|
| **Ouvert** | `OUVERT` |
| **En cours** | `EN_COURS` |
| **QA Test** | `QA_TEST` |
| **Validé** | `VALIDE` |
| **Terminé** | `TERMINE` |
| **Ré-ouvert** | `REOUVERT` |
| **Refusé** | `REFUSE` |
| **Incomplet** | `INCOMPLET` |
| **Plus tard** | `PLUS_TARD` |

## Commentaires

| Élément | Valeur |
|---|---|
| Longueur maximale | 5 000 caractères |
| Modification et suppression | Auteur du commentaire, avec le droit de gestion des tickets |
| Commentaire supprimé | Retiré du fil |

## Pièces jointes

| Élément | Valeur |
|---|---|
| Nombre maximal par ticket | 20 pièces jointes actives |
| Image collée ou insérée | PNG, JPEG, GIF, WebP ; 10 Mo au plus |
| Vidéo | MP4, WebM, QuickTime ; 50 Mo au plus dans la console |
| Contrôle du type | Sur le contenu réel du fichier |
| Analyse | Antivirus systématique ; badges **Analyse en cours**, **Sain**, **Infecté**, **Erreur d'analyse** |
| Téléchargement | Seulement pour un fichier **Sain** ; lien valable 1 heure |
| Suppression | Auteur du ticket, avec le droit de gestion |

## Notifications par e-mail

Les e-mails partent vers l'auteur du ticket et son responsable, jamais vers la personne à l'origine de l'événement. L'auteur d'un ticket **Interne Waka** n'est pas prévenu.

| Événement | Objet de l'e-mail |
|---|---|
| Création | `[Ticket APP-12] Nouveau ticket créé` |
| Assignation | `[Ticket APP-12] Ticket assigné` |
| Changement d'état | `[Ticket APP-12] Statut mis à jour` |
| Nouveau commentaire | `[Ticket APP-12] Nouveau commentaire` |

Un e-mail qui échoue est retenté trois fois. Les changements de priorité, d'échéance et de visibilité n'envoient pas d'e-mail.

## Conservation

| Situation | Délai avant purge définitive |
|---|---|
| Ticket supprimé | 90 jours après la suppression |
| Ticket d'une application devenue inactive | 90 jours après le passage de l'application à l'état inactif |

La purge s'exécute chaque nuit à 3 h et supprime le ticket, ses commentaires, son historique et ses pièces jointes.

## Droits

| Droit | Code | Profils livrés |
|---|---|---|
| **Voir un ticket dans son périmètre** | `tickets.read` | Chef de projet, Testeur, Développeur |
| **Créer/commenter/joindre une pièce à un ticket** | `tickets.write` | Chef de projet, Testeur, Développeur |
| **Gérer l'état, l'affectation et les commentaires tiers d'un ticket** | `tickets.manage` | Chef de projet, Développeur |

Les actions de Product Owner (état, responsable, priorité, échéance, visibilité) demandent en plus le niveau Propriétaire, Administrateur réseau ou Administrateur d'applications.

## Limites de la liste

| Élément | Valeur |
|---|---|
| Recherche | Sur le titre, sans tenir compte de la casse ; 200 caractères au plus |
| Tri | Du plus récent au plus ancien |
| Taille de page | 20 tickets |

## Voir aussi

- [Visibilité et niveaux](/v1.0/support/visibilite-et-niveaux)
- [Cycle de vie d'un ticket](/v1.0/support/cycle-de-vie-d-un-ticket)
