# harrinisri12/budget_management architecture

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

- Interactive diagram: https://gitdiagram.com/harrinisri12/budget_management
- Repository: https://github.com/harrinisri12/budget_management

## Overview

This is a college CSE budget-management portal: faculty authenticate, prepare and submit activity proposals, while administrators manage faculty, academic-year allocations, proposal decisions, budgets, transactions and reports. The React application uses shared auth and budget state, with an Express API and Supabase persistence/authentication. The graph captures documented route mounting and sampled data access; several page capabilities are identifiable from the tree and routing, but their internal calls were not sampled, so those links are intentionally omitted.

Main entry points: [`src/App.jsx`](https://github.com/harrinisri12/budget_management/blob/main/src/App.jsx) (Route guards), [`server/server.js`](https://github.com/harrinisri12/budget_management/blob/main/server/server.js) (Express API router), [`src/context/BudgetContext.jsx`](https://github.com/harrinisri12/budget_management/blob/main/src/context/BudgetContext.jsx) (Budget state and data access), [`server/middleware/auth.js`](https://github.com/harrinisri12/budget_management/blob/main/server/middleware/auth.js) (Token authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web portal"]
  node_app["Route guards<br/>[App.jsx]"]
  node_login["Authentication screens<br/>[LoginPage.jsx]"]
  node_faculty_proposal["Proposal submission"]
  node_faculty_views["Faculty dashboard and proposals"]
  node_admin_proposals["Proposal review"]
  node_academic_ui["Academic-year management"]
  node_admin_views["Budget, reports and activities"]
  node_faculty_admin["Faculty administration<br/>[FacultyList.jsx]"]
  node_auth_state["Auth state<br/>[AuthContext.jsx]"]
  node_budget_state["Budget state and data access<br/>[BudgetContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express API router<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_faculty_routes["Faculty routes<br/>[faculty.js]"]
  node_proposal_routes["Proposal routes<br/>[proposals.js]"]
  node_budget_routes["Budget routes<br/>[budgets.js]"]
  node_year_routes["Academic-year routes<br/>[academicYears.js]"]
  node_transaction_routes["Transaction routes<br/>[transactions.js]"]
  node_auth_middleware["Token authentication<br/>[auth.js]"]
  node_role_middleware["Role authorization<br/>[roles.js]"]
end

subgraph group_domain["Budget operations"]
end

subgraph group_persistence["Supabase services"]
  node_supabase_client["Server Supabase client<br/>[supabaseClient.js]"]
  node_supabase_store[("Supabase platform<br/>[supabase.js]")]
end

node_faculty(("Faculty user"))
node_admin(("Administrator"))

node_faculty -->|"uses portal"| node_app
node_admin -->|"uses portal"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_faculty_proposal
node_app -->|"routes to"| node_faculty_views
node_app -->|"routes to"| node_admin_proposals
node_app -->|"routes to"| node_academic_ui
node_app -->|"routes to"| node_admin_views
node_login -->|"authenticates via"| node_auth_state
node_faculty_proposal -->|"reads and submits"| node_budget_state
node_faculty_views -->|"reads data"| node_budget_state
node_admin_proposals -->|"reads data"| node_budget_state
node_academic_ui -->|"updates years"| node_budget_state
node_faculty_admin -->|"manages faculty"| node_budget_state
node_auth_state -->|"authenticates and reads profiles"| node_supabase_store
node_budget_state -->|"requests API data"| node_api_client
node_budget_state -->|"fallback reads"| node_supabase_store
node_api_client -.->|"calls API"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_faculty_routes
node_server -->|"mounts"| node_proposal_routes
node_server -->|"mounts"| node_budget_routes
node_server -->|"mounts"| node_year_routes
node_server -->|"mounts"| node_transaction_routes
node_auth_routes -->|"uses"| node_auth_middleware
node_faculty_routes -->|"uses"| node_auth_middleware
node_proposal_routes -->|"uses"| node_auth_middleware
node_budget_routes -->|"uses"| node_auth_middleware
node_year_routes -->|"uses"| node_auth_middleware
node_transaction_routes -->|"uses"| node_auth_middleware
node_faculty_routes -->|"checks roles"| node_role_middleware
node_proposal_routes -->|"checks roles"| node_role_middleware
node_year_routes -->|"checks roles"| node_role_middleware
node_transaction_routes -->|"checks roles"| node_role_middleware
node_auth_middleware -->|"validates token and profile"| node_supabase_client
node_auth_routes -->|"uses"| node_supabase_client
node_faculty_routes -->|"uses"| node_supabase_client
node_proposal_routes -->|"uses"| node_supabase_client
node_budget_routes -->|"uses"| node_supabase_client
node_year_routes -->|"uses"| node_supabase_client
node_transaction_routes -->|"uses"| node_supabase_client

click node_app "https://github.com/harrinisri12/budget_management/blob/main/src/App.jsx"
click node_login "https://github.com/harrinisri12/budget_management/blob/main/src/pages/LoginPage.jsx"
click node_faculty_proposal "https://github.com/harrinisri12/budget_management/blob/main/src/pages/NewProposalPage.jsx"
click node_faculty_views "https://github.com/harrinisri12/budget_management/blob/main/src/pages/FacultyDashboardPage.jsx"
click node_admin_proposals "https://github.com/harrinisri12/budget_management/blob/main/src/pages/AdminProposalsPage.jsx"
click node_academic_ui "https://github.com/harrinisri12/budget_management/blob/main/src/pages/AcademicYearsPage.jsx"
click node_admin_views "https://github.com/harrinisri12/budget_management/blob/main/src/pages/BudgetOverviewPage.jsx"
click node_faculty_admin "https://github.com/harrinisri12/budget_management/blob/main/src/components/faculty/FacultyList.jsx"
click node_auth_state "https://github.com/harrinisri12/budget_management/blob/main/src/context/AuthContext.jsx"
click node_budget_state "https://github.com/harrinisri12/budget_management/blob/main/src/context/BudgetContext.jsx"
click node_api_client "https://github.com/harrinisri12/budget_management/blob/main/src/lib/api.js"
click node_server "https://github.com/harrinisri12/budget_management/blob/main/server/server.js"
click node_auth_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/auth.js"
click node_faculty_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/faculty.js"
click node_proposal_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/proposals.js"
click node_budget_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/budgets.js"
click node_year_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/academicYears.js"
click node_transaction_routes "https://github.com/harrinisri12/budget_management/blob/main/server/routes/transactions.js"
click node_auth_middleware "https://github.com/harrinisri12/budget_management/blob/main/server/middleware/auth.js"
click node_role_middleware "https://github.com/harrinisri12/budget_management/blob/main/server/middleware/roles.js"
click node_supabase_client "https://github.com/harrinisri12/budget_management/blob/main/server/supabaseClient.js"
click node_supabase_store "https://github.com/harrinisri12/budget_management/blob/main/src/lib/supabase.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_login,node_faculty_proposal,node_faculty_views,node_admin_proposals,node_academic_ui,node_admin_views,node_faculty_admin,node_auth_state,node_budget_state,node_api_client,node_faculty toneBlue
class node_server,node_auth_routes,node_faculty_routes,node_proposal_routes,node_budget_routes,node_year_routes,node_transaction_routes,node_auth_middleware,node_role_middleware toneAmber
class node_supabase_client,node_supabase_store toneRose
class node_admin toneIndigo
```

## Components

### Web portal

- [Route guards](https://github.com/harrinisri12/budget_management/blob/main/src/App.jsx): `src/App.jsx`
- [Authentication screens](https://github.com/harrinisri12/budget_management/blob/main/src/pages/LoginPage.jsx): `src/pages/LoginPage.jsx`
- [Proposal submission](https://github.com/harrinisri12/budget_management/blob/main/src/pages/NewProposalPage.jsx): `src/pages/NewProposalPage.jsx`
- [Faculty dashboard and proposals](https://github.com/harrinisri12/budget_management/blob/main/src/pages/FacultyDashboardPage.jsx): `src/pages/FacultyDashboardPage.jsx`
- [Proposal review](https://github.com/harrinisri12/budget_management/blob/main/src/pages/AdminProposalsPage.jsx): `src/pages/AdminProposalsPage.jsx`
- [Academic-year management](https://github.com/harrinisri12/budget_management/blob/main/src/pages/AcademicYearsPage.jsx): `src/pages/AcademicYearsPage.jsx`
- [Budget, reports and activities](https://github.com/harrinisri12/budget_management/blob/main/src/pages/BudgetOverviewPage.jsx): `src/pages/BudgetOverviewPage.jsx`
- [Faculty administration](https://github.com/harrinisri12/budget_management/blob/main/src/components/faculty/FacultyList.jsx): `src/components/faculty/FacultyList.jsx`
- [Auth state](https://github.com/harrinisri12/budget_management/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Budget state and data access](https://github.com/harrinisri12/budget_management/blob/main/src/context/BudgetContext.jsx): `src/context/BudgetContext.jsx`
- [API client](https://github.com/harrinisri12/budget_management/blob/main/src/lib/api.js): `src/lib/api.js`

### API and access

- [Express API router](https://github.com/harrinisri12/budget_management/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Faculty routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/faculty.js): `server/routes/faculty.js`
- [Proposal routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/proposals.js): `server/routes/proposals.js`
- [Budget routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/budgets.js): `server/routes/budgets.js`
- [Academic-year routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/academicYears.js): `server/routes/academicYears.js`
- [Transaction routes](https://github.com/harrinisri12/budget_management/blob/main/server/routes/transactions.js): `server/routes/transactions.js`
- [Token authentication](https://github.com/harrinisri12/budget_management/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Role authorization](https://github.com/harrinisri12/budget_management/blob/main/server/middleware/roles.js): `server/middleware/roles.js`

### Supabase services

- [Server Supabase client](https://github.com/harrinisri12/budget_management/blob/main/server/supabaseClient.js): `server/supabaseClient.js`
- [Supabase platform](https://github.com/harrinisri12/budget_management/blob/main/src/lib/supabase.js): `src/lib/supabase.js`

### Other components

- **Faculty user**
- **Administrator**

## Connections

- Faculty user → Route guards: uses portal (evidence: `src/App.jsx`)
- Administrator → Route guards: uses portal (evidence: `src/App.jsx`)
- Route guards → Authentication screens: routes to (evidence: `src/App.jsx`)
- Route guards → Proposal submission: routes to (evidence: `src/App.jsx`)
- Route guards → Faculty dashboard and proposals: routes to (evidence: `src/App.jsx`)
- Route guards → Proposal review: routes to (evidence: `src/App.jsx`)
- Route guards → Academic-year management: routes to (evidence: `src/App.jsx`)
- Route guards → Budget, reports and activities: routes to (evidence: `src/App.jsx`)
- Authentication screens → Auth state: authenticates via (evidence: `src/pages/LoginPage.jsx`)
- Proposal submission → Budget state and data access: reads and submits (evidence: `src/pages/NewProposalPage.jsx`)
- Faculty dashboard and proposals → Budget state and data access: reads data (evidence: `src/pages/FacultyDashboardPage.jsx`)
- Proposal review → Budget state and data access: reads data (evidence: `src/pages/AdminProposalsPage.jsx`)
- Academic-year management → Budget state and data access: updates years (evidence: `src/pages/AcademicYearsPage.jsx`)
- Faculty administration → Budget state and data access: manages faculty (evidence: `src/components/faculty/FacultyList.jsx`)
- Auth state → Supabase platform: authenticates and reads profiles (evidence: `src/context/AuthContext.jsx`)
- Budget state and data access → API client: requests API data (evidence: `src/context/BudgetContext.jsx`)
- Budget state and data access → Supabase platform: fallback reads (evidence: `src/context/BudgetContext.jsx`)
- API client → Express API router: calls API
- Express API router → Authentication routes: mounts (evidence: `server/server.js`)
- Express API router → Faculty routes: mounts (evidence: `server/server.js`)
- Express API router → Proposal routes: mounts (evidence: `server/server.js`)
- Express API router → Budget routes: mounts (evidence: `server/server.js`)
- Express API router → Academic-year routes: mounts (evidence: `server/server.js`)
- Express API router → Transaction routes: mounts (evidence: `server/server.js`)
- Authentication routes → Token authentication: uses (evidence: `server/routes/auth.js`)
- Faculty routes → Token authentication: uses (evidence: `server/routes/faculty.js`)
- Proposal routes → Token authentication: uses (evidence: `server/routes/proposals.js`)
- Budget routes → Token authentication: uses (evidence: `server/routes/budgets.js`)
- Academic-year routes → Token authentication: uses (evidence: `server/routes/academicYears.js`)
- Transaction routes → Token authentication: uses (evidence: `server/routes/transactions.js`)
- Faculty routes → Role authorization: checks roles (evidence: `server/routes/faculty.js`)
- Proposal routes → Role authorization: checks roles (evidence: `server/routes/proposals.js`)
- Academic-year routes → Role authorization: checks roles (evidence: `server/routes/academicYears.js`)
- Transaction routes → Role authorization: checks roles (evidence: `server/routes/transactions.js`)
- Token authentication → Server Supabase client: validates token and profile (evidence: `server/middleware/auth.js`)
- Authentication routes → Server Supabase client: uses (evidence: `server/routes/auth.js`)
- Faculty routes → Server Supabase client: uses (evidence: `server/routes/faculty.js`)
- Proposal routes → Server Supabase client: uses (evidence: `server/routes/proposals.js`)
- Budget routes → Server Supabase client: uses (evidence: `server/routes/budgets.js`)
- Academic-year routes → Server Supabase client: uses (evidence: `server/routes/academicYears.js`)
- Transaction routes → Server Supabase client: uses (evidence: `server/routes/transactions.js`)
