В государственном цифровом сервисе ЕСИА и СМЭВ решают разные задачи. ЕСИА относится к идентификации и аутентификации пользователей, а СМЭВ обеспечивает информационное взаимодействие систем при предоставлении услуг и исполнении функций. Их полезно выделить в отдельные части архитектуры и плана работ. Официальные материалы для подготовки проекта опубликованы в рекомендациях Минцифры по ЕСИА и разделе вопросов Ситуационного центра по СМЭВ.
Разделите вход и права в приложении
Для ЕСИА начните с пользовательского сценария: кто входит в сервис, какие сведения нужны после входа и что человек сможет сделать в приложении. Состав получаемых данных и основание их использования должен быть согласован заказчиком. Авторизация внутри сервиса требует своей модели ролей: подтвержденная учетная запись еще не определяет полномочия сотрудника в конкретной организации. Опишите создание локального профиля, связь с существующей записью и действия при изменении сведений. Отдельного внимания требуют пользователи, представляющие организацию.
Заранее составьте перечень зависимостей подключения: регистрационные действия, параметры интеграции, доступ к средам, сертификаты и согласования, применимые к выбранному сценарию. Для каждой зависимости укажите владельца и ожидаемый результат. Используемые требования проверяйте по документации выбранной версии. В пользовательском интерфейсе предусмотрите понятные состояния при прерывании входа, отказе пользователя и временной недоступности внешнего сервиса. Человек должен понимать, удалось ли войти и какое действие он может выполнить дальше.
Опишите каждый обмен сведениями
Для СМЭВ составьте отдельную карточку каждого нужного вида сведений: цель запроса, поставщик, версия, входные данные и правила применения ответа в вашем процессе. Каталог видов сведений доступен на официальном портале Ситуационного центра. Уточните условия доступа и требования к выбранному обмену до оценки разработки. Полезно сразу определить, что произойдет, если ответ содержит неполные сведения или не позволяет продолжить обработку заявления.
Если выбранный обмен предполагает раздельную отправку запроса и получение ответа, отразите это в состоянии задачи. Система должна связывать ответ с исходным запросом, показывать ожидание и учитывать повторную обработку. Проверьте успешный ответ, ошибку формата, отсутствие данных, поздний ответ и временную недоступность внешней стороны. Журнал должен помогать найти конкретный обмен по идентификатору и понять его состояние, сохраняя согласованный состав диагностических данных. Правила ручного разбора исключений также стоит включить в приемку.
Планируйте запуск вместе с эксплуатацией
Рабочий запуск зависит от готовности приложения и внешних подключений. В общем плане обозначьте, какие сценарии можно проверить на стенде, какие требуют взаимодействия со смежной стороной и кто фиксирует результат. Перед передачей подготовьте сведения о версиях документов, настройках, сроках действия используемых сертификатов и канале регистрации инцидентов. Изменение вида сведений или условий входа должно запускать проверку совместимости. Тогда ЕСИА и СМЭВ становятся понятными частями сервиса с собственными владельцами, проверками и порядком сопровождения.