Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maciekiwaniuk/shop-system
💰 Simple shop system made in Symfony using hexagonal architecture as modular monolith
https://github.com/maciekiwaniuk/shop-system
codesniffer cqrs data-fixtures ddd deptrac docker doctrine event-sourcing hexagonal-architecture lexikjwt openapi pagination php8 phpstan phpunit redis symfony6 tests uuid
Last synced: about 2 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 (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-01T18:36:12.000Z (3 months ago)
- Last Synced: 2024-10-17T13:51:58.460Z (2 months ago)
- Topics: codesniffer, cqrs, data-fixtures, ddd, deptrac, docker, doctrine, event-sourcing, hexagonal-architecture, lexikjwt, openapi, pagination, php8, phpstan, phpunit, redis, symfony6, tests, uuid
- Language: PHP
- Homepage:
- Size: 694 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Shop system - description below is not up to date, project is being rebuilt
> ### Project of the backend of shop
## General info
- App is structured using DDD approach, based on the Command Query Responsibility Segregation (CQRS) pattern.
- Several tools are utilized to facilitate the creation of robust code: phpstan (6 level), deptrac, codesniffer.
- The application is well-tested, with tests categorized into Application (E2E), Integration, and Unit tests.
- A caching system based on Redis has been implemented.
## Technical solutions
- Directories are organized into /Module, which contains subdirectories for all modules, and /Shared, which includes
components shared across all modules. Each module [Order, Product, User] comprises four directories:
- Application -> houses the implementation of application logic
- Domain -> contains things related strictly to business information - entities, enums and interfaces of repositories
- Infrastructure -> includes components related to the technical layer, such as the database and caching system
- UI -> contains console commands or controllers that serve as the connection between the user and the system
- Actions are classified into commands and queries. I have implemented a custom solution for storing information after
the completion of actions. Each command returns a CommandResult, while queries return a QueryResult, which contains
information about success, status codes, and retrieved data.
- Authentication is implemented using the JWT approach with the LexikJWTAuthenticationBundle.
- Event sourcing is used to store information about the current status of an order. The latest created order status
indicates its current status.
### Database
### API Docs
### Structure
### Module
## Commands using Make
Initialize for first time run
make initialize
Run development profile
make run
Drop migrations, migrate and load fixtures
make drop_migrations
make migrate
make load_fixtures
Run all tests
make test
## Commands without Make
Initialize for first time run
docker-compose up --profile dev -d
docker-compose exec php bin/console doctrine:migrations:diff
docker-compose exec php bin/console doctrine:migrations:migrate
docker-compose exec php bin/console lexik:jwt:generate-keypair
#### For other commands check content of Makefile
## API Documentation
The API documentation is available at
localhost:80/api/doc