Zwei Fragen aus der Praxis, die die Anleitung nicht beantwortete.
## Der Jahresabschluss
Sie beschrieb, was in jedem Bericht steht, aber nicht die Reihenfolge und
nicht, was man vorher besorgen muss. Der neue Abschnitt beginnt deshalb
sechs Wochen vor dem Stichtag: Rueckkaufswerte und Bescheinigungen
brauchen Wochen, und wer erst am Stichtag daran denkt, geraet in Verzug.
Danach die Staende mit Quellenangabe, dann die Berichte in der
Reihenfolge, in der sie aufeinander aufbauen.
## Genossenschaftsanteile
Das Gericht fragt einen "Kontoauszug" an, den es nicht gibt: Ein
Geschaeftsguthaben ist kein Zahlungskonto, sondern eine Forderung gegen
die Genossenschaft. Es laufen keine Buchungen darueber, und ausgezahlt
wird erst nach Kuendigung der Mitgliedschaft.
Der Fall fuehrt zu einem stillen Fehler: Wer die Anteile als Konto
anlegt, kann die Bescheinigung nicht am Wert hinterlegen - genau das
Blatt, das das Gericht sehen will. Ein Saldostand traegt eine
Quellenangabe, aber kein Dokument; ein Wertstand am Vermoegensposten
schon. Deshalb steht im Text nicht nur, was zu tun ist, sondern warum -
sonst legt der naechste Leser es wieder als Konto an.
Dazu der Hinweis, dass "der Wert bleibt doch gleich" nicht traegt: Wird
eine Dividende dem Geschaeftsguthaben gutgeschrieben statt ausgezahlt,
waechst es. Genau deshalb fragt man jaehrlich nach, statt den
Vorjahreswert fortzuschreiben.
Eine Uebersicht behandelt die verwandten Faelle mit - Bausparvertrag,
Depot, Verbindlichkeit. Das Depot ist die Ausnahme: Dort laufen Umsaetze,
es gibt einen Auszug, es ist ein Konto. Versicherungen gehoeren an den
Vertrag, nicht ins Vermoegen.
Zehn Pruefungen in tests/anleitung.test.ts, gegen vier Mutationen
geprueft: als Konto geraten, Dividendenhinweis entfernt, Vorlauf
entfernt, Abschnitt entfernt - jede wird rot.
Refs #55
Aus einer Fehlersuche am 31.08.2026 sind vier Luecken in der Anleitung
uebriggeblieben. Keine davon war falsch formuliert - alle vier waren
schlicht nicht durchdacht.
1. Es stand nirgends, wo die Daten liegen. Der neue Abschnitt nennt die
drei Orte, zeigt den Pfad auf der Platte, sagt ausdruecklich, dass dort
keine anklickbaren PDFs liegen, und beschreibt den Abgleich zwischen
Akte und Speicher: Zu jedem Eintrag muss eine Datei gehoeren, sonst
belegt eine Pruefsumme ein Dokument, das es nicht mehr gibt.
2. Der mc-Alias wurde einmalig gesetzt. Er liegt in /root/.mc IM
Behaelter und ist nach jedem "docker compose up -d minio" weg -
"mc ls lokal" liefert dann kommentarlos nichts, und man haelt seine
Dokumente fuer verschwunden. Genau das ist passiert. Jeder Aufruf setzt
den Alias jetzt selbst, aus den Variablen des Behaelters.
3. Der Bucket-Name stand fest im Befehl, die Anwendung liest ihn aus
S3_BUCKET. Weichen sie ab, zeigen beide aneinander vorbei.
4. "set -a && source .env" wurde empfohlen, ohne zu sagen, dass die
exportierten Werte danach jedes "docker compose up" ueberstimmen. Wer
spaeter die .env aendert und neu startet, sieht keine Wirkung und sucht
den Fehler ueberall, nur nicht in der eigenen Shell. Der Kniff ist
nicht mehr noetig - der neue Befehl kommt ohne ihn aus - und die Falle
steht als Erklaerung daneben.
Dazu docker-compose.override.yml in der .gitignore und in der Anleitung
als vorgesehener Ort fuer Anpassungen, die ein Update ueberleben sollen:
update.sh prueft nur versionierte Dateien und laesst sie in Ruhe.
Die Aussage zur Sicherung ist mitgezogen - sie stimmt seit #41 nicht mehr,
die Dokumente sind jetzt enthalten.
Neun Pruefungen in tests/anleitung.test.ts, gegen vier Mutationen
geprueft: Name fest verdrahtet, Alias nicht gesetzt, source .env zurueck,
Abschnitt entfernt - jede wird rot.
Refs #46
Florian Wilde