# kinukshan/insurance-claims-processing-system architecture

> Architecture diagram of the GitHub repository kinukshan/insurance-claims-processing-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kinukshan/insurance-claims-processing-system
- Repository: https://github.com/kinukshan/insurance-claims-processing-system

## Overview

This is a cross-platform insurance claims system: policyholders submit and track claims in Flutter, while staff manage policies, claim reviews, fraud risk and payouts in React. Both clients use the ASP.NET Core API; it persists business records and invokes the internal AI service for claim verification, risk assessment and validation before human decisions. The tree and README establish these major capabilities, but only selected source was sampled, so unsampled subsystem links are documented or shown as unverified rather than inferred from names.

Main entry points: [`backend/src/InsuranceClaims.Api/Program.cs`](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Api/Program.cs) (ASP.NET API), [`ai-service/workflows/claim_processing_workflow.py`](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/workflows/claim_processing_workflow.py) (Claim workflow), [`backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs`](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs) (PostgreSQL), [`mobile`](https://github.com/kinukshan/insurance-claims-processing-system/tree/main/mobile) (Flutter app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_mobile["Flutter app"]
  node_web["Staff dashboard<br/>[App.jsx]"]
end

subgraph group_api["Public API"]
  node_api_entry["ASP.NET API<br/>[Program.cs]"]
  node_auth["Authentication<br/>[AuthService.cs]"]
end

subgraph group_business["Claims operations"]
  node_policy["Policy management<br/>[PolicyService.cs]"]
  node_claims["Claim management<br/>[ClaimService.cs]"]
  node_risk["Risk assessment"]
  node_payout["Payout processing<br/>[PayoutService.cs]"]
  node_notifications["Notifications"]
end

subgraph group_agents["AI workflow"]
  node_workflow["Claim workflow"]
  node_coordinator["Coordinator agent"]
  node_document_agent["Document verification"]
  node_fraud_agent["Fraud and risk agent"]
  node_validation_agent["Safety validation"]
  node_gemini["Gemini client<br/>[gemini_client.py]"]
  node_ai_api["Internal AI service<br/>[main.py]"]
end

subgraph group_infra["Persistence and integrations"]
  node_database[("PostgreSQL")]
  node_payment["Payment gateway<br/>[IPaymentGateway.cs]"]
  node_email["Email provider"]
end

node_policyholder(("Policyholder"))
node_staff(("Claims staff"))

node_policyholder -->|"uses"| node_mobile
node_staff -->|"uses"| node_web
node_mobile -->|"API requests"| node_api_entry
node_web -->|"API requests"| node_api_entry
node_api_entry -.->|"routes auth"| node_auth
node_api_entry -.->|"routes policies"| node_policy
node_api_entry -.->|"routes claims"| node_claims
node_api_entry -.->|"routes assessments"| node_risk
node_api_entry -->|"routes payouts"| node_payout
node_api_entry -->|"sends notices"| node_notifications
node_api_entry -->|"internal requests"| node_ai_api
node_ai_api -->|"starts workflow"| node_coordinator
node_coordinator -.->|"executes plan"| node_workflow
node_workflow -.->|"verifies documents"| node_document_agent
node_workflow -.->|"assesses risk"| node_fraud_agent
node_workflow -.->|"validates result"| node_validation_agent
node_document_agent -->|"uses reasoning"| node_gemini
node_database -.->|"stores records"| node_claims
node_database -->|"stores records"| node_policy
node_database -->|"stores users"| node_auth
node_payout -.->|"dispatches payment"| node_payment
node_api_entry -->|"receives webhooks"| node_payment
node_notifications -.->|"sends email"| node_email

click node_mobile "https://github.com/kinukshan/insurance-claims-processing-system/tree/main/mobile"
click node_web "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/frontend-web/src/App.jsx"
click node_api_entry "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Api/Program.cs"
click node_auth "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Authentication/AuthService.cs"
click node_policy "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs"
click node_claims "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/ClaimsManagement/Services/ClaimService.cs"
click node_risk "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/RiskAssessment/Services/RiskAssessmentService.cs"
click node_payout "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/PayoutProcessing/Services/PayoutService.cs"
click node_notifications "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/Notifications/Services/NotificationOrchestrator.cs"
click node_workflow "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/workflows/claim_processing_workflow.py"
click node_coordinator "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/coordinator_agent.py"
click node_document_agent "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/document_verification_agent.py"
click node_fraud_agent "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/fraud_risk_agent.py"
click node_validation_agent "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/validation_agent.py"
click node_gemini "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/services/gemini_client.py"
click node_database "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs"
click node_payment "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/ExternalServices/Payments/IPaymentGateway.cs"
click node_email "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/ExternalServices/Email/ResendEmailService.cs"
click node_ai_api "https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mobile,node_web toneBlue
class node_api_entry,node_auth toneAmber
class node_policy,node_claims,node_risk,node_payout,node_notifications toneMint
class node_workflow,node_coordinator,node_document_agent,node_fraud_agent,node_validation_agent,node_gemini,node_ai_api toneRose
class node_database,node_payment,node_email,node_policyholder,node_staff toneIndigo
```

## Components

### User applications

- [Flutter app](https://github.com/kinukshan/insurance-claims-processing-system/tree/main/mobile): `mobile`
- [Staff dashboard](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/frontend-web/src/App.jsx): `frontend-web/src/App.jsx`

### Public API

- [ASP.NET API](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Api/Program.cs): `backend/src/InsuranceClaims.Api/Program.cs`
- [Authentication](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Authentication/AuthService.cs): `backend/src/InsuranceClaims.Infrastructure/Authentication/AuthService.cs`

### Claims operations

- [Policy management](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs): `backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs`
- [Claim management](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/ClaimsManagement/Services/ClaimService.cs): `backend/src/InsuranceClaims.Application/ClaimsManagement/Services/ClaimService.cs`
- [Risk assessment](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/RiskAssessment/Services/RiskAssessmentService.cs): `backend/src/InsuranceClaims.Application/RiskAssessment/Services/RiskAssessmentService.cs`
- [Payout processing](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/PayoutProcessing/Services/PayoutService.cs): `backend/src/InsuranceClaims.Application/PayoutProcessing/Services/PayoutService.cs`
- [Notifications](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Application/Notifications/Services/NotificationOrchestrator.cs): `backend/src/InsuranceClaims.Application/Notifications/Services/NotificationOrchestrator.cs`

### AI workflow

- [Claim workflow](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/workflows/claim_processing_workflow.py): `ai-service/workflows/claim_processing_workflow.py`
- [Coordinator agent](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/coordinator_agent.py): `ai-service/agents/coordinator_agent.py`
- [Document verification](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/document_verification_agent.py): `ai-service/agents/document_verification_agent.py`
- [Fraud and risk agent](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/fraud_risk_agent.py): `ai-service/agents/fraud_risk_agent.py`
- [Safety validation](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/agents/validation_agent.py): `ai-service/agents/validation_agent.py`
- [Gemini client](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/services/gemini_client.py): `ai-service/services/gemini_client.py`
- [Internal AI service](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/ai-service/main.py): `ai-service/main.py`

### Persistence and integrations

- [PostgreSQL](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs): `backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs`
- [Payment gateway](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/ExternalServices/Payments/IPaymentGateway.cs): `backend/src/InsuranceClaims.Infrastructure/ExternalServices/Payments/IPaymentGateway.cs`
- [Email provider](https://github.com/kinukshan/insurance-claims-processing-system/blob/main/backend/src/InsuranceClaims.Infrastructure/ExternalServices/Email/ResendEmailService.cs): `backend/src/InsuranceClaims.Infrastructure/ExternalServices/Email/ResendEmailService.cs`

### Other components

- **Policyholder**
- **Claims staff**

## Connections

- Policyholder → Flutter app: uses
- Claims staff → Staff dashboard: uses
- Flutter app → ASP.NET API: API requests
- Staff dashboard → ASP.NET API: API requests
- ASP.NET API → Authentication: routes auth
- ASP.NET API → Policy management: routes policies
- ASP.NET API → Claim management: routes claims
- ASP.NET API → Risk assessment: routes assessments
- ASP.NET API → Payout processing: routes payouts
- ASP.NET API → Notifications: sends notices
- ASP.NET API → Internal AI service: internal requests (evidence: `ai-service/main.py`)
- Internal AI service → Coordinator agent: starts workflow (evidence: `ai-service/main.py`)
- Coordinator agent → Claim workflow: executes plan
- Claim workflow → Document verification: verifies documents
- Claim workflow → Fraud and risk agent: assesses risk
- Claim workflow → Safety validation: validates result
- Document verification → Gemini client: uses reasoning (evidence: `ai-service/agents/document_verification_agent.py`)
- PostgreSQL → Claim management: stores records
- PostgreSQL → Policy management: stores records (evidence: `backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs`)
- PostgreSQL → Authentication: stores users (evidence: `backend/src/InsuranceClaims.Infrastructure/Authentication/AuthService.cs`)
- Payout processing → Payment gateway: dispatches payment
- ASP.NET API → Payment gateway: receives webhooks
- Notifications → Email provider: sends email
