How maazhussain786/nust_event_managment works
NUST Event Management is a student-facing university society and event platform, with separate society-leadership and super-admin workflows. Students discover events and societies, register for events, and manage QR-ticket and payment-proof steps; society leaders manage membership, roles, events, and operations; administrators review and monitor platform activity. The graph preserves the README’s major capabilities and uses the supplied route excerpts for concrete wiring. Other route internals were not sampled, so their detailed calls are not inferred.
Main entry points: db.ts Postgres access · (main) Student app · [societyId] Society workspace · blob.ts Blob media
Components 26
User experience
- Student app
src/app/(main) - Account flows
src/app/(auth) - Offline and install
public/sw.js
Society operations
- Society workspace
src/app/society/[societyId] - Society API
src/app/api/societies - Role invitations
src/app/api/invites/route.ts - Society media
src/app/api/upload/society-media/route.ts
Events and tickets
- Event discovery
src/app/(main)/events - Event API
src/app/api/events/route.ts - Ticket API
src/app/api/tickets/route.ts - Ticket detail
src/app/api/tickets/[id]/route.ts - Payment proof
src/app/api/payments/submit-proof/route.ts
Platform administration
- Event oversight
src/app/api/admin/events/route.ts - Admin console
src/app/platform
Runtime services
- Authentication API
src/app/api/auth - Session and JWT
src/lib/auth.ts - Notifications and reminders
src/app/api/notifications/route.ts - Push delivery
src/lib/push-notifications.ts - Postgres access
src/lib/db.ts - PostgreSQL
- Blob media
src/lib/blob.ts - Azure Blob Storage
- MongoDB read model
Other components
- Students
- Society leaders
- Super admins
Connections 37
- Students → Account flows: sign up
- Students → Student app: use app
- Society leaders → Society workspace: manage society
- Super admins → Admin console: administer
- Account flows → Authentication API: authenticate
- Authentication API → Session and JWT: validate session
- Authentication API → Postgres access: read and write
- Student app → Event API: browse events
- Event discovery → Event API: request listings
- Event API → Postgres access: query events
- Society workspace → Society API: manage society
- Society API → Postgres access: read and write
- Society workspace → Role invitations: invite members
- Role invitations → Session and JWT: identify caller
- Role invitations → Postgres access: validate and save invite
- Society workspace → Society media: upload media
- Society media → Postgres access: save media records
- Society media → Blob media: process media
- Blob media → Azure Blob Storage: store files
- Student app → Ticket API: view tickets
- Ticket API → Postgres access: query registrations
- Ticket API → Blob media: resolve media URLs
- Student app → Ticket detail: open ticket
- Ticket detail → Postgres access: read and save QR
- Student app → Payment proof: submit proof
- Payment proof → Postgres access: verify and record proof
- Payment proof → Blob media: process and upload proof
- Super admins → Event oversight: review events
- Admin console → Event oversight: manage events
- Event oversight → Postgres access: read and write
- Student app → Notifications and reminders: view updates
- Notifications and reminders → Postgres access: read notifications
- Notifications and reminders → Push delivery: dispatch reminders
- Push delivery → Students: send push
- Student app → Offline and install: use offline app
- Postgres access → PostgreSQL: query and update
- Society API → MongoDB read model: read public profile model