PoseidonCapitalSolutions

PoseidonCapitalSolutions aggregator makes storing assets safe and secure.

Table of contents

• PoseidonCapitalSolutions
  • Table of contents
  • Tech stack
    • Database
    • Backend
    • Frontend
  • Running the application
    • Maven
    • Container
  • Testing
    • Coverage
    • Test execution
    • Mutation

Tech stack

Database

• MariaDb: SQL database.
• SQLx: Simple SQL migration.

Backend

• Maven: Integrated build tool with mvnw.
• Java >=21.
• Spring boot: Configure a Spring project.

Frontend

• Thymeleaf: Java templating engine.
• Bootstrap: CSS framework.

Running the application

There are 2 different way to run this application:

Maven

Run the tests using:

./mvnw test

Run the mutation tests using:

./mvnw test-compile org.pitest:pitest-maven:mutationCoverage

Run the formater using:

./mvnw spotless:apply

Build the application as an uber JAR (a JAR containing all of its dependencies) using:

./mvnw spring-boot:repackage
java -jar build/**.jar # Run

Run the application using:

cp .env.CHANGEME .env
# Edit the `DATABASE_**` variables to match your PostgreSQL instance
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Install Rust, used to install the migration tool
cargo install sqlx-cli
sqlx database setup
./mvnw spring-boot:run

Container

You can run the application using an OCI compliant container engine (like Docker or Podman) that supports the compose specification.

# Using Docker
docker-compose up -d
# Using Podman
podman-compose up -d

Testing

This application was tested on a Linux machine (Ubuntu 24.10 x86_64).

Coverage

Mutation