https://github.com/maciekiwaniuk/shop-system
💰 Simple shop system made in Symfony using hexagonal architecture as modular monolith
https://github.com/maciekiwaniuk/shop-system
bounded-contexts codesniffer continuous-integration cqrs cursor-rules deptrac docker event-sourcing hexagonal-architecture kubernetes lexikjwt modular-monolith mysql php8 phpstan phpunit rabbitmq redis symfony7 tests
Last synced: 3 months ago
JSON representation
💰 Simple shop system made in Symfony using hexagonal architecture as modular monolith
- Host: GitHub
- URL: https://github.com/maciekiwaniuk/shop-system
- Owner: maciekiwaniuk
- Created: 2023-08-26T21:07:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-14T12:07:38.000Z (6 months ago)
- Last Synced: 2025-12-15T11:22:34.004Z (6 months ago)
- Topics: bounded-contexts, codesniffer, continuous-integration, cqrs, cursor-rules, deptrac, docker, event-sourcing, hexagonal-architecture, kubernetes, lexikjwt, modular-monolith, mysql, php8, phpstan, phpunit, rabbitmq, redis, symfony7, tests
- Language: PHP
- Homepage:
- Size: 1.63 MB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Shop System
A **simple e-commerce system** built with modern, popular technologies, showcasing advanced software architecture patterns and best practices.
#### This project is kind of sandbox for me for experimenting and learning new techniques and technologies. It’s more meant to be an ongoing project rather than something finished once and for all. I also see it as a great way to showcase my work and coding skills. Not everything here is optimized for maximum efficiency and how I would approach to these problems in real commercial projects - some parts, such as the communication between the payment microservice and the monolith, are intentionally implemented using mixed - sync and async communication because I wanted to test pros and cons and that's for me best way of learning something in efficient way.
### Initial commit to this repo was made 27th August 2023
## Visual overview
### Emails
### Database structure
This diagram shows structure of database - separated databases per module/service, with data replication rather than a shared database.
### CI pipeline
For now CI is only configured for backend.
## General description
At the beginning, when I started this project to learn Symfony, I made it as a simple monolith. Later, I decided to learn about the modular monolith, and then the hexagonal architecture. That’s how this project has been evolving alongside my experience and curiosity about learning new approaches and technologies.
The main application is built in PHP with Symfony as a modular monolith, where one module is a simple authentication service and the other, commerce, is a bit more complex. The payments microservice is written in Go using the Gin framework. Both the monolith and the payments microservice are made using ports and adapters architecture and also CQRS.
Each module or microservice has it own context -> for example same entity representation in auth service will be named user - in clients module it is client - payments service it is payer, records are replicated through whole system. Each module or service has own separate database.
Replication of data is only done when it's necessary -> for example when someone tries to make purchase without account (unique id is associated to email) then records is only being created in payments and clients modules. Only when user decide to make account then record with given id and email is being created in user module.
Modules in monolith have also separated databases so you can say easily this is configuration is ready for separating monolith to microservices. With common database it would be much harder and in my opinion microservices with common databases are not as powerful as with separated.
### CQRS Implementation
- **Queries** handle read operations (search products, get order details)
- **Sync Commands** handle write operations that needs to be done instantly (create product, update order status)
- **Async Commands** for operations that can be delayed or might take some time to complete (email notifications)
## Development
### Installation
**Start the development environment**
```bash
cd development && ./build.sh
```
**Access the application**
- **Frontend**: http://localhost:3000
- **Backend API**: http://localhost/api/v1
- **API Documentation**: http://localhost/api/doc
- **RabbitMQ Management**: http://localhost:15672
- **MailHog**: http://localhost:8025
## API documentation
The API is available at http://localhost/api/doc
## Testing
### Code Quality
- **PHPStan** for static analysis
- **PHPCS** for coding standards
- **Deptrac** for architecture enforcement
- **PHPUnit** for testing
### Run tests
```bash
./bin/tests.sh
```
## Run kubernetes infrastructure locally using minikube
minikube start --driver=docker
minikube addons enable storage-provisioner