Glossar

Kurzanleitung zu Aptli-spezifischen Begriffen, die auf der gesamten Plattform und in diesem Leitfaden verwendet werden.

Daten & Datensätze

Versionsbasiertes Modell

Datensätze, die einen Zyklus aus Entwurf → Diff → Commit durchlaufen, bevor Änderungen dauerhaft gespeichert werden. Versionierte Datensätze unterstützen die Offline-Bearbeitung, Rückgängig/Wiederherstellen, Konflikterkennung und einen vollständigen Versionsverlauf. In Aptli verwenden Kartenelemente (Punkte, Linien, Polygone, Ebenen, Schemata) und Aufträge das versionierte Modell.

Im Gegensatz zu: Echtzeitmodell

Echtzeitmodell

Datensätze, die ohne Zwischenspeicherungsschritt sofort auf dem Server gespeichert werden. Änderungen sind für alle Benutzer sofort sichtbar. Arbeitsaufträge, Berichte, Validierungen, Transaktionen und Standorte nutzen das Echtzeitmodell.

Im Gegensatz zu: Versionsmodell

Entwurf

Eine Reihe lokaler Änderungen an versionierten Datensätzen, die noch nicht auf dem Server festgeschrieben wurden. Entwürfe werden im Browser gespeichert und bleiben auch bei Seitenaktualisierungen ohne Netzwerkzugang erhalten. Ein Benutzer kann pro Version einen aktiven Entwurf haben. Entwürfe können zur Überprüfung durch den Administrator auf den Server hochgeladen werden, bevor sie live geschaltet werden.

Commit

Der Vorgang, bei dem die Änderungen eines Entwurfs dauerhaft auf den Live-Datensatz angewendet werden. Durch Commits wird ein neuer, unveränderlicher Eintrag im Versionsverlauf erstellt. Nur Benutzer mit dem Administratorrecht allowCommits können Commits durchführen.

Versionskonflikt

Tritt auf, wenn zwei Benutzer dasselbe Objekt in separaten Offline-Entwürfen bearbeitet haben. Aptli erkennt Konflikte beim Commit, indem es die Basisversion, auf der jeder Entwurf basiert, mit der aktuellen Live-Version vergleicht. Konfliktbehaftete Commits werden zur Überprüfung durch den Administrator markiert und können erst nach Behebung des Konflikts übernommen werden – es findet kein stillschweigendes Überschreiben statt.

Bestandsverwaltung

Ressource

Eine Definition eines Materials, eines Verbrauchsmaterials, eines Gerätetyps oder einer Arbeitskategorie. Ressourcen definieren ihre Maßeinheiten und Abholrichtlinien und stellen das dar, was ein Auftrag verbraucht. Die an Ressourcen durchgeführten Arbeiten werden separat als Aktivität katalogisiert. Beispiele: 500 m Glasfaserkabel, Betonankerbolzen, Montagestunde.

Aktivität

Eine Definition einer Art von Arbeit, die ein Team ausführt – Spleißen, Kabelverlegung, Aushub, Inspektion. Aktivitäten sind das arbeitsseitige Pendant zu Ressourcen: ein eigenständiges Verzeichnis mit eigenen Maßeinheiten (§193), auf das in einer Arbeitsauftrags- als Aktivitätszeile referenziert wird, die entweder aus dem Katalog ausgewählt oder ad hoc eingegeben wird. Optional – ein Arbeitsauftrag muss keine nennen. Beispiele: Fusionsspleiß, Glasfaserverlegung (m), Richtbohrung (m). Verwaltung unter „Administration“ → „Aktivitäten“ (activitiesCreate / activitiesUpdate / activitiesDelete).

Lagerbestand

Der aktuelle Bestand einer bestimmten Ressource an einem bestimmten Standort. Lagerbestände werden ausschließlich durch Transaktionen aktualisiert – sie werden niemals direkt bearbeitet. Eine Ressource kann gleichzeitig an mehreren Standorten Lagerbestände haben.

Standort

Ein physischer oder logischer Ort, an dem Bestände gelagert werden. Zu den Standorten zählen Lagerhäuser, Lagerplätze, Außendienstdepots, „persönliche Standorte“ einzelner Mitarbeiter sowie Fahrzeuge. Jeder Benutzer kann einen persönlichen Standort haben, an den Bestände durch QR-Scan-Abholungen geliefert werden.

Transaktion

Ein unveränderlicher Buchungseintrag, der jede Bestandsbewegung erfasst. Transaktionen können weder bearbeitet noch gelöscht werden – Korrekturen erfolgen immer durch die Erstellung einer neuen Korrekturtransaktion. Transaktionsarten:

Abholcode

Ein zeitlich begrenzter, fälschungssicherer QR-Code, der bei der Zuweisung eines Arbeitsauftrags ausgestellt wird. Außendienstmitarbeiter scannen den Abholcode im Lager, um ihre zugewiesenen Materialien zu autorisieren und in Empfang zu nehmen. Abholcodes enthalten die autorisierten Ressourcenmengen, die zugehörige Zuweisung sowie eine Ablaufzeit. Nur der zugewiesene Mitarbeiter – oder ein Benutzer mit der Berechtigung canFacilitatePickups – kann sie scannen.

Transfercode

Ein fälschungssicherer QR-Code, der einen Peer-to-Peer-Bestandstransfer zwischen Standorten autorisiert. Im Gegensatz zu Abholcodes sind Transfercodes nicht an einen Arbeitsauftrag gebunden. Sie können für jede Bewegung zwischen Standorten generiert und vom Empfänger gescannt werden, um den Transfer auszuführen und die Transaktion automatisch zu erfassen.

Zwischenlagerressource

Eine vorübergehende „Zwischenlager“-Kennzeichnung, die verwendet wird, wenn eine Lieferung mit Artikeln eingeht, die noch nicht im Ressourcenkatalog vorhanden sind. Außendienstmitarbeiter nehmen die Lieferung in die Zwischenlagerressource auf, damit die Arbeit nicht blockiert wird; Büromitarbeiter ordnen den Bestand später einer entsprechenden Ressource zu, sobald diese definiert ist. Verhindert die Sackgasse „Ich kann das nicht annehmen, weil es nicht im System ist“.

Abholrichtlinie

Die einzige Einstellung auf Steuerungsebene für eine Ressource, die regelt, wer diese in jedem Ablauf (Auftragsabholung, Selbstausleihe, Transfer) ausgeben oder abholen darf. Einer von drei Werten:

Vermittelte Abholung

Das Verhalten einer Ressource, deren Abholrichtlinie auf vermittelt gesetzt ist. Ein Mitarbeiter kann sie nicht selbst aushändigen; stattdessen führt das Lagerpersonal (ein Inhaber der Berechtigung canFacilitatePickups) die Abholung im Namen des Mitarbeiters durch, während dieser anwesend ist. Die Transaktion protokolliert beide Parteien sowie die verwendete Scan-Methode.

Auftragsabwicklung

Auftrag

Eine georäumlich verortete Einheit geplanter Arbeit mit optionalen Ressourcenanforderungen. Aufträge sind versioniert – sie durchlaufen wie Kartenobjekte die Phasen Entwurf → Commit. Ein Auftrag kann an einem Punkt (einem Schacht), einer Linienkette (einem Straßenabschnitt), einem Polygon (einem Wohngebiet) verortet sein oder für Büroarbeiten ohne Standortangabe belassen werden. Aufträge gehören zu Projekten und werden über Arbeitsaufträge abgewickelt; die durchgeführten Arbeiten werden in der Aktivitätszeile des Arbeitsauftrags erfasst.

Arbeitsauftrag

Eine Zuweisung eines Auftrags an ein Team mit einem Fälligkeitsdatum, einer optionalen Aktivitätszeile (die auszuführende Arbeit) und einem optionalen Abholcode für Materialien. Arbeitsaufträge verfolgen den Status (ausstehend → in Bearbeitung → abgeschlossen) in Echtzeit. Wird auch als Zuweisung bezeichnet.

Auftrag

Wird in Aptli synonym mit Arbeitsauftrag verwendet. In einigen Bereichen der Benutzeroberfläche wird das Konzept zwar weiterhin als „Auftrag“ bezeichnet, doch der zugrunde liegende Datensatz und die zugehörigen Administratorrechte heißen Arbeitsauftrag (workOrdersCreate, workOrdersUpdate, workOrdersDelete). Beide Begriffe beziehen sich auf dasselbe.

Bericht

Die Aufzeichnung der abgeschlossenen Arbeit durch einen Außendienstmitarbeiter. Berichte erfassen die durchgeführten Arbeiten, den GPS-Standort, die tatsächlich verbrauchten Ressourcen sowie Fotos. Berichte können im Rahmen eines formellen Auftrags oder ad hoc für ungeplante Wartungsarbeiten eingereicht werden. Das Einreichen eines Berichts löst automatische Bestandsabzüge aus und benachrichtigt die Vorgesetzten.

Validierung

Die Qualitätssicherungsprüfung eines eingereichten Berichts durch einen Vorgesetzten. Bei Validierungen werden das Ergebnis (bestanden / nicht bestanden / muss überarbeitet werden / mit Anmerkungen genehmigt) sowie etwaige Feststellungen festgehalten. Eine nicht bestandene oder zur Überarbeitung zurückgesandte Validierung führt dazu, dass der Bericht an den Mitarbeiter zurückgeschickt wird; eine genehmigte Validierung kann die Berechnung der Zahlungsfreigabe auslösen.

Projekt

Eine Gruppe miteinander verbundener Aufträge mit gemeinsamem Fälligkeitsdatum und gemeinsamer Teamzuweisung. Projekte bieten einen übergeordneten Überblick über den Fortschritt aller zugehörigen Aufträge und Berichte.

Sicherheit & Zugriff

Administratorrechte

Permissive Berechtigungen, die steuern, was ein Benutzer tun darf. Aptli bietet detaillierte Administratorrechte, die jede Erstellungs-, Lese-, Aktualisierungs- und Löschaktion im System abdecken. Beispiele: workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, auditView. Administratorrechte sind additiv – ein Benutzer ohne Rechte kann nur seine eigenen Aufträge einsehen.

Rollenbeschränkungen

Restriktive Filter auf Feldebene, die steuern, welche Daten ein Benutzer nicht sehen darf. Rollenbeschränkungen werden serverseitig durchgesetzt: Nicht autorisierte Daten werden niemals an den Client gesendet, sondern nicht nur in der Benutzeroberfläche ausgeblendet. Beispiel: Eine Einschränkung auf assignedTo = currentUser beschränkt einen Auftragnehmer darauf, nur seine eigenen Arbeitsaufträge zu sehen. Rolleneinschränkungen und Administratorrechte funktionieren als zwei unabhängige Ebenen.

Zugriffsanfrage

Ein ausstehendes Konto, das erstellt wird, wenn sich jemand über die Anmeldeseite selbst registriert. Zugriffsanfragen verbleiben unter Admin → Zugriffsanfragen, bis ein Administrator sie genehmigt oder ablehnt. Bei Genehmigung wird das Konto zu einem regulären Benutzer; bei Ablehnung wird die Anfrage vorläufig gelöscht.

Eine einzige aktive Sitzung

Das Sitzungsmodell von Aptli erlaubt zu jedem Zeitpunkt eine aktive Anmeldung pro Konto auf allen Geräten. Die Anmeldung auf einem neuen Gerät beendet die vorherige Sitzung; das verdrängte Gerät erhält eine einmalige Benachrichtigung und wird zur Anmeldeseite zurückgeleitet. Zwei Registerkarten im selben Browserprofil teilen sich eine Sitzung und verdrängen sich nicht gegenseitig.

Harte Sperre

Ein Kontostatus, der die Anmeldung über alle Methoden verhindert. Wird automatisch nach wiederholten fehlgeschlagenen Anmeldeversuchen (Standard: 10 aufeinanderfolgende Fehlversuche) ausgelöst oder manuell von einem Administrator gesetzt. Kann nur von einem Administrator mit der Berechtigung usersUpdate aufgehoben werden.

Wartungsmodus

Ein vom Administrator aktivierbarer Modus, der Schreibvorgänge von Nicht-Administratoren blockiert und allen Benutzern ein Banner anzeigt. Beabsichtigt für kurze Zeitfenster, in denen eine Migration oder ein Batch-Job läuft und Schreibvorgänge von Benutzern den laufenden Betrieb beeinträchtigen würden. Administratoren behalten den vollen Zugriff.

Audit-Protokoll

Ein ausschließlich nachträglich ergänztes Protokoll aussagekräftiger Aktionen im gesamten System – Anmeldungen, das Anlegen und Bearbeiten von Datensätzen, Datei-Uploads, Statuswechsel, die Vergabe von Administratorrechten. Einzelne Datensätze sind in der eingebetteten Zeitleiste auf den Detailseiten sichtbar, alle Datensätze zusammen unter Admin → Audit-Verlauf (erfordert auditView). Exportierbar als CSV zur externen Überprüfung (erfordert auditExport).

Archiviert (vorläufig gelöscht)

Ein Datensatz, der als gelöscht markiert, aber physisch beibehalten wird. Archivierte Datensätze werden in normalen Listen und Abfragen ausgeblendet; Benutzer mit der Berechtigung viewDeleted können sie einblenden und bei Bedarf wiederherstellen. Aptli löscht Datensätze nur selten endgültig – durch die Archivierung bleiben Prüf- und Betriebsverlauf erhalten.

Karte & GIS

Ebene

Eine benannte Sammlung von Kartenobjekten, die denselben Geometrietyp (Punkte, Linien oder Polygone) und denselben visuellen Stil (Symbol, Farbe, Linienstärke) aufweisen. Ebenen definieren, was ein Objekt ist – zum Beispiel eine Ebene „Telefonmasten“ oder eine Ebene „Leitungsrouten“. Ebenen sind versioniert.

Schema

Ein Beziehungsdiagramm, das Verbindungen zwischen Kartenelementen oder abstrakten Objekten modelliert. Schemata verwenden einen Grapheneditor (Knoten und gerichtete Kanten), um Netzwerktopologie, Kabelverläufe, Leitungskanalauslastung oder andere Beziehungen darzustellen, die sich allein auf einer geografischen Karte nur schwer ausdrücken lassen. Schemata sind versioniert.

Zeichenbereich

Ein temporärer Bearbeitungsbereich, in dem Geometrie gezeichnet und verfeinert wird, bevor sie als permanente Kartenobjekte übernommen wird. Der Zeichenbereich ermöglicht es, komplexe Bearbeitungen – Freihandzeichnen, Einrasten, Operationen mit mehreren Objekten – zu überprüfen, bevor sie live geschaltet werden.

Felddatensätze

Die Bezeichnung für die Kartenoberfläche in der Navigation von Aptli – dort, wo geografische Objekte gespeichert sind und gezeichnet, bearbeitet und nachgezeichnet werden. (Die Werkzeuge der Karte werden als Fenster über die Symbolleiste geöffnet.)

Fenster

Ein schwebendes, verschiebbares Fenster, das über die Kartensymbolleiste geöffnet wird. Jedes Fenster schaltet ein Werkzeug um: Ausgewählte Objekte, Suche, Datenübertragung und Ebenenmanager sind immer vorhanden; Projekte, Ebenenbeziehungen und Builder werden angezeigt, wenn die entsprechende Funktion lizenziert ist. Ein Fenster kann für die Arbeit mit mehreren Monitoren in ein separates Browserfenster ausgelagert werden.

Ausführungslupe

Eine Kartenüberlagerung, die vorhandene Objekte entsprechend ihrem abgeleiteten Bearbeitungsstatus neu einfärbt, sodass der Status eines Bereichs auf einen Blick erkennbar ist. Es können mehrere gleichzeitig aktiv sein. Zu den Linsen gehören Fortschritt, Meine Arbeitsaufträge, Muss validiert werden, Fehlgeschlagen, Validiert, Muss überarbeitet werden, Mit Anmerkungen genehmigt und Nicht zugewiesen. Aktivierung über Ebenenmanager → Überlagerungen.

Präsenz-Lens

Eine Ergänzung zu den Ausführungs-Lenses, die Objekte hervorhebt, denen eine bestimmte Art von Datensatz zugeordnet ist: Hat Auftrag, Hat Schema, Hat Standort.

Universelle Suche

Die app-weite Befehlspalette, die von jeder Seite aus mit Cmd/Strg-K geöffnet wird. Durchsucht Ihre Datensätze app-weit und springt zu einem Ergebnis. Unterscheidet sich vom Such-Fenster der Karte, das Objekte findet und dorthin springt.

Arbeiten vom Gerät aus

Der Schalter „Lesequelle“ (früher „Offline-Modus“), der dafür sorgt, dass Listenseiten und die Karte von einer lokalen Gerätekopie statt vom Live-Server bereitgestellt werden, sodass Sie auch ohne Verbindung weiterarbeiten können. In Kombination mit Automatisches Speichern auf dem Gerät (die lokale Schreibfrequenz) und dem Versionsmanager. Siehe Versionsverwaltung.

Automatisierungen & Überwachung

Hook

Ein signiertes ausgehendes Ziel, das die von Ihnen ausgewählten Ereignisse abonniert: Geben Sie eine URL und ein Signaturgeheimnis an, und jedes passende Ereignis wird dort per POST gesendet. Die einfachste ausgehende Integration. Siehe Automatisierungen & Überwachung.

Ereignis-Trigger

Eine Automatisierungsregel nach dem Modell Trigger → Bedingungen → Aktionen – wenn ein Ereignis ausgelöst wird und die Bedingungen erfüllt sind, werden eine oder mehrere Aktionen ausgeführt (benachrichtigen, einen Arbeitsauftrag erstellen, einen Webhook aufrufen, in Postgres schreiben und mehr).

Ingest-Konnektor

Eine externe Datenquelle, die Messwerte von Sensoren/Geräten an Aptli übermittelt – entweder per Pull (Aptli fragt eine Hersteller-API nach einem festgelegten Zeitplan ab) oder per Push (der Absender sendet per POST unter Verwendung eines Ingest-API-Schlüssels an einen Connector-Endpunkt).

Station

Ein Kartenobjekt, zu dem ein Sensor Messwerte meldet. Sobald Messwerte eintreffen, zeigt der Datensatz des Objekts den aktuellen Wert jeder Kennzahl sowie eine 7-Tage-Sparkline an.

Alarm

Ein Datensatz, der ausgelöst wird, wenn ein überwachter Messwert einen Schwellenwert überschreitet (mit Hysterese, damit es nicht zu Schwankungen kommt) oder wenn eine Quelle ausfällt (Erkennung eines defekten Sensors). Alarme durchlaufen die Phasen Aktiv → Bestätigt → Gelöst, benachrichtigen Empfänger und können an eine zweite Ebene eskaliert werden, wenn sie nicht rechtzeitig bestätigt werden.

Ergebnis

In einem Projekt: ein Diagramm der überwachten Metrikreihen im Vergleich zu Meilensteinen der abgeschlossenen Arbeit – Messwerte werden neben den Arbeitsschritten angezeigt, die sie möglicherweise beeinflusst haben (Korrelation zum Kontext, keine Kausalitätsbehauptung). Kann als schreibgeschützter, widerrufbarer Freigabelink veröffentlicht werden.

Verbindungskontingent

Das kommerzielle Messsystem für Automatisierungen: Jeder Ingest-Konnektor, jeder API-Schlüssel und jeder wiederverwendbare Hook verbraucht eine Einheit aus einem gemeinsamen Pool (interne ereignisgesteuerte Regeln sind nicht begrenzt). „Automations“ selbst ist in jedem Tarif enthalten.

Öffentliche Annahmestelle (Service-Portal)

Einreichung

Ein Datensatz, der erstellt wird, wenn ein Bürger über ein öffentliches Service-Portal eine Anfrage einreicht – keine Anmeldung erforderlich. Enthält eine öffentliche Referenznummer, optionale Geometriedaten und Anhänge. Die Mitarbeiter prüfen die Anfrage und können sie in einen Arbeitsauftrag, einen Bericht oder ein Kartenobjekt umwandeln.

Referenznummer

Der kurze, teilbare Code, den ein Einreicher erhält. Er enthält keine internen Identifikatoren und ist die dauerhafte Möglichkeit, eine Einreichung nachzuverfolgen oder darauf zu antworten – und auf dem Gerät des Einreichers alle seine Einreichungen aufzulisten („Meine Einreichungen“).

Weiterleitung zur Nachverfolgung

Weiterleitung einer Meldung an ein externes System als reine Einweg-Übergabe mit einem einmalig nutzbaren, zeitlich begrenzten Rückruf-Link, damit das externe System sein Ergebnis einmalig zurücksenden kann. Der Status der Meldung ändert sich dabei nicht; die Anzeige lautet Weitergeleitet → Warten auf Antwort → Beantwortet (oder Abgelaufen / Widerrufen).

Antwort zum Ausführen

Versenden eines Arbeitsauftrags per E-Mail oder SMS, damit der Empfänger den Fertigstellungsbericht durch Antworten auf die Nachricht einreichen kann – ohne Anmeldung. Die Antwortlinks sind einmalig verwendbar und verfallen.

Zusammenarbeit & Nachhaltigkeit

Multiplayer-Sitzung

Eine Live-Sitzung zur gemeinsamen Bearbeitung in Echtzeit (das Co-Design-Add-on), die durch einen 6-stelligen Code freigeschaltet wird: Zwei oder mehr Personen bearbeiten gemeinsam dieselbe Karte oder denselben Datensatz mit sichtbaren Cursorn, und der Gastgeber überträgt das vereinbarte Ergebnis in den Hauptzweig. Siehe Multiplayer.

Asset / Emissionsprofil

Die Affordanz des „Carbon“-Add-ons (auf dem Datensatz eines Kartenelements), die ein Emissionsprofil hinzufügt – wodurch das Element mit seinem Verbrauch bei einer bestimmten Rate verknüpft wird –, sodass sein Treibhausgas-Fußabdruck anhand von Standard-Emissionsfaktoren nachverfolgt wird. Siehe Carbon.

Rate-Load-Anzeige

Eine kleine Anzeige innerhalb der App, die anzeigt, wie nah Sie an der Obergrenze für die Anfragerate sind – gelb, wenn Sie sich ihr nähern, rot bei Erreichen der Obergrenze, mit dem Status „Catching up…“, wenn die App die Anfragen bewusst drosselt. Diese Anzeige dient der Information und schützt die Reaktionsfähigkeit bei hoher Auslastung.