GuidoandClaude Opus 5
385352974c
"Aelteres nachholen" greift 90 Tage zurueck – mitten in Monate, die schon per CSV eingelesen sind. Genau davor schuetzt sonst das Startdatum, und der Knopf haengt es aus. Der Duplikatschutz faengt das nicht: Sein Schluessel enthaelt den Empfaengertext, und der lautet bei der Bank anders als im Auszug. Ergebnis: jede Zahlung des Zeitraums zweimal. Das war mein Fehler – ich habe den Knopf gebaut UND empfohlen, ohne die Sicherung zu ersetzen, die er aushebelt. Der Abruf prueft jetzt selbst: Gibt es auf dem Konto schon eine Buchung gleicher Richtung und gleichen Betrags im Umkreis von drei Tagen, die NICHT von der Bank kam, ist der Umsatz dieselbe Bewegung und wird uebersprungen. Jede vorhandene Buchung erklaert dabei hoechstens einen Umsatz – sonst verschluckte eine Kaffeezahlung alle weiteren desselben Betrags. Die Zahl der uebersprungenen steht in der Rueckmeldung. Fuer den bereits angerichteten Schaden gibt es scripts/raeume_doppelte_bankumsaetze.py: Es findet Bank-Umsaetze, die eine vorhandene Buchung wiederholen, und entfernt IMMER die von der Bank – die eigene traegt die Kategorie des Nutzers. Sie wird verworfen, nicht geloescht, damit kein spaeterer Abruf sie wiederholt. Ohne --wirklich passiert nichts; mit --wirklich wird zuerst eine Kopie der Datenbank angelegt. An nachgestellten Daten geprueft: Aus -95.80 wird -48.40, die eigenen Buchungen samt Kategorie bleiben, der echte neue Umsatz bleibt. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Certain Finance
Selbstgehostete Finanzverwaltung für Privathaushalte. Budgets, mehrere Konten (EUR und CHF), ein konfigurierbares Dashboard und Import von Kontoauszügen – lauffähig in einem Proxmox-LXC, erreichbar über eine Web-UI hinter dem eigenen Nginx Proxy Manager.
Der interne Codename/Anzeigename steht zentral an einer Stelle (
web/src/brand.js,backend/app/branding.py); der Rest ist generisch.
Stack
- Backend: FastAPI · SQLAlchemy · SQLite · Alembic · argon2 · Server-Sitzungen (Cookie)
- Frontend: React 18 · Vite · reines JSX · react-i18next (DE/EN) · Inline-SVG-Icons
- Betrieb: ein systemd-Dienst (uvicorn) liefert API und gebautes Frontend auf einem Port aus
Entwicklung (lokal)
Backend (Terminal 1):
cd backend
python3 -m venv .venv && . .venv/bin/activate # Python 3.11+
pip install -r requirements.txt
APP_DATA_DIR=./data uvicorn app.main:app --reload --port 8000
Frontend (Terminal 2):
cd web
npm install
npm run dev # http://localhost:5173 (leitet /api an :8000 weiter)
Beim ersten Start wird ein Admin angelegt (Standard admin / changeme, per
APP_ADMIN_USERNAME / APP_ADMIN_PASSWORD änderbar).
Installation im LXC (Proxmox, Debian/Ubuntu)
git clone <repo-url> /opt/certain-finance
cd /opt/certain-finance
sudo ./deploy/install.sh
Danach im Nginx Proxy Manager einen Proxy-Host auf http://<LXC-IP>:<APP_PORT>
anlegen (HTTPS via Let's Encrypt). Updates: sudo ./deploy/update.sh.
Details: docs/ARCHITECTURE.md · Fahrplan: docs/ROADMAP.md