
🛡️ Insurance · C4 Architecture · Pro
The core system of an insurer: quoting, underwriting, policy issue, billing and claims, used by customers, agents and underwriters.
C4 Architecture diagrams are part of Pro. Anyone can view this one; generating and editing it needs Pro.
Drawing diagram…
An insurance policy administration system: customers use a portal and agents use a mobile app, both calling an API gateway. Services: quote and rating service, underwriting service with a rules engine, policy service (issue, endorsements, renewals), billing service and claims service. Data in PostgreSQL, documents generated as PDFs into object storage. External systems: payment gateway, credit/medical data providers and a reinsurer.
C4Container
title Policy Administration System
Person(customer, "Customer", "Buys and renews policies")
Person(agent, "Agent", "Sells policies")
System_Boundary(pas, "Policy Administration") {
Container(portal, "Customer Portal", "React", "Quotes, policies, claims")
Container(agentapp, "Agent App", "Flutter", "Leads and proposals")
Container(api, "API Gateway", "Kong", "Auth and routing")
Container(rating, "Quote and Rating", "Java", "Premium calculation")
Container(uw, "Underwriting Service", "Java + Drools", "Risk rules")
Container(policy, "Policy Service", "Java", "Issue, renew, endorse")
Container(claims, "Claims Service", "Node.js", "Claim intake and status")
ContainerDb(db, "Policy DB", "PostgreSQL", "Policies and claims")
}
System_Ext(pay, "Payment Gateway", "Premium payments")
System_Ext(data, "Data Providers", "Credit and medical data")
Rel(customer, portal, "Uses")
Rel(agent, agentapp, "Uses")
Rel(portal, api, "Calls")
Rel(agentapp, api, "Calls")
Rel(api, rating, "Routes")
Rel(rating, uw, "Requests decision")
Rel(uw, data, "Checks")
Rel(api, policy, "Routes")
Rel(api, claims, "Routes")
Rel(policy, db, "Stores")
Rel(policy, pay, "Collects premium")The states of an insurance claim from first notice of loss to payment or closure, including investigation and appeals.
How a life or health insurance proposal is underwritten: automated rules, medical tests where needed, and the underwriter's decision.
How a customer buys motor insurance online: quote, add-ons, vehicle and previous-policy checks, payment and instant policy issue.
A relational schema for an insurer: customers, policies, coverages, insured objects, premiums, claims and payments.
How an insurer scores incoming claims for fraud: data enrichment, rules, an ML model and a special investigation unit queue.
What happens between a policyholder, the insurer's app, a surveyor and a garage when a car insurance claim is made.