# sahil-das/clubkhata-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/sahil-das/clubkhata-frontend
- Repository: https://github.com/sahil-das/clubkhata-frontend

## Overview

This is a React application for managing club finances and operations, with a separate platform-administration area. The main workflow is an authenticated user entering a routed club workspace, selecting operational or financial features, and using those screens to work with API-backed data. The graph preserves major feature areas visible in the tree, while detailed call relationships are limited to the supplied excerpts and SOURCE INDEX references; unsampled page behavior is not inferred.

Main entry points: [`src/App.jsx`](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/App.jsx) (Router and layouts), [`src/api/axios.js`](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/axios.js) (HTTP client), [`src/pages/VendorHiring.jsx`](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/VendorHiring.jsx) (Vendor rentals), [`src/pages/Settings.jsx`](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Settings.jsx) (Club settings and years)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Router and layouts<br/>[App.jsx]"]
end

subgraph group_identity["Identity and shared state"]
  node_auth["Authentication<br/>[AuthContext.jsx]"]
  node_api["HTTP client<br/>[axios.js]"]
  node_theme["Theme preferences<br/>[ThemeContext.jsx]"]
  node_toast["Toast notifications<br/>[ToastContext.jsx]"]
end

subgraph group_club["Club operations"]
  node_members["Members and profiles<br/>[MemberDetails.jsx]"]
  node_polls["Polls<br/>[Polls.jsx]"]
  node_notices["Notices<br/>[NoticeBoard.jsx]"]
  node_rentals["Vendor rentals<br/>[VendorHiring.jsx]"]
  node_rental_api["Rental operations API<br/>[rentals.js]"]
  node_rental_dialogs["Rental dialogs"]
end

subgraph group_finance["Finance and records"]
  node_finance["Finance workspace<br/>[DashboardHome.jsx]"]
  node_contributions["Contributions<br/>[Contributions.jsx]"]
  node_puja["Festival contributions"]
  node_donations["Donations<br/>[Donations.jsx]"]
  node_expenses["Expenses and budgets<br/>[Budgeting.jsx]"]
  node_assets["Assets<br/>[Assets.jsx]"]
  node_records["Archives and reports<br/>[ArchiveReport.jsx]"]
  node_settings["Club settings and years<br/>[Settings.jsx]"]
  node_years_api["Festival-year API<br/>[years.js]"]
  node_year_dialog["Create-year dialog"]
  node_pdf["PDF exports<br/>[pdfExport.js]"]
end

subgraph group_platform["Platform administration"]
  node_platform["Platform administration"]
  node_platform_api["Platform API<br/>[platform.js]"]
end

node_member(("Club user"))
node_server{{"Application API"}}

node_member -->|"opens"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes to"| node_finance
node_app -->|"routes to"| node_platform
node_auth -->|"auth requests"| node_api
node_app -->|"provides theme"| node_theme
node_app -->|"provides notifications"| node_toast
node_app -->|"routes to"| node_members
node_app -->|"routes to"| node_polls
node_app -->|"routes to"| node_rentals
node_app -->|"routes to"| node_expenses
node_app -->|"routes to"| node_assets
node_app -->|"routes to"| node_records
node_app -->|"routes to"| node_settings
node_rentals -->|"calls"| node_rental_api
node_rental_api -->|"uses client"| node_api
node_rentals -->|"renders"| node_rental_dialogs
node_settings -->|"calls"| node_years_api
node_settings -->|"uses"| node_year_dialog
node_years_api -->|"uses client"| node_api
node_platform -->|"calls"| node_platform_api
node_platform_api -->|"uses client"| node_api
node_members -->|"calls"| node_api
node_puja -->|"calls"| node_api
node_puja -->|"exports"| node_pdf
node_api -->|"sends requests"| node_server

click node_app "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/App.jsx"
click node_auth "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/AuthContext.jsx"
click node_api "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/axios.js"
click node_theme "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/ThemeContext.jsx"
click node_toast "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/ToastContext.jsx"
click node_members "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/MemberDetails.jsx"
click node_polls "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Polls.jsx"
click node_notices "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/NoticeBoard.jsx"
click node_rentals "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/VendorHiring.jsx"
click node_rental_api "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/rentals.js"
click node_rental_dialogs "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/rentals/CreateOrderModal.jsx"
click node_finance "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/DashboardHome.jsx"
click node_contributions "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Contributions.jsx"
click node_puja "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/PujaContributions.jsx"
click node_donations "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Donations.jsx"
click node_expenses "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Budgeting.jsx"
click node_assets "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Assets.jsx"
click node_records "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/ArchiveReport.jsx"
click node_settings "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Settings.jsx"
click node_years_api "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/years.js"
click node_year_dialog "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/CreateYearModal.jsx"
click node_platform "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/platform/PlatformDashboard.jsx"
click node_platform_api "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/platform.js"
click node_pdf "https://github.com/sahil-das/clubkhata-frontend/blob/main/src/utils/pdfExport.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_member toneBlue
class node_auth,node_api,node_theme,node_toast toneAmber
class node_members,node_polls,node_notices,node_rentals,node_rental_api,node_rental_dialogs,node_server toneMint
class node_finance,node_contributions,node_puja,node_donations,node_expenses,node_assets,node_records,node_settings,node_years_api,node_year_dialog,node_pdf toneRose
class node_platform,node_platform_api toneIndigo
```

## Components

### Application shell

- [Router and layouts](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/App.jsx): `src/App.jsx`

### Identity and shared state

- [Authentication](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [HTTP client](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/axios.js): `src/api/axios.js`
- [Theme preferences](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/ThemeContext.jsx): `src/context/ThemeContext.jsx`
- [Toast notifications](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/context/ToastContext.jsx): `src/context/ToastContext.jsx`

### Club operations

- [Members and profiles](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/MemberDetails.jsx): `src/pages/MemberDetails.jsx`
- [Polls](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Polls.jsx): `src/pages/Polls.jsx`
- [Notices](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/NoticeBoard.jsx): `src/components/NoticeBoard.jsx`
- [Vendor rentals](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/VendorHiring.jsx): `src/pages/VendorHiring.jsx`
- [Rental operations API](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/rentals.js): `src/api/rentals.js`
- [Rental dialogs](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/rentals/CreateOrderModal.jsx): `src/components/rentals/CreateOrderModal.jsx`

### Finance and records

- [Finance workspace](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/DashboardHome.jsx): `src/pages/DashboardHome.jsx`
- [Contributions](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Contributions.jsx): `src/pages/Contributions.jsx`
- [Festival contributions](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/PujaContributions.jsx): `src/pages/PujaContributions.jsx`
- [Donations](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Donations.jsx): `src/pages/Donations.jsx`
- [Expenses and budgets](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Budgeting.jsx): `src/pages/Budgeting.jsx`
- [Assets](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Assets.jsx): `src/pages/Assets.jsx`
- [Archives and reports](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/ArchiveReport.jsx): `src/pages/ArchiveReport.jsx`
- [Club settings and years](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/Settings.jsx): `src/pages/Settings.jsx`
- [Festival-year API](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/years.js): `src/api/years.js`
- [Create-year dialog](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/components/CreateYearModal.jsx): `src/components/CreateYearModal.jsx`
- [PDF exports](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/utils/pdfExport.js): `src/utils/pdfExport.js`

### Platform administration

- [Platform administration](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/pages/platform/PlatformDashboard.jsx): `src/pages/platform/PlatformDashboard.jsx`
- [Platform API](https://github.com/sahil-das/clubkhata-frontend/blob/main/src/api/platform.js): `src/api/platform.js`

### Other components

- **Club user**
- **Application API**

## Connections

- Club user → Router and layouts: opens (evidence: `src/App.jsx`)
- Router and layouts → Authentication: provides auth (evidence: `src/App.jsx`)
- Router and layouts → Finance workspace: routes to (evidence: `src/App.jsx`)
- Router and layouts → Platform administration: routes to (evidence: `src/App.jsx`)
- Authentication → HTTP client: auth requests (evidence: `src/context/AuthContext.jsx`)
- Router and layouts → Theme preferences: provides theme (evidence: `src/App.jsx`)
- Router and layouts → Toast notifications: provides notifications (evidence: `src/App.jsx`)
- Router and layouts → Members and profiles: routes to (evidence: `src/App.jsx`)
- Router and layouts → Polls: routes to (evidence: `src/App.jsx`)
- Router and layouts → Vendor rentals: routes to (evidence: `src/App.jsx`)
- Router and layouts → Expenses and budgets: routes to (evidence: `src/App.jsx`)
- Router and layouts → Assets: routes to (evidence: `src/App.jsx`)
- Router and layouts → Archives and reports: routes to (evidence: `src/App.jsx`)
- Router and layouts → Club settings and years: routes to (evidence: `src/App.jsx`)
- Vendor rentals → Rental operations API: calls (evidence: `src/pages/VendorHiring.jsx`)
- Rental operations API → HTTP client: uses client (evidence: `src/api/rentals.js`)
- Vendor rentals → Rental dialogs: renders (evidence: `src/pages/VendorHiring.jsx`)
- Club settings and years → Festival-year API: calls (evidence: `src/pages/Settings.jsx`)
- Club settings and years → Create-year dialog: uses (evidence: `src/pages/Settings.jsx`)
- Festival-year API → HTTP client: uses client (evidence: `src/api/years.js`)
- Platform administration → Platform API: calls (evidence: `src/pages/platform/PlatformDashboard.jsx`)
- Platform API → HTTP client: uses client (evidence: `src/api/platform.js`)
- Members and profiles → HTTP client: calls (evidence: `src/pages/MemberDetails.jsx`)
- Festival contributions → HTTP client: calls (evidence: `src/pages/PujaContributions.jsx`)
- Festival contributions → PDF exports: exports (evidence: `src/pages/PujaContributions.jsx`)
- HTTP client → Application API: sends requests (evidence: `src/api/axios.js`)
