Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/k0t9i/taskmanager-php-ddd
Clean Architecture, DDD and CQRS using Symfony 6
https://github.com/k0t9i/taskmanager-php-ddd
clean-architecture cqrs cqrs-pattern ddd ddd-architecture ddd-example docker doctrine doctrine-orm doctrine2 microservices php php8 php82 rabbitmq symfony symfony6 symfony62
Last synced: about 1 month ago
JSON representation
Clean Architecture, DDD and CQRS using Symfony 6
- Host: GitHub
- URL: https://github.com/k0t9i/taskmanager-php-ddd
- Owner: k0t9i
- License: gpl-3.0
- Created: 2023-06-06T21:04:34.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-09-19T11:41:54.000Z (about 1 year ago)
- Last Synced: 2024-09-29T20:04:25.746Z (about 2 months ago)
- Topics: clean-architecture, cqrs, cqrs-pattern, ddd, ddd-architecture, ddd-example, docker, doctrine, doctrine-orm, doctrine2, microservices, php, php8, php82, rabbitmq, symfony, symfony6, symfony62
- Language: PHP
- Homepage:
- Size: 776 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Task manager system using Clean Architecture, DDD and CQRS. [](https://github.com/k0t9i/TaskManager-php-ddd/actions/workflows/ci.yml)
## Environment setup
1) Install Docker
2) Clone the project: `git clone https://github.com/k0t9i/TaskManager-php-ddd.git`
3) Run docker containers: `docker-compose -f ./backend/symfony/docker-compose.yml up -d --build`
4) Setup application: `make setup`. This step installs the composer dependency, generates JWT keys, runs migrations, warms up the cache and reloads the supervisor.
## Performing checks
- `make test` - phpunit tests
- `make code-style` - php-cs-fixer checks
- `make static-analysis` - psalm checks
- `make check-all` - all of the above
## Api
Swagger api is available on http://127.0.0.1:8081/api/doc
## Database
All data is stored on one server in one database, you can see the database structure via adminer http://127.0.0.1:9080/.
## Frontend example
Simple vue3 application is available on http://127.0.0.1:7080/
## Code structure
```scala
├── Projects // Code related to a specific bounded context
│ ├── Application // Application layer depends only on Domain layer
│ │ ├── Command
│ │ ├── Handler // Command handlers
│ │ ├── Service // Application services
│ │ └── Subscriber // Domain event subscribers
│ ├── Domain // Domain logic layer does not depend on other layers
│ │ ├── Collection
│ │ ├── Entity // Entities and aggregate roots
│ │ ├── Event // Domain events
│ │ ├── Exception // Domain exceptions
│ │ ├── Repository // Repository interfaces
│ │ └── ValueObject
│ └── Infrastructure // Infrastructure layer depends on Domain and Application layers
│ ├── Persistence // Entity mapping in database
│ ├── Repository // Repository realizations
│ └── Service
└── Shared // Common code for all bounded contexts
```
## Buses
Command and query buses are synchronous, implemented via the symfony messenger.
The application has two event buses: the domain event bus and the integration event bus.
The domain event bus is synchronous, implemented via the symfony messenger and used inside bounded contexts.
The integration event bus is asynchronous, implemented via the symfony messenger and RabbitMQ (http://127.0.0.1:15673/). Events are received from RabbitMQ through the Symfony Messenger, which is launched using the supervisor.
## Projections
Projections are collected from domain events using the console command, which is launched using the supervisor.
You can always reload projections from scratch with `make projections-reload`