Verwaltung¶
Alle administrativen Funktionen zur Verwaltung von Kunden, Services, Servern, Dokumenten und E-Mails.
Kunden¶
Navigation: Admin > Kunden
Die Kundenverwaltung ist das zentrale Element von HostAdmin. Jeder Kunde erhält eine automatisch generierte Kundennummer.
Kundendaten¶
Die Kundenbearbeitung ist in mehrere Tabs aufgeteilt:
- Kundendaten: Stammdaten, Adresse, Zahlungsinformationen (IBAN mit Validierung), SEPA-Mandat
- Notizen: Interne Notizen zum Kunden
- Panel-Zugang: Zugangsdaten für das Kundenportal
- Ansprechpartner: Zusatzliche Kontaktpersonen mit eigenen PINs
Funktionen¶
| Funktion | Beschreibung |
|---|---|
| Kundennummer | Automatisch generiert, konfigurierbar (Stellenanzahl, Startnummer) |
| SEPA-Mandat | PDF-Generierung direkt aus dem Formular, Speicherung auf S3 |
| Panel-Zugang | Passwort generieren und per E-Mail senden |
| Service-PIN | PIN zur telefonischen Verifizierung |
| Wiedervorlage | Datum + Grund fuer Nachverfolgung setzen |
| Impersonation | Als Kunde im Panel einloggen (erfordert aktiven Panel-Zugang) |
| Stripe-Sync | Status der Stripe-Synchronisierung einsehen |
Quellen (Source)¶
Jeder Kunde hat eine Herkunft:
- local - Direkt in HostAdmin angelegt (Standard)
- stripe - Aus Stripe importiert
- webfakt - Aus Webfakt importiert
Sub-Navigation¶
Die Kunden-Detailseite bietet folgende Unterseiten:
- Bearbeiten (Stammdaten)
- Services
- Rechnungen
- Dokumente
- Stripe Info
Kundenservices¶
Navigation: Admin > Kundenservices
Services sind die abrechnungsfaehigen Leistungen eines Kunden (Hosting, Domains, SSL, etc.).
Anlage¶
Bei der Erstellung wird eine Service-Definition als Vorlage ausgewaehlt. Dabei werden Name, Preis, Abrechnungszyklus und Typ automatisch uebernommen (denormalisiert fuer historische Genauigkeit).
Parent-Child-Beziehungen¶
Hosting-Pakete koennen untergeordnete Services haben:
Webhosting Premium
+-- example.com (Domain)
+-- mail@example.com (E-Mail)
+-- db_example (Datenbank)
Nur Services vom Typ hosting koennen Kinder haben. Die Sortierung innerhalb eines Pakets ist ueber sort_order steuerbar.
Felder¶
| Feld | Beschreibung |
|---|---|
| Service-Definition | Vorlage (befuellt automatisch Name, Preis, Zyklus, Typ) |
| Preis (Netto/Brutto) | Automatische Berechnung mit 19% MwSt. |
| Abrechnungszyklus | monatlich, vierteljaehrlich, jaehrlich, etc. |
| Domain / AuthInfo | Fuer Domain-Services |
| Server | Zugewiesener Server |
| Account-Daten | Benutzername/Passwort fuer den Service |
| Status | draft, order, active, suspended, cancelled, terminated |
Aktionen¶
- AuthInfo senden - Domain-AuthInfo per E-Mail an Kunden
- Zugangsdaten senden - Account-Credentials per E-Mail
- Stripe Sync - Service mit Stripe synchronisieren
- Bulk: Subscription erstellen - Mehrere Services zu einem Stripe-Abo buendeln
Filter¶
Status, Kunde, Abrechnungszyklus, Service-Typ, Server, Subscription-Zugehoerigkeit.
Server¶
Navigation: Admin > Server
Verwaltung der physischen und virtuellen Server.
| Feld | Beschreibung |
|---|---|
| Servernummer | Automatisch generiert |
| System-Specs | OS, CPU-Kerne, RAM, Speicher |
| Control Panel | Typ und URL (z.B. Plesk, cPanel) |
| IP-Adressen | IPv4 und IPv6 |
| Status | active, maintenance, offline, decommissioned |
Pro Server wird angezeigt, wie viele Kundenservices darauf laufen.
Dokumente¶
Navigation: Admin > Dokumente
Dokumentenverwaltung mit S3-Speicherung.
Dokumenttypen¶
- contract - Vertraege
- cancellation - Kuendigungen
- sepa-mandat - SEPA-Mandate (werden automatisch bei Mandat-Generierung erstellt)
- other - Sonstige Dokumente
Funktionen¶
- Upload auf S3 (MinIO)
- Kundensichtbarkeit ein-/ausschalten
- Download-Funktion
- Soft-Delete mit Wiederherstellung
- Uploader-Tracking
Speicherpfad: customer/{customer_id}/docs/
E-Mails¶
Navigation: Admin > E-Mails
Datenbankbasiertes E-Mail-System mit Queue-Verarbeitung und Rate-Limiting.
Status-Workflow¶
- draft - Entwurf, noch nicht zur Zustellung freigegeben
- new - Bereit zur Zustellung
- sent - Erfolgreich zugestellt
- error - Fehler bei Zustellung (kann wiederholt werden)
- stopped - Manuell gestoppt
Funktionen¶
- Rich-Text-Editor mit Signatur
- Template-Integration
- Anhaenge (Viewer + Download)
- Geplanter Versand
- Retry-Mechanismus fuer fehlgeschlagene E-Mails (einzeln und Bulk)
- Fehlerprotokollierung
Rate-Limiting
E-Mails werden nicht direkt versendet, sondern ueber eine Queue mit Rate-Limiting verarbeitet.
Bestellungen (Orders)¶
Navigation: Admin > Verwaltung > Bestellungen
Listet alle Kundenservices mit dem Status order auf. Dies sind neue Bestellungen aus dem Shop, die noch bearbeitet werden muessen.
Massen-E-Mail (Bulk Email)¶
Navigation: Admin > Verwaltung > Massen-E-Mail
Ermoeglicht den Versand von E-Mails an mehrere Kunden gleichzeitig.
- Template-Auswahl
- Kundenfilterung
- Vorschau vor dem Versand