Professional Billing and Work Management System API

Eine professionelle RESTful Backend-API zur Verwaltung von Abrechnung, Arbeitseinsätzen und Benutzerrollen.
Das Projekt wurde im Rahmen meiner Bachelorarbeit entwickelt und dient als Referenz für saubere Backend-Architektur, sichere Authentifizierung und rollenbasierte Zugriffskontrolle.

Projektkontext (Bachelorarbeit)

Dieses Repository repräsentiert die erste Version des Backends, umgesetzt mit Laravel.
Die Anwendung war Teil einer vollständigen Vereins- und Einsatzverwaltungssoftware mit Mobile-/Desktop-Frontend.

👉 Aktueller Hinweis:

Derzeit wird das System architektonisch neu aufgebaut und vollständig auf das .NET-Ökosystem migriert (ASP.NET Core, EF Core, Docker).
Die neue Version existiert in einem separaten öffentlichen Repository und stellt die aktive Weiterentwicklung dar.

Dieses Laravel-Projekt bleibt bewusst erhalten, um:

• den ursprünglichen Architekturansatz zu dokumentieren
• Backend-Kompetenz frameworkübergreifend zu zeigen
• die Entwicklungsschritte nachvollziehbar zu machen

Ziel des Projekts

• Entwicklung einer skalierbaren Backend-API für Abrechnung und Arbeitseinsätze
• Umsetzung sicherer Authentifizierung und Rollenverwaltung
• Trennung von Verantwortlichkeiten (Auth, User, Billing, Work)
• Vorbereitung für reale Einsatzszenarien (Reports, PDFs, Admin-Workflows)

Zentrale Funktionen

Authentifizierung & Autorisierung

• Sichere Benutzeranmeldung mit Laravel Sanctum
• Rollenbasierte Zugriffskontrolle (z. B. Super Admin, Admin, Honorarkraft)
• Passwort-Reset
• Profilverwaltung

Abrechnungsverwaltung

• Erstellung und Verwaltung von Abrechnungen
• PDF-Rechnungserstellung
• Monatliche Abrechnungsübersichten
• Admin-Dashboard für Abrechnungen

Einsatz- und Arbeitsverwaltung

• Erstellung und Zuweisung von Arbeitseinsätzen
• Statusverfolgung
• Einsatz- und Tätigkeitsberichte
• Team- und nutzerbasierte Organisation
• PDF-Dokumentenverwaltung

Benutzerverwaltung

• Benutzerregistrierung mit Freigabeprozess
• Rollenmanagement
• Profilpflege
• Admin-Übersicht aller Benutzer

Technischer Überblick (Version 1 – Laravel)

• Framework: Laravel 11
• Sprache: PHP 8.2+
• Authentifizierung: Laravel Sanctum
• Datenbank: MySQL
• API-Stil: RESTful
• Tests: PHPUnit (geplant / teilweise vorbereitet)

Aktuelle Weiterentwicklung (separates Repository)

• ASP.NET Core Web API
• Entity Framework Core
• PostgreSQL & Microsoft SQL Server
• Docker & Docker Compose
• Clean Architecture / Layered Architecture
• Rollen- & Policy-basierter Autorisierung

👉 Dieses Repository zeigt den Ursprung, das neue .NET-Repository zeigt den aktuellen Stand.

🛠️ Technical Stack

• Framework: Laravel 11.x
• PHP Version: 8.2+
• Authentication: Laravel Sanctum
• Database: MySQL
• API Documentation: RESTful API
• Testing: PHPUnit ( To do )

Installation (Laravel-Version)

1. Clone the repository

git clone 

2. Install dependencies

composer install
npm install

3. Configure environment

cp .env.example .env
php artisan key:generate

4. Configure database in .env file

5. Run migrations

php artisan migrate

6. Start the development server

php artisan serve

📚 API-Dokumentation

• Authentifizierung (/api/auth/*)
• Benutzerverwaltung (/api/user/*)
• Abrechnung (/api/billings/*)
• Einsätze (/api/works/*)
• Super-Admin-Funktionen (/api/superadmin/*)

Projektstatus

Status: Abgeschlossenes Thesis-Projekt (Version 1)

Weiterentwicklung: Aktiv – neue Version im .NET-Ökosystem (separates Repository)

📝 License

This project is licensed under the MIT License.

🤝 Contributing

Contributions, issues, and feature requests are welcome!