# basilbarakat15/labriry architecture

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

- Interactive diagram: https://gitdiagram.com/basilbarakat15/labriry
- Repository: https://github.com/basilbarakat15/labriry

## Overview

This is a JavaFX library-management desktop application. Employees and customers sign in, enter role-specific screens, then manage catalogue records, users, borrowing, purchases and feedback. The README also documents searching books and registering/tracking users. Sampled controllers execute PostgreSQL queries directly rather than through a separate service or repository layer. The source index supports additional controller-to-model associations, but unsampled UI and persistence flows are shown conservatively; the database relationships below are limited to sampled SQL evidence.

Main entry points: [`LogInController.java`](https://github.com/basilbarakat15/labriry/blob/main/LogInController.java) (Sign-in), [`BookController.java`](https://github.com/basilbarakat15/labriry/blob/main/BookController.java) (Book catalogue), [`CustomerDashboardController.java`](https://github.com/basilbarakat15/labriry/blob/main/CustomerDashboardController.java) (Customer dashboard), [`App.java`](https://github.com/basilbarakat15/labriry/blob/main/App.java) (JavaFX application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and dashboards"]
  node_app["JavaFX application<br/>[App.java]"]
  node_login["Sign-in"]
  node_dash["Employee dashboard"]
  node_custdash["Customer dashboard"]
end

subgraph group_catalog["Catalogue management"]
  node_search["Book search"]
  node_bookui["Book catalogue"]
  node_bookadd["Add books"]
  node_bookedit["Edit books"]
  node_authorui["Author records"]
  node_publisherui["Publisher records"]
  node_customerbook["Customer book view<br/>[CustomerBook.java]"]
  node_book["Book entity<br/>[Book.java]"]
  node_author["Author entity<br/>[Author.java]"]
  node_publisher["Publisher entity<br/>[Publisher.java]"]
end

subgraph group_circulation["Library operations"]
  node_borrowui["Borrow and return"]
  node_borrowadd["Add borrow"]
  node_borrowedit["Edit borrow"]
  node_borrow["Borrow entity<br/>[Borrow.java]"]
end

subgraph group_people["People management"]
  node_customerui["Customer records"]
  node_employeeui["Employee records"]
  node_customer["Customer entity<br/>[Customer.java]"]
  node_employee["Employee entity<br/>[Employee.java]"]
end

subgraph group_community["Purchases and feedback"]
  node_purchaseui["Purchases"]
  node_feedbackui["Feedback"]
  node_customerfeedback["Customer feedback"]
  node_purchase["Purchase entity<br/>[Purchase.java]"]
  node_feedback["Feedback entity<br/>[Feedback.java]"]
end

node_user(("Library user"))
node_postgres[("PostgreSQL database")]

node_user -->|"starts"| node_app
node_app -->|"loads sign-in"| node_login
node_user -->|"submits credentials"| node_login
node_login -->|"checks credentials"| node_postgres
node_login -->|"routes employee"| node_dash
node_login -->|"routes customer"| node_custdash
node_bookui -->|"queries catalogue"| node_postgres
node_employeeui -->|"queries employees"| node_postgres
node_authorui -->|"queries authors"| node_postgres
node_borrowui -->|"queries borrows"| node_postgres
node_bookui -->|"creates rows"| node_book
node_bookui -->|"creates related data"| node_author
node_bookui -->|"creates related data"| node_publisher
node_employeeui -->|"creates rows"| node_employee
node_authorui -->|"creates rows"| node_author
node_borrowui -->|"creates rows"| node_borrow
node_bookadd -->|"uses entity"| node_book
node_borrowadd -->|"uses entity"| node_borrow
node_bookedit -->|"uses entity"| node_book
node_borrowedit -->|"uses entity"| node_borrow
node_customerui -->|"uses entity"| node_customer
node_purchaseui -->|"uses entity"| node_purchase
node_feedbackui -->|"uses entity"| node_feedback
node_custdash -->|"uses view model"| node_customerbook
node_search -->|"uses entity"| node_book
node_custdash -->|"uses entity"| node_feedback
node_customerfeedback -->|"reads session state"| node_login
node_dash -->|"navigates screens"| node_app
node_custdash -->|"navigates screens"| node_app

click node_app "https://github.com/basilbarakat15/labriry/blob/main/App.java"
click node_login "https://github.com/basilbarakat15/labriry/blob/main/LogInController.java"
click node_dash "https://github.com/basilbarakat15/labriry/blob/main/DashboardController.java"
click node_custdash "https://github.com/basilbarakat15/labriry/blob/main/CustomerDashboardController.java"
click node_search "https://github.com/basilbarakat15/labriry/blob/main/CustomerBookSearchController.java"
click node_bookui "https://github.com/basilbarakat15/labriry/blob/main/BookController.java"
click node_bookadd "https://github.com/basilbarakat15/labriry/blob/main/AddBookController.java"
click node_bookedit "https://github.com/basilbarakat15/labriry/blob/main/EditBookController.java"
click node_authorui "https://github.com/basilbarakat15/labriry/blob/main/AuthorController.java"
click node_publisherui "https://github.com/basilbarakat15/labriry/blob/main/PublisherController.java"
click node_borrowui "https://github.com/basilbarakat15/labriry/blob/main/BorrowController.java"
click node_borrowadd "https://github.com/basilbarakat15/labriry/blob/main/AddBorrowController.java"
click node_borrowedit "https://github.com/basilbarakat15/labriry/blob/main/EditBorrowController.java"
click node_customerui "https://github.com/basilbarakat15/labriry/blob/main/CustomerController.java"
click node_employeeui "https://github.com/basilbarakat15/labriry/blob/main/EmployeeController.java"
click node_purchaseui "https://github.com/basilbarakat15/labriry/blob/main/PurchasesController.java"
click node_feedbackui "https://github.com/basilbarakat15/labriry/blob/main/FeedbackController.java"
click node_customerfeedback "https://github.com/basilbarakat15/labriry/blob/main/CustomerFeedBackController.java"
click node_customerbook "https://github.com/basilbarakat15/labriry/blob/main/CustomerBook.java"
click node_book "https://github.com/basilbarakat15/labriry/blob/main/Book.java"
click node_author "https://github.com/basilbarakat15/labriry/blob/main/Author.java"
click node_publisher "https://github.com/basilbarakat15/labriry/blob/main/Publisher.java"
click node_borrow "https://github.com/basilbarakat15/labriry/blob/main/Borrow.java"
click node_customer "https://github.com/basilbarakat15/labriry/blob/main/Customer.java"
click node_employee "https://github.com/basilbarakat15/labriry/blob/main/Employee.java"
click node_purchase "https://github.com/basilbarakat15/labriry/blob/main/Purchase.java"
click node_feedback "https://github.com/basilbarakat15/labriry/blob/main/Feedback.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_app,node_login,node_dash,node_custdash,node_user toneBlue
class node_search,node_bookui,node_bookadd,node_bookedit,node_authorui,node_publisherui,node_customerbook,node_book,node_author,node_publisher,node_postgres toneAmber
class node_borrowui,node_borrowadd,node_borrowedit,node_borrow toneMint
class node_customerui,node_employeeui,node_customer,node_employee toneRose
class node_purchaseui,node_feedbackui,node_customerfeedback,node_purchase,node_feedback toneIndigo
```

## Components

### Access and dashboards

- [JavaFX application](https://github.com/basilbarakat15/labriry/blob/main/App.java): `App.java`
- [Sign-in](https://github.com/basilbarakat15/labriry/blob/main/LogInController.java): `LogInController.java`
- [Employee dashboard](https://github.com/basilbarakat15/labriry/blob/main/DashboardController.java): `DashboardController.java`
- [Customer dashboard](https://github.com/basilbarakat15/labriry/blob/main/CustomerDashboardController.java): `CustomerDashboardController.java`

### Catalogue management

- [Book search](https://github.com/basilbarakat15/labriry/blob/main/CustomerBookSearchController.java): `CustomerBookSearchController.java`
- [Book catalogue](https://github.com/basilbarakat15/labriry/blob/main/BookController.java): `BookController.java`
- [Add books](https://github.com/basilbarakat15/labriry/blob/main/AddBookController.java): `AddBookController.java`
- [Edit books](https://github.com/basilbarakat15/labriry/blob/main/EditBookController.java): `EditBookController.java`
- [Author records](https://github.com/basilbarakat15/labriry/blob/main/AuthorController.java): `AuthorController.java`
- [Publisher records](https://github.com/basilbarakat15/labriry/blob/main/PublisherController.java): `PublisherController.java`
- [Customer book view](https://github.com/basilbarakat15/labriry/blob/main/CustomerBook.java): `CustomerBook.java`
- [Book entity](https://github.com/basilbarakat15/labriry/blob/main/Book.java): `Book.java`
- [Author entity](https://github.com/basilbarakat15/labriry/blob/main/Author.java): `Author.java`
- [Publisher entity](https://github.com/basilbarakat15/labriry/blob/main/Publisher.java): `Publisher.java`

### Library operations

- [Borrow and return](https://github.com/basilbarakat15/labriry/blob/main/BorrowController.java): `BorrowController.java`
- [Add borrow](https://github.com/basilbarakat15/labriry/blob/main/AddBorrowController.java): `AddBorrowController.java`
- [Edit borrow](https://github.com/basilbarakat15/labriry/blob/main/EditBorrowController.java): `EditBorrowController.java`
- [Borrow entity](https://github.com/basilbarakat15/labriry/blob/main/Borrow.java): `Borrow.java`

### People management

- [Customer records](https://github.com/basilbarakat15/labriry/blob/main/CustomerController.java): `CustomerController.java`
- [Employee records](https://github.com/basilbarakat15/labriry/blob/main/EmployeeController.java): `EmployeeController.java`
- [Customer entity](https://github.com/basilbarakat15/labriry/blob/main/Customer.java): `Customer.java`
- [Employee entity](https://github.com/basilbarakat15/labriry/blob/main/Employee.java): `Employee.java`

### Purchases and feedback

- [Purchases](https://github.com/basilbarakat15/labriry/blob/main/PurchasesController.java): `PurchasesController.java`
- [Feedback](https://github.com/basilbarakat15/labriry/blob/main/FeedbackController.java): `FeedbackController.java`
- [Customer feedback](https://github.com/basilbarakat15/labriry/blob/main/CustomerFeedBackController.java): `CustomerFeedBackController.java`
- [Purchase entity](https://github.com/basilbarakat15/labriry/blob/main/Purchase.java): `Purchase.java`
- [Feedback entity](https://github.com/basilbarakat15/labriry/blob/main/Feedback.java): `Feedback.java`

### Other components

- **Library user**
- **PostgreSQL database**

## Connections

- Library user → JavaFX application: starts (evidence: `App.java`)
- JavaFX application → Sign-in: loads sign-in (evidence: `App.java`)
- Library user → Sign-in: submits credentials (evidence: `LogInController.java`)
- Sign-in → PostgreSQL database: checks credentials (evidence: `LogInController.java`)
- Sign-in → Employee dashboard: routes employee (evidence: `LogInController.java`)
- Sign-in → Customer dashboard: routes customer (evidence: `LogInController.java`)
- Book catalogue → PostgreSQL database: queries catalogue (evidence: `BookController.java`)
- Employee records → PostgreSQL database: queries employees (evidence: `EmployeeController.java`)
- Author records → PostgreSQL database: queries authors (evidence: `AuthorController.java`)
- Borrow and return → PostgreSQL database: queries borrows (evidence: `BorrowController.java`)
- Book catalogue → Book entity: creates rows (evidence: `BookController.java`)
- Book catalogue → Author entity: creates related data (evidence: `BookController.java`)
- Book catalogue → Publisher entity: creates related data (evidence: `BookController.java`)
- Employee records → Employee entity: creates rows (evidence: `EmployeeController.java`)
- Author records → Author entity: creates rows (evidence: `AuthorController.java`)
- Borrow and return → Borrow entity: creates rows (evidence: `BorrowController.java`)
- Add books → Book entity: uses entity (evidence: `AddBookController.java`)
- Add borrow → Borrow entity: uses entity (evidence: `AddBorrowController.java`)
- Edit books → Book entity: uses entity (evidence: `EditBookController.java`)
- Edit borrow → Borrow entity: uses entity (evidence: `EditBorrowController.java`)
- Customer records → Customer entity: uses entity (evidence: `CustomerController.java`)
- Purchases → Purchase entity: uses entity (evidence: `PurchasesController.java`)
- Feedback → Feedback entity: uses entity (evidence: `FeedbackController.java`)
- Customer dashboard → Customer book view: uses view model (evidence: `CustomerDashboardController.java`)
- Book search → Book entity: uses entity (evidence: `CustomerBookSearchController.java`)
- Customer dashboard → Feedback entity: uses entity (evidence: `CustomerDashboardController.java`)
- Customer feedback → Sign-in: reads session state (evidence: `CustomerFeedBackController.java`)
- Employee dashboard → JavaFX application: navigates screens (evidence: `DashboardController.java`)
- Customer dashboard → JavaFX application: navigates screens (evidence: `CustomerDashboardController.java`)
