Séries récurrentes

fixed_day_of_month : toujours autour du même jour. month_end : en fin de mois, quel que soit le nombre de jours — un prélèvement du 31 janvier, 28 février, 31 mars est un seul motif. last_business_day : le dernier jour ouvré, cas fréquent des salaires. business_day_adjusted : un jour nominal déplacé hors du week-end (samedi → vendredi, dimanche → lundi). Nous NE modélisons pas les jours fériés : ni français, ni target, ni bancaires. Un report de férié est absorbé par la tolérance de la fenêtre, pas reconnu — prétendre connaître un calendrier que nous n'avons pas serait pire que de l'ignorer. fixed_weekday : toujours le même jour de la semaine. flexible_calendar_window : une occurrence par période, sans jour stable. unknown : rien d'identifiable.

Une constante par type d'ancrage, ou une formule linéaire sur l'étendue des jours pour fixed_day_of_month et flexible_calendar_window. 0 pour unknown. Un 0,33 fixed_day_of_month et un 0,3 flexible_calendar_window ne se comparent pas — et flexible_calendar_window change de règle avec la cadence (constante 0,3 en hebdomadaire, 1 - etendue/10 en mensuel).

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Stable. Il se dérive de ce qui ne change pas — workspace, famille, contrepartie, sens, devise — jamais de la dernière occurrence ni du libellé courant. Une occurrence de plus ne crée pas une autre série.

recurring_payment dit « ce paiement revient », et rien de plus : un loyer et une échéance de prêt le sont aussi. subscription est une affirmation plus forte et exige son propre signal ; sans lui, la réponse reste recurring_payment. De même recurring_income couvre pension, prestation et loyer perçu — salary_series en est une spécialisation, pas un synonyme.

Le type plus général que celui-ci spécialise, s'il existe.

Deux occurrences font émerger, trois peuvent établir, une seule jamais. broken se calcule au moment de la lecture : une série devient en retard par le seul passage du temps, sans qu'aucune écriture n'ait lieu.

Lue au calendrier, pas en jours secs : le 31 janvier et le 28 février sont à un mois d'intervalle, et un salaire au dernier jour ouvré glisse.

L'égalité exacte n'est pas exigée : une facture d'électricité varie, un salaire aussi. Montants en unités mineures, en chaîne — jamais un nombre JSON.

Facultative, et c'est le point. Absente tant que la série n'est pas établie ou que la cadence est irrégulière : rendre une date sur deux observations faibles la ferait passer pour une prévision. Ce n'est pas une API de prévision.

Ce n'est pas une probabilité : c'est la part des signaux corroborants présents sur ceux que ce type sait produire. Et ce n'est pas le même nombre que relationships[].match_strength : même nom, autre dénominateur, autres signaux. Cinq critères hétérogènes sur cinq — cadence calendaire, montant fixe ou étroit, au moins trois occurrences, entité connue, type spécialisé. Ils ne s'additionnent qu'ici.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Les signaux qui fondent la série. value est une chaîne ou un entier selon le code (occurrences porte un entier).

Un axe différent de status. status dit à quel point nous croyons que c'est une série ; lifecycle dit ce qui lui arrive maintenant. Une série très bien établie peut avoir cessé de prélever, et une série fraîche peut être parfaitement vivante. Et aucun état ne se conclut d'une absence sans couverture : si la source n'était pas observée de façon complète sur la fenêtre attendue, l'état est unknown, pas late. « Je n'ai rien vu » ne devient jamais « il n'y a rien eu » — c'est la différence entre un client qui a cessé d'envoyer et un abonnement qui a cessé de prélever.

active : l'échéance attendue est arrivée, ou n'est pas encore échue. late : une échéance manque ET le compte était observé. inactive : plusieurs échéances consécutives manquent sous observation complète — la série ne prélève plus, sans que nous sachions pourquoi. ended : réservé à une preuve terminale explicite. Aucune accumulation d'absences ne produit cet état : un prélèvement qui s'arrête peut être une résiliation, une suspension, une carte expirée ou un échec de prélèvement, et nous ne devinons pas laquelle. unknown : nous ne pouvons pas conclure, et reason dit pourquoi.

Une fenêtre, pas une date. Un salaire tombe vers les derniers jours ouvrés, un prélèvement SEPA vers le 5. Rendre un instant exact serait une précision que nous n'avons pas, et vous la croiriez.

La demi-largeur de la fenêtre, en jours. Plus grand = moins précis. Vient du type d'ancrage, relevé au plancher de la famille de série.

Le type d'ancrage qui a donné la fenêtre.

true si la tolérance a été relevée au plancher de la famille (5 jours pour un abonnement, 6 pour un salaire, 7 sinon).

Le compteur n'avance que sous couverture complète. Absent quand rien n'est attendu — ce qui n'est pas la même ignorance que « nous ne regardions pas ».

not_required : aucune échéance close, rien n'avait à être observé. complete : chaque source de la série était couverte sur la fenêtre attendue — un manque est un manque. incomplete : au moins une source ne l'était pas — l'absence ne prouve rien, state est unknown. unknown : les sources sont inconnues ou trop nombreuses pour être vérifiées.

Le même nombre que cadence_detail.strength, rendu ici pour que le cycle de vie soit lisible seul. Ce n'est pas un second score.

Le même objet que calendar_pattern (classe anchor_stability), rendu ici pour la même raison ; { type: unknown } quand aucun ancrage n'a été inféré. Absent quand aucune échéance n'est attendue. duplicate_of : series[].calendar_pattern — ce n'est pas un second score.

Présent pour ended : la preuve terminale qui l'a produit.

Présent uniquement quand l'identité de la série a été corrigée, pour dire pourquoi state vaut unknown : ce n'est pas une ignorance économique, c'est que le verdict appartient désormais aux successeurs. L'état d'identité complet se lit dans identity, qui est un axe à part entière ; ce champ n'est qu'un renvoi, et il ne prend jamais la valeur current.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Un troisième axe, et il ne se mélange ni à status NI À lifecycle. status dit à quel point nous croyons que c'est une série ; lifecycle dit ce qui lui arrive économiquement ; identity dit si son nom est toujours le bon. Une série peut prélever tous les mois et avoir changé d'identité parce que nous avons compris qu'elle était en réalité deux flux, ou deux moitiés d'un seul. ET UN series_id n'est jamais réécrit ni réutilisé en silence. Quand nous corrigeons, l'ancien nom subsiste, marqué superseded, et il porte ses successeurs.

current : ce nom est le nom courant de ce flux. superseded : ce nom a été remplacé par une correction d'identité. Il reste valide comme référence historique — il ne disparaîtra pas — mais les occurrences futures porteront le nom de ses successeurs.

Après une scission il n'y a pas de redirection unique, et c'est pourquoi ce champ rend une liste. Si nous découvrons qu'une série mélangeait deux flux, aucun des deux successeurs n'est « la suite » de l'ancien : la moitié des occurrences de l'ancien n'est pas dans l'un d'eux. Élire un canonique serait confortable et faux.

split : cette identité en recouvrait plusieurs, et chacune a désormais la sienne. merge : cette identité et une autre étaient le même flux ; toutes deux sont remplacées par une identité neuve.

Les codes de preuve qui ont autorisé la correction. Jamais un score interne, jamais un identifiant de ligne.

Un seul après une fusion, plusieurs après une scission. Jamais vide quand status vaut superseded.

Le chemin de retour, et il compte autant que l'autre. Les identités que celle-ci remplace. Sans lui, l'ancien series_id que vous aviez stocké ne correspondrait plus à rien de ce que vous recevez, et vous n'auriez aucun moyen de faire le lien. Vide pour une série qui n'est née d'aucune correction.

D'où vient cette occurrence, et où est-elle maintenant. Quand une identité est corrigée, l'occurrence change de série : sans ce bloc, vous n'auriez aucun moyen de relier le series_id que vous aviez stocké à celui que vous recevez. Vous n'avez jamais à reconstruire le graphe vous-même.

La série à laquelle cette occurrence a été rattachée la première fois. Égale à current_series_id tant qu'aucune correction n'a eu lieu.

Les déplacements successifs, du plus ancien au plus récent. Vide pour une occurrence qui n'a jamais bougé.

Le premier jour où nous Avons observé cette série — pas le jour où elle a commencé. Une série peut tourner depuis cinq ans alors que nous ne l'observons que depuis trois mois. Il n'existe volontairement aucun champ started_at : nous ne le savons pas.

true : notre observation commence avec la première occurrence connue, donc la série a pu commencer avant nous et rien ne le montrera. false : la première occurrence connue est antérieure au début de notre observation, donc son commencement est observé et non supposé.

À quelle fréquence l'événement se répète — et rien d'autre. La cadence se déduit de la progression des périodes calendaires, pas des écarts en jours : trois mois consécutifs sont trois mois consécutifs, que les écarts vaillent 28, 30 ou 31. Et une récurrence de 28 jours n'est pas mensuelle : elle tombe une fois par mois pendant onze mois puis deux, et son jour recule à chaque cycle. Nous ne l'appelons pas monthly — cette version n'a pas de cadence pour elle, et irregular_recurring vaut mieux qu'un faux mensuel. strength est la part des cycles attendus qui portent une occurrence. Ce n'est pas une probabilité.

0 = aucune hypothèse calendaire retenue, pas « faible ».

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Où, dans chaque période, la série tend à tomber — une question différente de cadence. Une série peut être franchement mensuelle en flottant entre le 1er et le 6 : sans ce champ, « monthly » se lirait comme « le même jour chaque mois », ce qui est faux pour la majorité des séries réelles. C'est aussi ce qui donne sa largeur à expected_next_window : un prélèvement toujours au 5 justifie trois jours, un loyer qui flotte en justifie huit. Appliquer la même fenêtre aux deux ferait déclarer « en retard » une série parfaitement normale.

fixed_day_of_month : toujours autour du même jour. month_end : en fin de mois, quel que soit le nombre de jours — un prélèvement du 31 janvier, 28 février, 31 mars est un seul motif. last_business_day : le dernier jour ouvré, cas fréquent des salaires. business_day_adjusted : un jour nominal déplacé hors du week-end (samedi → vendredi, dimanche → lundi). Nous NE modélisons pas les jours fériés : ni français, ni target, ni bancaires. Un report de férié est absorbé par la tolérance de la fenêtre, pas reconnu — prétendre connaître un calendrier que nous n'avons pas serait pire que de l'ignorer. fixed_weekday : toujours le même jour de la semaine. flexible_calendar_window : une occurrence par période, sans jour stable. unknown : rien d'identifiable.

Une constante par type d'ancrage, ou une formule linéaire sur l'étendue des jours pour fixed_day_of_month et flexible_calendar_window. 0 pour unknown. Un 0,33 fixed_day_of_month et un 0,3 flexible_calendar_window ne se comparent pas — et flexible_calendar_window change de règle avec la cadence (constante 0,3 en hebdomadaire, 1 - etendue/10 en mensuel).

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Ce que nous pouvons voir, et ce que nous ne pouvons pas. insufficient signifie « notre mémoire est trop courte pour en juger », jamais « il n'y a pas d'occurrence plus ancienne ». Et il y a deux mémoires, qu'il ne faut pas confondre. raw_days (30) dit combien de temps la transaction reste lisible ; derived_days (400) dit combien de temps ce que nous avons appris d'une série lui survit. Une transaction purgée reste purgée — cette API ne la ressuscite jamais — mais la série se souvient qu'elle a eu lieu. C'est ce qui rend une cadence mensuelle confirmable alors que la transaction de janvier n'existe plus. observed_days est ce que nous avons effectivement vu : un client qui lit « monthly / sufficient » peut vérifier que la conclusion ne sort pas de trente jours.

Durée de vie de la transaction brute. Passé ce délai elle est physiquement supprimée et rien ne la rend.

Durée de vie de la mémoire de série, comptée depuis la dernière occurrence. Sans nouvelle occurrence, l'état dérivé est physiquement supprimé à l'échéance et une occurrence ultérieure ouvre une série neuve.

Étendue réellement observée, de la première à la dernière occurrence connue.

Conservé pour compatibilité : identique à raw_days.

Répond à une seule question : peut-on croire la cadence ? Pas à « sait-on quand ça a commencé », qui est le champ suivant.

Dit pourquoi first_occurrence_bounded vaut ce qu'il vaut.

Une question différente de sufficiency, et qui était confondue avec elle. true : notre observation de cette série commence avec la première occurrence que nous connaissons — elle a donc pu commencer avant nous, et rien ne le montrera jamais. false : la première occurrence connue est antérieure au début de notre observation, donc le commencement est observé et non supposé. Un import d'historique rend false ; une série découverte au fil de l'eau rend true.