# mukesh182005/rotandance architecture

> Architecture diagram of the GitHub repository mukesh182005/rotandance, 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/mukesh182005/rotandance
- Repository: https://github.com/mukesh182005/rotandance

## Overview

RCAEMS is a Rotaract club management system with a Next.js portal and NestJS API. Members and administrators use the portal to manage identity, events, attendance, membership, and related club records; the API exposes authenticated, role-checked operations backed by Prisma. The README also names reporting, media storage, notifications, backups, and QR attendance as product capabilities. Those documented but unsampled areas are included conservatively; frontend-to-API wiring and their internal calls are not established by the excerpts, so those links are omitted or marked unverified.

Main entry points: [`backend/src/main.ts`](https://github.com/mukesh182005/rotandance/blob/main/backend/src/main.ts) (NestJS API), [`backend/src/prisma/prisma.service.ts`](https://github.com/mukesh182005/rotandance/blob/main/backend/src/prisma/prisma.service.ts) (Prisma access), [`backend/src/common/guards`](https://github.com/mukesh182005/rotandance/tree/main/backend/src/common/guards) (Access guards), [`frontend/src/app/page.tsx`](https://github.com/mukesh182005/rotandance/blob/main/frontend/src/app/page.tsx) (Next.js portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Web portal"]
  node_web_portal["Next.js portal<br/>[page.tsx]"]
  node_admin_views["Admin views"]
  node_member_views["Member views"]
  node_shared_views["Shared views"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Auth endpoints<br/>[auth.controller.ts]"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_jwt_strategy["JWT validation<br/>[jwt.strategy.ts]"]
  node_access_guards["Access guards"]
  node_users["User management"]
end

subgraph group_operations["Club operations"]
  node_events["Event management"]
  node_attendance["Attendance"]
  node_qr["QR check-in"]
  node_members["Membership"]
  node_reports["Reports"]
  node_gallery["Event gallery"]
  node_notifications["Notifications"]
  node_settings["Club settings"]
  node_analytics["Analytics"]
end

subgraph group_platform["Data and services"]
  node_api["NestJS API<br/>[main.ts]"]
  node_backup["Backups<br/>[backup.service.ts]"]
  node_prisma["Prisma access<br/>[prisma.service.ts]"]
  node_postgres[("PostgreSQL")]
  node_media_services["Media integrations"]
end

node_member_actor(("Member / admin"))
node_external_storage["Cloud media storage"]

node_member_actor -.->|"uses"| node_web_portal
node_web_portal -.->|"offers"| node_admin_views
node_web_portal -.->|"offers"| node_member_views
node_web_portal -.->|"offers"| node_shared_views
node_member_actor -.->|"sends requests"| node_api
node_api -->|"registers"| node_auth_controller
node_api -->|"registers"| node_users
node_api -->|"registers"| node_members
node_api -->|"registers"| node_events
node_api -->|"registers"| node_attendance
node_api -->|"registers"| node_qr
node_api -->|"registers"| node_gallery
node_api -->|"registers"| node_reports
node_api -->|"registers"| node_backup
node_api -->|"registers"| node_notifications
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"reads/writes"| node_prisma
node_auth_controller -->|"guards routes"| node_access_guards
node_events -->|"guards routes"| node_access_guards
node_events -->|"reads/writes"| node_prisma
node_attendance -->|"guards routes"| node_access_guards
node_attendance -->|"reads/writes"| node_prisma
node_members -->|"guards routes"| node_access_guards
node_members -->|"reads/writes"| node_prisma
node_reports -->|"reads"| node_prisma
node_gallery -->|"reads/writes"| node_prisma
node_users -->|"guards routes"| node_access_guards
node_prisma -.->|"queries"| node_postgres
node_gallery -.->|"uploads media"| node_media_services
node_media_services -.->|"stores media"| node_external_storage

click node_web_portal "https://github.com/mukesh182005/rotandance/blob/main/frontend/src/app/page.tsx"
click node_admin_views "https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(admin)"
click node_member_views "https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(member)"
click node_shared_views "https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(shared)"
click node_api "https://github.com/mukesh182005/rotandance/blob/main/backend/src/main.ts"
click node_auth_controller "https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/auth.controller.ts"
click node_auth_service "https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/auth.service.ts"
click node_jwt_strategy "https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/jwt.strategy.ts"
click node_access_guards "https://github.com/mukesh182005/rotandance/tree/main/backend/src/common/guards"
click node_users "https://github.com/mukesh182005/rotandance/tree/main/backend/src/users"
click node_events "https://github.com/mukesh182005/rotandance/blob/main/backend/src/events/events.controller.ts"
click node_attendance "https://github.com/mukesh182005/rotandance/blob/main/backend/src/attendance/attendance.controller.ts"
click node_qr "https://github.com/mukesh182005/rotandance/tree/main/backend/src/qr"
click node_members "https://github.com/mukesh182005/rotandance/blob/main/backend/src/members/members.controller.ts"
click node_reports "https://github.com/mukesh182005/rotandance/blob/main/backend/src/reports/reports.controller.ts"
click node_gallery "https://github.com/mukesh182005/rotandance/blob/main/backend/src/gallery/gallery.controller.ts"
click node_notifications "https://github.com/mukesh182005/rotandance/tree/main/backend/src/notifications"
click node_settings "https://github.com/mukesh182005/rotandance/tree/main/backend/src/settings"
click node_analytics "https://github.com/mukesh182005/rotandance/tree/main/backend/src/analytics"
click node_backup "https://github.com/mukesh182005/rotandance/blob/main/backend/src/backup/backup.service.ts"
click node_prisma "https://github.com/mukesh182005/rotandance/blob/main/backend/src/prisma/prisma.service.ts"
click node_media_services "https://github.com/mukesh182005/rotandance/tree/main/backend/src/integrations/cloudinary"

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_web_portal,node_admin_views,node_member_views,node_shared_views toneBlue
class node_auth_controller,node_auth_service,node_jwt_strategy,node_access_guards,node_users,node_external_storage toneAmber
class node_events,node_attendance,node_qr,node_members,node_reports,node_gallery,node_notifications,node_settings,node_analytics toneMint
class node_api,node_backup,node_prisma,node_postgres,node_media_services toneRose
class node_member_actor toneIndigo
```

## Components

### Web portal

- [Next.js portal](https://github.com/mukesh182005/rotandance/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Admin views](https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(admin)): `frontend/src/app/(admin)`
- [Member views](https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(member)): `frontend/src/app/(member)`
- [Shared views](https://github.com/mukesh182005/rotandance/tree/main/frontend/src/app/(shared)): `frontend/src/app/(shared)`

### Identity and access

- [Auth endpoints](https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Authentication](https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT validation](https://github.com/mukesh182005/rotandance/blob/main/backend/src/auth/jwt.strategy.ts): `backend/src/auth/jwt.strategy.ts`
- [Access guards](https://github.com/mukesh182005/rotandance/tree/main/backend/src/common/guards): `backend/src/common/guards`
- [User management](https://github.com/mukesh182005/rotandance/tree/main/backend/src/users): `backend/src/users`

### Club operations

- [Event management](https://github.com/mukesh182005/rotandance/blob/main/backend/src/events/events.controller.ts): `backend/src/events/events.controller.ts`
- [Attendance](https://github.com/mukesh182005/rotandance/blob/main/backend/src/attendance/attendance.controller.ts): `backend/src/attendance/attendance.controller.ts`
- [QR check-in](https://github.com/mukesh182005/rotandance/tree/main/backend/src/qr): `backend/src/qr`
- [Membership](https://github.com/mukesh182005/rotandance/blob/main/backend/src/members/members.controller.ts): `backend/src/members/members.controller.ts`
- [Reports](https://github.com/mukesh182005/rotandance/blob/main/backend/src/reports/reports.controller.ts): `backend/src/reports/reports.controller.ts`
- [Event gallery](https://github.com/mukesh182005/rotandance/blob/main/backend/src/gallery/gallery.controller.ts): `backend/src/gallery/gallery.controller.ts`
- [Notifications](https://github.com/mukesh182005/rotandance/tree/main/backend/src/notifications): `backend/src/notifications`
- [Club settings](https://github.com/mukesh182005/rotandance/tree/main/backend/src/settings): `backend/src/settings`
- [Analytics](https://github.com/mukesh182005/rotandance/tree/main/backend/src/analytics): `backend/src/analytics`

### Data and services

- [NestJS API](https://github.com/mukesh182005/rotandance/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [Backups](https://github.com/mukesh182005/rotandance/blob/main/backend/src/backup/backup.service.ts): `backend/src/backup/backup.service.ts`
- [Prisma access](https://github.com/mukesh182005/rotandance/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- **PostgreSQL**
- [Media integrations](https://github.com/mukesh182005/rotandance/tree/main/backend/src/integrations/cloudinary): `backend/src/integrations/cloudinary`

### Other components

- **Member / admin**
- **Cloud media storage**

## Connections

- Member / admin → Next.js portal: uses
- Next.js portal → Admin views: offers
- Next.js portal → Member views: offers
- Next.js portal → Shared views: offers
- Member / admin → NestJS API: sends requests (evidence: `README.md`)
- NestJS API → Auth endpoints: registers
- NestJS API → User management: registers
- NestJS API → Membership: registers
- NestJS API → Event management: registers
- NestJS API → Attendance: registers
- NestJS API → QR check-in: registers
- NestJS API → Event gallery: registers
- NestJS API → Reports: registers
- NestJS API → Backups: registers
- NestJS API → Notifications: registers
- Auth endpoints → Authentication: delegates to (evidence: `backend/src/auth/auth.controller.ts`)
- Authentication → Prisma access: reads/writes (evidence: `backend/src/auth/auth.service.ts`)
- Auth endpoints → Access guards: guards routes (evidence: `backend/src/auth/auth.controller.ts`)
- Event management → Access guards: guards routes (evidence: `backend/src/events/events.controller.ts`)
- Event management → Prisma access: reads/writes
- Attendance → Access guards: guards routes (evidence: `backend/src/attendance/attendance.controller.ts`)
- Attendance → Prisma access: reads/writes
- Membership → Access guards: guards routes (evidence: `backend/src/members/members.controller.ts`)
- Membership → Prisma access: reads/writes
- Reports → Prisma access: reads
- Event gallery → Prisma access: reads/writes
- User management → Access guards: guards routes (evidence: `backend/src/users/users.controller.ts`)
- Prisma access → PostgreSQL: queries (evidence: `README.md`)
- Event gallery → Media integrations: uploads media
- Media integrations → Cloud media storage: stores media (evidence: `README.md`)
