# saranyaa5/hallbookingsystemmaven architecture

> Architecture diagram of the GitHub repository saranyaa5/hallbookingsystemmaven, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saranyaa5/hallbookingsystemmaven
- Repository: https://github.com/saranyaa5/hallbookingsystemmaven

## Overview

##### Project type and purpose
- This is a Java/Maven–based, console‐driven application (“HallBookingSystemMaven”) whose sole responsibility is to manage hall‐booking operations (CRUD on halls, bookings, customers, payments) via a command‐line UI. It uses a layered architecture (models, DAOs, services, utils) and connects to a relational database via JDBC, sending confirmation emails via SMTP.

##### File structure
- Top‐level Maven project with pom.xml
- src/main/java/com/hallbooking:
- App.java: console launcher & menu handler
- model/: entity classes (Hall, Booking, Customer, Payment, Admin)
- dao/: data‐access interfaces or classes (BookingDAO, HallDAO, etc.)
- service/: business‐logic layer (BookingService, PriceService, AdminService, etc.)
- utils/: DBConnection (JDBC connection factory), EmailUtil (SMTP helper), ConsoleColors
- src/main/resources:
- application.properties (DB URL, credentials, SMTP settings)
- schema.sql (DDL for tables)
- src/test: JUnit test for App

##### Additional insights from README
- Purpose: streamline hall booking for both administrators and users.
- No built‐in GUI or web interface—pure console and back‐end.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        App["Console UI (App)"]:::code
    end

    subgraph "Service Layer"
        BS["BookingService"]:::code
        CS["CustomerService"]:::code
        AS["AdminService"]:::code
        AC["AdminCredentials"]:::code
        HS["HallSearch"]:::code
        PS["PaymentService"]:::code
        PB["PaymentServiceBase"]:::code
        PrS["PriceService"]:::code
    end

    subgraph "DAO Layer"
        BDAO["BookingDAO"]:::code
        CDAO["CustomerDAO"]:::code
        HDAO["HallDAO"]:::code
        PDAO["PaymentDAO"]:::code
        SDAO["SearchDAO"]:::code
    end

    subgraph "Utilities"
        DBC["DBConnection"]:::code
        EU["EmailUtil"]:::code
        CC["ConsoleColors"]:::code
    end

    subgraph "Configuration Files"
        AP["application.properties"]:::config
        SC["schema.sql"]:::config
    end

    Database[(Relational Database)]:::database
    SMTP([SMTP Email Server]):::external

    subgraph "Test Suite"
        AppTest["App Test Suite"]:::test
    end

    %% Relationships
    App -->|"invoke business API"| BS
    App -->|"invoke business API"| CS
    App -->|"invoke business API"| AS
    App -->|"invoke business API"| HS
    App -->|"invoke business API"| PS
    App -->|"invoke business API"| PrS

    BS -->|"persistence calls"| BDAO
    CS -->|"persistence calls"| CDAO
    AS -->|"persistence calls"| CDAO
    HS -->|"persistence calls"| SDAO
    PS -->|"persistence calls"| PDAO
    PrS -->|"persistence calls"| HDAO
    PB -.-> PS

    BDAO -->|"SQL queries"| Database
    CDAO -->|"SQL queries"| Database
    HDAO -->|"SQL queries"| Database
    PDAO -->|"SQL queries"| Database
    SDAO -->|"SQL queries"| Database

    BS -->|"sendEmail()"| EU
    CS -->|"sendEmail()"| EU

    DBC -->|"jdbc connect"| Database
    EU -->|"smtp connect"| SMTP

    AP -.->|"configures"| DBC
    AP -.->|"configures"| EU
    SC -.->|"defines schema"| Database

    AppTest -->|"tests"| App

    %% Click Events
    click App "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/App.java"
    click BS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/BookingService.java"
    click CS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/CustomerService.java"
    click AS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/AdminService.java"
    click AC "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/AdminCredentials.java"
    click HS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/HallSearch.java"
    click PS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/PaymentService.java"
    click PB "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/PaymentServiceBase.java"
    click PrS "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/service/PriceService.java"
    click BDAO "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/dao/BookingDAO.java"
    click CDAO "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/dao/CustomerDAO.java"
    click HDAO "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/dao/HallDAO.java"
    click PDAO "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/dao/PaymentDAO.java"
    click SDAO "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/dao/SearchDAO.java"
    click DBC "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/utils/DBConnection.java"
    click EU "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/utils/EmailUtil.java"
    click CC "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/java/com/hallbooking/utils/ConsoleColors.java"
    click AP "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/resources/application.properties"
    click SC "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/main/resources/schema.sql"
    click AppTest "https://github.com/saranyaa5/hallbookingsystemmaven/blob/main/src/test/java/com/hallbooking/hall_booking_demo/AppTest.java"

    %% Styles
    classDef code fill:#D6EAF8,stroke:#3498DB
    classDef database fill:#ABEBC6,stroke:#28B463
    classDef external fill:#F9E79F,stroke:#F1C40F
    classDef config fill:#FADBD8,stroke-dasharray:5 5
    classDef test fill:#E8DAEF,stroke:#8E44AD
```
