GuidoandClaude Opus 5
c1561acdce
Die staendige Meldung "weicht ab" hatte mehrere Quellen, und eine davon war ueberhaupt keine Abweichung. 1. Ein VERFUEGBARER Saldo enthaelt Vorgemerktes. Certain bucht Vorgemerktes bewusst nicht – es kaeme spaeter mit anderer Kennung ein zweites Mal. Beides zu vergleichen musste also dauerhaft danebengehen. Verglichen wird jetzt nur noch ein GEBUCHTER Saldo (CLBD, ITBD, PRCD); sonst steht dort "verfuegbarer Saldo, nicht vergleichbar" und keine Abweichung. 2. Die Saldi wurden VOR den Umsaetzen geholt und sofort geschrieben. Brach der Umsatz-Abruf danach ab, stand ein aktueller Saldo neben altem Bestand – und die Anzeige meldete eine Abweichung, die nur aus der Reihenfolge kam. Sie kommen jetzt zuletzt. Ohne Kontozuordnung weiterhin zuerst: Dort gibt es keine Umsaetze zu holen, und bei mehreren gleich aussehenden Pockets ist der Betrag das Einzige, woran man sie unterscheidet. 3. Jeder weitere Abruf griff nur drei Tage hinter den letzten zurueck. Banken buchen mitunter spaeter zurueck; was einmal ausserhalb lag, kam nie wieder. Jetzt sieben Tage – doppelt holen kostet nichts, die Kennung des Umsatzes faengt es exakt ab. Damit ist die Anzeige nicht mehr nur ehrlicher, sondern zeigt auch wieder auf etwas: Steht dort eine Abweichung, ist sie echt. 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