Hexagonal Architecture

🎯 Ports and Adapters / Hexagonal Architecture

This repository follow the Ports and Adapters / Hexagonal Architecture pattern.

We organize the code with the follow structure:

src
├── Bounded Context
│ ├── Application
│ │ ├── Command
│ │ └── Query
│ ├── Domain
│ │ ├── Event // All Subscribers subscribed to events
│ │ └── Model
│ └── Infrastructure
│     ├── Ports And Adapters
│     └── UI
│         ├── Command // CLI commands
│         └── Controller

Example of Quotes API:

src
├── Api
│ ├── Application
│ │ ├── Command
│ │ │ ├── ImportAuthors
│ │ │ │ ├── ImportAuthorsCommand.php
│ │ │ │ └── ImportAuthorsCommandHandler.php
│ │ │ └── ImportQuotes
│ │ │     ├── ImportQuotesCommand.php
│ │ │     └── ImportQuotesCommandHandler.php
│ │ └── Query
│ │     └── GetShoutsByAuthor
│ │         ├── GetShoutsByAuthorQuery.php
│ │         ├── GetShoutsByAuthorQueryHandler.php
│ │         └── GetShoutsByAuthorQueryResponse.php
│ ├── Domain
│ │ ├── Event
│ │ │ ├── Author
│ │ │ │ └── CreateAuthorSubscriber.php
│ │ │ ├── Quote
│ │ │ │ └── CreateQuoteSubscriber.php
│ │ │ └── Shout
│ │ │     └── ShoutsByAuthorSubscriber.php
│ │ └── Model
│ │     ├── Author
│ │     │ ├── Author.php
│ │     │ ├── AuthorCreatedV1.php
│ │     │ ├── AuthorNotFound.php
│ │     │ ├── AuthorProjection.php
│ │     │ └── AuthorRepository.php
│ │     ├── Quote
│ │     │ ├── Quote.php
│ │     │ ├── QuoteCreatedV1.php
│ │     │ ├── QuoteProjection.php
│ │     │ └── QuoteRepository.php
│ │     └── Shout
│ │         ├── Shout.php
│ │         ├── ShoutCollection.php
│ │         └── ShoutsByAuthorRequestedV1.php
│ └── Infrastructure
│     ├── Framework
│     │ └── Symfony
│     │     └── Kernel.php
│     ├── Persistence
│     │ ├── Dbal
│     │ │ ├── Author
│     │ │ │ └── DbalAuthorProjection.php
│     │ │ └── Quote
│     │ │     └── DbalQuoteProjection.php
│     │ └── Doctrine
│     │     ├── Author
│     │     │ └── DoctrineAuhorRepository.php
│     │     ├── Quote
│     │     │ └── DoctrineQuoteRepository.php
│     │     └── mapping
│     │         ├── Author.Author.orm.xml
│     │         └── Quote.Quote.orm.xml
│     └── UI
│         ├── Command
│         │ ├── Author
│         │ │ └── ImportAuthorsCommand.php
│         │ └── Quote
│         │     └── ImportQuotesCommand.php
│         └── Controller
│             ├── GetQuotesByAuthor
│             │ └── GetQuotesByAuthorController.php
│             └── Ping
│                 └── PingController.php
└── Shared
    ├── Domain
    │ └── Model
    │     ├── Aggregate
    │     │ └── AggregateRoot.php
    │     ├── Api
    │     │ └── ApiError.php
    │     ├── Bus
    │     │ ├── CommandBus.php
    │     │ ├── EventBus.php
    │     │ └── QueryBus.php
    │     ├── Cache
    │     │ └── CacheRepository.php
    │     ├── Command.php
    │     ├── Event
    │     │ ├── DomainEvent.php
    │     │ ├── DomainEventPublisher.php
    │     │ ├── DomainEventSubscriber.php
    │     │ ├── EventFailed.php
    │     │ ├── EventFailedNotFoundException.php
    │     │ ├── EventFailedStore.php
    │     │ ├── EventNotPublished.php
    │     │ ├── EventNotPublishedNotFoundException.php
    │     │ ├── EventNotPublishedStore.php
    │     │ ├── EventStore.php
    │     │ ├── PublishableDomainEvent.php
    │     │ ├── StoredEvent.php
    │     │ └── StoredEventNotFoundException.php
    │     ├── Exception
    │     │ ├── BadRequestException.php
    │     │ ├── ConflictException.php
    │     │ ├── NotFoundException.php
    │     │ └── ProjectException.php
    │     ├── Query.php
    │     └── Serializer
    │         └── Serializer.php
    └── Infrastructure
        ├── Bus
        │ ├── Custom
        │ │ └── CustomEventBus.php
        │ └── League
        │     ├── CommandBus.php
        │     ├── CommandBusFactory.php
        │     ├── CommandBusProvider.php
        │     ├── DbalTransactionMiddleware.php
        │     ├── QueryBus.php
        │     ├── QueryBusFactory.php
        │     └── QueryBusProvider.php
        ├── MessageBroker
        │ ├── Dispatcher.php
        │ ├── RabbitMq
        │ │ ├── RabbitMqConfigurer.php
        │ │ ├── RabbitMqConnection.php
        │ │ ├── RabbitMqDomainEventsConsumer.php
        │ │ ├── RabbitMqExchangeNameFormatter.php
        │ │ ├── RabbitMqFactoryConfigurer.php
        │ │ ├── RabbitMqFactoryConnection.php
        │ │ └── RabbitMqPublisher.php
        │ └── SubscriberMapper.php
        ├── Persistence
        │ ├── Dbal
        │ │ └── Event
        │ │     ├── DbalEventFailedStore.php
        │ │     ├── DbalEventNotPublishedStore.php
        │ │     └── DbalEventStore.php
        │ ├── FakeCacheRepository.php
        │ └── Redis
        │     └── Cache
        │         └── RedisCacheRepository.php
        ├── Serializer
        │ └── PhpSerializer.php
        └── UI
            └── Command
                └── MessageBroker
                    ├── RabbitMqConfigureCommand.php
                    ├── RabbitMqConsumeDomainEventsCommand.php
                    └── RabbitMqUpDomainEventsConsumers.php