# rbsuhail/easybook architecture

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

- Interactive diagram: https://gitdiagram.com/rbsuhail/easybook
- Repository: https://github.com/rbsuhail/easybook

## Overview

##### Project type and purpose
- From the README and file tree, this is a standalone backend service (no dedicated frontend code) for managing reservations (tickets/trains in code, books in README) with basic CLI or API entrypoint. It implements user authentication, listing/search, reservation logic, and an admin interface (presumably via the same service or CLI).

##### File structure
- Top-level:
- app/src/main/java/ticket/booking/App.java – the application entrypoint
- entities/ – domain objects (User, Train, Ticket)
- service/ – business logic (TrainService, UserBookingService)
- localDB/ – JSON files acting as the data store
- util/ – helper routines
- Tests mirror the main structure under app/src/test.
- Gradle config and wrapper at project root.

##### README for additional insights
- Lists core features: authentication, listing, search, reservation, admin panel.
- Tech stack: Java + Gradle.
- No external services declared; data is persisted as JSON in localDB.

##### Detailed capture of essential elements
- Don’t just group everything as “backend”; show each service and its dependency on the JSON files.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Actor
    External["Admin CLI/REST Client"]:::external

    %% API/CLI Layer
    subgraph "API/CLI Layer"
        API["App.java"]:::entrypoint
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        AuthU["Authentication Module\n(UserServiceUtil)"]:::service
        Booking["UserBookingService"]:::service
        Inventory["TrainService"]:::service
        Util["Utility Module\n(UserServiceUtil)"]:::service
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        DataAccess["localDB Interface"]:::dataaccess
        subgraph "Domain Entities"
            User["User"]:::dataaccess
            Train["Train"]:::dataaccess
            Ticket["Ticket"]:::dataaccess
        end
    end

    %% Data Store
    subgraph "Data Store"
        TrainsJSON["trains.json"]:::datastore
        UsersJSON["users.json"]:::datastore
    end

    %% Testing Layer
    subgraph "Testing Components"
        TestSuite["AppTest"]:::test
        Ledger["Ledger Validation Logs"]:::test
    end

    %% Connections
    External -->|uses| API
    API -->|calls| AuthU
    API -->|calls| Booking
    API -->|calls| Inventory

    AuthU -->|reads/writes| DataAccess
    Booking -->|reads/writes| DataAccess
    Inventory -->|reads/writes| DataAccess

    Booking -->|uses| Util
    Inventory -->|uses| Util

    DataAccess -->|loads| TrainsJSON
    DataAccess -->|loads| UsersJSON

    TestSuite -->|simulates| API
    TestSuite -->|validates| Ledger

    %% Click Events
    click API "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/App.java"
    click AuthU "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/util/UserServiceUtil.java"
    click Booking "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/service/UserBookingService.java"
    click Inventory "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/service/TrainService.java"
    click Util "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/util/UserServiceUtil.java"
    click DataAccess "https://github.com/rbsuhail/easybook/tree/main/app/src/main/java/ticket/booking/localDB"
    click User "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/entities/User.java"
    click Train "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/entities/Train.java"
    click Ticket "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/entities/Ticket.java"
    click TrainsJSON "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/localDB/trains.json"
    click UsersJSON "https://github.com/rbsuhail/easybook/blob/main/app/src/main/java/ticket/booking/localDB/users.json"
    click TestSuite "https://github.com/rbsuhail/easybook/blob/main/app/src/test/java/ticket/booking/AppTest.java"
    click Ledger "https://github.com/rbsuhail/easybook/tree/main/app/src/main/java/ticket/booking/test-ledger/"

    %% Styles
    classDef entrypoint fill:#bbdefb,stroke:#0d47a1
    classDef service fill:#c8e6c9,stroke:#2e7d32
    classDef dataaccess fill:#ffe0b2,stroke:#ef6c00
    classDef datastore fill:#eeeeee,stroke:#424242
    classDef external fill:#e1bee7,stroke:#6a1b9a
    classDef test fill:#f0f4c3,stroke:#827717
```
