От системных событий к внутреннему взаимодействию
Система как чёрный ящик
Заголовок раздела «Система как чёрный ящик»Системная диаграмма последовательности (SSD, System Sequence Diagram) — приём анализа: внутреннее устройство системы скрыто. Системные события называют намерения актора, а ответы — наблюдаемые результаты. Не добавляйте сюда контроллеры, SQL, репозитории и обработчики уведомлений.
Студент уже прошёл внешний вход и выбрал интервал. Для варианта из справочника успешная запись сразу подтверждается; ошибка доставки уведомления не отменяет результат бронирования.
Внешний контракт не утверждает, каким образом обеспечивается единственность активной записи. Однако отказ обязан быть наблюдаемым, а успешный ответ означает, что запись уже сохранена. Идентификатор студента может поступать из контекста подтверждённой личности; актор не получает права подставить чужого владельца.
Контракт системной операции
Заголовок раздела «Контракт системной операции»| Часть | создатьЗапись(интервалId) |
|---|---|
| Предусловия | личность студента подтверждена; интервал существует и открыт преподавателем |
| Успех | новая запись относится к этому студенту и интервалу; статус Подтверждена; задание уведомления сохранено |
| Конфликт | новой записи и нового задания уведомления нет; существующая история не изменена |
| Инвариант | на интервале не более одной активной записи (Создана или Подтверждена) |
| Внешний эффект | доставка выполняется позднее и не является условием успешного бронирования |
Доступность интервала не задана предусловием: она может измениться после выбора пользователем. Поэтому конфликт входит в результат операции, а атомарное обеспечение правила относится к реализации.
Раскрыть одну операцию
Заголовок раздела «Раскрыть одну операцию»Выбор ответственности выполняют на основании технической модели и ADR. В варианте справочника контроллер передаёт команду сервису приложения; резервирование, запись и outbox фиксируются одной транзакцией.
| Внешнее утверждение | Внутреннее выполнение |
|---|---|
| поступил запрос создания | BookingController.create вызывает BookingService.create |
| интервал удалось занять | SchedulePort.reserve атомарно проверяет доступность |
| результат сохранён | BookingRepository.saveConfirmed и NotificationPort.enqueue выполняются до фиксации общей транзакции |
| получен успешный ответ | BookingResult возвращается после фиксации |
| получен конфликт | при неуспешном резервировании нет вызовов сохранения новой записи и постановки уведомления |
Полная внутренняя диаграмма приведена в успешной последовательности. Отсутствие ветви конфликта на успешной трассе не отменяет её в контракте системы.
В базовой демонстрации лекций новая запись остаётся в Создана, а уведомление запрашивается после сохранения через NotificationChannel. Это другой согласованный вариант решения. При переносе между вариантами нужно явно изменить постусловие, технические операции и автомат, а не смешивать saveIfNoActive с saveConfirmed в одной трассе без объяснения.
Проверка перехода между масштабами
Заголовок раздела «Проверка перехода между масштабами»- Все внешние запросы и ответы внутренней модели сопоставляются с SSD.
- Новая внутренняя ответственность обоснована требованием, правилом или ADR.
- Успешный ответ не отправляется до обещанного сохранения.
- Изменение внутреннего поставщика не меняет внешний контракт без отдельного решения.
- Вызовы не требуют от актора знать репозитории и внутренние идентификаторы реализации.
SSD полезна при обсуждении требований; внутренняя последовательность — при распределении ответственности. Практика — в задачах по взаимодействиям.