Schadenfälle & Versicherungen
claims
core_platform
🛡️ RLS Protected
Schadenfälle & Versicherungen — aus Code abgeleitete Prozess- und API-Dokumentation.
⚡ Διοργανωτικές ροές & κύκλοι ζωής
Benutzerbefehl: claims agent
plan:command_claims_agent
Ελεγχόμενο διαρκές σχέδιο (durable_plan), ξεκίνηση: manual_command.
Schadenfall
status:claim
Επιστημονική μηχανή (απόκριτα).
⚙️ Fachprozesse & Capabilities (System-Fachlogik)
Registrierte Fachoperationen und System-Capabilities dieses Moduls zur Steuerung von Workflows, Kaskaden und KI-Agenten.
| Capability & Schlüssel | Fachliche Bezeichnung | Ausführung / Coverage | Risikostufe & Freigabe | Effekte & Kaskaden |
|---|---|---|---|---|
Agent-Einstieg claims_agent
agent_entry:claims_agent
|
Agent-Einstieg claims_agent
Quelle:
code:module_agent_map
|
manual_entry |
✓ Auto
|
Keine Seiteneffekte deklariert |
Doppelmeldungen prüfen
capability:claim.ai.duplicates
Op:
claim.ai.duplicates
|
Intent:
find_similar_claims
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Versicherer-Schreiben entwerfen
capability:claim.ai.letter
Op:
claim.ai.letter
|
Intent:
draft_claim_letter
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Rückstellung vorschlagen
capability:claim.ai.reserve
Op:
claim.ai.reserve
|
Intent:
suggest_claim_reserve
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Schaden zusammenfassen
capability:claim.ai.summarize
Op:
claim.ai.summarize
|
Intent:
summarize_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Schaden freigeben
capability:claim.approve
Op:
claim.approve
|
Intent:
approve_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
🔒 Freigabe nötig
Risiko:
business_record
|
|
Schadenbearbeiter zuweisen
capability:claim.assign
Op:
claim.assign
|
Intent:
assign_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Schadenbeleg anhängen
capability:claim.attachment.add
Op:
claim.attachment.add
|
Intent:
attach_claim_document
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenbeleg entfernen
capability:claim.attachment.remove
Op:
claim.attachment.remove
|
Intent:
remove_claim_attachment
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Ursachenanalyse / CAPA pflegen
capability:claim.capa.update
Op:
claim.capa.update
|
Intent:
update_claim_capa
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenfall abschließen
capability:claim.close
Op:
claim.close
|
Intent:
close_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenkosten buchen
capability:claim.cost.book
Op:
claim.cost.book
|
Intent:
book_claim_cost
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenkosten stornieren
capability:claim.cost.remove
Op:
claim.cost.remove
|
Intent:
remove_claim_cost
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadennotiz erfassen
capability:claim.event.add
Op:
claim.event.add
|
Intent:
add_claim_note
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden untersuchen
capability:claim.investigate
Op:
claim.investigate
|
Intent:
investigate_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden verknüpfen
capability:claim.link
Op:
claim.link
|
Intent:
link_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden als triagiert markieren
capability:claim.mark_triaged
Op:
claim.mark_triaged
|
Intent:
triage_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenfotos anfordern
capability:claim.photo.request
Op:
claim.photo.request
|
Intent:
request_claim_photos
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden ablehnen
capability:claim.reject
Op:
claim.reject
|
Intent:
reject_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
🔒 Freigabe nötig
Risiko:
business_record
|
|
Schadenfall wiedereröffnen
capability:claim.reopen
Op:
claim.reopen
|
Intent:
reopen_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenfall anlegen
capability:claim.report
Op:
claim.report
|
Intent:
report_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Rückstellung setzen
capability:claim.reserve.set
Op:
claim.reserve.set
|
Intent:
set_claim_reserve
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden in Prüfung setzen
capability:claim.review
Op:
claim.review
|
Intent:
review_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden regulieren
capability:claim.settle
Op:
claim.settle
|
Intent:
settle_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
🔒 Freigabe nötig
Risiko:
business_record
|
|
Schadenzahlung auslösen
capability:claim.settlement.pay
Op:
claim.settlement.pay
|
Intent:
pay_claim_settlement
Quelle:
code:capability_registry
|
⚙️ Engine |
🔒 Freigabe nötig
Risiko:
external_effect
|
|
Vergleichsvorschlag erfassen
capability:claim.settlement.propose
Op:
claim.settlement.propose
|
Intent:
propose_claim_settlement
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden melden
capability:claim.submit
Op:
claim.submit
|
Intent:
submit_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
🔒 Freigabe nötig
Risiko:
business_record
|
|
Regress eröffnen
capability:claim.subrogation.open
Op:
claim.subrogation.open
|
Intent:
open_claim_subrogation
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schaden triagieren
capability:claim.triage
Op:
claim.triage
|
Intent:
triage_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
metadata
|
|
Schadenverknüpfung lösen
capability:claim.unlink
Op:
claim.unlink
|
Intent:
unlink_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Schadenfall bearbeiten
capability:claim.update
Op:
claim.update
|
Intent:
update_claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: add event
capability:claims.claim.add_event
Op:
claims.claim.add_event
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: create claim
capability:claims.claim.create_claim
Op:
claims.claim.create_claim
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: create policy
capability:claims.claim.create_policy
Op:
claims.claim.create_policy
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: transition
capability:claims.claim.transition
Op:
claims.claim.transition
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: update claim
capability:claims.claim.update_claim
Op:
claims.claim.update_claim
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Claim: update policy
capability:claims.claim.update_policy
Op:
claims.claim.update_policy
|
Objekt:
claim
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Police verlängern
capability:insurance.policy.renew
Op:
insurance.policy.renew
|
Objekt:
insurance_policy
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Police registrieren
capability:policy.register
Op:
policy.register
|
Intent:
register_insurance_policy
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Police verlängern
capability:policy.renew
Op:
policy.renew
|
Intent:
renew_insurance_policy
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
Police bearbeiten
capability:policy.update
Op:
policy.update
|
Intent:
update_insurance_policy
Quelle:
code:capability_registry
|
⚙️ Engine |
✓ Auto
Risiko:
business_record
|
|
claim: edit form
form_surface_anchor:claim.edit
|
Objekt:
claim
Quelle:
code:erp_form_surface
|
operator_surface |
✓ Auto
|
Keine Seiteneffekte deklariert |
Schadenfall melden
gateway:claim_handling
Op:
claim.submit
|
Schadenfall melden
Quelle:
code:reviewed_gateway
|
⚙️ Engine |
✓ Auto
|
Keine Seiteneffekte deklariert |
Benutzerbefehl: claims agent
plan:command_claims_agent
|
Benutzerbefehl: claims agent
Quelle:
code:reviewed_execution_plan
|
durable_plan |
✓ Auto
|
Keine Seiteneffekte deklariert |
Schadenfall
status:claim
|
Objekt:
claim
Quelle:
code:status_machine
|
observable_only |
✓ Auto
|
Keine Seiteneffekte deklariert |
🧠 Fachprozess-Erzählung & Dual Knowledge Architektur
Synthese aus der ideologischen Blaupause (Meta-Fachlogik / Soll), der faktischen System-Implementierung (System-Fachlogik / Ist) und No-Code Customizing für KI-Consultants.
Der durchgängige Businessprozess im Detail (End-to-End Fließtext-Erzählung)
Der durchgängige Schadenprozess in der betrieblichen Praxis
Das Schadenmanagement verbindet Ereignisaufnahme, Beweissicherung, Risikobewertung, Versicherungskorrespondenz und kaufmännische Regulierung zu einem durchgängigen Prozess. Jeder Schadenfall ist ein eigener Vorgang mit Nummer, Status, Verantwortlichem, Frist und vollständigem Verlauf.
1. Omnichannel-Aufnahme & Primärverknüpfung
Ein Schadenfall entsteht aus einem konkreten Geschäftsvorfall – niemals aus dem Nichts:
- Meldewege: Interner Erfassungsdialog (
/schaeden/neu), Telefon, E-Mail, Kundenportal, API oder ein Agent. Der Kanal wird am Fall gespeichert (internal,phone,email,portal,api,sales,service). - Primärbezug: Über
cap:claim.reportwird der Fall mit seinem auslösenden Objekt verknüpft: Sendung, Retoure, Fertigungsauftrag, Arbeitsauftrag, Projekt, Artikel, Anlage, Fahrzeug, Charge, Bestellung, Kundenauftrag, Lagerbewegung, Einsatzbericht oder Mietbuchung. Der Primärbezug landet zusätzlich als Link mit Rolleprimaryin der Schadenakte. - Nummernkreis: Die Schadennummer wird transaktionssicher aus dem Nummernkreis
CLAIMvergeben; der Fall startet im Status Gemeldet (reported).
2. Beweissicherung & digitale Schadenakte
Vor jeder Reparatur oder Entsorgung werden Beweise gesichert:
- Fotos, Frachtbriefe mit Vorbehalt, Polizeiprotokolle, Gutachten, Rechnungen und Korrespondenz werden über
cap:claim.attachment.addals Dokumente des Dokumentmoduls an die Akte gebunden (Arten:photo,report,invoice,correspondence,evidence,other). - Jede fachliche Handlung – Statuswechsel, Notiz, KI-Triage, Reserve, Regress – erzeugt einen Eintrag in
claim_events(cap:claim.event.add). Dieses Journal ist append-only: Die Anwendungsrolle besitzt kein UPDATE/DELETE. - Fehlen Belege, fordert
cap:claim.photo.requestper Aufgabe gezielt Schadenfotos nach.
3. Kaskadierende Klassifikation & Friststeuerung
Die Schadenklassifikation ist dreistufig und datengetrieben (Bereich → Kategorie → Ursache):
- Neun Bereiche: Transport & Versand, Produktion & Fertigung, Lager & Logistik, Kundenretoure & Reklamation, Fuhrpark & Fahrzeuge, Gebäude & Anlagen, Service & Montage, Lieferant & Beschaffung, Sonstiges.
- Jede Kategorie kennt nur ihre zulässigen Ursachen; Taxonomie-Verstöße werden serverseitig abgewiesen (
validate_taxonomy). Dadurch sprechen Formular, API, KI-Triage und Auswertung dieselbe Sprache. - Die Schwere (
low,normal,high,critical) setzt die Bearbeitungsfrist (due_at): 14, 7, 3 bzw. 1 Tag ab Schadendatum. Die Priorität (lowbisurgent) steuert die Bearbeitungsreihenfolge.
4. KI-Triage & Doppelmeldungs-Radar
cap:claim.triageklassifiziert den Fall anhand der Fakten: Bereich, Kategorie, Ursache, Schwere, Priorität, Zusammenfassung, fehlende Informationen und empfohlene nächste Schritte. Die KI darf keine Beträge, Daten oder Personen erfinden; Schadenbeschreibungen und Dokumenttexte gelten als nicht vertrauenswürdiger Inhalt (Prompt-Injection-Schutz).- Mit
apply=trueübernimmt der Fall die Vorschläge und erhält eine neue Frist; ohne Freigabe bleibt es bei einem Vorschlag. cap:claim.ai.duplicatessucht ähnliche Fälle (gleiche Retoure, Artikel, Kunde oder Objekt innerhalb von 90 Tagen) und schützt vor Doppelregulierung.
5. Untersuchung, Ursachenanalyse & 8D/CAPA
- Nach der Triage wird der Fall über
cap:claim.mark_triagedundcap:claim.investigatein Untersuchung geführt. cap:claim.capa.updatepflegt die 8D-/CAPA-Struktur: Ursache (root_cause), Sofortmaßnahme (containment_action), Korrekturmaßnahme (corrective_action), Vorbeugemaßnahme (preventive_action) und Wirksamkeitsprüfung (verification). Das Kennzeichenis_8dmarkiert Fälle mit formaler 8D-Pflicht.- Über
cap:claim.linklassen sich zusätzliche Beziehungen – etwa betroffene Charge, Lieferant, Maschine oder Rücklieferung – mit Rolleaffected,source,recoveryodercontextdokumentieren.
6. Deckungsprüfung & Rückstellung
- Aktive Policen werden über
insurance_policiesgeführt.find_matching_policiesgleicht Deckungsart, Fahrzeug und Anlage ab;cap:policy.registerundcap:policy.updatepflegen Laufzeit, Prämie, Selbstbehalt und Erinnerungsvorlauf. cap:claim.reserve.setsetzt die Schadenrückstellung und dokumentiert sie im Verlauf;cap:claim.ai.reserveschlägt auf Basis von Schätzung, gebuchten Kosten und historischer Regulierungsquote einen Wert vor.cap:claim.settlement.proposehält einen Vergleichsvorschlag fest, ohne ihn zu buchen.
7. Einreichung beim Versicherer & Prüfung
cap:claim.ai.letterentwirft ein formelles deutsches Schadenmelde-Schreiben mit Police, Hergang, Höhe, Selbstbeteiligung und Bitte um Deckungsbestätigung – ausschließlich aus gelieferten Fakten.cap:claim.submitreicht den Fall ein (Status Eingereicht (submitted)). Die Einreichung ist freigabepflichtig, weil sie eine externe Wirkung gegenüber dem Versicherer entfaltet.- Geht die Rückmeldung ein, führt
cap:claim.reviewden Fall in Prüfung (in_review). Aus der Prüfung kann der Fall wieder nach Gemeldet zurückfallen (cap:claim.reopen), wenn neue Erkenntnisse oder Nachmeldungen vorliegen.
8. Anerkennung, Regulierung & Regress
cap:claim.approveerfasst Deckungszusage und Anerkennungsbetrag (approved_amount),cap:claim.rejectlehnt begründet ab.cap:claim.settlebzw.cap:claim.settlement.payregulieren den Fall und setzen den Auszahlungsbetrag (settled_at,settled_amount). Die Zahlung ist als externe Wirkung besonders geschützt und benötigt eine menschliche Bestätigung.cap:claim.subrogation.openeröffnet den Regress gegen Dritte (Frachtführer, Lieferant, Schädiger); der erwartete Rückfluss wird alsrecovery_amountgeführt.cap:claim.closeschließt die Akte nach Regulierung oder Ablehnung revisionssicher ab.
9. Schadenkosten & kaufmännische Bewertung
cap:claim.cost.bookerfasst Kostenpositionen (Reparatur, Ersatz, Fracht, Gutachter, Rechtsberatung, Sonstiges) mit Menge, Einzelpreis, Lieferant, Beleg und Status;cap:claim.cost.removestorniert eine Position, ohne den Verlauf zu löschen.- Die Summe der Kostenpositionen fließt in die semantische Auswertung (
claim.cost_total) und in die Reservenempfehlung ein. - Schätzung, Reserve, Anerkennung, Regulierung und Regress bleiben getrennt ausgewiesen – so entsteht eine belastbare Soll-Ist-Betrachtung je Fall und Bereich.
10. Abschluss, Policenpflege & Lernschleife
- Auslaufende Policen werden über
expiring_policieserkannt;cap:policy.renewverlängert die Laufzeit und aktiviert die Police wieder. Der Erinnerungsvorlauf (reminder_days) steuert die Fristenwarnung. - Abgeschlossene Fälle dienen der Ursachenanalyse: Bereichs-, Kategorie- und Ursachenstatistiken zeigen wiederkehrende Fehlerquellen; CAPA-Maßnahmen und Verknüpfungen zu Fertigungs-, Lager- und Lieferantenprozessen schließen die Lernschleife.
- Der Statuswechsel erzeugt das Outbox-Signal
CLAIM_STATUS_CHANGED; nachgelagerte Prozesse (Aufgaben, Benachrichtigungen, Auswertungen, Workflows) können darauf reagieren.
Meta-Fachlogik: Ideologische Blaupause, Soll-Weltbild & Normen
Meta-Fachlogik: Die normative Blaupause des Schadenmanagements
Die Meta-Fachlogik beschreibt, wie ein exzellentes Schaden- und Versicherungsmanagement aufgebaut sein muss – unabhängig von der konkreten Software. Sie dient Consultants und KI-Agenten als Referenz, um Kundenprozesse zu bewerten und Lücken aufzudecken.
1. Philosophische Grundlagen
- Ganzheitliches Risikomanagement (ISO 31000): Schadenfälle sind keine Einzelereignisse, sondern Symptome von Risiken in Prozessen, Lieferketten und Anlagen. Jeder Fall muss deshalb nicht nur reguliert, sondern auf seine Ursache zurückgeführt werden.
- First-Time-Right statt Schadensverwaltung: Das Ziel ist die Vermeidung wiederkehrender Schäden. Jeder abgeschlossene Fall liefert Erkenntnisse für Produktion, Einkauf, Lager und Versand.
- Wirtschaftlichkeit der Regulierung: Der Netto-Schadenaufwand (Regulierung minus Regress und Selbstbehalt) ist die entscheidende Kennzahl – nicht die Bruttosumme.
2. Normative Standards & Vorschriften
- VVG (Versicherungsvertragsgesetz): Obliegenheiten zur rechtzeitigen Schadenanzeige und zur Beweissicherung; Regress nach § 86 VVG (Übergang von Ersatzansprüchen auf den Versicherer) sowie Rückgriff gegen Schädiger.
- HGB § 249 ff. & GoBD: Schadenrückstellungen sind periodengerecht zu bilden; die Schadenakte und ihre Buchungen müssen nachvollziehbar, unveränderbar und revisionssicher archiviert werden (append-only Verlauf, keine rückwirkende Löschung).
- DSGVO: Datenminimierung und Zweckbindung – Gesundheitsdaten, Personenschäden und freie Notizen dürfen nicht in generische KI-Kontexte oder ungeprüfte Exporte gelangen.
- ISO 9001 / IATF 16949 & 8D: Reklamations- und Schadenfälle mit Kunden- oder Produktbezug erfordern strukturierte Ursachenanalyse (8D: D1–D8) und dokumentierte Wirksamkeitsprüfung.
- Vier-Augen-Prinzip: Einreichung, Anerkennung, Ablehnung und Auszahlung sind freigabepflichtige Entscheidungen mit finanzieller oder externer Wirkung.
3. Invarianten des Soll-Modells
- Kein Schadenfall ohne eindeutigen Bezug zu einem Objekt, einer Meldung und einem Meldeweg.
- Keine Regulierung ohne dokumentierte Deckungsprüfung und nachvollziehbare Betragshistorie.
- Keine externe Zahlung oder Versicherermeldung ohne menschliche Freigabe.
- Keine Löschung von Verlaufseinträgen; Korrekturen erfolgen als neue, dokumentierte Buchung.
- Kein Abschluss ohne Klärung von Regressmöglichkeiten.
- Jeder Fall mit Produkt-/Prozessbezug erhält eine Ursachenanalyse, sofern die Schwere hoch oder kritisch ist.
- Fristen sind verbindlich: Die Schwere bestimmt den Bearbeitungshorizont, nicht umgekehrt.
4. Kennzahlen eines gesunden Schadenmanagements
- Durchlaufzeit je Status und Bereich, gemessen gegen die SLA-Frist (
due_at). - Regulierungsquote (reguliert / geschätzt) und Reservengenauigkeit je Bereich.
- Regressquote (wiedererlangte Beträge / Bruttoschaden).
- Wiederholungsrate gleicher Ursachen und Kategorien.
- Anteil Fälle ohne vollständige Beweislage zum Zeitpunkt der Einreichung.
Systemische Fachlogik: Faktische Umsetzung in Centurio ERP & Capabilities
Systemische Fachlogik: Die faktische Umsetzung in Centurio ERP
Die System-Fachlogik beschreibt, wie Centurio ERP das normative Soll-Modell in Code, Datenbank und KI-Schicht realisiert.
1. Datenmodelle & Mandantentrennung
Alle Tabellen tragen tenant_id; der Zugriff läuft ausschließlich über mandantengefilterte Services und PostgreSQL Row-Level-Security:
claims: Schadenfallkopf mit Nummer, Typ, Status, Taxonomie, Schwere, Priorität, Kanal, bis zu 13 Objekt-Fremdschlüsseln, fünf Geldbeträgen (Schätzung, Reserve, Anerkennung, Regulierung, Regress), Selbstbehalt, Police, Fristen und CAPA/8D-Feldern.claim_events: append-only Verlauf (Statuswechsel, Notizen, KI-Triage, Reserve, Regress) mit Akteur und Zeitstempel.claim_links: polymorphe Verknüpfung mit Rolle (primary,affected,source,recovery,context), eindeutig je Fall/Objekt/Rolle.claim_attachments: Bindung an Dokumente des Dokumentmoduls (Foto, Bericht, Rechnung, Korrespondenz, Beweis).claim_cost_lines: Kostenpositionen mit Art, Menge, Einzelpreis, Betrag, Lieferant, Beleg und Status.insurance_policies: Policen mit Deckungsart, Laufzeit, Prämie, Selbstbehalt, Objektbezug (Anlage/Fahrzeug) und Erinnerungsvorlauf.
2. Verknüpfungsregister (17 Objekttypen)
app/modules/claims/links.py ist die eine Vokabel für Formular, Detailseite, API und Agenten. Unterstützt werden: Retoure, Kunde, Lieferant, Fertigungsauftrag, Arbeitsauftrag, Projekt, Artikel, Anlage, Fahrzeug, Charge/Serie, Sendung, Lager/Standort, Bestellung, Verkaufsauftrag, Lagerbewegung, Einsatzbericht und Mietbuchung. Jeder Typ kennt Tabelle, UI-Route, Label- und Suchfelder; Aliasse (z. B. manufacturing_order → assembly_order) werden kanonisiert.
3. Capability-Register (Ausführungsbausteine)
Der vollständige Lebenszyklus liegt als typisierte ENGINE-Familie claim_handling vor (Vorbild Fertigung):
- Aufnahme & Pflege:
cap:claim.report,cap:claim.update,cap:claim.assign,cap:claim.capa.update,cap:claim.event.add. - Triage & Untersuchung:
cap:claim.triage,cap:claim.mark_triaged,cap:claim.investigate. - Entscheidung & Regulierung:
cap:claim.submit,cap:claim.review,cap:claim.approve,cap:claim.settle,cap:claim.reject,cap:claim.close,cap:claim.reopen,cap:claim.settlement.propose,cap:claim.settlement.pay. - Akte & Belege:
cap:claim.link,cap:claim.unlink,cap:claim.attachment.add,cap:claim.attachment.remove,cap:claim.photo.request. - Finanzen & Regress:
cap:claim.reserve.set,cap:claim.cost.book,cap:claim.cost.remove,cap:claim.subrogation.open. - KI:
cap:claim.ai.summarize,cap:claim.ai.letter,cap:claim.ai.duplicates,cap:claim.ai.reserve. - Versicherung:
cap:policy.register,cap:policy.update,cap:policy.renew. Alle Einträge tragen Modul, Prozessfamilie, Risikostufe, Feldbezüge, Effekte und Statuskanten. Regulierung und externe Zahlung sind freigabepflichtig; jede Ausführung wird alscapability.invokedauditiert.
4. Zustandsmaschine & Outbox
Die Statuskette ist als Statusmaschine registriert (app/modules/events/status_machines.py):
reported → triaged → investigating → submitted → in_review → approved → settled → closed, mit Seitenpfaden rejected und der Wiedereröffnung in_review → reported. Die Service-Schicht validiert jeden Übergang gegen CLAIM_TRANSITIONS; die Status-Hooks schreiben CLAIM_STATUS_CHANGED in die transaktionale Outbox. Der Designer bietet diese Zustände als Wait-Events und Signalausgänge an.
5. Semantische Schicht (Feldsemantik)
- Custom Attributes:
claimundinsurance_policysind als customizing-fähige Objekte registriert; mandantenspezifische Zusatzfelder werden versioniert gespeichert. - Formularfläche:
claimbesitzt die bearbeitbare Formularflächeedit; das Intake-Formular nutzt dieselbe Taxonomie und dieselben Verknüpfungstypen wie API und Agenten. - Snapshots: Der Snapshot-Adapter liefert für KI- und Agentenkontexte ausschließlich strukturierte Fakten (Status, Taxonomie, Beträge, Fristen, Objektbezüge) – bewusst ohne Titel, Beschreibung, Notizen oder Freitext.
- Beziehungsgraph:
related_entitiesmodelliert elf statische Kanten (Police, Kunde, Lieferant, Retoure, Fertigung, Artikel, Anlage, Fahrzeug, Arbeitsauftrag, Projekt, Charge, Sendung) sowie dynamische Kanten ausclaim_links(Lager, Bestellung, Verkaufsauftrag, Lagerbewegung, Einsatzbericht, Miete). Der Graph emittiert Fakten wieclaim.status,claim.overdue,claim.cost_total,claim.links_countund die Voraussetzungclaim.policy_bound.
6. KI-Integration
app/modules/claims/ai.py kapselt alle KI-Aufrufe:
- Mandanten-Provider mit Guthabenprüfung und Nutzungsprotokollierung; ohne konfigurierten Provider greifen deterministische Heuristiken (offline- und testfähig).
- Prompt-Injection-Schutz und
wrap_untrustedfür Schadenbeschreibungen und Dokumenttexte; kein Erfinden von Beträgen, Daten oder Personen. - Fähigkeiten: Triage mit strukturiertem Schema, Zusammenfassung, Versicherer-Schreiben, Doppelmeldungsprüfung, Reservenempfehlung aus historischer Regulierungsquote.
- Agenten-Werkzeuge (
create_claim,submit_claim,transition_claim,book_claim_cost,add_claim_note,attach_document_to_claim,create_insurance_policy,triage_claim) rufen dieselben Capabilities auf – kein direkter SQL-Zugriff aus Agenten.
7. Oberfläche & Gateway
Die Schadenakte unter /schaeden/{id} bündelt Kopf, Verlauf, Verknüpfungen, Anhänge, Kosten und KI-Aktionen; /versicherungen pflegt Policen. Der reviewed Gateway gw:claim_handling@v1 bildet den freigabepflichtigen Meldeweg zum Versicherer ab und bleibt für Audit- und Gateway-Pfade verfügbar.
KI-Consultant Leitfaden: Customizing- & No-Code-Konzept (Soll-Ist-Synthese)
KI-Consultant Blueprint: Customizing & No-Code Architektur
Dieser Leitfaden dient Solution Architects und autonomen KI-Consultants als Handlungsvorlage für kundenspezifische Schadenprozesse auf der No-Code-Engine.
1. Analyse der Kundenanforderung (Soll-Ist-Abgleich)
Der Berater prüft zuerst:
- Welche Schadenarten und Bereiche sind branchenspezifisch relevant (z. B. Lebensmittel: Kontamination/Verfall; Maschinenbau: Maschinenschaden/Stillstand; Spedition: Transportschaden/Regress)?
- Welche Meldewege müssen angebunden sein (Portal, E-Mail-Postfach, API, Außendienst-App)?
- Welche Freigabeschwellen gelten (z. B. Regulierung ab 5.000 EUR durch die Geschäftsleitung)?
- Welche Fristen und Eskalationen sind vertraglich oder versicherungsseitig vorgegeben?
2. No-Code Zusatzfelder (Custom Fields)
Im Customizing Studio (/semantic/customizing) lassen sich Felder auf claim und insurance_policy anlegen:
- Auf
Claim:recall_relevant(Ja/Nein): Löst bei Wahrheit eine produktbezogene Eskalation aus.supplier_claim_number(Text): Referenz auf die Korrespondenz mit dem Lieferanten.incident_shift(Auswahl: Früh/Spät/Nacht): Auswertung von Schichtclustern.safety_relevant(Ja/Nein): Kopplung an Arbeitssicherheitsvorfälle.
- Auf
InsurancePolicy:broker_contact(Text): Ansprechpartner des Maklers.coverage_limit(Dezimal): Deckungssumme für Plausibilitätsprüfungen.notice_period_days(Ganzzahl): Kündigungsfrist für automatische Erinnerungen.
3. No-Code Workflow Canvas DAGs
Blueprint A: Eskalation kritischer Schäden
- Trigger:
cap:claim.reportmitseverity = criticalodersafety_relevant = true. - Condition:
estimated_amount > threshold OR claim_type = liability. - Human-in-the-Loop: Erzeugt eine Aufgabe für Schadenleitung und Geschäftsführung; Optionen Freigeben (
cap:claim.approve) oder Ablehnen (cap:claim.reject). - Parallelzweig: Benachrichtigt die Versicherung über
cap:claim.ai.letterals Entwurf – der Versand bleibt manuell.
Blueprint B: Beweislücken-Workflow
- Trigger: Statuswechsel nach
triagedohne Anhang der Artphotooderreport. - Action:
cap:claim.photo.requesterzeugt eine Aufgabe mit Frist; der Fall bleibt in Untersuchung. - Exit: Sobald ein Foto/Beleg angehängt ist (
claim.attachment.add), schließt der Workflow die Aufgabe.
Blueprint C: Policy-Ablauf & Verlängerung
- Trigger: Zeitplan oder
expiring_policies-Ereignis (<reminder_days). - Action: Aufgabe für Versicherungsverantwortliche; nach Entscheidung
cap:policy.renewodercap:policy.update. - Guard: Keine automatische Verlängerung ohne dokumentierte Freigabe.
4. Validierungsregeln & Formular-Customizing
- Betragskonsistenz:
settled_amount <= approved_amount <= estimated_amount * 1.25als Hinweisregel (keine harte Sperre, da Nachträge möglich sind). - Pflichtfelder je Schwere: Ab
highmüssen Bereich, Kategorie, Ursache und mindestens ein Beweismittel vorliegen. - Fristen:
due_atwird bei Änderung der Schwere neu berechnet; Überfälligkeit wird alsclaim.overdueim semantischen Kontext sichtbar. - Datenschutz: Freitextfelder (Titel, Beschreibung, Notizen) niemals in generische Agenten- oder Analysekontexte aufnehmen – nur strukturierte Fakten verwenden.
📚 Operative Prozessbegriffe & Transaktionsschnittstellen
- Externe Schadenmeldung aus Kundenportal, E-Mail, Telefon oder API
- Transportschaden bei Anlieferung oder Auslieferung (Frachtbrief mit Vorbehalt)
- Reklamation oder Retoure mit Produkt- und Kundenbezug
- Qualitätsabweichung, Ausschuss oder Nacharbeit aus der Fertigung
- Unfall-, Diebstahl- oder Glasschaden eines Fuhrparksfahrzeugs
- Sachschaden an Gebäuden, Maschinen oder Anlagen
- Beschaffungsfehler, Falschlieferung oder Fehlmenge eines Lieferanten
- Vollständige digitale Schadenakte mit Verlauf, Verknüpfungen, Belegen und Kosten
- Klassifizierter Schadenfall mit Bereich, Kategorie, Ursache, Schwere und Frist
- KI-Triage-Vorschlag und Versicherer-Schreiben-Entwurf
- Dokumentierte Deckungsprüfung, Rückstellung und Regulierungsvorschlag
- Regulierungsentscheidung mit Anerkennungs- und Auszahlungsbetrag
- Regressforderung gegen Dritte mit erwartetem Rückfluss
- Ursachenanalyse (8D/CAPA) und Bereichsstatistik für die Lernschleife
- claim_registered -> claim_linked: Primärbezug wird als Link in der Akte gespeichert
- severity_changed -> due_at_recalculated: SLA-Frist folgt der Schwere
- claim_submitted -> insurer_notification: fristwahrende Meldung an den Versicherer
- claim_settled -> claim_payment_recorded: Regulierung wird kaufmännisch abgeschlossen
- carrier_fault -> subrogation_claim: Regressforderung an den Frachtführer
- claim_closed -> cause_statistics_updated: Bereichs- und Ursachenauswertung wird fortgeschrieben
- policy_expiring -> renewal_task: Erinnerung und Verlängerung der Police
- Sachverständigen-Beauftragung und Vor-Ort-Begutachtung
- Juristische Abwehr unberechtigter Drittansprüche
- Regressprüfung gegen Unterlieferanten und Frachtführer
- Nachforderung fehlender Fotos, Belege oder Zeugenaussagen
- Manuelle Korrektur von Beträgen mit dokumentierter Begründung
- Schadenarten und Bereiche branchenspezifisch schärfen; Kategorien nur mit passenden Ursachen hinterlegen
- Freigabeschwellen für Einreichung, Anerkennung und Auszahlung in der Agenten-/Gateway-Policy justieren
- Zusatzfelder für Recall-, Arbeitssicherheits- und Lieferantenbezug auf `claim` anlegen
- Policen mit Deckungssumme, Selbstbehalt und Erinnerungsvorlauf pflegen, damit Matching und Fristen greifen
- Beweismittel-Pflichten je Schwere im Formular und in Workflows erzwingen
- Auswertungen nach Bereich, Kategorie, Ursache, Regulierungsquote und Regressquote etablieren
🗄️ Πλαίσιο
🔌 Πηγαίνοντας από την αρχή
| Art | Μεθοδος | Τελική οδός | Titel & Zweck | Δικαιοδοσία |
|---|---|---|---|---|
| ⚡ REST API | DELETE | /api/v1/claims/{claim_id}/attachments/{attachment_id} |
remove_claim_attachment
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | DELETE | /api/v1/claims/{claim_id}/costs/{line_id} |
remove_claim_cost
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | DELETE | /api/v1/claims/{claim_id}/links/{link_id} |
remove_claim_link
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | GET | /api/v1/claims |
list_claims
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/by-entity/{entity_type}/{entity_id} |
claims_for_entity
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/entities/search |
search_claim_entities
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/policies |
list_policies
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/policies/expiring |
expiring_policies
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/policies/{policy_id} |
get_policy
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/summary |
claims_summary
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/taxonomy |
claims_taxonomy
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/{claim_id} |
get_claim
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/{claim_id}/attachments |
list_claim_attachments
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/{claim_id}/costs |
list_claim_costs
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/{claim_id}/events |
list_claim_events
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /api/v1/claims/{claim_id}/links |
list_claim_links
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /schaeden |
claims_page
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /schaeden/entitaeten |
claim_entity_search
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /schaeden/{claim_id} |
claim_detail_page
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | GET | /versicherungen |
policies_page
Semantic binding: inventory_only; mutation=False
|
claims
|
| ⚡ REST API | PATCH | /api/v1/claims/policies/{policy_id} |
update_policy
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | PATCH | /api/v1/claims/{claim_id} |
update_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims |
create_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/policies |
create_policy
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/ai/duplicates |
ai_duplicates_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/ai/letter |
ai_letter_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/ai/reserve |
ai_reserve_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/ai/summary |
ai_summarize_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/ai/triage |
ai_triage_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/approve |
approve_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/assign |
assign_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/attachments |
upload_claim_attachment
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/capa |
update_capa
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/close |
close_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/costs |
add_claim_cost
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/events |
add_claim_event
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/investigate |
investigate_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/links |
add_claim_link
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/reject |
reject_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/reopen |
reopen_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/review |
review_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/settle |
settle_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/submit |
submit_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /api/v1/claims/{claim_id}/triage |
triage_claim
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/neu |
create_claim_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/aktion |
claim_action_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/anhang |
claim_attachment_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/anhang/{attachment_id}/loeschen |
claim_attachment_delete_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/bearbeiten |
update_claim_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/capa |
claim_capa_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/ki/{kind} |
claim_ai_action
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/kosten |
claim_cost_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/kosten/{line_id}/loeschen |
claim_cost_delete_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/link |
claim_link_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/link/{link_id}/loeschen |
claim_unlink_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/notiz |
claim_note_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /schaeden/{claim_id}/zuweisen |
claim_assign_form
Semantic binding: operator_surface; mutation=True
|
claims
|
| ⚡ REST API | POST | /versicherungen/neu |
create_policy_form
Semantic binding: operator_surface; mutation=True
|
claims
|
🛡️ Ρυθμιστική & συμμόρφωση
Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:
- Διάλυση
- Απομόνωση πελατών (PostgreSQL RLS)