# viswadarshan-024/librax architecture

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

- Interactive diagram: https://gitdiagram.com/viswadarshan-024/librax
- Repository: https://github.com/viswadarshan-024/librax

## Overview

##### Project Type & Purpose
- LibraX is a console‐based, full-stack Java application implementing a Smart Library Management System.
- Its primary purpose is to manage users (Admin, Student), library items (Book, Magazine, DVD, EBook), borrowing workflows, fines, and reporting.

##### File Structure
- Top‐level:
- LibraryManagementSystem.java – application entry point
- ui/MenuHandler.java – CLI menu layer
- services/LibrarySystem.java – core business logic
- interfaces/ExamEnrollable.java, FinesApplicable.java – behavior contracts
- models/abstractt/LibraryItem & Member – domain abstractions
- models/items/Book, DVD, EBook, Magazine – concrete domain entities
- models/users/Admin, Student – user roles
- models/BorrowRecord.java – transaction log
- No external DB: uses file-based serialization for persistence (config.properties hints at configurable parameters).

##### Key README Insights
- SOLID, DRY, KISS principles
- Design patterns: Abstract Factory (item creation), Strategy (fine calc), Observer (notifications), Template Method (common workflows)
- Layers: Interfaces → Abstract classes → Models → Services → UI → Main
- Configurable via config.properties; supports future DB/REST API integration.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors
    actorAdmin["Admin"]:::actor
    actorStudent["Student"]:::actor

    %% UI Layer
    subgraph "UI Layer"
        uiMenu["MenuHandler\n(com.library.ui.MenuHandler)"]:::ui
    end

    %% Application Layer
    subgraph "Application Layer"
        appMain["LibraryManagementSystem\n(com.library.LibraryManagementSystem)"]:::app
    end

    %% Service Layer
    subgraph "Service Layer"
        svc["LibrarySystem\n(com.library.services.LibrarySystem)"]:::service
    end

    %% Domain Layer
    subgraph "Domain Layer"
        intFE["ExamEnrollable\n(interface)"]:::domain
        intFA["FinesApplicable\n(interface)"]:::domain
        absItem["LibraryItem\n(abstract)"]:::domain
        absMember["Member\n(abstract)"]:::domain
        itemBook["Book"]:::domain
        itemMag["Magazine"]:::domain
        itemDVD["DVD"]:::domain
        itemEBook["EBook"]:::domain
        userAdminModel["Admin"]:::domain
        userStudentModel["Student"]:::domain
        record["BorrowRecord"]:::domain
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        persist["FileSerializer"]:::persistence
        config["config.properties"]:::persistence
    end

    %% Flows
    actorAdmin --> uiMenu
    actorStudent --> uiMenu
    uiMenu --> appMain
    appMain --> svc
    svc --> absItem
    svc --> absMember
    svc --> record
    svc -->|"serialize/deserialize"| persist
    absItem --> itemBook
    absItem --> itemMag
    absItem --> itemDVD
    absItem --> itemEBook
    absMember --> userAdminModel
    absMember --> userStudentModel
    svc -->|"uses"| intFA
    svc -->|"uses"| intFE
    persist --> config

    %% Click Events
    click appMain "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/LibraryManagementSystem.java"
    click uiMenu "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/ui/MenuHandler.java"
    click svc "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/services/LibrarySystem.java"
    click intFE "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/interfaces/ExamEnrollable.java"
    click intFA "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/interfaces/FinesApplicable.java"
    click absItem "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/abstractt/LibraryItem.java"
    click absMember "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/abstractt/Member.java"
    click itemBook "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/items/Book.java"
    click itemMag "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/items/Magazine.java"
    click itemDVD "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/items/DVD.java"
    click itemEBook "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/items/EBook.java"
    click userAdminModel "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/users/Admin.java"
    click userStudentModel "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/users/Student.java"
    click record "https://github.com/viswadarshan-024/librax/blob/main/src/main/java/com/library/models/BorrowRecord.java"

    %% Styles
    classDef actor fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef app fill:#87CEFA,stroke:#333,stroke-width:1px
    classDef service fill:#90EE90,stroke:#333,stroke-width:1px
    classDef domain fill:#FFFACD,stroke:#333,stroke-width:1px
    classDef persistence fill:#D3D3D3,stroke:#333,stroke-width:1px
    class actorAdmin,actorStudent actor
    class uiMenu ui
    class appMain app
    class svc service
    class intFE,intFA,absItem,absMember,itemBook,itemMag,itemDVD,itemEBook,userAdminModel,userStudentModel,record domain
    class persist,config persistence
```
