https://dckms.github.io/system-architecture/emacsway/it/sdlc/models/agile/analysis/concerns/balancing-business-technical-concerns.html https://github.com/backmeupplz/banofbot - https://twitter.com/ghohpe/status/1332200805852606470?s=20 - https://ru.wikipedia.org/wiki/%D0%AD%D1%84%D1%84%D0%B5%D0%BA%D1%82_%D0%94%D0%B0%D0%BD%D0%BD%D0%B8%D0%BD%D0%B3%D0%B0_%E2%80%94_%D0%9A%D1%80%D1%8E%D0%B3%D0%B5%D1%80%D0%B0 Aggregates from this Application/Bounded Context Aggregates from other Application/Bounded Context Aggregates from this Application/Bounded Context Aggregates from other Application/Bounded Context Выбор конкретного типа адаптера не является существенным архитектурным решением, т.к. это решение легко изменить. Основным критерием выбора является гарантия согласованности данных и performance. Контур тестирования In-Process Component (Acceptance) Tests Контур тестирования Contract (Integration) Tests Контур тестирования Out-Of-Process Component & e2e (Acceptance) Tests Точка расширения Граница процесса. IO-устройства. Несущественная сложность. Существенная Сложность (Essential Complexity). Логика, являющаяся причиной существования системы. Код, который чаще всего читают программисты. Команда сервиса-подписчика может добавить собственную политику, которая обогатит интеграционное событие всеми данными, необходимые для автономной обработки события. Подробнее: - https://event-driven.io/en/events_should_be_as_small_as_possible/ - https://verraes.net/2019/05/patterns-for-decoupling-distsys-segregated-event-layers/ - https://verraes.net/2019/05/patterns-for-decoupling-distsys-summary-event/ - https://verraes.net/2019/05/patterns-for-decoupling-distsys-fat-event/ Легко интегрируется с Workflow/Rule Engine https://docs.temporal.io/references/commands Request-Reply https://www.enterpriseintegrationpatterns.com/patterns/messaging/RequestReply.html Нельзя получить результат валидации команды сразу. Только Request-Reply или Dead Letter Channel Нельзя получить результат обработки команды сразу. Только подписка на доменные события. Пример от автора CQRS: - https://github.com/gregoryyoung/m-r/blob/master/SimpleCQRS/FakeBus.cs - https://github.com/gregoryyoung/m-r/blob/master/CQRSGui/Controllers/HomeController.cs#L38 - https://github.com/gregoryyoung/m-r/blob/master/CQRSGui/Program.cs#L38 Может масштабироваться независимо от Write Model. Оптимизировано под чтение. Денормализовано. DeadLetterChannel https://www.enterpriseintegrationpatterns.com/patterns/messaging/DeadLetterChannel.html CQRS Hexagonal Architecture - https://alistair.cockburn.us/hexagonal-architecture/ - https://jeffreypalermo.com/2008/07/the-onion-architecture-part-1/ - https://github.com/jeffreypalermo/onion-architecture-dotnet-6 - https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html - https://cqrs.files.wordpress.com/2010/11/cqrs_documents.pdf - https://github.com/gregoryyoung/m-r - http://udidahan.com/2009/12/09/clarified-cqrs/ - https://threedots.tech/post/ddd-cqrs-clean-architecture-combined/ - https://medium.com/@TonyBologni/implementing-domain-driven-design-and-hexagonal-architecture-with-go-2-efd432505554 - https://medium.com/@TonyBologni/implementing-domain-driven-design-and-hexagonal-architecture-with-go-3-f9dfd7ab0a78 - https://medium.com/@TonyBologni/hexagonal-architecture-structuring-a-project-and-the-influence-of-granularity-df4e0851ab5c - https://blog.ploeh.dk/2013/12/03/layers-onions-ports-adapters-its-all-the-same/ - https://www.youtube.com/watch?v=th4AgBcrEHA - https://www.youtube.com/watch?v=iALcE8BPs94 - https://www.youtube.com/watch?v=DAe0Bmcyt-4 Побочная Сложность (Accidental Complexity). Bounded Context In this Context Map, relations can be: - Conformist: 2 teams in an upstream/downstream relationship. Upstream has no motivation to provide specific or new features for the downstream team. Downstream team doesn't put effort in translation. - Customer/Supplier: 2 teams in an upstream/downstream relationship. Upstream can succeed interdependently of the downstream team. Downstream priorities factor into upstream planning. endorserId: Endorser.id endorserGrade: int endorserVersion: int specialistId: Specialist.id specialistGrade: int specialistVersion: int artifactId: Artifact.id createdAt: datetime id: { tenantId: Tenant.id artifact_id: int } status: []str{'proposed', 'accepted'} name: str description: str url: str competenceIds: []Competence.id authorIds: []Member.id ownerId: Member.Id createdAt: datetime id: { tenantId: int memberId: int } grade: int receivedEndorsements: []Endorsement assignments: []Assignment createdAt: datetime version: int specialistId: Specialist.id specialistVersion: int assignedGrade: int createdAt: datetime id: { tenantId: Tenant.id competenceId: int } name: string ownerId: Member.Id createdAt: datetime id: { tenantId: int memberId: int } grade: int availableEndorsementCount: int pendingEndorsementCount: int createdAt: datetime version: int Агрегат - корневая сущность, к которой можно получить доступ по уникальному идентификатору. Границы агрегата определяются инвариантами (бизнес-правилами), которые должны обеспечиваться в условиях строгой согласованности (единой транзакцией). Политика (Реакция, Policy) - реакция на доменное событие. Выполняет какое-то действие без вмешательства в логику, которая произвела доменное событие. Часто используется для обновления состояния зависимых Агрегатов. Цель - что нужно достичь. Шпаргалка по Event Storming: https://github.com/ddd-crew/eventstorming-glossary-cheat-sheet Представление Доменного События в шине сообщений. Внешний интерфейс Hexagonal Adapter для Hexagonal Port (Доменного События). Представление команды в шине сообщений. Внешний интерфейс Hexagonal Adapter для Hexagonal Port (Команды). Заинтересованное лицо (стейкхолдер) - источник бизнес-потребности. Оценка бизнес-проблемы, результат её анализа. Доменное Событие - факт изменения состояния Агрегата или модели (например, наступление времени по расписанию). Содержит инкремент изменения состояния модели. Является исходящим интерфейсом модели (Hexagonal Port). У события может быть несколько подписчиков. Событие в одной модели может запускать команду в другой модели или политики в собственной модели. Событие может иметь несколько адаптеров, предоставляющих к нему публичный интерфейс: - Pub/Sub bus message - WebHook Команда - императив, действие, которое можно осуществить над моделью с целью изменения состояния модели. Является входным интерфейсом модели (Hexagonal Port). У команды может быть только один исполнитель. Как правило, Команда осуществляет действие над одним Агрегатом. Команда может иметь несколько адаптеров, предоставляющих к ней публичный интерфейс: - REST-API, JSON-RPC, gRPC (для внешних систем и внутренних подсистем систем) - Pub/Sub bus message (для внутренних подсистем) - REST Endpoint для message bus - Front Door Queue (для внешних систем и внутренних подсистем систем) Бизнес-потребность, решаемая бизнес-проблема. Представление Агрегата. Модель Чтения. Данные, которые необходимы Актору приложения (пользователю или другому приложению) для того, чтобы они смогли сформировать необходимую команду приложению. Запрос (query) - интерфейс модели (hexagonal port), возвращающий информацию о модели и обладающий ссылочной прозрачностью, т.е. не производит конретного (наблюдаемого) побочного эффекта. Т.е. используется для получения данных ничего не изменяя. Актор - пользователь приложения или внешняя система, исполняющие конкретную роль по отношению к приложению. Требование. Ограничение.