php-coder / mystamps

The site about post stamps where you can create a virtual collection

My Stamps

What is it?

This is a website for anybody who collects post stamps and wants to have an online version of the collection.

How can it be useful to me?

On the site you can:

• see the statistics (including charts) about your collection: how many series and stamps do you have? From what countries and from what categories?
• share a link to the collection with friends
• use it as a list of the stamps that you are selling on an auction
• add to the signature on the forums or e-mail
• use it where a photo of your collection is needed

How can I try it?

You can look at it and try on https://my-stamps.ru

If you are programmer/sysadmin or you just feeling that you are able to run a local version of the site then follow the following instructions: If you want to run it locally, follow the instructions:

• install JDK (at least 8th version is required)
• clone this project
• from the console inside the directory with source code, execute the command ./mvnw spring-boot:run
• open up http://127.0.0.1:8080 in a browser
• browse the site or log in as one of the pre-created users: admin, paid, or coder with password test
• press Ctrl-C to stop the server

Caution! The purpose of that version is a preview of the site and its capabilities. Because of that, the changes that you can make on the site will be lost after stopping the server!

What is inside?

• At the heart of: Spring Framework (and especially Spring Boot)
• Template engine: Thymeleaf
• UI: HTML, Bootstrap and JavaScript (React, JQuery)
• Security: Spring Security
• Databases: H2, MySQL or PostgreSQL
• Database access: Spring's JdbcTemplate
• Database migrations: Liquibase
• Validation: Hibernate Validator
• Logging: Slf4j (Logback)
• Unit tests: Groovy with Spock Framework or JUnit (for Java code), Jest (for JavaScript code)
• Integration tests: Selenium3, RobotFramework, WireMock
• Deployment: bash, Ansible, Terraform
• Others: Lombok, Togglz, WebJars, AssertJ