README.md aktualisiert
This commit is contained in:
512
README.md
Normal file
512
README.md
Normal 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.*
|
||||
Reference in New Issue
Block a user