# akej24/bookstore architecture

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

- Interactive diagram: https://gitdiagram.com/akej24/bookstore
- Repository: https://github.com/akej24/bookstore

## Overview

##### Project type and purpose
- This is a full-stack Bookstore application comprised of:
- A React.js frontend (hosted separately at the frontend repo).
- A Java Spring Boot backend organized in three modules (monolith, domain, adapters, application).
- Supporting infrastructure (H2/relational database, Redis cache, RabbitMQ message broker).
- Users can register, log in, browse books, manage a shopping cart, checkout, place orders, and view order summaries. Administrators can manage deliveries and users.

##### File structure
- Top-level “bookstore” folder: multi-module Maven project.
- bookstore/domain: pure domain model (entities, value objects, exceptions).
- bookstore/application: application-service layer (handlers, repositories interfaces, event publishers/listeners).
- bookstore/adapters: adapter layer with Spring Boot Controllers, JPA repositories, JSON converters, security, RabbitMQ/Redis configs, caching, mail sender.
- bookstore/monolith: a standalone monolith version (for reference/tests).
- Infrastructure config files in adapters/src/main/resources: Liquibase changelogs, SQL scripts, Redis and RabbitMQ configs, application-*.yml.
- docker-compose.yml and Dockerfile: orchestrate containers for backend, Redis, RabbitMQ, and database.

##### README for additional insights
- Confirms monolithic Spring Boot architecture separated into layers.
- Lists core technologies: Spring Security (JWT), JPA/Hibernate, Redis cache, RabbitMQ messaging, Liquibase migrations, Ehcache, Spring Mail.
- Provides run instructions: Docker Compose brings up all services.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend
    React["React.js Frontend"]:::frontend

    %% Backend Service Container
    subgraph "Backend Service"
        direction TB

        subgraph "API/Adapters Layer"
            direction TB
            BookController["BookController"]:::backend
            CartController["CartController"]:::backend
            CheckoutCartController["CheckoutCartController"]:::backend
            OrderController["OrderController"]:::backend
            UserController["UserController"]:::backend
            DeliveryController["DeliveryController"]:::backend
            JwtAuthFilter["JwtAuthenticationFilter"]:::backend
            SecurityConfig["SecurityConfig"]:::backend
            RabbitMQConfig["RabbitMQConfig"]:::backend
            CacheConfig["CacheConfig"]:::backend
            RedisConfig["RedisConfig"]:::backend
            EmailSenderService["EmailSenderService"]:::backend
        end

        subgraph "Application Layer"
            direction TB
            CartHandler["CartHandler"]:::backend
            CheckoutCartHandler["CheckoutCartHandler"]:::backend
            OrderHandler["OrderHandler"]:::backend
            UserHandler["UserHandler"]:::backend
            BookControllerHandler["BookControllerHandler"]:::backend
            PlacedOrderPublisher["PlacedOrderPublisher"]:::backend
            PlacedOrderListener["PlacedOrderListener"]:::backend
            IEmailSenderService["IEmailSenderService"]:::backend
        end

        subgraph "Domain Layer"
            direction TB
            DomainModel["Entities / VOs"]:::backend
        end

        subgraph "Persistence Adapters"
            direction TB
            BookJpaRepo["BookJpaRepository"]:::backend
            CartRedisRepo["CartRedisRepository"]:::backend
            OrderJpaRepo["OrderJpaRepository"]:::backend
            UserJpaRepo["UserJpaRepository"]:::backend
            DeliveryJpaRepo["DeliveryJpaRepository"]:::backend
            PaymentJpaRepo["PaymentJpaRepository"]:::backend
        end

        subgraph "Messaging Adapters"
            direction TB
            OrderRabbitTemplate["OrderRabbitMQTemplate"]:::backend
        end
    end

    %% Monolith Reference
    Monolith["Monolith Reference App"]:::backend

    %% Infrastructure
    DB[(Relational DB)]:::db
    Redis[(Redis Cache)]:::cache
    RabbitMQ((RabbitMQ)):::mq
    SMTP(("SMTP Mail Server")):::mail

    %% Connections
    React -->|"HTTP/HTTPS (JWT)"| JwtAuthFilter
    JwtAuthFilter --> BookController
    JwtAuthFilter --> CartController
    JwtAuthFilter --> CheckoutCartController
    JwtAuthFilter --> OrderController
    JwtAuthFilter --> UserController
    JwtAuthFilter --> DeliveryController

    BookController -->|"uses"| BookControllerHandler
    CartController -->|"uses"| CartHandler
    CheckoutCartController -->|"uses"| CheckoutCartHandler
    OrderController -->|"uses"| OrderHandler
    UserController -->|"uses"| UserHandler
    DeliveryController -->|"uses"| OrderHandler

    BookControllerHandler --> DomainModel
    CartHandler --> DomainModel
    CheckoutCartHandler --> DomainModel
    OrderHandler --> DomainModel
    UserHandler --> DomainModel

    BookControllerHandler --> BookJpaRepo
    CartHandler --> CartRedisRepo
    OrderHandler --> OrderJpaRepo
    UserHandler --> UserJpaRepo
    OrderHandler --> DeliveryJpaRepo
    OrderHandler --> PaymentJpaRepo

    CartHandler --> Redis
    CartRedisRepo --> Redis

    PlacedOrderPublisher --> OrderRabbitTemplate
    OrderRabbitTemplate --> RabbitMQ
    RabbitMQ --> PlacedOrderListener
    PlacedOrderListener -->|"triggers"| OrderHandler

    PlacedOrderListener --> EmailSenderService
    EmailSenderService --> SMTP

    %% Monolith reference isolated
    Monolith -.-> DomainModel
    Monolith -.-> BookJpaRepo
    Monolith -.-> BookController

    %% Database migrations & caching files (non-data flow)
    CacheConfig --> ehcacheXML["ehcache.xml"]:::infra
    RabbitMQConfig --> RedisConfig
    RabbitMQConfig --> dbchangelog["dbchangelog.xml"]:::infra

    %% Click Events
    click BookController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/book/BookController.java"
    click CartController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/cart/CartController.java"
    click CheckoutCartController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/checkout_cart/CheckoutCartController.java"
    click OrderController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/order/OrderController.java"
    click UserController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/user/UserController.java"
    click DeliveryController "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/delivery/DeliveryController.java"
    click JwtAuthFilter "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/auth/core/JwtAuthenticationFilter.java"
    click SecurityConfig "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/auth/core/SecurityConfig.java"
    click BookJpaRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/book/BookJpaRepository.java"
    click CartRedisRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/cart/CartRedisRepository.java"
    click OrderJpaRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/order/OrderJpaRepository.java"
    click UserJpaRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/user/UserJpaRepository.java"
    click DeliveryJpaRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/delivery/DeliveryJpaRepository.java"
    click PaymentJpaRepo "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/payment/PaymentJpaRepository.java"
    click RabbitMQConfig "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/config/RabbitMQConfig.java"
    click OrderRabbitTemplate "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/purchase/order/OrderRabbitMQTemplate.java"
    click CacheConfig "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/config/CacheConfig.java"
    click ehcacheXML "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/resources/ehcache.xml"
    click RedisConfig "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/config/RedisConfig.java"
    click dbchangelog "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/resources/dbchangelog.xml"
    click EmailSenderService "https://github.com/akej24/bookstore/blob/ddd/bookstore/adapters/src/main/java/com.bookstoreapplication.bookstore/mail_sender/EmailSenderService.java"
    click IEmailSenderService "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/mail_sender/IEmailSenderService.java"
    click PlacedOrderPublisher "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/purchase/order/PlacedOrderPublisher.java"
    click PlacedOrderListener "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/purchase/order/PlacedOrderListener.java"
    click CartHandler "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/purchase/cart/CartHandler.java"
    click CheckoutCartHandler "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/purchase/checkout_cart/CheckoutCartHandler.java"
    click OrderHandler "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/purchase/order/OrderHandler.java"
    click UserHandler "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/user/UserHandler.java"
    click BookControllerHandler "https://github.com/akej24/bookstore/blob/ddd/bookstore/application/src/main/java/com.bookstoreapplication.bookstore/book/BookControllerHandler.java"
    click Monolith "https://github.com/akej24/bookstore/tree/ddd/bookstore/monolith"
    click DockerCompose "https://github.com/akej24/bookstore/blob/ddd/bookstore/docker-compose.yml"
    click Dockerfile "https://github.com/akej24/bookstore/tree/ddd/bookstore/Dockerfile"

    %% Styles
    classDef frontend fill:#E8F1FF,stroke:#3B7BBB,color:#0B3D91
    classDef backend fill:#DFF7E0,stroke:#4A8F29,color:#2F6613
    classDef db fill:#FFF2CC,stroke:#D6A600,color:#8C6B00
    classDef cache fill:#FDEADA,stroke:#DD6B20,color:#A33C09
    classDef mq fill:#E8EAF6,stroke:#3F51B5,color:#1A237E
    classDef mail fill:#F3E5F5,stroke:#8E24AA,color:#4A148C
    classDef infra fill:#EEEEEE,stroke:#999999,color:#333333
```
