So funktioniert QuickPlan im Alltag und technisch im Hintergrund.

Benutzerhandbuch

QuickPlan hilft Ihnen, eine individuelle Therapieempfehlung aus den verfügbaren Leistungen zusammenzustellen. Sie brauchen keine technischen Vorkenntnisse und können die Schritte unten direkt im Tool nachvollziehen.

Standort wählen

Oben sehen Sie ein Standort-Menü. Wählen Sie Berlin oder München. Die angezeigten Leistungen und Preise beziehen sich immer auf den gewählten Standort. Wenn Sie den Standort wechseln, wird die Liste neu geladen und Ihr Plan dort aktualisiert, wo Preise aus dem Katalog kommen.

Leistungen links

In der linken Spalte stehen Leistungsbereiche. Klicken Sie einen Bereich an, um die zugehörigen Optionen in der Mitte zu sehen. Haben Sie bereits Positionen aus einem Bereich im Plan, erscheint eine kleine Zahl neben dem Namen.

Optionen in der Mitte

In der Mitte sehen Sie die Optionen zum gewählten Bereich. Jede Karte ist eine konkrete Option mit Preis oder mit dem Hinweis „Preis auf Anfrage“. Mit dem Plus fügen Sie eine Option zum Plan hinzu. Über das Suchfeld können Sie die Liste eingrenzen. Bereits im Plan enthaltene Optionen zeigen „Im Plan“ mit einer Stückzahl.

Individuelle Therapieempfehlung rechts

Die rechte Spalte ist Ihre individuelle Therapieempfehlung. Oben stehen Hinweise & Empfehlungen. Darunter erscheinen Ihre Planzeilen: Mengen ändern, Zeilen entfernen und Rabatte prüfen. Über „+ Weitere Zeile hinzufügen“ können Sie manuelle Positionen ergänzen. Mit „Drucken“ erzeugen Sie eine saubere Zusammenfassung für Gespräche mit Patientinnen und Patienten oder im Team.

Manuelle Zeilen hinzufügen

Scrollen Sie in der individuellen Therapieempfehlung zum Ende der Planliste und klicken Sie auf „+ Weitere Zeile hinzufügen“. Es öffnet sich ein Inline-Entwurf mit Kategorie, Bezeichnung und Preis. Mit „Hinzufügen“ übernehmen Sie die Zeile in die Therapieempfehlung, mit „Abbrechen“ verwerfen Sie den Entwurf. Die Menge startet bei 1 und lässt sich danach wie bei jeder anderen Position anpassen.

Rabatte und manuelle Zeilen

Automatische Rabatte wie Mengenrabatte, Paketrabatte oder Multi-Bundle-Boni gelten nur für Katalogzeilen. Manuelle Zeilen zählen mit dem eingegebenen Preis in Brutto- und Endsumme.

Technische Dokumentation

QuickPlan lädt Katalogdaten serverseitig für die erste Darstellung, normalisiert Leistungen und Varianten und nutzt eine API-Route, damit Geheimnisse und Upstream-URLs auf dem Server bleiben.

Erstes Rendern

Die Startseite ist eine Server-Komponente. Sie ruft `fetchOfferingCatalog` mit der Standard-Standort-ID und Revalidation auf, blendet nicht sichtbare Leistungen aus und übergibt das Ergebnis an `CostPlanClient` als `initialServices`. Der Client hält die Leistungen im State und bildet jede Leistung als Zeile in der linken Seitenleiste ab.

Varianten und Auswahl

Die Upstream-Daten können verschachtelt oder flach sein. `normalizeOfferingData` gruppiert flache Varianten nach Leistungs-ID, sodass die Oberfläche immer mit einer einheitlichen Struktur arbeitet. In der App ist die Auswahl zweistufig: zuerst Leistung, dann Variante. Beim Standortwechsel wird über dieselbe Same-Origin-API neu geladen und bestehende Auswahl soweit möglich abgeglichen.

Manuelle Zeilen & Währung

Ad-hoc-Zeilen werden in `computePlanBreakdown` gekennzeichnet und bepreist:

  • `SelectedService` und `LinePlanPricing` setzen `isCustom: true` für manuelle Zeilen.
  • Mengen- und Paketlogik greift für diese Zeilen nicht; der Preis bleibt wie eingegeben.
  • Währungscodes werden großgeschrieben, damit pro Währung genau eine Summe entsteht und UI wie Druck keine geteilten Totals zeigen.

Server-Proxy und API-Sicherheit

Der Browser ruft die Upstream-Offering-API nicht direkt auf. Stattdessen fragt er `/api/offering-services` an. Der Route-Handler baut serverseitig die Upstream-URL aus `OFFERING_API_URL`, setzt `X-Location-Id` und optional `x-publishable-api-key`. So bleiben Basis-URL und Schlüssel außerhalb des Clients.