Зелёный индикатор соединения говорит лишь о том, что транспорт сейчас доступен. Он не доказывает, что конкретное сообщение записано сервером, дошло до телефона адресата или было открыто человеком. Ошибка интерфейса обычно начинается с одного булева `delivered`, в который попытались уместить все эти события.
Socket.IO гарантирует порядок сообщений, но по умолчанию описывает доставку как at-most-once: при разрыве во время отправки событие может не попасть на другую сторону, а сервер без дополнительной логики не хранит пропущенные события для отключённого клиента. Значит, гарантию надо строить в приложении поверх транспорта.
Назовите четыре состояния без двусмысленности
| Состояние | Кто подтверждает | Что уже известно |
|---|---|---|
| queued | устройство отправителя | сообщение сохранено локально |
| accepted | сервер после commit | есть message ID и запись |
| delivered | конкретное устройство адресата | локальный inbox принял запись |
| read | клиент после показа пользователю | сообщение было в видимой области |
| failed | клиент/сервер по политике | дальнейший retry требует решения |
Названия можно изменить, но их смысл фиксируется в API и аналитике. Если продукт показывает одну галочку, решите, какое именно состояние она означает, и не поднимайте её по событию подключения сокета.
Accepted появляется только после сохранения
client_message_id: 01J...
conversation_id: c-42
sender_id: u-7
body: ...
created_at_client: ...
server response: {message_id, sequence, state: 'accepted'}Клиентский ID остаётся тем же при retry. Сервер делает его уникальным в пределах отправителя или беседы, записывает сообщение и только после commit отправляет ack. Если ответ потерялся, повтор возвращает уже созданный `message_id`, а не публикует вторую копию.
Delivered привязывается к устройству
У пользователя могут быть телефон, браузер и офлайн-планшет. Событие `delivered` должно содержать device/session ID и sequence сообщения. Продуктовая агрегация — «хотя бы одно устройство» или «все активные устройства» — выбирается отдельно. Удалённое или давно неактивное устройство не должно навсегда блокировать общий статус.
- Сохранить сообщение в локальное хранилище до device ack.
- Не считать push-уведомление подтверждением чтения.
- Не доверять read-событию от пользователя без доступа к беседе.
- Хранить время сервера и sequence, а клиентское время использовать как подсказку.
- Агрегировать состояния по документированному правилу устройств.
Reconnect начинается с последнего offset
Клиент сохраняет последний непрерывно обработанный sequence/offset. После reconnect он отправляет его серверу; сервер читает из устойчивого event store все более новые события и только затем переключает сессию на live. Именно такой подход Socket.IO приводит как способ получить доставку server-to-client не хуже at-least-once.
connect({ auth: { offset: lastAppliedSequence } })
server: SELECT * FROM conversation_events
WHERE sequence > :offset ORDER BY sequence
client: apply idempotently, then advance contiguous offsetЕсли сначала подписаться на live, а потом читать историю без барьера, новое событие может прийти между двумя этапами и появиться дважды или потеряться. Сделайте replay и live одной согласованной процедурой, а применение на клиенте — идемпотентным по event ID.
Поздний ack не откатывает состояние
Подтверждения могут прийти повторно и не по ожидаемому времени: старый браузер проснулся после того, как телефон уже отправил read. Применяйте только монотонные переходы `accepted < delivered < read`; старое событие сохраняйте в диагностике, но не понижайте отображаемое состояние. Для отзыва или удаления заведите отдельное событие, а не обратный статус доставки.
Тестируйте разрывы в каждом промежутке
- Оборвать сеть до server commit: сообщение остаётся queued и повторяется с тем же ID.
- Оборвать после commit, но до ack: retry возвращает ту же серверную запись.
- Доставить событие устройству и потерять device ack: replay не создаёт дубль.
- Прочитать на телефоне при выключенном браузере: общий read не откатывается после его reconnect.
- Получить события 12 и 14 без 13: непрерывный offset не перескакивает через пробел.
- Открыть беседу двумя вкладками: аналитика не считает два прочтения одним пользователем.
Лог описывает путь одного message ID
Для диагностики достаточно message ID, conversation ID, server sequence, session/device ID, типа ack, времени сервера и correlation ID соединения. Текст сообщения и токен авторизации в технический лог не кладите. По этой цепочке видно, кто именно заявил неверное состояние.
Подготовьте для разбора один обезличенный timeline от queued до read, версии клиента и сервера, правила агрегации устройств и результат reconnect с offset. Скриншот одной галочки без событий не позволяет отличить UI-кеш от потери транспорта.