collabrix/ADMIN_SETUP.md
DGSoft 93b98cfb5c Initial commit: Team Chat System with Code Snippet Library
- Complete chat application similar to Microsoft Teams
- Code snippet library with syntax highlighting
- Real-time messaging with WebSockets
- File upload with Office integration
- Department-based permissions
- Dark/Light theme support
- Production deployment with SSL/Reverse Proxy
- Docker containerization
- PostgreSQL database with SQLModel ORM
2025-12-09 22:25:03 +01:00

100 lines
3.1 KiB
Markdown

# Admin Panel Setup - Zusammenfassung
## ✅ Erfolgreich eingerichtet!
Ihr Admin-Bereich ist jetzt vollständig funktionsfähig. Sie können Abteilungen anlegen, User zuweisen und Channels erstellen.
## 🔑 Admin-Zugang
**Username:** Ronny
**Passwort:** admin123
**Admin-Status:** ✅ Aktiviert
## 🌐 Zugriff auf den Admin-Bereich
1. **Frontend:** http://localhost:5173
2. Anmelden mit den obigen Zugangsdaten
3. Klicken Sie auf "🔧 Admin" in der Navigation
## 📋 Verfügbare Admin-Funktionen
### 1. User Management (Tab: Users)
- Liste aller Benutzer anzeigen
- Admin-Status für Benutzer aktivieren/deaktivieren
- Benutzer zu Abteilungen zuweisen
### 2. Abteilungsverwaltung (Tab: Departments)
- Neue Abteilungen erstellen (Name + Beschreibung)
- Abteilungen löschen
- Mitglieder zu Abteilungen zuweisen
- Mitgliederliste jeder Abteilung anzeigen
### 3. Channel-Verwaltung (Tab: Channels)
- Neue Channels erstellen
- Channel einer Abteilung zuordnen
- Channels löschen
## 🔧 Backend API-Endpunkte
Alle Admin-Endpunkte sind geschützt und erfordern Admin-Rechte:
### User-Management
- `GET /admin/users` - Alle Benutzer auflisten
- `PATCH /admin/users/{user_id}/admin` - Admin-Status ändern
### Abteilungen
- `POST /admin/departments` - Abteilung erstellen
- `GET /admin/departments` - Alle Abteilungen auflisten
- `DELETE /admin/departments/{department_id}` - Abteilung löschen
- `POST /admin/departments/{department_id}/members` - User zu Abteilung hinzufügen
- `DELETE /admin/departments/{department_id}/members/{user_id}` - User aus Abteilung entfernen
- `GET /admin/departments/{department_id}/members` - Mitglieder einer Abteilung anzeigen
### Channels
- `POST /admin/channels` - Channel erstellen
- `DELETE /admin/channels/{channel_id}` - Channel löschen
## 📝 Beispiel: Abteilung und Channel erstellen
1. Gehen Sie zum Admin-Panel (http://localhost:5173/admin)
2. Wechseln Sie zum "Departments"-Tab
3. Füllen Sie das Formular aus:
- **Name:** z.B. "Entwicklung"
- **Beschreibung:** z.B. "Development Team"
4. Klicken Sie auf "Create Department"
5. Wechseln Sie zum "Channels"-Tab
6. Füllen Sie das Formular aus:
- **Channel Name:** z.B. "general"
- **Beschreibung:** z.B. "Allgemeine Diskussionen"
- **Department:** Wählen Sie "Entwicklung"
7. Klicken Sie auf "Create Channel"
## 🎨 Dark Mode Support
Das Admin-Panel unterstützt Dark Mode und passt sich automatisch an Ihre System-Einstellungen an.
## 🔒 Sicherheit
- Nur Benutzer mit `is_admin = true` haben Zugriff auf Admin-Funktionen
- Alle API-Endpunkte sind durch JWT-Token geschützt
- Admin-Berechtigungen werden bei jedem Request überprüft
## 🧪 Test durchgeführt
Alle Funktionen wurden erfolgreich getestet:
- ✅ Admin-Login
- ✅ User-Verwaltung
- ✅ Abteilungen erstellen/löschen
- ✅ Channels erstellen
- ✅ User-Zuweisung zu Abteilungen
## 🚀 Nächste Schritte
Sie können jetzt:
1. Weitere Abteilungen erstellen (z.B. Marketing, Vertrieb, Support)
2. Channels für jede Abteilung anlegen
3. Weitere Benutzer registrieren und zu Abteilungen zuweisen
4. Anderen Benutzern Admin-Rechte geben (über die Users-Tab)
Viel Erfolg mit Ihrem Team Chat System! 🎉