Zum Inhalt springen

Referenz & Datenmodell

Die Regel-Engine (system_derived_record)

Wie Aligia aus einem Eingangsdatensatz einen abgeleiteten Datensatz mit Herkunft macht.

Eingangsdatensatz ändert sich (anlegen · ändern · löschen)
│
▼
Regel prüft: „betrifft mich diese Änderung?“ (nur bestimmte Felder)
│ ja
▼
Regel liest die Quelle NEU aus der Datenbank und berechnet den Sollzustand
│
├─ Bedingung erfüllt → gewünschte Zeile(n) mit Wert, Datum, Kostenart
├─ Bedingung entfällt → keine Zeile gewünscht
└─ Voraussetzung fehlt (z. B. Kostenart) → „Überspringen“, nichts ändern
│
▼
Abgleich mit dem Herkunfts-Ledger (system_derived_record)
├─ create-only: nur anlegen, was noch nicht bekannt ist
└─ reconcile: anlegen · aktualisieren · entfernen

Jede Regel hat einen festen Schlüssel (z. B. time_log.personal_cost) und reagiert nur auf Änderungen an bestimmten Feldern ihrer Quelle. Sie berechnet den Sollzustand immer aus dem aktuellen Datenbankstand, nie aus dem Ereignis selbst. Zwei gleichzeitige Änderungen an derselben Quelle werden nacheinander verarbeitet; die spätere gewinnt.

Jede abgeleitete Zeile ist im Herkunfts-Ledger (system_derived_record) verzeichnet: Regelschlüssel, Quell-Datensatz, Ziel-Datensatz. Pro Regel und Quelle gibt es genau eine Zielzeile je Schlüssel. Die Zielzeile selbst trägt zusätzlich die Quelle (source_id) und den Regelschlüssel (rule_key); daraus baut die Oberfläche den Text „Quelle“ mit Link zum Ursprung (z. B. „Zeiterfassung · Max Muster vom 20.08.2026“). Der Ledger ist nur serverseitig und nicht sichtbar; siehe Abgeleiteter Datensatz.

Policy Anlegen Aktualisieren Entfernen Ziele
create-only beim ersten passenden Ereignis nie nie Ist-Buchung, Kostenart
reconcile wenn Bedingung erfüllt bei jeder relevanten Änderung der Quelle wenn Bedingung entfällt Plan-Position, Lagerbewegung

„Entfernen“ heißt Soft-Delete: Die Zeile verschwindet aus der Oberfläche und kommt zurück, wenn die Bedingung erneut erfüllt wird (dieselbe Zeile wird wiederbelebt).

  • reconcile: Die Quelle gilt als „nicht mehr vorhanden“ → die abgeleitete Plan-Position bzw. Lagerbewegung wird entfernt. Wird die Quelle wiederhergestellt, entsteht die Zeile erneut.
  • create-only: Nichts. Eine gebuchte Ist-Buchung bleibt bestehen, auch wenn die Zeiterfassung, der Einkauf oder das Risiko später gelöscht wird. Nur das Löschen des Projekts oder der Kostenart nimmt die Buchung als Kaskade mit (siehe Sperren & Löschschutz).

Fehlt eine Voraussetzung (keine Kostenart der passenden Kategorie im Projekt, kein Stundensatz, kein Nettopreis am Gut, kein Datum), ändert die Regel nichts und protokolliert das serverseitig. Bestehende abgeleitete Zeilen bleiben unverändert. Beim nächsten Ereignis an der Quelle wird erneut versucht. Ein einmal verpasstes Ereignis (z. B. Genehmigung ohne Personal-Kostenart) wird also nicht automatisch nachgeholt, solange sich die Quelle nicht erneut ändert.

  • Die Verarbeitung läuft asynchron im Hintergrund; abgeleitete Zeilen erscheinen typischerweise binnen Sekunden, nicht sofort.
  • Eine vom System erzeugte Zeile darf nie in eine andere Tabelle „umziehen“; das gilt als Regelfehler.