# nelushgayashan/event_management architecture

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

- Interactive diagram: https://gitdiagram.com/nelushgayashan/event_management
- Repository: https://github.com/nelushgayashan/event_management

## Overview

This is a Spring Boot event-management REST API. Users register or log in, receive authenticated access, then create, discover, update, and RSVP to events; administrators can manage users. The map separates API, domain services, security, and persistence, while retaining documented filtering, soft deletion, caching, rate limiting, and auditing. Controller-to-service links are visible in the source index; several unsampled implementation links rely only on the README’s layered-architecture description, so uncertain integrations are omitted.

Main entry points: [`src/main/java/com/eventmanagement/repository`](https://github.com/nelushgayashan/event_management/tree/main/src/main/java/com/eventmanagement/repository) (JPA Repositories), [`src/main/java/com/eventmanagement/service/SoftDeleteService.java`](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/SoftDeleteService.java) (Soft Deletion), [`src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java`](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java) (Registration Login), [`src/main/java/com/eventmanagement/security/CustomUserDetailsService.java`](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/CustomUserDetailsService.java) (User Lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Auth Endpoints"]
  node_event_api["Event Endpoints"]
  node_user_api["User Endpoints"]
end

subgraph group_domain["Event Workflows"]
  node_events["Event Management"]
  node_attendance["RSVP Tracking"]
  node_user_management["User Administration"]
  node_filtering["Event Filtering<br/>[FilterService.java]"]
end

subgraph group_identity["Identity Security"]
  node_auth_flow["Registration Login"]
  node_jwt["JWT Tokens"]
  node_jwt_filter["JWT Request Filter"]
  node_principal["User Principal<br/>[UserPrincipal.java]"]
  node_user_lookup["User Lookup"]
end

subgraph group_data["Persistence"]
  node_repositories["JPA Repositories"]
  node_user_entity["User Record<br/>[User.java]"]
  node_event_entity["Event Record<br/>[Event.java]"]
  node_attendance_entity["Attendance Record<br/>[Attendance.java]"]
  node_database[("PostgreSQL")]
end

subgraph group_platform["Cross-Cutting"]
  node_soft_delete["Soft Deletion"]
  node_cache["Caching<br/>[CacheConfig.java]"]
  node_rate_limit["Rate Limiting"]
  node_audit["Audit Tracking"]
end

node_client(("API Client"))

node_client -->|"calls auth"| node_auth_api
node_client -->|"calls events"| node_event_api
node_client -->|"calls users"| node_user_api
node_auth_api -->|"delegates to"| node_auth_flow
node_event_api -->|"delegates to"| node_events
node_user_api -->|"delegates to"| node_user_management
node_auth_flow -->|"uses"| node_repositories
node_auth_flow -->|"issues tokens"| node_jwt
node_jwt_filter -->|"validates tokens"| node_jwt
node_jwt_filter -.->|"loads identity"| node_user_lookup
node_user_lookup -->|"looks up users"| node_repositories
node_user_lookup -->|"creates principal"| node_principal
node_events -.->|"uses"| node_repositories
node_attendance -->|"uses"| node_repositories
node_user_management -->|"uses"| node_repositories
node_attendance -->|"applies filters"| node_filtering
node_repositories -->|"persists records"| node_database
node_soft_delete -->|"archives entities"| node_user_entity
node_soft_delete -->|"archives entities"| node_event_entity
node_soft_delete -->|"archives entities"| node_attendance_entity

click node_auth_api "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/AuthController.java"
click node_event_api "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/EventController.java"
click node_user_api "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/UserController.java"
click node_auth_flow "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/JwtTokenProvider.java"
click node_jwt_filter "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/JwtAuthenticationFilter.java"
click node_principal "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/UserPrincipal.java"
click node_user_lookup "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/CustomUserDetailsService.java"
click node_events "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/EventServiceImpl.java"
click node_attendance "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/AttendanceService.java"
click node_user_management "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/UserServiceImpl.java"
click node_filtering "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/FilterService.java"
click node_repositories "https://github.com/nelushgayashan/event_management/tree/main/src/main/java/com/eventmanagement/repository"
click node_user_entity "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/User.java"
click node_event_entity "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/Event.java"
click node_attendance_entity "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/Attendance.java"
click node_soft_delete "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/SoftDeleteService.java"
click node_cache "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/CacheConfig.java"
click node_rate_limit "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/RateLimitConfig.java"
click node_audit "https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/JpaAuditingConfig.java"

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_api,node_event_api,node_user_api,node_client toneBlue
class node_events,node_attendance,node_user_management,node_filtering toneAmber
class node_auth_flow,node_jwt,node_jwt_filter,node_principal,node_user_lookup toneMint
class node_repositories,node_user_entity,node_event_entity,node_attendance_entity,node_database toneRose
class node_soft_delete,node_cache,node_rate_limit,node_audit toneIndigo
```

## Components

### REST API

- [Auth Endpoints](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/AuthController.java): `src/main/java/com/eventmanagement/controller/AuthController.java`
- [Event Endpoints](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/EventController.java): `src/main/java/com/eventmanagement/controller/EventController.java`
- [User Endpoints](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/controller/UserController.java): `src/main/java/com/eventmanagement/controller/UserController.java`

### Event Workflows

- [Event Management](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/EventServiceImpl.java): `src/main/java/com/eventmanagement/service/impl/EventServiceImpl.java`
- [RSVP Tracking](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/AttendanceService.java): `src/main/java/com/eventmanagement/service/AttendanceService.java`
- [User Administration](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/UserServiceImpl.java): `src/main/java/com/eventmanagement/service/impl/UserServiceImpl.java`
- [Event Filtering](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/FilterService.java): `src/main/java/com/eventmanagement/service/FilterService.java`

### Identity Security

- [Registration Login](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java): `src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java`
- [JWT Tokens](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/JwtTokenProvider.java): `src/main/java/com/eventmanagement/security/JwtTokenProvider.java`
- [JWT Request Filter](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/JwtAuthenticationFilter.java): `src/main/java/com/eventmanagement/security/JwtAuthenticationFilter.java`
- [User Principal](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/UserPrincipal.java): `src/main/java/com/eventmanagement/security/UserPrincipal.java`
- [User Lookup](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/security/CustomUserDetailsService.java): `src/main/java/com/eventmanagement/security/CustomUserDetailsService.java`

### Persistence

- [JPA Repositories](https://github.com/nelushgayashan/event_management/tree/main/src/main/java/com/eventmanagement/repository): `src/main/java/com/eventmanagement/repository`
- [User Record](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/User.java): `src/main/java/com/eventmanagement/entity/User.java`
- [Event Record](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/Event.java): `src/main/java/com/eventmanagement/entity/Event.java`
- [Attendance Record](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/entity/Attendance.java): `src/main/java/com/eventmanagement/entity/Attendance.java`
- **PostgreSQL**

### Cross-Cutting

- [Soft Deletion](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/service/SoftDeleteService.java): `src/main/java/com/eventmanagement/service/SoftDeleteService.java`
- [Caching](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/CacheConfig.java): `src/main/java/com/eventmanagement/config/CacheConfig.java`
- [Rate Limiting](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/RateLimitConfig.java): `src/main/java/com/eventmanagement/config/RateLimitConfig.java`
- [Audit Tracking](https://github.com/nelushgayashan/event_management/blob/main/src/main/java/com/eventmanagement/config/JpaAuditingConfig.java): `src/main/java/com/eventmanagement/config/JpaAuditingConfig.java`

### Other components

- **API Client**

## Connections

- API Client → Auth Endpoints: calls auth (evidence: `README.md`)
- API Client → Event Endpoints: calls events (evidence: `README.md`)
- API Client → User Endpoints: calls users (evidence: `README.md`)
- Auth Endpoints → Registration Login: delegates to (evidence: `src/main/java/com/eventmanagement/controller/AuthController.java`)
- Event Endpoints → Event Management: delegates to (evidence: `src/main/java/com/eventmanagement/controller/EventController.java`)
- User Endpoints → User Administration: delegates to (evidence: `src/main/java/com/eventmanagement/controller/UserController.java`)
- Registration Login → JPA Repositories: uses (evidence: `src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java`)
- Registration Login → JWT Tokens: issues tokens (evidence: `src/main/java/com/eventmanagement/service/impl/AuthServiceImpl.java`)
- JWT Request Filter → JWT Tokens: validates tokens (evidence: `src/main/java/com/eventmanagement/security/JwtAuthenticationFilter.java`)
- JWT Request Filter → User Lookup: loads identity
- User Lookup → JPA Repositories: looks up users (evidence: `src/main/java/com/eventmanagement/security/CustomUserDetailsService.java`)
- User Lookup → User Principal: creates principal (evidence: `src/main/java/com/eventmanagement/security/CustomUserDetailsService.java`)
- Event Management → JPA Repositories: uses (evidence: `src/main/java/com/eventmanagement/service/impl/EventServiceImpl.java`)
- RSVP Tracking → JPA Repositories: uses (evidence: `src/main/java/com/eventmanagement/service/AttendanceService.java`)
- User Administration → JPA Repositories: uses (evidence: `src/main/java/com/eventmanagement/service/impl/UserServiceImpl.java`)
- RSVP Tracking → Event Filtering: applies filters (evidence: `src/main/java/com/eventmanagement/service/AttendanceService.java`)
- JPA Repositories → PostgreSQL: persists records (evidence: `README.md`)
- Soft Deletion → User Record: archives entities (evidence: `src/main/java/com/eventmanagement/service/SoftDeleteService.java`)
- Soft Deletion → Event Record: archives entities (evidence: `src/main/java/com/eventmanagement/service/SoftDeleteService.java`)
- Soft Deletion → Attendance Record: archives entities (evidence: `src/main/java/com/eventmanagement/service/SoftDeleteService.java`)
