Guide Notes

Les Notes sont des narratifs d’investigation avec des preuves intégrées — la couche narrative de jinflow.

Concepts

• Notebook : un par tenant. Contient toutes les notes (depuis le YAML) et les entrées utilisateur (depuis l’Explorer).
• 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’Explorer. Stockée dans le SIS.
• Cellule : une entrée dans une note ou la section utilisateur — narrative, view, reference, discussion ou action.

Deux sources, une page

La page notebook (/{tenant}/notebook) affiche le contenu de deux sources :

1. Notes KLS (section haute) — compilées depuis les fichiers YAML lors de jinflow make. Lecture seule dans l’Explorer. Éditez le YAML et reconstruisez pour les modifier.
2. Entrées utilisateur SIS (section basse, « Your notes ») — créées et éditées directement dans l’Explorer. Stockées dans le fichier SIS du tenant. Pas de rebuild nécessaire.

Si les entrées SIS 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’Explorer

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

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

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

Cliquez + Add reply en bas d’un fil de discussion. Tapez votre réponse et cliquez Reply.

Statut action

Cliquez le badge de statut sur une cellule action pour basculer entre proposed et completed.

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)

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.yaml

Le nom de fichier doit correspondre au notebook_id dans le YAML.

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)

notebook_id: nb_my_investigation
version: "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: active
tags: [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: "Hospital Administration"
    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."

Protocole de fusion SIS

Deux analystes travaillant indépendamment peuvent fusionner leurs notebooks SIS :

# Export events from analyst B's SIS
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --export-events events_b.json

# Import into analyst A's SIS
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --import-events events_b.json

# Or merge directly from another SIS file
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --merge /path/to/other_sis.duckdb

La fusion est au niveau événement : union par event_id (globalement unique), pas de conflits.

Deep links

Lier directement à une note :

/millesime.domaine_zufferey/notebook?note=nb_zufferey_taxonomy_provenance

Cliquer sur une carte note dans l’index met aussi à jour l’URL pour le partage.

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:.