# siddhantkore/college-event-management-system architecture

> Architecture diagram of the GitHub repository siddhantkore/college-event-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddhantkore/college-event-management-system
- Repository: https://github.com/siddhantkore/college-event-management-system

## Overview

##### Project type and purpose
- This is a standalone Java desktop application (“College Event Management System”) built with Java Swing for the GUI, Hibernate/MySQL for persistence, and Jakarta Mail/ SMS for notifications.
- Purpose: Let students view/register for events and let admins create/manage events via a desktop interface.

##### File structure
- src/main/java/in/adcet/event_management/gui → Presentation layer (Java Swing frames and dashboards)
- src/main/java/in/adcet/event_management/service → Business-logic layer (EventService, UserService, etc.)
- src/main/java/in/adcet/event_management/dao → Data-access layer (DAO classes for CRUD operations)
- src/main/java/in/adcet/event_management/entity → ORM entities (mapped to MySQL tables)
- src/main/java/in/adcet/event_management/notifications → Notification abstraction and implementations (Mail, SMS)
- src/main/java/in/adcet/event_management/utils → Utility classes (Hibernate SessionFactory, notification helpers)
- Resources: application.properties, hibernate.cfg.xml (DB config), HTML email template.

##### README for additional insights
- Layers: Presentation (Swing), Service, DAO, Database (MySQL via Hibernate), Notifications (Email/SMS).
- Tools: Maven, Lombok, SLF4J for logging.

a. Main components
- Presentation Layer (Java Swing GUI)
- Service Layer (business logic)
- DAO Layer (persistence)
- Database (MySQL)
- Notification Module (SMTP server, SMS gateway)
b. Relationships & data flow
1. User interacts with GUI (e.g., RegisterEventPage)
2. GUI invokes Service methods (RegisterService.register(...))
3. Service uses DAO to read/write entities (UserDAO, EventDAO)
4. DAOs use Hibernate to execute SQL against MySQL
5. Upon certain events (successful registration), Service calls NotificationUtils → MailNotification/SMSNotification → external SMTP or SMS gateway
c. Architectural patterns & principles
- Layered (Presentation → Service → DAO → Database)
- DAO pattern for persistence separation
- DTOs for transferring data to/from GUI
- Utility classes for cross-cutting concerns (SessionFactory, notifications)
d. Key technologies
- Java Swing, Hibernate, MySQL, Jakarta Mail, SLF4J, Maven, Lombok

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Entry
    App["App Entry Point"]:::utils

    %% Presentation Layer
    subgraph "Presentation Layer" 
        LoginFrame["LoginFrame"]:::presentation
        AdminDashboard["AdminDashboard"]:::presentation
        StudentDashboard["StudentDashboard"]:::presentation
        CreateEventPage1["CreateEventPage1"]:::presentation
        RegisterEventPage["RegisterEventPage"]:::presentation
        RegisteredEventsPage["RegisteredEventsPage"]:::presentation
        ViewAdminEventsAdmin["ViewAdminEventsAdmin"]:::presentation
        StudentViewEvent["StudentViewEvent"]:::presentation
    end

    %% Service Layer
    subgraph "Service Layer"
        EventService["EventService"]:::service
        UserService["UserService"]:::service
        RegisterService["RegisterService"]:::service
        ResultService["ResultService"]:::service
    end

    %% DAO Layer
    subgraph "DAO Layer"
        EventDAO["EventDAO"]:::dao
        UserDAO["UserDAO"]:::dao
        RegistrationDAO["RegistrationDAO"]:::dao
        ResultDAO["ResultDAO"]:::dao
    end

    %% Entities & DTOs
    subgraph "Entities and DTOs"
        Events["Events"]:::entity
        UserEntity["User"]:::entity
        RegisterEntity["Register"]:::entity
        ResultsEntity["Results"]:::entity
        AdminEvent["AdminEvent DTO"]:::dto
        RegistrationDTO["RegistrationDTO"]:::dto
        ResultDTO["ResultDTO"]:::dto
    end

    %% Utilities and Notifications
    subgraph "Utilities & Notifications"
        SessionFactoryUtils["SessionFactoryUtils"]:::utils
        NotificationUtils["NotificationUtils"]:::utils
        NotificationIface["Notification interface"]:::notification
        MailNotification["MailNotification"]:::notification
        SMSNotification["SMSNotification"]:::notification
    end

    %% Database and External Services
    MySQL[(MySQL Database)]:::external
    SMTP["SMTP Server"]:::external
    SMSGateway["SMS Gateway"]:::external

    %% Exception Handling
    subgraph "Exceptions"
        ConstraintsViolationException["ConstraintsViolationException"]:::utils
        RegistrationClosedException["RegistrationClosedException"]:::utils
        UserNotFoundException["UserNotFoundException"]:::utils
    end

    %% Relationships
    App -->|starts| LoginFrame
    App -->|starts| AdminDashboard
    App -->|starts| StudentDashboard

    %% GUI to Service
    LoginFrame -->|calls| UserService
    AdminDashboard -->|calls| EventService
    StudentDashboard -->|calls| EventService
    CreateEventPage1 -->|calls| EventService
    RegisterEventPage -->|calls| RegisterService
    RegisteredEventsPage -->|calls| RegisterService
    ViewAdminEventsAdmin -->|calls| EventService
    StudentViewEvent -->|calls| EventService

    %% Service to DAO
    EventService -->|uses| EventDAO
    UserService -->|uses| UserDAO
    RegisterService -->|uses| RegistrationDAO
    ResultService -->|uses| ResultDAO

    %% DAO to DB
    EventDAO -->|executes SQL| MySQL
    UserDAO -->|executes SQL| MySQL
    RegistrationDAO -->|executes SQL| MySQL
    ResultDAO -->|executes SQL| MySQL

    %% Service to Notifications
    RegisterService -->|on success| NotificationUtils
    NotificationUtils -->|instantiates| MailNotification
    NotificationUtils -->|instantiates| SMSNotification
    MailNotification -->|sends email via| SMTP
    SMSNotification -->|sends SMS via| SMSGateway

    %% Utilities to layers
    SessionFactoryUtils -.->|provides SessionFactory| EventDAO
    SessionFactoryUtils -.->|provides SessionFactory| UserDAO
    SessionFactoryUtils -.->|provides SessionFactory| RegistrationDAO
    SessionFactoryUtils -.->|provides SessionFactory| ResultDAO

    %% Exceptions thrown by Services/DAOs
    UserService -->|throws| UserNotFoundException
    RegisterService -->|throws| RegistrationClosedException
    RegistrationDAO -->|throws| ConstraintsViolationException

    %% Click Events
    click LoginFrame "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/LoginFrame.java"
    click AdminDashboard "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/AdminDashboard.java"
    click StudentDashboard "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/StudentDashboard.java"
    click CreateEventPage1 "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/CreateEventPage1.java"
    click RegisterEventPage "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/RegisterEventPage.java"
    click RegisteredEventsPage "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/RegisteredEventsPage.java"
    click ViewAdminEventsAdmin "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/ViewAdminEventsAdmin.java"
    click StudentViewEvent "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/gui/StudentViewEvent.java"
    click EventService "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/service/EventService.java"
    click UserService "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/service/UserService.java"
    click RegisterService "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/service/RegisterService.java"
    click ResultService "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/service/ResultService.java"
    click EventDAO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/dao/EventDAO.java"
    click UserDAO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/dao/UserDAO.java"
    click RegistrationDAO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/dao/RegistrationDAO.java"
    click ResultDAO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/dao/ResultDAO.java"
    click Events "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/entity/Events.java"
    click UserEntity "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/entity/User.java"
    click RegisterEntity "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/entity/Register.java"
    click ResultsEntity "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/entity/Results.java"
    click AdminEvent "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/DTO/AdminEvent.java"
    click RegistrationDTO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/DTO/RegistrationDTO.java"
    click ResultDTO "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/DTO/ResultDTO.java"
    click NotificationIface "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/notifications/Notification.java"
    click MailNotification "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/notifications/MailNotification.java"
    click SMSNotification "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/notifications/SMSNotification.java"
    click SessionFactoryUtils "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/utils/SessionFactoryUtils.java"
    click NotificationUtils "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/utils/NotificationUtils.java"
    click App "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/App.java"
    click ConstraintsViolationException "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/exceptions/ConstraintsViolationException.java"
    click RegistrationClosedException "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/exceptions/RegistrationClosedException.java"
    click UserNotFoundException "https://github.com/siddhantkore/college-event-management-system/blob/main/src/main/java/in/adcet/event_management/exceptions/UserNotFoundException.java"

    %% Styles
    classDef presentation fill:#CCE5FF,stroke:#004085,color:#004085
    classDef service fill:#C6EFCE,stroke:#1E4620,color:#1E4620
    classDef dao fill:#FFF2CC,stroke:#7D6608,color:#7D6608
    classDef entity fill:#FDE9D9,stroke:#7F0000,color:#7F0000
    classDef dto fill:#E8DAEF,stroke:#4A235A,color:#4A235A
    classDef notification fill:#FFD966,stroke:#7A6000,color:#7A6000
    classDef utils fill:#D9EAD3,stroke:#274E13,color:#274E13
    classDef external fill:#D5D8DC,stroke:#1B2631,color:#1B2631
```
