How kinukshan/insurance-claims-processing-system works
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: Program.cs ASP.NET API · claim_processing_workflow.py Claim workflow · ApplicationDbContext.cs PostgreSQL · mobile Flutter app
Components 21
User applications
- Flutter app
mobile - Staff dashboard
frontend-web/src/App.jsx
Public API
- ASP.NET API
backend/src/InsuranceClaims.Api/Program.cs - Authentication
backend/src/InsuranceClaims.Infrastructure/Authentication/AuthService.cs
Claims operations
- Policy management
backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs - Claim management
backend/src/InsuranceClaims.Application/ClaimsManagement/Services/ClaimService.cs - Risk assessment
backend/src/InsuranceClaims.Application/RiskAssessment/Services/RiskAssessmentService.cs - Payout processing
backend/src/InsuranceClaims.Application/PayoutProcessing/Services/PayoutService.cs - Notifications
backend/src/InsuranceClaims.Application/Notifications/Services/NotificationOrchestrator.cs
AI workflow
- Claim workflow
ai-service/workflows/claim_processing_workflow.py - Coordinator agent
ai-service/agents/coordinator_agent.py - Document verification
ai-service/agents/document_verification_agent.py - Fraud and risk agent
ai-service/agents/fraud_risk_agent.py - Safety validation
ai-service/agents/validation_agent.py - Gemini client
ai-service/services/gemini_client.py - Internal AI service
ai-service/main.py
Persistence and integrations
- PostgreSQL
backend/src/InsuranceClaims.Infrastructure/Persistence/ApplicationDbContext.cs - Payment gateway
backend/src/InsuranceClaims.Infrastructure/ExternalServices/Payments/IPaymentGateway.cs - Email provider
backend/src/InsuranceClaims.Infrastructure/ExternalServices/Email/ResendEmailService.cs
Other components
- Policyholder
- Claims staff
Connections 23
- 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
ai-service/main.py - Internal AI service → Coordinator agent: starts workflow
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
ai-service/agents/document_verification_agent.py - PostgreSQL → Claim management: stores records
- PostgreSQL → Policy management: stores records
backend/src/InsuranceClaims.Infrastructure/Services/PolicyService.cs - PostgreSQL → Authentication: stores users
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