# mascteam/masc-website architecture

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

- Interactive diagram: https://gitdiagram.com/mascteam/masc-website
- Repository: https://github.com/mascteam/masc-website

## Overview

Club Website is a public-facing club portal and management platform: visitors browse blogs and events, while members authenticate and organizers administer content, registrations, attendance, and feedback. The Next.js client and Express API are separate applications; the API routes requests to domain controllers and persists records through MongoDB models. The README documents these major capabilities, but sampled client pages do not expose their API calls, so client-to-server links are shown as unverified rather than asserted.

Main entry points: [`server/src/app.ts`](https://github.com/mascteam/masc-website/blob/main/server/src/app.ts) (Express application), [`server/src/controllers/event.controller.ts`](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/event.controller.ts) (Event operations), [`server/src/controllers/feedback.controller.ts`](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/feedback.controller.ts) (Feedback operations), [`server/src/middlewares/auth.middleware.ts`](https://github.com/mascteam/masc-website/blob/main/server/src/middlewares/auth.middleware.ts) (JWT authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_home["Club homepage<br/>[page.tsx]"]
  node_authpages["Member accounts<br/>[page.tsx]"]
  node_blogpages["Blog browsing<br/>[page.tsx]"]
  node_blogdetail["Blog detail<br/>[page.tsx]"]
  node_eventpages["Event browsing<br/>[page.tsx]"]
  node_eventactions["Event actions<br/>[page.tsx]"]
  node_adminpages["Admin tools<br/>[page.tsx]"]
end

subgraph group_api["API and access"]
  node_apiapp["Express application<br/>[app.ts]"]
  node_authroutes["Account routes<br/>[auth.routes.ts]"]
  node_authctrl["Account operations<br/>[auth.controller.ts]"]
  node_authguard["JWT authentication<br/>[auth.middleware.ts]"]
  node_async["Async wrapper<br/>[asyncHandler.ts]"]
  node_errorhandler["Error handling<br/>[errorHandler.ts]"]
  node_userstore[("Member records<br/>[user.model.ts]")]
  node_serverstart["Server startup<br/>[server.ts]"]
end

subgraph group_content["Content management"]
  node_blogroutes["Blog routes<br/>[blog.routes.ts]"]
  node_blogctrl["Blog operations<br/>[blog.controller.ts]"]
  node_blogstore[("Blog records<br/>[blog.model.ts]")]
end

subgraph group_events["Events and engagement"]
  node_eventroutes["Event routes<br/>[event.routes.ts]"]
  node_eventctrl["Event operations"]
  node_eventstore[("Event records<br/>[events.model.ts]")]
  node_attendance[("Attendance records")]
  node_registrations[("Registrations")]
  node_feedbackroutes["Feedback routes<br/>[feedback.routes.ts]"]
  node_feedbackctrl["Feedback operations"]
  node_feedbackstore[("Feedback records<br/>[feedback.model.ts]")]
end

node_visitor(("Visitor or member"))
node_mongodb[("MongoDB")]
node_supabase[("Supabase storage")]

node_visitor -->|"browses"| node_home
node_visitor -->|"uses"| node_authpages
node_visitor -->|"browses"| node_blogpages
node_visitor -->|"browses"| node_eventpages
node_home -.->|"requests data"| node_apiapp
node_authpages -.->|"requests account actions"| node_apiapp
node_blogpages -.->|"requests blogs"| node_apiapp
node_blogpages -->|"links to"| node_blogdetail
node_eventpages -.->|"requests events"| node_apiapp
node_eventactions -.->|"requests event actions"| node_apiapp
node_adminpages -.->|"requests admin actions"| node_apiapp
node_serverstart -->|"starts"| node_apiapp
node_apiapp -->|"mounts"| node_authroutes
node_apiapp -->|"mounts"| node_blogroutes
node_apiapp -->|"mounts"| node_eventroutes
node_apiapp -->|"mounts"| node_feedbackroutes
node_apiapp -->|"handles errors"| node_errorhandler
node_authroutes -->|"dispatches to"| node_authctrl
node_authroutes -->|"guards routes"| node_authguard
node_blogroutes -->|"dispatches to"| node_blogctrl
node_blogroutes -->|"guards routes"| node_authguard
node_eventroutes -->|"dispatches to"| node_eventctrl
node_eventroutes -->|"guards routes"| node_authguard
node_feedbackroutes -->|"dispatches to"| node_feedbackctrl
node_feedbackroutes -->|"guards routes"| node_authguard
node_authctrl -->|"reads and writes"| node_userstore
node_blogctrl -->|"reads and writes"| node_blogstore
node_blogctrl -->|"reads and updates"| node_userstore
node_eventctrl -->|"reads and writes"| node_eventstore
node_eventctrl -->|"reads and updates"| node_userstore
node_eventctrl -->|"reads and writes"| node_attendance
node_eventctrl -->|"uses"| node_registrations
node_feedbackctrl -->|"reads and writes"| node_feedbackstore
node_feedbackctrl -->|"checks event"| node_eventstore
node_feedbackctrl -->|"reads member"| node_userstore
node_apiapp -->|"configures uploads"| node_supabase
node_apiapp -.->|"uses persistence"| node_mongodb

click node_home "https://github.com/mascteam/masc-website/blob/main/client/src/app/(root)/page.tsx"
click node_authpages "https://github.com/mascteam/masc-website/blob/main/client/src/app/(auth)/login/page.tsx"
click node_blogpages "https://github.com/mascteam/masc-website/blob/main/client/src/app/blogs/page.tsx"
click node_blogdetail "https://github.com/mascteam/masc-website/blob/main/client/src/app/blogs/%5Bslug%5D/page.tsx"
click node_eventpages "https://github.com/mascteam/masc-website/blob/main/client/src/app/events/page.tsx"
click node_eventactions "https://github.com/mascteam/masc-website/blob/main/client/src/app/events/create/page.tsx"
click node_adminpages "https://github.com/mascteam/masc-website/blob/main/client/src/app/admin/(actions)/blogs/page.tsx"
click node_apiapp "https://github.com/mascteam/masc-website/blob/main/server/src/app.ts"
click node_authroutes "https://github.com/mascteam/masc-website/blob/main/server/src/routes/auth.routes.ts"
click node_authctrl "https://github.com/mascteam/masc-website/blob/main/server/src/controllers/auth.controller.ts"
click node_authguard "https://github.com/mascteam/masc-website/blob/main/server/src/middlewares/auth.middleware.ts"
click node_async "https://github.com/mascteam/masc-website/blob/main/server/src/utils/asyncHandler.ts"
click node_errorhandler "https://github.com/mascteam/masc-website/blob/main/server/src/middlewares/errorHandler.ts"
click node_blogroutes "https://github.com/mascteam/masc-website/blob/main/server/src/routes/blog.routes.ts"
click node_blogctrl "https://github.com/mascteam/masc-website/blob/main/server/src/controllers/blog.controller.ts"
click node_blogstore "https://github.com/mascteam/masc-website/blob/main/server/src/models/blog.model.ts"
click node_eventroutes "https://github.com/mascteam/masc-website/blob/main/server/src/routes/event.routes.ts"
click node_eventctrl "https://github.com/mascteam/masc-website/blob/main/server/src/controllers/event.controller.ts"
click node_eventstore "https://github.com/mascteam/masc-website/blob/main/server/src/models/events.model.ts"
click node_attendance "https://github.com/mascteam/masc-website/blob/main/server/src/models/attendance.model.ts"
click node_registrations "https://github.com/mascteam/masc-website/blob/main/server/src/models/registration.mode.ts"
click node_feedbackroutes "https://github.com/mascteam/masc-website/blob/main/server/src/routes/feedback.routes.ts"
click node_feedbackctrl "https://github.com/mascteam/masc-website/blob/main/server/src/controllers/feedback.controller.ts"
click node_feedbackstore "https://github.com/mascteam/masc-website/blob/main/server/src/models/feedback.model.ts"
click node_userstore "https://github.com/mascteam/masc-website/blob/main/server/src/models/user.model.ts"
click node_serverstart "https://github.com/mascteam/masc-website/blob/main/server/src/server.ts"

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_home,node_authpages,node_blogpages,node_blogdetail,node_eventpages,node_eventactions,node_adminpages toneBlue
class node_apiapp,node_authroutes,node_authctrl,node_authguard,node_async,node_errorhandler,node_userstore,node_serverstart,node_mongodb,node_supabase toneAmber
class node_blogroutes,node_blogctrl,node_blogstore toneMint
class node_eventroutes,node_eventctrl,node_eventstore,node_attendance,node_registrations,node_feedbackroutes,node_feedbackctrl,node_feedbackstore toneRose
class node_visitor toneIndigo
```

## Components

### Web client

- [Club homepage](https://github.com/mascteam/masc-website/blob/main/client/src/app/(root)/page.tsx): `client/src/app/(root)/page.tsx`
- [Member accounts](https://github.com/mascteam/masc-website/blob/main/client/src/app/(auth)/login/page.tsx): `client/src/app/(auth)/login/page.tsx`
- [Blog browsing](https://github.com/mascteam/masc-website/blob/main/client/src/app/blogs/page.tsx): `client/src/app/blogs/page.tsx`
- [Blog detail](https://github.com/mascteam/masc-website/blob/main/client/src/app/blogs/%5Bslug%5D/page.tsx): `client/src/app/blogs/[slug]/page.tsx`
- [Event browsing](https://github.com/mascteam/masc-website/blob/main/client/src/app/events/page.tsx): `client/src/app/events/page.tsx`
- [Event actions](https://github.com/mascteam/masc-website/blob/main/client/src/app/events/create/page.tsx): `client/src/app/events/create/page.tsx`
- [Admin tools](https://github.com/mascteam/masc-website/blob/main/client/src/app/admin/(actions)/blogs/page.tsx): `client/src/app/admin/(actions)/blogs/page.tsx`

### API and access

- [Express application](https://github.com/mascteam/masc-website/blob/main/server/src/app.ts): `server/src/app.ts`
- [Account routes](https://github.com/mascteam/masc-website/blob/main/server/src/routes/auth.routes.ts): `server/src/routes/auth.routes.ts`
- [Account operations](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/auth.controller.ts): `server/src/controllers/auth.controller.ts`
- [JWT authentication](https://github.com/mascteam/masc-website/blob/main/server/src/middlewares/auth.middleware.ts): `server/src/middlewares/auth.middleware.ts`
- [Async wrapper](https://github.com/mascteam/masc-website/blob/main/server/src/utils/asyncHandler.ts): `server/src/utils/asyncHandler.ts`
- [Error handling](https://github.com/mascteam/masc-website/blob/main/server/src/middlewares/errorHandler.ts): `server/src/middlewares/errorHandler.ts`
- [Member records](https://github.com/mascteam/masc-website/blob/main/server/src/models/user.model.ts): `server/src/models/user.model.ts`
- [Server startup](https://github.com/mascteam/masc-website/blob/main/server/src/server.ts): `server/src/server.ts`

### Content management

- [Blog routes](https://github.com/mascteam/masc-website/blob/main/server/src/routes/blog.routes.ts): `server/src/routes/blog.routes.ts`
- [Blog operations](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/blog.controller.ts): `server/src/controllers/blog.controller.ts`
- [Blog records](https://github.com/mascteam/masc-website/blob/main/server/src/models/blog.model.ts): `server/src/models/blog.model.ts`

### Events and engagement

- [Event routes](https://github.com/mascteam/masc-website/blob/main/server/src/routes/event.routes.ts): `server/src/routes/event.routes.ts`
- [Event operations](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/event.controller.ts): `server/src/controllers/event.controller.ts`
- [Event records](https://github.com/mascteam/masc-website/blob/main/server/src/models/events.model.ts): `server/src/models/events.model.ts`
- [Attendance records](https://github.com/mascteam/masc-website/blob/main/server/src/models/attendance.model.ts): `server/src/models/attendance.model.ts`
- [Registrations](https://github.com/mascteam/masc-website/blob/main/server/src/models/registration.mode.ts): `server/src/models/registration.mode.ts`
- [Feedback routes](https://github.com/mascteam/masc-website/blob/main/server/src/routes/feedback.routes.ts): `server/src/routes/feedback.routes.ts`
- [Feedback operations](https://github.com/mascteam/masc-website/blob/main/server/src/controllers/feedback.controller.ts): `server/src/controllers/feedback.controller.ts`
- [Feedback records](https://github.com/mascteam/masc-website/blob/main/server/src/models/feedback.model.ts): `server/src/models/feedback.model.ts`

### Other components

- **Visitor or member**
- **MongoDB**
- **Supabase storage**

## Connections

- Visitor or member → Club homepage: browses (evidence: `README.md`)
- Visitor or member → Member accounts: uses (evidence: `README.md`)
- Visitor or member → Blog browsing: browses (evidence: `README.md`)
- Visitor or member → Event browsing: browses (evidence: `README.md`)
- Club homepage → Express application: requests data
- Member accounts → Express application: requests account actions
- Blog browsing → Express application: requests blogs
- Blog browsing → Blog detail: links to (evidence: `client/src/app/blogs/page.tsx`)
- Event browsing → Express application: requests events
- Event actions → Express application: requests event actions
- Admin tools → Express application: requests admin actions
- Server startup → Express application: starts (evidence: `server/src/server.ts`)
- Express application → Account routes: mounts (evidence: `server/src/app.ts`)
- Express application → Blog routes: mounts (evidence: `server/src/app.ts`)
- Express application → Event routes: mounts (evidence: `server/src/app.ts`)
- Express application → Feedback routes: mounts (evidence: `server/src/app.ts`)
- Express application → Error handling: handles errors (evidence: `server/src/app.ts`)
- Account routes → Account operations: dispatches to (evidence: `server/src/routes/auth.routes.ts`)
- Account routes → JWT authentication: guards routes (evidence: `server/src/routes/auth.routes.ts`)
- Blog routes → Blog operations: dispatches to (evidence: `server/src/routes/blog.routes.ts`)
- Blog routes → JWT authentication: guards routes (evidence: `server/src/routes/blog.routes.ts`)
- Event routes → Event operations: dispatches to (evidence: `server/src/routes/event.routes.ts`)
- Event routes → JWT authentication: guards routes (evidence: `server/src/routes/event.routes.ts`)
- Feedback routes → Feedback operations: dispatches to (evidence: `server/src/routes/feedback.routes.ts`)
- Feedback routes → JWT authentication: guards routes (evidence: `server/src/routes/feedback.routes.ts`)
- Account operations → Member records: reads and writes (evidence: `server/src/controllers/auth.controller.ts`)
- Blog operations → Blog records: reads and writes (evidence: `server/src/controllers/blog.controller.ts`)
- Blog operations → Member records: reads and updates (evidence: `server/src/controllers/blog.controller.ts`)
- Event operations → Event records: reads and writes (evidence: `server/src/controllers/event.controller.ts`)
- Event operations → Member records: reads and updates (evidence: `server/src/controllers/event.controller.ts`)
- Event operations → Attendance records: reads and writes (evidence: `server/src/controllers/event.controller.ts`)
- Event operations → Registrations: uses (evidence: `server/src/controllers/event.controller.ts`)
- Feedback operations → Feedback records: reads and writes (evidence: `server/src/controllers/feedback.controller.ts`)
- Feedback operations → Event records: checks event (evidence: `server/src/controllers/feedback.controller.ts`)
- Feedback operations → Member records: reads member (evidence: `server/src/controllers/feedback.controller.ts`)
- Express application → Supabase storage: configures uploads (evidence: `server/src/app.ts`)
- Express application → MongoDB: uses persistence
