# Локатор: время отметки подменяется временем синхронизации
 
**Мутация:** `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` и без ручной арифметики.
 
Тело запроса на проводе:
 
```json
{
"operationName": "createVisitMark",
"variables": {
"input": { "markedAt": "2026-08-12T10:30:45.123Z", "...": "..." }
}
}
```
 
## 3. Вопрос к бэкенду
 
Схема прямо документирует fallback на серверное время
(`CreateVisitMarkInput.markedAt`):
 
> Дата и время создания отметки на устройстве (ISO 8601).
> Если не указано, используется серверное время
 
Это **единственный найденный в кодовой базе механизм**, дающий ровно наблюдаемый
симптом «время синхронизации вместо времени создания» для классического
офлайн-сценария (отметка создана в 10:30 без сети, ушла на сервер в 12:47).
 
Просьба проверить на резолвере `createVisitMark`:
 
1. **Доходит ли `markedAt` до резолвера** — не отсекается ли он валидацией
входа или маппингом DTO.
2. **Не перетирается ли `markedAt` серверным `now()`** при записи — например
через `@CreateDateColumn`/`default: now()` на колонке, или через явное
присвоение в сервисе.
3. **Принимается ли строка `"2026-08-12T10:30:45.123Z"`** (ISO 8601 UTC с
миллисекундами). Поле объявлено как `String` на входе и как `DateTime` на
выходе — если парсинг строки падает молча, срабатывает задокументированный
fallback на серверное время.
4. **Возвращает ли `visitMarks.markedAt` сохранённое клиентское время**, а не
время создания записи.
 
Отдельно стоит отметить: у `VisitMark` уже есть **отдельные поля `syncedAt` и
`syncStatus`**. То есть время синхронизации хранится самостоятельно, и `markedAt`
им подменяться не должен — иначе поле теряет смысл, а руководитель не может
отличить «сотрудник пришёл на точку в 10:30» от «телефон поймал сеть в 12:47».
 
### Как воспроизвести
 
1. Перевести устройство в офлайн (авиарежим).
2. Создать отметку — зафиксировать время на устройстве (например 10:30).
3. Через 1–2 часа включить сеть, дождаться автосинхронизации.
4. Сверить `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.

Локатор: время отметки подменяется временем синхронизации

Мутация: createVisitMark (CreateVisitMarkInput.markedAt) Запрос отображения: visitMarks → поле markedAt Приложение: «Локатор» 1.6.0, раздел «Отметки» (мобильный сотрудник) Статус фронта: одна из двух причин найдена и исправлена на фронте (см. §4). Оставшийся вопрос — к бэкенду: уважает ли резолвер переданный markedAt.


1. Симптом

Отметка сделана сотрудником в 10:30, после синхронизации сохранилась и отображается со временем 12:47.

Разница ~2ч17м — не кратна часовому поясу. Это исключает ошибку таймзоны или форматирования и указывает на подстановку «времени какого-то более позднего события» (типично — момент приёма запроса сервером).

2. Что фронт гарантированно отправляет

Путь построения payload единственный, обходных нет:

шагфайлчто делает
фиксация времениcomponents/CheckInFormModal.vue:4396timestamp отметки на устройстве
сборка payloadutils/visit-mark-sync-payload.utils.ts:28markedAt: checkIn.timestamp
мутацияservices/sync.service.ts:746markedAt в 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:

  1. Доходит ли markedAt до резолвера — не отсекается ли он валидацией входа или маппингом DTO.
  2. Не перетирается ли markedAt серверным now() при записи — например через @CreateDateColumn/default: now() на колонке, или через явное присвоение в сервисе.
  3. Принимается ли строка "2026-08-12T10:30:45.123Z" (ISO 8601 UTC с миллисекундами). Поле объявлено как String на входе и как DateTime на выходе — если парсинг строки падает молча, срабатывает задокументированный fallback на серверное время.
  4. Возвращает ли visitMarks.markedAt сохранённое клиентское время, а не время создания записи.

Отдельно стоит отметить: у VisitMark уже есть отдельные поля syncedAt и syncStatus. То есть время синхронизации хранится самостоятельно, и markedAt им подменяться не должен — иначе поле теряет смысл, а руководитель не может отличить «сотрудник пришёл на точку в 10:30» от «телефон поймал сеть в 12:47».

Как воспроизвести

  1. Перевести устройство в офлайн (авиарежим).
  2. Создать отметку — зафиксировать время на устройстве (например 10:30).
  3. Через 1–2 часа включить сеть, дождаться автосинхронизации.
  4. Сверить 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.