{
  "openapi": "3.1.0",
  "info": {
    "title": "fwMAX.de Schnittstelle",
    "version": "1.0",
    "description": "Die Schnittstelle von **fwMAX.de – Das Feuerwehr Maximum** für andere Systeme: Webseite der Feuerwehr, Alarmierung, Leitstelle, Lohn.\n\n**Anmeldung.** Jeder Aufruf trägt einen Schlüssel in der Kopfzeile `Authorization: Bearer fwmax_...`. Schlüssel legt die Feuerwehr in fwMAX.de unter Verwaltung, Schnittstelle an; der Schlüssel bestimmt, welche Feuerwehr gemeint ist und was er darf.\n\n**Ausprobieren.** Mit dem Schlüssel `demo` antwortet die Live-Demo mit erfundenen Daten. Sie ist nur zum Lesen; schreibende Aufrufe werden mit 403 abgelehnt.\n\n**Rechte.** Ein Recht ist Bereich plus Tätigkeit, zum Beispiel „Personal ansehen“. Ein Schlüssel kann auf eine Einheit und alles darunter beschränkt sein; dann liefert er nur deren Personen.\n\n**Fehler** haben immer die Form `{\"fehler\": \"Text\"}` mit einem deutschen Satz.\n\n**Grenze.** Höchstens 120 Aufrufe je Minute und Schlüssel, danach 429.\n\n**Datum** steht als `JJJJ-MM-TT`, Zeitpunkte nach ISO 8601. Feldnamen sind deutsch und wie im Rest von fwMAX.de.",
    "contact": {
      "name": "fwMAX.de Support",
      "email": "support@fwmax.de",
      "url": "https://fwmax.de/schnittstelle"
    }
  },
  "servers": [
    {
      "url": "https://api.fwmax.de",
      "description": "fwMAX.de Schnittstelle"
    }
  ],
  "tags": [
    {
      "name": "Allgemein",
      "description": "Wer bin ich, was darf ich, und die Beschreibung der Schnittstelle selbst."
    },
    {
      "name": "Personen",
      "description": "Personalliste und Personalakten: Stammdaten, Mitgliedschaften, Nachweise, Kontaktpersonen."
    },
    {
      "name": "Fristen",
      "description": "Was läuft ab: Untersuchungen, Unterweisungen, Lehrgänge mit Gültigkeit."
    },
    {
      "name": "Statistik",
      "description": "Zahlen ohne Namen, z. B. für die Homepage: Einsätze eines Jahres nach Art und Monat."
    },
    {
      "name": "Organisation",
      "description": "Der Aufbau der Feuerwehr: Einheiten vom Landkreis bis zur Gruppe."
    },
    {
      "name": "Kataloge",
      "description": "Die Auswahllisten, auf die sich andere Angaben mit ihrer Nummer beziehen."
    },
    {
      "name": "Fahrzeuge",
      "description": "Fahrzeuge mit ihren Plätzen und ob sie einsatzbereit sind; Stichworte mit ihrer Ausrückefolge."
    },
    {
      "name": "Material",
      "description": "Geräte mit ihren Prüfungen und Mängeln; was zur Prüfung fällig ist; einen Mangel melden."
    },
    {
      "name": "Atemschutz",
      "description": "Das Atemschutz-Logbuch und wer atemschutztauglich ist."
    },
    {
      "name": "Objekte",
      "description": "Objekte, die die Feuerwehr kennen muss, und Wasserentnahmestellen mit dem Stand ihrer Prüfung."
    },
    {
      "name": "Kleiderkammer",
      "description": "Bestand der Kleiderkammer und die Kleidung einer Person gegen ihre Soll-Ausstattung."
    },
    {
      "name": "Etiketten",
      "description": "Etiketten mit QR-Code für alle Bereiche als ZPL, die Etikettendrucker der Feuerwehr und der Druck über zplCloud.com."
    },
    {
      "name": "Adressbuch",
      "description": "Kontakte außerhalb der Mannschaft: Behörden, Versorger, Nachbarwehren, Lieferanten."
    },
    {
      "name": "Alarmierung",
      "description": "Alarme auslösen, beenden und lesen: für Leitstelle und Alarmgeber. Ein Alarm geht als Push-Nachricht an die App."
    },
    {
      "name": "Einsätze",
      "description": "Einsätze lesen, auch in einer Fassung für die Homepage, und Einsätze von Leitstelle oder Alarmserver aufnehmen."
    },
    {
      "name": "Dienste",
      "description": "Übungen, sonstige Dienste, Veranstaltungen und Sitzungen mit Rückmeldungen und Anwesenheit."
    },
    {
      "name": "Lehrgänge",
      "description": "Lehrgangstermine mit Teilnehmern und alle Nachweise der Personen."
    },
    {
      "name": "Ehrungen",
      "description": "Verliehene Ehrungen, Vorschläge und was nach den Regeln fällig ist."
    },
    {
      "name": "App",
      "description": "Was die App von fwMAX.de benutzt: Anmeldung mit Code, Gerät, eigene Alarme und Rückmeldungen, eigene Termine mit Zu- und Absage, Check-in an der Wache, eigene Anwesenheit."
    }
  ],
  "security": [
    {
      "Schluessel": []
    }
  ],
  "paths": {
    "/v1": {
      "get": {
        "tags": [
          "Allgemein"
        ],
        "summary": "Wer bin ich",
        "description": "Feuerwehr, Fassung der Schnittstelle, Name des Schlüssels und seine Rechte. Gut als erster Aufruf, um einen Schlüssel zu prüfen.\n\n**Nötiges Recht:** keines.",
        "operationId": "get",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Auskunft"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/openapi.json": {
      "get": {
        "tags": [
          "Allgemein"
        ],
        "summary": "Beschreibung der Schnittstelle",
        "description": "Diese Beschreibung in maschinenlesbarer Form (OpenAPI 3.1). Ohne Schlüssel abrufbar.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_openapi_json",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/v1/personen": {
      "get": {
        "tags": [
          "Personen"
        ],
        "summary": "Personalliste",
        "description": "Alle Personen mit laufender Mitgliedschaft, mit Dienstgrad, Funktionen, Mitgliedschaften und Stand der Nachweise. Ein Schlüssel, der auf eine Einheit beschränkt ist, bekommt nur deren Personen.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_personen",
        "parameters": [
          {
            "name": "suche",
            "in": "query",
            "required": false,
            "description": "Begriffe, die in Name oder Personalnummer vorkommen müssen.",
            "schema": {
              "type": "string"
            },
            "example": "Braun"
          },
          {
            "name": "einheit",
            "in": "query",
            "required": false,
            "description": "Nur Personen mit laufender Mitgliedschaft in dieser Einheit.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ehemalige",
            "in": "query",
            "required": false,
            "description": "Auch Personen ohne laufende Mitgliedschaft.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "jugend",
            "in": "query",
            "required": false,
            "description": "Nur Mitglieder der Jugend- und Kinderfeuerwehr.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Personenzeile"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Personen"
        ],
        "summary": "Person anlegen",
        "description": "Legt eine Person an. Ohne Personalnummer wird die nächste freie vergeben.\n\n**Nötiges Recht:** Personal bearbeiten.",
        "operationId": "post_personen",
        "parameters": [],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonAngelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/personen/{id}": {
      "get": {
        "tags": [
          "Personen"
        ],
        "summary": "Personalakte",
        "description": "Die vollständige Personalakte: Stammdaten, Mitgliedschaften, Dienstgrade, Funktionen, Nachweise, Kontaktpersonen, Dokumente und Hinweise. Gesundheitsangaben und Dokumente nur mit dem jeweiligen Recht.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_personen_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Personalakte"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "put": {
        "tags": [
          "Personen"
        ],
        "summary": "Stammdaten ändern",
        "description": "Ändert die Stammdaten einer Person. Felder, die fehlen, bleiben wie sie sind.\n\n**Nötiges Recht:** Personal bearbeiten.",
        "operationId": "put_personen_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonAngelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/personen/{id}/mitgliedschaften": {
      "post": {
        "tags": [
          "Personen"
        ],
        "summary": "Mitgliedschaft eintragen",
        "description": "Trägt eine Mitgliedschaft der Person in einer Einheit ein. Dieselbe Art in derselben Einheit darf sich zeitlich nicht überschneiden.\n\n**Nötiges Recht:** Personal bearbeiten, auch in der Einheit.",
        "operationId": "post_personen_id_mitgliedschaften",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Angelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MitgliedschaftEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/personen/{id}/nachweise": {
      "post": {
        "tags": [
          "Personen"
        ],
        "summary": "Nachweis eintragen",
        "description": "Trägt einen Nachweis ein: Lehrgang, Untersuchung, Unterweisung, Führerschein, Abzeichen oder Ehrung. Ohne „gueltigBis“ wird das Ende aus der Gültigkeit der Nachweisart berechnet.\n\n**Nötiges Recht:** Personal bearbeiten.",
        "operationId": "post_personen_id_nachweise",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NachweisAngelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NachweisEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/personen/{id}/kontaktpersonen": {
      "post": {
        "tags": [
          "Personen"
        ],
        "summary": "Kontaktperson eintragen",
        "description": "Trägt eine Kontaktperson ein: Notfallkontakt oder, bei Minderjährigen, Erziehungsberechtigte.\n\n**Nötiges Recht:** Personal bearbeiten.",
        "operationId": "post_personen_id_kontaktpersonen",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Angelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KontaktpersonEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/fristen": {
      "get": {
        "tags": [
          "Fristen"
        ],
        "summary": "Ablaufende Nachweise",
        "description": "Nachweise, die abgelaufen sind oder in den nächsten Tagen ablaufen, nach Ablaufdatum sortiert. Es zählt je Person und Art nur der neueste Nachweis.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_fristen",
        "parameters": [
          {
            "name": "tage",
            "in": "query",
            "required": false,
            "description": "Wie viele Tage voraus; ohne Angabe 90.",
            "schema": {
              "type": "integer"
            },
            "example": 90
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Frist"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/statistik/einsaetze": {
      "get": {
        "tags": [
          "Statistik"
        ],
        "summary": "Einsatzstatistik eines Jahres",
        "description": "Zahl der Einsätze, Einsatzstunden und Stunden der Mannschaft eines Jahres, aufgeteilt nach Einsatzart und nach Monat, mit den Zahlen des Vorjahres. Ohne Namen, Adressen und Berichte; gut für die Homepage. Ohne „jahr“ das laufende Jahr.\n\n**Nötiges Recht:** Einsätze ansehen.",
        "operationId": "get_statistik_einsaetze",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Einsatzstatistik"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/organisationseinheiten": {
      "get": {
        "tags": [
          "Organisation"
        ],
        "summary": "Alle Einheiten",
        "description": "Alle Einheiten als flache Liste in der Reihenfolge des Baums; „ebene“ sagt, wie tief eine Einheit hängt.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_organisationseinheiten",
        "parameters": [
          {
            "name": "aufgeloeste",
            "in": "query",
            "required": false,
            "description": "Auch aufgelöste Einheiten liefern.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Organisationseinheit"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Organisation"
        ],
        "summary": "Einheit anlegen",
        "description": "Legt eine Einheit an.\n\n**Nötiges Recht:** Organisation bearbeiten.",
        "operationId": "post_organisationseinheiten",
        "parameters": [],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Angelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrganisationseinheitEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/organisationseinheiten/{id}": {
      "get": {
        "tags": [
          "Organisation"
        ],
        "summary": "Eine Einheit",
        "description": "Eine Einheit mit ihrer Art und der Einheit darüber.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_organisationseinheiten_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Organisationseinheit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "put": {
        "tags": [
          "Organisation"
        ],
        "summary": "Einheit ändern",
        "description": "Ändert eine Einheit. Felder, die fehlen, bleiben wie sie sind. Mit „gueltigBis“ wird sie aufgelöst.\n\n**Nötiges Recht:** Organisation bearbeiten.",
        "operationId": "put_organisationseinheiten_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Angelegt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrganisationseinheitEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/kataloge/dienstgrade": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Dienstgrade",
        "description": "Katalog der Dienstgrade in ihrer Rangfolge.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_dienstgrade",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Dienstgrad"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kataloge/funktionen": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Funktionen",
        "description": "Katalog der Funktionen.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_funktionen",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Funktion"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kataloge/nachweisarten": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Nachweisarten",
        "description": "Katalog der Nachweisarten mit Kategorie und Gültigkeit.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_nachweisarten",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Nachweisart"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kataloge/mitgliedschaftsarten": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Mitgliedschaftsarten",
        "description": "Katalog der Mitgliedschaftsarten.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_mitgliedschaftsarten",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Mitgliedschaftsart"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kataloge/organisationsarten": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Arten von Einheiten",
        "description": "Katalog der Arten von Einheiten.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_organisationsarten",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Organisationsart"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/fahrzeuge": {
      "get": {
        "tags": [
          "Fahrzeuge"
        ],
        "summary": "Alle Fahrzeuge",
        "description": "Die Fahrzeuge mit Funkrufname, Kennzeichen, Plätzen, Stand der Hauptuntersuchung und ob sie einsatzbereit sind, in der Reihenfolge der Einheiten.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_fahrzeuge",
        "parameters": [
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ausgemusterte",
            "in": "query",
            "required": false,
            "description": "Auch ausgemusterte Fahrzeuge.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Fahrzeug"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/fahrzeuge/{id}": {
      "get": {
        "tags": [
          "Fahrzeuge"
        ],
        "summary": "Ein Fahrzeug",
        "description": "Ein Fahrzeug mit seinen Plätzen.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_fahrzeuge_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fahrzeug"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/etiketten/drucker": {
      "get": {
        "tags": [
          "Etiketten"
        ],
        "summary": "Etikettendrucker",
        "description": "Die Etikettendrucker der Feuerwehr mit Auflösung und Verbindung; bei Netzwerkdruckern IP-Adresse und Port für den Druck aus der App.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_etiketten_drucker",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Etikettendrucker"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/etiketten/formate": {
      "get": {
        "tags": [
          "Etiketten"
        ],
        "summary": "Etikettenformate",
        "description": "Alle Formate: A4-Bögen und Rollen für Etikettendrucker, mit Größe in Millimetern.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_etiketten_formate",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Etikettenformatzeile"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/etiketten/zpl": {
      "get": {
        "tags": [
          "Etiketten"
        ],
        "summary": "Etiketten als ZPL",
        "description": "Etiketten eines Bereichs als ZPL für Zebra-Drucker (Text), in der Auflösung des gewählten Druckers, UTF-8 (^CI28). Ohne „ids“ alle Stücke des Bereichs.\n\n**Nötiges Recht:** Drucken im Bereich.",
        "operationId": "get_etiketten_zpl",
        "parameters": [
          {
            "name": "bereich",
            "in": "query",
            "required": false,
            "description": "Bereich der Etiketten: Kleiderkammer, Material, Atemschutz oder Fahrzeug.",
            "schema": {
              "type": "string"
            },
            "example": "Material"
          },
          {
            "name": "ids",
            "in": "query",
            "required": false,
            "description": "Nummern der Stücke, mit Komma getrennt; ohne Angabe alle.",
            "schema": {
              "type": "string"
            },
            "example": "42,43"
          },
          {
            "name": "etikettenformat",
            "in": "query",
            "required": false,
            "description": "Schlüssel des Etikettenformats; ohne Angabe das Standardformat des Druckers.",
            "schema": {
              "type": "string"
            },
            "example": "rolle-57x32"
          },
          {
            "name": "drucker",
            "in": "query",
            "required": false,
            "description": "Nummer des Etikettendruckers: ZPL in seiner Auflösung.",
            "schema": {
              "type": "integer"
            },
            "example": 3
          },
          {
            "name": "fahrzeug",
            "in": "query",
            "required": false,
            "description": "Nur die Beladung dieses Fahrzeugs.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/etiketten/drucken": {
      "post": {
        "tags": [
          "Etiketten"
        ],
        "summary": "Etiketten drucken",
        "description": "Sendet Etiketten über zplCloud.com an einen Zebra-Drucker der Feuerwehr.\n\n**Nötiges Recht:** Drucken im Bereich.",
        "operationId": "post_etiketten_drucken",
        "parameters": [],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Etikettengesendet"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Druckeingabe"
              }
            }
          }
        }
      }
    },
    "/v1/atemschutz/eintraege": {
      "get": {
        "tags": [
          "Atemschutz"
        ],
        "summary": "Atemschutz-Logbuch eines Jahres",
        "description": "Die Einträge des Atemschutz-Logbuchs, neueste zuerst: wer wann wie lange unter Atemschutz war, mit Gerät, Maske, Druck und dem Dienst oder Einsatz dazu. „bestaetigtAm“ ist leer, solange die zweite Person nicht bestätigt hat.\n\n**Nötiges Recht:** Atemschutz ansehen.",
        "operationId": "get_atemschutz_eintraege",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          },
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "person",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Person.",
            "schema": {
              "type": "integer"
            },
            "example": 155
          },
          {
            "name": "offene",
            "in": "query",
            "required": false,
            "description": "Nur Einträge, die noch nicht bestätigt sind.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Atemschutzeintrag"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/atemschutz/traeger": {
      "get": {
        "tags": [
          "Atemschutz"
        ],
        "summary": "Atemschutzgeräteträger mit Tauglichkeit",
        "description": "Alle Atemschutzgeräteträger mit ihrem Stand (Gruen, Gelb, Rot), bis wann sie tauglich sind, jeder einzelnen Anforderung und den Zahlen aus dem Logbuch. Tauglich heißt: alle Nachweise für Atemschutz gültig und ein Einsatz oder eine Übung unter Atemschutz in den letzten zwölf Monaten.\n\n**Nötiges Recht:** Atemschutz ansehen.",
        "operationId": "get_atemschutz_traeger",
        "parameters": [
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Atemschutztraeger"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kleiderkammer/bestand": {
      "get": {
        "tags": [
          "Kleiderkammer"
        ],
        "summary": "Bestand der Kleiderkammer",
        "description": "Die einzeln geführten Kleidungsstücke mit Größe, Stand, Lagerort oder Träger, Prüftermin und Ablegereife, dazu der gezählte Bestand (z. B. T-Shirts) je Größe und Lagerort. Ausgesonderte Stücke fehlen.\n\n**Nötiges Recht:** Kleiderkammer ansehen.",
        "operationId": "get_kleiderkammer_bestand",
        "parameters": [
          {
            "name": "kleidungskategorie",
            "in": "query",
            "required": false,
            "description": "Nur Kleidung dieser Art (Nummer der Art).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "lagerort",
            "in": "query",
            "required": false,
            "description": "Nur Kleidung in diesem Lagerort (Nummer des Lagerorts).",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Kleiderkammerbestand"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/personen/{id}/kleidung": {
      "get": {
        "tags": [
          "Kleiderkammer"
        ],
        "summary": "Kleidung einer Person",
        "description": "Was eine Person nach der Soll-Ausstattung haben sollte, was sie hat und wie jede Art steht (Fehlt, Ablegereif, PruefungFaellig, FalscheGroesse, Vorhanden, Zusaetzlich), mit ihren Größen.\n\n**Nötiges Recht:** Kleiderkammer ansehen.",
        "operationId": "get_personen_id_kleidung",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Kleidungsausstattung"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/adressbuch": {
      "get": {
        "tags": [
          "Adressbuch"
        ],
        "summary": "Alle Kontakte",
        "description": "Die Kontakte des Adressbuchs (Behörden, Versorger, Nachbarwehren, Lieferanten …) mit allen Telefonnummern, Favoriten zuerst. Ein Schlüssel, der auf eine Einheit beschränkt ist, bekommt nur die Kontakte dieser Einheit.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_adressbuch",
        "parameters": [
          {
            "name": "suche",
            "in": "query",
            "required": false,
            "description": "Begriffe, die in Name oder Personalnummer vorkommen müssen.",
            "schema": {
              "type": "string"
            },
            "example": "Braun"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Adressbucheintrag"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/fahrzeuge/{id}/fahrten": {
      "get": {
        "tags": [
          "Fahrzeuge"
        ],
        "summary": "Fahrtenbuch eines Fahrzeugs",
        "description": "Die Fahrten eines Fahrzeugs, neueste zuerst, mit Kilometerständen und gefahrenen Kilometern. „luecke“ sagt, wie viele Kilometer vor einer Fahrt im Buch fehlen.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_fahrzeuge_id_fahrten",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "von",
            "in": "query",
            "required": false,
            "description": "Ab diesem Zeitpunkt (ISO 8601); ohne Angabe ab jetzt.",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-16T00:00:00Z"
          },
          {
            "name": "bis",
            "in": "query",
            "required": false,
            "description": "Bis zu diesem Zeitpunkt (ISO 8601); ohne Angabe 120 Tage nach „von“.",
            "schema": {
              "type": "string"
            },
            "example": "2027-01-31T00:00:00Z"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Fahrt"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Fahrzeuge"
        ],
        "summary": "Fahrt eintragen",
        "description": "Trägt eine Fahrt ins Fahrtenbuch ein. Ohne „kilometerstandBeginn“ beginnt sie beim Ende der letzten Fahrt. Ein Stand unter dem Ende der Fahrt davor wird mit beiden Zahlen abgelehnt.\n\n**Nötiges Recht:** Fahrzeuge bearbeiten.",
        "operationId": "post_fahrzeuge_id_fahrten",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fahrt"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FahrtEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/objekte": {
      "get": {
        "tags": [
          "Objekte"
        ],
        "summary": "Alle Objekte",
        "description": "Die Objekte der Feuerwehr mit Anschrift, Koordinaten, Gefahren, Brandmeldeanlage und Kontakten. Mit „format=geojson“ als GeoJSON (nur Objekte mit Koordinaten).\n\n**Nötiges Recht:** keines.",
        "operationId": "get_objekte",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Mit „geojson“ kommt die Antwort als GeoJSON (FeatureCollection).",
            "schema": {
              "type": "string"
            },
            "example": "geojson"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Objekt"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/objekte/{id}": {
      "get": {
        "tags": [
          "Objekte"
        ],
        "summary": "Ein Objekt",
        "description": "Ein Objekt mit seinen Kontakten.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_objekte_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Objekt"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/wasserentnahmestellen": {
      "get": {
        "tags": [
          "Objekte"
        ],
        "summary": "Wasserentnahmestellen",
        "description": "Hydranten, offene Gewässer, Zisternen und Brunnen mit Koordinaten, Zustand und Stand der Prüfung. Mit „format=geojson“ als GeoJSON.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_wasserentnahmestellen",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Mit „geojson“ kommt die Antwort als GeoJSON (FeatureCollection).",
            "schema": {
              "type": "string"
            },
            "example": "geojson"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Wasserentnahmestelle"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/material": {
      "get": {
        "tags": [
          "Material"
        ],
        "summary": "Bestand",
        "description": "Die Geräte mit Kategorie, Inventarnummer, Ort, Einsatzstand, nächster Prüfung und der Zahl offener Mängel.\n\n**Nötiges Recht:** Material ansehen.",
        "operationId": "get_material",
        "parameters": [
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "materialkategorie",
            "in": "query",
            "required": false,
            "description": "Nur Geräte dieser Kategorie (Nummer der Kategorie).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "aufFahrzeug",
            "in": "query",
            "required": false,
            "description": "Nur Geräte, die auf diesem Fahrzeug verlastet sind (Nummer des Fahrzeugs).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "ausgesonderte",
            "in": "query",
            "required": false,
            "description": "Auch ausgesonderte Geräte.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Material"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/material/pruefungen/faellig": {
      "get": {
        "tags": [
          "Material"
        ],
        "summary": "Fällige Prüfungen",
        "description": "Die Prüfungen, die in den nächsten Tagen fällig werden, und alle überfälligen, die früheste zuerst.\n\n**Nötiges Recht:** Material ansehen.",
        "operationId": "get_material_pruefungen_faellig",
        "parameters": [
          {
            "name": "innerhalbTagen",
            "in": "query",
            "required": false,
            "description": "Wie viele Tage voraus (0 bis 730); ohne Angabe 30. Überfällige Prüfungen sind immer dabei.",
            "schema": {
              "type": "integer"
            },
            "example": 30
          },
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Prueffaelligkeit"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/material/{id}": {
      "get": {
        "tags": [
          "Material"
        ],
        "summary": "Ein Gerät",
        "description": "Ein Gerät mit seinen Prüfplänen, den letzten 50 Prüfungen und seinen Mängeln.\n\n**Nötiges Recht:** Material ansehen.",
        "operationId": "get_material_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Materialakte"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/material/{id}/maengel": {
      "post": {
        "tags": [
          "Material"
        ],
        "summary": "Mangel melden",
        "description": "Meldet einen Mangel an einem Gerät. Ein kritischer Mangel nimmt das Gerät sofort außer Betrieb. Dafür ist kein Recht nötig.\n\n**Nötiges Recht:** keines.",
        "operationId": "post_material_id_maengel",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Materialmangel"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MangelEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/stichworte": {
      "get": {
        "tags": [
          "Fahrzeuge"
        ],
        "summary": "Stichworte mit Ausrückefolge",
        "description": "Die Alarmstichworte mit den Fahrzeugen, die dafür am Tag und in der Nacht ausrücken.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_stichworte",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Stichwort"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/kataloge/einsatzarten": {
      "get": {
        "tags": [
          "Kataloge"
        ],
        "summary": "Einsatzarten",
        "description": "Katalog der Einsatzarten mit ihrer Farbe.\n\n**Nötiges Recht:** keines.",
        "operationId": "get_kataloge_einsatzarten",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Einsatzart"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/alarme": {
      "post": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Alarm auslösen",
        "description": "Löst einen Alarm aus und schickt ihn als Push-Nachricht an die Geräte aller Betroffenen: Mitglieder der genannten Einheiten samt allem darunter, ohne Einheiten alle im Einsatzdienst. Dieselbe „fremdkennung“ innerhalb von zehn Minuten löst keinen zweiten Alarm aus, sondern liefert den ersten zurück.\n\n**Nötiges Recht:** Alarmierung bearbeiten.",
        "operationId": "post_alarme",
        "parameters": [],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alarm"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlarmEingabe"
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Alle Alarme",
        "description": "Die letzten 100 Alarme, neueste zuerst, mit den Zählern der Rückmeldungen.\n\n**Nötiges Recht:** Alarmierung ansehen.",
        "operationId": "get_alarme",
        "parameters": [
          {
            "name": "seit",
            "in": "query",
            "required": false,
            "description": "Nur Alarme nach diesem Zeitpunkt (ISO 8601).",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-16T00:00:00Z"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Alarm"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/alarme/{id}/beenden": {
      "post": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Alarm beenden",
        "description": "Beendet einen Alarm. Die Geräte zeigen ihn danach nicht mehr als laufend, Rückmeldungen sind nicht mehr möglich.\n\n**Nötiges Recht:** Alarmierung bearbeiten.",
        "operationId": "post_alarme_id_beenden",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alarm"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/alarme/{id}": {
      "get": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Ein Alarm",
        "description": "Ein Alarm mit allen Rückmeldungen.\n\n**Nötiges Recht:** Alarmierung ansehen.",
        "operationId": "get_alarme_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alarm"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/einsaetze": {
      "get": {
        "tags": [
          "Einsätze"
        ],
        "summary": "Einsätze eines Jahres",
        "description": "Die Einsätze eines Jahres, neueste zuerst, mit Fahrzeugen, Kräften und Lagemeldungen. Ein Schlüssel, der auf eine Einheit beschränkt ist, bekommt nur deren Einsätze. Mit „oeffentlich=true“ in der Fassung für die Homepage: ohne Namen, ohne Notizen und Verursacher, der Bericht nur bei abgeschlossenen Einsätzen und auf 400 Zeichen gekürzt.\n\n**Nötiges Recht:** Einsätze ansehen.",
        "operationId": "get_einsaetze",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          },
          {
            "name": "oeffentlich",
            "in": "query",
            "required": false,
            "description": "Fassung für die Homepage: ohne Namen, der Bericht nur abgeschlossen und gekürzt.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Einsatz"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Einsätze"
        ],
        "summary": "Einsatz melden",
        "description": "Nimmt einen Einsatz von Leitstelle oder Alarmserver auf und vergibt die nächste Einsatznummer. Das Stichwort wird dem Katalog zugeordnet, Fahrzeuge über ihren Funkrufnamen; fremde Fahrzeuge werden übergangen. Dieselbe Leitstellennummer im selben Jahr ist derselbe Einsatz: dann wird nichts angelegt und der vorhandene kommt mit Status 200 zurück.\n\n**Nötiges Recht:** Einsätze bearbeiten.",
        "operationId": "post_einsaetze",
        "parameters": [],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Einsatz"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EinsatzEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/einsaetze/{id}": {
      "get": {
        "tags": [
          "Einsätze"
        ],
        "summary": "Ein Einsatz",
        "description": "Ein Einsatz mit allem, was dazugehört; mit „oeffentlich=true“ in der Fassung für die Homepage.\n\n**Nötiges Recht:** Einsätze ansehen.",
        "operationId": "get_einsaetze_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "oeffentlich",
            "in": "query",
            "required": false,
            "description": "Fassung für die Homepage: ohne Namen, der Bericht nur abgeschlossen und gekürzt.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Einsatz"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/einsaetze/fe2": {
      "post": {
        "tags": [
          "Einsätze"
        ],
        "summary": "Alarm von Alamos FE2 aufnehmen",
        "description": "Nimmt einen Alarm so auf, wie Alamos FE2 ihn mit seinem HTTP-Ausgang als JSON sendet (Felder oben, unter „data“ oder unter „parameters“): Stichwort aus „keyword“ und „keyword_description“, Adresse aus „street“, „house“, „postalCode“, „city“, „city_abbr“, „building“, Koordinaten aus „lat“/„lng“, Meldetext aus „message“, Fahrzeuge aus „vehicles“, Alarmzeit aus „timestamp“. Die externe Einsatznummer („einsatznummer“, „externalId“, „operationNumber“, „alarmnummer“, „dbId“ oder „id“) wird zur Leitstellennummer; dieselbe Nummer im selben Jahr legt keinen zweiten Einsatz an und kommt mit Status 200 und „neu: false“ zurück. Fehlt sie, bildet fwMAX.de eine Nummer aus Stichwort, Minute und Adresse. Ein neuer Einsatz löst das Ereignis „einsatz.angelegt“ aus.\n\n**Nötiges Recht:** Einsätze bearbeiten.",
        "operationId": "post_einsaetze_fe2",
        "parameters": [
          {
            "name": "einsatzeinheit",
            "in": "query",
            "required": false,
            "description": "Nummer der Einheit, der der Einsatz gehört; ohne Angabe die erste Einheit, für die der Schlüssel Einsätze schreiben darf.",
            "schema": {
              "type": "integer"
            },
            "example": 12
          }
        ],
        "responses": {
          "201": {
            "description": "Angelegt.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Fe2Ergebnis"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Fe2Alarm"
              }
            }
          }
        }
      }
    },
    "/v1/dienste": {
      "get": {
        "tags": [
          "Dienste"
        ],
        "summary": "Dienste und Termine",
        "description": "Übungen, sonstige Dienste, Veranstaltungen und Sitzungen eines Zeitraums, früheste zuerst, mit den Zählern der Rückmeldungen und der Anwesenheit. Ohne Angabe von heute an 120 Tage, höchstens drei Jahre. Ein Schlüssel, der auf eine Einheit beschränkt ist, bekommt nur deren Dienste. Seitenweise.\n\n**Nötiges Recht:** Dienste ansehen.",
        "operationId": "get_dienste",
        "parameters": [
          {
            "name": "von",
            "in": "query",
            "required": false,
            "description": "Ab diesem Zeitpunkt (ISO 8601); ohne Angabe ab jetzt.",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-16T00:00:00Z"
          },
          {
            "name": "bis",
            "in": "query",
            "required": false,
            "description": "Bis zu diesem Zeitpunkt (ISO 8601); ohne Angabe 120 Tage nach „von“.",
            "schema": {
              "type": "string"
            },
            "example": "2027-01-31T00:00:00Z"
          },
          {
            "name": "art",
            "in": "query",
            "required": false,
            "description": "Nur diese Arten von Dienst, durch Komma getrennt: Uebung, SonstigerDienst, Veranstaltung, Sitzung; ohne Angabe alle.",
            "schema": {
              "type": "string"
            },
            "example": "Uebung,Sitzung"
          },
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "abgesagte",
            "in": "query",
            "required": false,
            "description": "Abgesagte Dienste mitliefern; ohne Angabe ja.",
            "schema": {
              "type": "boolean"
            },
            "example": true
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Dienst"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/dienste/{id}": {
      "get": {
        "tags": [
          "Dienste"
        ],
        "summary": "Ein Dienst",
        "description": "Ein Dienst mit Zielgruppe, Bericht und Zählern; mit „Personal ansehen“ auch die Teilnehmer mit Antwort, Anwesenheit und Platz auf dem Fahrzeug.\n\n**Nötiges Recht:** Dienste ansehen.",
        "operationId": "get_dienste_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dienstakte"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/lehrgaenge": {
      "get": {
        "tags": [
          "Lehrgänge"
        ],
        "summary": "Lehrgangstermine",
        "description": "Die Lehrgangstermine mit Plätzen, Belegung und Warteliste, kommende zuerst. Ohne „vergangene“ nur Termine, die noch nicht vorbei sind. Seitenweise.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_lehrgaenge",
        "parameters": [
          {
            "name": "vergangene",
            "in": "query",
            "required": false,
            "description": "Auch Termine, die vorbei sind.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "nachweisart",
            "in": "query",
            "required": false,
            "description": "Nur diese Nachweisart (Nummer aus /kataloge/nachweisarten).",
            "schema": {
              "type": "integer"
            },
            "example": 10
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Lehrgang"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/lehrgaenge/{id}": {
      "get": {
        "tags": [
          "Lehrgänge"
        ],
        "summary": "Ein Lehrgangstermin",
        "description": "Ein Lehrgangstermin mit seinen Teilnehmern, ihrem Stand, dem Ergebnis und den fehlenden Voraussetzungen.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_lehrgaenge_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Lehrgangsakte"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/nachweise": {
      "get": {
        "tags": [
          "Lehrgänge"
        ],
        "summary": "Nachweise",
        "description": "Alle Nachweise der Personen (Lehrgänge, Untersuchungen, Unterweisungen, Führerscheine, Abzeichen, Ehrungen), neueste zuerst. Ein Schlüssel, der auf eine Einheit beschränkt ist, bekommt nur die Nachweise ihrer Personen. Seitenweise.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_nachweise",
        "parameters": [
          {
            "name": "kategorie",
            "in": "query",
            "required": false,
            "description": "Nur diese Kategorie: Lehrgang, Untersuchung, Unterweisung, Fuehrerschein, Abzeichen oder Ehrung.",
            "schema": {
              "type": "string"
            },
            "example": "Lehrgang"
          },
          {
            "name": "nachweisart",
            "in": "query",
            "required": false,
            "description": "Nur diese Nachweisart (Nummer aus /kataloge/nachweisarten).",
            "schema": {
              "type": "integer"
            },
            "example": 10
          },
          {
            "name": "person",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Person.",
            "schema": {
              "type": "integer"
            },
            "example": 155
          },
          {
            "name": "einheit",
            "in": "query",
            "required": false,
            "description": "Nur Personen mit laufender Mitgliedschaft in dieser Einheit.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "nurGeltende",
            "in": "query",
            "required": false,
            "description": "Je Person und Art nur der neueste Nachweis.",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Nachweiszeile"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/ehrungen": {
      "get": {
        "tags": [
          "Ehrungen"
        ],
        "summary": "Verliehene Ehrungen",
        "description": "Die eingetragenen Ehrungen der Personen, neueste zuerst; auch von ehemaligen Mitgliedern. Seitenweise.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_ehrungen",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Nachweiszeile"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/ehrungen/vorschlaege": {
      "get": {
        "tags": [
          "Ehrungen"
        ],
        "summary": "Ehrungsvorschläge",
        "description": "Die Vorschläge für Ehrungen und Beförderungen mit ihrem Stand, offene zuerst. Seitenweise.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_ehrungen_vorschlaege",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Nur Vorschläge in diesem Stand.",
            "schema": {
              "type": "string"
            },
            "example": "Vorgeschlagen"
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Ehrungsvorschlag"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/ehrungen/faellig": {
      "get": {
        "tags": [
          "Ehrungen"
        ],
        "summary": "Fällige Ehrungen",
        "description": "Ehrungen und Beförderungen, die nach den Regeln der Feuerwehr fällig sind oder in den nächsten Tagen fällig werden, früheste zuerst. Abgelehnte Vorschläge fehlen. Seitenweise.\n\n**Nötiges Recht:** Personal ansehen.",
        "operationId": "get_ehrungen_faellig",
        "parameters": [
          {
            "name": "tage",
            "in": "query",
            "required": false,
            "description": "Wie viele Tage voraus; ohne Angabe 90.",
            "schema": {
              "type": "integer"
            },
            "example": 90
          },
          {
            "name": "seite",
            "in": "query",
            "required": false,
            "description": "Die Seite, ab 1. Die Gesamtzahl steht in der Kopfzeile X-Gesamtzahl, die nächste Seite in Link.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "proSeite",
            "in": "query",
            "required": false,
            "description": "Einträge je Seite, 1 bis 500; ohne Angabe 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Ehrungsfaelligkeit"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/statistik/dienste": {
      "get": {
        "tags": [
          "Statistik"
        ],
        "summary": "Dienststatistik eines Jahres",
        "description": "Zahl der Dienste, Stunden und Anwesenheitsquote eines Jahres, nach Art und Monat. Mit „Personal ansehen“ auch die Quote jeder Person, die der Schlüssel sehen darf. Ohne „jahr“ das laufende Jahr.\n\n**Nötiges Recht:** Dienste ansehen.",
        "operationId": "get_statistik_dienste",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          },
          {
            "name": "art",
            "in": "query",
            "required": false,
            "description": "Nur diese Arten von Dienst, durch Komma getrennt: Uebung, SonstigerDienst, Veranstaltung, Sitzung; ohne Angabe alle.",
            "schema": {
              "type": "string"
            },
            "example": "Uebung,Sitzung"
          },
          {
            "name": "organisationseinheit",
            "in": "query",
            "required": false,
            "description": "Nur Einträge dieser Einheit und der Einheiten darunter.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dienststatistik"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/health-check": {
      "get": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Health-Check senden (ohne Inhalt)",
        "description": "Wie POST, für Systeme, die nur eine Adresse abrufen können. Der Schlüssel der Quelle steht in der Kopfzeile oder, wenn das nicht geht, als `apikey` in der Adresse; `meldung` ist ein kurzer Stand.\n\n**Nötiges Recht:** Token der Quelle.",
        "operationId": "get_health-check",
        "parameters": [
          {
            "name": "apikey",
            "in": "query",
            "required": false,
            "description": "Token der Quelle (beginnt mit fwh_), wenn das aufrufende System keine Kopfzeile setzen kann.",
            "schema": {
              "type": "string"
            },
            "example": "fwh_TOKEN"
          },
          {
            "name": "meldung",
            "in": "query",
            "required": false,
            "description": "Kurzer Stand der Quelle, höchstens 300 Zeichen.",
            "schema": {
              "type": "string"
            },
            "example": "FE2 läuft"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Herzschlag"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Health-Check senden",
        "description": "Eine überwachte Quelle (z. B. der Alarmserver an der Wache) meldet, dass sie läuft. Gilt mit dem Token der Quelle (beginnt mit `fwh_`), nicht mit einem API-Key der Schnittstelle; auch als GET aufrufbar. Bleibt der Health-Check länger aus als vereinbart, warnt fwMAX.de die Verantwortlichen.\n\n**Nötiges Recht:** Token der Quelle.",
        "operationId": "post_health-check",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Herzschlag"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HerzschlagEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/herzschlag": {
      "get": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Health-Check senden (alte Adresse) (ohne Inhalt)",
        "description": "Wie POST, für Systeme, die nur eine Adresse abrufen können. Der Schlüssel der Quelle steht in der Kopfzeile oder, wenn das nicht geht, als `apikey` in der Adresse; `meldung` ist ein kurzer Stand.\n\n**Nötiges Recht:** Token der Quelle.",
        "operationId": "get_herzschlag",
        "parameters": [
          {
            "name": "apikey",
            "in": "query",
            "required": false,
            "description": "Token der Quelle (beginnt mit fwh_), wenn das aufrufende System keine Kopfzeile setzen kann.",
            "schema": {
              "type": "string"
            },
            "example": "fwh_TOKEN"
          },
          {
            "name": "meldung",
            "in": "query",
            "required": false,
            "description": "Kurzer Stand der Quelle, höchstens 300 Zeichen.",
            "schema": {
              "type": "string"
            },
            "example": "FE2 läuft"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Herzschlag"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "Alarmierung"
        ],
        "summary": "Health-Check senden (alte Adresse)",
        "description": "Eine überwachte Quelle (z. B. der Alarmserver an der Wache) meldet, dass sie läuft. Gilt mit dem Token der Quelle (beginnt mit `fwh_`), nicht mit einem API-Key der Schnittstelle; auch als GET aufrufbar. Bleibt der Health-Check länger aus als vereinbart, warnt fwMAX.de die Verantwortlichen.\n\n**Nötiges Recht:** Token der Quelle.",
        "operationId": "post_herzschlag",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Herzschlag"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HerzschlagEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/anmeldung/code": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Anmeldecode senden",
        "description": "Schickt den Anmeldecode an die E-Mail-Adresse, wenn es in der genannten Feuerwehr ein aktives Konto dazu gibt. Die Antwort ist immer gleich. Ohne Schlüssel aufrufbar, höchstens 20 Aufrufe je Minute.\n\n**Nötiges Recht:** keines.",
        "operationId": "post_app_anmeldung_code",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CodeGesendet"
                }
              }
            }
          }
        },
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CodeEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/anmeldung": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Mit Code anmelden",
        "description": "Prüft den Code und meldet das Gerät an. Die Antwort enthält die Sitzung (beginnt mit `fwapp_`); sie wird danach wie ein Schlüssel als `Authorization: Bearer fwapp_...` gesendet, gilt bis zum Abmelden und hat die Rechte des Kontos. Hat das Konto die Zwei-Faktor-Anmeldung eingeschaltet, enthält die Antwort statt der Sitzung `zweiterFaktor: true` und eine `marke`; die App fragt dann nach dem Code aus der Authenticator-App und sendet ihn an `/app/anmeldung/zweiter-faktor`. Verlangt die Feuerwehr die Zwei-Faktor-Anmeldung und das Konto hat sie noch nicht eingerichtet, kommt 403: einrichten geht im Browser unter „Mein Konto“. Ohne Schlüssel aufrufbar.\n\n**Nötiges Recht:** keines.",
        "operationId": "post_app_anmeldung",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appanmeldung"
                }
              }
            }
          }
        },
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AnmeldungEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/anmeldung/zweiter-faktor": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Zweiten Faktor senden",
        "description": "Zweiter Schritt der Anmeldung für Konten mit Authenticator-App: die `marke` aus dem ersten Schritt (gilt 5 Minuten) und der sechsstellige Code aus der App oder ein Wiederherstellungscode. Die Antwort enthält die Sitzung wie bei der Anmeldung. Nach fünf falschen Codes in Folge nimmt das Konto 15 Minuten lang keinen Code an (429). Ohne Schlüssel aufrufbar.\n\n**Nötiges Recht:** keines.",
        "operationId": "post_app_anmeldung_zweiter-faktor",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appanmeldung"
                }
              }
            }
          }
        },
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ZweiterFaktorEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/abmelden": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Abmelden",
        "description": "Löscht die Sitzung und die Push-Adresse des Geräts.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_abmelden",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Abgemeldet"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/ich": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Wer bin ich in der App",
        "description": "Feuerwehr, Konto, verknüpfte Person, Rechte und Stand des Geräts.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_ich",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appauskunft"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/geraet": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "Push-Adresse des Geräts",
        "description": "Meldet, wohin Push-Nachrichten für dieses Gerät gehen. Eine leere Adresse schaltet Push für das Gerät ab.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "put_app_geraet",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Gespeichert"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GeraetEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/alarme": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Meine Alarme",
        "description": "Die Alarme, die die Person des Kontos betreffen, neueste zuerst, höchstens 100. Wer „Alarmierung ansehen“ hat, bekommt alle.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_alarme",
        "parameters": [
          {
            "name": "seit",
            "in": "query",
            "required": false,
            "description": "Nur Alarme nach diesem Zeitpunkt (ISO 8601).",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-16T00:00:00Z"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Alarm"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/alarme/{id}": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Ein Alarm",
        "description": "Ein Alarm mit der eigenen Rückmeldung und den Zählern. Die Liste aller Rückmeldungen nur mit „Alarmierung ansehen“.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_alarme_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alarm"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/alarme/{id}/rueckmeldung": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Rückmeldung geben",
        "description": "Die Antwort der Person auf den Alarm. Je Person und Alarm gibt es eine Rückmeldung; eine neue ersetzt die alte.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_alarme_id_rueckmeldung",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Alarm"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RueckmeldungEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/dienste": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Meine Termine",
        "description": "Die kommenden Dienste und Termine (Übungen, sonstige Dienste, Veranstaltungen, Sitzungen), die für die Person des Kontos gedacht sind: Mitglieder der Einheit des Termins, auf Wunsch samt allem darunter, eingegrenzt auf eine Funktion oder Mitgliedschaftsart. Ohne Angabe von jetzt an 120 Tage, höchstens 200. Ein Termin bleibt in der Liste, bis er vorbei ist.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_dienste",
        "parameters": [
          {
            "name": "von",
            "in": "query",
            "required": false,
            "description": "Ab diesem Zeitpunkt (ISO 8601); ohne Angabe ab jetzt.",
            "schema": {
              "type": "string"
            },
            "example": "2026-11-16T00:00:00Z"
          },
          {
            "name": "bis",
            "in": "query",
            "required": false,
            "description": "Bis zu diesem Zeitpunkt (ISO 8601); ohne Angabe 120 Tage nach „von“.",
            "schema": {
              "type": "string"
            },
            "example": "2027-01-31T00:00:00Z"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Apptermin"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/dienste/{id}": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Ein Termin",
        "description": "Ein Termin mit der eigenen Antwort, den Zählern, dem eigenen Platz auf dem Fahrzeug und den Namen der Zusagen, wenn die Feuerwehr das für Mitglieder freigegeben hat.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_dienste_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Apptermin"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/dienste/{id}/antwort": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Zu- oder absagen",
        "description": "Die Antwort der Person auf einen Termin; eine neue ersetzt die alte. Zusagen geht bis zum Anmeldeschluss, absagen bis zum Beginn. Wer zusagt, wenn alle Plätze vergeben sind, steht auf der Warteliste und rückt nach, sobald jemand absagt.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_dienste_id_antwort",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Apptermin"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DienstantwortEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/checkin": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Check-in an der Wache",
        "description": "Meldet die Person mit dem Code an, den das Tablet an der Wache als QR-Code zeigt. Der Code wechselt alle 20 Sekunden; gültig sind der laufende und der vorige. Der Check-in trägt Zusage und Anwesenheit ein und ist von zwei Stunden vor Beginn bis zum Ende des Termins möglich.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_checkin",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Apptermin"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckinEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/ausweis": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Mein Dienstausweis",
        "description": "Der gültige Dienstausweis der Person des Kontos: Nummer, Name, Dienstgrad, Einheit, Gültigkeit und die Adresse der öffentlichen Prüfseite für den QR-Code. 404, wenn kein Ausweis ausgestellt ist.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_ausweis",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/anwesenheit": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Meine Anwesenheit",
        "description": "Die Anwesenheit der Person des Kontos in einem Jahr, je Art des Dienstes: wie viele Dienste für sie waren, bei wie vielen sie da oder entschuldigt war, ihre Stunden und die Quote. Gezählt wird gegen die Mitgliedschaft am Tag des Dienstes.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_anwesenheit",
        "parameters": [
          {
            "name": "jahr",
            "in": "query",
            "required": false,
            "description": "Das Jahr; ohne Angabe das laufende.",
            "schema": {
              "type": "integer"
            },
            "example": 2026
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appanwesenheit"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/nachrichten": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Meine Nachrichten",
        "description": "Die Nachrichten und Umfragen für die Person des Kontos: angeheftete zuerst, dann ungelesene, dann die neuesten; höchstens 200. Empfänger ist, wer am Tag des Sendens aktives Mitglied der gemeinten Einheit war (und die genannte Funktion hatte) oder es heute ist, solange die Nachricht aktuell ist.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_nachrichten",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Appnachricht"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/nachrichten/{id}/gelesen": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Nachricht als gelesen merken",
        "description": "Hält fest, dass die Person die Nachricht geöffnet hat. Einmal genügt; ein weiterer Aufruf ändert nichts.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_nachrichten_id_gelesen",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appgelesen"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/nachrichten/{id}/abstimmung": {
      "post": {
        "tags": [
          "App"
        ],
        "summary": "In einer Umfrage abstimmen",
        "description": "Die gewählten Antworten ersetzen die bisherige Stimme der Person; eine leere Liste nimmt sie zurück. Möglich bis zum Ende der Umfrage. Bei einer Umfrage ohne Mehrfachwahl ist nur eine Antwort erlaubt.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "post_app_nachrichten_id_abstimmung",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Appnachricht"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AbstimmungEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/nachrichten/anhaenge/{id}": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Datei einer Nachricht",
        "description": "Liefert die Datei (Bild oder PDF) einer Nachricht, wenn die Person Empfänger ist.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_nachrichten_anhaenge_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Nummer des Datensatzes.",
            "schema": {
              "type": "integer"
            },
            "example": 1
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "404": {
            "$ref": "#/components/responses/NichtGefunden"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/scan": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Gescannten Code auflösen",
        "description": "Was ein gescannter fwMAX.de-Code meint: Gerät (material), Kleidungsstück (kleidung), Check-in an der Wache (checkin) oder Dienstausweis (ausweis), mit dem Pfad der Seite auf der eigenen Adresse. Nur der Pfad zählt, nie die Adresse einer anderen Seite. Eine bloße Inventarnummer wird bei Geräten und Kleidung gesucht. 404, wenn nichts passt.\n\n**Nötiges Recht:** Anmeldung in der App.",
        "operationId": "get_app_scan",
        "parameters": [
          {
            "name": "code",
            "in": "query",
            "required": false,
            "description": "Der gescannte Text: ein fwMAX.de-Link, sein Pfad oder eine Inventarnummer.",
            "schema": {
              "type": "string"
            },
            "example": "https://musterstadt.fwmax.de/material/42"
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    },
    "/v1/app/unterschriften": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Unterschriften zu einer Sache",
        "description": "Die Unterschriften zu einem Einsatz (bezugArt Einsatz), einem Gerät (Ausruestung) oder einem Fahrzeug (Fahrzeug), neueste zuerst: Zweck, Name, Zeitpunkt und Gerät, ohne Bild.\n\n**Nötiges Recht:** Ansehen der Sache.",
        "operationId": "get_app_unterschriften",
        "parameters": [
          {
            "name": "bezugArt",
            "in": "query",
            "required": false,
            "description": "Art der Sache: Einsatz, Ausruestung oder Fahrzeug.",
            "schema": {
              "type": "string"
            },
            "example": "Einsatz"
          },
          {
            "name": "bezugId",
            "in": "query",
            "required": false,
            "description": "Kennung der Sache.",
            "schema": {
              "type": "integer"
            },
            "example": 17
          }
        ],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      },
      "post": {
        "tags": [
          "App"
        ],
        "summary": "Unterschreiben",
        "description": "Speichert eine auf dem Gerät gezeichnete Unterschrift (PNG als Base64) mit Name, Zeitpunkt und Gerät als einfache elektronische Signatur. Zwecke: Einsatz – Einsatzleitung, Kommandant; Ausruestung – Empfang, Rueckgabe; Fahrzeug – Uebergabe, Uebernahme.\n\n**Nötiges Recht:** Anmeldung in der App und Bearbeiten der Sache.",
        "operationId": "post_app_unterschriften",
        "parameters": [],
        "responses": {
          "201": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Eingabefehler"
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UnterschriftEingabe"
              }
            }
          }
        }
      }
    },
    "/v1/app/einsaetze": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "Letzte Einsätze",
        "description": "Die letzten 50 Einsätze, neueste zuerst: Nummer, Stichwort, Art, Ort und Zeit. Ohne Bericht und ohne Namen.\n\n**Nötiges Recht:** Einsätze ansehen.",
        "operationId": "get_app_einsaetze",
        "parameters": [],
        "responses": {
          "200": {
            "description": "In Ordnung.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Appeinsatz"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/OhneSchluessel"
          },
          "403": {
            "$ref": "#/components/responses/KeinZugriff"
          },
          "429": {
            "$ref": "#/components/responses/ZuVieleAufrufe"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "Schluessel": {
        "type": "http",
        "scheme": "bearer",
        "description": "Schlüssel der Schnittstelle aus Verwaltung, Schnittstelle; beginnt mit `fwmax_`. Zum Ausprobieren mit der Live-Demo: `demo`."
      }
    },
    "responses": {
      "Eingabefehler": {
        "description": "Die Angaben stimmen nicht.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Fehler"
            },
            "example": {
              "fehler": "Bitte einen Nachnamen eingeben."
            }
          }
        }
      },
      "OhneSchluessel": {
        "description": "Der Schlüssel fehlt, ist gesperrt oder abgelaufen.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Fehler"
            },
            "example": {
              "fehler": "Der Schlüssel ist nicht gültig, gesperrt oder abgelaufen."
            }
          }
        }
      },
      "KeinZugriff": {
        "description": "Dem Schlüssel fehlt das Recht, oder die Feuerwehr nimmt gerade keine Änderungen an.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Fehler"
            },
            "example": {
              "fehler": "Dafür fehlt das Recht „Personal bearbeiten“."
            }
          }
        }
      },
      "NichtGefunden": {
        "description": "Den Datensatz gibt es nicht, oder der Schlüssel darf ihn nicht sehen.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Fehler"
            },
            "example": {
              "fehler": "Diese Person gibt es nicht."
            }
          }
        }
      },
      "ZuVieleAufrufe": {
        "description": "Zu viele Aufrufe in einer Minute.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Fehler"
            },
            "example": {
              "fehler": "Zu viele Aufrufe. Bitte in einer Minute noch einmal versuchen."
            }
          }
        }
      }
    },
    "schemas": {
      "AlarmEingabe": {
        "type": "object",
        "description": "Ein Alarm, wie ihn Leitstelle oder Alarmgeber melden.",
        "properties": {
          "stichwort": {
            "type": "string",
            "description": "Alarmstichwort. Pflicht.",
            "example": "B3 Wohnungsbrand"
          },
          "text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Freitext zur Lage.",
            "example": "Rauch aus Fenster im 2. OG, Personen im Gebäude"
          },
          "ort": {
            "type": [
              "string",
              "null"
            ],
            "description": "Einsatzort.",
            "example": "Hauptstraße 12, Musterstadt"
          },
          "einheiten": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer"
            },
            "description": "Nummern der alarmierten Einheiten; alles darunter ist mit gemeint. Leer: alle im Einsatzdienst."
          },
          "istProbe": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Probealarm: wird genauso zugestellt, aber als Probe gekennzeichnet.",
            "example": false
          },
          "fremdkennung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nummer des Alarms im sendenden System, als Schutz vor doppeltem Auslösen.",
            "example": "LST-2026-004711"
          }
        }
      },
      "Alarm": {
        "type": "object",
        "description": "Ein Alarm mit dem Stand der Rückmeldungen.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Alarms.",
            "example": 42
          },
          "stichwort": {
            "type": "string",
            "description": "Alarmstichwort.",
            "example": "B3 Wohnungsbrand"
          },
          "text": {
            "type": "string",
            "description": "Freitext zur Lage.",
            "example": "Rauch aus Fenster im 2. OG"
          },
          "ort": {
            "type": "string",
            "description": "Einsatzort.",
            "example": "Hauptstraße 12, Musterstadt"
          },
          "zeitpunkt": {
            "type": "string",
            "format": "date-time",
            "description": "Wann der Alarm ausgelöst wurde.",
            "example": "2026-11-16T12:31:00+00:00"
          },
          "istProbe": {
            "type": "boolean",
            "description": "Probealarm.",
            "example": false
          },
          "einheiten": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Alarmeinheit"
            },
            "description": "Alarmierte Einheiten; leer = alle im Einsatzdienst."
          },
          "beendetAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann der Alarm beendet wurde; leer, solange er läuft."
          },
          "meineRueckmeldung": {
            "$ref": "#/components/schemas/Alarmrueckmeldung"
          },
          "zaehler": {
            "$ref": "#/components/schemas/Alarmzaehler"
          },
          "rueckmeldungen": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Alarmrueckmeldung"
            },
            "description": "Alle Rückmeldungen; nur beim einzelnen Alarm und nur mit „Alarmierung ansehen“."
          }
        }
      },
      "Alarmeinheit": {
        "type": "object",
        "description": "Eine alarmierte Einheit.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Einheit.",
            "example": 12
          },
          "name": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          }
        }
      },
      "Alarmzaehler": {
        "type": "object",
        "description": "Zähler der Rückmeldungen.",
        "properties": {
          "komme": {
            "type": "integer",
            "description": "Kommen.",
            "example": 9
          },
          "kommeSpaeter": {
            "type": "integer",
            "description": "Kommen später.",
            "example": 2
          },
          "kommeNicht": {
            "type": "integer",
            "description": "Kommen nicht.",
            "example": 3
          },
          "offen": {
            "type": "integer",
            "description": "Betroffene ohne Rückmeldung.",
            "example": 7
          }
        }
      },
      "Alarmrueckmeldung": {
        "type": "object",
        "description": "Die Antwort einer Person auf einen Alarm.",
        "properties": {
          "person": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Person; fehlt bei der eigenen Rückmeldung.",
            "example": "Mia Braun"
          },
          "antwort": {
            "type": "string",
            "description": "Komme, KommeSpaeter oder KommeNicht.",
            "example": "Komme"
          },
          "minuten": {
            "type": [
              "integer",
              "null"
            ],
            "description": "In wie vielen Minuten die Person da ist.",
            "example": 5
          },
          "zeitpunkt": {
            "type": "string",
            "format": "date-time",
            "description": "Wann geantwortet wurde.",
            "example": "2026-11-16T12:32:10+00:00"
          }
        }
      },
      "Apptermin": {
        "type": "object",
        "description": "Ein Dienst oder Termin, wie ihn ein Mitglied in der App sieht.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Termins.",
            "example": 311
          },
          "art": {
            "type": "string",
            "description": "Uebung, SonstigerDienst, Veranstaltung oder Sitzung.",
            "example": "Uebung"
          },
          "artName": {
            "type": "string",
            "description": "Die Art in Worten.",
            "example": "Übung"
          },
          "farbe": {
            "type": "string",
            "description": "Farbe der Art.",
            "example": "#2563eb"
          },
          "titel": {
            "type": "string",
            "description": "Thema.",
            "example": "Löschangriff nach FwDV 3"
          },
          "beginn": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn.",
            "example": "2026-11-24T19:00:00+01:00"
          },
          "ende": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Ende; leer = offenes Ende.",
            "example": "2026-11-24T21:00:00+01:00"
          },
          "istGanztaegig": {
            "type": "boolean",
            "description": "Ganztägiger Termin.",
            "example": false
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden, wie sie überall gezählt wird.",
            "example": 2
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Feuerwehrhaus"
          },
          "beschreibung": {
            "type": "string",
            "description": "Beschreibung.",
            "example": "Bitte Einsatzkleidung mitbringen."
          },
          "einheit": {
            "type": "string",
            "description": "Einheit, zu der der Termin gehört.",
            "example": "Löschzug Nord"
          },
          "leitung": {
            "type": "string",
            "description": "Wer den Termin leitet.",
            "example": "Oskar Becker"
          },
          "mitAtemschutz": {
            "type": "boolean",
            "description": "Mit Atemschutz.",
            "example": false
          },
          "istAbgesagt": {
            "type": "boolean",
            "description": "Der Termin wurde abgesagt.",
            "example": false
          },
          "absagegrund": {
            "type": "string",
            "description": "Warum er abgesagt wurde.",
            "example": ""
          },
          "mitRueckmeldung": {
            "type": "boolean",
            "description": "Mitglieder sollen zu- oder absagen.",
            "example": true
          },
          "anmeldeschluss": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Danach geht nur noch die Absage."
          },
          "plaetze": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Plätze; leer = unbegrenzt.",
            "example": 12
          },
          "freiePlaetze": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Freie Plätze; leer = unbegrenzt.",
            "example": 4
          },
          "binGemeint": {
            "type": "boolean",
            "description": "Der Termin ist für die Person des Kontos gedacht.",
            "example": true
          },
          "meineAntwort": {
            "type": "string",
            "description": "Offen, Zusage oder Absage.",
            "example": "Zusage"
          },
          "meinAbsagegrund": {
            "type": "string",
            "description": "Der eigene Grund der Absage.",
            "example": ""
          },
          "binAufWarteliste": {
            "type": "boolean",
            "description": "Zugesagt, aber alle Plätze sind vergeben.",
            "example": false
          },
          "binAnwesend": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Anwesenheit; leer, solange sie nicht eingetragen ist."
          },
          "eingechecktAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann sich die Person selbst eingecheckt hat."
          },
          "meinPlatz": {
            "type": "string",
            "description": "Fahrzeug und Platz, wenn die Person eingeteilt ist.",
            "example": "HLF 20 · Maschinist"
          },
          "darfZusagen": {
            "type": "boolean",
            "description": "Zusagen ist noch möglich.",
            "example": true
          },
          "darfAbsagen": {
            "type": "boolean",
            "description": "Absagen ist noch möglich.",
            "example": true
          },
          "zaehler": {
            "$ref": "#/components/schemas/Appterminzaehler"
          },
          "zusagen": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Namen der Zusagen mit Platz; nur beim einzelnen Termin und nur, wenn die Feuerwehr das freigegeben hat."
          },
          "warteliste": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Namen auf der Warteliste, in der Reihenfolge des Nachrückens."
          }
        }
      },
      "Appterminzaehler": {
        "type": "object",
        "description": "Zähler der Antworten auf einen Termin.",
        "properties": {
          "zusage": {
            "type": "integer",
            "description": "Zusagen mit Platz.",
            "example": 8
          },
          "absage": {
            "type": "integer",
            "description": "Absagen.",
            "example": 3
          },
          "offen": {
            "type": "integer",
            "description": "Gemeinte ohne Antwort.",
            "example": 9
          },
          "warteliste": {
            "type": "integer",
            "description": "Zusagen ohne Platz.",
            "example": 0
          }
        }
      },
      "DienstantwortEingabe": {
        "type": "object",
        "description": "Die Antwort auf einen Termin.",
        "properties": {
          "antwort": {
            "type": "string",
            "description": "Zusage oder Absage.",
            "example": "Absage"
          },
          "grund": {
            "type": [
              "string",
              "null"
            ],
            "description": "Grund der Absage, höchstens 200 Zeichen.",
            "example": "Schichtdienst"
          }
        }
      },
      "Appnachricht": {
        "type": "object",
        "description": "Eine Nachricht an die Mitglieder, wie die Person des Kontos sie sieht.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Nachricht.",
            "example": 42
          },
          "titel": {
            "type": "string",
            "description": "Titel.",
            "example": "Winterdienst an der Wache"
          },
          "text": {
            "type": "string",
            "description": "Reiner Text mit Zeilenumbrüchen; nie HTML.",
            "example": "Bitte tragt euch für den Räumdienst ein."
          },
          "verfasser": {
            "type": "string",
            "description": "Wer sie geschrieben hat.",
            "example": "Oskar Becker"
          },
          "veroeffentlichtAm": {
            "type": "string",
            "description": "Wann sie gesendet wurde (ISO 8601).",
            "example": "2026-11-12T18:30:00Z"
          },
          "istWichtig": {
            "type": "boolean",
            "description": "Als wichtig markiert.",
            "example": false
          },
          "istAngeheftet": {
            "type": "boolean",
            "description": "Steht heute oben in der Liste.",
            "example": true
          },
          "istGelesen": {
            "type": "boolean",
            "description": "Die Person hat sie schon geöffnet.",
            "example": false
          },
          "empfaenger": {
            "type": "string",
            "description": "An wen sie ging, in Worten.",
            "example": "Löschzug Nord und alles darunter"
          },
          "anhaenge": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Appnachrichtanhang"
            },
            "description": "Dateien der Nachricht."
          },
          "umfrage": {
            "$ref": "#/components/schemas/Appumfrage"
          }
        }
      },
      "Appnachrichtanhang": {
        "type": "object",
        "description": "Eine Datei einer Nachricht; abzurufen unter /app/nachrichten/anhaenge/{id}.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Datei.",
            "example": 7
          },
          "dateiname": {
            "type": "string",
            "description": "Name der Datei.",
            "example": "raeumplan.pdf"
          },
          "inhaltstyp": {
            "type": "string",
            "description": "image/png, image/jpeg, image/webp oder application/pdf.",
            "example": "application/pdf"
          },
          "groesse": {
            "type": "integer",
            "description": "Größe in Bytes.",
            "example": 48213
          }
        }
      },
      "Appumfrage": {
        "type": "object",
        "description": "Die Umfrage einer Nachricht.",
        "properties": {
          "frage": {
            "type": "string",
            "description": "Die Frage.",
            "example": "Wer kommt zum Kameradschaftsabend?"
          },
          "istMehrfachwahl": {
            "type": "boolean",
            "description": "Mehrere Antworten sind erlaubt.",
            "example": false
          },
          "endetAm": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ende der Abstimmung (ISO 8601); leer: solange die Nachricht aktuell ist.",
            "example": "2026-11-30T19:00:00Z"
          },
          "istBeendet": {
            "type": "boolean",
            "description": "Abstimmen ist nicht mehr möglich.",
            "example": false
          },
          "istAnonym": {
            "type": "boolean",
            "description": "Niemand sieht, wer wofür gestimmt hat.",
            "example": false
          },
          "ergebnisSichtbar": {
            "type": "boolean",
            "description": "Die Zahlen der Antworten sind für die Person sichtbar.",
            "example": true
          },
          "hatAbgestimmt": {
            "type": "boolean",
            "description": "Die Person hat abgestimmt.",
            "example": true
          },
          "teilnehmer": {
            "type": "integer",
            "description": "Wie viele Personen abgestimmt haben.",
            "example": 23
          },
          "optionen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Appumfrageoption"
            },
            "description": "Die Antworten in ihrer Reihenfolge."
          }
        }
      },
      "Appumfrageoption": {
        "type": "object",
        "description": "Eine Antwort einer Umfrage.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Antwort.",
            "example": 101
          },
          "text": {
            "type": "string",
            "description": "Die Antwort.",
            "example": "Ich komme"
          },
          "stimmen": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Zahl der Stimmen; leer, solange das Ergebnis nicht sichtbar ist.",
            "example": 14
          },
          "gewaehlt": {
            "type": "boolean",
            "description": "Die Person hat diese Antwort gewählt.",
            "example": true
          }
        }
      },
      "AbstimmungEingabe": {
        "type": "object",
        "description": "Die Stimme der Person in einer Umfrage.",
        "properties": {
          "optionen": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "description": "Nummern der gewählten Antworten; leer nimmt die Stimme zurück."
          }
        }
      },
      "Appgelesen": {
        "type": "object",
        "description": "Bestätigung, dass die Nachricht als gelesen gemerkt ist.",
        "properties": {
          "gelesen": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          }
        }
      },
      "Etikettendrucker": {
        "type": "object",
        "description": "Ein Etikettendrucker der Feuerwehr.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Druckers.",
            "example": 3
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Kleiderkammer"
          },
          "modell": {
            "type": "string",
            "description": "Modell.",
            "example": "Zebra ZD421"
          },
          "dpi": {
            "type": "integer",
            "description": "Auflösung: 203, 300 oder 600.",
            "example": 203
          },
          "verbindung": {
            "type": "string",
            "description": "ZplCloud, Netzwerk, BrowserPrint oder Datei.",
            "example": "Netzwerk"
          },
          "adresse": {
            "type": [
              "string",
              "null"
            ],
            "description": "IP-Adresse im eigenen Netz (nur Netzwerk).",
            "example": "192.168.1.50"
          },
          "port": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Port (nur Netzwerk), meist 9100.",
            "example": 9100
          },
          "istStandard": {
            "type": "boolean",
            "description": "Der Standarddrucker.",
            "example": true
          }
        }
      },
      "Etikettenformatzeile": {
        "type": "object",
        "description": "Ein Etikettenformat.",
        "properties": {
          "schluessel": {
            "type": "string",
            "description": "Schlüssel des Formats.",
            "example": "rolle-57x32"
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Rolle 57 × 32 mm (Zebra)"
          },
          "breiteMm": {
            "type": "number",
            "description": "Breite eines Etiketts in mm.",
            "example": 57
          },
          "hoeheMm": {
            "type": "number",
            "description": "Höhe eines Etiketts in mm.",
            "example": 32
          },
          "istRolle": {
            "type": "boolean",
            "description": "Rolle (sonst A4-Bogen).",
            "example": true
          }
        }
      },
      "Druckeingabe": {
        "type": "object",
        "description": "Welche Etiketten an welchen Drucker.",
        "properties": {
          "bereich": {
            "type": "string",
            "description": "Kleiderkammer, Material, Atemschutz oder Fahrzeug.",
            "example": "Material"
          },
          "ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nummern der Stücke, mit Komma getrennt; leer für alle.",
            "example": "42,43"
          },
          "drucker": {
            "type": "integer",
            "description": "Nummer des Druckers.",
            "example": 3
          },
          "format": {
            "type": [
              "string",
              "null"
            ],
            "description": "Schlüssel des Formats; ohne Angabe das Standardformat des Druckers.",
            "example": "rolle-57x32"
          },
          "fahrzeug": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nur die Beladung dieses Fahrzeugs."
          }
        }
      },
      "Etikettengesendet": {
        "type": "object",
        "description": "Bestätigung, dass die Etiketten an den Drucker gingen.",
        "properties": {
          "gesendet": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          }
        }
      },
      "CheckinEingabe": {
        "type": "object",
        "description": "Der Code vom Tablet an der Wache.",
        "properties": {
          "code": {
            "type": "string",
            "description": "Der gescannte Code oder die Adresse, die ihn enthält.",
            "example": "AAABN0x3Qm1kZ2hpag"
          }
        }
      },
      "UnterschriftEingabe": {
        "type": "object",
        "description": "Eine auf dem Gerät gezeichnete Unterschrift.",
        "properties": {
          "bezugArt": {
            "type": "string",
            "description": "Art der Sache: Einsatz, Ausruestung oder Fahrzeug.",
            "example": "Einsatz"
          },
          "bezugId": {
            "type": "integer",
            "description": "Kennung der Sache.",
            "example": 17
          },
          "zweck": {
            "type": "string",
            "description": "Rolle: Einsatzleitung, Kommandant, Empfang, Rueckgabe, Uebergabe oder Uebernahme.",
            "example": "Einsatzleitung"
          },
          "name": {
            "type": "string",
            "description": "Der Name der unterschreibenden Person.",
            "example": "Anna Weber"
          },
          "bild": {
            "type": "string",
            "description": "Die Unterschrift als PNG in Base64.",
            "example": "iVBORw0KGgo..."
          },
          "geraet": {
            "type": "string",
            "description": "Plattform des Geräts, z. B. Android oder iOS.",
            "example": "Android"
          }
        }
      },
      "Appanwesenheit": {
        "type": "object",
        "description": "Die eigene Anwesenheit in einem Jahr.",
        "properties": {
          "jahr": {
            "type": "integer",
            "description": "Das Jahr.",
            "example": 2026
          },
          "arten": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Appanwesenheitszeile"
            },
            "description": "Je Art des Dienstes eine Zeile."
          },
          "gesamt": {
            "$ref": "#/components/schemas/Appanwesenheitssumme"
          }
        }
      },
      "Appanwesenheitszeile": {
        "type": "object",
        "description": "Anwesenheit bei einer Art von Dienst.",
        "properties": {
          "art": {
            "type": "string",
            "description": "Uebung, SonstigerDienst, Veranstaltung, Sitzung oder Einsatz.",
            "example": "Uebung"
          },
          "name": {
            "type": "string",
            "description": "Die Art in Worten.",
            "example": "Übung"
          },
          "farbe": {
            "type": "string",
            "description": "Farbe der Art.",
            "example": "#2563eb"
          },
          "dienste": {
            "type": "integer",
            "description": "Dienste, die für die Person waren.",
            "example": 22
          },
          "anwesend": {
            "type": "integer",
            "description": "Davon anwesend.",
            "example": 17
          },
          "entschuldigt": {
            "type": "integer",
            "description": "Davon entschuldigt gefehlt.",
            "example": 3
          },
          "stunden": {
            "type": "number",
            "description": "Stunden der Person.",
            "example": 34
          },
          "quote": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Anwesenheit in Prozent; leer ohne Dienste.",
            "example": 77
          }
        }
      },
      "Appanwesenheitssumme": {
        "type": "object",
        "description": "Anwesenheit über alle Arten.",
        "properties": {
          "dienste": {
            "type": "integer",
            "description": "Dienste.",
            "example": 41
          },
          "anwesend": {
            "type": "integer",
            "description": "Anwesend.",
            "example": 30
          },
          "entschuldigt": {
            "type": "integer",
            "description": "Entschuldigt.",
            "example": 5
          },
          "stunden": {
            "type": "number",
            "description": "Stunden.",
            "example": 72
          }
        }
      },
      "Appeinsatz": {
        "type": "object",
        "description": "Ein Einsatz in der kurzen Liste der App.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Datensatzes.",
            "example": 88
          },
          "nummer": {
            "type": "string",
            "description": "Einsatznummer mit Jahr.",
            "example": "17/2026"
          },
          "titel": {
            "type": "string",
            "description": "Stichwort.",
            "example": "B3 Wohnungsbrand"
          },
          "einsatzart": {
            "type": "string",
            "description": "Art des Einsatzes.",
            "example": "Brand"
          },
          "ort": {
            "type": "string",
            "description": "Einsatzort.",
            "example": "Hauptstraße 12, Nord"
          },
          "beginn": {
            "type": "string",
            "format": "date-time",
            "description": "Alarmzeit.",
            "example": "2026-11-16T12:31:00+01:00"
          },
          "ende": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Einsatzende."
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden.",
            "example": 2
          },
          "istAbgeschlossen": {
            "type": "boolean",
            "description": "Der Bericht ist abgeschlossen.",
            "example": true
          }
        }
      },
      "HerzschlagEingabe": {
        "type": "object",
        "description": "Was eine Quelle beim Health-Check mitgeben kann. Der Inhalt darf fehlen.",
        "properties": {
          "meldung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Kurzer Stand der Quelle, höchstens 300 Zeichen.",
            "example": "FE2 2.38, 3 Alarme heute"
          }
        }
      },
      "Herzschlag": {
        "type": "object",
        "description": "Antwort auf einen Health-Check.",
        "properties": {
          "ok": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          },
          "name": {
            "type": "string",
            "description": "Name der Quelle.",
            "example": "Alarmserver Wache Nord"
          },
          "zeitpunkt": {
            "type": "string",
            "format": "date-time",
            "description": "Wann der Health-Check ankam.",
            "example": "2026-11-16T12:31:00+00:00"
          },
          "erwartetAlleMinuten": {
            "type": "integer",
            "description": "So oft wird ein Health-Check erwartet.",
            "example": 5
          },
          "warAusgefallen": {
            "type": "boolean",
            "description": "Die Quelle galt als ausgefallen und ist jetzt wieder da.",
            "example": false
          }
        }
      },
      "RueckmeldungEingabe": {
        "type": "object",
        "description": "Die Antwort auf einen Alarm.",
        "properties": {
          "antwort": {
            "type": "string",
            "description": "Komme, KommeSpaeter oder KommeNicht.",
            "example": "Komme"
          },
          "minuten": {
            "type": [
              "integer",
              "null"
            ],
            "description": "In wie vielen Minuten (0 bis 600).",
            "example": 5
          }
        }
      },
      "CodeEingabe": {
        "type": "object",
        "description": "Wer sich anmelden will.",
        "properties": {
          "adresse": {
            "type": "string",
            "description": "Adressname der Feuerwehr, der Teil vor .fwmax.de.",
            "example": "musterstadt"
          },
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse des Kontos.",
            "example": "mia.braun@example.org"
          }
        }
      },
      "CodeGesendet": {
        "type": "object",
        "description": "Antwort auf die Bitte um einen Code; immer gleich.",
        "properties": {
          "gesendet": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          }
        }
      },
      "AnmeldungEingabe": {
        "type": "object",
        "description": "Anmeldung mit dem Code aus der E-Mail.",
        "properties": {
          "adresse": {
            "type": "string",
            "description": "Adressname der Feuerwehr.",
            "example": "musterstadt"
          },
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse des Kontos.",
            "example": "mia.braun@example.org"
          },
          "code": {
            "type": "string",
            "description": "Der Code aus der E-Mail.",
            "example": "123456"
          },
          "geraetename": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Geräts, für die Liste der Anmeldungen.",
            "example": "iPhone von Mia"
          },
          "plattform": {
            "type": [
              "string",
              "null"
            ],
            "description": "ios oder android.",
            "example": "ios"
          }
        }
      },
      "ZweiterFaktorEingabe": {
        "type": "object",
        "description": "Zweiter Schritt der Anmeldung: der Code aus der Authenticator-App.",
        "properties": {
          "adresse": {
            "type": "string",
            "description": "Adressname der Feuerwehr.",
            "example": "musterstadt"
          },
          "marke": {
            "type": "string",
            "description": "Die Marke aus der Antwort des ersten Schritts.",
            "example": "CfDJ8…"
          },
          "code": {
            "type": "string",
            "description": "Sechs Ziffern aus der Authenticator-App oder ein Wiederherstellungscode.",
            "example": "123456"
          },
          "geraetename": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Geräts, für die Liste der Anmeldungen.",
            "example": "iPhone von Mia"
          },
          "plattform": {
            "type": [
              "string",
              "null"
            ],
            "description": "ios oder android.",
            "example": "ios"
          }
        }
      },
      "Appanmeldung": {
        "type": "object",
        "description": "Antwort auf die Anmeldung: entweder die Sitzung mit Feuerwehr, Konto und Person, oder die Aufforderung zum zweiten Schritt.",
        "properties": {
          "sitzung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Die Sitzung; wird nur hier einmal geliefert. Fehlt, solange der zweite Schritt aussteht.",
            "example": "fwapp_…"
          },
          "feuerwehr": {
            "$ref": "#/components/schemas/Appfeuerwehr"
          },
          "konto": {
            "$ref": "#/components/schemas/Appkonto"
          },
          "person": {
            "$ref": "#/components/schemas/Appperson"
          },
          "zweiterFaktor": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Wahr, wenn das Konto eine Authenticator-App hat und der zweite Schritt noch aussteht.",
            "example": false
          },
          "marke": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nur mit zweiterFaktor: gehört in den Aufruf von /app/anmeldung/zweiter-faktor, gilt 5 Minuten."
          },
          "wiederherstellungscode": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Wahr, wenn im zweiten Schritt ein Wiederherstellungscode benutzt wurde.",
            "example": false
          }
        }
      },
      "Appauskunft": {
        "type": "object",
        "description": "Wer in der App angemeldet ist.",
        "properties": {
          "feuerwehr": {
            "$ref": "#/components/schemas/Appfeuerwehr"
          },
          "konto": {
            "$ref": "#/components/schemas/Appkonto"
          },
          "person": {
            "$ref": "#/components/schemas/Appperson"
          },
          "rechte": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Rechte als „Bereich.Tätigkeit“.",
            "example": [
              "Alarm.Ansehen",
              "Personal.Ansehen"
            ]
          },
          "nurLesen": {
            "type": "boolean",
            "description": "Die Feuerwehr nimmt gerade keine Änderungen an.",
            "example": false
          },
          "geraet": {
            "$ref": "#/components/schemas/Appgeraet"
          }
        }
      },
      "Appfeuerwehr": {
        "type": "object",
        "description": "Die Feuerwehr eines Kontos.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Feuerwehr Musterstadt"
          },
          "adressname": {
            "type": "string",
            "description": "Adressname.",
            "example": "musterstadt"
          },
          "land": {
            "type": "string",
            "description": "DE, AT oder CH.",
            "example": "DE"
          }
        }
      },
      "Appkonto": {
        "type": "object",
        "description": "Ein Konto.",
        "properties": {
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse.",
            "example": "mia.braun@example.org"
          },
          "istVerwalter": {
            "type": "boolean",
            "description": "Darf alles.",
            "example": false
          }
        }
      },
      "Appperson": {
        "type": "object",
        "description": "Die Person eines Kontos.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          }
        }
      },
      "Appgeraet": {
        "type": "object",
        "description": "Stand des Geräts.",
        "properties": {
          "pushAktiv": {
            "type": "boolean",
            "description": "Das Gerät hat eine Push-Adresse und der Versand für seine Plattform ist eingerichtet.",
            "example": true
          },
          "kritischeHinweise": {
            "type": "boolean",
            "description": "Alarme dürfen trotz „Nicht stören“ klingeln.",
            "example": true
          }
        }
      },
      "GeraetEingabe": {
        "type": "object",
        "description": "Push-Angaben des Geräts.",
        "properties": {
          "pushToken": {
            "type": [
              "string",
              "null"
            ],
            "description": "Push-Adresse des Geräts (APNs-Token bzw. FCM-Token); leer schaltet Push ab.",
            "example": "a1b2c3…"
          },
          "plattform": {
            "type": "string",
            "description": "ios oder android.",
            "example": "ios"
          },
          "kritischeHinweise": {
            "type": "boolean",
            "description": "Der Benutzer hat kritische Hinweise erlaubt.",
            "example": true
          },
          "appVersion": {
            "type": [
              "string",
              "null"
            ],
            "description": "Fassung der App.",
            "example": "1.0.0"
          }
        }
      },
      "Gespeichert": {
        "type": "object",
        "description": "Antwort auf das Speichern.",
        "properties": {
          "gespeichert": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          }
        }
      },
      "Abgemeldet": {
        "type": "object",
        "description": "Antwort auf das Abmelden.",
        "properties": {
          "abgemeldet": {
            "type": "boolean",
            "description": "Immer wahr.",
            "example": true
          }
        }
      },
      "Fehler": {
        "type": "object",
        "description": "Jeder Fehler hat diese Form.",
        "properties": {
          "fehler": {
            "type": "string",
            "description": "Was nicht ging, als Satz für Menschen.",
            "example": "Bitte einen Nachnamen eingeben."
          }
        }
      },
      "Angelegt": {
        "type": "object",
        "description": "Antwort auf das Anlegen oder Ändern.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Datensatzes.",
            "example": 4711
          }
        }
      },
      "PersonAngelegt": {
        "type": "object",
        "description": "Antwort auf das Anlegen oder Ändern einer Person.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer; wurde keine mitgegeben, die nächste freie.",
            "example": "0033"
          }
        }
      },
      "NachweisAngelegt": {
        "type": "object",
        "description": "Antwort auf das Eintragen eines Nachweises.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Nachweises.",
            "example": 901
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Ende der Gültigkeit; ohne Angabe aus der Gültigkeit der Nachweisart berechnet.",
            "example": "2029-11-16"
          }
        }
      },
      "Auskunft": {
        "type": "object",
        "description": "Wer ruft auf und was darf er.",
        "properties": {
          "feuerwehr": {
            "type": "string",
            "description": "Name der Feuerwehr, zu der der Schlüssel gehört.",
            "example": "Demo-Feuerwehr Musterstadt"
          },
          "adressname": {
            "type": "string",
            "description": "Adressname der Feuerwehr.",
            "example": "demo"
          },
          "version": {
            "type": "string",
            "description": "Fassung der Schnittstelle.",
            "example": "1.0"
          },
          "schluessel": {
            "type": "string",
            "description": "Name des Schlüssels; leer in der Live-Demo.",
            "example": "Webseite der Feuerwehr"
          },
          "nurLesen": {
            "type": "boolean",
            "description": "Die Feuerwehr nimmt gerade keine Änderungen an (Live-Demo oder abgelaufene Testphase).",
            "example": true
          },
          "darfAlles": {
            "type": "boolean",
            "description": "Ohne Einschränkung durch Rechte (nur in der Live-Demo).",
            "example": true
          },
          "rechte": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Recht"
            },
            "description": "Die Rechte des Schlüssels."
          }
        }
      },
      "Recht": {
        "type": "object",
        "description": "Ein Recht: Bereich plus Tätigkeit.",
        "properties": {
          "bereich": {
            "type": "string",
            "description": "Personal, Gesundheitsangaben, Dokumente, Organisation, Kataloge oder Alarm.",
            "example": "Personal"
          },
          "taetigkeit": {
            "type": "string",
            "description": "Ansehen, Bearbeiten, Loeschen oder Drucken.",
            "example": "Ansehen"
          },
          "ueberall": {
            "type": "boolean",
            "description": "Gilt für die gesamte Feuerwehr.",
            "example": true
          },
          "organisationseinheiten": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer"
            },
            "description": "Sonst: Nummern der Einheiten, in denen es gilt."
          }
        }
      },
      "Organisationseinheit": {
        "type": "object",
        "description": "Eine Einheit im Aufbau der Feuerwehr.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Einheit.",
            "example": 12
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Löschzug Nord"
          },
          "kurzname": {
            "type": "string",
            "description": "Kurzname.",
            "example": "LZ Nord"
          },
          "organisationsartId": {
            "type": "integer",
            "description": "Nummer der Art, siehe /v1/kataloge/organisationsarten.",
            "example": 2
          },
          "art": {
            "type": "string",
            "description": "Name der Art.",
            "example": "Löschzug"
          },
          "uebergeordneteOrganisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Einheit darüber; leer auf oberster Ebene.",
            "example": 3
          },
          "ebene": {
            "type": "integer",
            "description": "Tiefe im Baum, 0 ist die oberste Ebene.",
            "example": 3
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Platz unter den Geschwistern.",
            "example": 1
          },
          "gueltigVon": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Besteht seit.",
            "example": "1975-01-01"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Aufgelöst zum; leer, solange die Einheit besteht."
          }
        }
      },
      "OrganisationseinheitEingabe": {
        "type": "object",
        "description": "Angaben zu einer Einheit. Beim Ändern bleiben fehlende Felder, wie sie sind.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name. Pflicht beim Anlegen.",
            "example": "Löschgruppe Altheim"
          },
          "kurzname": {
            "type": [
              "string",
              "null"
            ],
            "description": "Kurzname.",
            "example": "LG Altheim"
          },
          "organisationsartId": {
            "type": "integer",
            "description": "Nummer der Art. Pflicht beim Anlegen.",
            "example": 3
          },
          "uebergeordneteOrganisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Einheit darüber; leer = oberste Ebene.",
            "example": 12
          },
          "reihenfolge": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Platz unter den Geschwistern.",
            "example": 2
          },
          "gueltigVon": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Besteht seit.",
            "example": "2026-01-01"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Aufgelöst zum."
          }
        }
      },
      "Mitgliedschaft": {
        "type": "object",
        "description": "Eine Person gehört für eine Zeit in einer bestimmten Art zu einer Einheit.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Mitgliedschaft.",
            "example": 301
          },
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit.",
            "example": 12
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          },
          "mitgliedschaftsartId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 1
          },
          "mitgliedschaftsart": {
            "type": "string",
            "description": "Name der Art.",
            "example": "Einsatzabteilung"
          },
          "status": {
            "type": "string",
            "description": "Aktiv, Ruhend, Beurlaubt oder Ausgetreten.",
            "example": "Aktiv"
          },
          "gueltigVon": {
            "type": "string",
            "format": "date",
            "description": "Beginn.",
            "example": "2017-03-01"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Ende; leer = laufend."
          },
          "austrittsgrund": {
            "type": "string",
            "description": "Grund des Endes.",
            "example": ""
          }
        }
      },
      "MitgliedschaftEingabe": {
        "type": "object",
        "description": "Eine neue Mitgliedschaft.",
        "properties": {
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit.",
            "example": 12
          },
          "mitgliedschaftsartId": {
            "type": "integer",
            "description": "Nummer der Art, siehe /v1/kataloge/mitgliedschaftsarten.",
            "example": 1
          },
          "gueltigVon": {
            "type": "string",
            "format": "date",
            "description": "Beginn.",
            "example": "2026-11-16"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Ende; leer = laufend."
          }
        }
      },
      "Personenzeile": {
        "type": "object",
        "description": "Eine Zeile der Personalliste.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer.",
            "example": "0011"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "geburtsdatum": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Geburtsdatum.",
            "example": "2003-01-11"
          },
          "dienstgrad": {
            "type": [
              "string",
              "null"
            ],
            "description": "Aktueller Dienstgrad.",
            "example": "Oberfeuerwehrmann/-frau"
          },
          "funktionen": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Laufende Funktionen, Führungsfunktionen zuerst.",
            "example": [
              "Atemschutzgeräteträger/in"
            ]
          },
          "mitgliedschaften": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mitgliedschaft"
            },
            "description": "Laufende Mitgliedschaften."
          },
          "dienstjahre": {
            "type": "integer",
            "description": "Volle Dienstjahre bis heute.",
            "example": 9
          },
          "atemschutz": {
            "type": "string",
            "description": "NichtVorgesehen, Tauglich, LaeuftBaldAb oder NichtTauglich.",
            "example": "Tauglich"
          },
          "nachweiseAbgelaufen": {
            "type": "integer",
            "description": "Zahl abgelaufener Nachweise.",
            "example": 1
          },
          "nachweiseBaldFaellig": {
            "type": "integer",
            "description": "Zahl der Nachweise, die in 90 Tagen ablaufen.",
            "example": 1
          }
        }
      },
      "PersonEingabe": {
        "type": "object",
        "description": "Stammdaten einer Person. Beim Ändern bleiben fehlende Felder, wie sie sind.",
        "properties": {
          "personalnummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Frei wählbar und änderbar, je Feuerwehr nur einmal. Leer lassen: die nächste freie Nummer wird vergeben.",
            "example": ""
          },
          "anrede": {
            "type": [
              "string",
              "null"
            ],
            "description": "Frau, Herr oder Divers. Pflicht beim Anlegen.",
            "example": "Frau"
          },
          "vorname": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vorname. Pflicht beim Anlegen.",
            "example": "Lena"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname. Pflicht beim Anlegen.",
            "example": "Keller"
          },
          "geburtsdatum": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Geburtsdatum. Pflicht beim Anlegen.",
            "example": "1998-05-04"
          },
          "geburtsort": {
            "type": [
              "string",
              "null"
            ],
            "description": "Geburtsort.",
            "example": "Musterstadt"
          },
          "geschlecht": {
            "type": [
              "string",
              "null"
            ],
            "description": "weiblich, männlich oder divers.",
            "example": "weiblich"
          },
          "strasse": {
            "type": [
              "string",
              "null"
            ],
            "description": "Straße und Hausnummer.",
            "example": "Gartenweg 31"
          },
          "postleitzahl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postleitzahl.",
            "example": "12345"
          },
          "ort": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "telefon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Telefon.",
            "example": "0151 5551370"
          },
          "mobiltelefon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mobiltelefon.",
            "example": "0170 5552530"
          },
          "eMailAdresse": {
            "type": [
              "string",
              "null"
            ],
            "description": "E-Mail-Adresse.",
            "example": "lena.keller@example.org"
          },
          "beruf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Beruf.",
            "example": "Elektronikerin"
          },
          "arbeitgeber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Arbeitgeber.",
            "example": "Stadtwerke Musterstadt"
          },
          "istTagsueberVerfuegbar": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Tagsüber in der Regel für Einsätze verfügbar.",
            "example": false
          },
          "notizen": {
            "type": [
              "string",
              "null"
            ],
            "description": "Freie Notizen.",
            "example": ""
          }
        }
      },
      "Befoerderung": {
        "type": "object",
        "description": "Ein Dienstgrad, den die Person an einem Tag bekommen hat.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 77
          },
          "dienstgradId": {
            "type": "integer",
            "description": "Nummer des Dienstgrads.",
            "example": 4
          },
          "dienstgrad": {
            "type": "string",
            "description": "Name des Dienstgrads.",
            "example": "Oberfeuerwehrmann/-frau"
          },
          "datum": {
            "type": "string",
            "format": "date",
            "description": "Seit wann.",
            "example": "2023-01-01"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          }
        }
      },
      "Funktionszuweisung": {
        "type": "object",
        "description": "Eine Funktion, die die Person für eine Zeit hat.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 21
          },
          "funktionId": {
            "type": "integer",
            "description": "Nummer der Funktion.",
            "example": 8
          },
          "funktion": {
            "type": "string",
            "description": "Name der Funktion.",
            "example": "Atemschutzgeräteträger/in"
          },
          "organisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Einheit, in der sie gilt; leer = gesamte Feuerwehr."
          },
          "organisationseinheit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Einheit."
          },
          "gueltigVon": {
            "type": "string",
            "format": "date",
            "description": "Beginn.",
            "example": "2019-03-01"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Ende; leer = laufend."
          }
        }
      },
      "Nachweis": {
        "type": "object",
        "description": "Ein Lehrgang, eine Untersuchung, eine Unterweisung, ein Führerschein, ein Abzeichen oder eine Ehrung.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 901
          },
          "nachweisartId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 10
          },
          "nachweisart": {
            "type": "string",
            "description": "Name der Art.",
            "example": "Atemschutztauglichkeit (G26.3)"
          },
          "kategorie": {
            "type": "string",
            "description": "Lehrgang, Untersuchung, Unterweisung, Fuehrerschein, Abzeichen oder Ehrung.",
            "example": "Untersuchung"
          },
          "erworbenAm": {
            "type": "string",
            "format": "date",
            "description": "Datum.",
            "example": "2025-10-16"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Ende der Gültigkeit; leer = unbefristet.",
            "example": "2028-10-16"
          },
          "ausgestelltVon": {
            "type": "string",
            "description": "Wer ausgestellt hat.",
            "example": "Betriebsarzt"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          },
          "gilt": {
            "type": "boolean",
            "description": "Der neueste seiner Art: der, der heute zählt.",
            "example": true
          },
          "stand": {
            "type": "string",
            "description": "OhneAblauf, Gueltig, LaeuftBaldAb oder Abgelaufen.",
            "example": "Gueltig"
          }
        }
      },
      "NachweisEingabe": {
        "type": "object",
        "description": "Ein neuer Nachweis.",
        "properties": {
          "nachweisartId": {
            "type": "integer",
            "description": "Nummer der Art, siehe /v1/kataloge/nachweisarten.",
            "example": 10
          },
          "erworbenAm": {
            "type": "string",
            "format": "date",
            "description": "Datum; nicht in der Zukunft.",
            "example": "2026-11-16"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Leer lassen: wird aus der Gültigkeit der Art berechnet."
          },
          "ausgestelltVon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Wer ausgestellt hat.",
            "example": "Betriebsarzt"
          },
          "bemerkung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bemerkung.",
            "example": ""
          }
        }
      },
      "Kontaktperson": {
        "type": "object",
        "description": "Wer für eine Person anzurufen ist; bei Minderjährigen die Erziehungsberechtigten.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 55
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Thomas Braun"
          },
          "beziehung": {
            "type": "string",
            "description": "Beziehung zur Person.",
            "example": "Ehemann"
          },
          "telefon": {
            "type": "string",
            "description": "Telefon.",
            "example": "0160 5555310"
          },
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse.",
            "example": ""
          },
          "istNotfallkontakt": {
            "type": "boolean",
            "description": "Im Notfall anrufen.",
            "example": true
          },
          "istErziehungsberechtigt": {
            "type": "boolean",
            "description": "Unterschreibt für Minderjährige.",
            "example": false
          }
        }
      },
      "KontaktpersonEingabe": {
        "type": "object",
        "description": "Eine neue Kontaktperson. Telefon oder E-Mail-Adresse muss angegeben sein.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Sabine Neumann"
          },
          "beziehung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Beziehung zur Person.",
            "example": "Mutter"
          },
          "telefon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Telefon.",
            "example": "0160 5553123"
          },
          "eMailAdresse": {
            "type": [
              "string",
              "null"
            ],
            "description": "E-Mail-Adresse.",
            "example": "sabine.neumann@example.org"
          },
          "istNotfallkontakt": {
            "type": "boolean",
            "description": "Im Notfall anrufen.",
            "example": true
          },
          "istErziehungsberechtigt": {
            "type": "boolean",
            "description": "Unterschreibt für Minderjährige.",
            "example": true
          }
        }
      },
      "Dokumenteintrag": {
        "type": "object",
        "description": "Ein Dokument der Personalakte, ohne die Datei.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 3
          },
          "titel": {
            "type": "string",
            "description": "Titel.",
            "example": "Einverständniserklärung Zeltlager"
          },
          "abgelegtAm": {
            "type": "string",
            "format": "date-time",
            "description": "Wann abgelegt.",
            "example": "2026-11-11T10:56:00+00:00"
          },
          "unterschriebenAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann über fwMAX.de unterschrieben.",
            "example": "2026-11-11T10:56:00+00:00"
          }
        }
      },
      "Hinweis": {
        "type": "object",
        "description": "Etwas, das beim Lesen der Akte auffallen soll.",
        "properties": {
          "stufe": {
            "type": "string",
            "description": "schlecht, warn oder info.",
            "example": "schlecht"
          },
          "text": {
            "type": "string",
            "description": "Der Hinweis.",
            "example": "Erste Hilfe ist seit 16.08.2026 abgelaufen."
          }
        }
      },
      "Personalakte": {
        "type": "object",
        "description": "Die vollständige Personalakte.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer.",
            "example": "0011"
          },
          "anrede": {
            "type": "string",
            "description": "Anrede.",
            "example": "Frau"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "geburtsdatum": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Geburtsdatum.",
            "example": "2003-01-11"
          },
          "geburtsort": {
            "type": "string",
            "description": "Geburtsort.",
            "example": "Neustadt"
          },
          "geschlecht": {
            "type": "string",
            "description": "Geschlecht.",
            "example": "weiblich"
          },
          "alter": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Alter in Jahren.",
            "example": 23
          },
          "strasse": {
            "type": "string",
            "description": "Straße.",
            "example": "Gartenweg 31"
          },
          "postleitzahl": {
            "type": "string",
            "description": "Postleitzahl.",
            "example": "12345"
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "telefon": {
            "type": "string",
            "description": "Telefon.",
            "example": "0151 5551370"
          },
          "mobiltelefon": {
            "type": "string",
            "description": "Mobiltelefon.",
            "example": "0170 5552530"
          },
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse.",
            "example": "mia.braun@example.org"
          },
          "beruf": {
            "type": "string",
            "description": "Beruf.",
            "example": "Elektronikerin"
          },
          "arbeitgeber": {
            "type": "string",
            "description": "Arbeitgeber.",
            "example": "Stadtwerke Musterstadt"
          },
          "istTagsueberVerfuegbar": {
            "type": "boolean",
            "description": "Tagsüber in der Regel verfügbar.",
            "example": false
          },
          "notizen": {
            "type": "string",
            "description": "Notizen.",
            "example": ""
          },
          "dienstgrad": {
            "type": [
              "string",
              "null"
            ],
            "description": "Aktueller Dienstgrad.",
            "example": "Oberfeuerwehrmann/-frau"
          },
          "dienstjahre": {
            "type": "integer",
            "description": "Volle Dienstjahre.",
            "example": 9
          },
          "istEinsatzfaehig": {
            "type": "boolean",
            "description": "Hat eine laufende, aktive Mitgliedschaft im Einsatzdienst.",
            "example": true
          },
          "atemschutz": {
            "type": "string",
            "description": "NichtVorgesehen, Tauglich, LaeuftBaldAb oder NichtTauglich.",
            "example": "Tauglich"
          },
          "mitgliedschaften": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Mitgliedschaft"
            },
            "description": "Alle Mitgliedschaften, neueste zuerst."
          },
          "dienstgrade": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Befoerderung"
            },
            "description": "Alle Dienstgrade, neuester zuerst."
          },
          "funktionen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Funktionszuweisung"
            },
            "description": "Alle Funktionen."
          },
          "nachweise": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Nachweis"
            },
            "description": "Alle Nachweise."
          },
          "kontaktpersonen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kontaktperson"
            },
            "description": "Kontaktpersonen."
          },
          "dokumente": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Dokumenteintrag"
            },
            "description": "Dokumente; leer ohne das Recht „Dokumente ansehen“."
          },
          "hinweise": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Hinweis"
            },
            "description": "Was auffallen soll: abgelaufene Nachweise, fehlende Angaben, Jubiläen."
          },
          "gesundheitsangabe": {
            "type": "string",
            "description": "Allergien, Medikamente, Hinweise für den Notfall; leer ohne das Recht „Gesundheitsangaben ansehen“.",
            "example": ""
          }
        }
      },
      "Frist": {
        "type": "object",
        "description": "Ein Nachweis, der abgelaufen ist oder bald abläuft.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer.",
            "example": "0011"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "nachweisartId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 9
          },
          "nachweisart": {
            "type": "string",
            "description": "Name der Art.",
            "example": "Erste Hilfe"
          },
          "kategorie": {
            "type": "string",
            "description": "Kategorie der Art.",
            "example": "Lehrgang"
          },
          "erworbenAm": {
            "type": "string",
            "format": "date",
            "description": "Datum des Nachweises.",
            "example": "2024-08-16"
          },
          "gueltigBis": {
            "type": "string",
            "format": "date",
            "description": "Ende der Gültigkeit.",
            "example": "2026-08-16"
          },
          "stand": {
            "type": "string",
            "description": "Abgelaufen oder LaeuftBaldAb.",
            "example": "Abgelaufen"
          }
        }
      },
      "Kleiderkammerbestand": {
        "type": "object",
        "description": "Der Bestand der Kleiderkammer.",
        "properties": {
          "stuecke": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungsstueck"
            },
            "description": "Die einzeln geführten Stücke."
          },
          "gezaehlt": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungsbestand"
            },
            "description": "Der gezählte Bestand je Größe und Lagerort."
          }
        }
      },
      "Kleidungsstueck": {
        "type": "object",
        "description": "Ein einzeln geführtes Kleidungsstück.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Stücks.",
            "example": 812
          },
          "inventarnummer": {
            "type": "string",
            "description": "Inventarnummer.",
            "example": "EJ-0042"
          },
          "kleidungskategorieId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 3
          },
          "kleidungskategorie": {
            "type": "string",
            "description": "Art der Kleidung.",
            "example": "Einsatzjacke"
          },
          "groesse": {
            "type": "string",
            "description": "Größe.",
            "example": "52"
          },
          "zustand": {
            "type": "string",
            "description": "Lager, Ausgegeben, Waesche, Reparatur oder Ausgesondert.",
            "example": "Ausgegeben"
          },
          "istEinsatzbereit": {
            "type": "boolean",
            "description": "Darf ausgegeben und getragen werden.",
            "example": true
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Einheit, der das Stück gehört.",
            "example": "Demo-Feuerwehr Musterstadt"
          },
          "lagerort": {
            "type": [
              "string",
              "null"
            ],
            "description": "Lagerort.",
            "example": "Kleiderkammer Gerätehaus"
          },
          "personId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Person, die es hat.",
            "example": 155
          },
          "hergestelltAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Herstellungsdatum.",
            "example": "2021-03-01"
          },
          "naechstePruefung": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Nächste Sichtprüfung.",
            "example": "2027-02-15"
          },
          "aussondernAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Tag der Ablegereife.",
            "example": "2031-03-01"
          },
          "waschzahl": {
            "type": "integer",
            "description": "Wie oft gewaschen.",
            "example": 7
          },
          "hinweis": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ablegereif, PruefungFaellig, PruefungBald oder BaldAusgewaschen.",
            "example": "PruefungBald"
          }
        }
      },
      "Kleidungsgroesse": {
        "type": "object",
        "description": "Die Größe einer Person in einem Größensystem.",
        "properties": {
          "groessensystem": {
            "type": "string",
            "description": "Konfektion, Buchstaben, Schuh, Helm, Handschuh oder Koerpergroesse.",
            "example": "Konfektion"
          },
          "groesse": {
            "type": "string",
            "description": "Größe.",
            "example": "52"
          }
        }
      },
      "Kleidungszeile": {
        "type": "object",
        "description": "Eine Art der Kleidung bei einer Person.",
        "properties": {
          "kleidungskategorieId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 3
          },
          "kleidungskategorie": {
            "type": "string",
            "description": "Art der Kleidung.",
            "example": "Einsatzjacke"
          },
          "soll": {
            "type": "integer",
            "description": "Wie viele die Person haben sollte.",
            "example": 1
          },
          "ist": {
            "type": "integer",
            "description": "Wie viele sie hat.",
            "example": 1
          },
          "stand": {
            "type": "string",
            "description": "Fehlt, Ablegereif, PruefungFaellig, FalscheGroesse, Vorhanden oder Zusaetzlich.",
            "example": "Vorhanden"
          },
          "stuecke": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungsstueck"
            },
            "description": "Die einzeln geführten Stücke der Person."
          },
          "gezaehlt": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungsbestand"
            },
            "description": "Gezählte Kleidung der Person (ohne Lagerort)."
          }
        }
      },
      "Kleidungsbestand": {
        "type": "object",
        "description": "Gezählte Kleidung in einem Lagerort.",
        "properties": {
          "kleidungskategorieId": {
            "type": "integer",
            "description": "Nummer der Art.",
            "example": 10
          },
          "kleidungskategorie": {
            "type": "string",
            "description": "Art der Kleidung.",
            "example": "T-Shirt"
          },
          "groesse": {
            "type": "string",
            "description": "Größe.",
            "example": "L"
          },
          "lagerortId": {
            "type": "integer",
            "description": "Nummer des Lagerorts.",
            "example": 2
          },
          "lagerort": {
            "type": "string",
            "description": "Lagerort.",
            "example": "Kleiderkammer Gerätehaus"
          },
          "anzahl": {
            "type": "integer",
            "description": "Anzahl.",
            "example": 6
          }
        }
      },
      "Kleidungsausstattung": {
        "type": "object",
        "description": "Die Kleidung einer Person gegen ihre Soll-Ausstattung.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "istMitglied": {
            "type": "boolean",
            "description": "Hat eine laufende Mitgliedschaft.",
            "example": true
          },
          "sollsaetze": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Die Soll-Ausstattungen, die für die Person gelten.",
            "example": [
              "Einsatzdienst (Einsatzabteilung)"
            ]
          },
          "groessen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungsgroesse"
            },
            "description": "Die Größen der Person je Größensystem."
          },
          "kleidung": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Kleidungszeile"
            },
            "description": "Je Art der Kleidung: Soll, Ist und Stand mit den Stücken."
          }
        }
      },
      "Fahrzeug": {
        "type": "object",
        "description": "Ein Fahrzeug mit seinen Plätzen.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Fahrzeugs.",
            "example": 7
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "HLF 20"
          },
          "funkrufname": {
            "type": "string",
            "description": "Funkrufname.",
            "example": "Florian Musterstadt 1/46-1"
          },
          "kennzeichen": {
            "type": "string",
            "description": "Kennzeichen.",
            "example": "MU-FW 146"
          },
          "fahrzeugart": {
            "type": "string",
            "description": "Art des Fahrzeugs.",
            "example": "Hilfeleistungslöschgruppenfahrzeug"
          },
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit, zu der das Fahrzeug gehört.",
            "example": 12
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          },
          "sitzplaetze": {
            "type": "integer",
            "description": "Zahl der Sitzplätze.",
            "example": 9
          },
          "baujahr": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Baujahr.",
            "example": 2019
          },
          "istEinsatzbereit": {
            "type": "boolean",
            "description": "Einsatzbereit.",
            "example": true
          },
          "nichtEinsatzbereitWeil": {
            "type": "string",
            "description": "Grund, wenn nicht einsatzbereit.",
            "example": ""
          },
          "naechsteHauptuntersuchung": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Nächste Hauptuntersuchung.",
            "example": "2027-04-30"
          },
          "hauptuntersuchung": {
            "type": "string",
            "description": "OhneTermin, InOrdnung, BaldFaellig (innerhalb von 30 Tagen) oder Ueberfaellig.",
            "example": "InOrdnung"
          },
          "istAusgemustert": {
            "type": "boolean",
            "description": "Ausgemustert: bleibt in alten Einsätzen, wird nicht mehr angeboten.",
            "example": false
          },
          "plaetze": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Fahrzeugplatz"
            },
            "description": "Die Plätze in ihrer Reihenfolge."
          }
        }
      },
      "FahrtEingabe": {
        "type": "object",
        "description": "Eine Fahrt für das Fahrtenbuch.",
        "properties": {
          "beginn": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Beginn der Fahrt; ohne Angabe jetzt.",
            "example": "2026-11-16T18:30:00+01:00"
          },
          "fahrerPersonId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Person, die gefahren ist.",
            "example": 155
          },
          "fahrerName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name, wenn die Person nicht in der Personalliste steht. Eines von beiden ist nötig.",
            "example": "Werkstatt Müller"
          },
          "zweck": {
            "type": "string",
            "description": "Zweck der Fahrt.",
            "example": "Übung"
          },
          "kilometerstandBeginn": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Kilometerstand am Anfang; ohne Angabe das Ende der letzten Fahrt.",
            "example": 12336
          },
          "kilometerstandEnde": {
            "type": "integer",
            "description": "Kilometerstand am Ende.",
            "example": 12366
          },
          "getankteLiter": {
            "type": [
              "number",
              "null"
            ],
            "description": "Getankte Menge in Litern.",
            "example": "42,5"
          },
          "bemerkung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bemerkung.",
            "example": ""
          },
          "dienstId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Dienstes oder Einsatzes, zu dem die Fahrt gehört."
          }
        }
      },
      "Fahrt": {
        "type": "object",
        "description": "Eine Fahrt aus dem Fahrtenbuch eines Fahrzeugs.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer der Fahrt.",
            "example": 88
          },
          "fahrzeugId": {
            "type": "integer",
            "description": "Nummer des Fahrzeugs.",
            "example": 7
          },
          "fahrzeug": {
            "type": "string",
            "description": "Name des Fahrzeugs.",
            "example": "HLF 20"
          },
          "beginn": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn der Fahrt.",
            "example": "2026-11-16T18:30:00+01:00"
          },
          "fahrerPersonId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Person, die gefahren ist.",
            "example": 155
          },
          "fahrer": {
            "type": "string",
            "description": "Name der Person, die gefahren ist.",
            "example": "Braun, Mia"
          },
          "zweck": {
            "type": "string",
            "description": "Zweck der Fahrt.",
            "example": "Übung"
          },
          "kilometerstandBeginn": {
            "type": "integer",
            "description": "Kilometerstand am Anfang.",
            "example": 12336
          },
          "kilometerstandEnde": {
            "type": "integer",
            "description": "Kilometerstand am Ende.",
            "example": 12366
          },
          "kilometer": {
            "type": "integer",
            "description": "Gefahrene Kilometer.",
            "example": 30
          },
          "luecke": {
            "type": "integer",
            "description": "Kilometer, die vor dieser Fahrt im Buch fehlen; 0, wenn die Kette stimmt.",
            "example": 0
          },
          "getankteLiter": {
            "type": [
              "number",
              "null"
            ],
            "description": "Getankte Menge in Litern.",
            "example": "42,5"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          },
          "dienstId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Dienstes oder Einsatzes, zu dem die Fahrt gehört."
          }
        }
      },
      "Atemschutzeintrag": {
        "type": "object",
        "description": "Ein Eintrag des Atemschutz-Logbuchs: eine Person einmal unter Atemschutz.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Eintrags.",
            "example": 412
          },
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "person": {
            "type": "string",
            "description": "Name der Person.",
            "example": "Braun, Mia"
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Einheit der Person.",
            "example": "Löschzug Nord"
          },
          "datum": {
            "type": "string",
            "format": "date",
            "description": "Tag.",
            "example": "2026-11-12"
          },
          "art": {
            "type": "string",
            "description": "Einsatz, Uebung, Belastungsuebung, Unterweisung oder Sonstiges.",
            "example": "Einsatz"
          },
          "taetigkeit": {
            "type": "string",
            "description": "Was unter Atemschutz getan wurde, z. B. Brandbekaempfung, Menschenrettung, Sicherungstrupp; OhneAngabe, wenn nichts gewählt ist.",
            "example": "Brandbekaempfung"
          },
          "minuten": {
            "type": "integer",
            "description": "Minuten unter der Maske.",
            "example": 25
          },
          "geraetenummer": {
            "type": "string",
            "description": "Nummer des Geräts.",
            "example": "PA 07"
          },
          "maskennummer": {
            "type": "string",
            "description": "Nummer der Maske.",
            "example": "M 23"
          },
          "druckAmAnfang": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Flaschendruck am Anfang in bar.",
            "example": 300
          },
          "druckAmEnde": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Flaschendruck am Ende in bar.",
            "example": 90
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung."
          },
          "dienstId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Dienstes oder Einsatzes.",
            "example": 311
          },
          "dienst": {
            "type": [
              "string",
              "null"
            ],
            "description": "Titel des Dienstes oder Einsatzes.",
            "example": "B3 Wohnungsbrand"
          },
          "erfasstAm": {
            "type": "string",
            "format": "date-time",
            "description": "Wann der Eintrag erfasst wurde."
          },
          "bestaetigtAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann eine zweite Person bestätigt hat; leer, solange er offen ist."
          }
        }
      },
      "Atemschutztraeger": {
        "type": "object",
        "description": "Ein Atemschutzgeräteträger mit seiner Tauglichkeit.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer.",
            "example": "0011"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Einheit der Person.",
            "example": "Löschzug Nord"
          },
          "stand": {
            "type": "string",
            "description": "Gruen (tauglich), Gelb (läuft bald ab) oder Rot (nicht tauglich).",
            "example": "Gruen"
          },
          "tauglichBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Der letzte Tag, an dem alles noch gilt; leer bei Rot.",
            "example": "2027-03-14"
          },
          "grund": {
            "type": [
              "string",
              "null"
            ],
            "description": "Was fehlt oder bald abläuft."
          },
          "anforderungen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Atemschutzanforderung"
            },
            "description": "Jede Anforderung mit ihrem Stand."
          },
          "minutenImJahr": {
            "type": "integer",
            "description": "Minuten unter Atemschutz im laufenden Jahr.",
            "example": 140
          },
          "anzahlImJahr": {
            "type": "integer",
            "description": "Einsätze, Übungen und Belastungsübungen im laufenden Jahr.",
            "example": 6
          },
          "minutenInZwoelfMonaten": {
            "type": "integer",
            "description": "Minuten in den letzten zwölf Monaten.",
            "example": 180
          },
          "anzahlInZwoelfMonaten": {
            "type": "integer",
            "description": "Einsätze, Übungen und Belastungsübungen in den letzten zwölf Monaten.",
            "example": 8
          },
          "letzterEinsatz": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Letzter Einsatz unter Atemschutz."
          },
          "letzteUebung": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Letzte Übung unter Atemschutz."
          },
          "letzteBelastungsuebung": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Letzte Belastungsübung."
          }
        }
      },
      "Atemschutzanforderung": {
        "type": "object",
        "description": "Etwas, das ein Atemschutzgeräteträger braucht, um tauglich zu sein.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name der Anforderung: eine Art von Nachweis, oder der Einsatz bzw. die Übung unter Atemschutz.",
            "example": "Atemschutztauglichkeit (G26.3)"
          },
          "istErfuellt": {
            "type": "boolean",
            "description": "Heute erfüllt.",
            "example": true
          },
          "giltBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Der letzte Tag, an dem sie gilt.",
            "example": "2027-03-14"
          },
          "hinweis": {
            "type": "string",
            "description": "Stand in Worten.",
            "example": "gültig bis 14.03.2027"
          }
        }
      },
      "Material": {
        "type": "object",
        "description": "Ein Gerät aus dem Bestand.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Geräts.",
            "example": 42
          },
          "inventarnummer": {
            "type": "string",
            "description": "Inventarnummer, eindeutig je Feuerwehr.",
            "example": "SCH-0042"
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Druckschlauch B 75, 20 m"
          },
          "materialkategorieId": {
            "type": "integer",
            "description": "Nummer der Kategorie.",
            "example": 3
          },
          "materialkategorie": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Kategorie.",
            "example": "Schläuche"
          },
          "hersteller": {
            "type": "string",
            "description": "Hersteller."
          },
          "modell": {
            "type": "string",
            "description": "Modell."
          },
          "seriennummer": {
            "type": "string",
            "description": "Seriennummer."
          },
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit, zu der das Gerät gehört.",
            "example": 12
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          },
          "fahrzeugId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Fahrzeugs, auf dem es verlastet ist.",
            "example": 7
          },
          "fahrzeug": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Fahrzeugs.",
            "example": "HLF 20"
          },
          "lagerort": {
            "type": "string",
            "description": "Fach oder Lagerort.",
            "example": "G1"
          },
          "gekauftAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Kaufdatum."
          },
          "istEinsatzbereit": {
            "type": "boolean",
            "description": "Einsatzbereit.",
            "example": true
          },
          "nichtEinsatzbereitWeil": {
            "type": "string",
            "description": "Grund, wenn nicht einsatzbereit.",
            "example": ""
          },
          "istAusgesondert": {
            "type": "boolean",
            "description": "Ausgesondert: bleibt für die Historie, hat keine Prüfungen mehr.",
            "example": false
          },
          "naechstePruefung": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Die früheste fällige Prüfung.",
            "example": "2027-03-01"
          },
          "pruefstand": {
            "type": "string",
            "description": "OhnePlan, InOrdnung, BaldFaellig (innerhalb von 30 Tagen) oder Ueberfaellig.",
            "example": "InOrdnung"
          },
          "offeneMaengel": {
            "type": "integer",
            "description": "Zahl der offenen Mängel.",
            "example": 0
          },
          "kritischeMaengel": {
            "type": "integer",
            "description": "Davon kritisch.",
            "example": 0
          }
        }
      },
      "Materialakte": {
        "type": "object",
        "description": "Ein Gerät mit Prüfplänen, Prüfungen und Mängeln.",
        "properties": {
          "geraet": {
            "$ref": "#/components/schemas/Material"
          },
          "pruefplaene": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Materialpruefplan"
            },
            "description": "Welche Prüfung für das Gerät wann fällig ist."
          },
          "pruefungen": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Materialpruefung"
            },
            "description": "Die letzten 50 Prüfungen, neueste zuerst."
          },
          "maengel": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Materialmangel"
            },
            "description": "Alle Mängel, offene zuerst."
          }
        }
      },
      "Materialpruefplan": {
        "type": "object",
        "description": "Eine Prüfart, die für ein Gerät gilt, mit dem nächsten Termin.",
        "properties": {
          "pruefartId": {
            "type": "integer",
            "description": "Nummer der Prüfart.",
            "example": 2
          },
          "pruefart": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Prüfart.",
            "example": "Leitern: jährliche Sicht- und Belastungsprüfung"
          },
          "intervallInMonaten": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Abstand der Prüfungen in Monaten.",
            "example": 12
          },
          "naechstePruefung": {
            "type": "string",
            "format": "date",
            "description": "Der Tag, an dem sie fällig ist.",
            "example": "2027-03-01"
          }
        }
      },
      "Materialpruefung": {
        "type": "object",
        "description": "Eine durchgeführte Prüfung eines Geräts.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Prüfprotokolls.",
            "example": 311
          },
          "pruefart": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Prüfart."
          },
          "datum": {
            "type": "string",
            "format": "date",
            "description": "Tag der Prüfung.",
            "example": "2026-03-01"
          },
          "istBestanden": {
            "type": "boolean",
            "description": "Bestanden.",
            "example": true
          },
          "pruefer": {
            "type": "string",
            "description": "Wer geprüft hat.",
            "example": "Gerätewart"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung."
          },
          "istUnterschrieben": {
            "type": "boolean",
            "description": "Das Protokoll ist unterschrieben und damit unveränderlich.",
            "example": false
          },
          "istUnveraendert": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Nur bei unterschriebenen: die Prüfsumme passt noch zum Inhalt."
          }
        }
      },
      "Materialmangel": {
        "type": "object",
        "description": "Ein Mangel an einem Gerät.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Mangels.",
            "example": 9
          },
          "materialId": {
            "type": "integer",
            "description": "Nummer des Geräts.",
            "example": 42
          },
          "beschreibung": {
            "type": "string",
            "description": "Was nicht in Ordnung ist.",
            "example": "Dichtring an einer Kupplung fehlt"
          },
          "istKritisch": {
            "type": "boolean",
            "description": "Kritisch: das Gerät ist damit nicht einsatzbereit.",
            "example": false
          },
          "gemeldetAm": {
            "type": "string",
            "format": "date-time",
            "description": "Wann er gemeldet wurde."
          },
          "gemeldetVon": {
            "type": "string",
            "description": "Wer ihn gemeldet hat."
          },
          "behobenAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann er behoben wurde; leer, solange er offen ist."
          },
          "behebung": {
            "type": "string",
            "description": "Was getan wurde."
          }
        }
      },
      "MangelEingabe": {
        "type": "object",
        "description": "Ein Mangel, wie er gemeldet wird.",
        "properties": {
          "beschreibung": {
            "type": "string",
            "description": "Was nicht in Ordnung ist. Pflicht, höchstens 1000 Zeichen.",
            "example": "Dichtring an einer Kupplung fehlt"
          },
          "istKritisch": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Kritisch: das Gerät geht sofort außer Betrieb. Ohne Angabe nein.",
            "example": false
          }
        }
      },
      "Prueffaelligkeit": {
        "type": "object",
        "description": "Eine fällige Prüfung eines Geräts.",
        "properties": {
          "materialId": {
            "type": "integer",
            "description": "Nummer des Geräts.",
            "example": 42
          },
          "inventarnummer": {
            "type": "string",
            "description": "Inventarnummer.",
            "example": "SCH-0042"
          },
          "name": {
            "type": "string",
            "description": "Name des Geräts."
          },
          "materialkategorie": {
            "type": "string",
            "description": "Kategorie."
          },
          "ort": {
            "type": "string",
            "description": "Fahrzeug und Fach oder Lagerort."
          },
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit."
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit."
          },
          "pruefartId": {
            "type": "integer",
            "description": "Nummer der Prüfart."
          },
          "pruefart": {
            "type": "string",
            "description": "Name der Prüfart.",
            "example": "Schlauchprüfung nach Gebrauch und jährlich"
          },
          "naechstePruefung": {
            "type": "string",
            "format": "date",
            "description": "Der Tag, an dem sie fällig ist.",
            "example": "2026-12-01"
          },
          "stand": {
            "type": "string",
            "description": "InOrdnung, BaldFaellig oder Ueberfaellig.",
            "example": "BaldFaellig"
          }
        }
      },
      "Fahrzeugplatz": {
        "type": "object",
        "description": "Ein Platz auf einem Fahrzeug mit seiner Aufgabe.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Platzes.",
            "example": 31
          },
          "name": {
            "type": "string",
            "description": "Aufgabe des Platzes.",
            "example": "Maschinist"
          },
          "brauchtAtemschutz": {
            "type": "boolean",
            "description": "Der Platz verlangt Atemschutztauglichkeit.",
            "example": false
          },
          "brauchtFahrberechtigung": {
            "type": "boolean",
            "description": "Der Platz verlangt die Fahrberechtigung für das Fahrzeug.",
            "example": true
          }
        }
      },
      "Einsatzart": {
        "type": "object",
        "description": "Eine Einsatzart des Katalogs.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 1
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Brand"
          },
          "farbe": {
            "type": "string",
            "description": "Farbe als #rrggbb; leer ohne Farbe.",
            "example": "#d42a12"
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Reihenfolge.",
            "example": 1
          }
        }
      },
      "Stichwort": {
        "type": "object",
        "description": "Ein Alarmstichwort mit seiner Ausrückefolge.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 3
          },
          "kurzzeichen": {
            "type": "string",
            "description": "Kurzzeichen.",
            "example": "B3"
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Wohnungsbrand"
          },
          "einsatzartId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der üblichen Einsatzart.",
            "example": 1
          },
          "einsatzart": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der üblichen Einsatzart.",
            "example": "Brand"
          },
          "istAktiv": {
            "type": "boolean",
            "description": "Wird angeboten.",
            "example": true
          },
          "ausrueckefolge": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Ausrueckefolge"
            },
            "description": "Die Fahrzeuge in ihrer Reihenfolge."
          }
        }
      },
      "Objekt": {
        "type": "object",
        "description": "Ein Gebäude oder Gelände, das die Feuerwehr kennen muss.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Objekts in fwMAX.de.",
            "example": 12
          },
          "nummer": {
            "type": "string",
            "description": "Eigene Objektnummer der Feuerwehr.",
            "example": "O-017"
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Seniorenheim Am Park"
          },
          "art": {
            "type": "string",
            "description": "Art des Objekts.",
            "example": "Pflegeheim"
          },
          "strasse": {
            "type": "string",
            "description": "Straße.",
            "example": "Parkstraße"
          },
          "hausnummer": {
            "type": "string",
            "description": "Hausnummer.",
            "example": "12"
          },
          "postleitzahl": {
            "type": "string",
            "description": "Postleitzahl.",
            "example": "70000"
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "ortsteil": {
            "type": "string",
            "description": "Ortsteil.",
            "example": "Nord"
          },
          "breitengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Breitengrad in Grad (WGS 84).",
            "example": "48,7758"
          },
          "laengengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Längengrad in Grad (WGS 84).",
            "example": "9,1829"
          },
          "organisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der zuständigen Einheit; leer = die ganze Feuerwehr.",
            "example": 12
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          },
          "brandmeldeanlagennummer": {
            "type": "string",
            "description": "Nummer der Brandmeldeanlage; leer = keine.",
            "example": "BMA 4711"
          },
          "brandmeldezentrale": {
            "type": "string",
            "description": "Wo Zentrale, Anzeigetableau und Laufkarten sind.",
            "example": "Haupteingang links"
          },
          "schluesseldepot": {
            "type": "string",
            "description": "Wo das Schlüsseldepot ist.",
            "example": "rechts neben dem Haupteingang"
          },
          "gefahren": {
            "type": "string",
            "description": "Gefahren in Worten.",
            "example": "Sauerstofflager im Keller"
          },
          "gefahrenmarken": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Die angekreuzten Gefahren.",
            "example": "Gefahrstoffe"
          },
          "anfahrt": {
            "type": "string",
            "description": "Anfahrt.",
            "example": "über die Parkstraße"
          },
          "aufstellflaeche": {
            "type": "string",
            "description": "Aufstellfläche.",
            "example": "Innenhof, Drehleiter an der Südseite"
          },
          "sammelplatz": {
            "type": "string",
            "description": "Sammelplatz.",
            "example": "Parkplatz Nord"
          },
          "wasserversorgung": {
            "type": "string",
            "description": "Löschwasserversorgung.",
            "example": "Überflurhydrant am Haupteingang"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          },
          "zuletztGeprueftAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Letzte Durchsicht der Angaben.",
            "example": "2026-03-01"
          },
          "naechstePruefungAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Nächste Durchsicht.",
            "example": "2027-03-01"
          },
          "pruefung": {
            "type": "string",
            "description": "OhneTermin, InOrdnung, BaldFaellig oder Ueberfaellig.",
            "example": "InOrdnung"
          },
          "kontakte": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Objektkontakt"
            },
            "description": "Ansprechpartner in ihrer Reihenfolge."
          }
        }
      },
      "Objektkontakt": {
        "type": "object",
        "description": "Ein Ansprechpartner eines Objekts.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Herr Maier"
          },
          "rolle": {
            "type": "string",
            "description": "Was die Person für das Objekt ist.",
            "example": "Hausmeister"
          },
          "telefon": {
            "type": "string",
            "description": "Telefonnummer.",
            "example": "0711 123456"
          },
          "erreichbarkeit": {
            "type": "string",
            "description": "Immer, Tagsueber oder Nachts.",
            "example": "Immer"
          }
        }
      },
      "Adressbucheintrag": {
        "type": "object",
        "description": "Ein Kontakt des Adressbuchs: eine Organisation, eine Person oder beides.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer in fwMAX.de.",
            "example": 41
          },
          "organisation": {
            "type": "string",
            "description": "Name der Organisation.",
            "example": "Stadtwerke Musterstadt"
          },
          "anrede": {
            "type": "string",
            "description": "Anrede.",
            "example": "Herr"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Jonas"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Albrecht"
          },
          "rolle": {
            "type": "string",
            "description": "Was die Person dort ist.",
            "example": "Bereitschaftsdienst Wasser"
          },
          "kategorieId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Kategorie.",
            "example": 3
          },
          "kategorie": {
            "type": "string",
            "description": "Name der Kategorie.",
            "example": "Versorger"
          },
          "telefone": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Adressbuchtelefon"
            },
            "description": "Alle Telefonnummern in ihrer Reihenfolge."
          },
          "eMailAdresse": {
            "type": "string",
            "description": "E-Mail-Adresse.",
            "example": "bereitschaft@stadtwerke.example"
          },
          "strasse": {
            "type": "string",
            "description": "Straße und Hausnummer.",
            "example": "Wasserweg 3"
          },
          "postleitzahl": {
            "type": "string",
            "description": "Postleitzahl.",
            "example": "12345"
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "land": {
            "type": "string",
            "description": "Land.",
            "example": ""
          },
          "webadresse": {
            "type": "string",
            "description": "Webadresse.",
            "example": "https://stadtwerke.example"
          },
          "notiz": {
            "type": "string",
            "description": "Notiz.",
            "example": "Nachts über die Leitstelle"
          },
          "istFavorit": {
            "type": "boolean",
            "description": "Als Favorit markiert.",
            "example": true
          },
          "organisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Einheit, zu der der Kontakt gehört; leer = gesamte Feuerwehr."
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Gesamte Feuerwehr"
          }
        }
      },
      "Adressbuchtelefon": {
        "type": "object",
        "description": "Eine Telefonnummer eines Kontakts.",
        "properties": {
          "bezeichnung": {
            "type": "string",
            "description": "Wofür die Nummer ist.",
            "example": "Bereitschaft"
          },
          "nummer": {
            "type": "string",
            "description": "Die Nummer, wie sie eingetragen ist.",
            "example": "0711 123456"
          }
        }
      },
      "Wasserentnahmestelle": {
        "type": "object",
        "description": "Ein Hydrant, ein offenes Gewässer, eine Zisterne oder ein Brunnen.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer in fwMAX.de.",
            "example": 301
          },
          "nummer": {
            "type": "string",
            "description": "Nummer des Versorgers oder der Feuerwehr.",
            "example": "H-0412"
          },
          "art": {
            "type": "string",
            "description": "Unterflurhydrant, Ueberflurhydrant, OffenesGewaesser, Zisterne, Brunnen oder Saugstelle.",
            "example": "Unterflurhydrant"
          },
          "bezeichnung": {
            "type": "string",
            "description": "Bezeichnung.",
            "example": ""
          },
          "strasse": {
            "type": "string",
            "description": "Straße.",
            "example": "Parkstraße"
          },
          "hausnummer": {
            "type": "string",
            "description": "Hausnummer.",
            "example": "12"
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "lagebeschreibung": {
            "type": "string",
            "description": "Wie man sie findet.",
            "example": "im Gehweg vor der Bäckerei"
          },
          "breitengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Breitengrad in Grad (WGS 84).",
            "example": "48,7758"
          },
          "laengengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Längengrad in Grad (WGS 84).",
            "example": "9,1829"
          },
          "nennweite": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nennweite in Millimetern.",
            "example": 100
          },
          "leitung": {
            "type": "string",
            "description": "Leitung.",
            "example": "DN 150"
          },
          "durchfluss": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Liter je Minute.",
            "example": 1600
          },
          "druck": {
            "type": [
              "number",
              "null"
            ],
            "description": "Druck in bar.",
            "example": "4,5"
          },
          "zustand": {
            "type": "string",
            "description": "InOrdnung, Defekt oder NichtAuffindbar.",
            "example": "InOrdnung"
          },
          "zuletztGeprueftAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Letzte Prüfung.",
            "example": "2026-04-12"
          },
          "naechstePruefungAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Nächste Prüfung.",
            "example": "2027-04-12"
          },
          "pruefung": {
            "type": "string",
            "description": "OhneTermin, InOrdnung, BaldFaellig oder Ueberfaellig.",
            "example": "InOrdnung"
          },
          "organisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der zuständigen Einheit.",
            "example": 12
          },
          "organisationseinheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          }
        }
      },
      "Ausrueckefolge": {
        "type": "object",
        "description": "Ein Fahrzeug in der Ausrückefolge eines Stichworts.",
        "properties": {
          "fahrzeugId": {
            "type": "integer",
            "description": "Nummer des Fahrzeugs.",
            "example": 7
          },
          "fahrzeug": {
            "type": "string",
            "description": "Name des Fahrzeugs.",
            "example": "HLF 20"
          },
          "giltAmTag": {
            "type": "boolean",
            "description": "Rückt von 6 bis 18 Uhr aus.",
            "example": true
          },
          "giltInDerNacht": {
            "type": "boolean",
            "description": "Rückt vor 6 und ab 18 Uhr aus.",
            "example": true
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Platz in der Reihenfolge.",
            "example": 1
          }
        }
      },
      "Einsatzstatistik": {
        "type": "object",
        "description": "Die Einsätze eines Jahres in Zahlen, ohne Namen.",
        "properties": {
          "jahr": {
            "type": "integer",
            "description": "Das Jahr.",
            "example": 2026
          },
          "anzahl": {
            "type": "integer",
            "description": "Zahl der Einsätze.",
            "example": 42
          },
          "stunden": {
            "type": "number",
            "description": "Dauer aller Einsätze in Stunden.",
            "example": "61,5"
          },
          "personenstunden": {
            "type": "number",
            "description": "Stunden aller Einsatzkräfte zusammen.",
            "example": "540,25"
          },
          "amTag": {
            "type": "integer",
            "description": "Einsätze mit Alarm zwischen 6 und 18 Uhr.",
            "example": 27
          },
          "inDerNacht": {
            "type": "integer",
            "description": "Einsätze mit Alarm zwischen 18 und 6 Uhr.",
            "example": 15
          },
          "fehlalarme": {
            "type": "integer",
            "description": "Fehlalarme.",
            "example": 6
          },
          "vorjahr": {
            "$ref": "#/components/schemas/Einsatzsumme"
          },
          "nachEinsatzart": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EinsatzstatistikArt"
            },
            "description": "Je Einsatzart, häufigste zuerst."
          },
          "nachMonat": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EinsatzstatistikMonat"
            },
            "description": "Je Monat, Januar bis Dezember."
          }
        }
      },
      "Einsatzsumme": {
        "type": "object",
        "description": "Einsätze eines Zeitraums in drei Zahlen.",
        "properties": {
          "anzahl": {
            "type": "integer",
            "description": "Zahl der Einsätze.",
            "example": 38
          },
          "stunden": {
            "type": "number",
            "description": "Dauer aller Einsätze in Stunden.",
            "example": "55"
          },
          "personenstunden": {
            "type": "number",
            "description": "Stunden aller Einsatzkräfte zusammen.",
            "example": "498,5"
          }
        }
      },
      "EinsatzstatistikArt": {
        "type": "object",
        "description": "Die Einsätze einer Einsatzart.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name der Einsatzart.",
            "example": "Technische Hilfe"
          },
          "farbe": {
            "type": "string",
            "description": "Farbe der Einsatzart, #rrggbb oder leer.",
            "example": "#2563eb"
          },
          "anzahl": {
            "type": "integer",
            "description": "Zahl der Einsätze.",
            "example": 19
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden.",
            "example": "24,75"
          }
        }
      },
      "EinsatzstatistikMonat": {
        "type": "object",
        "description": "Die Einsätze eines Monats.",
        "properties": {
          "monat": {
            "type": "integer",
            "description": "Monat, 1 bis 12.",
            "example": 3
          },
          "anzahl": {
            "type": "integer",
            "description": "Zahl der Einsätze.",
            "example": 5
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden.",
            "example": "7,5"
          }
        }
      },
      "Dienstgrad": {
        "type": "object",
        "description": "Ein Dienstgrad des Katalogs.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 4
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Oberfeuerwehrmann/-frau"
          },
          "kurzname": {
            "type": "string",
            "description": "Kurzname.",
            "example": "OFM"
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Rangfolge; höher ist höher.",
            "example": 4
          },
          "istJugend": {
            "type": "boolean",
            "description": "Dienstgrad der Jugendfeuerwehr.",
            "example": false
          }
        }
      },
      "Funktion": {
        "type": "object",
        "description": "Eine Funktion des Katalogs.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 3
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Zugführer/in"
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Reihenfolge.",
            "example": 3
          },
          "istFuehrungsfunktion": {
            "type": "boolean",
            "description": "Führungsfunktion.",
            "example": true
          }
        }
      },
      "Nachweisart": {
        "type": "object",
        "description": "Eine Art von Nachweis.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 10
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Atemschutztauglichkeit (G26.3)"
          },
          "kurzname": {
            "type": "string",
            "description": "Kurzname.",
            "example": "G26.3"
          },
          "kategorie": {
            "type": "string",
            "description": "Lehrgang, Untersuchung, Unterweisung, Fuehrerschein, Abzeichen oder Ehrung.",
            "example": "Untersuchung"
          },
          "gueltigkeitInMonaten": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Wie lange ein Nachweis gilt; leer = unbefristet.",
            "example": 36
          },
          "istFuerAtemschutzErforderlich": {
            "type": "boolean",
            "description": "Ohne gültigen Nachweis dieser Art nicht atemschutztauglich.",
            "example": true
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Reihenfolge.",
            "example": 10
          }
        }
      },
      "Mitgliedschaftsart": {
        "type": "object",
        "description": "Eine Art von Mitgliedschaft.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 1
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Einsatzabteilung"
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Reihenfolge.",
            "example": 1
          },
          "zaehltFuerDienstjahre": {
            "type": "boolean",
            "description": "Zeit zählt als Dienstzeit.",
            "example": true
          },
          "istEinsatzfaehig": {
            "type": "boolean",
            "description": "Mitglieder gehen in den Einsatz.",
            "example": true
          },
          "istJugend": {
            "type": "boolean",
            "description": "Jugend- oder Kinderfeuerwehr.",
            "example": false
          }
        }
      },
      "EinsatzEingabe": {
        "type": "object",
        "description": "Ein Einsatz, wie ihn Leitstelle oder Alarmserver melden.",
        "properties": {
          "stichwort": {
            "type": "string",
            "description": "Einsatzstichwort. Pflicht. Passt es zu einem Stichwort des Katalogs, wird es zugeordnet.",
            "example": "B3 Wohnungsbrand"
          },
          "leitstellennummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nummer des Einsatzes bei der Leitstelle. Dieselbe Nummer im selben Jahr legt keinen zweiten Einsatz an.",
            "example": "LST-2026-004711"
          },
          "beginn": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Alarmzeit; ohne Angabe jetzt.",
            "example": "2026-11-16T12:31:00+01:00"
          },
          "ende": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Einsatzende, wenn schon bekannt."
          },
          "text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Freitext der Meldung; kommt in die Notizen.",
            "example": "Rauch aus Fenster im 2. OG"
          },
          "strasse": {
            "type": [
              "string",
              "null"
            ],
            "description": "Straße.",
            "example": "Hauptstraße"
          },
          "hausnummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Hausnummer.",
            "example": "12"
          },
          "postleitzahl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postleitzahl.",
            "example": "70000"
          },
          "ort": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "ortsteil": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ortsteil."
          },
          "objekt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Objekts.",
            "example": "Seniorenheim Am Park"
          },
          "breitengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Breite in Grad."
          },
          "laengengrad": {
            "type": [
              "number",
              "null"
            ],
            "description": "Länge in Grad."
          },
          "organisationseinheitId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Die Einheit im Einsatz; ohne Angabe die erste Einheit, für die der Schlüssel Einsätze schreiben darf.",
            "example": 12
          },
          "fahrzeuge": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/EinsatzfahrzeugEingabe"
            },
            "description": "Alarmierte Fahrzeuge mit ihren Statuszeiten."
          }
        }
      },
      "EinsatzfahrzeugEingabe": {
        "type": "object",
        "description": "Ein Fahrzeug im gemeldeten Einsatz.",
        "properties": {
          "funkrufname": {
            "type": "string",
            "description": "Funkrufname, ersatzweise Name oder Kennzeichen des Fahrzeugs.",
            "example": "Florian Musterstadt 1/44-1"
          },
          "ausgeruecktAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 3; ohne Angabe der Beginn des Einsatzes."
          },
          "amEinsatzortAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 4."
          },
          "freiAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 1."
          },
          "zurueckAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 2."
          }
        }
      },
      "Einsatz": {
        "type": "object",
        "description": "Ein Einsatz. In der Fassung für die Homepage (oeffentlich=true) fehlen alle Felder mit Namen, die Notizen, der Verursacher, die Zeiten der Fahrzeuge und die Lagemeldungen; die Kräfte stehen dann nur als Anzahl da und „bericht“ ist der gekürzte Bericht.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Datensatzes.",
            "example": 311
          },
          "nummer": {
            "type": "string",
            "description": "Einsatznummer, laufend je Feuerwehr und Jahr.",
            "example": "17/2026"
          },
          "leitstellennummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nummer bei der Leitstelle.",
            "example": "LST-2026-004711"
          },
          "stichwort": {
            "type": "string",
            "description": "Einsatzstichwort.",
            "example": "B3 Wohnungsbrand"
          },
          "einsatzart": {
            "type": [
              "string",
              "null"
            ],
            "description": "Art des Einsatzes für die Statistik.",
            "example": "Brand"
          },
          "beginn": {
            "type": "string",
            "format": "date-time",
            "description": "Alarmzeit.",
            "example": "2026-11-16T12:31:00+01:00"
          },
          "ende": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Einsatzende."
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden, auf Viertelstunden gerundet."
          },
          "personenstunden": {
            "type": [
              "number",
              "null"
            ],
            "description": "Stunden aller Kräfte zusammen."
          },
          "einheit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Die Einheit im Einsatz.",
            "example": "Löschzug Nord"
          },
          "strasse": {
            "type": "string",
            "description": "Straße."
          },
          "hausnummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Hausnummer."
          },
          "postleitzahl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postleitzahl."
          },
          "ort": {
            "type": "string",
            "description": "Ort."
          },
          "ortsteil": {
            "type": "string",
            "description": "Ortsteil."
          },
          "objekt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name des Objekts."
          },
          "einsatzleitung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Einsatzleitung."
          },
          "lageBeiEintreffen": {
            "type": [
              "string",
              "null"
            ],
            "description": "Lage bei Eintreffen."
          },
          "massnahmen": {
            "type": [
              "string",
              "null"
            ],
            "description": "Durchgeführte Maßnahmen."
          },
          "bericht": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nur in der Fassung für die Homepage: Lage und Maßnahmen, auf 400 Zeichen an einem Wort gekürzt; leer, solange der Bericht nicht abgeschlossen ist."
          },
          "istBrandmeldeanlage": {
            "type": "boolean",
            "description": "Auslösung durch eine Brandmeldeanlage.",
            "example": false
          },
          "istFehlalarm": {
            "type": "boolean",
            "description": "Fehlalarm.",
            "example": false
          },
          "weitereKraefte": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Weitere Kräfte an der Einsatzstelle."
          },
          "abgeschlossenAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Wann der Bericht abgeschlossen wurde; leer, solange er offen ist."
          },
          "fahrzeuge": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Einsatzfahrzeug"
            },
            "description": "Die Fahrzeuge im Einsatz."
          },
          "lagemeldungen": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Lagemeldung"
            },
            "description": "Die Lagemeldungen in zeitlicher Folge."
          }
        }
      },
      "Einsatzfahrzeug": {
        "type": "object",
        "description": "Ein Fahrzeug in einem Einsatz mit seinen Statuszeiten.",
        "properties": {
          "fahrzeugId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Fahrzeugs.",
            "example": 7
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "HLF 20"
          },
          "funkrufname": {
            "type": "string",
            "description": "Funkrufname.",
            "example": "Florian Musterstadt 1/44-1"
          },
          "ausgeruecktAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 3."
          },
          "amEinsatzortAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 4."
          },
          "freiAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 1."
          },
          "zurueckAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Status 2."
          },
          "anfahrtInMinuten": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Minuten von Status 3 bis Status 4.",
            "example": 6
          },
          "stunden": {
            "type": [
              "number",
              "null"
            ],
            "description": "Stunden von Status 3 bis Status 2."
          },
          "kilometer": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Gefahrene Kilometer."
          }
        }
      },
      "Lagemeldung": {
        "type": "object",
        "description": "Eine Lagemeldung während eines Einsatzes.",
        "properties": {
          "zeitpunkt": {
            "type": "string",
            "format": "date-time",
            "description": "Wann.",
            "example": "2026-11-16T12:44:00+01:00"
          },
          "von": {
            "type": "string",
            "description": "Von wem.",
            "example": "Florian Musterstadt 1/44-1"
          },
          "an": {
            "type": "string",
            "description": "An wen.",
            "example": "Leitstelle"
          },
          "text": {
            "type": "string",
            "description": "Die Meldung.",
            "example": "Feuer in Gewalt, eine Person gerettet."
          }
        }
      },
      "Fe2Alarm": {
        "type": "object",
        "description": "Ein Alarm, wie Alamos FE2 ihn sendet. Die Felder dürfen oben, unter „data“ oder unter „parameters“ stehen; Groß- und Kleinschreibung zählt nicht.",
        "properties": {
          "keyword": {
            "type": "string",
            "description": "Stichwort. Pflicht.",
            "example": "B3"
          },
          "keyword_description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Text zum Stichwort; wird angehängt.",
            "example": "Wohnungsbrand"
          },
          "einsatznummer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Externe Einsatznummer; auch als externalId, operationNumber, alarmnummer, dbId oder id. Schützt vor Dubletten.",
            "example": "LST-2026-004711"
          },
          "timestamp": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alarmzeit als Millisekunden seit 1970 oder nach ISO 8601; ohne Angabe jetzt.",
            "example": "2026-11-16T12:31:00+01:00"
          },
          "message": {
            "type": [
              "string",
              "null"
            ],
            "description": "Meldetext; auch als Liste von Zeilen. Kommt in die Notizen.",
            "example": "Rauch aus Fenster im 2. OG"
          },
          "street": {
            "type": [
              "string",
              "null"
            ],
            "description": "Straße.",
            "example": "Hauptstraße"
          },
          "house": {
            "type": [
              "string",
              "null"
            ],
            "description": "Hausnummer.",
            "example": "12"
          },
          "postalCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Postleitzahl.",
            "example": "70000"
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ort.",
            "example": "Musterstadt"
          },
          "city_abbr": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ortsteil.",
            "example": "Nord"
          },
          "building": {
            "type": [
              "string",
              "null"
            ],
            "description": "Objekt.",
            "example": "Seniorenheim Am Park"
          },
          "lat": {
            "type": [
              "number",
              "null"
            ],
            "description": "Breite in Grad.",
            "example": "48,7758"
          },
          "lng": {
            "type": [
              "number",
              "null"
            ],
            "description": "Länge in Grad.",
            "example": "9,1829"
          },
          "vehicles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Alarmierte Fahrzeuge als Funkrufnamen oder Objekte mit „name“; fremde Fahrzeuge werden übergangen.",
            "example": [
              "Florian Musterstadt 1/44-1"
            ]
          }
        }
      },
      "Fe2Ergebnis": {
        "type": "object",
        "description": "Antwort auf einen Alarm von FE2.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Einsatzes.",
            "example": 311
          },
          "nummer": {
            "type": "string",
            "description": "Einsatznummer.",
            "example": "17/2026"
          },
          "leitstellennummer": {
            "type": "string",
            "description": "Die externe Nummer.",
            "example": "LST-2026-004711"
          },
          "neu": {
            "type": "boolean",
            "description": "Wahr, wenn der Einsatz neu angelegt wurde; falsch bei einer Dublette.",
            "example": true
          },
          "stichwort": {
            "type": "string",
            "description": "Stichwort.",
            "example": "B3 Wohnungsbrand"
          }
        }
      },
      "Dienst": {
        "type": "object",
        "description": "Ein Dienst oder Termin.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 812
          },
          "art": {
            "type": "string",
            "description": "Uebung, SonstigerDienst, Veranstaltung oder Sitzung.",
            "example": "Uebung"
          },
          "artName": {
            "type": "string",
            "description": "Art in Worten.",
            "example": "Übung"
          },
          "titel": {
            "type": "string",
            "description": "Titel.",
            "example": "Atemschutzübung"
          },
          "beginn": {
            "type": "string",
            "format": "date-time",
            "description": "Beginn.",
            "example": "2026-11-20T19:00:00+01:00"
          },
          "ende": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Ende."
          },
          "istGanztaegig": {
            "type": "boolean",
            "description": "Ganztägig.",
            "example": false
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Gerätehaus"
          },
          "beschreibung": {
            "type": "string",
            "description": "Beschreibung.",
            "example": ""
          },
          "organisationseinheitId": {
            "type": "integer",
            "description": "Nummer der Einheit.",
            "example": 12
          },
          "einheit": {
            "type": "string",
            "description": "Name der Einheit.",
            "example": "Löschzug Nord"
          },
          "mitUntergeordnetenEinheiten": {
            "type": "boolean",
            "description": "Gilt auch für die Einheiten darunter.",
            "example": true
          },
          "mitRueckmeldung": {
            "type": "boolean",
            "description": "Zu- und Absage erwünscht.",
            "example": true
          },
          "anmeldeschluss": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Bis wann zugesagt werden kann."
          },
          "plaetze": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Plätze; leer = unbegrenzt.",
            "example": 12
          },
          "mitAtemschutz": {
            "type": "boolean",
            "description": "Übung unter Atemschutz.",
            "example": true
          },
          "istAbgesagt": {
            "type": "boolean",
            "description": "Abgesagt.",
            "example": false
          },
          "absagegrund": {
            "type": "string",
            "description": "Grund der Absage.",
            "example": ""
          },
          "stunden": {
            "type": "number",
            "description": "Dauer in Stunden.",
            "example": "2,5"
          },
          "zaehltFuerStatistik": {
            "type": "boolean",
            "description": "Zählt für die Dienststatistik.",
            "example": true
          },
          "dienstserieId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Serie, wenn der Dienst zu einer gehört."
          },
          "zaehler": {
            "$ref": "#/components/schemas/Dienstzaehler"
          }
        }
      },
      "Dienstzaehler": {
        "type": "object",
        "description": "Zähler eines Dienstes.",
        "properties": {
          "gemeint": {
            "type": "integer",
            "description": "Für wie viele Personen der Dienst gedacht ist.",
            "example": 24
          },
          "zusagen": {
            "type": "integer",
            "description": "Zusagen.",
            "example": 15
          },
          "absagen": {
            "type": "integer",
            "description": "Absagen.",
            "example": 3
          },
          "offen": {
            "type": "integer",
            "description": "Ohne Antwort.",
            "example": 6
          },
          "anwesend": {
            "type": "integer",
            "description": "Anwesend.",
            "example": 14
          },
          "gaeste": {
            "type": "integer",
            "description": "Gäste.",
            "example": 1
          },
          "aufWarteliste": {
            "type": "integer",
            "description": "Auf der Warteliste.",
            "example": 0
          }
        }
      },
      "Dienstakte": {
        "type": "object",
        "description": "Ein Dienst mit allem, was dazugehört.",
        "properties": {
          "dienst": {
            "$ref": "#/components/schemas/Dienst"
          },
          "leitung": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name der Leitung; nur mit „Personal ansehen“.",
            "example": "Mia Braun"
          },
          "zielFunktion": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nur für Personen mit dieser Funktion."
          },
          "zielMitgliedschaftsart": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nur für diese Mitgliedschaftsart."
          },
          "bericht": {
            "type": "string",
            "description": "Bericht zum Dienst.",
            "example": ""
          },
          "teilnehmer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Dienstteilnehmer"
            },
            "description": "Die Personen; leer ohne „Personal ansehen“."
          }
        }
      },
      "Dienstteilnehmer": {
        "type": "object",
        "description": "Eine Person bei einem Dienst.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "einheit": {
            "type": "string",
            "description": "Einheit der Person am Tag des Dienstes.",
            "example": "Löschzug Nord"
          },
          "istGemeint": {
            "type": "boolean",
            "description": "Der Dienst ist für sie gedacht.",
            "example": true
          },
          "antwort": {
            "type": "string",
            "description": "Offen, Zusage oder Absage.",
            "example": "Zusage"
          },
          "aufWarteliste": {
            "type": "boolean",
            "description": "Zusage über die Plätze hinaus.",
            "example": false
          },
          "istAnwesend": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Anwesend; leer, solange nicht erfasst.",
            "example": true
          },
          "istEntschuldigt": {
            "type": "boolean",
            "description": "Entschuldigt.",
            "example": false
          },
          "fahrzeug": {
            "type": [
              "string",
              "null"
            ],
            "description": "Eingeteilt auf dieses Fahrzeug.",
            "example": "HLF 20"
          },
          "platz": {
            "type": [
              "string",
              "null"
            ],
            "description": "Platz auf dem Fahrzeug.",
            "example": "Maschinist"
          }
        }
      },
      "Lehrgang": {
        "type": "object",
        "description": "Ein Lehrgangstermin.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 21
          },
          "nachweisartId": {
            "type": "integer",
            "description": "Nummer der Nachweisart, die der Lehrgang bringt.",
            "example": 3
          },
          "nachweisart": {
            "type": "string",
            "description": "Name.",
            "example": "Truppmann Teil 1"
          },
          "beginn": {
            "type": "string",
            "format": "date",
            "description": "Erster Tag.",
            "example": "2027-02-06"
          },
          "ende": {
            "type": "string",
            "format": "date",
            "description": "Letzter Tag.",
            "example": "2027-03-20"
          },
          "ort": {
            "type": "string",
            "description": "Ort.",
            "example": "Kreisausbildungszentrum"
          },
          "veranstalter": {
            "type": "string",
            "description": "Veranstalter.",
            "example": "Kreisfeuerwehrverband"
          },
          "ebene": {
            "type": "string",
            "description": "Ebene des Lehrgangs.",
            "example": "Kreis"
          },
          "status": {
            "type": "string",
            "description": "Stand des Termins.",
            "example": "Geplant"
          },
          "plaetze": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Plätze; leer = unbegrenzt.",
            "example": 20
          },
          "belegt": {
            "type": "integer",
            "description": "Belegte Plätze.",
            "example": 14
          },
          "aufWarteliste": {
            "type": "integer",
            "description": "Auf der Warteliste.",
            "example": 2
          },
          "vorgemerkt": {
            "type": "integer",
            "description": "Vorgemerkt.",
            "example": 1
          },
          "anmeldeschluss": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Anmeldeschluss.",
            "example": "2027-01-15"
          },
          "stunden": {
            "type": [
              "number",
              "null"
            ],
            "description": "Umfang in Stunden.",
            "example": 70
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          }
        }
      },
      "Lehrgangsakte": {
        "type": "object",
        "description": "Ein Lehrgangstermin mit seinen Teilnehmern.",
        "properties": {
          "lehrgang": {
            "$ref": "#/components/schemas/Lehrgang"
          },
          "teilnehmer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Lehrgangsteilnehmer"
            },
            "description": "Die Teilnehmer, die der Schlüssel sehen darf."
          }
        }
      },
      "Lehrgangsteilnehmer": {
        "type": "object",
        "description": "Eine Person bei einem Lehrgang.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "status": {
            "type": "string",
            "description": "Stand der Teilnahme, z. B. Vorgemerkt, Gemeldet, Zugesagt, Warteliste oder Teilgenommen.",
            "example": "Zugesagt"
          },
          "ergebnis": {
            "type": "string",
            "description": "Ergebnis.",
            "example": "Offen"
          },
          "gemeldetAm": {
            "type": "string",
            "format": "date",
            "description": "Gemeldet am.",
            "example": "2026-11-02"
          },
          "nachweisId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Der Nachweis, der aus dem Lehrgang entstand."
          },
          "fehlendeVoraussetzungen": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Was der Person für den Lehrgang fehlt.",
            "example": [
              "Grundausbildung"
            ]
          },
          "hatSchonGueltig": {
            "type": "boolean",
            "description": "Hat den Nachweis schon gültig.",
            "example": false
          }
        }
      },
      "Nachweiszeile": {
        "type": "object",
        "description": "Ein Nachweis einer Person.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer des Nachweises.",
            "example": 901
          },
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "personalnummer": {
            "type": "string",
            "description": "Personalnummer.",
            "example": "0155"
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "nachweisartId": {
            "type": "integer",
            "description": "Nummer der Nachweisart.",
            "example": 10
          },
          "nachweisart": {
            "type": "string",
            "description": "Name der Nachweisart.",
            "example": "Leistungsabzeichen Bronze"
          },
          "kategorie": {
            "type": "string",
            "description": "Kategorie.",
            "example": "Abzeichen"
          },
          "erworbenAm": {
            "type": "string",
            "format": "date",
            "description": "Erworben am.",
            "example": "2025-06-14"
          },
          "gueltigBis": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Gültig bis; leer = unbefristet."
          },
          "ausgestelltVon": {
            "type": "string",
            "description": "Ausgestellt von.",
            "example": "Kreisfeuerwehrverband"
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          },
          "stand": {
            "type": "string",
            "description": "Stand des Nachweises am heutigen Tag.",
            "example": "Gueltig"
          }
        }
      },
      "Ehrungsvorschlag": {
        "type": "object",
        "description": "Ein Vorschlag für eine Ehrung oder Beförderung.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 44
          },
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "ziel": {
            "type": "string",
            "description": "Ehrung oder Dienstgrad.",
            "example": "Ehrenzeichen in Silber (25 Jahre)"
          },
          "istBefoerderung": {
            "type": "boolean",
            "description": "Ziel ist ein Dienstgrad.",
            "example": false
          },
          "nachweisartId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer der Ehrung (Nachweisart)."
          },
          "dienstgradId": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Nummer des Dienstgrads."
          },
          "regel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Die Regel, aus der der Vorschlag kam."
          },
          "faelligAm": {
            "type": "string",
            "format": "date",
            "description": "Fällig am.",
            "example": "2026-12-01"
          },
          "status": {
            "type": "string",
            "description": "Stand des Vorschlags.",
            "example": "Vorgeschlagen"
          },
          "verleihungAm": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Verliehen am."
          },
          "verliehenDurch": {
            "type": "string",
            "description": "Verliehen durch.",
            "example": ""
          },
          "bemerkung": {
            "type": "string",
            "description": "Bemerkung.",
            "example": ""
          }
        }
      },
      "Ehrungsfaelligkeit": {
        "type": "object",
        "description": "Eine Ehrung oder Beförderung, die nach den Regeln fällig ist.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "vorname": {
            "type": "string",
            "description": "Vorname.",
            "example": "Mia"
          },
          "nachname": {
            "type": "string",
            "description": "Nachname.",
            "example": "Braun"
          },
          "regelId": {
            "type": "integer",
            "description": "Nummer der Regel.",
            "example": 4
          },
          "regel": {
            "type": "string",
            "description": "Name der Regel.",
            "example": "25 Jahre aktiver Dienst"
          },
          "ziel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Ehrung oder Dienstgrad."
          },
          "istBefoerderung": {
            "type": "boolean",
            "description": "Ziel ist ein Dienstgrad.",
            "example": false
          },
          "faelligAm": {
            "type": "string",
            "format": "date",
            "description": "Fällig am.",
            "example": "2026-12-01"
          },
          "istUeberfaellig": {
            "type": "boolean",
            "description": "Schon überfällig.",
            "example": false
          },
          "begruendung": {
            "type": "string",
            "description": "Warum fällig.",
            "example": "25 Jahre Dienstzeit am 01.12.2026"
          },
          "vorschlag": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stand eines vorhandenen Vorschlags."
          }
        }
      },
      "Dienststatistik": {
        "type": "object",
        "description": "Die Dienste eines Jahres in Zahlen.",
        "properties": {
          "jahr": {
            "type": "integer",
            "description": "Das Jahr.",
            "example": 2026
          },
          "dienste": {
            "type": "integer",
            "description": "Zahl der Dienste bis heute.",
            "example": 48
          },
          "erfasste": {
            "type": "integer",
            "description": "Dienste mit erfasster Anwesenheit.",
            "example": 45
          },
          "stunden": {
            "type": "number",
            "description": "Dauer aller Dienste in Stunden.",
            "example": "120,5"
          },
          "personenstunden": {
            "type": "number",
            "description": "Stunden aller Anwesenden zusammen.",
            "example": "1580"
          },
          "quote": {
            "type": [
              "number",
              "null"
            ],
            "description": "Anwesenheit in Prozent.",
            "example": "71,3"
          },
          "schwelle": {
            "type": "integer",
            "description": "Unter dieser Quote in Prozent fällt eine Person auf.",
            "example": 50
          },
          "nachArt": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DienststatistikArt"
            },
            "description": "Je Art des Dienstes."
          },
          "nachMonat": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DienststatistikMonat"
            },
            "description": "Je Monat."
          },
          "personen": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Dienstpersonenquote"
            },
            "description": "Je Person; nur mit „Personal ansehen“."
          }
        }
      },
      "DienststatistikArt": {
        "type": "object",
        "description": "Die Dienste einer Art.",
        "properties": {
          "art": {
            "type": "string",
            "description": "Art.",
            "example": "Uebung"
          },
          "name": {
            "type": "string",
            "description": "Art in Worten.",
            "example": "Übung"
          },
          "dienste": {
            "type": "integer",
            "description": "Zahl.",
            "example": 30
          },
          "stunden": {
            "type": "number",
            "description": "Stunden.",
            "example": 75
          },
          "anwesend": {
            "type": "integer",
            "description": "Anwesende zusammen.",
            "example": 420
          },
          "soll": {
            "type": "integer",
            "description": "Erwartete zusammen.",
            "example": 600
          }
        }
      },
      "DienststatistikMonat": {
        "type": "object",
        "description": "Die Dienste eines Monats.",
        "properties": {
          "monat": {
            "type": "integer",
            "description": "Monat, 1 bis 12.",
            "example": 3
          },
          "dienste": {
            "type": "integer",
            "description": "Zahl.",
            "example": 4
          },
          "soll": {
            "type": "integer",
            "description": "Erwartete zusammen.",
            "example": 96
          },
          "anwesend": {
            "type": "integer",
            "description": "Anwesende zusammen.",
            "example": 70
          },
          "stunden": {
            "type": "number",
            "description": "Stunden.",
            "example": 10
          }
        }
      },
      "Dienstpersonenquote": {
        "type": "object",
        "description": "Eine Person über die Dienste eines Jahres.",
        "properties": {
          "personId": {
            "type": "integer",
            "description": "Nummer der Person.",
            "example": 155
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Braun, Mia"
          },
          "einheit": {
            "type": "string",
            "description": "Einheit.",
            "example": "Löschzug Nord"
          },
          "soll": {
            "type": "integer",
            "description": "Dienste, die für sie waren.",
            "example": 40
          },
          "anwesend": {
            "type": "integer",
            "description": "Davon da.",
            "example": 31
          },
          "entschuldigt": {
            "type": "integer",
            "description": "Davon entschuldigt.",
            "example": 5
          },
          "gefehlt": {
            "type": "integer",
            "description": "Unentschuldigt gefehlt.",
            "example": 4
          },
          "stunden": {
            "type": "number",
            "description": "Stunden.",
            "example": "77,5"
          },
          "quote": {
            "type": [
              "number",
              "null"
            ],
            "description": "Quote in Prozent.",
            "example": "77,5"
          },
          "istUnterSchwelle": {
            "type": "boolean",
            "description": "Unter der Schwelle der Feuerwehr.",
            "example": false
          }
        }
      },
      "Organisationsart": {
        "type": "object",
        "description": "Eine Art von Einheit.",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Nummer.",
            "example": 2
          },
          "name": {
            "type": "string",
            "description": "Name.",
            "example": "Löschzug"
          },
          "reihenfolge": {
            "type": "integer",
            "description": "Reihenfolge.",
            "example": 2
          },
          "istJugend": {
            "type": "boolean",
            "description": "Einheit der Jugend.",
            "example": false
          }
        }
      }
    }
  }
}