Zum Hauptinhalt springen

Folder dashboards

Build KPI and chart widgets on a folder's custom dashboard through Higento chat. Higento asks one question at a time with ask-user, then saves the widget when you confirm.

MVP: No live chart in chat — after dashboard-add-widget, open the folder in the UI to see the widget.

Prerequisites​

  • A folder with at least one table in its tree (folder or subfolder).
  • Higento opened in that folder (or pass folderId explicitly).

Example: KPI widget​

You: „Füg ein KPI für offene Verträge auf dem Ordner-Dashboard hinzu.“

Higento flow:

  1. dashboard-read — checks dashboard enabled, lists tables.
  2. dashboard-enable — if needed.
  3. ask-user — widget type → KPI.
  4. ask-user — table → Verträge (display name).
  5. ask-user — filter → all rows / view / custom.
  6. ask-user — metric → count (or sum/avg + column).
  7. ask-user — title → Offene Verträge.
  8. ask-user — confirm add.
  9. dashboard-add-widget — persists widget; you open the folder to view it.

Example: Time series​

Same wizard; choose time series in step 1. Extra ask-user steps for time field and bucket (day/week/month) before confirm.

Example: Update widget​

You: „Benenne das KPI Offene Verträge in Aktive Verträge um.“

Higento flow:

  1. dashboard-read — find widget by title → widgetId.
  2. table-read — schema for that widget's table.
  3. dashboard-update-widget — same params as add, with widgetId and updated fields.

Functions used​

StepFunction
Discoverdashboard-read
Enabledashboard-enable
Questionsask-user
Save (new)dashboard-add-widget
Save (edit)dashboard-update-widget

Tests​

Orchestrator CLI:

./higent-test run folder-assistant/unit/higento-dashboard-read
./higent-test run folder-assistant/unit/higento-dashboard-enable
./higent-test run folder-assistant/unit/higento-dashboard-add-widget
./higent-test run folder-assistant/unit/higento-dashboard-update-widget
./higent-test run folder-assistant/blueprints/higento-dashboard-widget-lifecycle