File-first: Dateien sind die Quelle der Wahrheit

Die Dateneinheit in Notarium ist eine gewöhnliche Markdown-Datei auf deiner Festplatte. Kein Datensatz in einer fremden Datenbank, kein Block in einem proprietären Speicher, sondern eine Datei, die sich in jedem Editor öffnen lässt — und die auch ohne Notarium vollständig bleibt. Das ist das File-first-Prinzip, aus dem alles Weitere folgt.

Was „Wahrheit“ ist und was abgeleitet ist

Die Quelle der Wahrheit sind die .md-Dateien selbst. Alles, was sich aus ihrem Inhalt berechnen lässt, ist abgeleitet und wiederherstellbar:

• abgeleitet (wird bei einem erneuten Scan von Grund auf neu aufgebaut): der Suchindex, der [[wikilinks]]-Graph, der Baum, die Snippets. Den Index zu löschen ist unbedenklich — die Engine indexiert die Dateien beim nächsten Start neu;
• nicht ableitbar (liegt in einer separaten Metadaten-Datenbank): Versionsverlauf, Benutzer, Mitgliedschaft und Zugriffe. Genau das lässt sich aus dem Text der Dateien nicht wiederherstellen — deshalb ist es an einen einzigen, klar abgetrennten Ort ausgelagert.

Die Identität dagegen ist in den Dateien selbst verankert: Die notarium-id einer Notiz steht in ihrem Frontmatter, die Kennungen von Space und Projekt stehen in Marker-Dateien (.notariummeta). Deshalb sind die Space- und Projekt-Tabellen in der Metadaten-Datenbank ein per Scan wiederherstellbarer Cache und nicht der alleinige Ort der Identität: Diese bleibt sogar dann erhalten, wenn der Ordner außerhalb von Notarium verschoben wird.

Eine externe Änderung wird auch dann erkannt, wenn die Datei ihre bisherige Größe und Änderungszeit behält — und genau so ist es nach einem git checkout, einer Synchronisation oder einer Wiederherstellung aus einem Archiv. Notarium nimmt die Metadaten einer Datei nicht für bare Münze: Das letzte Wort hat der Inhalt. So richten sich die abgeleiteten Ansichten (Liste, Suche, Graph) nach dem tatsächlichen Stand auf der Festplatte, statt an einer veralteten Version hängen zu bleiben.

Eine Datei-Notiz, kein Block

Diese Grenze ist bewusst gezogen: Die Dateneinheit ist die ganze Datei-Notiz, kein Absatz und kein Block darin. Notarium führt keine eigenen Entitäten unterhalb der Dateiebene ein — die Notiz als Ganzes bleibt die kleinste Einheit; genau an diesem Punkt wechseln dateibasierte Notiz-Apps üblicherweise zu einer Datenbank als Quelle der Wahrheit und verlieren ihre Portabilität. Eine Notiz bleibt eine Datei, und die Struktur darin ist einfach Markdown.

Notizen werden als GitHub Flavored Markdown gerendert; Metadatenfelder liegen im Frontmatter am Anfang der Datei.

Die Identität übersteht den Umzug

Jede Notiz hat eine stabile interne Kennung, die notarium-id — einen 12 Zeichen langen, URL-sicheren Schlüssel im Frontmatter der Datei:

---
notarium-id: aB3kR7xQ_2mv
title: Meine Notiz
---

Der Text der Notiz in gewöhnlichem Markdown.

Die Identität lebt in der Datei selbst, nicht nur in einer Datenbank. Deshalb verwaisen Versionsverlauf und Verknüpfungen weder beim Umbenennen noch beim Verschieben zwischen Ordnern — und nicht einmal dann, wenn die Datei an Notarium vorbei nach außen wandert: Protokoll und Verweise hängen an der notarium-id, nicht am Pfad. Der Dateiname ist abgeleitet (kebab-case per Transliteration, slug(title).md) und ist nicht die Identität.

Kein Lock-in

Du kannst den Ordner mit den Dateien jederzeit mitnehmen und gehen — ohne Notarium bleiben die Notizen lesbar und vollständig. Einen separaten Export brauchst du dafür nicht: Du bist ja nie „drinnen“ — deine Daten liegen immer als gewöhnliche Dateien auf deiner Festplatte. git kann die Quelle der Wahrheit sein: Versioniere den Ordner, synchronisiere ihn, lies die Historie mit den Werkzeugen, die du ohnehin nutzt.

Darauf beruht auch die Privatsphäre von Notarium: nicht auf Ende-zu-Ende-Verschlüsselung (der intelligente Server sieht die Inhalte bewusst — sonst gäbe es weder Suche noch Semantik noch Agenten), sondern darauf, dass du Server und Dateien selbst in der Hand behältst. Mehr dazu unter Spaces und Projekte und Zugriffsmodell.