База знаний Антона Сидорова
База знаний по аналитике, ИТ архитектуре, API. Документирование. Тесты инструментов.
Project maintained by daemon110282
Hosted on GitHub Pages — Theme by mattgraham
Принцип неизменяемости (immutability)
Immutable (неизменяемые) данные — это объекты, состояние которых нельзя изменить после создания. Любое изменение порождает новую копию.
Зачем
- Упрощение понимания и отладки кода, так как объекты не изменяются после создания.
Примеры из предметной области
- банковская транзакция
- Transaction(id=1, amount=100, status=’completed’) нельзя превратить в amount=50. Вместо этого создается Transaction(id=2, amount=50, status=’corrected_v1’). Это гарантирует аудит.
- запись в бухгалтерской книге, где изменение суммы (например, с 10 на 100) невозможно, а создается новая запись об отмене или корректировке.
- Электронная коммерция (Заказы):
- Объект Order (заказ) после оформления не меняется. Если пользователь добавляет товар, система создает новый объект Order, а старый удаляет или помечает как неактивный.
- ЭДО после того как: пакет документов сформирован, отправлен клиенту и тем более подписан, он должен рассматриваться как immutable snapshot.
У тебя же:
состав пакета меняется постфактум (Документ 1 переезжает в Пакет 2),
при этом старый пакет уже «зафиксирован» в ЛК.
Это ломает базовый контракт: “то, что пользователь увидел и подписал, больше не меняется”
В ЭДО: документ + пакет = юридический артефакт
Если ЭДО их меняет:
подпись становится спорной,
доказуемость нарушается.
Поэтому: подписанные данные обязаны быть immutable.
Практические правила (прикладные)
- Нельзя менять то, что видел пользователь
- Нельзя менять то, что подписано
- Любое изменение = новая сущность
- Ссылки должны быть версионными
- История должна быть полной
Уровень доменной модели (DDD)
Сущности делятся на:
Mutable (редко)
черновики
временные объекты
неподписанный документ
Immutable (основные бизнес-артефакты)
подписанные документы
отправленные пакеты
транзакции
Ключевые паттерны реализации
- Versioning
- Append-only storage
- Events:
- DOCUMENT_CREATED
- DOCUMENT_SIGNED
- DOCUMENT_MOVED
- Snapshot (снимки состояния)
- Copy-on-write
- При изменении:
- создаётся копия
- вносятся изменения в копию
Что ломается без immutability
У тебя: Документ 1 «переехал» в другой пакет
Это означает: изменился исторический контекст, но пользователь уже взаимодействовал со старым состоянием.
ТОДО
https://habr.com/ru/articles/571668/
https://system-design.space/chapter/consistency-idempotency-patterns/