# sanvi0401/risksure architecture

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

- Interactive diagram: https://gitdiagram.com/sanvi0401/risksure
- Repository: https://github.com/sanvi0401/risksure

## Overview

RiskSure is an insurance risk-assessment application with a Next.js user interface and Flask API. Its central workflow is customer application entry, backend risk assessment and persistence, then customer or underwriter review. The README documents PostgreSQL, JWT authentication, and a frontend API proxy. Major listed capabilities include administration, policy and premium views, claims and fraud intelligence, and relationship graphs. Backend excerpts show graph projection, policy retrieval, statistical analysis, and AI evidence summaries; several frontend branches are visible in the tree but their implementation links are not verified here.

Main entry points: [`backend/app.py`](https://github.com/sanvi0401/risksure/blob/main/backend/app.py) (Flask API), [`frontend/lib/api.ts`](https://github.com/sanvi0401/risksure/blob/main/frontend/lib/api.ts) (API client), [`backend/integrations.py`](https://github.com/sanvi0401/risksure/blob/main/backend/integrations.py) (External integrations), [`frontend/app/case-intelligence/page.tsx`](https://github.com/sanvi0401/risksure/blob/main/frontend/app/case-intelligence/page.tsx) (Case intelligence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_application_ui["Application entry<br/>[page.tsx]"]
  node_customer_views["Customer views<br/>[page.tsx]"]
  node_underwriter_views["Underwriter views<br/>[page.tsx]"]
  node_case_ui["Case intelligence<br/>[page.tsx]"]
  node_admin_ui["Administration<br/>[page.tsx]"]
  node_claims_ui["Claims views<br/>[page.tsx]"]
  node_claims_intel_ui["Claims intelligence<br/>[page.tsx]"]
  node_fraud_ui["Fraud views<br/>[page.tsx]"]
  node_policy_ui["Policy views<br/>[page.tsx]"]
  node_premium_ui["Premium views<br/>[page.tsx]"]
  node_provider_ui["Provider views<br/>[page.tsx]"]
  node_risk_ui["Risk views<br/>[page.tsx]"]
  node_graph_ui["Relationship graph<br/>[page.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_underwriting["Underwriting workflow"]
  node_risk["Risk assessment<br/>[risk_service.py]"]
end

subgraph group_intelligence["Risk intelligence"]
  node_statistics["Cohort analysis"]
  node_graph_service["Relationship projection<br/>[neo4j_service.py]"]
  node_rag["Policy retrieval<br/>[rag_service.py]"]
  node_ai_underwriter["Evidence assistant"]
end

subgraph group_operations["Insurance operations"]
end

subgraph group_platform["Backend platform"]
  node_backend_api["Flask API<br/>[app.py]"]
  node_auth["Authentication<br/>[app.py]"]
  node_domain_models["Insurance records<br/>[models.py]"]
  node_database[("PostgreSQL<br/>[database.py]")]
  node_integrations["External integrations<br/>[integrations.py]"]
end

node_browser(("Browser users"))
node_neo4j[("Neo4j")]
node_hf["Hugging Face inference"]

node_browser -.->|"enters application"| node_application_ui
node_browser -.->|"reviews account"| node_customer_views
node_browser -.->|"reviews cases"| node_underwriter_views
node_application_ui -.->|"submits data"| node_api_client
node_customer_views -.->|"requests data"| node_api_client
node_underwriter_views -.->|"requests cases"| node_api_client
node_case_ui -->|"requests evidence"| node_api_client
node_admin_ui -->|"manages users"| node_api_client
node_api_client -->|"proxies API"| node_backend_api
node_browser -->|"uses frontend proxy"| node_backend_api
node_backend_api -->|"authenticates requests"| node_auth
node_backend_api -->|"queries records"| node_domain_models
node_domain_models -->|"maps tables"| node_database
node_backend_api -->|"assesses risk"| node_risk
node_backend_api -->|"computes cohort evidence"| node_statistics
node_backend_api -->|"requests graph evidence"| node_graph_service
node_backend_api -->|"retrieves policy context"| node_rag
node_backend_api -->|"requests summary"| node_ai_underwriter
node_graph_service -->|"syncs graph facts"| node_integrations
node_rag -->|"retrieves chunks"| node_integrations
node_ai_underwriter -->|"requests inference"| node_integrations
node_integrations -->|"reads and writes graph"| node_neo4j
node_integrations -->|"calls inference"| node_hf
node_case_ui -->|"renders graph"| node_graph_ui
node_claims_ui -.->|"claims workflow"| node_backend_api
node_claims_intel_ui -.->|"requests intelligence"| node_backend_api
node_fraud_ui -.->|"requests fraud review"| node_backend_api
node_policy_ui -.->|"requests policies"| node_backend_api
node_premium_ui -.->|"requests premiums"| node_backend_api
node_provider_ui -.->|"requests providers"| node_backend_api
node_risk_ui -.->|"requests risk data"| node_backend_api
node_graph_ui -.->|"requests graph data"| node_backend_api

click node_application_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/new-application/page.tsx"
click node_customer_views "https://github.com/sanvi0401/risksure/blob/main/frontend/app/customer/page.tsx"
click node_underwriter_views "https://github.com/sanvi0401/risksure/blob/main/frontend/app/underwriter/page.tsx"
click node_case_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/case-intelligence/page.tsx"
click node_admin_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/admin/page.tsx"
click node_claims_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/claims/page.tsx"
click node_claims_intel_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/claims-intelligence/page.tsx"
click node_fraud_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/fraud/page.tsx"
click node_policy_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/policy/page.tsx"
click node_premium_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/premium/page.tsx"
click node_provider_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/provider/page.tsx"
click node_risk_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/risk/page.tsx"
click node_graph_ui "https://github.com/sanvi0401/risksure/blob/main/frontend/app/relationship-graph/page.tsx"
click node_api_client "https://github.com/sanvi0401/risksure/blob/main/frontend/lib/api.ts"
click node_backend_api "https://github.com/sanvi0401/risksure/blob/main/backend/app.py"
click node_auth "https://github.com/sanvi0401/risksure/blob/main/backend/app.py"
click node_domain_models "https://github.com/sanvi0401/risksure/blob/main/backend/models.py"
click node_database "https://github.com/sanvi0401/risksure/blob/main/backend/database.py"
click node_risk "https://github.com/sanvi0401/risksure/blob/main/backend/services/risk_service.py"
click node_statistics "https://github.com/sanvi0401/risksure/blob/main/backend/services/statistical_analysis_service.py"
click node_graph_service "https://github.com/sanvi0401/risksure/blob/main/backend/services/neo4j_service.py"
click node_rag "https://github.com/sanvi0401/risksure/blob/main/backend/services/rag_service.py"
click node_ai_underwriter "https://github.com/sanvi0401/risksure/blob/main/backend/services/ai_underwriter_service.py"
click node_integrations "https://github.com/sanvi0401/risksure/blob/main/backend/integrations.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_application_ui,node_customer_views,node_underwriter_views,node_case_ui,node_admin_ui,node_claims_ui,node_claims_intel_ui,node_fraud_ui,node_policy_ui,node_premium_ui,node_provider_ui,node_risk_ui,node_graph_ui,node_api_client,node_browser toneBlue
class node_risk,node_neo4j toneAmber
class node_statistics,node_graph_service,node_rag,node_ai_underwriter toneMint
class node_backend_api,node_auth,node_domain_models,node_database,node_integrations,node_hf toneIndigo
```

## Components

### User experience

- [Application entry](https://github.com/sanvi0401/risksure/blob/main/frontend/app/new-application/page.tsx): `frontend/app/new-application/page.tsx`
- [Customer views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/customer/page.tsx): `frontend/app/customer/page.tsx`
- [Underwriter views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/underwriter/page.tsx): `frontend/app/underwriter/page.tsx`
- [Case intelligence](https://github.com/sanvi0401/risksure/blob/main/frontend/app/case-intelligence/page.tsx): `frontend/app/case-intelligence/page.tsx`
- [Administration](https://github.com/sanvi0401/risksure/blob/main/frontend/app/admin/page.tsx): `frontend/app/admin/page.tsx`
- [Claims views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/claims/page.tsx): `frontend/app/claims/page.tsx`
- [Claims intelligence](https://github.com/sanvi0401/risksure/blob/main/frontend/app/claims-intelligence/page.tsx): `frontend/app/claims-intelligence/page.tsx`
- [Fraud views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/fraud/page.tsx): `frontend/app/fraud/page.tsx`
- [Policy views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/policy/page.tsx): `frontend/app/policy/page.tsx`
- [Premium views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/premium/page.tsx): `frontend/app/premium/page.tsx`
- [Provider views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/provider/page.tsx): `frontend/app/provider/page.tsx`
- [Risk views](https://github.com/sanvi0401/risksure/blob/main/frontend/app/risk/page.tsx): `frontend/app/risk/page.tsx`
- [Relationship graph](https://github.com/sanvi0401/risksure/blob/main/frontend/app/relationship-graph/page.tsx): `frontend/app/relationship-graph/page.tsx`
- [API client](https://github.com/sanvi0401/risksure/blob/main/frontend/lib/api.ts): `frontend/lib/api.ts`

### Underwriting workflow

- [Risk assessment](https://github.com/sanvi0401/risksure/blob/main/backend/services/risk_service.py): `backend/services/risk_service.py`

### Risk intelligence

- [Cohort analysis](https://github.com/sanvi0401/risksure/blob/main/backend/services/statistical_analysis_service.py): `backend/services/statistical_analysis_service.py`
- [Relationship projection](https://github.com/sanvi0401/risksure/blob/main/backend/services/neo4j_service.py): `backend/services/neo4j_service.py`
- [Policy retrieval](https://github.com/sanvi0401/risksure/blob/main/backend/services/rag_service.py): `backend/services/rag_service.py`
- [Evidence assistant](https://github.com/sanvi0401/risksure/blob/main/backend/services/ai_underwriter_service.py): `backend/services/ai_underwriter_service.py`

### Backend platform

- [Flask API](https://github.com/sanvi0401/risksure/blob/main/backend/app.py): `backend/app.py`
- [Authentication](https://github.com/sanvi0401/risksure/blob/main/backend/app.py): `backend/app.py`
- [Insurance records](https://github.com/sanvi0401/risksure/blob/main/backend/models.py): `backend/models.py`
- [PostgreSQL](https://github.com/sanvi0401/risksure/blob/main/backend/database.py): `backend/database.py`
- [External integrations](https://github.com/sanvi0401/risksure/blob/main/backend/integrations.py): `backend/integrations.py`

### Other components

- **Browser users**
- **Neo4j**
- **Hugging Face inference**

## Connections

- Browser users → Application entry: enters application
- Browser users → Customer views: reviews account
- Browser users → Underwriter views: reviews cases
- Application entry → API client: submits data
- Customer views → API client: requests data
- Underwriter views → API client: requests cases
- Case intelligence → API client: requests evidence (evidence: `frontend/app/case-intelligence/page.tsx`)
- Administration → API client: manages users (evidence: `frontend/app/admin/page.tsx`)
- API client → Flask API: proxies API (evidence: `README.md`)
- Browser users → Flask API: uses frontend proxy (evidence: `README.md`)
- Flask API → Authentication: authenticates requests (evidence: `backend/app.py`)
- Flask API → Insurance records: queries records (evidence: `backend/app.py`)
- Insurance records → PostgreSQL: maps tables (evidence: `backend/models.py`)
- Flask API → Risk assessment: assesses risk (evidence: `backend/app.py`)
- Flask API → Cohort analysis: computes cohort evidence (evidence: `backend/app.py`)
- Flask API → Relationship projection: requests graph evidence (evidence: `backend/app.py`)
- Flask API → Policy retrieval: retrieves policy context (evidence: `backend/app.py`)
- Flask API → Evidence assistant: requests summary (evidence: `backend/app.py`)
- Relationship projection → External integrations: syncs graph facts (evidence: `backend/services/neo4j_service.py`)
- Policy retrieval → External integrations: retrieves chunks (evidence: `backend/services/rag_service.py`)
- Evidence assistant → External integrations: requests inference (evidence: `backend/services/ai_underwriter_service.py`)
- External integrations → Neo4j: reads and writes graph (evidence: `backend/integrations.py`)
- External integrations → Hugging Face inference: calls inference (evidence: `backend/integrations.py`)
- Case intelligence → Relationship graph: renders graph (evidence: `frontend/app/case-intelligence/page.tsx`)
- Claims views → Flask API: claims workflow
- Claims intelligence → Flask API: requests intelligence
- Fraud views → Flask API: requests fraud review
- Policy views → Flask API: requests policies
- Premium views → Flask API: requests premiums
- Provider views → Flask API: requests providers
- Risk views → Flask API: requests risk data
- Relationship graph → Flask API: requests graph data
