Мобильное приложение — Решение проблем¶

1. Подключение и авторизация¶

1.1 МП не подключается к серверу¶

Симптом: при добавлении учётной записи — ошибка подключения или бесконечная загрузка.

Что проверить: - URL сервера в настройках МП (должен быть полный: https://crm.company.ru) - Доступен ли сервер из сети телефона (Wi-Fi vs мобильная сеть) - SSL-сертификат — валидный, не самоподписанный (МП не принимает self-signed без доп. настройки) - Порт 443 открыт на файрволе для мобильной сети

Решение: если внутренний сервер — проверить, что МП подключается через тот же домен, что и веб. VPN может потребоваться.

Эскалация: если сертификат корректный и порт открыт — к DevOps (проверка reverse proxy, IIS bindings).

1.2 Выбрасывает из МП / ошибка refresh token¶

Симптом: пользователя периодически выкидывает на экран логина; ошибка «refresh token».

Что проверить: - Версия МП — обновлена ли до последней - Не менялся ли пароль пользователя в веб-версии - [2L] Журнал ошибок: поиск по refresh_token / unauthorized

Решение: удалить учётную запись из МП → добавить заново. Если повторяется — очистить кэш (Настройки → Очистить кэш данных).

1.3 Вход по SMS — выбрасывает¶

Симптом: при входе по SMS-коду МП выкидывает обратно на экран авторизации.

Что проверить: - Корректность номера телефона в профиле пользователя - Срок действия SMS-кода (не истёк ли) - Версия МП

Решение: обновить МП. Если воспроизводится — зафиксировать версию МП и ОС, эскалировать.

1.4 Превышение попыток входа¶

Симптом: блокировка после нескольких неудачных попыток.

Что проверить: - Настройка блокировки в AdminSPA (Общие настройки → Безопасность → Количество попыток входа) - [2L] Таблица SecurityLog — записи блокировки

Решение: разблокировать пользователя в AdminSPA. В МП — некорректно обрабатывается событие: пользователь не получает понятного сообщения.

1.5 Пароль безопасности / сканер отпечатков¶

Симптом: вопросы о принудительной установке PIN/биометрии при входе в МП.

Что проверить: - Настройка в AdminSPA: Общие настройки → Мобильное приложение → Обязательность пароля безопасности

Решение: пароль безопасности — это PIN / Face ID / Touch ID для разблокировки самого МП (не пароль учётной записи). Включается/выключается администратором.

Документация: install-password.md

2. Отображение ДП и полей¶

2.1 Поля не отображаются на Android (но видны на iOS / веб)¶

Симптом: часть ДП категории не отображается в МП на Android, хотя в веб и на iOS — всё ок.

Что проверить: - Тип ДП — не все типы поддерживаются в МП на обеих платформах одинаково - Версия МП Android — обновлена ли - [2L] Мобильный шаблон категории — настроен ли (AdminSPA → Мобильные шаблоны)

Решение: если мобильный шаблон не настроен — МП использует дефолтное отображение, которое может пропускать некоторые ДП. Настроить мобильный шаблон в AdminSPA.

Документация: mobile-templates

2.2 Различие отображения НТФ / полей на iOS и Android¶

Симптом: один и тот же ДП выглядит по-разному на iOS и Android (шрифт, разметка, отступы).

Что проверить: - Тип ДП: «Нередактируемое текстовое поле» (НТФ), «Большой текст с форматированием» (БТсФ) — наиболее проблемные - HTML-содержимое поля — сложная вёрстка может рендериться по-разному

Решение: это ожидаемое поведение для сложного HTML. Для критичных случаев — упрощать HTML в ДП. Зафиксировать и эскалировать как feature request.

2.3 Невозможно заполнить / отредактировать ДП на iOS¶

Симптом: ДП доступен только для просмотра в МП, хотя в вебе можно редактировать. Или БТсФ не даёт ввести текст.

Что проверить: - Тип ДП — не все типы редактируемы в МП (только основные: текст, число, дата, справочник, чекбокс) - Версия МП - Права пользователя на редактирование ДП (матрица доступа к ДП по статусу)

Решение: если тип ДП не поддерживает редактирование в МП — это ограничение платформы. Документировать в карточке задачи.

2.4 Не загружается список категорий¶

Симптом: при входе в раздел категорий — пустой список или ошибка загрузки.

Что проверить: - Подключение к серверу (другие разделы работают?) - Версия МП - [2L] Логи сервера — ошибки в endpoint /api/categories

Решение: очистить кэш МП. Если не помогает — переустановить учётную запись.

3. Новости и лента¶

3.1 Новости не отображаются в МП¶

Симптом: раздел новостей пуст или новости пропали на обеих платформах (iOS + Android).

Что проверить: - В веб-версии новости видны? - Пользователь входит в целевую группу новостей - [2L] Настройка портала: новости публикуются через виджет «Новости» — проверить, что виджет настроен для мобильных - Версия МП — после обновления сервера может потребоваться обновление МП

Решение: обычно связано с обновлением сервера без обновления МП, или с изменением настроек виджета новостей.

3.2 В МП отображаются несогласованные новости¶

Симптом: в МП видны новости со статусом «На согласовании» (черновики).

Что проверить: - Роль пользователя — администраторы/модераторы портала видят черновики - [2L] Настройка виджета новостей — фильтрация по статусу публикации

Решение: если пользователь не модератор — это баг фильтрации. Эскалировать с указанием версии МП.

3.3 Отображение ленты / темы обсуждения¶

Симптом: в ленте задач не видна тема обсуждения, комментарии отображаются без группировки.

Что проверить: - Версия МП — группировка комментариев добавлена в новых версиях - Настройки отображения ленты в МП

Решение: обновить МП до последней версии.

4. Push-уведомления¶

4.1 Push не приходят (Android)¶

Симптом: на Android не приходят push-уведомления из чатов/задач.

Что проверить: - В настройках телефона: уведомления для 1F Mobile разрешены? - Режим энергосбережения не блокирует фоновые процессы? - Настройки push в МП: Настройки → Уведомления — нужные типы включены? - [2L] Порты для FCM (Firebase Cloud Messaging): 443, 5228-5230 — открыты на файрволе? - [2L] В AdminSPA: Общие настройки → Push-уведомления — Server Key указан?

Решение: чаще всего — режим энергосбережения на Android (Huawei/Xiaomi особенно агрессивны). Добавить 1F Mobile в исключения. Если порты закрыты — открыть на файрволе.

Документация: push_ios.md, notification_android.md

4.2 Сертификаты для push (iOS)¶

Симптом: push на iOS перестали приходить; запрос на обновление сертификатов.

Что проверить: - [2L] Сертификат APNs в AdminSPA → Push-уведомления. Сертификат Apple истекает через 1 год. - Тип сертификата: Production (не Development) - Bundle ID совпадает с приложением

Решение: перевыпустить сертификат в Apple Developer Portal → загрузить в AdminSPA. Каждое кастомное приложение — свой сертификат.

4.3 Badge (индикация на иконке)¶

Симптом: badge (красный кружок с числом) на иконке МП не обновляется или показывает неверное число.

Что проверить: - В настройках телефона: «Значки приложений» / Badges разрешены - На iOS: badge обновляется через APNs (silent push) — требуется Background App Refresh - [2L] Серверная отправка badge count — через NotificationHub

Решение: включить Background App Refresh для 1F Mobile. Если не помогает — диагностика через раздел «Диагностика» в МП.

Документация: mobile_logs.md

5. UI и визуальные баги¶

5.1 Главная страница бесцветная / тёмный текст на плитках¶

Симптом: на iOS плитки дашборда отображаются без цвета или с тёмным нечитаемым текстом. На Android — нормально.

Что проверить: - Версия МП iOS - Настройки цвета плиток в AdminSPA (Дашборды → цвет текста, цвет фона) - Тёмная тема iOS — может влиять на отображение

Решение: обновить МП. Если баг воспроизводится — зафиксировать версию iOS + МП, сделать скриншот, эскалировать.

5.2 PWA — белый экран¶

Симптом: 1Форма в режиме PWA (отдельное приложение) запускается в белый экран.

Что проверить: - Это не нативное МП, а PWA (Progressive Web App) — ярлык из браузера - Очистить кэш браузера / удалить PWA и добавить заново - Версия браузера (Chrome / Safari) — обновлена ли

Решение: PWA — это не 1F Mobile, а веб-обёртка. Белый экран обычно из-за устаревшего Service Worker. Удалить PWA → очистить кэш браузера → добавить заново.

5.3 Фильтры и сортировки¶

Симптом: не отображается меню фильтра в категориях, сортировки работают не так как в вебе.

Что проверить: - Версия МП - Тип фильтра — не все фильтры из веба доступны в МП

Решение: МП поддерживает базовый набор фильтров. Если нужный фильтр недоступен — это ограничение платформы.

Документация: tasks_filter.md, tasks_filter_android.md

6. Чаты и коммуникации в МП¶

6.1 Пересылка сообщений¶

Симптом: нельзя переслать несколько сообщений из одного чата в другой.

Что проверить: - Версия МП — мультиселект при пересылке появился в новых версиях - Длинный тап на сообщении → меню → Переслать

Решение: обновить МП. Если функционал отсутствует — это feature request.

6.2 Избранные сообщения¶

Симптом: нельзя редактировать избранные сообщения; нет перехода к оригиналу из списка избранного.

Что проверить: - Версия МП (iOS)

Решение: функционал развивается — обновить до последней версии.

6.3 ВКС из МП — задержка вызова¶

Симптом: при инициации звонка из МП — длительная задержка до установления соединения.

Что проверить: - Качество сети (Wi-Fi vs LTE) - Доступность Jitsi-сервера из мобильной сети - [2L] Настройки TURN/STUN сервера для мобильных клиентов

Решение: проверить сетевое подключение. Если задержка >10 сек — проверить доступность TURN-сервера.

7. Контакты и профиль¶

7.1 Уволенные сотрудники в контактах¶

Симптом: в списке контактов МП периодически появляются уволенные сотрудники.

Что проверить: - В веб-версии: пользователь деактивирован? (Пользователи → статус) - [2L] Флаг IsActive в таблице Persons — должен быть 0 - Кэш контактов в МП

Решение: очистить кэш МП (Настройки → Очистить кэш данных). Если проблема повторяется — это баг кэширования, эскалировать.

7.2 Запрет на изменение аватарки¶

Симптом: вопрос о возможности запретить пользователям менять аватарку через МП.

Что проверить: - [2L] Настройка в AdminSPA: Общие настройки → Профиль пользователя

Решение: если настройки нет — это ограничение платформы. Эскалировать как feature request.

8. Прочее¶

8.1 APK мобильного приложения¶

Симптом: клиент просит APK-файл для установки на Android без Google Play.

Что проверить: - Кастомная ли сборка МП у клиента

Решение: APK предоставляется по запросу через менеджера. Стандартная версия — через Google Play / RuStore. Кастомная — отдельная сборка.

8.2 Автоматическое открытие МП¶

Симптом: запрос на автоматический запуск МП (например, при входе на территорию).

Решение: нативное МП не поддерживает автозапуск по событию. Возможны deep links (1forma://) для открытия конкретных задач/категорий.

8.3 Транскрибация ВКС из МП¶

Симптом: запрос на включение транскрибации записи видеоконференции из МП.

Решение: транскрибация управляется на сервере (Jibri). Из МП можно инициировать запись, транскрибация обрабатывается автоматически при наличии настроенного пакета AI.

См. также: conferences/support-guide.md — секция Транскрибация

8.4 Некорректная работа с карточками задач¶

Симптом: карточки задач в МП работают некорректно (зависание, неверные данные, ошибки при открытии).

Что проверить: - Версия МП - Категория задачи — содержит ли сложные ДП (скрипты, HTML-виджеты) - [2L] Логи сервера — ошибки при запросе карточки

Решение: очистить кэш МП. Если проблема в конкретной категории — проверить мобильный шаблон.

9. Поиск и навигация¶

9.1 Поиск по чатам не работает (Android)¶

Симптом: на Android поиск по чатам не возвращает результатов или не реагирует на ввод. Воспроизводится во всех чатах.

Что проверить: - Версия МП Android — обновлена ли до последней - Воспроизводится ли на iOS (для изоляции: платформенный баг vs серверный) - Количество чатов/сообщений у пользователя (большой объём может влиять)

Решение: обновить МП. Если на последней версии — зафиксировать версию МП + версию Android + модель устройства, эскалировать как баг Android-клиента.

10. Стабильность и крэши¶

10.1 МП вылетает / крэшится¶

Симптом: МП закрывается самопроизвольно (вылеты), иногда многократно. Может быть привязано к конкретному действию или возникать спонтанно.

Что проверить: - Версия МП и версия ОС - При каком действии происходит вылет (открытие задачи, чат, лента) - Свободная память на устройстве - [2L] Логи крэшей: раздел «Диагностика» в МП или Firebase Crashlytics

Решение: обновить МП до последней версии. Если крэш воспроизводится стабильно — собрать: версия МП, версия ОС, модель устройства, шаги воспроизведения. Очистить кэш МП. Эскалировать с логами.

10.2 Тяжёлая задача вешает МП¶

Симптом: при открытии конкретной задачи МП зависает или вылетает. Другие задачи открываются нормально.

Что проверить: - Размер задачи: количество ДП, комментариев, вложений - Наличие сложных ДП: HTML-виджеты, скрипты, большие таблицы - [2L] Мобильный шаблон категории — настроен ли, какие ДП включены

Решение: если задача содержит тяжёлые ДП (скрипты, большие НТФ) — оптимизировать мобильный шаблон, исключив тяжёлые поля. Если проблема в объёме комментариев — это ограничение платформы, эскалировать.

11. Таблицы и сложные ДП¶

11.1 Ошибки заполнения таблицы в МП¶

Симптом: при заполнении табличного ДП в МП возникают ошибки: не сохраняются данные, сбрасываются значения, ошибки валидации.

Что проверить: - Тип ДП: «Таблица» — поддержка в МП ограничена - Какие колонки таблицы вызывают ошибку (справочник, дата, число) - Версия МП - [2L] Мобильный шаблон — включена ли таблица, какие колонки отображаются

Решение: табличные ДП в МП имеют ограниченную поддержку. Если ошибка в конкретном типе колонки — зафиксировать и эскалировать. Как workaround — заполнять таблицу через веб-версию.

12. ВКС и звонки¶

12.1 Пропала кнопка «Войти в ВКС» в МП¶

Симптом: в МП на iOS пропала опция входа в ВКС пользователя (звонок). Ранее была доступна.

Что проверить: - Версия МП — не откатилась ли после обновления - В веб-версии кнопка ВКС доступна? - [2L] Настройки ВКС в AdminSPA: включены ли звонки, Jitsi-сервер настроен - [2L] Права пользователя на инициацию ВКС

Решение: обновить МП. Если кнопка пропала после обновления МП — это регрессия, эскалировать с указанием предыдущей и текущей версии.

13. Сетевые требования¶

13.1 Какие порты нужны для работы МП¶

Симптом: клиент/IT-служба спрашивает, какие порты и адреса нужно открыть для работы МП.

Что проверить: - Тип инсталляции: облако или on-premise

Решение: минимальный набор: - 443 (HTTPS) — основной трафик МП ↔ сервер - 5228-5230 (TCP) — Firebase Cloud Messaging (push Android) - APNs (iOS): порт 443 к api.push.apple.com - Jitsi (ВКС): порты 443 + 10000/UDP к Jitsi-серверу (если используется ВКС) - Домен сервера 1Формы должен быть доступен без перехвата SSL (no MITM proxy)

Документация: push_ios.md, notification_android.md

14. Профиль и персонализация¶

14.1 Различия профиля между iOS и Android¶

Симптом: на iOS в профиле отображается больше информации, чем на Android (или наоборот). Запрос на выравнивание.

Что проверить: - Версия МП на обеих платформах - Какие именно поля отсутствуют на Android

Решение: iOS и Android — разные кодовые базы, набор полей профиля может отличаться между версиями. Зафиксировать конкретные отсутствующие поля, эскалировать как feature request на выравнивание.

Общие рекомендации по диагностике МП¶

Версия МП — первое, что нужно проверить. Попросить пользователя: Настройки → О программе.
Очистка кэша — решает ~30% проблем: Настройки → Очистить кэш данных.
Переустановка учётной записи — при проблемах авторизации: удалить аккаунт → добавить заново.
Диагностика — раздел доступен администраторам: см. mobile_logs.md.
iOS vs Android — разные кодовые базы (Swift / Kotlin), поэтому баги могут воспроизводиться только на одной платформе. Всегда фиксировать: платформа + версия ОС + версия МП.
Мобильные шаблоны — если ДП/поля не видны в МП, проверить настройку мобильных шаблонов в AdminSPA.