Planificateur de postes rotatifs

Les plages invalides, les jours de calendrier impossibles et les champs de cycle hors plage échouent avec invalid_input et ne sont jamais facturés.

Ce que signifie un cycle rotatif de service et de repos pour un travailleur

Le jour zéro du cycle est le premier jour d’un bloc de service lorsque cycle_offset vaut zéro. Pour tout indice de jour i compté depuis start_date (base zéro), day_in_cycle est le reste de i plus cycle_offset divisé par cycle_length, où cycle_length est on_days plus off_days. Si ce reste est strictement inférieur à on_days, le jour est on ; sinon il est off. Le classique 4-4 utilise donc on_days quatre et off_days quatre, un cycle de huit jours et un taux de travail de long terme d’un demi. Mettre off_days à zéro force tous les jours en service dans la fenêtre, parfois utile comme planning de disponibilité totale.

Contrat d’entrée, forme de la réponse et règles de validation

Le champ formula reformule la règle modulaire en texte clair pour les pistes d’audit. Envoyez en POST un corps JSON avec quatre champs obligatoires et deux optionnels. start_date et end_date doivent être des chaînes de calendrier grégorien réelles au format strict YYYY-MM-DD ; la plage est inclusive aux deux extrémités et end_date ne doit pas précéder start_date. L’étendue inclusive peut compter au plus trois cent soixante-six jours afin de borner la taille de la réponse pour le navigateur et les clients API. on_days est un entier positif de un à quatre-vingt-dix ; off_days est un entier de zéro à quatre-vingt-dix. cycle_offset vaut zéro par défaut et, s’il est fourni, doit se situer entre zéro et cycle_length moins un, afin qu’une phase d’embauche en milieu de cycle ne dépasse pas la fin du cycle. worker_name est une étiquette optionnelle d’au plus cent vingt caractères renvoyée en cas de succès lorsqu’elle est présente. Des alias sont acceptés pour l’ergonomie : from ou begin pour start_date, to ou until pour end_date, work_days pour on_days, rest_days pour off_days, offset ou phase pour cycle_offset, et name ou employee pour worker_name. En cas de succès, le corps renvoie les dates et paramètres de cycle normalisés, pattern comme chaîne courte du type four-on slash four-off, total_days, days_on, days_off, work_ratio arrondi half-up à six décimales, un tableau roster d’objets avec date, day_in_cycle et status on ou off, plus les tableaux parallèles on_dates et off_dates pour un filtrage rapide. Les dates impossibles comme le trente et un avril, une étendue négative, une étendue au-dessus du maximum, un on_days nul ou non entier, ou un cycle_offset égal ou supérieur à cycle_length échouent avec invalid_input en nommant le champ ; ces échecs ne consomment pas le solde prépayé. Le prix des appels réussis est un forfait $0.002 avec l’unité item.

Où l’expansion du planning rotatif apporte de la valeur

Les flux d’embauche RH peuvent transmettre la date d’embauche comme start_date avec un cycle_offset non nul afin que le nouvel arrivant rejoigne la rotation existante en milieu de cycle au lieu de redémarrer au jour zéro. Les préprocesseurs de paie comptent days_on dans une période de paie pour contrôler les heures ordinaires attendues avant d’appliquer les règles d’heures supplémentaires. Les simulateurs d’effectifs comparent work_ratio entre motifs candidats—2-2 versus 4-4 versus 5-2—sans écrire de scripts sur mesure à chaque fois. Les équipes d’intégration intègrent l’API dans des outils internes afin que les planificateurs ne ressaisissent jamais les tables modulaires à la main.