# akhilreddy6g/eventseasy architecture

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

- Interactive diagram: https://gitdiagram.com/akhilreddy6g/eventseasy
- Repository: https://github.com/akhilreddy6g/eventseasy

## Overview

Eventseasy coordinates hosted, managed, and attended events: users authenticate, create or join events, invite guests/managers, then use event views for schedules, landmarks, media, and chat. The frontend is a Next.js client; a NestJS API owns authentication, event and invitation operations, while a separate Go chat service and Kafka components support real-time messaging. MongoDB is the documented data store and AWS S3 the media integration. Several backend and integration links are documented or inferred from the product description, not verified in sampled implementation.

Main entry points: [`Frontend/app/(dashboard)/events/(view)`](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/app/(dashboard)/events/(view)) (Event workspaces), [`Frontend/components/dashboard/managers`](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/managers) (Manager management), [`backend/src/chats/chats.service.ts`](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chats.service.ts) (Chat operations), [`backend/src/events/events.controller.ts`](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/events/events.controller.ts) (Event API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_auth_ui["Sign in and signup<br/>[auth-form.tsx]"]
  node_event_actions["Host and join events"]
  node_event_views["Event workspaces"]
  node_guest_tools["Guest management"]
  node_manager_tools["Manager management"]
  node_invite_ui["Send invitations<br/>[common-invite.tsx]"]
  node_chat_ui["Event chat interface"]
  node_media_ui["Event media"]
  node_landmarks_ui["Landmarks and routes"]
  node_client_state["Client state"]
end

subgraph group_api["NestJS API"]
  node_auth_api["Authentication API<br/>[auth.controller.ts]"]
  node_auth_logic["Authentication service<br/>[auth.service.ts]"]
  node_session["Token sessions<br/>[session.service.ts]"]
  node_users["User accounts<br/>[users.service.ts]"]
  node_event_api["Event API"]
  node_event_logic["Event operations<br/>[events.service.ts]"]
  node_invite_api["Email invite API"]
  node_invite_logic["Invitation delivery<br/>[invite.service.ts]"]
  node_chat_api["Chat API"]
  node_chat_logic["Chat operations<br/>[chats.service.ts]"]
  node_chat_schema["Chat persistence model"]
end

subgraph group_messaging["Realtime messaging"]
  node_go_chat["WebSocket chat service<br/>[websocket.go]"]
  node_ws_pool["Connection pool<br/>[pool.go]"]
  node_kafka["Kafka messaging<br/>[kafka.service.ts]"]
end

subgraph group_integrations["External services"]
  node_mongo[("MongoDB")]
  node_s3[("AWS S3")]
  node_email["Email service"]
end

node_user(("Event participant"))

node_user -->|"signs in"| node_auth_ui
node_user -->|"hosts or joins"| node_event_actions
node_user -->|"uses"| node_event_views
node_auth_ui -.->|"authenticates"| node_auth_api
node_event_actions -.->|"submits event"| node_event_api
node_event_views -->|"manages guests"| node_guest_tools
node_event_views -->|"manages managers"| node_manager_tools
node_event_views -->|"opens chat"| node_chat_ui
node_event_views -.->|"views media"| node_media_ui
node_event_views -.->|"views landmarks"| node_landmarks_ui
node_manager_tools -->|"invites managers"| node_invite_ui
node_manager_tools -->|"loads managers"| node_event_api
node_manager_tools -->|"removes attendee"| node_event_api
node_invite_ui -.->|"sends invitation"| node_invite_api
node_auth_api -->|"delegates to"| node_auth_logic
node_auth_api -->|"refreshes tokens"| node_session
node_auth_logic -->|"delegates to"| node_users
node_event_api -->|"delegates to"| node_event_logic
node_invite_api -->|"sends through"| node_invite_logic
node_chat_api -->|"delegates to"| node_chat_logic
node_chat_logic -->|"uses model"| node_chat_schema
node_chat_ui -.->|"uses chat API"| node_chat_api
node_chat_logic -.->|"opens sockets"| node_go_chat
node_go_chat -.->|"manages clients"| node_ws_pool
node_chat_logic -.->|"publishes messages"| node_kafka
node_kafka -.->|"dispatches events"| node_go_chat
node_event_logic -.->|"persists events"| node_mongo
node_users -.->|"stores accounts"| node_mongo
node_chat_schema -.->|"stores chat data"| node_mongo
node_media_ui -.->|"uploads media"| node_s3
node_invite_logic -.->|"sends email"| node_email
node_manager_tools -->|"updates manager state"| node_client_state

click node_auth_ui "https://github.com/akhilreddy6g/eventseasy/blob/main/Frontend/components/auth/auth-form.tsx"
click node_event_actions "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/events"
click node_event_views "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/app/(dashboard)/events/(view)"
click node_guest_tools "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/guests"
click node_manager_tools "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/managers"
click node_invite_ui "https://github.com/akhilreddy6g/eventseasy/blob/main/Frontend/components/dashboard/common/common-invite.tsx"
click node_chat_ui "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/chat"
click node_media_ui "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/media"
click node_landmarks_ui "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/landmarks"
click node_client_state "https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/lib/features"
click node_auth_api "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/auth.controller.ts"
click node_auth_logic "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/auth.service.ts"
click node_session "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/session/session.service.ts"
click node_users "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/users/users.service.ts"
click node_event_api "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/events/events.controller.ts"
click node_event_logic "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/events/events.service.ts"
click node_invite_api "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/invite/invite.controller.ts"
click node_invite_logic "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/invite/invite.service.ts"
click node_chat_api "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chats.controller.ts"
click node_chat_logic "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chats.service.ts"
click node_chat_schema "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chatdata/chats.chatdata.schema.ts"
click node_go_chat "https://github.com/akhilreddy6g/eventseasy/blob/main/chat_backend/pkg/websocket/websocket.go"
click node_ws_pool "https://github.com/akhilreddy6g/eventseasy/blob/main/chat_backend/pkg/websocket/pool.go"
click node_kafka "https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/kafka/kafka.service.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_auth_ui,node_event_actions,node_event_views,node_guest_tools,node_manager_tools,node_invite_ui,node_chat_ui,node_media_ui,node_landmarks_ui,node_client_state toneBlue
class node_auth_api,node_auth_logic,node_session,node_users,node_event_api,node_event_logic,node_invite_api,node_invite_logic,node_chat_api,node_chat_logic,node_chat_schema toneAmber
class node_go_chat,node_ws_pool,node_kafka toneMint
class node_mongo,node_s3,node_email toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Sign in and signup](https://github.com/akhilreddy6g/eventseasy/blob/main/Frontend/components/auth/auth-form.tsx): `Frontend/components/auth/auth-form.tsx`
- [Host and join events](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/events): `Frontend/components/dashboard/events`
- [Event workspaces](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/app/(dashboard)/events/(view)): `Frontend/app/(dashboard)/events/(view)`
- [Guest management](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/guests): `Frontend/components/dashboard/guests`
- [Manager management](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/managers): `Frontend/components/dashboard/managers`
- [Send invitations](https://github.com/akhilreddy6g/eventseasy/blob/main/Frontend/components/dashboard/common/common-invite.tsx): `Frontend/components/dashboard/common/common-invite.tsx`
- [Event chat interface](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/chat): `Frontend/components/dashboard/chat`
- [Event media](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/media): `Frontend/components/dashboard/media`
- [Landmarks and routes](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/components/dashboard/landmarks): `Frontend/components/dashboard/landmarks`
- [Client state](https://github.com/akhilreddy6g/eventseasy/tree/main/Frontend/lib/features): `Frontend/lib/features`

### NestJS API

- [Authentication API](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Authentication service](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [Token sessions](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/session/session.service.ts): `backend/src/auth/session/session.service.ts`
- [User accounts](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/auth/users/users.service.ts): `backend/src/auth/users/users.service.ts`
- [Event API](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/events/events.controller.ts): `backend/src/events/events.controller.ts`
- [Event operations](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/events/events.service.ts): `backend/src/events/events.service.ts`
- [Email invite API](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/invite/invite.controller.ts): `backend/src/invite/invite.controller.ts`
- [Invitation delivery](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/invite/invite.service.ts): `backend/src/invite/invite.service.ts`
- [Chat API](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chats.controller.ts): `backend/src/chats/chats.controller.ts`
- [Chat operations](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chats.service.ts): `backend/src/chats/chats.service.ts`
- [Chat persistence model](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/chats/chatdata/chats.chatdata.schema.ts): `backend/src/chats/chatdata/chats.chatdata.schema.ts`

### Realtime messaging

- [WebSocket chat service](https://github.com/akhilreddy6g/eventseasy/blob/main/chat_backend/pkg/websocket/websocket.go): `chat_backend/pkg/websocket/websocket.go`
- [Connection pool](https://github.com/akhilreddy6g/eventseasy/blob/main/chat_backend/pkg/websocket/pool.go): `chat_backend/pkg/websocket/pool.go`
- [Kafka messaging](https://github.com/akhilreddy6g/eventseasy/blob/main/backend/src/kafka/kafka.service.ts): `backend/src/kafka/kafka.service.ts`

### External services

- **MongoDB**
- **AWS S3**
- **Email service**

### Other components

- **Event participant**

## Connections

- Event participant → Sign in and signup: signs in (evidence: `README.md`)
- Event participant → Host and join events: hosts or joins (evidence: `README.md`)
- Event participant → Event workspaces: uses (evidence: `README.md`)
- Sign in and signup → Authentication API: authenticates
- Host and join events → Event API: submits event
- Event workspaces → Guest management: manages guests (evidence: `README.md`)
- Event workspaces → Manager management: manages managers (evidence: `README.md`)
- Event workspaces → Event chat interface: opens chat (evidence: `README.md`)
- Event workspaces → Event media: views media
- Event workspaces → Landmarks and routes: views landmarks
- Manager management → Send invitations: invites managers (evidence: `Frontend/components/dashboard/managers/managers-overview.tsx`)
- Manager management → Event API: loads managers (evidence: `Frontend/components/dashboard/managers/managers-overview.tsx`)
- Manager management → Event API: removes attendee (evidence: `Frontend/components/dashboard/managers/view-managers.tsx`)
- Send invitations → Email invite API: sends invitation
- Authentication API → Authentication service: delegates to (evidence: `backend/src/auth/auth.controller.ts`)
- Authentication API → Token sessions: refreshes tokens (evidence: `backend/src/auth/auth.controller.ts`)
- Authentication service → User accounts: delegates to (evidence: `backend/src/auth/auth.service.ts`)
- Event API → Event operations: delegates to (evidence: `backend/src/events/events.controller.ts`)
- Email invite API → Invitation delivery: sends through (evidence: `backend/src/invite/invite.controller.ts`)
- Chat API → Chat operations: delegates to (evidence: `backend/src/chats/chats.controller.ts`)
- Chat operations → Chat persistence model: uses model (evidence: `backend/src/chats/chats.service.ts`)
- Event chat interface → Chat API: uses chat API
- Chat operations → WebSocket chat service: opens sockets
- WebSocket chat service → Connection pool: manages clients
- Chat operations → Kafka messaging: publishes messages
- Kafka messaging → WebSocket chat service: dispatches events
- Event operations → MongoDB: persists events
- User accounts → MongoDB: stores accounts
- Chat persistence model → MongoDB: stores chat data
- Event media → AWS S3: uploads media (evidence: `README.md`)
- Invitation delivery → Email service: sends email (evidence: `README.md`)
- Manager management → Client state: updates manager state (evidence: `Frontend/components/dashboard/managers/view-managers.tsx`)
