Rollen

Für die technische Schnittstellendefinition spielen Rollen und Rechte keine große Rolle. Sie legen mehr das fachliche Laufzeitverhalten fest. Dennoch ist es für höhere Definitionsebenen sinnvoll, die fachlichen Zugriffsrechte zu behandeln und festzulegen.

Für Musterserver und Musterclient sind die Rollen von konkreter bedeutung für die Steuerung der Hypermedia-Controls.

Agenten

Agenten sollten nochmals anders behandelt werden als die eigentlichen User. Gründe dafür sind:

  • Auditierbarkeit, Haftung und Nachvollziehbarkeit

  • Einschränkung des Handlungsspielraums der Agenten

  • Rate Limiting und Schutz der API

Dies sollte über ein zusätzliches Merkmal erfolgen, ist aber kein fachliches Kriterium.

1. Interessenten & Endkunden

  • Gast / Anonymer Nutzer (ROLE_GUEST)

  • Zweck: Nutzer, die sich noch nicht authentifiziert haben (z.B. auf einer Landingpage oder im Erstkontakt mit einem Chatbot).

  • Rechte: Darf Tarife berechnen (anonyme Berechnungen), allgemeine Produktinformationen abrufen und eventuell ein Offert erstellen (welches dann z.B. über einen Token in einer E-Mail gebunden wird).

  • Einschränkung: Darf keine personenbezogenen Daten speichern oder Verträge ohne vorherige Identifikation (z.B. Gast-Checkout oder Registrierung) verbindlich abschließen. Darf keine Bestandsverträge einsehen.

  • Authentifizierter Kunde / Versicherungsnehmer (ROLE_CUSTOMER)

  • Zweck: Ein eingeloggter Endkunde im Kundenportal oder in einer App.

  • Rechte: Darf eigene Offerte einsehen, Anträge abschließen, eigene Verträge einsehen, Vertragsänderungen (z.B. Adressänderung, Kfz-Wechsel) für seine eigenen Verträge initiieren.

  • Einschränkung: Sieht strikt nur die eigenen Daten (Mandantenfähigkeit auf Nutzerebene).

2. Vermittler

  • Makler / Vermittler (ROLE_BROKER)

  • Zweck: Unabhängige Makler oder gebundene Vermittler, die im Auftrag von Kunden handeln.

  • Rechte: Darf Berechnungen, Offerte und Anträge für verschiedene Kunden erstellen. Hat Lese- und (eingeschränkte) Schreibzugriffe auf den Bestand der ihm zugeordneten Kunden. Darf oft spezielle, für Makler rabattierte oder erweiterte Produktbausteine sehen, die dem Endkunden verborgen bleiben.

  • Besonderheit: Benötigt oft das Recht, ein Offert an den Endkunden zur digitalen Signatur weiterzuleiten, anstatt es selbst zu unterschreiben.

  • Makler-Backoffice (ROLE_BROKER_ASSISTANT)

  • Zweck: Assistenzkräfte in einem Maklerbüro.

  • Rechte: Ähnlich wie der Makler, darf Dokumente hochladen, Daten erfassen, Verträge einsehen, aber möglicherweise nicht den finalen Antrag verbindlich für den Kunden einreichen (4-Augen-Prinzip).

3. VU-Mitarbeiter

  • Sachbearbeiter / Underwriter (ROLE_UNDERWRITER)

  • Zweck: Fachabteilung in der Versicherung, die Anträge prüft.

  • Rechte: Darf Anträge einsehen, die in die manuelle Prüfung (Dunkelverarbeitungs-Aussteuerung) gefallen sind. Darf Risikozuschläge vergeben, Anträge policiert (annehmen) oder ablehnen. Kann Dokumente anfordern.

  • Kundenservice / Support (ROLE_CUSTOMER_SUPPORT)

  • Zweck: First- und Second-Level Support.

  • Rechte: Lesender Zugriff auf Verträge, Anträge und Fehlerlogs (z.B. fehlgeschlagene Validierungen in der API). Darf Stammdatenänderungen im Auftrag des Kunden durchführen, Offerte erneut versenden.