Core.RW 1.1.1

Core.RW — Domain Primitives & Consistency Model

Overview / Обзор

Core.RW предоставляет базовые строительные блоки для реализации систем, основанных на предметно-ориентированном проектировании (DDD), с явными границами согласованности и отслеживанием изменений состояния через доменные события.

This library is not a utility collection. Эта библиотека не является набором утилит.

It defines a domain execution model, including: Она определяет модель выполнения домена, включающую:

• Identity-based domain entities / Сущности с идентичностью
• Value-based objects / Объекты-значения
• Aggregate consistency boundaries / Границы согласованности агрегатов
• Domain event collection model / Модель сбора доменных событий

Architectural Intent / Архитектурное назначение

Core.RW предназначена для систем, которым необходимы:

• Strict domain encapsulation / Строгая инкапсуляция домена
• Explicit mutation boundaries / Явные границы изменений состояния
• Event-driven state propagation / Событийное распространение изменений
• Compatibility with event sourcing patterns / Совместимость с event sourcing
• Clear separation between domain and application concerns / Чёткое разделение домена и приложения

Domain Model Structure / Структура доменной модели

Core.RW построена вокруг четырёх основных концепций:

• Entities / Сущности
• Value Objects / Объекты-значения
• Aggregates / Агрегаты
• Domain Events / Доменные события

Entities / Сущности

Entity Представляет объект со стабильной идентичностью и жизненным циклом.

Сущности определяются своей идентичностью, а не набором свойств.

Key properties / Основные свойства:

• Identity is immutable / Идентичность неизменна
• Equality is based on identity / Сравнение основано на идентичности
• State may change over time / Состояние может изменяться

Responsibility / Ответственность:

Entity представляют доменные объекты, которые изменяются в рамках бизнес-правил.

Value Objects / Объекты-значения

ValueObject Представляет неизменяемый объект, полностью определяемый своими значениями.

Key properties / Основные свойства:

• No identity / Отсутствует идентичность
• Immutable by convention / Неизменяемость по соглашению
• Equality based on structure / Сравнение по структуре

Responsibility / Ответственность:

ValueObject Инкапсулирует доменные концепции, полностью определяемые значениями.

Examples / Примеры:

• Money / Деньги
• Address / Адрес
• Date range / Диапазон дат
• Measurement / Измерение

Aggregates / Агрегаты

AggregateRoot Представляет границу согласованности внутри доменной модели. Агрегат гарантирует, что все внутренние изменения состояния корректны и согласованы.

Responsibility / Ответственность:

• Enforce domain invariants / Обеспечение инвариантов
• Control state mutations / Контроль изменений состояния
• Maintain internal consistency / Поддержание согласованности
• Collect domain events / Сбор доменных событий

Domain Events / Доменные события:

Агрегаты не публикуют события напрямую. Они только накапливают их во время выполнения. События извлекаются внешним слоем приложения.

Lifecycle flow / Жизненный цикл:

1. Command is applied to AggregateRoot / Команда применяется к агрегату
2. State is mutated internally / Изменяется внутреннее состояние
3. Domain events are recorded / Записываются доменные события
4. Events are retrieved externally / События извлекаются приложением

Domain Events / Доменные события

DomainEvent Представляет факт того, что в домене произошло значимое событие.

Key properties / Основные свойства:

• Immutable / неизменяемые
• Append-only / только добавление
• Generated by aggregates / создаются агрегатами
• Consumed outside domain boundary / обрабатываются вне домена

Key concept / Ключевая идея:

Доменные события описывают что произошло, а не что нужно сделать.

Lifecycle flow / Жизненный цикл:

1. Created inside AggregateRoot / Создаются в агрегате
2. Stored internally / Хранятся внутри агрегата
3. Retrieved by application layer / Извлекаются приложением
4. Dispatched externally / Отправляются во внешние системы

Design Principles / Принципы проектирования

1. Explicit Consistency Boundaries / Явные границы согласованности

Агрегаты задают строгие границы изменения состояния.

2. Identity vs Value Separation / Разделение идентичности и значений

• Entities = identity-based / сущности основаны на идентичности
• Value Objects = structure-based / объекты-значения основаны на структуре

3. Event Capture at Mutation Point / Фиксация событий в точке изменения

Доменные события фиксируются в момент изменения состояния

. Domain Isolation / Изоляция домена

Core.RW не зависит от внешних слоёв.