Zum Inhalt springen

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.

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.

Die erste Zeile nennt die Spalten, in beliebiger Reihenfolge. Eine Zeile ist eine Frist, ein offener Betrag oder ein wiederkehrender Betrag.

ZeileSpaltenWird zu
Fristding, aufgabe, fällig; warn_tage, krit_tage, textFälligkeit mit Vorwarnung: in Ordnung, Warnung ab warn_tage vor der Fälligkeit (Standard: am Tag selbst), kritisch krit_tage danach (Standard: nie)
wiederkehrende Pflichtdazu alle = monat, quartal oder jahrdas jeweils offene Vorkommen
Rechnung / VerbindlichkeitFrist mit betrag, währung, seite (ertrag: steht dir zu; aufwand: schuldest du)derselbe Zustand, als offener Posten
wiederkehrender Betragding, betrag, währung, je; seite, seit, bisein deklarierter Preis: Miete, Retainer, eine Abschreibung, die endet
Schritt eines Plansaufgabe, nach, abstandFrist, deren Datum sich aus dem Schritt davor ergibt; siehe Pläne
auf jeder Zeilename, art, teil_vonbeschreibt 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.

Fristen und Rechnungen:

ding;name;art;teil_von;aufgabe;fällig;alle;erledigt;warn_tage;betrag;währung;seite;text
steuer;Steuern;bereich;;ust-voranmeldung;10.12.2026;monat;;5;;;;Umsatzsteuer-Voranmeldung für den Vormonat
steuer;;;;einkommensteuer;31.07.2027;jahr;;30;;;;Einkommensteuererklärung
kunde-a;Kunde A;kunde;;rechnung-2026-001;15.12.2026;;;0;1.190,00;EUR;ertrag;Rechnung 2026-001
buero;Büro;bereich;;miete-dezember;03.12.2026;;;3;450,00;EUR;aufwand;Miete Dezember

Verträge und Beträge:

ding;name;art;teil_von;betrag;währung;seite;je;seit;bis
miete;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.2028
domain;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.

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

Terminal-Fenster
./nota probe -check probe.json

prüft die Konfiguration.

Terminal-Fenster
./nota probe -once probe.json

lässt alles einmal laufen und gibt aus, was gemeldet würde.