513 lines
14 KiB
Markdown
513 lines
14 KiB
Markdown
# 📚 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.*
|