How codeshul/vit_clubs works
VIT Clubs is a campus club and event management platform. Students discover clubs and events, register for events, and use a personal portal; club admins manage events and members; super admins review event approvals and manage the wider system. The main event flow runs from public event views through shared event state and server actions to persistence, with domain validation supporting business rules. Authentication, notifications, club discovery, calendars, and permission-letter verification are separate capabilities. Several portal and notification implementations were not sampled, so those branches reflect documented capabilities rather than inspected call details.
Main entry points: events-context.tsx Event state · events.ts Event actions · db.ts Prisma client · page.tsx Event details
Components 24
Discovery and portals
- Event discovery
src/app/events/page.tsx - Event details
src/app/events/[id]/page.tsx - Event calendar
src/app/calendar/page.tsx - Student portal
src/app/portal/user/page.tsx - Club admin portal
src/app/portal/admin/page.tsx - Super admin portal
src/app/portal/super-admin/page.tsx
Event operations
- Event state
src/lib/events-context.tsx - Event actions
src/app/actions/events.ts - Approval workflows
src/app/portal/super-admin/approvals/page.tsx - Letter verification
src/app/verify/[token]/page.tsx
Identity and access
- Login modal
src/components/auth/LoginModal.tsx - Auth context
src/lib/auth-context.tsx - Credentials auth
src/app/api/auth/[...nextauth]/route.ts - Route protection
src/middleware.ts
Domain and persistence
- Domain model
src/lib/domain.ts - Prisma client
src/lib/db.ts - PostgreSQL
Club and notifications
- Club discovery
src/components/shared/ClubExplorer.tsx - Club actions
src/app/actions/clubs.ts - Notifications
src/lib/notifications-context.tsx - Fallback data
src/lib/mock-data.ts
Other components
- Student
- Club admin
- Super admin
Connections 27
- Student → Event discovery: browses
README.md - Student → Event details: opens event
README.md - Student → Event calendar: views calendar
README.md - Student → Student portal: uses portal
README.md - Club admin → Club admin portal: manages club
README.md - Super admin → Super admin portal: manages system
README.md - Event discovery → Event state: reads events
src/app/events/page.tsx - Event details → Event state: reads event
src/app/events/[id]/page.tsx - Event details → Event actions: registers
src/app/events/[id]/page.tsx - Event calendar → Event state: reads events
src/lib/events-context.tsx - Event state → Event actions: loads and mutates
src/lib/events-context.tsx - Club admin portal → Event state: uses events
src/app/portal/admin/page.tsx - Super admin portal → Event state: uses events
src/app/portal/super-admin/page.tsx - Approval workflows → Event state: reviews events
README.md - Event actions → Prisma client: persists events
src/app/actions/events.ts - Event actions → Domain model: validates entities
src/app/actions/events.ts - Prisma client → PostgreSQL: accesses
README.md - Login modal → Auth context: starts login
src/components/auth/LoginModal.tsx - Auth context → Credentials auth: credentials sign-in
README.md - Credentials auth → Prisma client: looks up users
src/app/api/auth/[...nextauth]/route.ts - Credentials auth → Domain model: validates user
src/app/api/auth/[...nextauth]/route.ts - Route protection → Student portal: protects routes
README.md - Club discovery → Fallback data: reads clubs
src/components/shared/ClubExplorer.tsx - Club actions → Prisma client: persists clubs
src/app/actions/clubs.ts - Club actions → Domain model: uses entities
src/app/actions/clubs.ts - Notifications → Student portal: alerts users
README.md - Event actions → Letter verification: issues letter tokens
README.md