Trébol Backend

This application powers a complete implemented backend for the eCommerce project Trébol.

Features:

A REST API designed accordingly to the OpenAPI 3 standard.
Compatibility with any JDBC driver supported by Spring Data JDBC. Default bundle comes with H2 and MariaDB dependencies.
Supports managing information about billing/shipping addresses, customers, products, images, categories, sales, salespeople, shippers, users, user roles.
Stateless session authentication/autorization, pairing JWT with a entity-relationship model of users, roles, and permissions.
Passwords are encoded using BCrypt.
Supports registering new user accounts and requesting checkout-only temporary guest sessions.
Currently only allows payment using Webpay Plus by Transbank (chilean service that accepts credit and debit cards).
And all other Spring Boot/Data JPA/Security goodness!

Status / Roadmap

See this project.

Currently working towards support for the next minor API version (v1.1).

Requirements

JDK 11+
Apache Maven 3.6.0

Getting started

Some classes are generated by a maven plugin. Running mvn compile should supply them.

When that is done, you can quickly run the application with mvn spring-boot:run. To install into a webserver, do mvn package to generate the WAR file.

Configuration & Execution

Base settings are set in the default configuration profile, which is located at /src/main/resources/application.properties. You can "just" run the application out-of-the-box with these, though you'll probably want to change the database driver and URL, between other things. The aforementioned file also has instructions to set things up and running, so go ahead and read it if you're curious.