GuidoandClaude Opus 5 60b8178c57 fix: Mails vor der Einrichtung waren fuer immer ausserhalb des Suchfensters
Der Zeitstempel des letzten Abrufs wird auch dann gesetzt, wenn ein Abruf
nichts fand – und danach sucht Certain nur noch ab gestern. Wer das Postfach
einrichtet, nachdem die Mails schon da waren, findet sie nie: Der erste,
ergebnislose Abruf schiebt das Fenster an ihnen vorbei.

Jetzt gibt es "Aelteres nachholen": Es sucht die letzten 90 Tage und uebergeht
den Zeitstempel. Dass dabei nichts doppelt ankommt, sichert wie bisher die
Message-ID.

Ausserdem sagt die Meldung jetzt, AB WANN gesucht wurde. Bisher stand dort
"Stimmt der Ordner?" – die Frage war fast immer die falsche.

Und ein latenter Fehler, der im August nicht auffaellt: Das Suchdatum wurde mit
strftime("%b") gebaut, also mit dem Monatskuerzel in der Sprache des Servers.
IMAP verlangt die englischen; auf einem deutschen System haette die Suche im
Maerz, Mai, Oktober und Dezember nichts gefunden. Die Kuerzel stehen jetzt fest
im Code.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-27 12:59:08 +02:00

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

S
Description
No description provided
Readme
8.7 MiB
Languages
Python 55.3%
JavaScript 22.8%
Swift 16.3%
CSS 5%
Shell 0.6%