How mascteam/masc-website works
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: app.ts Express application · event.controller.ts Event operations · feedback.controller.ts Feedback operations · auth.middleware.ts JWT authentication
Components 29
Web client
- Club homepage
client/src/app/(root)/page.tsx - Member accounts
client/src/app/(auth)/login/page.tsx - Blog browsing
client/src/app/blogs/page.tsx - Blog detail
client/src/app/blogs/[slug]/page.tsx - Event browsing
client/src/app/events/page.tsx - Event actions
client/src/app/events/create/page.tsx - Admin tools
client/src/app/admin/(actions)/blogs/page.tsx
API and access
- Express application
server/src/app.ts - Account routes
server/src/routes/auth.routes.ts - Account operations
server/src/controllers/auth.controller.ts - JWT authentication
server/src/middlewares/auth.middleware.ts - Async wrapper
server/src/utils/asyncHandler.ts - Error handling
server/src/middlewares/errorHandler.ts - Member records
server/src/models/user.model.ts - Server startup
server/src/server.ts
Content management
- Blog routes
server/src/routes/blog.routes.ts - Blog operations
server/src/controllers/blog.controller.ts - Blog records
server/src/models/blog.model.ts
Events and engagement
- Event routes
server/src/routes/event.routes.ts - Event operations
server/src/controllers/event.controller.ts - Event records
server/src/models/events.model.ts - Attendance records
server/src/models/attendance.model.ts - Registrations
server/src/models/registration.mode.ts - Feedback routes
server/src/routes/feedback.routes.ts - Feedback operations
server/src/controllers/feedback.controller.ts - Feedback records
server/src/models/feedback.model.ts
Other components
- Visitor or member
- MongoDB
- Supabase storage
Connections 37
- Visitor or member → Club homepage: browses
README.md - Visitor or member → Member accounts: uses
README.md - Visitor or member → Blog browsing: browses
README.md - Visitor or member → Event browsing: browses
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
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
server/src/server.ts - Express application → Account routes: mounts
server/src/app.ts - Express application → Blog routes: mounts
server/src/app.ts - Express application → Event routes: mounts
server/src/app.ts - Express application → Feedback routes: mounts
server/src/app.ts - Express application → Error handling: handles errors
server/src/app.ts - Account routes → Account operations: dispatches to
server/src/routes/auth.routes.ts - Account routes → JWT authentication: guards routes
server/src/routes/auth.routes.ts - Blog routes → Blog operations: dispatches to
server/src/routes/blog.routes.ts - Blog routes → JWT authentication: guards routes
server/src/routes/blog.routes.ts - Event routes → Event operations: dispatches to
server/src/routes/event.routes.ts - Event routes → JWT authentication: guards routes
server/src/routes/event.routes.ts - Feedback routes → Feedback operations: dispatches to
server/src/routes/feedback.routes.ts - Feedback routes → JWT authentication: guards routes
server/src/routes/feedback.routes.ts - Account operations → Member records: reads and writes
server/src/controllers/auth.controller.ts - Blog operations → Blog records: reads and writes
server/src/controllers/blog.controller.ts - Blog operations → Member records: reads and updates
server/src/controllers/blog.controller.ts - Event operations → Event records: reads and writes
server/src/controllers/event.controller.ts - Event operations → Member records: reads and updates
server/src/controllers/event.controller.ts - Event operations → Attendance records: reads and writes
server/src/controllers/event.controller.ts - Event operations → Registrations: uses
server/src/controllers/event.controller.ts - Feedback operations → Feedback records: reads and writes
server/src/controllers/feedback.controller.ts - Feedback operations → Event records: checks event
server/src/controllers/feedback.controller.ts - Feedback operations → Member records: reads member
server/src/controllers/feedback.controller.ts - Express application → Supabase storage: configures uploads
server/src/app.ts - Express application → MongoDB: uses persistence