Guide Notes
Les Notes sont des narratifs d’investigation avec des preuves intégrées — la couche narrative de jinflow.
Concepts
Section intitulée « Concepts »- Notebook : un par tenant. Contient toutes les notes (depuis le YAML) et les entrées utilisateur (depuis l’JinDesk).
- Note : un fichier YAML dans
notebook/avec un titre, un auteur, des cellules et des métadonnées. Compilé dans le KLS. - Entrée utilisateur : une cellule ajoutée directement dans l’JinDesk. Stockée dans le OPS.
- Cellule : une entrée dans une note ou la section utilisateur — narrative, view, reference, discussion ou action.
Deux sources, une page
Section intitulée « Deux sources, une page »La page notebook (/{tenant}/notebook) affiche le contenu de deux sources :
- Notes KLS (section haute) — compilées depuis les fichiers YAML lors de
jinflow make. Lecture seule dans l’JinDesk. Éditez le YAML et reconstruisez pour les modifier. - Entrées utilisateur OPS (section basse, « Your notes ») — créées et éditées directement dans l’JinDesk. Stockées dans le fichier OPS du tenant. Pas de rebuild nécessaire.
Si les entrées OPS ont changé depuis le dernier build, une bannière de drift apparaît : « Unpublished changes — notes have been modified since the last build. »
Édition dans l’JinDesk
Section intitulée « Édition dans l’JinDesk »Créer des entrées
Section intitulée « Créer des entrées »Utilisez les boutons de la barre d’outils en haut de la section « Your notes » :
| Bouton | Crée |
|---|---|
| + Note | Une cellule narrative (Markdown supporté) |
| + Discussion | Un fil de discussion vide |
| + Action | Une tâche suivie avec responsable |
Éditer des narratifs
Section intitulée « Éditer des narratifs »Survolez une cellule narrative pour révéler le bouton edit (en haut à droite). Cliquez pour passer en éditeur inline. Modifiez le texte et cliquez Save.
Supprimer des entrées
Section intitulée « Supprimer des entrées »Survolez n’importe quelle cellule pour révéler le bouton delete (en haut à droite). Cliquez pour supprimer la cellule. C’est immédiat — pas de dialogue de confirmation.
Réponses discussion
Section intitulée « Réponses discussion »Cliquez + Add reply en bas d’un fil de discussion. Tapez votre réponse et cliquez Reply.
Statut action
Section intitulée « Statut action »Cliquez le badge de statut sur une cellule action pour basculer entre proposed et completed.
Ajouter des findings au notebook
Section intitulée « Ajouter des findings au notebook »Sur n’importe quelle page de détail de Finding, cliquez Add to notebook. Cela crée :
- Une cellule reference pointant vers le Signal
- Une cellule narrative avec l’interprétation du Finding (ou l’explication IA si générée)
Fichiers Note (YAML)
Section intitulée « Fichiers Note (YAML) »Les notes vivent dans le répertoire notebook/ de l’AFS sous forme de fichiers YAML :
afs/notebook/ nb_io_article_reconciliation.yaml nb_zufferey_taxonomy_provenance.yamlLe nom de fichier doit correspondre au notebook_id dans le YAML.
Types de cellule
Section intitulée « Types de cellule »| Type | Usage | Contenu |
|---|---|---|
| narrative | Observation ou analyse en texte libre | Markdown (trilingue) |
| view | Lien vers une page dimension/findings | Page cible + filtres/tri |
| reference | Lien vers un Signal, Thesis, Entity, SMEbit | Kind + ID cible |
| discussion | Conversation en fil | Auteur, date, texte par message |
| action | Tâche suivie | Statut, responsable, description, résultat |
Écrire une Note (YAML)
Section intitulée « Écrire une Note (YAML) »notebook_id: nb_my_investigationversion: "1"title: en: "My Investigation" de: "Meine Untersuchung"author: name: "Analyst Name" role: "Role" date: "2026-03-19"scope: tenant_id: "*" time_range: "2024"status: activetags: [investigation, material-flow]
cells: - id: context type: narrative content: en: | ## Context This note documents...
- id: view_top_delta type: view description: en: "Top articles by value delta" target: page: dimensions entity: io_article_reconciliation sort: value_delta order: desc filters: - column: year value: "2024"
- id: ref_io_probe type: reference kind: probe target: probe_io_coefficient note: en: "Monthly I/O coefficient per material"
- id: action_mapping type: action status: proposed assignee: "Operations" description: en: "Fill in the ABT→KST mapping"
- id: discussion type: discussion thread: - author: "Analyst" date: "2026-03-19" text: en: "We should investigate further."Partager des notes entre machines
Section intitulée « Partager des notes entre machines »Les notes vivent dans l’OPS (Operational Store) — un magasin par tenant, une
base Cloudflare D1 dans le cloud. Contrairement au KLS, il n’est jamais
reconstruit : jin make ne le régénère pas, donc après une perte, seule une
restauration permet de revenir.
jin ops backup <pack.tenant> # sauvegarde à chaud, sans interruptionjin ops restore <pack.tenant> <dir> # délibérément destructif — écrasejin ops sync <pack.tenant> # union local ↔ cloud (citizens événementiels)jin ops sync n’unifie que là où deux magasins ne peuvent pas se contredire :
le journal de navigation et l’historique des Runs. Il refuse délibérément
les notes, les desks et les vues enregistrées : la même note modifiée sur deux
machines est un conflit, pas une union. En attendant reconcile, déplacez-les
par sauvegarde/restauration ou gardez un seul auteur.
Deep links
Section intitulée « Deep links »Lier directement à une note :
/millesime.domaine_zufferey/notebook?note=nb_zufferey_taxonomy_provenanceCliquer sur une carte note dans l’index met aussi à jour l’URL pour le partage.
Cellules view depuis les vues sauvegardées
Section intitulée « Cellules view depuis les vues sauvegardées »Utilisez le bouton copier-en-YAML sur les pilules de vue sauvegardée pour générer une cellule view :
- id: view_year_2024 type: view description: en: "year=2024, sorted by value delta" target: page: dimensions entity: io_article_reconciliation params: "f.year=2024&sort=value_delta&order=desc"Collez dans n’importe quel fichier note sous cells:.