Architektur & Zuverlässigkeit
Systeme, gebaut für die Tage, an denen nicht alles gut läuft.
Ein Ablauf, der in der Demo funktioniert, ist noch kein produktives System. Hier sind die Architekturprinzipien, die wir anwenden, damit eine Automatisierung zuverlässig, verständlich und übernehmbar bleibt.
- Für wen
- IT-Verantwortliche, Betrieb und technische Leitung.
- Prinzip
- Jeder Baustein erfüllt genau eine Aufgabe und kann ersetzt werden.
- Reversibilität
- Ihre Regeln und Daten bleiben dokumentiert und exportierbar.
Referenzarchitektur
Getrennte, lesbare und testbare Verantwortlichkeiten.
Jedes Projekt wird angepasst, aber die Struktur bleibt dieselbe. Ein einfacher Ablauf nutzt nur die nötigen Schichten.
- 01EingängeE-Mail, Dateien, Formulare, API, Webhooks, geplante Aufgaben. Der Roheingang wird aufbewahrt, damit eine Verarbeitung wiederholt werden kann.
- 02ValidierungFormat, Pflichtfelder, Duplikate. Anhänge werden vor jedem Lesen isoliert.
- 03OrchestrierungWarteschlangen, Zustände, Wiederaufnahmen und Fristen. Eine unterbrochene Verarbeitung wird dort fortgesetzt, wo sie angehalten hat.
- 04GeschäftsregelnPreise, Schwellenwerte, Routing, Kontrollen: Alles, was exakt sein muss, ist in lesbarem und getestetem Code geschrieben.
- 05KI, wo sinnvoll KIKlassifizierung, Extraktion, Dokumentensuche. Ausgaben werden gegen ein Schema geprüft, mit Konfidenzwert pro Ergebnis.
- 06Menschliche Kontrolle MenschFreigabe vor jeder verpflichtenden Aktion und für jeden Fall unter dem Konfidenzschwellenwert.
- 07AktionenSchreiben ins ERP, ins CRM, ins E-Mail-System oder in eine Datenbank, mit minimalen Rechten.
Zuverlässigkeitsprinzipien
Was wir standardmässig anwenden.
Diese Prinzipien sind keine kostenpflichtigen Zusatzoptionen: Sie gehören zu unserer Art zu bauen.
Eingangsvalidierung
Empfangene Daten werden vor jeder Verarbeitung geprüft (Format, Pflichtfelder, Konsistenz). Ein ungültiger Eingang geht in eine menschliche Warteschlange, statt sich weiter fortzupflanzen.
Idempotenz
Jede Operation trägt einen eindeutigen Schlüssel: Eine Wiederholung hat keine zusätzliche Wirkung. Keine doppelte Rechnung, keine doppelte Bestellung, kein doppelter Versand.
Kontrollierte Wiederholungen
Ein vorübergehender Fehler wird automatisch erneut versucht, in wachsenden Abständen und mit einer maximalen Anzahl Versuche, dann gemeldet.
Timeouts und Ausweichlösungen
Jeder externe Aufruf hat eine maximale Dauer. Darüber hinaus greift ein vorgesehenes Verhalten: Zurückstellen, Übergabe an eine Person, Alarm.
Unsicheres Ergebnis
Ist unklar, ob eine Aktion ausgeführt wurde, zum Beispiel nach einem Netzwerkunterbruch, wird sie als unsicher markiert und überprüft – nie blind wiederholt.
Audit-Protokoll
Wer, was, wann, mit welchen Daten, mit welchem Ergebnis. Das Protokoll ist rein additiv: Seine Einträge werden weder geändert noch gelöscht.
Minimale Rechte
Jede Komponente erhält nur die nötigen Rechte. Secrets bleiben auf dem Server, nie im Browser und nie im Quellcode.
Isolation
Riskante Verarbeitungen, etwa die Analyse empfangener Dateien, laufen in einer isolierten Umgebung, ohne Netzwerkzugang und ohne Zugriff auf den Rest des Systems.
Getrennte Umgebungen
Entwicklung, Test und Produktion sind getrennt. Keine Tests mit Ihren Produktivdaten ohne Ihr Einverständnis.
Beobachtungsmodus
Ein neuer Ablauf kann zunächst laufen, ohne etwas zu versenden: Er bereitet jede Aktion zur Überprüfung vor, bis sein tatsächliches Verhalten bestätigt ist.
Notstopp
Jeder Ablauf kann angehalten werden, ohne ausstehende Elemente zu verlieren, und anschliessend sauber wieder aufgenommen werden.
Technologien
Gewählt nach dem Problem, nie vorgegeben.
Wir bevorzugen bewährte, dokumentierte und ersetzbare Technologien.
- Orchestrierung
- Code in Node.js oder Python, n8n wo passend, Warteschlangen und geplante Aufgaben.
- Daten
- PostgreSQL, SQLite oder Ihre bestehenden Datenbanken; verschlüsselte Backups.
- KI
- Modelle etablierter Anbieter oder lokal installierte offene Modelle; Vektorsuche für Dokumente.
- Hosting
- Linux-Server, Container, Private Cloud oder Ihre Infrastruktur.
- Observability
- Strukturierte Logs, Metriken, Alarme per E-Mail oder Messenger.
Reversibilität
Ihr Kapital sind Ihre Regeln und Ihre Daten, nicht das Tool.
Geschäftsregeln, Schnittstellen und Daten bleiben dokumentiert und exportierbar. Ein KI-Modell oder eine Komponente kann ersetzt werden, ohne den Prozess neu aufzubauen, und das System kann von einem anderen Team übernommen werden.
Architektur
Einfach beginnen, nur hinzufügen, was fehlt.
Sprechen wir über Ihren Prozess und darüber, welche Zuverlässigkeit er tatsächlich verlangt.