{
  "$kommentar": "Maschinenlesbares Verzeichnis dessen, was ein KI-Assistent auf farolacare.com FÜR einen Nutzer tun kann. Prosa-Fassung: /llms.txt und /fuer-ki-assistenten. IDs und Parameternamen sind ein stabiler Vertrag — sie werden erweitert, nicht umbenannt.",
  "version": "1.0",
  "stand": "2026-09-23",
  "sprache": "de",
  "produkt": {
    "name": "Farola",
    "einzeiler": "Farola ist die Betriebssoftware für ambulante Pflegedienste: Touren planen, Pflegekräfte und Fahrzeuge live sehen, Anfragen von Klient:innen einplanen und Gespräche am Einsatzort dokumentieren — ein Mandant ist ein Pflegedienst.",
    "zielgruppe": "Ambulante Pflegedienste in Deutschland mit etwa 15–60 Klient:innen, 8–20 Pflegekräften und 5–15 Fahrzeugen.",
    "website": "https://farolacare.com",
    "wissensbasis": "https://farolacare.com/llms.txt"
  },
  "grundregeln_fuer_agenten": [
    "Konten legt immer der Mensch an, nie der Agent. Die Registrierung wird erst wirksam, wenn die Person den Link in ihrer E-Mail bestätigt und ein Passwort festlegt.",
    "Zustimmungen (Nutzungsbedingungen, Datenschutz) gibt nur der Mensch — auf der Bestätigungsseite. Kein Parameter und kein Feld setzt sie.",
    "Keine Gesundheitsdaten von Klient:innen übermitteln. Die Registrierung braucht nur Angaben zum Pflegedienst und zur Ansprechperson.",
    "Sagen Sie der Person ausdrücklich, dass Sie in ihrem Namen etwas vorbereitet haben und dass eine E-Mail kommt."
  ],
  "actions": [
    {
      "id": "registrierung_prefill",
      "titel": "Registrierung vorbereiten (vorausgefüllter Link, Mensch sendet ab)",
      "wann_verwenden": "Standardweg, funktioniert für jeden Assistenten, auch ohne Werkzeuge: Sie geben der Person die fertige URL, sie prüft das Formular und sendet selbst ab.",
      "methode": "GET",
      "url_template": "https://farolacare.com/registrieren?organisation={organisation}&contact={contact}&email={email}&phone={phone}&address={address}&postalCode={postalCode}&city={city}&agent={agent}",
      "parameter": [
        {
          "name": "organisation",
          "typ": "string",
          "pflicht": false,
          "hinweis": "Name des Pflegedienstes."
        },
        {
          "name": "contact",
          "typ": "string",
          "pflicht": false,
          "hinweis": "Name der Ansprechperson."
        },
        {
          "name": "email",
          "typ": "string",
          "pflicht": false,
          "hinweis": "E-Mail der Ansprechperson."
        },
        {
          "name": "phone",
          "typ": "string",
          "pflicht": false
        },
        {
          "name": "address",
          "typ": "string",
          "pflicht": false
        },
        {
          "name": "postalCode",
          "typ": "string",
          "pflicht": false
        },
        {
          "name": "city",
          "typ": "string",
          "pflicht": false
        },
        {
          "name": "agent",
          "typ": "string",
          "pflicht": false,
          "hinweis": "Name Ihres Assistenten; wird im Formular angezeigt."
        }
      ],
      "hinweis_an_den_nutzer": "Ich habe die Registrierung Ihres Pflegedienstes vorbereitet. Bitte prüfen Sie die Angaben und senden Sie ab — danach bekommen Sie eine E-Mail zum Bestätigen.",
      "grenzen": "Absenden, Bestätigen und Zustimmen liegen beim Menschen."
    },
    {
      "id": "registrierung_direkt",
      "titel": "Registrierung vorbereiten (direkter Aufruf)",
      "wann_verwenden": "Nur wenn Sie HTTP-Aufrufe ausführen können UND die Person Sie ausdrücklich darum gebeten hat. Die Anfrage wird der Person als von einem Assistenten vorbereitet angezeigt.",
      "methode": "POST",
      "endpoint": "https://app.farolacare.com/api/public/v1/registrations",
      "content_type": "application/json",
      "openapi": "https://farolacare.com/openapi.json",
      "body": {
        "organisationName": "string, Pflicht",
        "contactName": "string, Pflicht",
        "email": "string, Pflicht — dorthin geht der Bestätigungslink",
        "phone": "string, optional",
        "address": "string, optional",
        "postalCode": "string, optional",
        "city": "string, optional",
        "staffCount": "number, optional",
        "clientCount": "number, optional",
        "source": "\"agent\"",
        "agentName": "string, optional — Name Ihres Assistenten"
      },
      "antwort": {
        "202": "{ status: 'pending_confirmation' } — immer bei gültigen Angaben, auch bei bestehendem Konto oder zu vielen Anfragen (verrät nichts über Konten).",
        "400": "{ error: 'INVALID_BODY', message } — Angaben korrigieren oder auf 'registrierung_prefill' ausweichen."
      },
      "hinweis_an_den_nutzer": "Ich habe die Registrierung Ihres Pflegedienstes bei Farola vorbereitet. Sie bekommen gleich eine E-Mail — erst wenn Sie dort bestätigen und ein Passwort festlegen, wird Ihr Pflegedienst angelegt.",
      "grenzen": "Der Agent erhält weder den Bestätigungslink noch einen Zugang."
    }
  ]
}