Инструкция пользователя

Инструкция пользователя программного комплекса «Мобильное приложение SMS Helper — клиентское Android-приложение для авторизации операторов, просмотра административных процедур с принятыми решениями и отправки уведомлений заявителям (SMS, Viber, Telegram) службы «одно окно» г. Минска»

Инструкция — Мобильное приложение SMS Helper (служба «одно окно» г. Минска)

📱 Клиентское Android-приложение для операторов службы «одно окно» г. Минска

🔗 Backend API: https://sms.onewin.by/api

🏢 Оператор: КУП «Минское городское агентство обслуживания населения»

🎯 1. Для чего нужно приложение

SMS Helper — мобильное рабочее место уполномоченного сотрудника службы «одно окно» г. Минска. Приложение помогает:

  • войти в систему по логину и паролю;
  • просмотреть административные процедуры с принятыми решениями, ожидающие уведомления заявителя;
  • сформировать текст уведомления по шаблону и при необходимости отредактировать его;
  • отправить уведомление заявителю по каналам SMS, Viber, Telegram.
✅ Приложение предназначено только для сотрудников службы «одно окно»
Это не публичный сервис для заявителей. Для работы нужны учётная запись, доступ к backend API и устройство на Android с доступом в интернет.
ℹ️ Отображаемое имя на устройстве — SMS Helper. Идентификатор приложения: com.adminnotifysms.helper
🌐 2. Связанные сервисы МГАОН

Приложение работает совместно с серверной частью системы уведомлений и информационными сервисами «одного окна»:

sms.onewin.by/api onewin.by map.onewin.by info.onewin.by book.onewin.by ask.onewin.by
📩 SMS 💬 Viber ✈️ Telegram
💡 3. Перед началом
  • Устройство на Android 5.0 (API 21) или новее.
  • Установленное приложение SMS Helper (корпоративная установка, не публичный магазин для заявителей).
  • Стабильный доступ в интернет (Wi‑Fi или мобильная сеть).
  • Действующие логин и пароль сотрудника службы «одно окно».
  • Для отправки SMS — SIM‑карта и разрешение Android на отправку SMS.
  • Для доставки через мессенджеры — на устройстве должны быть установлены клиенты Viber и/или Telegram (при использовании соответствующих каналов).
ℹ️ URL backend API по умолчанию: https://sms.onewin.by/api. Меняйте его только по указанию администратора системы.
📌 4. Как пользоваться приложением (6 шагов)
🔐 Шаг 1. Вход в систему
  1. Откройте приложение SMS Helper.
  2. При необходимости проверьте поле «URL Backend API».
  3. Введите логин и пароль.
  4. Нажмите «Войти».
🔄 при сохранённой сессии вход выполняется автоматически
📱 Шаг 2. Разрешение SMS
  • При первом запуске Android запросит разрешение на отправку SMS.
  • Нажмите «Разрешить».
  • Без разрешения отправка SMS с устройства будет недоступна.
⚙️ при отказе откройте настройки приложения
🏢 Шаг 3. Район и загрузка
  1. В шапке экрана отображаются пользователь и район.
  2. Если вы администратор — выберите район в списке «Выберите район».
  3. Нажмите «Загрузить процедуры».
⏱️ список обновляется автоматически каждые 15 минут
🔍 Шаг 4. Фильтры

При большом списке используйте блок «Фильтры»:

  • Номер процедуры
  • Фамилия
  • Номер обращения

Затем нажмите «Применить фильтры».

✏️ Шаг 5. Текст уведомления
  1. Откройте карточку нужной процедуры.
  2. Проверьте ФИО, телефон, номер и дату обращения.
  3. При необходимости измените текст в поле «Текст уведомления (можно изменить перед отправкой)».
📝 текст можно править отдельно для каждой процедуры
📤 Шаг 6. Отправка
  1. Отметьте чекбоксами одну или несколько процедур.
  2. Нажмите «Отправить SMS (N)», где N — число выбранных записей.
  3. Дождитесь результата: «Отправлено: X, Ошибок: Y».
  4. При успехе статус станет «✅ SMS отправлена».
🔁 рекомендуется снова нажать «Загрузить процедуры»
📋 5. Что отображается в карточке процедуры
Номер процедуры — идентификатор административной процедуры.
ФИО — фамилия, имя и отчество заявителя.
Телефон — номер для доставки уведомления (записи без телефона в список не попадают).
Номер обращения — номер обращения заявителя.
Дата обращения — дата подачи обращения.
Текст уведомления — шаблонный текст, доступный для правки перед отправкой.
Статус отправки — «Отправить SMS» или «✅ SMS отправлена».
📝 6. Шаблон текста уведомления

По умолчанию формируется сообщение вида:

Служба «одно окно». Ваше обращение от ДД.ММ.ГГГГ номер … рассмотрено. Итоговые документы получите в службе «одно окно» при предъявлении документов, удостоверяющих личность (по доверенности).

ℹ️ Перед отправкой оператор может изменить текст вручную — это снижает риск ошибочного уведомления.
📡 7. Каналы уведомлений
КаналКак используетсяЧто нужно на устройстве
SMS Основной канал отправки с SIM‑карты устройства через системный SMS‑сервис SIM‑карта, разрешение «SMS», связь оператора связи
Viber Доставка уведомления заявителю через мессенджер Viber Установленный клиент Viber, доступ в интернет
Telegram Доставка уведомления заявителю через мессенджер Telegram Установленный клиент Telegram, доступ в интернет
✅ После успешной отправки факт уведомления фиксируется в серверной системе. Для синхронизации статуса снова нажмите «Загрузить процедуры».
👤 8. Роли пользователей
Оператор / сотрудник района — работает с процедурами своего района, загружает список и отправляет уведомления.
Администратор — дополнительно выбирает район в выпадающем списке («Выберите район») и затем загружает процедуры выбранного района.

Для выхода из учётной записи нажмите «Выйти» — сессия пользователя будет очищена. URL API при этом сохраняется.

⚠️ 9. Частые ситуации и что делать
🔴 «Заполните все поля»
→ Укажите URL API, логин и пароль — все три поля обязательны.
🟠 Ошибка входа / таймаут / нет связи с сервером
→ Проверьте интернет, правильность URL (https://sms.onewin.by/api) и учётные данные. При повторении ошибки обратитесь к администратору системы.
📵 Разрешение SMS отклонено
→ Настройки Android → Приложения → SMS Helper → Разрешения → SMS → Разрешить. Либо используйте кнопку «⚙️ Открыть настройки приложения» в приложении.
📭 Список процедур пуст
→ Убедитесь, что выбран нужный район, нажмите «Загрузить процедуры». Возможно, нет записей, ожидающих уведомления, или у процедур отсутствует телефон.
📡 «Отправлено: 0, Ошибок: N» / сбой отправки
→ Проверьте SIM‑карту, баланс/блокировку SMS, режим полёта, покрытие сети. Дождитесь завершения отправки и при необходимости повторите.
🔄 Статусы «не обновились» после отправки
→ Нажмите «Загрузить процедуры» для синхронизации с базой данных. Список также обновляется автоматически каждые 15 минут, пока экран процедур открыт.
🔐 10. Безопасность и персональные данные
  • Приложение используют только уполномоченные сотрудники службы «одно окно».
  • Не передавайте логин и пароль третьим лицам; при смене сотрудника запросите отзыв доступа у администратора.
  • Перед отправкой проверяйте телефон и текст уведомления — сообщение уходит заявителю.
  • Сессия сохраняется на устройстве (логин в систему не требуется при каждом открытии, пока вы не нажмёте «Выйти»).
  • Не оставляйте разблокированное устройство с открытым приложением без присмотра.
ℹ️ Ознакомьтесь с Политикой обработки персональных данных КУП «Минское городское агентство обслуживания населения».
🛠️ 11. Диагностика готовности приложения

При технических сбоях администратор может проверить экран диагностики приложения:

  • статус разрешения SEND_SMS;
  • состояние фонового сервиса отправки;
  • кнопки «Проверить работу» и «Запросить разрешение SMS».
ℹ️ В нормальном режиме сотруднику достаточно экранов входа и списка процедур. Диагностика нужна при настройке устройства или разборе ошибок отправки.
📞 12. Контакты и помощь

КУП «Минское городское агентство обслуживания населения»

📍 220004, г. Минск, ул. М.Танка, 36, корп. 1, пом. 1Н

📧 info@mgaon.by

📞 +375 (17) 364-66-34

По вопросам учётных записей, URL API и состава процедур обратитесь к администратору системы уведомлений или в МГАОН. По вопросам конкретной службы «одно окно» — в администрацию вашего района (контакты на onewin.by).

📌 Версия инструкции для мобильного приложения SMS Helper (AndroidSmsHelper), v1.0.
Программный комплекс: клиентское Android-приложение для авторизации операторов, просмотра административных процедур с принятыми решениями и отправки уведомлений заявителям (SMS, Viber, Telegram) службы «одно окно» г. Минска.