# sujals-codes/last_projects architecture

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

- Interactive diagram: https://gitdiagram.com/sujals-codes/last_projects
- Repository: https://github.com/sujals-codes/last_projects

## Overview

This repository contains two independent products. Inventory Management is a JavaFX product CRUD application backed by JDBC; the Bookstore is a Spring Boot REST API for books and authors, with search, pagination, and DTO responses. The graphs show the sampled call paths and documented capabilities; supplier management is documented but its implementation was not shown, and database wiring for the Bookstore is inferred from its JPA repositories and README configuration.

Main entry points: [`bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/service/BookService.java) (Book operations), [`InventoryManagementSystem/src/ui/MainApp.java`](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/ui/MainApp.java) (Product interface), [`bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.java`](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.java) (Author repository), [`InventoryManagementSystem/src/dao/ProductDAO.java`](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/dao/ProductDAO.java) (Product DAO)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inv_ui["Inventory interface"]
  node_inventory_app["Product interface<br/>[MainApp.java]"]
end

subgraph group_inv_data["Inventory data"]
  node_product_model["Product model<br/>[Product.java]"]
  node_product_dao["Product DAO<br/>[ProductDAO.java]"]
  node_db_connection["JDBC connection<br/>[DBConnection.java]"]
  node_supplier_stock["Supplier and stock management"]
end

subgraph group_book_api["Bookstore API"]
  node_book_controller["Book endpoints"]
  node_author_controller["Author endpoints"]
end

subgraph group_book_domain["Bookstore domain"]
  node_book_service["Book operations<br/>[BookService.java]"]
  node_author_service["Author operations<br/>[AuthorService.java]"]
  node_book_mapper["Book mapper<br/>[BookMapper.java]"]
  node_book_dto["Book response DTO<br/>[BookDTO.java]"]
  node_book_model["Book entity<br/>[Book.java]"]
  node_author_model["Author entity<br/>[Author.java]"]
end

subgraph group_book_persist["Bookstore persistence"]
  node_book_repository["Book repository"]
  node_author_repository["Author repository"]
end

node_inventory_user(("Inventory user"))
node_inventory_db[("MySQL inventory DB")]
node_api_client(("API client"))
node_bookstore_db[("MySQL bookstore DB")]

node_inventory_user -->|"uses"| node_inventory_app
node_inventory_app -->|"loads and mutates"| node_product_dao
node_inventory_app -->|"displays and edits"| node_product_model
node_product_dao -->|"creates and returns"| node_product_model
node_product_dao -->|"opens connection"| node_db_connection
node_db_connection -.->|"connects to"| node_inventory_db
node_inventory_app -.->|"also supports"| node_supplier_stock
node_api_client -->|"calls REST endpoints"| node_book_controller
node_api_client -->|"calls REST endpoints"| node_author_controller
node_book_controller -->|"delegates requests"| node_book_service
node_author_controller -->|"delegates requests"| node_author_service
node_book_service -->|"queries and saves"| node_book_repository
node_book_service -->|"looks up authors"| node_author_repository
node_author_service -->|"queries and saves"| node_author_repository
node_book_service -->|"maps search results"| node_book_mapper
node_book_service -->|"builds responses"| node_book_dto
node_book_mapper -->|"creates DTO"| node_book_dto
node_book_service -->|"reads and updates"| node_book_model
node_book_service -->|"uses author entity"| node_author_model
node_book_repository -->|"persists entity"| node_book_model
node_author_repository -->|"persists entity"| node_author_model
node_book_repository -.->|"persists via JPA"| node_bookstore_db
node_author_repository -.->|"persists via JPA"| node_bookstore_db

click node_inventory_app "https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/ui/MainApp.java"
click node_product_model "https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/model/Product.java"
click node_product_dao "https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/dao/ProductDAO.java"
click node_db_connection "https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/dao/DBConnection.java"
click node_supplier_stock "https://github.com/sujals-codes/last_projects/tree/main/InventoryManagementSystem/src"
click node_book_controller "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/controller/BookController.java"
click node_author_controller "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/controller/AuthorController.java"
click node_book_service "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/service/BookService.java"
click node_author_service "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/service/AuthorService.java"
click node_book_mapper "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/dto/BookMapper.java"
click node_book_dto "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/dto/BookDTO.java"
click node_book_model "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/model/Book.java"
click node_author_model "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/model/Author.java"
click node_book_repository "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/repository/BookRepository.java"
click node_author_repository "https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.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_inventory_app,node_inventory_user,node_api_client toneBlue
class node_product_model,node_product_dao,node_db_connection,node_supplier_stock,node_inventory_db,node_bookstore_db toneAmber
class node_book_controller,node_author_controller toneMint
class node_book_service,node_author_service,node_book_mapper,node_book_dto,node_book_model,node_author_model toneRose
class node_book_repository,node_author_repository toneIndigo
```

## Components

### Inventory interface

- [Product interface](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/ui/MainApp.java): `InventoryManagementSystem/src/ui/MainApp.java`

### Inventory data

- [Product model](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/model/Product.java): `InventoryManagementSystem/src/model/Product.java`
- [Product DAO](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/dao/ProductDAO.java): `InventoryManagementSystem/src/dao/ProductDAO.java`
- [JDBC connection](https://github.com/sujals-codes/last_projects/blob/main/InventoryManagementSystem/src/dao/DBConnection.java): `InventoryManagementSystem/src/dao/DBConnection.java`
- [Supplier and stock management](https://github.com/sujals-codes/last_projects/tree/main/InventoryManagementSystem/src): `InventoryManagementSystem/src`

### Bookstore API

- [Book endpoints](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/controller/BookController.java): `bookstore/src/main/java/com/sujal/bookstore/controller/BookController.java`
- [Author endpoints](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/controller/AuthorController.java): `bookstore/src/main/java/com/sujal/bookstore/controller/AuthorController.java`

### Bookstore domain

- [Book operations](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/service/BookService.java): `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`
- [Author operations](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/service/AuthorService.java): `bookstore/src/main/java/com/sujal/bookstore/service/AuthorService.java`
- [Book mapper](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/dto/BookMapper.java): `bookstore/src/main/java/com/sujal/bookstore/dto/BookMapper.java`
- [Book response DTO](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/dto/BookDTO.java): `bookstore/src/main/java/com/sujal/bookstore/dto/BookDTO.java`
- [Book entity](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/model/Book.java): `bookstore/src/main/java/com/sujal/bookstore/model/Book.java`
- [Author entity](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/model/Author.java): `bookstore/src/main/java/com/sujal/bookstore/model/Author.java`

### Bookstore persistence

- [Book repository](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/repository/BookRepository.java): `bookstore/src/main/java/com/sujal/bookstore/repository/BookRepository.java`
- [Author repository](https://github.com/sujals-codes/last_projects/blob/main/bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.java): `bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.java`

### Other components

- **Inventory user**
- **MySQL inventory DB**
- **API client**
- **MySQL bookstore DB**

## Connections

- Inventory user → Product interface: uses (evidence: `InventoryManagementSystem/src/ui/MainApp.java`)
- Product interface → Product DAO: loads and mutates (evidence: `InventoryManagementSystem/src/ui/MainApp.java`)
- Product interface → Product model: displays and edits (evidence: `InventoryManagementSystem/src/ui/MainApp.java`)
- Product DAO → Product model: creates and returns (evidence: `InventoryManagementSystem/src/dao/ProductDAO.java`)
- Product DAO → JDBC connection: opens connection (evidence: `InventoryManagementSystem/src/dao/ProductDAO.java`)
- JDBC connection → MySQL inventory DB: connects to
- Product interface → Supplier and stock management: also supports (evidence: `InventoryManagementSystem/src/ui/MainApp.java`)
- API client → Book endpoints: calls REST endpoints (evidence: `bookstore/src/main/java/com/sujal/bookstore/controller/BookController.java`)
- API client → Author endpoints: calls REST endpoints (evidence: `bookstore/src/main/java/com/sujal/bookstore/controller/AuthorController.java`)
- Book endpoints → Book operations: delegates requests (evidence: `bookstore/src/main/java/com/sujal/bookstore/controller/BookController.java`)
- Author endpoints → Author operations: delegates requests (evidence: `bookstore/src/main/java/com/sujal/bookstore/controller/AuthorController.java`)
- Book operations → Book repository: queries and saves (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Book operations → Author repository: looks up authors (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Author operations → Author repository: queries and saves (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/AuthorService.java`)
- Book operations → Book mapper: maps search results (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Book operations → Book response DTO: builds responses (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Book mapper → Book response DTO: creates DTO (evidence: `bookstore/src/main/java/com/sujal/bookstore/dto/BookMapper.java`)
- Book operations → Book entity: reads and updates (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Book operations → Author entity: uses author entity (evidence: `bookstore/src/main/java/com/sujal/bookstore/service/BookService.java`)
- Book repository → Book entity: persists entity (evidence: `bookstore/src/main/java/com/sujal/bookstore/repository/BookRepository.java`)
- Author repository → Author entity: persists entity (evidence: `bookstore/src/main/java/com/sujal/bookstore/repository/AuthorRepository.java`)
- Book repository → MySQL bookstore DB: persists via JPA
- Author repository → MySQL bookstore DB: persists via JPA
