dgsoft/collabrix
1
0
Fork 0
mirror of https://github.com/OHV-IT/collabrix.git synced 2025-12-15 16:48:36 +01:00
Code Issues Packages Projects Releases Wiki Activity
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

3.1 KiB
Raw Blame History

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! 🎉