Notizen Guide

Notizen sind Untersuchungsnarrative mit eingebetteter Evidenz — die Story-Ebene von jinflow.

Konzepte

• Notebook: Eines pro Tenant. Enthaelt alle Notizen (aus YAML) und Benutzereintraege (aus dem Explorer).
• Notiz: Eine YAML-Datei in notebook/ mit Titel, Autor, Zellen und Metadaten. Wird in den KLS kompiliert.
• Benutzereintrag: Eine Zelle, die direkt im Explorer hinzugefuegt wird. Im SIS gespeichert.
• Zelle: Ein Eintrag innerhalb einer Notiz oder des Benutzerbereichs — narrative, view, reference, discussion oder action.

Zwei Quellen, eine Seite

Die Notebook-Seite (/{tenant}/notebook) zeigt Inhalte aus zwei Quellen:

1. KLS-Notizen (oberer Abschnitt) — aus YAML-Dateien waehrend jinflow make kompiliert. Im Explorer schreibgeschuetzt. YAML bearbeiten und neu bauen um sie zu aendern.
2. SIS-Benutzereintraege (unterer Abschnitt, “Deine Notizen”) — direkt im Explorer erstellt und bearbeitet. In der SIS-Datei des Tenants gespeichert. Kein Rebuild noetig.

Wenn sich SIS-Eintraege seit dem letzten Build geaendert haben, erscheint ein Drift-Banner: “Unveroeffentlichte Aenderungen — Notizen wurden seit dem letzten Build geaendert.”

Explorer-Bearbeitung

Eintraege erstellen

Verwende die Toolbar-Buttons am oberen Rand des “Deine Notizen”-Abschnitts:

Button	Erstellt
+ Notiz	Eine narrative Zelle (Markdown unterstuetzt)
+ Diskussion	Ein leerer Diskussionsthread
+ Aktion	Eine verfolgte Aufgabe mit Verantwortlichem

Narrative bearbeiten

Fahre ueber eine narrative Zelle um den Bearbeiten-Button (oben rechts) anzuzeigen. Klicke um zum Inline-Editor zu wechseln. Text aendern und Speichern klicken.

Eintraege loeschen

Fahre ueber eine Zelle um den Loeschen-Button (oben rechts) anzuzeigen. Klicke um die Zelle zu entfernen. Dies geschieht sofort — kein Bestaetigungsdialog.

Diskussionsantworten

Klicke auf + Antwort hinzufuegen am unteren Ende eines Diskussionsthreads. Antwort eingeben und Antworten klicken.

Aktionsstatus

Klicke auf das Status-Badge einer Aktionszelle um zwischen proposed und completed umzuschalten.

Findings zum Notebook hinzufuegen

Auf jeder Finding-Detailseite, klicke Zum Notebook hinzufuegen. Dies erstellt:

• Eine Reference-Zelle, die auf das Signal zeigt
• Eine narrative Zelle mit der Finding-Interpretation (oder KI-Erklaerung wenn generiert)

Notiz-Dateien (YAML)

Notizen leben im AFS-Verzeichnis notebook/ als YAML-Dateien:

afs/notebook/
  nb_io_article_reconciliation.yaml
  nb_zufferey_taxonomy_provenance.yaml

Dateiname muss mit der notebook_id im YAML uebereinstimmen.

Zelltypen

Typ	Zweck	Inhalt
narrative	Freitext-Beobachtung oder Analyse	Markdown (dreisprachig)
view	Link zu einer Dimensions-/Findings-Seite	Zielseite + Filter/Sortierung
reference	Link zu Signal, Thesis, Entity, SMEbit	Art + Ziel-ID
discussion	Gesprächsthread	Autor, Datum, Text pro Nachricht
action	Verfolgte Aufgabe	Status, Verantwortlicher, Beschreibung, Ergebnis

Eine Notiz schreiben (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."

SIS-Merge-Protokoll

Zwei Analysten, die unabhaengig arbeiten, koennen ihre SIS-Notebooks mergen:

# Events aus Analyst B's SIS exportieren
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --export-events events_b.json

# In Analyst A's SIS importieren
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --import-events events_b.json

# Oder direkt aus einer anderen SIS-Datei mergen
python3 scripts/sisdb.py --pack millesime --tenant domaine_zufferey --merge /path/to/other_sis.duckdb

Der Merge erfolgt auf Event-Ebene: Union nach event_id (global eindeutig), keine Konflikte.

Deep Links

Direkt zu einer Notiz verlinken:

/millesime.domaine_zufferey/notebook?note=nb_zufferey_taxonomy_provenance

Klick auf eine Notizkarte im Index aktualisiert ebenfalls die URL zum Teilen.

View-Zellen aus gespeicherten Views

Verwende den Als-YAML-kopieren-Button auf gespeicherten View-Pillen um eine View-Zelle zu generieren:

  - 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"

In jede Notiz-Datei unter cells: einfuegen.