Sequence-диаграмма - это вроде бы простая штука: показываешь, кто с кем общается и в каком порядке. Ты хочешь изобразить “как работает процесс” и тут появляются вопросики: «А где тут refresh токена?» «А кто валидирует запрос?» «А если ошибка, кто показывает сообщение?» И вот ты стоишь перед выбором: 🟡 Придумать “логичное” поведение и нарисовать 🟢 Или честно пометить “не знаю”, “уточняется”, “под вопросом”

🙈 Часто вижу (и сама делала):

User → UI → Service1 → Service2 → DB А потом в комментах: "А кто проверяет токен?" "Почему тут нет очереди?" "UI точно делает это напрямую?" "Kafka где?" "Мы так не делаем вообще-то…"

✅ Как делать правильно: Если ты не уверен в шаге - пометь это. Прямо в диаграмме. Sequence не требует от тебя абсолютной истины. Он требует понятности. А понятность - это когда ты говоришь: “тут не знаю, давайте проясним”.

📌 Форматы пометок: • Пунктирная стрелка = неопределённый вызов • Серая нотация / comment box = зона неясности • Текст в стиле: “// уточнить у backend”, “// предположение” • Вариант: нарисовать alt-блок с вариантами

🧠 Почему это важно: 1. Это экономит время команды 2. Это показывает зону риска 3. Это формирует доверие: “схема не врет, просто еще не всё знаем”