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 JinDesk).
• Notiz: Eine YAML-Datei in notebook/ mit Titel, Autor, Zellen und Metadaten. Wird in den KLS kompiliert.
• Benutzereintrag: Eine Zelle, die direkt im JinDesk hinzugefuegt wird. Im OPS 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 JinDesk schreibgeschuetzt. YAML bearbeiten und neu bauen um sie zu aendern.
2. OPS-Benutzereintraege (unterer Abschnitt, “Deine Notizen”) — direkt im JinDesk erstellt und bearbeitet. In der OPS-Datei des Tenants gespeichert. Kein Rebuild noetig.

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

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

Notizen zwischen Rechnern teilen

Notizen leben im OPS (Operational Store) — ein Speicher pro Mandant, in der Cloud eine Cloudflare D1. Anders als der KLS wird er nie neu gebaut: jin make erzeugt ihn nicht neu, deshalb hilft nach einem Verlust nur eine Wiederherstellung.

jin ops backup <pack.tenant>           # Online-Backup, auch im laufenden Betrieb
jin ops restore <pack.tenant> <dir>    # bewusst destruktiv — überschreibt
jin ops sync <pack.tenant>             # vereinigt lokal ↔ Cloud (ereignis-basierte Citizens)

jin ops sync vereinigt nur, wo zwei Speicher sich nicht widersprechen können — Navigationsjournal und Run-Historie. Notizen, Desks und gespeicherte Ansichten verweigert es bewusst: dieselbe Notiz auf zwei Rechnern bearbeitet ist ein Konflikt und keine Vereinigung. Bis reconcile existiert: mit Backup und Restore umziehen oder bei einem Schreiber bleiben.

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.