Mandantenverwaltung — Mehrere Unternehmen verwalten, archivieren und wiederherstellen
Rechnungen — Erstellen, versenden, bezahlen, als PDF exportieren (§14 UStG konform)
Kundenverwaltung — Kundenstammdaten pro Mandant
Steuerberichte — USt-Voranmeldung, monatliche & quartalsweise Auswertungen
Benutzerverwaltung — Mehrere Benutzer mit Rollen (USER / ADMIN)
Audit-Log — Protokollierung aller relevanten Aktionen mit Benutzer und IP
Archiv — Archivierte Mandanten mit vollständiger Historie einsehbar
Papierkorb — Gelöschte Rechnungen wiederherstellbar

Tech Stack

React Router v7 (Framework Mode, SSR) + TypeScript
MariaDB via Prisma ORM
Cookie-Session-Auth (bcryptjs)
Tailwind CSS v4 + shadcn/ui
@react-pdf/renderer für PDF-Generierung
Docker für Datenbank und Deployment

Lokale Entwicklung

Voraussetzungen

Node.js 22+
Docker + Docker Compose

Installation

npm install

Umgebungsvariablen

.env im Projektstamm anlegen:

DATABASE_URL="mysql://annas_user:annas_password@localhost:3306/annas_rechnungen"
AUTH_SECRET="dein-zufaelliger-geheimer-string"

Datenbank einrichten

npx prisma migrate deploy   # Migrationen ausführen
npm run db:seed             # Demo-Daten einspielen (optional)

Dev-Server starten

npm run dev

Startet den Vite-Dev-Server auf http://localhost:5173.

Deployment

Erstes Deployment

1. Image bauen:

docker build -t annasrechnungsmanager:latest .

2. Secrets setzen (Shell-Exports oder .env-Datei):

export AUTH_SECRET="langer-zufaelliger-string"
export ADMIN_PASSWORD="sicheres-startpasswort"   # nur beim ersten Start

3. Stack starten:

docker compose up -d

Beim ersten Start mit gesetztem ADMIN_PASSWORD:

Prisma-Migrationen werden automatisch ausgeführt
Admin-Benutzer (username: admin) wird angelegt oder aktualisiert

4. ADMIN_PASSWORD entfernen (nach erfolgreichem Login und eigenem Passwort setzen).

Die App läuft auf http://localhost:3000.

Folge-Deployments

docker build -t annasrechnungsmanager:latest .
docker compose up -d --no-deps app

Migrationen werden beim Start automatisch angewendet. ADMIN_PASSWORD ist nicht erneut nötig.

Admin-Benutzer & Recovery

Admin-Passwort setzen (im laufenden Container)

docker exec -e ADMIN_PASSWORD=neuespasswort annas_app node scripts/setup-admin.js

Erstellt oder aktualisiert den Benutzer admin (idempotent). Mindestens 8 Zeichen.

Passwort eines beliebigen Benutzers zurücksetzen

docker exec -it annas_app node scripts/reset-password.js --username anna --password neuespasswort

Zeigt alle vorhandenen Benutzer an, wenn der angegebene Username nicht existiert.

Passwort im laufenden Betrieb ändern

Jeder eingeloggte Benutzer kann sein Passwort über das Schlüssel-Icon in der Topbar ändern (/settings/password).

Benutzerverwaltung (Admin)

Erreichbar über den Admin-Button in der Topbar (nur für Benutzer mit Rolle ADMIN).

Benutzer anlegen, bearbeiten, löschen
Rollen vergeben: USER oder ADMIN
Audit-Log einsehen (Aktion, Benutzer, IP-Adresse, Zeitstempel)

Scripts

Befehl	Beschreibung
`npm run dev`	Dev-Server starten
`npm run build`	Produktions-Build
`npm run start`	Produktions-Server starten
`npm run typecheck`	TypeScript prüfen
`npm run db:migrate`	Prisma Migrationen ausführen (Dev)
`npm run db:seed`	Demo-Daten einspielen
`npm run db:studio`	Prisma Studio öffnen
`npm run setup-admin`	Admin-Benutzer anlegen / Passwort setzen
`npm run reset-password`	Passwort eines Benutzers zurücksetzen

Beispiele (Entwicklung):

# Admin-Passwort setzen
ADMIN_PASSWORD=geheim npm run setup-admin

# Passwort zurücksetzen
npm run reset-password -- --username anna --password neuespasswort

Projektstruktur

app/
  components/         UI-Komponenten (ui/, layout/, company/, invoice/)
  lib/                Hilfsfunktionen (prisma, tax, utils, invoice-number, logger)
  routes/             Route-Dateien (React Router v7, file-based)
    admin.*           Admin-Bereich (Benutzerverwaltung, Audit-Log)
    api.*             REST-API-Routen (resource routes)
    settings.*        Benutzereinstellungen (Passwort ändern)
    archiv.tsx        Archiv-Übersicht (archivierte Mandanten)
  session.server.ts   Auth (Login via Username/E-Mail, Logout, Session)
  types/              Gemeinsame TypeScript-Typen
scripts/
  setup-admin.ts      Admin-Benutzer anlegen / Passwort setzen
  reset-password.ts   Recovery: Passwort eines Benutzers zurücksetzen
prisma/
  schema.prisma       Datenbankschema
  migrations/         Migrationsverlauf
  seed.ts             Demo-Daten

Rechnungs-Compliance (§14 UStG)

Alle PDFs enthalten die gesetzlich vorgeschriebenen Pflichtangaben:

Name & Anschrift Rechnungssteller und -empfänger
Steuernummer / USt-IdNr. des Ausstellers
Rechnungsdatum & fortlaufende Rechnungsnummer
Leistungsdatum / Lieferdatum
Leistungsbeschreibung
Nettobetrag, USt-Satz, USt-Betrag, Bruttobetrag