- Java 47.1%
- JavaScript 24.7%
- CSS 13.5%
- HTML 12.2%
- Dockerfile 2.5%
Robert von Burg
3e1a2f30e5
Updated the README with screenshots of the Web UI and added new section detailing the default login credentials. Also updated `docs/web_ui.md` to include the location for storing screenshot assets. |
||
|---|---|---|
| docs | ||
| runtime | ||
| src | ||
| .gitignore | ||
| docker-compose.yml | ||
| Dockerfile | ||
| pom.xml | ||
| README.md | ||
Strolch Bookshop
Bookshop built on Strolch. This project is the implementation of the Strolch Tutorial.
Features
In this tutorial project we build a book store using Strolch. The book store has the following features:
- The store owner can add, update and remove books
- The store owner can edit the stock quantity
- Users can view a list of books
- Users can add books to a virtual cart
- Users can create and verify an account using an e-mail address
- Users can submit an order for the books in their cart
- The store owner can see the orders by state (pending, preparing, sent)
- The store owner can update the state of an order (preparing, sent)
- Notify the user when the order is sent
- Modern Web UI: A clean, branded web interface to manage books (Login, Search, Add, Edit, Delete). Featuring Strolch's mascot and logo for a professional look.
Web UI Screenshots
The modern Web UI provides a clean interface for managing the bookshop.
Login Screen
Book Table
Getting Started
Prerequisites
- Java (JDK 24 recommended)
- Maven 3.6+
Build Instructions
To build the project:
mvn clean install
Running Tests
To run the tests:
mvn test
Running the Application
The Bookshop is a Strolch-based web application tutorial. It is packaged as a WAR file and can be deployed to any Jakarta EE compatible servlet container (e.g., Tomcat, Jetty).
For development, the project is configured with a local development profile that uses the runtime configuration in the runtime directory.
🐳 Running with Docker
To run the Bookshop using Docker, follow these steps:
- Build the project from the root:
mvn clean install -DskipTests - Start the application using Docker Compose:
docker compose up --build - The application will be available at
http://localhost:8080/bookshop. - Login with the default credentials: admin / admin.
The Docker configuration uses the runtime directory for configuration and data. Any changes made to the runtime directory on your host will be reflected in the container.
Documentation
For more information, see the Strolch Tutorial.