Qu’est-ce qu’un planificateur de ressources ?

Un planificateur de ressources répond à une seule question : quelle ressource fait quoi, et quand est-elle libre ? Les ressources sont des lignes, le temps défile à l’horizontale, et chaque tâche est une barre posée sur la ligne de la ressource qui l’exécute. La réception d’un hôtel voit des chambres et des séjours, un atelier voit des postes et des réparations, un répartiteur voit des techniciens et des interventions.

Cette page explique en quoi cette disposition diffère d’un agenda, quand votre produit en a besoin, ce que SuperScheduler prend en charge et ce qui reste dans votre application, ainsi que la différence entre les deux éditions. Elle se termine par le vocabulaire employé dans le reste de la documentation.

#Ce qui le distingue d’un agenda de rendez-vous

Les deux affichent des événements sur un axe de temps, mais ils répondent à des questions différentes.

Un agenda s’organise autour de la personne qui le lit. Un planificateur de ressources s’organise autour de ce dont la capacité est limitée. Dès que les utilisateurs doivent en comparer beaucoup à la fois et déplacer le travail de l’un à l’autre, la disposition d’agenda ne tient plus : une vue semaine de 80 chambres, ce sont 80 agendas.

#Quand vous en avez besoin

Il vous faut un planificateur de ressources lorsque plusieurs de ces conditions sont réunies :

• La capacité est le problème. Chambres, lits, postes, équipes, studios, machines, véhicules, quais ou instruments ne peuvent faire qu’une chose à la fois, ou un nombre limité de choses.
• Le travail passe d’une ressource à l’autre. Une réservation passe de la chambre 101 à la chambre 102, une réparation part vers un poste équipé d’un pont élévateur, une intervention est réattribuée à un autre technicien.
• Beaucoup de ressources sont comparées en même temps. Des dizaines à des milliers de lignes, souvent groupées par site, étage, équipe ou type.
• Les durées varient fortement. Des créneaux de 15 minutes et des affectations de plusieurs semaines cohabitent dans les mêmes données : la vue doit aller de la minute au mois.
• Des règles décident de ce qui peut aller où. Un séjour ne peut pas être déplacé dans le passé, une intervention exige un technicien certifié, deux opérations ne peuvent pas partager un bloc.

Un agenda classique suffit quand une seule personne gère un seul agenda, quand le besoin principal porte sur les invitations et les réunions récurrentes, ou quand personne ne compare de ressources. Dans ce cas, un planificateur de ressources ajoute une dimension dont personne ne se sert.

Planning des chambres d’hôtelLa douche de la 104 fuit. Relogez le prochain client, bloquez la chambre pour le plombier et repérez les nuits déjà complètes. Rendez-vous d’un cabinet de kinésithérapieUn patient ne peut pas venir à 10 h. Trouvez le prochain créneau qui respecte pauses et nettoyages.

#Ce que fait la bibliothèque et ce que fait votre application

SuperScheduler est un composant d’interface. Il affiche, mesure et gère les interactions ; il ne possède ni vos données ni votre logique métier.

#Lite et Pro

SuperScheduler existe en deux éditions, avec le même nom de composant et les mêmes conventions de dates et de données.

• Lite est le paquet npm public super-scheduler-lite : une frise quotidienne en lecture seule. Voir Démarrage rapide avec Lite.
• Pro est le paquet super-scheduler, installé depuis une archive tarball privée et versionnée. Voir Installer SuperScheduler Pro.

Aucune des deux éditions ne limite le nombre de ressources ou d’événements. Lite lève une erreur lorsqu’il reçoit une option qu’il n’implémente pas : une configuration Pro ne fonctionne donc jamais à moitié, en silence, sur Lite. Pro conserve un petit ensemble d’API réservées, typées pour la compatibilité mais non implémentées (par exemple l’édition de texte en ligne, la création interactive de liens et l’export en images ou en tableurs) ; elles émettent un avertissement unique en développement, et la référence de l’API les signale.

Pour les questions commerciales sur Pro, consultez les tarifs.

#Les données en une image

Tout ce que dessine le planificateur provient de deux tableaux : les ressources et les événements. Un événement désigne sa ressource par son id.

import type { SuperScheduler } from 'super-scheduler'

// Rows: anything that can only do one thing at a time, or has a limited capacity.
export const resources: SuperScheduler.ResourceData[] = [
  { id: 'room-101', name: 'Room 101' },
  { id: 'room-102', name: 'Room 102' },
  { id: 'van-3', name: 'Van 3' },
]

// Bars: one interval on one row. `end` is exclusive, so the stay below ends at 11:00 on
// 5 October and a booking that starts at 11:00 that day does not overlap it.
export const events: SuperScheduler.EventData[] = [
  {
    id: 'booking-1042',
    resource: 'room-101',
    start: '2026-10-02T14:00:00',
    end: '2026-10-05T11:00:00',
    text: 'Booking 1042',
  },
  {
    id: 'route-7',
    resource: 'van-3',
    start: '2026-10-03T08:00:00',
    end: '2026-10-03T12:30:00',
    text: 'Delivery route 7',
  },
]

Sur un axe en jours, vous verriez trois lignes et deux barres : l’une du 2 au 5 octobre sur la ligne Room 101, l’autre le 3 octobre sur Van 3. Le guide du modèle de données détaille les ids, les intervalles et les champs personnalisés.

#Glossaire

Ces termes ont le même sens dans toute la documentation et dans l’API.

#Ressource

Une ligne du planificateur : tout ce qui peut travailler au fil du temps. Dans l’API, c’est ResourceData, avec un id et un name. Dans Pro, les ressources peuvent avoir des children (une arborescence), être figées en haut ou en bas, ou être scindées en sous-lignes. Certaines API parlent de row (ligne) : une ligne est la ressource affichée.

#Événement

Une barre sur la ligne d’une ressource : une réservation, un poste, une intervention, un séjour. Dans l’API, c’est EventData, avec un id, un text, un start, un end et la resource à laquelle il appartient. Dans les callbacks, vous recevez généralement un objet enveloppe (SuperScheduler.Event) dont la propriété data est votre objet.

#Intervalle

L’étendue d’un événement, de start à end. Les intervalles sont semi-ouverts, [start, end) : le début appartient à l’événement, la fin non. Un événement qui se termine à 11:00 et un autre qui commence à 11:00 ne se chevauchent pas.

#Cellule

Un pas de la grille de temps sur une ligne : un jour, une heure ou un créneau de 15 minutes, selon l’échelle. C’est sur les cellules que l’on clique pour sélectionner du temps, sur elles que s’aligne le magnétisme, et ce sont elles que vous pouvez désactiver ou décorer avec onBeforeCellRender (Pro).

#Échelle

La taille d’une cellule : Day dans Lite ; dans Pro, aussi Hour, Minute, Week, Month, Year, ou CellDuration avec un nombre de minutes personnalisé. L’échelle est indépendante des libellés des en-têtes. Voir Heures, minutes, jours et zoom.

#Niveau de zoom

Un ensemble nommé d’options de l’axe du temps (échelle, durée de cellule, largeur de cellule, en-têtes) que Pro applique en bloc. Les gestes et control.zoom passent d’un niveau de zoom à l’autre, ou zooment en continu entre eux.

#Contrôle

L’instance du planificateur, SuperScheduler.Scheduler. Le composant React en crée une au montage et la libère au démontage. Vous appelez ses méthodes pour faire défiler, sélectionner, mettre à jour ou zoomer ; les handlers la reçoivent dans args.control. Voir Intégration React.

#Étapes suivantes

• Essayez l’édition en lecture seule en quelques minutes : Démarrage rapide avec Lite.
• Installez Pro et construisez un planning modifiable : Installer SuperScheduler Pro.
• Découvrez le modèle de données avant de brancher un backend : Ressources, événements et intervalles.
• Parcourez des plannings fonctionnels pour douze secteurs dans les exemples.