Admin

Aufbau

• Das Select neben dem Titel wechselt zwischen verfügbaren Admin-Sichten.
• Ist nur eine Sicht verfügbar, bleibt das Select sichtbar, aber deaktiviert.
• Passwort ändern bleibt für das eigene Konto erreichbar.
• Weitere Sichten erscheinen nur mit passenden Rechten.

Admin-Sichten

Passwort ändern

1 2 3

Marker	Element	Bedeutung
1	Admin-Sichtauswahl	Wählt den Teilbereich Passwort ändern.
2	Passwortfelder	Erfassen neues Passwort und Wiederholung.
3	Speichern	Übernimmt die Änderung nach Validierung.

Abb. A-01 zeigt die persönliche Passwortmaske. Nutzen Sie diese Sicht für das eigene Konto; neues Passwort und Wiederholung müssen übereinstimmen, bevor gespeichert werden kann.

Sammlungsverwaltung

1 2 3 4

Marker	Element	Bedeutung
1	Sammlungen	Öffnet die Verwaltung von Service-Sammlungen.
2	Sammlungsliste	Wählt eine Sammlung.
3	Detailformular	Pflegt Name und Kurzbeschreibung und zeigt die zugeordneten Services.
4	Aktionen	Speichert, erstellt oder löscht Sammlungen.

Abb. A-02 zeigt Sammlungen und zugeordnete Services. Die Sicht dient dazu, fachliche Service-Gruppen zu benennen und zu prüfen; eine separate Sortier- oder Sichtbarkeitspflege findet hier nicht statt. Die Standardsammlung ist geschützt und darf nicht wie eine normale Sammlung behandelt werden.

Benutzerverwaltung

1 2 3 4

Marker	Element	Bedeutung
1	Benutzer	Öffnet Benutzerkonten und Rechtezuordnung.
2	Benutzerliste	Wählt vorhandene Konten.
3	Detailbereich	Pflegt Anzeigename, Loginstatus und Rollen.
4	Aktionen	Speichert, sperrt oder erstellt Benutzer.

Abb. A-03 zeigt die Kontenliste, Benutzerfelder, Rolle, Aktiv-Status und Passwortaktionen. Pflegen Sie hier normale Benutzerkonten; der technische Benutzer admin ist geschützt.

Rollenverwaltung

1 2 3 4

Marker	Element	Bedeutung
1	Rollen	Öffnet Rollen und Rechtepakete.
2	Rollenliste	Wählt eine Rolle zur Bearbeitung.
3	Rechte-Matrix	Steuert sichtbare Reiter, Ansichten und Aktionen.
4	Speichern	Übernimmt die Rechteänderung.

Abb. A-04 zeigt Custom-Rollen und die Rechte-Matrix. Änderungen an Rechten können sichtbare Reiter, Aktionen und bestehende Sitzungen beeinflussen und müssen nach dem Speichern geprüft werden.

LLM-Konfiguration

1 2 3 4

Marker	Element	Bedeutung
1	LLM	Öffnet Modellziele und Providerkonfiguration.
2	Bereichsauswahl	Öffnet Admin-, Übersetzungs- oder Chat-Zielkonfiguration.
3	Konfiguration	Pflegt Basis-URL, API-Key, Modellanzeige und Bereichseinstellungen.
4	Test und Speichern	Prüft Erreichbarkeit und speichert die Einstellung.

Abb. A-05 zeigt Admin-, Chat- und Übersetzungsziele sowie den Zieltest. Prüfen Sie Ziel, Modell, Allowlist und Testausgabe, bevor produktive Chat- oder Admin-Flows damit arbeiten.

• Pro Bereich können mehrere Ziele hinterlegt, getestet und entfernt werden.
• Beim Chat-Ziel steuert Denk-Anzeige im Chat, ob und wo eine laufende Modellantwort sichtbar gemacht wird.
• Die technische Übersetzungskonfiguration bleibt hier; die fachliche Sprachfreigabe wird unter Sprachen gepflegt.
• Gespeicherte API-Keys können über die Löschoption entfernt werden, ohne andere Zielwerte zu verlieren.

Sprachen

Der Bereich Sprachen liegt vor Layout und steuert die Mehrsprachigkeit von ai-assist. Die aktiven Dialogsprachen werden in zwei Listen gepflegt: mögliche und aktive Sprachen.

• Mehrsprachigkeit aktivieren schaltet den fremdsprachigen Dialogpfad ein oder aus.
• Aktivieren und Deaktivieren verschieben Sprachen zwischen möglicher und aktiver Liste. Die aktive Liste zeigt zusätzlich getrennt an, ob LibreTranslate die Sprache aktuell bereitstellt und ob die UI-Übersetzungsliste vollständig ist oder wie viele Texte noch offen beziehungsweise veraltet sind.
• Eine aktive Fremdsprache wird im Bürgerchat erst angeboten, wenn die UI-Übersetzungsliste vollständig ist. Unvollständige oder veraltete Sprachen bleiben im Admin pflegbar, erscheinen aber weder im Sprachhinweis noch in der Chat-Sprachauswahl.
• Bearbeiten in der aktiven Sprachzeile öffnet eine kompakte Liste mit deutschem Ursprungstext und gepflegter Übersetzung. Im Code liegen keine fremdsprachigen Vorbelegungen; fehlende Übersetzungen werden beim Öffnen als frische LibreTranslate-Entwürfe angezeigt. Die Filterfelder für Deutsch und Übersetzung begrenzen die sichtbaren Einträge. KI → erzeugt für die sichtbaren Einträge erneut Übersetzungsentwürfe über LibreTranslate und zeigt währenddessen einen Laufhinweis; gespeichert wird erst mit Speichern. Ist die Sprache in LibreTranslate noch nicht geladen, bleibt die manuelle Pflege möglich, KI → wird deaktiviert und der Neustart-Hinweis eingeblendet.
• Platzhalter wie {count} oder {filename} müssen in Übersetzungen erhalten bleiben.
• Nach Aktivierung der Mehrsprachigkeit oder Anpassung der aktiven Sprachliste zeigt der Bereich einen Hinweis mit Link in die geöffnete Übersetzungs-Konfiguration. Die technische Einrichtung und der Runtime-Neustart bleiben in der LLM-Konfiguration.

Layout

1 2 3 4

Marker	Element	Bedeutung
1	Layout	Öffnet Branding und Chatdarstellung.
2	Logo und Texte	Pflegt sichtbare Marken- und Kopfbereichsdaten.
3	Farben und Vorschau	Kontrolliert, wie Änderungen im Chat wirken.
4	Speichern	Übernimmt die Layoutkonfiguration.

Abb. A-06 zeigt Branding, Logo, Farben und Chat-Vorschau. Änderungen sollten in der Vorschau kontrolliert und erst danach gespeichert werden.

• Es können mehrere Layouts gepflegt werden; genau ein Layout ist aktiv.
• Admin-Logo und Chat-Logo werden getrennt hochgeladen und können einzeln zurückgesetzt werden.
• Layout-Export und -Import liegen unter Datensicherung & -wiederherstellung; Logos sind darin nicht enthalten.

Layout-Felder

Konfigurationsbeispiele

Beim Layout-Export werden benutzerspezifische Layouts ohne Logos exportiert. Nach einem Import müssen Logos daher erneut hochgeladen werden. Importierte neue Layouts werden nicht automatisch aktiv; prüfen und aktivieren Sie sie bewusst.

Datensicherung und Wiederherstellung

1 2 3 4

Marker	Element	Bedeutung
1	Datensicherung	Öffnet Backup und Restore.
2	Backup erstellen	Erzeugt eine Sicherung vor riskanten Änderungen.
3	Restore und Upload	Stellt Sicherungen wieder her oder lädt Dateien hoch.
4	Wissensbasis	Startet besonders riskante Lösch- oder Neuaufbauaktionen.

Abb. A-07 zeigt Service-Listen-Export, Layout-Export, Gesamt-Export, Restore und Wartungsaktionen. Erstellen Sie vor Restore oder Löschung ein aktuelles Backup und testen Sie danach die wichtigsten Chat- und Admin-Flows.

Export- und Importdateien im Adminbereich

{
  "services": [
    {
      "service_id": "wohnbeihilfe",
      "collection_name": "Soziales",
      "bezeichnung": "Wohnbeihilfe",
      "leistungsbeschreibung_url": "https://example.gv.at/wohnbeihilfe"
    }
  ]
}

{
  "layouts": [
    {
      "customer_name": "Gemeinde Musterstadt",
      "customer_description": "Kommunales Chatlayout",
      "chat_primary_color": "#0b5cab",
      "chat_background_primary": "#ffffff",
      "chat_button_background": "#064486",
      "chat_button_text_color": "#ffffff",
      "chat_font_family": "Source Sans",
      "chat_font_size": 16,
      "chat_logo_position": "left",
      "chat_radius": "soft",
      "chat_shadow": "light",
      "chat_bot_label": "Musterstadt Assistenz",
      "chat_user_label": "Sie"
    }
  ]
}

{
  "manifest": {
    "manifest_version": "2",
    "profile": "full_system",
    "generated_at": "2026-08-02T10:15:00Z",
    "tables": ["services", "source_documents", "systems_settings"]
  },
  "profile": "full_system",
  "tables": {
    "services": [
      {"slug": "wohnbeihilfe", "name": "Wohnbeihilfe"}
    ],
    "systems_settings": [
      {"key": "chat.max_message_chars", "value": "4000", "value_type": "int"}
    ]
  }
}

Fachprofile

Die Sicht Fachprofile zeigt ausgelieferte, versionierte Projektdateien für Wissenskarten-Kategorien, Harvest-Fokusgruppen, Startberatungssignale und Runtime-Matching. Inhalte werden hier nicht direkt bearbeitet; Profiländerungen entstehen in der Entwicklungsumgebung und werden mit dem Deployment ausgeliefert.

• Aktive Profilkaskade zeigt, ob nur das Basisprofil oder zusätzlich ein Kunden-Fachprofil aktiv ist.
• Profilkaskade auswählen listet die ausgelieferten Profile, zum Beispiel basis, kunde_burgenland oder kunde_kufgem, sofern diese Dateien in der Instanz vorhanden sind.
• Validieren prüft die ausgewählte Profildatei, ohne sie zu aktivieren.
• Aktivieren schreibt Profil-Key, Version und Checksumme als Fachprofil-Systemwerte und löst einen Runtime-Reload aus.
• Beschreibungsfile für KI lädt ein Diagnosepaket herunter, wenn ein Profil ungültig oder die gespeicherte Aktivierung nicht mehr konsistent zur ausgelieferten Datei ist.

Nach einer Aktivierung können vorhandene Wissenskarten je nach Profiländerung einen Re-Harvest brauchen, damit Kategorien, Foki, Tags oder Fragevarianten zum neuen Profil passen. Prüfen Sie danach freie Fragen in Testen > QS-Startberatung.

Systemparameter

1 2 3 4

Marker	Element	Bedeutung
1	Systemparameter	Öffnet zentrale Laufzeit- und Sicherheitswerte.
2	Kategorien und Suche	Findet relevante Parameter.
3	Effektiver Wert	Zeigt Datenbankwert, Umgebungswert und Gültigkeit.
4	Speichern und prüfen	Übernimmt Änderungen und stösst Prüfungen an.

Abb. A-08 zeigt die gruppierten Systemparameter mit effektiven Werten, Overrides und Quellen. ENV-Vorgaben bleiben vorrangig; Änderungen können Limits, Retention, LLM-Verhalten, Quellen oder AFS-Vorschau beeinflussen.

• Default ist der mitgelieferte Standardwert.
• Wirksam ist der Wert, den die Anwendung aktuell verwendet.
• ENV zeigt, ob der Betrieb den Parameter ausserhalb des Adminbereichs vorgibt; solche Werte sind in der Oberfläche schreibgeschützt.
• Sicherheitsrelevante Parameter zeigen zusätzliche Hinweise zu Angriffsszenario und Schutzmassnahme.

{
  "schema_version": 1,
  "generated_at": "2026-08-02T10:15:00Z",
  "table": "systems_settings",
  "settings": [
    {
      "key": "chat.max_message_chars",
      "value": "4000",
      "value_type": "int",
      "updated_at": "2026-08-02T10:10:00Z",
      "updated_by": "admin"
    }
  ]
}

{
  "schema_version": 1,
  "generated_at": "2026-08-02T10:15:00Z",
  "purpose": "Beschreibungsfile für KI bei nicht konsistentem oder ungültigem Fachprofil.",
  "active_profile": {"key": "stadt_musterstadt", "version": "1.0"},
  "selected_validation": {"valid": false, "errors": ["Kategorie fehlt"]},
  "available_profiles": [
    {"key": "base", "label": "Basis-Fachprofil", "version": "1.0"}
  ]
}

Security-Findings

1 2 3 4 5

Marker	Element	Bedeutung
1	Security-Findings	Öffnet Sicherheitsbefunde aus Prüfungen.
2	Filter und Testangriff	Filtert Befunde oder erzeugt Testeinträge.
3	Finding-Liste	Wählt einen Befund und zeigt Schweregrad.
4	Detailbereich	Zeigt Objekt, Quelle, Ausschnitt und Empfehlung.
5	Statusaktionen	Öffnet Objekt, akzeptiert Risiko, erledigt oder meldet Fehlalarm.

Abb. A-09 zeigt Filter, Treffer, technische Details und Bewertungsaktionen. Ein Finding ist ein Sicherheitshinweis und kein Inhaltseditor; nötige Korrekturen erfolgen am betroffenen Objekt.

Securitycheck Konfiguration prüft Admin-Inhalte, Prompts, Fachinhalte und Systemparameter. Während der Prüfung zeigt ein Fortschrittsdialog den laufenden Bereich; ein Abbruch stoppt weitere Prüfungen, bereits gespeicherte Findings bleiben erhalten. Testangriff durchführen erzeugt kontrollierte Findings vom Typ security_test und markiert sie im Audit als Testlauf.

• Testangriff-Einträge löschen entfernt gezielt die kontrollierten Test-Findings.
• Alle Findings löschen ist nur in lokalen Entwicklungsumgebungen sichtbar und nicht für produktive Bereinigung gedacht.
• Der semantische Review verwendet den geschützten Security-Review-Prompt aus Prompts; Bearbeitung und Standardsetzung sind an audit.write gebunden.

Kurzreferenz

Arbeitsablauf: Benutzer und Rollen pflegen

1. Öffnen Sie Benutzerverwaltung.
2. Legen Sie ein Konto an oder wählen Sie ein bestehendes.
3. Pflegen Sie Rolle und Aktiv-Status.
4. Nutzen Sie bei Bedarf Initialpasswort setzen.
5. Öffnen Sie Rollenverwaltung, wenn Custom-Rechte angepasst werden müssen.
6. Prüfen Sie danach, ob die erwarteten Reiter sichtbar sind.

Arbeitsablauf: Backup oder Restore

1. Öffnen Sie Datensicherung & Wiederherstellung.
2. Für normale Sicherung nutzen Sie GESAMT-Export.
3. Für Stammdatenabgleich nutzen Sie Serviceliste-Export; für Branding nutzen Sie Layout-Export.
4. Prüfen Sie beim Import oder Restore, ob Datei und sichtbarer Importbereich zum Zweck passen.
5. Beachten Sie: Restore überschreibt fachliche Daten und Systemparameter-Overrides; ENV bleibt vorrangig.
6. Nach Restore Anwendung neu laden und zentrale Flows testen.

Arbeitsablauf: Security-Finding bewerten

1. Öffnen Sie Security-Findings.
2. Filtern Sie nach Status oder Objekttyp.
3. Lesen Sie Ausschnitt, Kategorie, Schweregrad und technische Details.
4. Öffnen Sie das betroffene Objekt, wenn eine Korrektur nötig ist.
5. Bewerten Sie mit Erledigt, Akzeptiertes Risiko, Fehlalarm oder Wieder öffnen.
6. Prüfen Sie bei Systemparameter-Hinweisen die mögliche Härtung.

Referenz: riskante Aktionen

1 2 3

Marker	Element	Bedeutung
1	Warnhinweis	Beschreibt die Auswirkung der Löschaktion.
2	Abbrechen	Schliesst den Dialog ohne Änderung.
3	Löschen bestätigen	Führt die riskante Aktion aus.

Abb. X-03 zeigt den Sicherheitsdialog vor dem Löschen der Wissensbasis. Die Bestätigung ist bewusst sichtbar und getrennt von normalen Pflegeaktionen, weil Services, Fakten, Parameter und Dokumente entfernt werden.

• Restore: spielt eine Backup-Datei ein und überschreibt bestehende Daten im betroffenen Umfang.
• Wissensbasis löschen: entfernt Services, Fakten, Parameter und Dokumente; Benutzer und Rollen bleiben erhalten.
• Systemparameter speichern: kann Limits, Retention, LLM-Verhalten oder AFS-Vorschau verändern.
• Security-Testangriff: erzeugt kontrollierte Test-Findings und protokolliert Auditdaten.

Querverweise

• Services für Sammlungswirkung.
• Prompts für geschützte Prompt-Änderungen.
• Log für Audit und Chatlog-Nachvollziehbarkeit.
• Referenz für Rechte und Aktionen.