# sahil-das/clubkhata-backend architecture

> Architecture diagram of the GitHub repository sahil-das/clubkhata-backend, 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-backend
- Repository: https://github.com/sahil-das/clubkhata-backend

## Overview

This is a multi-tenant club-management SaaS backend for festival committees. Its main workflow is a client request entering the Express API, passing route-level authentication/role checks, reaching a domain controller, and reading or updating MongoDB-backed club records. The domain spans club identity and membership, festival-year setup, subscriptions and fees, expenses and rentals, and finance/audit views; platform administration and member-facing collaboration are additional capabilities. The graph uses source-index references for unsampled modules, so some detailed controller-to-model relationships are omitted.

Main entry points: [`src/app.js`](https://github.com/sahil-das/clubkhata-backend/blob/main/src/app.js) (Express API), [`src/utils/auditLogger.js`](https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/auditLogger.js) (Audit logging), [`src/controllers/rental.controller.js`](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/rental.controller.js) (Rental orders and vendors), [`src/models/FestivalYear.js`](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/FestivalYear.js) (Festival years)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_api["Express API<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[auth.routes.js]"]
  node_authmw["Token and club context<br/>[auth.middleware.js]"]
  node_access["Role and request checks"]
end

subgraph group_identity["Clubs and membership"]
  node_authctrl["Authentication<br/>[auth.controller.js]"]
  node_users[("Users and sessions<br/>[User.js]")]
  node_clubs[("Clubs and memberships<br/>[Membership.js]")]
  node_membership["Membership management"]
end

subgraph group_festival["Festival operations"]
  node_years["Festival-year setup"]
  node_yeardata[("Festival years<br/>[FestivalYear.js]")]
  node_rentals["Rental orders and vendors"]
  node_rentaldata[("Rental records<br/>[RentalOrder.js]")]
  node_collaboration["Notices and polls"]
  node_assets["Asset management<br/>[asset.routes.js]"]
  node_archives["Festival archives<br/>[archive.routes.js]"]
end

subgraph group_finance["Finance and oversight"]
  node_subscriptions["Subscriptions"]
  node_fees["Member fees"]
  node_donations["Donations"]
  node_expenses["Expenses"]
  node_financeview["Budget and finance views"]
  node_audit["Audit logging<br/>[auditLogger.js]"]
  node_money["Money conversion<br/>[mongooseMoney.js]"]
  node_balance["Balance calculation"]
  node_auditdata[("Audit records<br/>[AuditLog.js]")]
end

subgraph group_platform["Platform services"]
  node_platform["Platform administration"]
end

node_client(("API client"))

node_client -.->|"sends requests"| node_api
node_api -->|"mounts auth"| node_authroutes
node_api -->|"mounts member routes"| node_membership
node_api -->|"mounts year routes"| node_years
node_api -->|"mounts subscription routes"| node_subscriptions
node_api -->|"mounts fee routes"| node_fees
node_api -->|"mounts donation routes"| node_donations
node_api -->|"mounts expense routes"| node_expenses
node_api -->|"mounts finance routes"| node_financeview
node_api -->|"mounts rental routes"| node_rentals
node_api -->|"mounts notices and polls"| node_collaboration
node_api -->|"mounts asset routes"| node_assets
node_api -->|"mounts archive routes"| node_archives
node_api -->|"mounts platform routes"| node_platform
node_authroutes -->|"routes requests"| node_authctrl
node_authroutes -->|"protects requests"| node_authmw
node_authroutes -->|"validates input"| node_access
node_authmw -->|"loads user"| node_users
node_authmw -->|"checks membership"| node_clubs
node_authctrl -->|"reads and writes"| node_users
node_authctrl -->|"creates membership"| node_clubs
node_authctrl -->|"records actions"| node_audit
node_membership -->|"uses user records"| node_users
node_membership -->|"manages memberships"| node_clubs
node_years -->|"manages years"| node_yeardata
node_years -->|"calculates balance"| node_balance
node_years -->|"records actions"| node_audit
node_subscriptions -->|"reads year state"| node_yeardata
node_subscriptions -->|"records actions"| node_audit
node_fees -->|"reads year state"| node_yeardata
node_fees -->|"reads memberships"| node_clubs
node_fees -->|"records actions"| node_audit
node_expenses -->|"checks year status"| node_yeardata
node_expenses -->|"uses rental records"| node_rentals
node_expenses -->|"records actions"| node_audit
node_rentals -->|"manages orders"| node_rentaldata
node_rentals -->|"checks active year"| node_yeardata
node_rentals -->|"formats amounts"| node_money
node_financeview -.->|"uses balance calculations"| node_balance
node_balance -->|"uses stored amounts"| node_money
node_audit -->|"creates log records"| node_auditdata
node_platform -->|"records actions"| node_audit

click node_api "https://github.com/sahil-das/clubkhata-backend/blob/main/src/app.js"
click node_authroutes "https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/auth.routes.js"
click node_authctrl "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/auth.controller.js"
click node_authmw "https://github.com/sahil-das/clubkhata-backend/blob/main/src/middleware/auth.middleware.js"
click node_access "https://github.com/sahil-das/clubkhata-backend/tree/main/src/middleware"
click node_users "https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/User.js"
click node_clubs "https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/Membership.js"
click node_membership "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/membership.controller.js"
click node_years "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/festivalYear.controller.js"
click node_yeardata "https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/FestivalYear.js"
click node_subscriptions "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/subscription.controller.js"
click node_fees "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/memberFee.controller.js"
click node_donations "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/donation.controller.js"
click node_expenses "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/expense.controller.js"
click node_rentals "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/rental.controller.js"
click node_rentaldata "https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/RentalOrder.js"
click node_financeview "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/finance.controller.js"
click node_audit "https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/auditLogger.js"
click node_collaboration "https://github.com/sahil-das/clubkhata-backend/tree/main/src/routes"
click node_assets "https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/asset.routes.js"
click node_archives "https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/archive.routes.js"
click node_platform "https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/platform.controller.js"
click node_money "https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/mongooseMoney.js"
click node_balance "https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/calculateBalance.js"
click node_auditdata "https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/AuditLog.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_api,node_authroutes,node_authmw,node_access,node_client toneBlue
class node_authctrl,node_users,node_clubs,node_membership toneAmber
class node_years,node_yeardata,node_rentals,node_rentaldata,node_collaboration,node_assets,node_archives toneMint
class node_subscriptions,node_fees,node_donations,node_expenses,node_financeview,node_audit,node_money,node_balance,node_auditdata toneRose
class node_platform toneIndigo
```

## Components

### API and access

- [Express API](https://github.com/sahil-das/clubkhata-backend/blob/main/src/app.js): `src/app.js`
- [Authentication routes](https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Token and club context](https://github.com/sahil-das/clubkhata-backend/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`
- [Role and request checks](https://github.com/sahil-das/clubkhata-backend/tree/main/src/middleware): `src/middleware`

### Clubs and membership

- [Authentication](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [Users and sessions](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/User.js): `src/models/User.js`
- [Clubs and memberships](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/Membership.js): `src/models/Membership.js`
- [Membership management](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/membership.controller.js): `src/controllers/membership.controller.js`

### Festival operations

- [Festival-year setup](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/festivalYear.controller.js): `src/controllers/festivalYear.controller.js`
- [Festival years](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/FestivalYear.js): `src/models/FestivalYear.js`
- [Rental orders and vendors](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/rental.controller.js): `src/controllers/rental.controller.js`
- [Rental records](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/RentalOrder.js): `src/models/RentalOrder.js`
- [Notices and polls](https://github.com/sahil-das/clubkhata-backend/tree/main/src/routes): `src/routes`
- [Asset management](https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/asset.routes.js): `src/routes/asset.routes.js`
- [Festival archives](https://github.com/sahil-das/clubkhata-backend/blob/main/src/routes/archive.routes.js): `src/routes/archive.routes.js`

### Finance and oversight

- [Subscriptions](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/subscription.controller.js): `src/controllers/subscription.controller.js`
- [Member fees](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/memberFee.controller.js): `src/controllers/memberFee.controller.js`
- [Donations](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/donation.controller.js): `src/controllers/donation.controller.js`
- [Expenses](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/expense.controller.js): `src/controllers/expense.controller.js`
- [Budget and finance views](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/finance.controller.js): `src/controllers/finance.controller.js`
- [Audit logging](https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/auditLogger.js): `src/utils/auditLogger.js`
- [Money conversion](https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/mongooseMoney.js): `src/utils/mongooseMoney.js`
- [Balance calculation](https://github.com/sahil-das/clubkhata-backend/blob/main/src/utils/calculateBalance.js): `src/utils/calculateBalance.js`
- [Audit records](https://github.com/sahil-das/clubkhata-backend/blob/main/src/models/AuditLog.js): `src/models/AuditLog.js`

### Platform services

- [Platform administration](https://github.com/sahil-das/clubkhata-backend/blob/main/src/controllers/platform.controller.js): `src/controllers/platform.controller.js`

### Other components

- **API client**

## Connections

- API client → Express API: sends requests
- Express API → Authentication routes: mounts auth (evidence: `src/app.js`)
- Express API → Membership management: mounts member routes (evidence: `src/app.js`)
- Express API → Festival-year setup: mounts year routes (evidence: `src/app.js`)
- Express API → Subscriptions: mounts subscription routes (evidence: `src/app.js`)
- Express API → Member fees: mounts fee routes (evidence: `src/app.js`)
- Express API → Donations: mounts donation routes (evidence: `src/app.js`)
- Express API → Expenses: mounts expense routes (evidence: `src/app.js`)
- Express API → Budget and finance views: mounts finance routes (evidence: `src/app.js`)
- Express API → Rental orders and vendors: mounts rental routes (evidence: `src/app.js`)
- Express API → Notices and polls: mounts notices and polls (evidence: `src/app.js`)
- Express API → Asset management: mounts asset routes (evidence: `src/app.js`)
- Express API → Festival archives: mounts archive routes (evidence: `src/app.js`)
- Express API → Platform administration: mounts platform routes (evidence: `src/app.js`)
- Authentication routes → Authentication: routes requests (evidence: `src/routes/auth.routes.js`)
- Authentication routes → Token and club context: protects requests (evidence: `src/routes/auth.routes.js`)
- Authentication routes → Role and request checks: validates input (evidence: `src/routes/auth.routes.js`)
- Token and club context → Users and sessions: loads user (evidence: `src/middleware/auth.middleware.js`)
- Token and club context → Clubs and memberships: checks membership (evidence: `src/middleware/auth.middleware.js`)
- Authentication → Users and sessions: reads and writes (evidence: `src/controllers/auth.controller.js`)
- Authentication → Clubs and memberships: creates membership (evidence: `src/controllers/auth.controller.js`)
- Authentication → Audit logging: records actions (evidence: `src/controllers/auth.controller.js`)
- Membership management → Users and sessions: uses user records (evidence: `src/controllers/membership.controller.js`)
- Membership management → Clubs and memberships: manages memberships (evidence: `src/controllers/membership.controller.js`)
- Festival-year setup → Festival years: manages years (evidence: `src/controllers/festivalYear.controller.js`)
- Festival-year setup → Balance calculation: calculates balance (evidence: `src/controllers/festivalYear.controller.js`)
- Festival-year setup → Audit logging: records actions (evidence: `src/controllers/festivalYear.controller.js`)
- Subscriptions → Festival years: reads year state (evidence: `src/controllers/subscription.controller.js`)
- Subscriptions → Audit logging: records actions (evidence: `src/controllers/subscription.controller.js`)
- Member fees → Festival years: reads year state (evidence: `src/controllers/memberFee.controller.js`)
- Member fees → Clubs and memberships: reads memberships (evidence: `src/controllers/memberFee.controller.js`)
- Member fees → Audit logging: records actions (evidence: `src/controllers/memberFee.controller.js`)
- Expenses → Festival years: checks year status (evidence: `src/controllers/expense.controller.js`)
- Expenses → Rental orders and vendors: uses rental records (evidence: `src/controllers/expense.controller.js`)
- Expenses → Audit logging: records actions (evidence: `src/controllers/expense.controller.js`)
- Rental orders and vendors → Rental records: manages orders (evidence: `src/controllers/rental.controller.js`)
- Rental orders and vendors → Festival years: checks active year (evidence: `src/controllers/rental.controller.js`)
- Rental orders and vendors → Money conversion: formats amounts (evidence: `src/controllers/rental.controller.js`)
- Budget and finance views → Balance calculation: uses balance calculations
- Balance calculation → Money conversion: uses stored amounts (evidence: `src/utils/calculateBalance.js`)
- Audit logging → Audit records: creates log records (evidence: `src/utils/auditLogger.js`)
- Platform administration → Audit logging: records actions (evidence: `src/controllers/platform.controller.js`)
