Définit les jeux de données, métriques, jugements, expériences, surveillance, diagnostics et seuils d'acceptation pour la fraîcheur. Cette référence fixe la limite d'adoption, le comportement en cas d'échec et les preuves observables tout en laissant les limites spécifiques à l'environnement configurables.
Statut du package : contexte de référence prêt pour revue humaine. Le contrat et les scénarios de test sont complets, mais aucune affirmation n'est faite qu'une implémentation adoptante les ait validés.
Décision
Pour la Fraîcheur, adopter un contrat de pertinence versionné évalué sur des jugements représentatifs. Traiter le bloc comme un contrat de publication et de régression construit à partir de cas positifs, limites, refus, échecs et récupération représentatifs. Ce package est un contrat de référence : l'équipe adoptante doit choisir les limites numériques, fournisseurs, juridictions et responsables opérationnels à partir des preuves dans son propre environnement.
Portée
- Les acteurs, entrées, sorties, états, versions de politique ou de schéma, et résultats visibles de l'extérieur décrits par ce bloc de test Fraîcheur.
- Interfaces principales et alternatives, travaux en arrière-plan, caches, intégrations, chemins de support et preuves pouvant exercer la même limite.
- Configuration spécifique à l'adoption, déploiement, récupération et responsabilités de vérification nécessaires pour appliquer la référence en toute sécurité.
Hors de ce bloc
- Choisir un fournisseur universel, cadre, juridiction, seuil numérique, période de rétention ou objectif de niveau de service pour chaque adoptant.
- Affirmer que les scénarios packagés ont été exécutés contre une implémentation en aval ou que cette référence accorde une certification légale, de sécurité ou d'accessibilité.
Contrat
- Définir l'interprétation des requêtes, l'éligibilité des candidats, les signaux de classement, le départage, les filtres et les solutions de repli indépendamment d'un moteur de recherche unique.
- Appliquer les règles de locataire, d'habilitation, de visibilité et de suppression avant de retourner des résultats, extraits, suggestions, facettes ou totaux.
- Versionner les enregistrements source, documents d'index, analyseurs, configuration de classement et ensembles d'évaluation pour que les changements soient attribuables.
- Mesurer la qualité par segment d'intention et protéger la latence, les erreurs, la fraîcheur et les garde-fous zéro-résultat durant les expériences de pertinence.
- Enregistrer la version du jeu de test, l'environnement, la configuration, le résultat observé et l'emplacement des preuves pour chaque exécution décisionnelle.
- Séparer les échecs produit, échecs de dépendance, échecs d'infrastructure de test et preuves non concluantes dans les rapports.
- Définir la fraîcheur à partir du temps d'événement source, de la complétion d'ingestion, de la visibilité dans l'index et de l'observation de la requête plutôt que de l'âge du cache seul.
- Utiliser des versions source et d'index durables pour prouver la cohérence lecture-après-écriture ou la bascule ; un TTL court n'est pas une garantie de cohérence.
Conseils d'implémentation
- Construire le plus petit ensemble déterministe de jeux de test couvrant les classes de risque, puis ajouter des cas dérivés de la production uniquement après revue respectant la confidentialité.
- Modéliser les entrées, sorties, acteurs, états, invariants, effets secondaires et preuves de la Fraîcheur avant de sélectionner les détails du cadre ou du fournisseur.
- Stocker la version applicable du contrat ou de la politique Fraîcheur avec l'état matériel pour que les migrations, rejouages et décisions de support restent attribuables.
- Introduire le chemin derrière un déploiement contrôlé, comparer les résultats attendus et observés, et conserver une voie de récupération testée jusqu'à ce que les preuves d'adoption soient complètes.
Gestion des échecs et garde-fous
- Les filtres invalides ou index requis indisponibles retournent un échec clair et borné ; les enrichissements optionnels ne peuvent se dégrader que s'ils sont déclarés non autoritatifs.
- L'état Fraîcheur invalide ou contradictoire est rejeté ou mis en quarantaine ; l'implémentation ne devine jamais une valeur élargissant l'autorité ou dupliquant un effet.
- Les tentatives de nouvelle exécution sont bornées et utilisent une identité durable ; après épuisement, le travail atteint un état terminal inspectable avec un responsable imputable.
Vérification et opérations
- Exécuter la suite deux fois à partir d'un état propre et confirmer que l'ordre, les tentatives et l'exécution parallèle ne changent pas le verdict.
- Surveiller le succès, le refus, l'échec de validation, l'échec de dépendance, l'épuisement des tentatives et la récupération de la Fraîcheur par version de contrat sans dimensions sensibles de charge utile.
- Réexécuter les jeux de test positifs et négatifs appariés après des changements de politique, schéma, dépendance, migration ou limite et conserver les preuves résultantes.
Hypothèses d'adoption
- Les noms et valeurs dans l'exemple sont un jeu de test concret, pas des valeurs universelles par défaut ; les adoptants les remplacent par des preuves documentées et une propriété.
- Le système adoptant peut fournir une identité authentifiée, des versions d'opération ou d'enregistrement durables, une télémétrie bornée et un chemin contrôlé pour le changement.
Les exemples à l'apparence exécutable dans ce package sont des jeux de test et des contrats d'acceptation. Exécutez le validateur de collection pour vérifier la structure et les métadonnées, puis traduisez et exécutez les scénarios dans le dépôt cible avant d'enregistrer les preuves d'implémentation.