Zum Inhalt springen

App-Dokumentation · DE

Intent-Graph

Screenshot der App

Überblick

Der Intent-Graph ist der maschinenlesbare Plan der Plattform: Er zeigt, welche App welche andere öffnen kann, aus welcher Entität eine App etwas anlegen kann und welche Apps aufeinander verweisen. Nichts davon ist von Hand gepflegt — der Graph wird automatisch aus den Steuerungsverträgen der Apps, der Entitäts-Registry für App-übergreifende Deep-Links und den Metadaten der Modul-Registry abgeleitet. Jede Kante nennt die Datei und Zeile, aus der sie stammt.

Damit werden Nutzerziele („Rechnung aus diesem Kunden anlegen", „zeige den Beleg zu dieser Zeile") maschinenlesbar: Chat, Sprache, die Kommando-Palette und die Apps selbst greifen auf denselben Graphen zu.

Der Graph

  • Übersicht nach Domäne: Ein Knoten je Domäne (Finanzen, ERP, Commerce, …); die Kantenstärke zeigt, wie viele Verbindungen zwischen zwei Domänen bestehen.
  • Domäne: Alle Apps einer Domäne mit den Kanten untereinander.
  • App: Die App im Zentrum, ihre Nachbarn im Ring; darunter die Listen Eingehend und Ausgehend — jede Kante mit Art (kann öffnen, kann anlegen aus, verweist auf, hängt ab von) und Herkunft.
  • Suche: App oder Entität nach Name oder Kennung finden und direkt anspringen.

Erreichbare Aktionen (Intent-Palette)

Sobald eine App oder Entität gewählt ist, listet die Palette nur die Aktionen, die von dort aus erreichbar sind. Ein Vorschlag ist eine Wahl: Navigationen öffnen die Ziel-App (bei ausgewähltem Datensatz mit dem kanonischen Datensatz-Link), Kommandos laufen über den Steuerungskanal — denselben, den Chat und Sprache nutzen.

Lückenliste

Die Lückenliste nennt mit Zahlen:

  • Sackgassen — Apps ohne eingehende und ausgehende Kanten,
  • Apps ohne ausgehende bzw. ohne eingehende Kanten,
  • steuerbare Apps ohne Route in der Modul-Registry,
  • Verweise ins Leere — Verwandtschafts-Angaben auf Kennungen, die es als Route nicht gibt (sie werden nie zu einer Kante).

Jeder Eintrag ist anklickbar und führt zur betroffenen App.

Deep-Links

/app/intent-graph?node=invoicing fokussiert eine App, ?node=entity:customer eine Entität, ?q=… setzt die Suche, ?tab=help öffnet die Hilfe.

Steuerung per Chat oder Sprache

Die App ist selbst steuerbar (Modul intent-graph): suggest-intents (erreichbare Aktionen für App/Entität/Datensatz), list-gaps (Lückenliste mit Zahlen), open-graph (Graph öffnen, optional fokussiert).