Dateien nach "/" hochladen

This commit is contained in:
2026-02-27 01:13:48 +01:00
commit 88a9bd23b8

512
BENUTZERHANDBUCH.md Normal file
View File

@@ -0,0 +1,512 @@
# 📚 Benutzerhandbuch - Sponsorenprogramm Verwaltung
**Version:** 2.0
**Datum:** Februar 2026
**Zielgruppe:** Alle Benutzer des Sponsorenprogramm-Systems
---
## 📋 Inhaltsverzeichnis
1. [Erste Schritte](#erste-schritte)
2. [Login](#login)
3. [Dashboard & Navigation](#dashboard--navigation)
4. [Sponsoren verwalten](#sponsoren-verwalten)
5. [Verträge verwalten](#verträge-verwalten)
6. [Leistungen](#leistungen)
7. [Kommunikation](#kommunikation)
8. [Admin-Panel](#admin-panel)
9. [Benutzerrollen](#benutzerrollen)
10. [Häufig gestellte Fragen](#häufig-gestellte-fragen)
11. [Troubleshooting](#troubleshooting)
---
## 🚀 Erste Schritte
### Systemanforderungen
- Moderner Webbrowser (Chrome, Firefox, Edge, Safari)
- Internetverbindung
- JavaScript aktiviert
### URL aufrufen
```
https://sponsoren.la-eracing.com
```
Nach dem Öffern werden Sie automatisch zur Login-Seite weitergeleitet.
---
## 🔐 Login
### Passwort-Login (Admin)
Falls kein Entra-Login konfiguriert ist, können Sie sich mit dem Admin-Passwort anmelden:
1. Gehen Sie zu `/login.html`
2. Geben Sie das **Admin-Passwort** in das Feld ein
3. Klicken Sie auf **"Anmelden"**
4. Sie werden zum Dashboard weitergeleitet
**Hinweis:** Das Admin-Passwort wird von Ihrem Administrator festgelegt.
### Microsoft Entra Login (SSO)
Falls **Entra aktiviert** ist:
1. Klicken Sie auf **"Mit Microsoft Entra anmelden"**
2. Sie werden zu Microsoft weitergeleitet
3. Melden Sie sich mit Ihrem Unternehmens-Konto an
4. Sie werden automatisch zurück geleitet
5. **Automatische Rollenvergabe:** Ihre Rolle wird basierend auf Ihren Gruppen in Azure AD bestimmt
**Vorteil:** Sie müssen sich nur einmal anmelden und erhalten Zugriff auf alle Systeme.
### Logout
Sie können sich in der oberen rechten Ecke der Anwendung abmelden:
1. Klicken Sie auf Ihren **Benutzernamen / Profil-Symbol**
2. Klicken Sie auf **"Abmelden"**
---
## 📊 Dashboard & Navigation
### Hauptseite
Nach dem Login sehen Sie das **Dashboard** mit:
- 📈 **Statistik-Überblick** (Sponsoren, Verträge, Leistungen)
- 🔄 **Schnellzugriff** zu den wichtigsten Funktionen
- 📅 **Aktuelle Aktivitäten**
### Navigationsmenü (Sidebar)
Die linke Seite zeigt alle verfügbaren Module:
| Symbol | Modul | Beschreibung |
|--------|-------|-------------|
| 🏠 | Dashboard | Startseite mit Übersicht |
| 🤝 | Sponsoren | Alle Sponsorenkonten verwalten |
| 📜 | Verträge | Sponsorshipverträge verwalten |
| ✅ | Leistungen | Erbrachte Leistungen nachverfolgung |
| 💬 | Kommunikation | Nachrichtenhistorie und Tickets |
| 🏭 | Fertiger | Hersteller/Partner-Status |
| ⚙️ | Admin | Systemverwaltung (nur Admins) |
### Benutzermenü (oben rechts)
```
👤 Ihr Name | Admin Badge
├─ Logout
```
---
## 🤝 Sponsoren verwalten
### Liste anzeigen
1. Klicken Sie im Menü auf **"Sponsoren"**
2. Sie sehen eine **Tabelle aller Sponsoren** mit:
- Name und Kategorie
- Status (aktiv, verhandlung, abgesagt, etc.)
- Kontaktinformationen
- Logo-Vorschau
### Neuen Sponsor erstellen (Editor/Admin)
1. Klicken Sie auf **"+ Neuer Sponsor"** Button
2. Füllen Sie folgende Felder aus:
- **Name** (erforderlich)
- **E-Mail** (erforderlich)
- **Kategorie** (Hauptsponsor, Gold, Silber, Bronze, Unterstützer)
- **Status** (offen, angefragt, verhandlung, aktiv, abgesagt)
- **Land**
- **Website**
- **Telefon**
3. Klicken Sie **"Speichern"**
### Sponsor bearbeiten (Editor/Admin)
1. Klicken Sie auf einen **Sponsor in der Liste**
2. Der Detailbereich öffnet sich auf der rechten Seite
3. Bearbeiten Sie die Felder
4. Klicken Sie **"Speichern"**
### Sponsor-Tabs
Wenn Sie einen Sponsor öffnen, sehen Sie mehrere Tabs:
#### 📋 Allgemein
- Grundinformationen bearbeiten
- Status ändern
#### 🖼️ Logo
- Mehrere Logos hochladen
- Datei-Typen: JPG, PNG, GIF, SVG, PSD, AI, EPS, PDF
- **Download**: Klick auf Logo
- **Löschen**: ❌ Button
#### 📄 Verträge
- Alle Verträge dieses Sponsors
- Neue Verträge erstellen
#### ✅ Leistungen
- Erhaltene Leistungen anzeigen
- Neue Leistungen hinzufügen
#### 💬 Kommunikation
- Nachrichten-Historie
- Neue Nachrichten senden
### Sponsor löschen (Admin)
1. Öffnen Sie den Sponsor
2. Klicken Sie oben auf **"🗑️ Sponsor löschen"**
3. Bestätigen Sie die Warnung
4. Der Sponsor wird gelöscht
⚠️ **Warnung:** Dies kann nicht rückgängig gemacht werden!
---
## 📜 Verträge verwalten
### Vertragstypen
- **Sponsoring-Verträge** - Vereinbarungen zwischen Verein und Sponsor
- **Leistungs-Verträge** - Spezifische Leistungsvereinbarungen
### Neuen Vertrag erstellen (Editor/Admin)
1. Gehen Sie zum **Sponsor** oder zu **"Verträge"** im Menü
2. Klicken Sie **"+ Neuer Vertrag"**
3. Füllen Sie aus:
- **Sponsor** (wählen Sie aus Liste)
- **Titel** (z.B. "Sponsoring 2025")
- **Typ** (Sponsoring / Leistung)
- **Startdatum**
- **Enddatum**
- **Betrag** (in Euro)
- **Beschreibung**
- **Status** (entwurf, aktiv, abgeschlossen, storniert)
4. Klicken Sie **"Speichern"**
### Vertrag bearbeiten (Editor/Admin)
1. Finden Sie den Vertrag in der Liste
2. Klicken Sie darauf
3. Bearbeiten Sie die Felder
4. Klicken Sie **"Speichern"**
### Vertrag hochladen/anhängen
Im Vertrag können Sie Dateien hochladen:
1. Klicken Sie auf **"Datei hochladen"**
2. Wählen Sie eine Datei (PDF, Word, Excel)
3. Die Datei wird gespeichert
### Verträge anzeigen nach Status
Verwenden Sie die **Filter-Tabs**:
- **Alle** - Alle Verträge
- **Aktiv** - Laufende Verträge
- **Entwurf** - Noch nicht aktiviert
- **Abgeschlossen** - Beendete Verträge
---
## ✅ Leistungen
### Was sind "Leistungen"?
**Leistungen** sind Gegenleistungen des Vereins an den Sponsor, z.B.:
- Logo auf Website
- Logo auf Fahrzeug
- VIP-Tickets zu Events
- Kontakt zum Rennteam
- etc.
### Leistungs-Kategorien
Folgende Kategorien sind vordefiniert:
- **Hauptsponsor** - Premium Leistungen
- **Gold** - Erweiterte Leistungen
- **Silber** - Standard Leistungen
- **Bronze** - Basis Leistungen
- **Unterstützer** - Minimale Leistungen
### Leistung hinzufügen (Editor/Admin)
1. Öffnen Sie einen **Sponsor**
2. Gehen Sie zum Tab **"✅ Leistungen"**
3. Klicken Sie **"+ Leistung hinzufügen"**
4. Wählen Sie aus der Liste:
- "Kontakt zum Rennteam"
- "Logo auf Vereinshomepage"
- "Logo auf Fahrzeug"
- etc.
5. Klicken Sie **"Speichern"**
### Leistungen 赤✓ Abhaken (Editor/Admin)
1. In der Leistungsliste sehen Sie: ☐ Nicht erledigt / ☑ Erledigt
2. Klicken Sie die Checkbox um den Status zu ändern
3. Das wird automatisch gespeichert
### Leistungs-Vorlagen
Im **Admin-Panel** können Sie Leistungs-Vorlagen pro Kategorie bearbeiten.
---
## 💬 Kommunikation
### Nachrichten-Historie
im **"Kommunikation"** Tab sehen Sie alle Nachrichten mit:
- Empfänger/Absender
- Datum
- Betreff
- Nachricht-Text
- Status (gelesen/ungelesen)
### Neue Nachricht senden (Editor/Admin)
1. Öffnen Sie den **Sponsor**
2. Gehen Sie zum Tab **"💬 Kommunikation"**
3. Klicken Sie **"+ Neue Nachricht"**
4. Füllen Sie aus:
- **Betreff**
- **Nachricht**
- **Anlage** (optional)
5. Klicken Sie **"Senden"**
### Mails automatisch synchronisieren
Falls konfiguriert, werden Emails automatisch:
- Empfangen und der Kommunikation zugeordnet
- Archiviert
- Referenziert
---
## ⚙️ Admin-Panel
⚠️ **Nur für Admins zugänglich!**
### Admin-Panel öffnen
1. Klicken Sie im Menü auf **"⚙️ Admin"**
2. Sie sehen mehrere Konfigurationstabs
### Tabs im Admin-Panel
#### 🔒 Lokaler Admin
- **Funktion:** Bestimmen Sie welcher Benutzer als lokaler Admin gilt
- **Verwendung:** Für Passwort-Login ohne Benutzer-Eintrag
- Geben Sie den Benutzernamen ein (z.B. `admin@local`)
#### 🔗 Webhook
- **Funktion:** Externe Systeme können Events erhalten
- **URL:** Ziel-URL für Webhooks
- **Test:** Button zum Testen der Verbindung
- **Status:** An/Aus
#### ✔️ Leistungen
- **Bearbeiten:** Passen Sie Leistungs-Vorlagen an
- **Pro Kategorie:** Definieren Sie Leistungen pro Sponsor-Kategorle
#### 🏷️ Kategorien
- **Sponsorenklassen:** Hauptsponsor, Gold, Silber, Bronze, Unterstützer
- **Farbe:** Wählen Sie eine Farbe pro Kategorie
- **Bearbeiten/Löschen:** Verwalten Sie Kategorien
#### 👥 Benutzer
- **Liste:** Alle Benutzer des Systems
- **Rolle:** Viewer, Editor, Admin
- **Status:** Aktiv/Inaktiv
- **Löschen:** Benutzer entfernen (Achtung: nicht rückgängig!)
#### 🔵 Microsoft Entra
- **Tenant ID:** Ihre Azure AD Tenant ID
- **Client ID:** App ID aus Azure
- **Redirect URI:** Sollte `https://sponsoren.la-eracing.com/login.html` sein
- **Enabled:** An/Aus
---
## 👥 Benutzerrollen
### Viewer 👀
**Berechtigung:** Nur Anschauen
- ✅ Sponsoren anschauen
- ✅ Verträge anschauen
- ✅ Leistungen anschauen
- ❌ Nichts bearbeiten
- ❌ Admin-Panel nicht zugänglich
**Verwendung:** Externe Stakeholder, Berichts-Empfänger
### Editor ✏️
**Berechtigung:** Erstellen & Bearbeiten (aber nicht löschen)
- ✅ Sponsoren erstellen/bearbeiten
- ✅ Verträge erstellen/bearbeiten
- ✅ Leistungen öffnen/bearbeiten
- ✅ Nachrichten senden
- ❌ Sponsoren/Verträge löschen
- ❌ Benutzer verwalten
- ❌ Admin-Panel nicht vollständig zugänglich
**Verwendung:** Sponsoren-Manager, Team-Mitglieder
### Admin 🔐
**Berechtigung:** Vollständiger Zugriff
- ✅ Alles erstellen, bearbeiten, löschen
- ✅ Benutzer verwalten
- ✅ System-Einstellungen ändern
- ✅ Webhooks konfigurieren
- ✅ Admin-Panel alle Funktionen
**Verwendung:** Systemadministratoren, Projekt-Leiter
---
## ❓ Häufig gestellte Fragen
### F: Ich bin ausgesperrt - was kann ich tun?
**A:**
- Versuchen Sie den Browser-Cache zu löschen (Strg+Shift+Entf)
- Versuchen Sie einen anderen Browser
- Wenden Sie sich an den Administrator
### F: Kann ich mehrere Logos hochladen?
**A:** Ja! Sie können bis zu mehrere Logos pro Sponsor hochladen.
- Formate: JPG, PNG, GIF, SVG, PSD, AI, EPS, PDF
- Maximal 10 MB pro Datei
### F: Können gelöschte Sponsoren wiederhergestellt werden?
**A:** Nein, gelöschte Sponsoren können nicht wiederhergestellt werden. Seien Sie vorsichtig beim Löschen!
### F: Wie kann ich meinen Namen/Passwort ändern?
**A:** Kontaktieren Sie Ihren Administrator - Benutzer-Management ist Admin-only.
### F: Was ist "Fertiger"?
**A:** Das sind Hersteller oder Partner mit speziellem Status. Sie haben einen separaten Bereich im Menü.
### F: Kann ich Berichte exportieren?
**A:** Derzeit nicht - geplant für zukünftige Versionen. Sie können mit der Druckfunktion (Strg+P) Seiten speichern.
### F: Wie funktioniert Entra Login?
**A:**
1. Sie klicken "Mit Microsoft Entra anmelden"
2. Sie werden zu Microsoft weitergeleitet
3. Sie melden sich mit Ihrem Unternehmenskonto an
4. Ihre Rolle wird automatisch basierend auf Ihren Azure AD-Gruppen zugewiesen
### F: Ich sehe einen Fehler "Keine Berechtigung"
**A:**
- Sie haben nicht die nötige Berechtigung für diese Aktion
- Fragen Sie einen Admin um mehr Rechte
- Überprüfen Sie Ihre Benutzer-Rolle
---
## 🔧 Troubleshooting
### Problem: Login funktioniert nicht
**Lösungen:**
1. ✅ Überprüfen Sie das Admin-Passwort
2. ✅ Versuchen Sie Browser-Cache zu löschen
3. ✅ Versuchen Sie einen anderen Browser
4. ✅ Überprüfen Sie Ihre Internetverbindung
5. ✅ Kontaktieren Sie den Administrator
### Problem: Seite lädt nicht
**Lösungen:**
1. ✅ Aktualisieren Sie die Seite (F5)
2. ✅ Warten Sie 30 Sekunden
3. ✅ Versuchen Sie einen anderen Browser
4. ✅ Deaktivieren Sie den Adblocker (z.B. uBlock)
5. ✅ Überprüfen Sie die Internetverbindung
### Problem: Änderungen werden nicht gespeichert
**Lösungen:**
1. ✅ Klicken Sie auf **"Speichern"** Button (nicht Enter!)
2. ✅ Warten Sie bis die Bestätigung erscheint
3. ✅ Aktualisieren Sie die Seite und überprüfen Sie
4. ✅ Überprüfen Sie Ihre Benutzer-Berechtigung
### Problem: Fehler 500 oder "Server Error"
**Lösungen:**
1. ✅ Aktualisieren Sie die Seite
2. ✅ Versuchen Sie es später erneut
3. ✅ Kontaktieren Sie den Administrator mit der Fehlermeldung
### Problem: Buttons/Funktionen sind grau/deaktiviert
**Lösungen:**
1. ✅ Überprüfen Sie Ihre Benutzer-Rolle
2. ✅ Viewer können nichts bearbeiten
3. ✅ Nur Admins können löschen
4. ✅ Fragen Sie einen Admin um erhöhte Rechte
### Problem: Logo wird nicht angezeigt
**Lösungen:**
1. ✅ Überprüfen Sie das Dateiformat (JPG, PNG, GIF, SVG, etc.)
2. ✅ Überprüfen Sie die Dateigröße (max. 10 MB)
3. ✅ Löschen Sie das Logo und laden Sie es erneut hoch
4. ✅ Versuchen Sie es mit einem anderen Browser
---
## 📞 Support & Hilfe
### Technischer Support
Wenden Sie sich bei Problemen an:
- **Email:** [Support E-Mail]
- **Telefon:** [Support Telefon]
- **Ticketing:** [Ticketing-System]
### Feedback & Verbesserungsvorschläge
Wir würden gerne von Ihnen hören! Senden Sie Feedback an:
- **Email:** feedback@sponsoren.example.com
- **Form:** Feedback-Seite im System
---
## 📝 Tipps & Best Practices
**DO:**
- Speichern Sie regelmäßig Ihre Änderungen
- Überprüfen Sie Dateigrößen vor dem Hochladen
- Nutzen Sie aussagekräftige Beschreibungen
- Halten Sie Ihre Kontaktinformationen aktuell
- Sichern Sie wichtige Dokumente extern
**DON'T:**
- Löschen Sie es nicht einfach "um zu sehen ob es funktioniert"
- (Das ist nicht rückgängig zu machen!)
- Verwenden Sie passwortfreie Konten
- Teilung Sie Ihr Passwort
- Verwenden Sie den Admin-Account für alltägliche Aufgaben
---
## 🔄 Versionsverlauf
| Version | Datum | Änderungen |
|---------|-------|-----------|
| 2.0 | Feb 2026 | Komplette Überarbeitung, Entra SSO, Admin-Panel |
| 1.0 | Dez 2025 | Erste Version |
---
**Zuletzt aktualisiert:** Februar 2026
**Nächste Überprüfung:** Mai 2026
---
*Dieses Handbuch wird regelmäßig aktualisiert. Bei Fragen oder Unklarheiten wenden Sie sich an den Administrator.*