Initial commit - Stand 26.04.2026

2026-04-26 07:51:39 +02:00
commit b29c467187
186 changed files with 39281 additions and 0 deletions
@@ -0,0 +1,77 @@
+# 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
+
+```bash
+cd buchhaltungs-app
+docker-compose up --build
+```
+
+- Frontend: http://localhost:5173
+- Backend API: http://localhost:3000
+
+### Produktion
+
+```bash
+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:
+
+```bash
+cp .env.example .env
+```