Developer Guide

Technische Übersicht für Entwicklung, Wartung und Erweiterung von Billeris.

Letzte Aktualisierung: 22. Mai 2026

Billeris ist eine Next.js App-Router-Anwendung mit TypeScript, React, PostgreSQL, serverseitigen API-Routen und modularen Dashboard-Komponenten.

Stack

Schicht	Technologie
Frontend	Next.js App Router, React, TypeScript, Tailwind CSS, shadcn/Radix-Komponenten.
Backend	Next.js Route Handler, serverseitige Helpers, PostgreSQL-Zugriff.
Datenbank	PostgreSQL mit Public- und Organisationsschemas.
PDF	React PDF, HTML/PDF-Vorschau und dokumentbezogene Renderer.
Zahlungen	Stripe für Subscriptions und Rechnungs-/Portalprozesse.

Bestehende Helper und Komponenten wiederverwenden, statt parallele Patterns anzulegen.
Mandanten- und Organisationskontext vor Datenzugriff immer klären.
Bei API-Routen Auth, Berechtigungen und sichere Fehlermeldungen mitdenken.
PDF- und Dokumentdaten über die vorhandenen Mapper aufbereiten.
Änderungen an geteilten Tabellen oder Routen mit Tests absichern.