About This Architecture

Page Carnival is a Spring Boot book marketplace architecture featuring role-based access control for admins, sellers, and buyers through Spring Security and custom authentication handlers. Client requests flow through a Security Filter Chain into MVC controllers serving Thymeleaf templates and REST API controllers returning JSON, with cross-cutting concerns like @PreAuthorize and @Valid enforced at the controller layer. The Service Layer (AuthService, BookService, CartService, OrderService) orchestrates business logic and delegates data access to Spring Data JPA repositories connected to PostgreSQL 15. The entire application is containerized with Docker and deployed via GitHub Actions CI/CD to Render Cloud, demonstrating a production-ready layered architecture with separation of concerns. Fork this diagram to customize role hierarchies, add new services, or adapt the deployment pipeline for your own marketplace platform.

People also ask

How do I structure a Spring Boot application with role-based authentication, separate MVC and REST API layers, and database persistence?

Page Carnival demonstrates a production-grade Spring Boot architecture where Spring Security Filter Chain authenticates users (admin, seller, buyer) and routes requests to MVC controllers (serving Thymeleaf templates) or REST API controllers (returning JSON). The Service Layer handles business logic, Spring Data JPA repositories manage database access to PostgreSQL, and Docker + GitHub Actions aut