Локатор: время отметки подменяется временем синхронизации
Мутация: createVisitMark (CreateVisitMarkInput.markedAt)
Запрос отображения: visitMarks → поле markedAt
Приложение: «Локатор» 1.6.0, раздел «Отметки» (мобильный сотрудник)
Статус фронта: одна из двух причин найдена и исправлена на фронте (см. §4).
Оставшийся вопрос — к бэкенду: уважает ли резолвер переданный markedAt.
1. Симптом
Отметка сделана сотрудником в 10:30, после синхронизации сохранилась и отображается со временем 12:47.
Разница ~2ч17м — не кратна часовому поясу. Это исключает ошибку таймзоны или форматирования и указывает на подстановку «времени какого-то более позднего события» (типично — момент приёма запроса сервером).
2. Что фронт гарантированно отправляет
Путь построения payload единственный, обходных нет:
| шаг | файл | что делает |
|---|---|---|
| фиксация времени | components/CheckInFormModal.vue:4396 | timestamp отметки на устройстве |
| сборка payload | utils/visit-mark-sync-payload.utils.ts:28 | markedAt: checkIn.timestamp |
| мутация | services/sync.service.ts:746 | markedAt в CreateVisitMarkInput |
Проверено дополнительно:
- Формат на проводе: результат
new Date().toISOString()— ISO 8601 extended, UTC, с миллисекундами и суффиксомZ, например"2026-08-12T10:30:45.123Z". Наивного времени без таймзоны фронт не отправляет никогда, поэтому tz-misparse на бэке не может дать некратный сдвиг 2ч17м. - Клиент переменные не фильтрует:
api/field-service/visit-mark.ts—transformVariables: (input) => ({ input }),services/graphqlService.tsпередаёт переменные вapolloClient.mutateвербатим. Allow-list полей и санитайзинга нет. - Офлайн-очередь время не переписывает: при ретраях меняются только
status,syncAttempts,lastSyncAttemptиqueueLock; полеtimestampне трогается ни при claim на синхронизацию, ни при восстановлении из карантина, ни при миграциях IndexedDB. - Фронт время не подменяет при отображении: после подтверждения сервера
локальная запись удаляется, список перечитывается запросом
visitMarks, и UI рендерит ровно тоmarkedAt, что вернул сервер. Fallback видаmarkedAt ?? createdAtв модуле отсутствует. - Форматирование не сдвигает время:
new Date(iso).toLocaleString("ru-RU", …)безtimeZoneи без ручной арифметики.
Тело запроса на проводе:
{
"operationName": "createVisitMark",
"variables": {
"input": { "markedAt": "2026-08-12T10:30:45.123Z", "...": "..." }
}
}
3. Вопрос к бэкенду
Схема прямо документирует fallback на серверное время
(CreateVisitMarkInput.markedAt):
Дата и время создания отметки на устройстве (ISO 8601). Если не указано, используется серверное время
Это единственный найденный в кодовой базе механизм, дающий ровно наблюдаемый симптом «время синхронизации вместо времени создания» для классического офлайн-сценария (отметка создана в 10:30 без сети, ушла на сервер в 12:47).
Просьба проверить на резолвере createVisitMark:
- Доходит ли
markedAtдо резолвера — не отсекается ли он валидацией входа или маппингом DTO. - Не перетирается ли
markedAtсервернымnow()при записи — например через@CreateDateColumn/default: now()на колонке, или через явное присвоение в сервисе. - Принимается ли строка
"2026-08-12T10:30:45.123Z"(ISO 8601 UTC с миллисекундами). Поле объявлено какStringна входе и какDateTimeна выходе — если парсинг строки падает молча, срабатывает задокументированный fallback на серверное время. - Возвращает ли
visitMarks.markedAtсохранённое клиентское время, а не время создания записи.
Отдельно стоит отметить: у VisitMark уже есть отдельные поля syncedAt и
syncStatus. То есть время синхронизации хранится самостоятельно, и markedAt
им подменяться не должен — иначе поле теряет смысл, а руководитель не может
отличить «сотрудник пришёл на точку в 10:30» от «телефон поймал сеть в 12:47».
Как воспроизвести
- Перевести устройство в офлайн (авиарежим).
- Создать отметку — зафиксировать время на устройстве (например 10:30).
- Через 1–2 часа включить сеть, дождаться автосинхронизации.
- Сверить
markedAtв БД и в ответеvisitMarksсо временем из п. 2.
Для сверки со стороны устройства в лог отправки добавлено значение markedAt
(services/sync.service.ts:732), строка вида:
[FieldWorkersSync] Отправка отметки визита → API: createVisitMark (mutation). userId=… markedAt=2026-08-12T10:30:45.123Z
Если в логе устройства markedAt=10:30, а в БД 12:47 — искажение на бэке.
4. Что уже исправлено на фронте
Найдена и закрыта вторая, независимая причина того же симптома, целиком фронтовая: возврат отметки из очереди в черновик («Изменить» / «Открыть и исправить») терял исходное время.
convertQueuedCheckInToDraft клал в снапшот черновика
timestamp: checkIn.timestamp, но это поле нигде не читалось, а первое же
автосохранение формы его стирало. При повторной отправке отметка получала
timestamp: new Date().toISOString() — то есть время переотправки.
Сценарий давал ровно 10:30 → 12:47: отметка сделана в 10:30, не ушла (офлайн или ошибка), сотрудник в 12:47 открыл её из очереди, поправил и отправил.
Исправление: utils/check-in-mark-timestamp.utils.ts +
восстановление и переиздание snapshot.timestamp в CheckInFormModal.vue.
Регрессионный тест —
tests/unit/modules/field-workers/field-worker/utils/check-in-mark-timestamp.utils.spec.ts.
Важно: этот фикс закрывает только сценарий с ручным редактированием отметки из очереди. Если время искажается и при обычной автоматической синхронизации без редактирования — причина на бэке, см. §3.