Handbuch - Materialverwaltung
# Materialverwaltung - Handbuch
## Inhaltsverzeichnis
1. [Einführung](#einführung)
2. [Systemanforderungen](#systemanforderungen)
3. [Installation](#installation)
4. [Erste Schritte](#erste-schritte)
5. [Benutzerhandbuch](#benutzerhandbuch)
6. [Module](#module)
7. [Offline-Nutzung](#offline-nutzung)
8. [Barrierefreiheit](#barrierefreiheit)
9. [Troubleshooting](#troubleshooting)
10. [Support](#support)
---
## 1. Einführung
Die Materialverwaltung ist ein modernes, webbasiertes System zur Verwaltung von medizinischen Materialien, Geräten und Verbrauchsmitteln für Sanitätsdienste. Es bietet umfassende Funktionen für die Bestandsverwaltung, Transaktionsverfolgung und Geräteverwaltung.
### Hauptmerkmale
- Rollenbasierte Zugriffssteuerung mit vier verschiedenen Benutzergruppen
- **Offline-Funktionalität** durch Service Worker
- **Moderne Web-Technologien** mit TypeScript-Unterstützung
- **Barrierefreiheit** gemäß WCAG-Richtlinien
- **Performance-Optimierungen** für schnelle Ladezeiten
---
## 2. Systemanforderungen
### Unterstützte Browser
| Browser | Version |
|---------|---------|
| Chrome | 90+ |
| Firefox | 88+ |
| Safari | 14+ |
| Edge | 90+ |
### Software
- Python 3.8+
- Node.js 16+ (für Frontend-Entwicklung)
- SQLite
### Mobile Geräte
- iOS 14+ (Safari)
- Android 8+ (Chrome)
---
## 3. Installation
### Schritt-für-Schritt-Anleitung
#### 1. Repository klonen
```bash
git clone https://github.com/CaptSonic/Materialverwaltung.git
cd Materialverwaltung
```
#### 2. Backend einrichten
```bash
# Python Virtual Environment erstellen
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
# Abhängigkeiten installieren
pip install -r requirements.txt
# Datenbank initialisieren
python main.py --init-db
```
#### 3. Server starten
```bash
python main.py
```
#### 4. Im Browser öffnen
- **Frontend**: http://localhost:8000
- **API-Dokumentation**: http://localhost:8000/docs
---
## 4. Erste Schritte
### Erster Login
1. Öffnen Sie die Anwendung im Browser
2. Melden Sie sich mit den Standard-Anmeldedaten an:
- **Benutzername**: `admin`
- **Passwort**: `admin123`
3. Ändern Sie das Passwort nach dem ersten Login
### Rollen und Berechtigungen
Das System verwendet vier verschiedene Benutzergruppen:
| Rolle | Berechtigungen |
|-------|----------------|
| **admin** | Vollzugriff auf alle Funktionen, Benutzerverwaltung |
| **manager_sanitaet** | Lagerverwaltung, Transaktionen, Berichte |
| **manager_iuk** | IuK-Geräteverwaltung |
| **user** | Transaktionen, Dashboard (nur Lesen) |
---
## 5. Benutzerhandbuch
### 5.1 Dashboard
Das Dashboard bietet einen Überblick über die wichtigsten Informationen:
#### Änderungshistorie
Je nach Benutzerrolle werden unterschiedliche Logs angezeigt:
- **Admin**: Alle Änderungen
- **Manager Sanität**: Nur Sanitäts-Logs
- **Manager IuK**: Nur IUK-Logs
Die Anzeige zeigt:
- Datum und Uhrzeit
- Aktion (Erstellt, Geändert, Gelöscht)
- Entität (Gerät, Inventar, Transaktion, etc.)
- Benutzer (mit Namen)
- Details (was genau geändert wurde)
#### Kritische Bestände
- Anzeige von Artikeln mit niedrigen Beständen
- Automatische Warnung bei Unterschreitung des Mindestbestands
- Farbcodierte Anzeige
#### Fällige Prüfungen
- Übersicht über Geräte mit fälligen Prüfungen
- Prüfintervalle und letzte Prüfdaten
#### Bald ablaufende Materialien
- Materialien mit nahenden Ablaufdaten
- Chargenverwaltung
- Warnung vor Ablauf
### 5.2 Lagerverwaltung
#### Artikel anlegen
1. Zum Lagerbereich navigieren
2. Auf "Neue Lagerposition" klicken
3. Artikelinformationen eingeben:
- Artikelnummer (automatisch generiert)
- Name und Beschreibung
- Einheit und Kategorie
- Mindestbestand
4. Speichern
#### Bestandsverwaltung
1. Bestand suchen oder auswählen
2. Menge anpassen:
- Zugang: Bestand erhöhen
- Abgang: Bestand verringern
3. Transaktion bestätigen
4. Bemerkung hinzufügen (optional)
#### Lagerorte verwalten
1. Zum Administration-Bereich navigieren
2. Lagerorte auswählen
3. Neuen Lagerort anlegen oder bestehende bearbeiten
### 5.3 Transaktionen
#### Neue Transaktion erstellen
1. Zum Transaktionsbereich navigieren
2. Auf "Neue Transaktion" klicken
3. Transaktionsart auswählen:
- Zugang (Zugang neuer Materialien)
- Abgang (Entnahme von Material)
4. Artikel und Menge auswählen
5. Lagerort und Kostenträger zuweisen
6. Bemerkung hinzufügen (optional)
7. Transaktion bestätigen
### 5.4 IuK-Verwaltung
#### DME verwalten
1. Zum IuK-Bereich navigieren
2. DME-Tab auswählen
3. Neues DME anlegen mit:
- Hersteller und Modell
- Inventarnummer und Seriennummer
- Programmierungsinformationen
#### Funkgeräte verwalten
1. Zum Funkgeräte-Tab navigieren
2. Neues Funkgerät anlegen mit:
- Hersteller und Modell
- Inventarnummer und Seriennummer
- Gerätetyp und TEI
#### BSI-Karten verwalten
1. Zum BSI-Karten-Tab navigieren
2. Neue BSI-Karte anlegen mit:
- ISSI und OPTA
- Kartennummer und Status
### 5.5 Administration
#### Benutzer verwalten
1. Zum Administration-Bereich navigieren
2. Benutzer-Tab auswählen
3. Neuen Benutzer anlegen mit:
- Name und Vorname
- Benutzername und E-Mail
- Rolle zuweisen
#### Kostenträger verwalten
1. Zum Kostenträger-Tab navigieren
2. Neuen Kostenträger anlegen mit:
- Name und Beschreibung
#### Lagerorte verwalten
1. Zum Lagerorte-Tab navigieren
2. Neuen Lagerort anlegen mit:
- Name und Typ
- Beschreibung
---
## 6. Module
### Hauptanwendung
Die zentrale Materialverwaltung mit allen Kernfunktionen für Lager, Transaktionen und Administration.
### Sanitätsmodul
Eigenständiges Modul für die Sanitätsverwaltung mit speziellen Funktionen für medizinische Materialien.
### IuK-Modul
Spezialisiertes Modul für Information und Kommunikation:
- TETRA-Funkgeräte
- DME (Digital Mobile Radio)
- BSI-Karten
- SIM-Karten
---
## 7. Offline-Nutzung
### Funktionsweise
Das System funktioniert auch ohne Internetverbindung:
#### Verfügbare Funktionen
- Lagerverwaltung: Artikel ansehen und Bestände anpassen
- Transaktionen: Neue Transaktionen erstellen
- IuK-Verwaltung: Geräte verwalten
- Dashboard: Aktuelle Informationen anzeigen
#### Offline-Modus aktivieren
1. Internetverbindung verlieren
2. System wechselt automatisch in den Offline-Modus
3. Alle Funktionen bleiben verfügbar
4. Bei Wiederherstellung erfolgt automatische Synchronisation
---
## 8. Barrierefreiheit
### Tastaturnavigation
- **Tab**: Zwischen Elementen navigieren
- **Enter**: Element auswählen oder aktivieren
- **Escape**: Modals schließen
- **Ctrl + Space**: Fokus auf Hauptanwendung
### Screenreader-Unterstützung
- ARIA-Labels für alle interaktiven Elemente
- Rollen und Zustände korrekt definiert
- Live Regions für dynamische Inhalte
### Hoher Kontrast
- Kontrastverhältnis von mindestens 4.5:1
- Farbenblindenfreundliches Design
- Anpassbare Schriftgrößen
---
## 9. Troubleshooting
### Häufige Probleme
#### Problem: Anmeldung fehlgeschlagen
- Passwort zurücksetzen oder Admin kontaktieren
- Internetverbindung und Serverstatus prüfen
#### Problem: Daten werden nicht synchronisiert
- Internetverbindung prüfen
- Browser-Einstellungen für Offline-Nutzung prüfen
#### Problem: Langsame Ladezeiten
- Browser-Cache leeren
- Internetverbindung prüfen
### Support kontaktieren
- **E-Mail**: support@materialverwaltung.de
- **Öffnungszeiten**: Mo-Fr 8:00-18:00
---
## 10. Support
### Schulungen
| Schulung | Dauer |
|----------|-------|
| Grundlagen | 2 Stunden |
| Fortgeschritten | 4 Stunden |
| Administratoren | 8 Stunden |
### Dokumentation
- **API-Dokumentation**: http://localhost:8000/docs
- **Dieses Handbuch**: HANDBUCH.md
---
**Version**: 1.2.0
**Datum**: 2026-02-20
**Copyright**: © 2026 - Alle Rechte vorbehalten.