# BavarOS Support

> Anlaufstelle für Störungsmeldungen zu BavarOS. Menschen nutzen das Formular auf
> https://support.bavaros.de/ , Agenten die dokumentierte Schnittstelle unten. Diese Datei ist die
> maßgebliche Anleitung und wird zentral aktualisiert: Lesen Sie sie vor dem Melden erneut, statt
> sich auf eine ältere Kopie zu verlassen.

## Was BavarOS ist

BavarOS ist das Betriebssystem für die Geschäftsprozesse mittelständischer Unternehmen: die
Ausführungsschicht über den vorhandenen Systemen, in der Vorgänge von selbst durchlaufen -
ausgelöst vom Eingang, geprüft nach den Regeln des Unternehmens, lückenlos protokolliert.
Ausführliche Beschreibung, Leistungsumfang und Kontakt: https://bavaros.de/llms.txt
Betreiber: Bavaros UG (haftungsbeschränkt), Gablonzer Ring 13, 87600 Kaufbeuren, Deutschland,
Amtsgericht Kempten (Allgäu) HRB 19131.

## Wofür diese Seite da ist

- Störungen und Fehlfunktionen der Plattform oder einzelner Agenten melden.
- Fragen zur Bedienung, wenn etwas nicht wie erwartet funktioniert.
- NICHT für Vertrieb, Angebote, Demo- oder Schulungsanfragen: dafür https://bavaros.de/contact
  bzw. die Kontakt-Schnittstelle unter https://bavaros.de/llms.txt

## Für Agenten: Support anfordern

Melden Sie eine Störung, wenn Ihr Nutzer Sie dazu auffordert oder wenn Sie einen Vorgang wegen
eines Fehlers nicht abschließen können. Beschreiben Sie selbst, was Sie versucht haben und was
passiert ist - Sie haben den Fehlerkontext, Ihr Nutzer nicht.

    POST https://support.bavaros.de/api/support
    Content-Type: application/json

    {
      "tenant": "Ihre Mandanten-ID",
      "summary": "Ein Satz: was funktioniert nicht",
      "description": "Was versucht wurde, was beobachtet wurde, seit wann",
      "logs": "Fehlerausgabe, Stacktrace, relevante Systemantworten",
      "severity": "blocker | degraded | question",
      "user": "Person, in deren Auftrag gemeldet wird",
      "agent": "Ihr Name",
      "process": "Auftragsabwicklung",
      "context": { "run_id": "…", "system": "ERP", "version": "…" },
      "contact_email": "Adresse für die Antwort",
      "reported_by": "agent",
      "idempotency_key": "eigener Schlüssel, z. B. Ihre Run-ID"
    }

### Pflicht und optional

- Pflicht: `summary` sowie `tenant` ODER `contact_email`. Fehlt beides, kommt `422`.
- Alles andere ist optional. Insbesondere `process` weglassen, wenn die Störung nicht an einem
  einzelnen Prozess hängt (z. B. die Plattform selbst antwortet nicht) - lieber kein Feld als ein
  geratener Wert.
- `severity`: `blocker` = Vorgang steht, `degraded` = läuft, aber fehlerhaft, `question` = Frage.
  Ohne Angabe gilt `question`.
- `logs` sind ausdrücklich erwünscht. Sie sind der Grund, warum Agenten besser melden als Menschen.

### Bestätigung und Einstufung

- Es ist kein Token und keine Authentifizierung nötig. Maßgeblich ist die Mandanten-ID.
- Ist Ihre `tenant`-ID bei uns hinterlegt, gilt das Ticket als bestätigt und wird bevorzugt
  bearbeitet. Ist sie es nicht, nehmen wir das Ticket trotzdem an, behandeln es aber als mögliches
  Spam. Melden Sie eine unbekannte Mandanten-ID Ihrem Administrator, nicht über dieses Formular.
- Meldungen über das Webformular gelten als von einem Menschen erstellt und werden nicht als Spam
  eingestuft.

### Antworten

- `201 {"ok": true, "id": "BV-XXXXXXXXXX", "status": "new"}` - nennen Sie Ihrem Nutzer diese ID.
- `200` mit `"deduplicated": true`, wenn derselbe `idempotency_key` erneut gesendet wurde.
- `422` Pflichtfeld fehlt · `429` Limit erreicht · `413` Body zu groß.

### Grenzen und Wiederholung

- Body maximal 2 MB. `logs` werden auf die letzten 200.000 Zeichen gekürzt statt abgelehnt; ist der
  gesamte Body zu groß, kommt `413` mit dem Hinweis, `logs` zu kürzen und erneut zu senden.
- Limit: 200 Tickets pro Stunde und IP für bestätigte Mandanten, sonst 20 (`429` darüber).
- Nach Netzwerkfehler denselben `idempotency_key` erneut senden - es entsteht kein zweites Ticket.
- Bei `429` oder `5xx` mit wachsendem Abstand erneut versuchen, nicht in einer engen Schleife.

### Stand abfragen

    GET https://support.bavaros.de/api/support/<id>
    → {"ok": true, "id": "…", "status": "new", "severity": "…", "received_at": "…"}

Liefert nur den Status, nie den Inhalt des Tickets zurück.

### Maschinenlesbare Feldliste

    GET https://support.bavaros.de/api/support/schema

Diese Datei ist die Anleitung, das Schema die verbindliche Feldliste. Weichen beide ab, gilt das
Schema.

## Datenschutz

Übermitteln Sie keine Passwörter, Schlüssel oder Zugangsdaten. `logs` können personenbezogene Daten
enthalten, wenn sie Inhalte aus Vorgängen wiedergeben; übermitteln Sie nur, was zur Klärung nötig
ist. Logs werden nach 30 Tagen automatisch gelöscht, Tickets nach 365 Tagen. Einzelheiten:
https://bavaros.de/datenschutz