Fastlane Gitea

Prompt- und Schema-Definitionen fuer Fastlane — die KI-Schnittstelle zwischen Fachanwendern und einem externen System. Claude analysiert natuerlichsprachliche Anfragen und liefert strukturierte JSON-Antworten, die vom Flutter-Frontend gerendert werden.

Verzeichnisstruktur

prompts/          # System-Prompts (steuern Claudes Verhalten)
schemas/          # JSON-Schemas (definieren die Antwortstruktur)

Prompts (prompts/)

Jeder Prompt ist eine JSON-Datei mit folgendem Aufbau:

{
  "key": "unique_identifier",
  "description": "Kurzbeschreibung des Prompts",
  "response_schema_ref": "fastlane_response.schema.json",
  "tags": ["tag1", "tag2"],
  "system_prompt": "Der vollstaendige System-Prompt als String"
}

Feld	Beschreibung
key	Eindeutiger Bezeichner
description	Was der Prompt tut
response_schema_ref	Verweis auf das JSON-Schema fuer die Antwort
tags	Kategorisierung (z.B. general, fleet, energy)
system_prompt	Instruktionen an Claude

Schemas (schemas/)

JSON-Schema-Dateien (Draft-07), die die Antwortstruktur validieren.

Antwort-Modi

Claude antwortet immer mit einem von zwei Modi:

response_type: "form"

Wird verwendet, wenn Claude zusaetzliche Informationen braucht. Generiert ein Formular, das im Flutter-Frontend via flutter_form_builder gerendert wird.

{
  "response_type": "form",
  "message": "Bitte waehle den Zeitraum aus.",
  "form": {
    "title": "Zeitraum waehlen",
    "fields": [
      {
        "name": "zeitraum",
        "widget": "date_range_picker",
        "label": "Zeitraum",
        "validators": [{ "type": "required" }]
      }
    ]
  }
}

response_type: "result"

Wird verwendet, wenn Claude alle Informationen hat. Kann HTML, Intents und Code-Bloecke enthalten.

{
  "response_type": "result",
  "message": "Hier ist die Uebersicht.",
  "html_content": "<table>...</table>",
  "intents": [{ "action": "notify", "params": { "message": "Fertig" } }],
  "code_blocks": [{ "execution_type": "graphql", "code": "{ vehicles { id } }" }]
}

Verfuegbare Form-Widgets

text_field | dropdown | date_time_picker | date_range_picker | checkbox | checkbox_group | radio_group | switch_field | slider | range_slider | choice_chip | filter_chip | segmented_control | typeahead

Verfuegbare Intent-Actions

Action	Zweck
navigate	Zu einer Route navigieren
display	Daten in einer Komponente anzeigen
confirm	Bestaetigung vor destruktiver Aktion
refresh	Aktuelle Ansicht aktualisieren
notify	Toast-Benachrichtigung

Code-Block-Typen

Typ	Verwendung
python	httpx + AUTH_HEADERS, Ergebnis in result
graphql	Query/Mutation mit variables
odata	path, method, params, body