# krish-bhavsar19/group-expense-management architecture

> Architecture diagram of the GitHub repository krish-bhavsar19/group-expense-management, 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/krish-bhavsar19/group-expense-management
- Repository: https://github.com/krish-bhavsar19/group-expense-management

## Overview

This is a full-stack group-expense platform. Members authenticate, create or join groups, record and split expenses (including receipt and AI-assisted entry), then review calculated settlements. The graph preserves the documented authentication, invitation, subgroup, expense, and settlement stages. Some frontend pages and backend modules were not excerpted, so their capability links rely on README documentation; uncertain internal calls are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/App.jsx) (Routes and app shell), [`backend/server.js`](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/server.js) (HTTP server), [`frontend/src/config/api.js`](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/config/api.js) (API client), [`backend/middleware/auth.js`](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/middleware/auth.js) (JWT protection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Routes and app shell<br/>[App.jsx]"]
  node_authui["Auth screens"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_groupui["Group views<br/>[Groups.jsx]"]
  node_groupdetails["Group details<br/>[GroupDetails.jsx]"]
  node_joinui["Join group view<br/>[JoinGroup.jsx]"]
  node_expenseui["Expense views<br/>[AddExpense.jsx]"]
  node_voiceui["Voice entry"]
  node_settlementui["Settlement view<br/>[Settlement.jsx]"]
end

subgraph group_identity["Identity"]
  node_server["HTTP server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_authmiddleware["JWT protection<br/>[auth.js]"]
  node_users["User records<br/>[User.js]"]
  node_jwt["JWT utility<br/>[jwt.js]"]
  node_email["Email delivery<br/>[email.js]"]
end

subgraph group_groups["Groups and membership"]
  node_groupsroutes["Group routes<br/>[groups.js]"]
  node_inviteroutes["Invite routes<br/>[invite.js]"]
  node_grouproutes["Subgroup routes<br/>[subgroups.js]"]
  node_groupcontroller["Group controller<br/>[groupController.js]"]
  node_invitecontroller["Invite controller"]
  node_subgroupcontroller["Subgroup controller"]
  node_groupauth["Membership checks<br/>[groupAuth.js]"]
  node_groupmodels["Group and membership records"]
  node_joinrequests["Join request records<br/>[JoinRequest.js]"]
end

subgraph group_finance["Expense and settlement"]
  node_expensesroutes["Expense routes<br/>[expenses.js]"]
  node_expensecontroller["Expense controller"]
  node_expensemodel["Expense records<br/>[Expense.js]"]
  node_ai["AI parser<br/>[aiService.js]"]
  node_settlementroutes["Settlement routes<br/>[settlement.js]"]
  node_settlementcontroller["Settlement controller"]
  node_settlementmodel["Settlement records<br/>[Settlement.js]"]
end

node_member(("Member"))

node_member -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_groupui
node_app -->|"routes to"| node_groupdetails
node_app -->|"routes to"| node_joinui
node_app -->|"routes to"| node_expenseui
node_app -->|"routes to"| node_settlementui
node_app -->|"provides"| node_authstate
node_authui -->|"uses"| node_authstate
node_authui -->|"calls"| node_api
node_authstate -->|"uses"| node_api
node_groupui -.->|"calls"| node_api
node_groupdetails -->|"calls"| node_api
node_joinui -.->|"calls"| node_api
node_expenseui -.->|"calls"| node_api
node_voiceui -.->|"assists entry"| node_expenseui
node_expenseui -.->|"requests APIs"| node_server
node_settlementui -.->|"requests APIs"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_groupsroutes
node_server -->|"mounts"| node_inviteroutes
node_server -->|"mounts"| node_expensesroutes
node_server -->|"mounts"| node_settlementroutes
node_server -->|"mounts"| node_grouproutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"protects"| node_authmiddleware
node_authcontroller -->|"reads and updates"| node_users
node_authcontroller -->|"generates tokens"| node_jwt
node_authcontroller -->|"sends OTP email"| node_email
node_authmiddleware -->|"verifies token"| node_jwt
node_authmiddleware -->|"loads user"| node_users
node_groupsroutes -->|"dispatches"| node_groupcontroller
node_groupsroutes -->|"dispatches"| node_invitecontroller
node_inviteroutes -->|"dispatches"| node_invitecontroller
node_grouproutes -->|"dispatches"| node_subgroupcontroller
node_groupcontroller -->|"manages groups"| node_groupmodels
node_invitecontroller -->|"looks up membership"| node_groupmodels
node_invitecontroller -->|"creates and handles"| node_joinrequests
node_subgroupcontroller -->|"checks membership"| node_groupmodels
node_groupauth -->|"checks membership"| node_groupmodels
node_expensesroutes -->|"dispatches"| node_expensecontroller
node_expensesroutes -->|"protects"| node_authmiddleware
node_expensesroutes -->|"checks access"| node_groupauth
node_expensecontroller -->|"creates and queries"| node_expensemodel
node_expensecontroller -->|"checks membership"| node_groupmodels
node_expensecontroller -->|"parses voice input"| node_ai
node_settlementroutes -->|"dispatches"| node_settlementcontroller
node_settlementroutes -->|"protects"| node_authmiddleware

click node_app "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/krish-bhavsar19/group-expense-management/tree/main/frontend/src/components/Auth"
click node_authstate "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/config/api.js"
click node_groupui "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/Groups.jsx"
click node_groupdetails "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/GroupDetails.jsx"
click node_joinui "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/JoinGroup.jsx"
click node_expenseui "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/AddExpense.jsx"
click node_voiceui "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/components/VoiceExpenseInput.jsx"
click node_settlementui "https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/Settlement.jsx"
click node_server "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/server.js"
click node_authroutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/auth.js"
click node_authcontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/authController.js"
click node_authmiddleware "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/middleware/auth.js"
click node_users "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/User.js"
click node_jwt "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/utils/jwt.js"
click node_email "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/utils/email.js"
click node_groupsroutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/groups.js"
click node_inviteroutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/invite.js"
click node_grouproutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/subgroups.js"
click node_groupcontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/groupController.js"
click node_invitecontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/inviteController.js"
click node_subgroupcontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/subgroupController.js"
click node_groupauth "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/middleware/groupAuth.js"
click node_groupmodels "https://github.com/krish-bhavsar19/group-expense-management/tree/main/backend/models"
click node_joinrequests "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/JoinRequest.js"
click node_expensesroutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/expenses.js"
click node_expensecontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/expenseController.js"
click node_expensemodel "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/Expense.js"
click node_ai "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/services/aiService.js"
click node_settlementroutes "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/settlement.js"
click node_settlementcontroller "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/settlementController.js"
click node_settlementmodel "https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/Settlement.js"

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_authui,node_authstate,node_api,node_groupui,node_groupdetails,node_joinui,node_expenseui,node_voiceui,node_settlementui toneBlue
class node_server,node_authroutes,node_authcontroller,node_authmiddleware,node_users,node_jwt,node_email toneAmber
class node_groupsroutes,node_inviteroutes,node_grouproutes,node_groupcontroller,node_invitecontroller,node_subgroupcontroller,node_groupauth,node_groupmodels,node_joinrequests toneMint
class node_expensesroutes,node_expensecontroller,node_expensemodel,node_ai,node_settlementroutes,node_settlementcontroller,node_settlementmodel toneRose
class node_member toneIndigo
```

## Components

### Web client

- [Routes and app shell](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth screens](https://github.com/krish-bhavsar19/group-expense-management/tree/main/frontend/src/components/Auth): `frontend/src/components/Auth`
- [Auth state](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/config/api.js): `frontend/src/config/api.js`
- [Group views](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/Groups.jsx): `frontend/src/pages/Groups.jsx`
- [Group details](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/GroupDetails.jsx): `frontend/src/pages/GroupDetails.jsx`
- [Join group view](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/JoinGroup.jsx): `frontend/src/pages/JoinGroup.jsx`
- [Expense views](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/AddExpense.jsx): `frontend/src/pages/AddExpense.jsx`
- [Voice entry](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/components/VoiceExpenseInput.jsx): `frontend/src/components/VoiceExpenseInput.jsx`
- [Settlement view](https://github.com/krish-bhavsar19/group-expense-management/blob/main/frontend/src/pages/Settlement.jsx): `frontend/src/pages/Settlement.jsx`

### Identity

- [HTTP server](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Auth controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [JWT protection](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [User records](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/User.js): `backend/models/User.js`
- [JWT utility](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/utils/jwt.js): `backend/utils/jwt.js`
- [Email delivery](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/utils/email.js): `backend/utils/email.js`

### Groups and membership

- [Group routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/groups.js): `backend/routes/groups.js`
- [Invite routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/invite.js): `backend/routes/invite.js`
- [Subgroup routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/subgroups.js): `backend/routes/subgroups.js`
- [Group controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/groupController.js): `backend/controllers/groupController.js`
- [Invite controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/inviteController.js): `backend/controllers/inviteController.js`
- [Subgroup controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/subgroupController.js): `backend/controllers/subgroupController.js`
- [Membership checks](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/middleware/groupAuth.js): `backend/middleware/groupAuth.js`
- [Group and membership records](https://github.com/krish-bhavsar19/group-expense-management/tree/main/backend/models): `backend/models`
- [Join request records](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/JoinRequest.js): `backend/models/JoinRequest.js`

### Expense and settlement

- [Expense routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/expenses.js): `backend/routes/expenses.js`
- [Expense controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/expenseController.js): `backend/controllers/expenseController.js`
- [Expense records](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/Expense.js): `backend/models/Expense.js`
- [AI parser](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/services/aiService.js): `backend/services/aiService.js`
- [Settlement routes](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/routes/settlement.js): `backend/routes/settlement.js`
- [Settlement controller](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/controllers/settlementController.js): `backend/controllers/settlementController.js`
- [Settlement records](https://github.com/krish-bhavsar19/group-expense-management/blob/main/backend/models/Settlement.js): `backend/models/Settlement.js`

### Other components

- **Member**

## Connections

- Member → Routes and app shell: uses (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Auth screens: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Group views: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Group details: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Join group view: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Expense views: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Settlement view: routes to (evidence: `frontend/src/App.jsx`)
- Routes and app shell → Auth state: provides (evidence: `frontend/src/App.jsx`)
- Auth screens → Auth state: uses (evidence: `frontend/src/components/Auth/Login.jsx`)
- Auth screens → API client: calls (evidence: `frontend/src/components/Auth/Login.jsx`)
- Auth state → API client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- Group views → API client: calls
- Group details → API client: calls (evidence: `frontend/src/pages/GroupDetails.jsx`)
- Join group view → API client: calls
- Expense views → API client: calls
- Voice entry → Expense views: assists entry
- Expense views → HTTP server: requests APIs
- Settlement view → HTTP server: requests APIs
- HTTP server → Auth routes: mounts (evidence: `backend/server.js`)
- HTTP server → Group routes: mounts (evidence: `backend/server.js`)
- HTTP server → Invite routes: mounts (evidence: `backend/server.js`)
- HTTP server → Expense routes: mounts (evidence: `backend/server.js`)
- HTTP server → Settlement routes: mounts (evidence: `backend/server.js`)
- HTTP server → Subgroup routes: mounts (evidence: `backend/server.js`)
- Auth routes → Auth controller: dispatches (evidence: `backend/routes/auth.js`)
- Auth routes → JWT protection: protects (evidence: `backend/routes/auth.js`)
- Auth controller → User records: reads and updates (evidence: `backend/controllers/authController.js`)
- Auth controller → JWT utility: generates tokens (evidence: `backend/controllers/authController.js`)
- Auth controller → Email delivery: sends OTP email (evidence: `backend/controllers/authController.js`)
- JWT protection → JWT utility: verifies token (evidence: `backend/middleware/auth.js`)
- JWT protection → User records: loads user (evidence: `backend/middleware/auth.js`)
- Group routes → Group controller: dispatches (evidence: `backend/routes/groups.js`)
- Group routes → Invite controller: dispatches (evidence: `backend/routes/groups.js`)
- Invite routes → Invite controller: dispatches (evidence: `backend/routes/invite.js`)
- Subgroup routes → Subgroup controller: dispatches (evidence: `backend/routes/subgroups.js`)
- Group controller → Group and membership records: manages groups (evidence: `backend/controllers/groupController.js`)
- Invite controller → Group and membership records: looks up membership (evidence: `backend/controllers/inviteController.js`)
- Invite controller → Join request records: creates and handles (evidence: `backend/controllers/inviteController.js`)
- Subgroup controller → Group and membership records: checks membership (evidence: `backend/controllers/subgroupController.js`)
- Membership checks → Group and membership records: checks membership (evidence: `backend/middleware/groupAuth.js`)
- Expense routes → Expense controller: dispatches (evidence: `backend/routes/expenses.js`)
- Expense routes → JWT protection: protects (evidence: `backend/routes/expenses.js`)
- Expense routes → Membership checks: checks access (evidence: `backend/routes/expenses.js`)
- Expense controller → Expense records: creates and queries (evidence: `backend/controllers/expenseController.js`)
- Expense controller → Group and membership records: checks membership (evidence: `backend/controllers/expenseController.js`)
- Expense controller → AI parser: parses voice input (evidence: `backend/controllers/expenseController.js`)
- Settlement routes → Settlement controller: dispatches (evidence: `backend/routes/settlement.js`)
- Settlement routes → JWT protection: protects (evidence: `backend/routes/settlement.js`)
