# swati-patil-11/bookmart architecture

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

- Interactive diagram: https://gitdiagram.com/swati-patil-11/bookmart
- Repository: https://github.com/swati-patil-11/bookmart

## Overview

BookMart is a second-hand book marketplace with an Android client and a Spring backend. Its user-facing stages include account access, browsing and book details, listing books, cart and wishlist management, checkout, payments, and order history; the tree also shows seller and admin screens. The sampled backend confirms book listings and cart/wishlist APIs, plus order persistence. Android-to-backend wiring, checkout/payment behavior, and several backend endpoints were not shown, so those relationships are not asserted.

Main entry points: [`backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java`](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java) (Book repository), [`backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java`](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java) (Cart API), [`backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java`](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java) (Wishlist API), [`backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java`](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java) (Cart repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_android_app["Android client"]
  node_account["Account access<br/>[LoginActivity.java]"]
  node_catalog_ui["Catalog browsing"]
  node_book_detail["Book details"]
  node_sell_ui["Sell books"]
  node_cart_ui["Shopping cart<br/>[CartActivity.java]"]
  node_checkout_ui["Checkout"]
  node_payment_ui["Payments"]
  node_orders_ui["Order history"]
  node_wishlist_ui["Wishlist"]
  node_seller_admin["Seller and admin"]
end

subgraph group_api["Backend API"]
  node_book_api["Book listings API"]
  node_cart_api["Cart API"]
  node_wishlist_api["Wishlist API"]
  node_order_api["Order API"]
end

subgraph group_persistence["Persistence"]
  node_books[("Book records<br/>[Book.java]")]
  node_cart_items[("Cart records<br/>[CartItem.java]")]
  node_wishlist_items[("Wishlist records<br/>[WishlistItem.java]")]
  node_orders[("Order records<br/>[Order.java]")]
  node_book_repo["Book repository"]
  node_cart_repo["Cart repository"]
  node_wishlist_repo["Wishlist repository"]
  node_order_repo["Order repository"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_android_app
node_book_api -->|"queries and saves"| node_book_repo
node_cart_api -->|"reads and writes"| node_cart_repo
node_cart_api -->|"looks up books"| node_book_repo
node_wishlist_api -->|"reads and writes"| node_wishlist_repo
node_wishlist_api -->|"looks up books"| node_book_repo
node_order_api -->|"uses"| node_order_repo
node_book_repo -->|"persists"| node_books
node_cart_repo -->|"persists"| node_cart_items
node_wishlist_repo -->|"persists"| node_wishlist_items
node_order_repo -->|"persists"| node_orders

click node_android_app "https://github.com/swati-patil-11/bookmart/tree/main/app/src/main/java/com/example/bookmart_project"
click node_account "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/LoginActivity.java"
click node_catalog_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/UserHomeActivity.java"
click node_book_detail "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/BookDetailActivity.java"
click node_sell_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/SellBookActivity.java"
click node_cart_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/CartActivity.java"
click node_checkout_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/CheckoutActivity.java"
click node_payment_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/PaymentsActivity.java"
click node_orders_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/OrdersActivity.java"
click node_wishlist_ui "https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/WishlistActivity.java"
click node_seller_admin "https://github.com/swati-patil-11/bookmart/tree/main/app/src/main/java/com/example/bookmart_project/activities"
click node_book_api "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/BookController.java"
click node_cart_api "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java"
click node_wishlist_api "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java"
click node_order_api "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/OrderController.java"
click node_books "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/Book.java"
click node_cart_items "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/CartItem.java"
click node_wishlist_items "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/WishlistItem.java"
click node_orders "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/Order.java"
click node_book_repo "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java"
click node_cart_repo "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java"
click node_wishlist_repo "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/WishlistRepository.java"
click node_order_repo "https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/OrderRepository.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_android_app,node_account,node_catalog_ui,node_book_detail,node_sell_ui,node_cart_ui,node_checkout_ui,node_payment_ui,node_orders_ui,node_wishlist_ui,node_seller_admin toneBlue
class node_book_api,node_cart_api,node_wishlist_api,node_order_api toneAmber
class node_books,node_cart_items,node_wishlist_items,node_orders,node_book_repo,node_cart_repo,node_wishlist_repo,node_order_repo toneMint
class node_shopper toneIndigo
```

## Components

### Android app

- [Android client](https://github.com/swati-patil-11/bookmart/tree/main/app/src/main/java/com/example/bookmart_project): `app/src/main/java/com/example/bookmart_project`
- [Account access](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/LoginActivity.java): `app/src/main/java/com/example/bookmart_project/activities/LoginActivity.java`
- [Catalog browsing](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/UserHomeActivity.java): `app/src/main/java/com/example/bookmart_project/activities/UserHomeActivity.java`
- [Book details](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/BookDetailActivity.java): `app/src/main/java/com/example/bookmart_project/activities/BookDetailActivity.java`
- [Sell books](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/SellBookActivity.java): `app/src/main/java/com/example/bookmart_project/activities/SellBookActivity.java`
- [Shopping cart](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/CartActivity.java): `app/src/main/java/com/example/bookmart_project/activities/CartActivity.java`
- [Checkout](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/CheckoutActivity.java): `app/src/main/java/com/example/bookmart_project/activities/CheckoutActivity.java`
- [Payments](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/PaymentsActivity.java): `app/src/main/java/com/example/bookmart_project/activities/PaymentsActivity.java`
- [Order history](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/OrdersActivity.java): `app/src/main/java/com/example/bookmart_project/activities/OrdersActivity.java`
- [Wishlist](https://github.com/swati-patil-11/bookmart/blob/main/app/src/main/java/com/example/bookmart_project/activities/WishlistActivity.java): `app/src/main/java/com/example/bookmart_project/activities/WishlistActivity.java`
- [Seller and admin](https://github.com/swati-patil-11/bookmart/tree/main/app/src/main/java/com/example/bookmart_project/activities): `app/src/main/java/com/example/bookmart_project/activities`

### Backend API

- [Book listings API](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/BookController.java): `backend/backend/src/main/java/com/bookmart/backend/controllers/BookController.java`
- [Cart API](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java): `backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java`
- [Wishlist API](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java): `backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java`
- [Order API](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/controllers/OrderController.java): `backend/backend/src/main/java/com/bookmart/backend/controllers/OrderController.java`

### Persistence

- [Book records](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/Book.java): `backend/backend/src/main/java/com/bookmart/backend/models/Book.java`
- [Cart records](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/CartItem.java): `backend/backend/src/main/java/com/bookmart/backend/models/CartItem.java`
- [Wishlist records](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/WishlistItem.java): `backend/backend/src/main/java/com/bookmart/backend/models/WishlistItem.java`
- [Order records](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/models/Order.java): `backend/backend/src/main/java/com/bookmart/backend/models/Order.java`
- [Book repository](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java): `backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java`
- [Cart repository](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java): `backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java`
- [Wishlist repository](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/WishlistRepository.java): `backend/backend/src/main/java/com/bookmart/backend/repositories/WishlistRepository.java`
- [Order repository](https://github.com/swati-patil-11/bookmart/blob/main/backend/backend/src/main/java/com/bookmart/backend/repositories/OrderRepository.java): `backend/backend/src/main/java/com/bookmart/backend/repositories/OrderRepository.java`

### Other components

- **Shopper**

## Connections

- Shopper → Android client: uses
- Book listings API → Book repository: queries and saves (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/BookController.java`)
- Cart API → Cart repository: reads and writes (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java`)
- Cart API → Book repository: looks up books (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/CartController.java`)
- Wishlist API → Wishlist repository: reads and writes (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java`)
- Wishlist API → Book repository: looks up books (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/WishlistController.java`)
- Order API → Order repository: uses (evidence: `backend/backend/src/main/java/com/bookmart/backend/controllers/OrderController.java`)
- Book repository → Book records: persists (evidence: `backend/backend/src/main/java/com/bookmart/backend/repositories/BookRepository.java`)
- Cart repository → Cart records: persists (evidence: `backend/backend/src/main/java/com/bookmart/backend/repositories/CartItemRepository.java`)
- Wishlist repository → Wishlist records: persists (evidence: `backend/backend/src/main/java/com/bookmart/backend/repositories/WishlistRepository.java`)
- Order repository → Order records: persists (evidence: `backend/backend/src/main/java/com/bookmart/backend/repositories/OrderRepository.java`)
