Listen (CSV)
Eine Liste ist für alles, was kein System meldet: eine Steuerfrist, eine Rechnung, die Miete. Sie ist eine CSV-Datei, die ein Mensch führt, in einer Tabellenkalkulation oder einem Editor. Die Sonde liest sie; nota init legt zwei zum Anfangen an.
Eine Datei eintragen
Abschnitt betitelt „Eine Datei eintragen“In probe.json:
"lists": [{ "name": "buero", "path": "/etc/nota/buero.csv" }]Eine Liste kann auch an einer Adresse liegen — eine Tabelle, als CSV veröffentlicht:
"lists": [{ "name": "buero", "url": "https://…" }]Nur https, höchstens 2 MiB. Die Adresse ist oft das Geheimnis, das die Tabelle schützt; sie wird deshalb nie gemeldet oder protokolliert.
Das Format
Abschnitt betitelt „Das Format“Die erste Zeile nennt die Spalten, in beliebiger Reihenfolge. Eine Zeile ist eine Frist, ein offener Betrag oder ein wiederkehrender Betrag.
| Zeile | Spalten | Wird zu |
|---|---|---|
| Frist | ding, aufgabe, fällig; warn_tage, krit_tage, text | Fälligkeit mit Vorwarnung: in Ordnung, Warnung ab warn_tage vor der Fälligkeit (Standard: am Tag selbst), kritisch krit_tage danach (Standard: nie) |
| wiederkehrende Pflicht | dazu alle = monat, quartal oder jahr | das jeweils offene Vorkommen |
| Rechnung / Verbindlichkeit | Frist mit betrag, währung, seite (ertrag: steht dir zu; aufwand: schuldest du) | derselbe Zustand, als offener Posten |
| wiederkehrender Betrag | ding, betrag, währung, je; seite, seit, bis | ein deklarierter Preis: Miete, Retainer, eine Abschreibung, die endet |
| Schritt eines Plans | aufgabe, nach, abstand | Frist, deren Datum sich aus dem Schritt davor ergibt; siehe Pläne |
| auf jeder Zeile | name, art, teil_von | beschreibt das Ding und wozu es gehört |
Eine Zeile ohne Ding setzt das Ding der Zeile darüber fort.
Deutsche Daten (20.11.2026) und Beträge (1.428,00) werden verstanden, ebenso 2026-11-20 und 1428.00; das Trennzeichen ist ; oder , — der Export einer Tabellenkalkulation funktioniert, wie er ist. Die englischen Spaltennamen stehen auf der englischen Seite und in der Referenz.
Ein Beispiel
Abschnitt betitelt „Ein Beispiel“Fristen und Rechnungen:
ding;name;art;teil_von;aufgabe;fällig;alle;erledigt;warn_tage;betrag;währung;seite;textsteuer;Steuern;bereich;;ust-voranmeldung;10.12.2026;monat;;5;;;;Umsatzsteuer-Voranmeldung für den Vormonatsteuer;;;;einkommensteuer;31.07.2027;jahr;;30;;;;Einkommensteuererklärungkunde-a;Kunde A;kunde;;rechnung-2026-001;15.12.2026;;;0;1.190,00;EUR;ertrag;Rechnung 2026-001buero;Büro;bereich;;miete-dezember;03.12.2026;;;3;450,00;EUR;aufwand;Miete DezemberVerträge und Beträge:
ding;name;art;teil_von;betrag;währung;seite;je;seit;bismiete;Büromiete;vertrag;buero;450,00;EUR;aufwand;monat;01.01.2026;software;Software-Abos;vertrag;buero;89,00;EUR;aufwand;monat;01.01.2026;laptop;Laptop (Abschreibung);anlage;buero;66,64;EUR;aufwand;monat;01.01.2025;01.01.2028domain;example.org;vertrag;buero;15,00;EUR;aufwand;jahr;14.03.2026;kunde-a-betreuung;Betreuung Kunde A;vertrag;kunde-a;290,00;EUR;ertrag;monat;01.01.2026;Das sind Beispielzeilen aus den zwei Vorlagen, die nota init unter lists/ anlegt.
Abhaken: erledigt
Abschnitt betitelt „Abhaken: erledigt“erledigt bekommt ein Datum, wenn etwas getan ist.
- Die Frist ist dann weg.
- Ein offener Betrag wird an dem Tag gebucht, als Aufwand oder Ertrag.
- Eine wiederkehrende Pflicht rückt zum nächsten Vorkommen weiter. Das Datum gilt für das Vorkommen, das ihm am nächsten liegt; zwei Tage zu früh zählt also für das kommende.
- Die Schritte nach einem Plan-Schritt zählen ab diesem Tag.
Eine Zeile, die du aus der Datei nimmst, wird auch im Core zurückgenommen.
Eine Zeile, die sich nicht lesen lässt
Abschnitt betitelt „Eine Zeile, die sich nicht lesen lässt“Eine Zeile, die keinen Sinn ergibt, wird übersprungen und in Nota selbst genannt — mit Zeilennummer und Grund — an der Prüfung rows des Dings list:<name>. Ein Tippfehler in einem Datum bleibt nicht unbemerkt.
Ausprobieren, ohne etwas zu senden
Abschnitt betitelt „Ausprobieren, ohne etwas zu senden“./nota probe -check probe.jsonprüft die Konfiguration.
./nota probe -once probe.jsonlässt alles einmal laufen und gibt aus, was gemeldet würde.