buchhaltung/README.md

SteuerFlow - Buchhaltungs-App

Dockerisierte Buchhaltungsanwendung für Steuerunterlagen, Nebenkostenabrechnungen und Gewerbe-Abrechnungen.

Features

• 📄 Dokumenten-Upload (PDF, Bilder)
• 🏷️ Kategorien: Steuer, Nebenkosten, Kredit, Hausmeister, Gewerbe
• 💰 Betrags-Erfassung pro Dokument
• 🗄️ SQLite-Datenbank (persistiert via Docker-Volume)
• 🔍 Schnelle Übersicht aller Dokumente

Schnellstart

Entwicklung

cd buchhaltungs-app
docker-compose up --build

• Frontend: http://localhost:5173
• Backend API: http://localhost:3000

Produktion

docker-compose -f docker-compose.prod.yml up --build -d

Kategorien

Kategorie	Verwendung
steuer	Elster-relevante Belege
nebenkosten	Wohngeldabrechnungen
kredit	Finanzierungsunterlagen
hausmeister	Instandhaltung & Reparaturen
gewerbe	Gewerbliche Ausgaben (ab Juli)
sonstiges	Alles andere

Technologien

• Frontend: React + Vite + Tailwind CSS
• Backend: Express + SQLite + Multer
• Container: Docker + Docker Compose

Projektstruktur

buchhaltungs-app/
├── backend/           # Express API
├── frontend/          # React App
├── docker-compose.yml # Dev-Konfiguration
└── README.md

Reverse Proxy (Produktion)

Für HTTPS hinter einem Reverse Proxy (z.B. Traefik, Nginx Proxy Manager):

1. docker-compose.prod.yml anpassen
2. Netzwerk proxy hinzufügen
3. Labels für Traefik konfigurieren

Datenbank

SQLite-Datenbank liegt unter /app/data/steuer.db im Container. Wird automatisch beim ersten Start erstellt.

Umgebungsvariablen

Kopiere .env.example zu .env und passe Werte an:

cp .env.example .env