ITS
ITS Control Center (ITS OS) DOKUMENTATION

Systemarchitektur, Module, Sicherheitskonzepte und Betriebsleitfaden

Kapitel 1

1. Systemarchitektur: Der strukturierte Monolith

Das ITS Control Center (ITS OS) ist als stabiler, hochperformanter modularer Monolith auf Basis von PHP 8.5 und Laravel 11 implementiert. Um unnötigen operativen Overhead zu vermeiden, sind sämtliche Geschäftslogiken in separaten Controllern und Eloquent Models organisiert.

Backend & Routing

Laravel 11 auf PHP 8.5 mit typisierten Controllern und dedizierten Endpunkten für jedes Modul.

Datenbank & Cache

MariaDB mit relationaler Integrität und Foreign Keys, Redis 7 für Caching und Queues.

TLS & Verschlüsselung

Google Trust Services TLS 1.3, AES-256 Envelope Encryption für sensible Kunden-Credentials.

Kapitel 2

2. ER-Datenmodell & Relationen

Das Datenmodell stellt sicher, dass jede Aktivität, jedes Ticket, jeder Server und jeder Vertrag lückenlos einem Unternehmen zugeordnet ist.

Zentrale Relationale Tabellen:
# companies
# contacts
# leads
# proposals
# projects
# tasks
# tickets
# servers
# domains
# contracts
# time_entries
# vault_secrets
# activities
# audit_logs
# marketing_campaigns
Kapitel 3

3. Die 12 Kernmodule im operativen Einsatz

3.1 Kundenakte (CRM) & 360°-Timeline

Jedes Kundenunternehmen erhält eine eindeutige Kennung wie ITS-C-100001. Die Kundenakte bündelt alle relevanten Daten: Stammdaten, beliebige Ansprechpartner mit Rollen (Geschäftsführung, IT, Buchhaltung), laufende Projekte, offene Tickets, zugewiesene Server, laufende Verträge und verschlüsselte Passwörter.

3.2 Sales Pipeline & Lead-Attribution

Leads werden über das interaktive Kanban-Board visualisiert. Bei jedem Lead wird die exakte Herkunft erfasst (z. B. Google Ads GCLID, UTM Campaign, Keyword). Wird ein Lead auf "Gewonnen" verschoben, setzt das System den Kunden automatisch auf den Status "Bestandskunde".

3.3 Angebote, Verträge & Der MRR-Rechner

Angebote unterstützen sowohl Einmalpositionen als auch wiederkehrende Monatsbeiträge (MRR). Durch Klick auf "✓ Annehmen" wird das Angebot automatisch in ein aktives Projekt konvertiert und – falls Monatsgebühren enthalten sind – ein Dauervertrag angelegt, der den Kunden-MRR automatisch erhöht.

3.4 Helpdesk & SLA-Eskalationsfristen

Das Helpdesk-System priorisiert Tickets nach Kritikalität: Critical (1 Stunde Notfallfrist), High (2 Stunden Frist) und Normal (4 Stunden Frist). Mitarbeiter können sowohl öffentliche Kundenantworten als auch interne Notizen anlegen.

3.5 IT-Infrastruktur & Server-Margen

Server erfassen Hostname, IP-Adresse, OS, Einkaufskosten (EK) und Verkaufspreis (VK). Das System berechnet automatisch die monatliche Deckungsbeitrags-Marge (z. B. Server kostet ITS 29 € und wird für 89 € berechnet = +60 € Marge). Domains überwachen Ablaufdaten und SSL-Zertifikate.

3.6 Zero-Knowledge Secret Vault (AES-256)

Passwörter und SSH-Keys werden niemals im Klartext gespeichert. Die Speicherung erfolgt über AES-256-GCM Envelope Encryption. Jeder Klick auf "Entschlüsseln 👁" erfordert Authentifizierung und wird manipulationssicher in audit_logs protokolliert.

3.7 Marketing Cockpit & Echter ROAS

Das Marketing-Cockpit stellt Werbeausgaben den tatsächlichen Umsätzen aus abgeschlossenen Aufträgen gegenüber. Dadurch wird genau nachvollzogen, welche Google Ads Kampagne echten CRM-Umsatz erzielt.

3.8 Automatisierungs-Engine & Webhooks

Event-getriebenes Regelwerk: WHEN [Event] IF [Bedingung] THEN [Aktion]. Ermöglicht automatische Zuweisung bei Notfällen, Warnungen vor Vertragsabläufen und Echtzeit-Webhooks an externe Systeme.

Kapitel 4

4. Security & Revisionssicherheit

Sämtliche Aktionen (Logins, Passwort-Entschlüsselungen, Statuswechsel) werden revisionssicher in audit_logs protokolliert. Session-Cookies sind mit strikten Sicherheitsflags geschützt. Das gesamte System wird über HTTPS mit einem Google Trust Services TLS-Zertifikat betrieben.

Kapitel 5

5. Server-, Host- & Live-Konfiguration

Host-IP: 217.160.43.176
Live-Domain: https://office.its.nrw
Dateipfad: /var/www/its-control-center
Datenbank: MariaDB (`its_control_center`)
Cache/Queue: Redis 7.0 Service (`127.0.0.1:6379`)
Git-Branch: main (Clean Light Business UI)