Glossaire de la disponibilité et de la demande de séjour

Critère impératif, flexible ou absent

Un critère impératif doit être respecté par le résultat principal. Un critère flexible peut varier dans une borne acceptée. Un critère absent n’entre pas dans la décision. Ces trois états évitent de traiter un champ vide comme une autorisation d’inventer.

Exemple : une date d’événement est impérative, la commune d’hébergement peut varier dans un rayon défini, et la présence d’une piscine peut être absente du besoin.

Résultat principal

Offre qui satisfait tous les critères impératifs de la requête. Elle conserve l’hébergement, les dates, la capacité, le total, la fraîcheur et le responsable de confirmation.

Si aucun résultat ne respecte les impératifs, le bon état est “aucune correspondance exacte”. Une alternative ne doit pas prendre la place du résultat principal sans explication.

Alternative expliquée

Résultat qui diffère d’au moins un critère et peut être proposé séparément parce que l’écart est visible : autres dates, autre zone, autre durée, autre accès ou autre total. Le voyageur accepte explicitement cet écart.

Une alternative n’est pas un résultat dégradé caché. Elle permet d’explorer sans faire croire que la demande initiale a été satisfaite.

Offre de séjour

Ensemble suffisamment complet pour être examiné : hébergement identifié, arrivée, départ, nombre de nuits, capacité, stock, prix total, prestations, conditions, fraîcheur et personne qui confirme.

Une photographie, un prix par nuit ou une période libre ne forment pas seuls une offre. Les éléments obligatoires doivent porter sur le même séjour.

Disponibilité déclarée

Stock communiqué manuellement par un rôle habilité, associé à une date de vérification et à une expiration. Il décrit ce qui était connu au moment du contrôle.

Une déclaration n’est ni une garantie temps réel ni une réservation. À l’expiration, elle disparaît du résultat courant jusqu’à une nouvelle vérification.

Disponibilité synchronisée

État dérivé d’une source relue selon une fréquence et un contrat connus. L’interface indique la dernière synchronisation réussie, la source et l’âge du snapshot.

La synchronisation peut réduire les doubles saisies, mais conserve un délai. Une source indisponible ou partielle ne doit pas être interprétée comme un calendrier libre.

Temps réel démontré

Capacité dont le délai est mesuré de bout en bout entre la mutation source et l’état visible, avec traitement des pannes, doublons et messages en retard. Une fréquence élevée de lecture ne suffit pas à établir cette preuve.

Le terme doit rester borné au périmètre réellement qualifié. TOO NICE TO MISS ne revendique actuellement aucune disponibilité temps réel publique.

Fraîcheur

Âge de la dernière donnée complète et valide par rapport au moment où elle est utilisée. La fraîcheur dépend du risque : une information descriptive peut durer, un dernier stock demande un contrôle plus récent.

L’heure de téléchargement, l’heure déclarée par la source et l’heure de publication sont des repères différents. Ils doivent rester traçables.

TTL et expiration

Le TTL est la durée pendant laquelle une donnée peut rester utilisable sans nouvelle validation. L’expiration est le moment où elle cesse d’être présentée comme courante.

Une expiration n’efface pas l’historique. Elle retire l’offre des résultats actifs et impose une nouvelle vérification avant republication.

iCalendar et fichier .ics

iCalendar est un format d’échange d’événements défini par la RFC 5545. Dans l’hébergement, il sert souvent à représenter des périodes occupées ou bloquées.

Le format ne garantit ni fréquence de mise à jour, ni prix, ni capacité, ni offre commerciale. Une date absente ne prouve pas qu’elle est réservable.

UID, DTSTART, DTEND et révision

UID identifie un événement dans le contexte de sa source. DTSTART et DTEND bornent sa période. DTSTAMP, LAST-MODIFIED ou SEQUENCE peuvent aider à suivre une révision lorsqu’ils sont présents.

Le type de date et le fuseau changent l’interprétation. Une valeur invalide, une fin antérieure au début ou un identifiant manquant part en quarantaine plutôt que d’être corrigé par supposition.

Snapshot

Représentation versionnée et cohérente d’un état à un instant. Un snapshot public peut contenir des périodes ou offres agrégées sans exposer le flux confidentiel ni les données d’un voyageur.

La publication atomique remplace le snapshot courant en une seule bascule. Le lecteur voit l’ancienne version complète ou la nouvelle, jamais un mélange.

Provenance

Information qui relie une donnée à son producteur, son canal, sa version et sa date de collecte. Elle permet de savoir qui peut corriger l’état et quelles limites lui appliquer.

Une offre sans provenance ne permet ni d’évaluer sa fraîcheur ni d’attribuer la confirmation. Elle doit rester non vérifiable.

Propriétaire de synchronisation

Unique système autorisé à relire et réconcilier une source de calendrier pour un logement. Cette règle évite deux pollers concurrents, les boucles d’import/export et les blocages fantômes.

Un autre produit consomme un snapshot qualifié ou reste hors du circuit. Il ne crée pas son propre connecteur vers la même source par commodité.

Système canonique de stock

Source de référence qui applique les mutations qu’elle possède : publication, hold, confirmation, retrait ou correction. Elle garantit la cohérence locale de ces opérations.

Elle ne connaît pas instantanément une réservation externe non transmise. La provenance et la fraîcheur des imports restent donc nécessaires.

Hold

Blocage temporaire interne du stock pendant la décision de l’hébergeur ou une étape bornée du parcours. Il protège le dernier stock contre deux demandes concurrentes.

Un hold TNTM est atomique, idempotent et expirable dans le système D1. Il n’est ni une confirmation, ni un paiement, ni un contrat ; sa présence ne prouve aucun séjour réel.

Atomicité

Propriété selon laquelle une opération critique se réalise entièrement ou pas du tout. Pour le stock, la vérification et la création du hold doivent appartenir à la même transaction.

Sans atomicité, deux demandes peuvent lire la même nuit comme libre puis la consommer toutes les deux.

Idempotence

Propriété selon laquelle répéter la même commande avec la même clé produit le même effet final. Un retry réseau ne doit pas créer une seconde demande ou débiter deux fois.

La clé relie l’action à son intention stable. Elle ne doit pas contenir de donnée personnelle exposée publiquement.

Demande

Expression de l’intention du voyageur sur une offre versionnée. Elle conserve les dates, l’hébergement, le total et les conditions qui ont été présentés.

La réception d’une demande ne signifie pas que le stock est confirmé. L’état reste compréhensible : reçue, en attente, confirmée, refusée ou expirée.

Confirmation

Décision explicite de l’hébergeur ou du canal autorisé d’accepter la demande selon l’offre et les conditions. Elle identifie ce qui est confirmé et les prochaines étapes.

Un accusé technique, un email envoyé ou un hold ne constituent pas automatiquement une confirmation.

Réservation

Engagement créé selon le contrat du professionnel, le canal et les conditions applicables. Sa formation ne se déduit pas du vocabulaire technique interne.

Le guide emploie “demande” jusqu’à la décision de l’hébergeur. TNTM ne crée aucune réservation automatique et aucune réservation humaine non synthétique n’est encore prouvée.

Prix total

Montant obligatoire calculable pour les dates, voyageurs et prestations sélectionnés. Il réunit les composantes imposées avant l’engagement.

La caution remboursable et les options facultatives non choisies restent séparées. Un prix par nuit ou “à partir de” n’est pas un total.

Caution et option

La caution est une somme ou garantie liée aux conditions du séjour, avec modalités de conservation ou restitution. Elle ne doit pas être confondue avec le prix consommé.

Une option est une prestation facultative choisie explicitement. Si elle devient obligatoire pour le séjour, son coût entre dans le total.

Capacité

Nombre de personnes que l’hébergement peut accueillir selon son descriptif et ses règles. La capacité maximale ne garantit pas un confort ou une configuration adaptés au groupe.

Le voyageur vérifie couchages, pièces, sanitaires et éventuelles limites par catégorie d’occupant.

Dernier kilomètre

Trajet entre la gare, l’arrêt ou le parking et l’entrée réelle de l’hébergement. Il comprend temps, mode, coût, horaires et accessibilité.

Une distance courte ne suffit pas à qualifier le chemin. Le coût total du séjour peut changer si un taxi, une navette ou plusieurs titres sont nécessaires.

Canal direct, plateforme et comparateur

Le canal direct relie le voyageur à l’hébergeur. Une plateforme peut centraliser recherche, demande, réservation ou paiement selon son rôle. Un comparateur rapproche plusieurs sources puis redirige souvent vers un vendeur.

Le lecteur identifie toujours qui vend, confirme, encaisse et assiste. Une interface similaire ne signifie pas un contrat identique.

OTA et channel manager

Une OTA est une agence de voyages en ligne qui distribue des offres selon son modèle. Un channel manager aide un hébergeur à gérer stock, tarifs ou réservations entre plusieurs canaux.

Ces catégories décrivent le marché. Elles ne prouvent aucune intégration TOO NICE TO MISS. Aucun partenaire ou connecteur OTA réel n’est annoncé.

Classement et classement acheté

Le classement ordonne des résultats selon des critères annoncés. Un placement payé ou sponsorisé doit être distingué du résultat organique.

Une alternative ne doit pas être remontée parce qu’elle génère davantage de revenu. Le guide n’utilise aucun classement commercial caché.

Fail-closed

Comportement qui ferme ou masque une capacité lorsque sa preuve, sa configuration ou sa source manque. Il préfère l’absence à une donnée inventée.

Pour TOO NICE TO MISS, l’absence de preuve de profils publics maintient le CTA applicatif masqué ; l’absence de stock réel interdit toute offre présentée comme réservable.

Archive, expiration et noindex

Une archive conserve une information passée pour la traçabilité. Elle ne sert plus de contenu courant lorsque sa date est dépassée.

Une page expirée ou insuffisante peut rester accessible avec `noindex` et un repli vers la source officielle. Elle sort du sitemap jusqu’à une nouvelle revue substantielle.

Correction et rollback

La correction suspend une offre fausse, répare la source de vérité et republie après validation. Le rollback restaure une version technique précédente cohérente.

Un rollback ne rajeunit pas le stock. Une disponibilité ancienne reste expirée même si l’artefact qui la contient fonctionne techniquement.

Sources, date et usage du glossaire

Les définitions iCalendar s’appuient sur la RFC 5545. Les notions de prix, plateforme et hébergement renvoient aux sources DGCCRF, Légifrance, EUR-Lex et Atout France. Les termes techniques sont définis comme méthodes, pas comme fonctions publiques actives.

Dernière révision humaine : 25 août 2026. Une évolution du produit ou d’une source peut imposer une nouvelle définition et une mise à jour des pages liées.

Une correction peut être proposée avec un terme, une URL publique et une source, sans identité, dates de séjour, flux iCalendar ou donnée de paiement.