Demo is now available at https://keyist-frontend.web.app/ 🔑
This project is a simple e-commerce website powered by Angular 10 on the frontend and Spring Boot for the backend.
For the full stack list please visit "Built With" section below.
Ecommerce is a complex business. It involves many edge cases and a solid system architecture. This project is simply a demo demonstrating basic features which is only the tip of an iceberg. This project might ( and certainly does ) have bugs, vulnerabilities or some other types of issues. So, contributions are always welcome :)
The demo is under free hosting, so it may require a bit of a patience :)
This project is upgraded to Java 11, Spring Boot 2.3.3 and Angular 10+ and some new features added!
A docker-compose.yml added for you to bootstrap all of the aplication instances in one command!
- You can browse items or select an item from the showcase and preview.
- Browse section remembers your list choice, so even if you leave the page, when you come back you do not need to fetch products again.
- Your cart is saved on the database so you can login from different sources and still be able to use your cart.
- You can use discount coupons!
- You can store your information for faster purchase.
- You can view your orders and change your account settings.
- You can request a password forgot request and use the token in your mail.
- You can search items.
This is a fully functional demo site and may have security vulnerabilities as user data is not encrypted with SSL.
The provided codes are not ready for production and should only be used for education purposes.
What things you need to install
Angular CLI is recommended.
You need Tomcat server 8 or above installed or you can use embedded spring boot tomcat jar.
Locally installed MySQL or a MySQL server.
Compatible IDE, Intellij IDEA recommended for this project.
If you want to run the Dockerized version keep in mind that you must install Docker. Also please note that booting up with docker-compose might take approx. 10-30min depending on your internet connection. After the initial setup, all other subsequent docker-compose commands will run much faster due to caching.
The codes are split into 3 sections.
frontend - Angular 10 ,
resource_server - Spring Boot Backend ,
authorization_server - A Spring Boot OAuth2 Authorization server.
To run the application fill the lines in resource server and authorization server application.properties as well as frontend application service urls.
For MySQL Database
SQL script can be found in the sql folder.
script.sql contains both the basic user info and the tables for the oauth2 implementation.
For Tomcat Application Server
Use Tomcat 8.5.23 or above and compile to generate WAR file.
If you want you can use Spring Boot embedded tomcat JAR file and host it.
Keep in mind that both authorization and backend server's pom.xml is configured to compile a jar file.
For Undertow Application Server
This project uses undertow as default.
Keep in mind that both authorization and backend server's pom.xml is configured to compile a jar file.
This project uses Java Mail to create an embedded SMTP server.
You can configure your own settings in the yaml file depending on your email provider or you can disable Java Mail altogether.
For Docker
In the root folder run the following command
docker-compose up
If you want to use development versions of the Dockerfiles, you need to setup docker-compose-yml to build using Dockerfile.dev.
- Java - Oracle Java 11 JDK
- Angular - Angular 10 Frontend
- Rxjs - Reactive functions
- Ngrx Store - State management
- Bootstrap - UI Components
- NgBootstrap - Angular specific widgets
- FontAwesome - Icons
- Spring - Spring Boot resource and authorization server
- Hibernate - Object-relational Mapping
- OAuth2 - OAuth2 Authorization
- Jackson - JSON Object Mapping and data binding
- Lombok - Automatic generated methods
- MySQL - MySQL Database
- Connector/J - Connecting to MySQL Database Server
- Maven - Dependency Management
- Docker - Containerized Apps
- Docker Compose - Running multi-container Docker applications
- CORS filter allows requests from every url.
- You might be interested is not functional at this version.
- Sometimes when you refresh the page loading cart stucks.
- No admin panel at all as of yet.
- Shipping status only supports packaging and shipped ( 0-1 )
- No cargo firm selecting when purchasing.
- Mobile devices are not supported, yet. Contributons are welcome!
If you want to contribute to this project you can email me - [email protected] or you can pull request.
This project does not have versioning and made with learning purposes.
- Ant Kaynak - Initial work - Github
This project is licensed under the MIT License - see the LICENSE.md for details.
If you have any questions mail me - [email protected]