# vedikakute06/insurgenie architecture

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

- Interactive diagram: https://gitdiagram.com/vedikakute06/insurgenie
- Repository: https://github.com/vedikakute06/insurgenie

## Overview

InsurGenie is a wellness-oriented insurance platform: users sign in, log activity, and view scores and rewards, while a separate underwriting flow calculates risk from health, lifestyle, and driving inputs. The frontend routes to backend HTTP endpoints; backend handlers delegate to risk, authentication, and gamification logic backed by Supabase. The README also describes Google Fit tracking, but the sampled service is not shown wired into the activity endpoint. The graph includes documented capabilities while avoiding unverified connections.

Main entry points: [`backend/app/main.py`](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/main.py) (HTTP endpoints), [`frontend/src/App.jsx`](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/App.jsx) (Route and session app), [`backend/app/database.py`](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/database.py) (Supabase client), [`backend/app/auth.py`](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/auth.py) (Google identity logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_app["Route and session app<br/>[App.jsx]"]
  node_login["Google sign-in<br/>[Login.jsx]"]
  node_dashboard_ui["Wellness dashboard<br/>[Dashboard.jsx]"]
  node_activity_ui["Activity entry<br/>[Gamification.jsx]"]
  node_home_ui["Welcome page<br/>[Home.jsx]"]
end

subgraph group_api["Backend API"]
  node_api_routes["HTTP endpoints<br/>[main.py]"]
end

subgraph group_underwriting["Risk assessment"]
  node_risk["Risk scoring engine<br/>[risk_engine.py]"]
  node_user_schema["Risk input schema<br/>[schemas.py]"]
end

subgraph group_wellness["Wellness and rewards"]
  node_gamification["Activity and rewards<br/>[gamification.py]"]
  node_fitness_controller["Fitness controller<br/>[fitness.py]"]
  node_google_fit["Google Fit client<br/>[google_fit.py]"]
end

subgraph group_identity["Authentication and storage"]
  node_auth["Google identity logic<br/>[auth.py]"]
  node_database_client["Supabase client<br/>[database.py]"]
  node_supabase[("Supabase data store")]
end

node_user(("Policyholder"))
node_google(("Google identity provider"))

node_user -->|"signs in"| node_login
node_login -->|"posts token"| node_api_routes
node_api_routes -->|"verifies and resolves"| node_auth
node_auth -->|"verifies token"| node_google
node_auth -->|"queries and inserts"| node_database_client
node_database_client -->|"connects"| node_supabase
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_activity_ui
node_app -->|"routes to"| node_home_ui
node_dashboard_ui -->|"gets dashboard"| node_api_routes
node_activity_ui -->|"posts activity"| node_api_routes
node_api_routes -->|"calculates risk"| node_risk
node_api_routes -->|"validates risk input"| node_user_schema
node_api_routes -->|"records and reads"| node_gamification
node_api_routes -->|"updates score"| node_database_client
node_gamification -->|"reads and writes"| node_database_client
node_fitness_controller -->|"calls service"| node_google_fit

click node_app "https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Login.jsx"
click node_dashboard_ui "https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Dashboard.jsx"
click node_activity_ui "https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Gamification.jsx"
click node_home_ui "https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Home.jsx"
click node_api_routes "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/main.py"
click node_risk "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/controllers/risk_engine.py"
click node_user_schema "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/schemas/schemas.py"
click node_auth "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/auth.py"
click node_gamification "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/gamification.py"
click node_fitness_controller "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/controllers/fitness.py"
click node_google_fit "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/services/google_fit.py"
click node_database_client "https://github.com/vedikakute06/insurgenie/blob/main/backend/app/database.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_app,node_login,node_dashboard_ui,node_activity_ui,node_home_ui toneBlue
class node_api_routes toneAmber
class node_risk,node_user_schema toneMint
class node_gamification,node_fitness_controller,node_google_fit toneRose
class node_auth,node_database_client,node_supabase,node_user,node_google toneIndigo
```

## Components

### User interface

- [Route and session app](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Google sign-in](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Wellness dashboard](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Activity entry](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Gamification.jsx): `frontend/src/pages/Gamification.jsx`
- [Welcome page](https://github.com/vedikakute06/insurgenie/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`

### Backend API

- [HTTP endpoints](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/main.py): `backend/app/main.py`

### Risk assessment

- [Risk scoring engine](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/controllers/risk_engine.py): `backend/app/controllers/risk_engine.py`
- [Risk input schema](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/schemas/schemas.py): `backend/app/schemas/schemas.py`

### Wellness and rewards

- [Activity and rewards](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/gamification.py): `backend/app/gamification.py`
- [Fitness controller](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/controllers/fitness.py): `backend/app/controllers/fitness.py`
- [Google Fit client](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/services/google_fit.py): `backend/app/services/google_fit.py`

### Authentication and storage

- [Google identity logic](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/auth.py): `backend/app/auth.py`
- [Supabase client](https://github.com/vedikakute06/insurgenie/blob/main/backend/app/database.py): `backend/app/database.py`
- **Supabase data store**

### Other components

- **Policyholder**
- **Google identity provider**

## Connections

- Policyholder → Google sign-in: signs in (evidence: `frontend/src/pages/Login.jsx`)
- Google sign-in → HTTP endpoints: posts token (evidence: `frontend/src/pages/Login.jsx`)
- HTTP endpoints → Google identity logic: verifies and resolves (evidence: `backend/app/main.py`)
- Google identity logic → Google identity provider: verifies token (evidence: `backend/app/auth.py`)
- Google identity logic → Supabase client: queries and inserts (evidence: `backend/app/auth.py`)
- Supabase client → Supabase data store: connects (evidence: `backend/app/database.py`)
- Route and session app → Google sign-in: routes to (evidence: `frontend/src/App.jsx`)
- Route and session app → Wellness dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route and session app → Activity entry: routes to (evidence: `frontend/src/App.jsx`)
- Route and session app → Welcome page: routes to (evidence: `frontend/src/App.jsx`)
- Wellness dashboard → HTTP endpoints: gets dashboard (evidence: `frontend/src/pages/Dashboard.jsx`)
- Activity entry → HTTP endpoints: posts activity (evidence: `frontend/src/pages/Gamification.jsx`)
- HTTP endpoints → Risk scoring engine: calculates risk (evidence: `backend/app/main.py`)
- HTTP endpoints → Risk input schema: validates risk input (evidence: `backend/app/main.py`)
- HTTP endpoints → Activity and rewards: records and reads (evidence: `backend/app/main.py`)
- HTTP endpoints → Supabase client: updates score (evidence: `backend/app/main.py`)
- Activity and rewards → Supabase client: reads and writes (evidence: `backend/app/gamification.py`)
- Fitness controller → Google Fit client: calls service (evidence: `backend/app/controllers/fitness.py`)
