Calculateur de rotation des tâches ménagères

La même fonction pure alimente l’exécuteur gratuit du navigateur et l’API, sans horloge, sans tirage au sort et sans réseau. Les listes vides ou un week_index manquant échouent avec invalid_input et ne sont pas facturés.

Comment la rotation attribue chaque corvée avec équité

Formellement, la personne qui assume la tâche i à la semaine W occupe person_index égal à (i plus W) modulo la taille du roster. Le calculateur n’invente ni semaines sautées, ni pondérations, ni calendriers de congés ; si quelqu’un est absent, retirez-le du roster ou avancez le week_index dans votre propre couche.

Contrat d’entrée, forme de la réponse et erreurs

Les champs de sortie facultatifs ne sont jamais remplis avec null. Envoyez par POST un corps JSON avec trois champs obligatoires. chores est un tableau non vide d’une à cinquante chaînes de noms de tâche dans l’ordre de la liste ; chaque entrée est recadrée et les chaînes vides après trim sont rejetées en invalid_input en nommant le mauvais index. roster est un tableau non vide d’une à cinquante chaînes de noms de personne dans l’ordre de rotation ; les doublons après un trim insensible à la casse sont rejetés pour que deux mentions de la même personne ne volent pas de tours supplémentaires. week_index est un entier non négatif de zéro à un milliard identifiant la semaine de la série que vous résolvez : zéro est la première semaine. Une chaîne séparée par des virgules, des sauts de ligne, des points-virgules ou des barres verticales est aussi acceptée pour chores et roster, afin qu’un texte collé façon liste de courses fonctionne. Les alias tasks, duties, jobs et chore_list correspondent à chores ; people, members, names et household à roster ; week, week_number, index et w à week_index. En cas de succès, le corps renvoie les listes normalisées et week_index, indique week_in_cycle, cycle_length, next_week_index, chore_count et person_count, puis liste assignments comme lignes tâche-vers-personne avec index, by_person comme chaque nom avec les tâches de cette semaine, et resting comme les noms sans devoir cette semaine. chores_per_person_min et chores_per_person_max montrent à quel point la charge est équilibrée cette semaine ; formula réaffirme person_index égal à (chore_index plus week_index) mod roster_size ; message est une seule ligne en anglais que vous pouvez épingler sur le réfrigérateur ou dans un fil. Exemple : chores Dishes, Trash, Vacuum avec roster Alice, Bob, Carol et week_index zéro attribue Alice à Dishes, Bob à Trash et Carol à Vacuum ; week_index un tourne vers Bob, Carol et Alice. Listes manquantes, noms vides, doublons dans le roster, week_index non entier ou négatif, et listes trop longues échouent avec invalid_input et ne consomment pas de solde.

Où une API de rotation des tâches ménagères gagne sa place

Les bots d’intendance domestique dans Slack ou un groupe familial envoient « les corvées de cette semaine » en appelant l’API avec l’indice de la série stocké dans une clé compteur. Comme l’implémentation est parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant ; une validation échouée est gratuite. Conservez la liste des corvées et le roster dans le même ordre dans chaque système d’enregistrement, incrémentez week_index une fois par semaine (y compris les semaines où vous voulez encore que la rotation avance même si quelqu’un voyage) et vous obtenez des attributions reproductibles pour impressions, calendriers et edge workers sans monter un service de planification à vous.