Работа без сети

В новостройке связи обычно нет, и приложение её не ждёт: справочник, черновик акта и фотографии лежат в памяти телефона, осмотр идёт целиком офлайн. Условие одно — перед первым выездом нужен один вход онлайн и одна загрузка справочника. Дальше эксперт хоть неделю ходит по паркингам и подвалам, а готовые акты уйдут на сервер сами, когда связь появится.

Что лежит в телефоне

Локальная база хранит всё, что нужно для осмотра, и не спрашивает сервер ни о чём.

• Справочник целиком — все помещения, группы конструкций, формулировки и нормативные основания.
• Черновики актов — и тот, который эксперт заполняет прямо сейчас, и те, что ещё не уехали.
• Фотографии — сами файлы лежат на диске телефона, а в базе к ним хранится привязка: какой снимок к какому дефекту.

Справочник скачивается один раз после входа и потом обновляется при каждом запуске приложения. Если обновиться не удалось — сети нет, сервер не ответил — остаётся прежняя копия. Пустым справочник не становится никогда.

Что офлайн не работает

С чистой установки без сети начать нельзя. Первый вход в приложение идёт через сервер, и справочник надо один раз получить — это те самые пять минут на вайфае накануне выезда. Всё остальное после этого офлайн.

Клиенты локально не хранятся: карточку заказчика приложение берёт с сервера. На осмотр это не влияет — данные заказчика вводятся в начале акта и уезжают вместе с ним.

Когда акт уходит на сервер

Отдельной кнопки «синхронизировать всё» искать не нужно. Приложение само смотрит, какие акты завершены и ещё не отправлены, и берётся за них на четырёх событиях:

• эксперт завершил акт;
• приложение запустилось;
• появилась сеть;
• нажата кнопка отправки вручную.

За сетью приложение следит средствами самого телефона, а отправка идёт в фоне: после сбоя приложение ждёт минуту, потом две, потом четыре. Телефон можно убрать в карман и ехать на следующий объект.

Почему не бывает дублей

Связь в лифте пропадает на середине загрузки — обычное дело. У каждого акта есть свой ключ, выданный ещё в телефоне, и на сервере этот ключ уникален в пределах организации. Повторная попытка попадает в тот же акт, а не создаёт второй.

Приложение различает обрыв связи и настоящую ошибку. На каждый этап отправки отведено три попытки, но пропавшая сеть попытку не тратит — иначе акт бы «сгорал» в доме, где лифт глушит интернет. Ручная кнопка отправки лимит обходит: если что-то заклинило, эксперт всегда может ткнуть ещё раз.

Фотографии с телефона удаляются только после того, как сервер подтвердил приём. До этого момента снимки лежат на диске, даже если приложение перезапускали.

Чего в приложении нет

Плашки «вы офлайн» на экране не будет. Осмотр в режиме без сети выглядит ровно так же, как с сетью, и отличить их по интерфейсу нельзя. Понять, что акт ещё не уехал, можно по его статусу в списке.

Рядом

Что происходит с актом дальше — на странице акта и PDF. Как эксперт получает доступ к приложению и как устроены роли — в команде и доступах. Остальные части сервиса — в разделе возможностей.