Tâches de maintenance
Une Tâche de maintenance est un contrôle récurrent pour une machine. Elle définit la périodicité, le responsable, la tolérance, et si un certificat est requis. Le système crée des Contrôles (journaux de maintenance) pour chaque cycle dû à partir de ces règles.
Sélectionnez toujours le bon client dans l’en-tête de l’application en premier.
Public typique : responsables maintenance (et Qualibee Admin pendant la mise en place). Les contrôleurs ouvrent en général les contrôles depuis le Planning Directeur ou l’Historique de maintenance ; ils n’ont pas besoin d’éditer le programme chaque jour.
Où gérer les tâches
- Allez à Contrôle → Machines (
/control/machines). - Ouvrez la machine :
/control/machines/:id. - Ouvrez la section Tâches de maintenance (elle apparaît avant l’Historique de maintenance).
| Action | FR |
|---|---|
| Créer | Nouvelle tâche de maintenance |
| Modifier | Modifier la tâche de maintenance |
| Enregistrer | — (Enregistrement… pendant la sauvegarde) |
| Annuler | — |

Ouvrez une ligne existante pour la modifier, ou utilisez Ajouter une tâche lorsque la machine peut créer des tâches.
Si Ajouter une tâche est absent et qu’un message de blocage apparaît (pas de plan de maintenance / soumettre l’actif / configurer l’équipe), la machine n’est pas prête — contacter Qualibee Admin (équipe sur la machine, société) ou le Support (modèles de catégorie / plan).
Champs importants
| Champ (API) | FR | Notes |
|---|---|---|
maintenance_task |
Nom de la tâche | Obligatoire dans l’UI — Enregistrer reste désactivé tant qu’il est vide |
maintenance_type |
Type de contrôle | CQ, OCR, Physique Médicale, Maintenance, Qualité, Autre (défaut : Maintenance) |
periodicity |
Périodicité | Quotidienne, Hebdomadaire, Mensuelle, Trimestrielle, Annuelle, Tous les 2 ans, Personnalisée (défaut : Mensuelle) |
start_date |
Date de début | Base pour le calcul du planning |
end_date |
Date de fin | Retrait optionnel ; le début doit précéder la fin |
next_due_date |
Prochaine date d'échéance | Se synchronise avec le contrôle ouvert Planifié / En retard ; recalculée si vide lorsque les champs de planning changent |
short_name |
Nom court | Libellé court sur les cartes / l’historique |
tolerance |
Tolérance (jours) | Nombre ≥ 0 — jours supplémentaires après l’échéance encore comptés comme à temps |
maintenance_status |
Statut de la tâche | Planifié / En retard / Annulé (défaut : Planifié) |
| Années / mois personnalisés | Périodicité personnalisée (années/mois) | Affiché seulement si Périodicité = Personnalisée ; années ou mois doivent être > 0 |
certificate_required |
Certificat requis | Case à cocher — si activé, la clôture nécessite un fichier téléversé |
reminder |
Rappel | Voir les options de rappel ci-dessous |
assign_to |
Assigner à | Affiché lorsque l’équipe de maintenance a des membres ; Non assigné est autorisé |
description |
Description | Texte libre |


Périodicité
| FR |
|---|
| Quotidienne |
| Hebdomadaire |
| Mensuelle |
| Trimestrielle |
| Annuelle |
| Tous les 2 ans |
| Personnalisée |

Options de rappel
| Valeur |
|---|
| (vide) Aucun rappel |
| Le même jour |
| La veille |
| 1 semaine avant |
| 2 semaines avant |
| 1 mois avant |
| 2 mois avant |
| 3 mois avant |
| 6 mois avant |
Si les rappels ne partent pour personne → contacter Qualibee Admin (configuration des notifications).
Règles de planning
- La Date de début est la base pour calculer la prochaine date d’échéance avec la périodicité.
- La Date de fin est un retrait optionnel : après cette date, la prochaine échéance devient vide et aucun cycle supplémentaire n’est généré.
- La Prochaine date d'échéance pilote la date d’échéance du contrôle ouvert Planifié / En retard. Si vous la laissez vide et changez les champs de planning, le système la recalcule à partir de la périodicité (ou des années/mois personnalisés).
- Si la prochaine échéance est avant aujourd’hui, le statut de la tâche peut passer à En retard.
- Assigner à ne liste que les personnes de l’équipe de maintenance de la machine. Si l’équipe n’a aucun membre, la liste déroulante d’assigné est masquée.
- L’assignation est manuelle (pas de round-robin automatique). Laisser Non assigné est autorisé dans l’UI.
- Pour changer le responsable en cours de programme, mettez à jour Assigner à et enregistrez. Les contrôles ouverts Planifié / En retard doivent se réaligner avec la tâche ; si l’assigné sur un contrôle ouvert paraît incorrect, actualisez la page machine, puis contactez Qualibee Admin s’il ne se met toujours pas à jour.
- Règle backend : la date de début doit précéder la date de fin lorsque les deux sont renseignées.
Après avoir enregistré une tâche
- La modal se ferme.
- Toast : Tâche de maintenance enregistrée (ou un toast d’erreur).
- L’UI recharge les Tâches de maintenance et l’Historique de maintenance.
En arrière-plan, l’enregistrement du plan parent synchronise les contrôles ouverts :
| Comportement de sync | Résultat |
|---|---|
| Contrôle ouvert Planifié / En retard | Date d’échéance, drapeau certificat, assigné, type, tolérance, nom court et champs liés suivent la tâche |
| Prochaine échéance omise + planning modifié | Prochaine échéance recalculée depuis la périodicité / l’intervalle personnalisé |
| Tâche retirée du plan | Les contrôles ouverts liés peuvent être Annulé à la sync |
| Première tâche sur une machine prête sans plan encore | Un plan peut être amorcé si l’actif est soumis, a une société, et a une équipe de maintenance |
Si une date d’échéance ne paraît pas mise à jour après enregistrement, actualisez et rouvrez la page machine. Si c’est encore incorrect → contacter Qualibee Admin.
| Scénario | Que faire |
|---|---|
| Retirer un contrôle récurrent | Renseigner une Date de fin |
| La preuve devient obligatoire | Activer Certificat requis |
| Changer le responsable | Modifier Assigner à, puis enregistrer |
| Intervalle personnalisé | Définir Périodicité = Personnalisée, puis années et/ou mois > 0 |
Lien entre tâches et contrôles
Tâche de maintenance (règles)
└── Contrôle (occurrence de ce cycle)
└── Tâches Cirra (seulement si Non-conforme)
- Les contrôles sont créés à partir des tâches — n’inventez pas de journaux de contrôle manuels comme parcours principal.
- Lorsqu’un contrôle est clôturé avec succès comme Terminé ou terminé en retard comme En retard / Terminé en retard, le cycle suivant est planifié à partir de la date d’achèvement et de la périodicité.
- Annulé n’ouvre pas de cycle suivant normal.
- Retirer une tâche peut annuler les contrôles ouverts liés à la sync — traitez les suppressions avec prudence.
Tolérance sur la tâche
Tolérance (jours) est la fenêtre de grâce après la date d’échéance pour ce contrôle.
- Terminer au plus tard à échéance + tolérance → Terminé (à temps)
- Terminer après cette fenêtre → encore clôturable, enregistré comme terminé en retard (En retard / Terminé en retard)
- Les clôtures anticipées sont autorisées
Exemple : Échéance 10 mars, tolérance 5 jours → à temps jusqu’au 15 mars. Terminer le 16 mars est clôturable mais étiqueté terminé en retard.
Certificat requis
Si Certificat requis est activé sur la tâche :
- La clôture du contrôle est bloquée jusqu’à ce qu’un fichier certificat soit téléversé sur le contrôle
- Les types acceptés incluent en général images, PDF et documents Office
- Le drapeau est défini sur la tâche (règle de programme), pas inventé seulement au moment de la clôture
Règles rapides
- Nom de la tâche vide → impossible d’Enregistrer
- Liste Assigner à vide (ou pas de liste déroulante) → équipe / employés incomplets → Support (équipe / employés) ou Qualibee Admin
- Non assigné est autorisé ; l’assignation reste recommandée pour que le travail apparaisse à la bonne personne
- Certificat requis sur la tâche → clôture bloquée jusqu’au téléversement de la preuve sur le contrôle
- Tolérance (jours) définit la fenêtre à temps après la date d’échéance
- La périodicité personnalisée nécessite années ou mois > 0
- Enregistrer actualise les tâches et l’historique ; si les dates paraissent obsolètes, actualisez d’abord la page machine