# ees-nitw/ees architecture

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

- Interactive diagram: https://gitdiagram.com/ees-nitw/ees
- Repository: https://github.com/ees-nitw/ees

## Overview

EES is a college website with public pages for events, teams, a databank, and placements, plus protected placement and administration workflows. Users enter through the React router; administrators manage events, teams, placements, and settings, while placement viewers browse companies and offers. The Express backend mounts domain routes, applies authentication where required, and persists domain data in PostgreSQL, with Cloudinary used for image assets. Source excerpts establish some frontend-to-API and backend-to-service links; unsampled page/API relationships are left unspecified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/ees-nitw/ees/blob/main/frontend/src/App.jsx) (Page router), [`backend/index.js`](https://github.com/ees-nitw/ees/blob/main/backend/index.js) (Express app), [`backend/routes/placements.js`](https://github.com/ees-nitw/ees/blob/main/backend/routes/placements.js) (Placement routes), [`backend/routes/db.js`](https://github.com/ees-nitw/ees/blob/main/backend/routes/db.js) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public website"]
  node_router["Page router<br/>[App.jsx]"]
  node_home["Landing page<br/>[Landing_main.jsx]"]
  node_events_page["Events page<br/>[Events.jsx]"]
  node_teams_page["Teams page<br/>[Teams.jsx]"]
  node_databank["Databank<br/>[Databank.jsx]"]
  node_placement_login["Placement login"]
  node_companies["Company directory<br/>[Placements.jsx]"]
  node_offers["Company offers<br/>[CompanyOffers.jsx]"]
  node_team_content["Member refresh hook<br/>[useContent2.jsx]"]
end

subgraph group_admin["Administration"]
  node_admin_login["Admin login<br/>[AdminLogin.jsx]"]
  node_admin_shell["Admin shell<br/>[Admin.jsx]"]
  node_dashboard["Admin dashboard<br/>[Dashboard.jsx]"]
  node_manage_events["Event management<br/>[ManageEvents.jsx]"]
  node_manage_placements["Placement management"]
  node_manage_teams["Team management<br/>[ManageTeams.jsx]"]
  node_settings["Admin settings<br/>[Settings.jsx]"]
end

subgraph group_server["Backend services"]
  node_api["Express app<br/>[index.js]"]
  node_auth["Google sign-in<br/>[auth.js]"]
  node_events_api["Events routes<br/>[events.js]"]
  node_public_events_api["Public events routes<br/>[eventsPublic.js]"]
  node_teams_api["Teams routes<br/>[teams.js]"]
  node_placement_api["Placement routes<br/>[placements.js]"]
  node_settings_api["Settings routes<br/>[settings.js]"]
  node_admin_api["Admin routes<br/>[admin.js]"]
end

subgraph group_data["Persistence and media"]
  node_database_pool["Database connection<br/>[db.js]"]
  node_postgres[("PostgreSQL")]
  node_cloudinary_config["Cloudinary client<br/>[cloudinary.js]"]
  node_cloudinary["Cloudinary media"]
end

node_visitor(("Website visitor"))

node_visitor -->|"opens"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_events_page
node_router -->|"routes to"| node_teams_page
node_router -->|"routes to"| node_databank
node_router -->|"routes to"| node_placement_login
node_router -->|"routes to"| node_companies
node_router -->|"routes to"| node_offers
node_router -->|"routes to"| node_admin_login
node_router -->|"routes to"| node_admin_shell
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_manage_teams
node_router -->|"routes to"| node_manage_events
node_router -->|"routes to"| node_manage_placements
node_router -->|"routes to"| node_settings
node_teams_page -->|"uses hook"| node_team_content
node_team_content -->|"requests members"| node_teams_api
node_manage_placements -->|"requests data"| node_placement_api
node_api -->|"mounts"| node_admin_api
node_api -->|"mounts"| node_events_api
node_api -->|"mounts"| node_public_events_api
node_api -->|"mounts"| node_teams_api
node_api -->|"mounts"| node_settings_api
node_api -->|"mounts"| node_placement_api
node_api -->|"loads strategy"| node_auth
node_auth -->|"queries users"| node_database_pool
node_events_api -->|"queries events"| node_database_pool
node_events_api -->|"uploads media"| node_cloudinary_config
node_placement_api -->|"queries placements"| node_database_pool
node_placement_api -->|"manages logos"| node_cloudinary_config
node_database_pool -.->|"connects to"| node_postgres
node_cloudinary_config -->|"configures client"| node_cloudinary

click node_router "https://github.com/ees-nitw/ees/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Home/Landing_main.jsx"
click node_events_page "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Events/Events.jsx"
click node_teams_page "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Teams/Teams.jsx"
click node_databank "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Databank/Databank.jsx"
click node_placement_login "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/PlacementsLogin.jsx"
click node_companies "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/Placements.jsx"
click node_offers "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/CompanyOffers.jsx"
click node_team_content "https://github.com/ees-nitw/ees/blob/main/frontend/src/hooks/useContent2.jsx"
click node_admin_login "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/AdminLogin.jsx"
click node_admin_shell "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Admin.jsx"
click node_dashboard "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Dashboard.jsx"
click node_manage_events "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManageEvents.jsx"
click node_manage_placements "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManagePlacements.jsx"
click node_manage_teams "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManageTeams.jsx"
click node_settings "https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Settings.jsx"
click node_api "https://github.com/ees-nitw/ees/blob/main/backend/index.js"
click node_auth "https://github.com/ees-nitw/ees/blob/main/backend/routes/auth.js"
click node_events_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/events.js"
click node_public_events_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/eventsPublic.js"
click node_teams_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/teams.js"
click node_placement_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/placements.js"
click node_settings_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/settings.js"
click node_admin_api "https://github.com/ees-nitw/ees/blob/main/backend/routes/admin.js"
click node_database_pool "https://github.com/ees-nitw/ees/blob/main/backend/routes/db.js"
click node_cloudinary_config "https://github.com/ees-nitw/ees/blob/main/backend/config/cloudinary.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_router,node_home,node_events_page,node_teams_page,node_databank,node_placement_login,node_companies,node_offers,node_team_content toneBlue
class node_admin_login,node_admin_shell,node_dashboard,node_manage_events,node_manage_placements,node_manage_teams,node_settings toneAmber
class node_api,node_auth,node_events_api,node_public_events_api,node_teams_api,node_placement_api,node_settings_api,node_admin_api toneMint
class node_database_pool,node_postgres,node_cloudinary_config,node_cloudinary toneRose
class node_visitor toneIndigo
```

## Components

### Public website

- [Page router](https://github.com/ees-nitw/ees/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Landing page](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Home/Landing_main.jsx): `frontend/src/Pages/Home/Landing_main.jsx`
- [Events page](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Events/Events.jsx): `frontend/src/Pages/Events/Events.jsx`
- [Teams page](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Teams/Teams.jsx): `frontend/src/Pages/Teams/Teams.jsx`
- [Databank](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Databank/Databank.jsx): `frontend/src/Pages/Databank/Databank.jsx`
- [Placement login](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/PlacementsLogin.jsx): `frontend/src/Pages/Placements/PlacementsLogin.jsx`
- [Company directory](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/Placements.jsx): `frontend/src/Pages/Placements/Placements.jsx`
- [Company offers](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Placements/CompanyOffers.jsx): `frontend/src/Pages/Placements/CompanyOffers.jsx`
- [Member refresh hook](https://github.com/ees-nitw/ees/blob/main/frontend/src/hooks/useContent2.jsx): `frontend/src/hooks/useContent2.jsx`

### Administration

- [Admin login](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/AdminLogin.jsx): `frontend/src/Pages/Admin/AdminLogin.jsx`
- [Admin shell](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Admin.jsx): `frontend/src/Pages/Admin/Admin.jsx`
- [Admin dashboard](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Dashboard.jsx): `frontend/src/Pages/Admin/Dashboard.jsx`
- [Event management](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManageEvents.jsx): `frontend/src/Pages/Admin/ManageEvents.jsx`
- [Placement management](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManagePlacements.jsx): `frontend/src/Pages/Admin/ManagePlacements.jsx`
- [Team management](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/ManageTeams.jsx): `frontend/src/Pages/Admin/ManageTeams.jsx`
- [Admin settings](https://github.com/ees-nitw/ees/blob/main/frontend/src/Pages/Admin/Settings.jsx): `frontend/src/Pages/Admin/Settings.jsx`

### Backend services

- [Express app](https://github.com/ees-nitw/ees/blob/main/backend/index.js): `backend/index.js`
- [Google sign-in](https://github.com/ees-nitw/ees/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Events routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/events.js): `backend/routes/events.js`
- [Public events routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/eventsPublic.js): `backend/routes/eventsPublic.js`
- [Teams routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/teams.js): `backend/routes/teams.js`
- [Placement routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/placements.js): `backend/routes/placements.js`
- [Settings routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/settings.js): `backend/routes/settings.js`
- [Admin routes](https://github.com/ees-nitw/ees/blob/main/backend/routes/admin.js): `backend/routes/admin.js`

### Persistence and media

- [Database connection](https://github.com/ees-nitw/ees/blob/main/backend/routes/db.js): `backend/routes/db.js`
- **PostgreSQL**
- [Cloudinary client](https://github.com/ees-nitw/ees/blob/main/backend/config/cloudinary.js): `backend/config/cloudinary.js`
- **Cloudinary media**

### Other components

- **Website visitor**

## Connections

- Website visitor → Page router: opens (evidence: `frontend/src/App.jsx`)
- Page router → Landing page: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Events page: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Teams page: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Databank: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Placement login: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Company directory: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Company offers: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Admin login: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Admin shell: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Team management: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Event management: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Placement management: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Admin settings: routes to (evidence: `frontend/src/App.jsx`)
- Teams page → Member refresh hook: uses hook (evidence: `frontend/src/Pages/Teams/Teams.jsx`)
- Member refresh hook → Teams routes: requests members (evidence: `frontend/src/hooks/useContent2.jsx`)
- Placement management → Placement routes: requests data (evidence: `frontend/src/Pages/Admin/ManagePlacements.jsx`)
- Express app → Admin routes: mounts (evidence: `backend/index.js`)
- Express app → Events routes: mounts (evidence: `backend/index.js`)
- Express app → Public events routes: mounts (evidence: `backend/index.js`)
- Express app → Teams routes: mounts (evidence: `backend/index.js`)
- Express app → Settings routes: mounts (evidence: `backend/index.js`)
- Express app → Placement routes: mounts (evidence: `backend/index.js`)
- Express app → Google sign-in: loads strategy (evidence: `backend/index.js`)
- Google sign-in → Database connection: queries users (evidence: `backend/routes/auth.js`)
- Events routes → Database connection: queries events (evidence: `backend/routes/events.js`)
- Events routes → Cloudinary client: uploads media (evidence: `backend/routes/events.js`)
- Placement routes → Database connection: queries placements (evidence: `backend/routes/placements.js`)
- Placement routes → Cloudinary client: manages logos (evidence: `backend/routes/placements.js`)
- Database connection → PostgreSQL: connects to
- Cloudinary client → Cloudinary media: configures client (evidence: `backend/config/cloudinary.js`)
