LB223 – Lagerbestandssystem

Multi-User-Applikation zur Verwaltung von Lagerbeständen. Mehrere Benutzer können gleichzeitig Artikel ein- und ausbuchen, wobei der Bestand durch Transaktionen und pessimistisches Locking jederzeit konsistent bleibt.

---

Inhaltsverzeichnis

• Übersicht
• Architektur
• Datenmodell (ERD)
• API-Dokumentation
• Wichtige Abläufe
• Voraussetzungen
• Installation & Start
• Testbenutzer
• Tests ausführen

---

Übersicht

Das Lagerbestandssystem ermöglicht es mehreren gleichzeitigen Benutzern, Artikel einzusehen und deren Bestand zu buchen. Nach dem Login sieht jeder Benutzer die aktuelle Bestandsliste und kann pro Artikel eine Einbuchung (Bestand erhöhen) oder Ausbuchung (Bestand verringern) auslösen. Das System verhindert zuverlässig, dass der Bestand unter 0 fällt – auch wenn mehrere Benutzer exakt zur gleichen Zeit buchen (Lost-Update-Problem gelöst durch Serializable-Transaktion und UPDLOCK/ROWLOCK).

---

Datenmodell (ERD)

erDiagram
    Article {
        int Id PK
        string Name
        int Quantity
        bytes RowVersion
    }
    User {
        int Id PK
        string Username
        string PasswordHash
    }

Loading

RowVersion ist ein EF Core Concurrency Token, das automatisch bei jeder Änderung neu gesetzt wird.

---

API-Dokumentation

Die vollständige interaktive Dokumentation ist über Swagger verfügbar: http://localhost:5000/swagger

Methode	Endpoint	Auth	Beschreibung
POST	/api/auth/login	–	Login, gibt JWT zurück
GET	/api/articles	Bearer	Alle Artikel mit aktuellem Bestand
POST	/api/articles/{id}/book	Bearer	Artikel ein- oder ausbuchen

BookingRequest Body:

{
  "type": "Einbuchen",
  "amount": 5
}

type ist entweder "Einbuchen" oder "Ausbuchen".

---

Voraussetzungen

• .NET 10 SDK
• Node.js 24.15+ + npm 10.9.1+
• Docker Desktop

---

Installation & Start

1. Repository klonen

git clone https://github.com/Monnerus/LB223
cd lb223

2. Datenbank starten

docker compose up -d

3. Backend starten

cd backend/Api
dotnet run

Die API ist erreichbar unter: http://localhost:5000
Swagger UI: http://localhost:5000/swagger

Migrationen und Seed-Daten (Artikel + Testbenutzer) werden beim Start automatisch angewendet.

4. Frontend starten

cd frontend
npm install
npm start

Das Frontend ist erreichbar unter: http://localhost:4200

---

Testbenutzer

Die folgenden Benutzer werden beim ersten Start automatisch angelegt:

Benutzername	Passwort
admin	Admin123
user1	User123
user2	User123

---

Tests ausführen

Die Tests befinden sich in backend/Tests/ und laufen gegen eine echte SQL Server Instanz (Port 1433 muss erreichbar sein).

cd backend
dotnet test

Testklasse	Test	Beschreibung
BookingUnitTests	ParallelAusbuchen_NurEineErfolgreich	2 parallele Ausbuchungen bei Bestand 1 → exakt 1 Erfolg
BookingUnitTests	ParallelEinbuchen_AlleErfolgreich	5 parallele Einbuchungen → alle erfolgreich, Bestand = 5
LoadTests	LastTest_Ausbuchen_BestandNieUnterNull	10 parallele Ausbuchungen bei Bestand 5 → Bestand nie < 0
LoadTests	LastTest_Einbuchen_AlleErfolgreich	20 parallele Einbuchungen → alle erfolgreich, Bestand = 20

---

Erstellt im Rahmen von Modul 223 – Laurin Monnerat – Mai 2026