Guide des données
Règles de lecture des enregistrements et différence entre les pages de données.
Last reviewed: 2026-04-10
Principes d'extraction
- Ne jamais inférer des faits qui ne sont pas explicitement écrits
- Normaliser les unités/l'heure/les comptages en préservant l'intention originale
- Conserver les valeurs inconnues comme null plutôt que des suppositions forcées
- Valider la cohérence date/day_number avant publication
Quelle page de données ouvrir selon la question
Choisissez la première page selon le type de réponse recherché.
La bonne page dépend de la question : changement d'aujourd'hui, tendance longue, règles de lecture ou schéma technique. En cas de doute, commencez par la checklist par problème.
Aujourd'hui
Prévision Santé
Vérifier les changements d'aujourd'hui et des derniers jours.
Long terme
Données de croissance
Revoir la tendance longue et le début d'un changement.
Technique
Spécification des données
Ouvrir la référence des champs, le pipeline et la couverture.
Règles
FAQ
Relire rapidement les règles de lecture et les hypothèses.
Entrée
Checklist par problème
Entrée quand vous ne savez pas où commencer.
Comment traiter les champs complétés ou estimés
Règles courtes de lecture pour une télémétrie réparée ou affinée.
Les pages publiques mélangent des valeurs tirées directement du journal avec des champs complétés ou affinés plus tard. En cas de doute, lisez d’abord les éléments les plus proches de la source et utilisez les valeurs dérivées comme contexte complémentaire.
- Privilégiez d’abord les champs les plus proches du texte original, comme les repas, les heures d’élimination et les mémos d’événement
- Les tags, le temps seul, la météo et certaines métriques dérivées peuvent être affinés plus tard et servent surtout de contexte complémentaire
- Une valeur estimée n’est pas une preuve, mais plutôt un indice à réexaminer
- Les valeurs inconnues restent inconnues ; les blancs ne sont pas remplis de force pour l’affichage
Comment une journée de journal devient des données structurées
Une note libre est découpée en unités plus faciles à comparer ensuite.
Une journée de journal conserve le texte libre, puis est aussi rangée dans quelques groupes plus faciles à comparer.
- Repas : les quantités du matin, du soir et le total sont stockés séparément
- Élimination : réussite, échec et moment de la journée restent distincts
- Événements de santé : soins dentaires, vomissements, visites en clinique ou moments sociaux deviennent des lignes d’événement
- Environnement : météo, visiteurs et temps seul sont reliés au même jour
- Tags : seuls des thèmes courts et faciles à retrouver sont conservés
Contrôles qualité à la publication
L'automatisation de publication valide :
- longueur du titre/corps/nombre de titres
- fuites de marqueurs TODO/TBD
- cohérence du format des liens
- cohérence frontmatter.date vs telemetry.date
Les rapports sont stockés dans logs/publish_quality_gate.jsonl.