How krish-bhavsar19/group-expense-management works
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: App.jsx Routes and app shell · server.js HTTP server · api.js API client · auth.js JWT protection
Components 34
Web client
- Routes and app shell
frontend/src/App.jsx - Auth screens
frontend/src/components/Auth - Auth state
frontend/src/context/AuthContext.jsx - API client
frontend/src/config/api.js - Group views
frontend/src/pages/Groups.jsx - Group details
frontend/src/pages/GroupDetails.jsx - Join group view
frontend/src/pages/JoinGroup.jsx - Expense views
frontend/src/pages/AddExpense.jsx - Voice entry
frontend/src/components/VoiceExpenseInput.jsx - Settlement view
frontend/src/pages/Settlement.jsx
Identity
- HTTP server
backend/server.js - Auth routes
backend/routes/auth.js - Auth controller
backend/controllers/authController.js - JWT protection
backend/middleware/auth.js - User records
backend/models/User.js - JWT utility
backend/utils/jwt.js - Email delivery
backend/utils/email.js
Groups and membership
- Group routes
backend/routes/groups.js - Invite routes
backend/routes/invite.js - Subgroup routes
backend/routes/subgroups.js - Group controller
backend/controllers/groupController.js - Invite controller
backend/controllers/inviteController.js - Subgroup controller
backend/controllers/subgroupController.js - Membership checks
backend/middleware/groupAuth.js - Group and membership records
backend/models - Join request records
backend/models/JoinRequest.js
Expense and settlement
- Expense routes
backend/routes/expenses.js - Expense controller
backend/controllers/expenseController.js - Expense records
backend/models/Expense.js - AI parser
backend/services/aiService.js - Settlement routes
backend/routes/settlement.js - Settlement controller
backend/controllers/settlementController.js - Settlement records
backend/models/Settlement.js
Other components
- Member
Connections 48
- Member → Routes and app shell: uses
frontend/src/App.jsx - Routes and app shell → Auth screens: routes to
frontend/src/App.jsx - Routes and app shell → Group views: routes to
frontend/src/App.jsx - Routes and app shell → Group details: routes to
frontend/src/App.jsx - Routes and app shell → Join group view: routes to
frontend/src/App.jsx - Routes and app shell → Expense views: routes to
frontend/src/App.jsx - Routes and app shell → Settlement view: routes to
frontend/src/App.jsx - Routes and app shell → Auth state: provides
frontend/src/App.jsx - Auth screens → Auth state: uses
frontend/src/components/Auth/Login.jsx - Auth screens → API client: calls
frontend/src/components/Auth/Login.jsx - Auth state → API client: uses
frontend/src/context/AuthContext.jsx - Group views → API client: calls
- Group details → API client: calls
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
backend/server.js - HTTP server → Group routes: mounts
backend/server.js - HTTP server → Invite routes: mounts
backend/server.js - HTTP server → Expense routes: mounts
backend/server.js - HTTP server → Settlement routes: mounts
backend/server.js - HTTP server → Subgroup routes: mounts
backend/server.js - Auth routes → Auth controller: dispatches
backend/routes/auth.js - Auth routes → JWT protection: protects
backend/routes/auth.js - Auth controller → User records: reads and updates
backend/controllers/authController.js - Auth controller → JWT utility: generates tokens
backend/controllers/authController.js - Auth controller → Email delivery: sends OTP email
backend/controllers/authController.js - JWT protection → JWT utility: verifies token
backend/middleware/auth.js - JWT protection → User records: loads user
backend/middleware/auth.js - Group routes → Group controller: dispatches
backend/routes/groups.js - Group routes → Invite controller: dispatches
backend/routes/groups.js - Invite routes → Invite controller: dispatches
backend/routes/invite.js - Subgroup routes → Subgroup controller: dispatches
backend/routes/subgroups.js - Group controller → Group and membership records: manages groups
backend/controllers/groupController.js - Invite controller → Group and membership records: looks up membership
backend/controllers/inviteController.js - Invite controller → Join request records: creates and handles
backend/controllers/inviteController.js - Subgroup controller → Group and membership records: checks membership
backend/controllers/subgroupController.js - Membership checks → Group and membership records: checks membership
backend/middleware/groupAuth.js - Expense routes → Expense controller: dispatches
backend/routes/expenses.js - Expense routes → JWT protection: protects
backend/routes/expenses.js - Expense routes → Membership checks: checks access
backend/routes/expenses.js - Expense controller → Expense records: creates and queries
backend/controllers/expenseController.js - Expense controller → Group and membership records: checks membership
backend/controllers/expenseController.js - Expense controller → AI parser: parses voice input
backend/controllers/expenseController.js - Settlement routes → Settlement controller: dispatches
backend/routes/settlement.js - Settlement routes → JWT protection: protects
backend/routes/settlement.js