1.9 KiB
FixFin
Kleine responsive Webapp für monatliche Fixplanung ohne Buchungsverlauf und ohne Kontostände.
Datenmodell
- Konten: nur Name / Zuordnung
- fixe Eingänge: Bezeichnung, Betrag pro Monat, Konto
- fixe Ausgänge: Bezeichnung, Betrag pro Monat, Konto
- fixe Transfers: Bezeichnung, Betrag pro Monat, Quellkonto, Zielkonto
- kein Datum
- keine einmaligen Buchungen
- keine Datenbank
- Speicherung ausschließlich in
finance.json
Berechnung
Je Konto:
Eingänge - Ausgänge + Transfers rein - Transfers raus = monatlicher Kontosaldo
Gesamt:
alle Eingänge - alle Ausgänge = monatlicher Gesamtsaldo
Interne Transfers verändern den Gesamtsaldo nicht.
Lokal starten
chmod +x start-local.sh
./start-local.sh
Die App läuft standardmäßig auf http://127.0.0.1:3000 und speichert lokal in .local-data/finance.json.
Docker-Server
Persistente Daten:
/srv/docker/fixfin/data/finance.json
Compose / Anwendung:
/opt/docker-infra/fixfin
Installation:
sudo chmod +x install.sh
sudo ./install.sh
Danach: http://DOCKER-SERVER-IP:3080
Build + Push in Gitea Container Registry
Vor dem ersten Push:
sudo docker login git.example.de
Dann:
sudo ./build-and-push-gitea.sh git.example.de owner/fixfin latest
Das Image wird als git.example.de/owner/fixfin:latest gepusht.
Standardplattform ist linux/amd64. Abweichend z. B.:
sudo PLATFORM=linux/arm64 ./build-and-push-gitea.sh git.example.de owner/fixfin latest
Registry-Image deployen
cd /opt/docker-infra/fixfin
sudo FIXFIN_IMAGE=git.example.de/owner/fixfin:latest docker compose -f docker-compose.registry.yml up -d
JSON-Migration
Alte FixFin-v1-Dateien mit balance in Konten werden automatisch auf v2 migriert. Die alten Kontostände werden entfernt; Eingänge, Ausgänge und Transfers bleiben erhalten. Vor dem Umschreiben wird finance.json.bak angelegt.