емиас — kpi врачей
- клиент
- Правительство Москвы — ЕМИАС
- отрасль
- Здравоохранение / госсектор
- роль
- Владелец модулей — проектирование, разработка, поддержка
- сроки
- С 2022 года по настоящее время
- команда
- До 15 инженеров, тестировщиков и аналитиков
- статус
- в продакшене · в работе
ЕМИАС — KPI врачей: кейс
Модуль ЕМИАС, который считает показатели эффективности врачей по всей медицинской сети Москвы.
Коротко
Модуль KPI врачей измеряет работу клинического персонала ЕМИАС: по этим показателям руководство оценивает эффективность медицинской помощи по всей городской сети. Это полноценный модуль с серверной частью и интерфейсом: backend на Spring Boot разделён на три приложения (web — пользовательский API, adapter — интеграция с ЕМИАС, static — раздача статики), к нему добавляются интерфейс на TypeScript и база данных, миграции которой разделены на общие настройки и справочные данные (НСИ).
- Наша роль: владелец модуля
- Статус: в продакшене, активно развивается
Архитектура
Главное решение здесь — разделение на три приложения. Большинство наших сервисов ЕМИАС умещаются в одном приложении, но у этого модуля есть причины отступить от шаблона:
web— пользовательский API. К нему обращаются врачи, руководители и аналитики.adapter— интеграция с ЕМИАС: входящий и исходящий обмен с остальной платформой. Эта часть развёртывается, масштабируется и отказывает иначе, чем пользовательский API, и разделение изолирует одно от другого.static— раздаёт статические ресурсы. Часть небольшая, но самостоятельная: объединив её сweb, мы связали бы два независимых жизненных цикла.
Миграции устроены по тому же принципу: настройки и справочные данные мигрируют раздельно, чтобы частые и малорискованные обновления НСИ не делили историю с редкими и рискованными структурными изменениями.
Интерфейс
Интерфейс написан на TypeScript и собран из Angular-библиотек компонентов МКПИ, которые тоже ведёт наша команда, — прежде всего из пакетов поиска пользователей и уведомлений. Библиотеки подключаются как версионируемые зависимости, а не копируются, поэтому поддерживать модуль недорого.
Стек
Backend: Java 17, Spring Boot, Hibernate, JUnit, Maven Frontend: TypeScript, Angular, библиотеки компонентов МКПИ Хранение данных: PostgreSQL, раздельные миграции настроек и НСИ Инфраструктура: Docker, Kubernetes Качество: интеграционные тесты на Python
Чему научились
- Разделить пользовательский API и интеграцию было правильно. Разные профили нагрузки, разные ритмы релизов, разные сценарии отказов. Общая единица развёртывания уже через квартал дала бы о себе знать связанными авариями.
- Раздельная история миграций для настроек и справочных данных кажется избыточной, пока не выкатываешь второе обновление НСИ за неделю и не радуешься, что ради него не нужно прогонять структурные изменения.
- Библиотеки компонентов МКПИ как версионируемые пакеты позволяют небольшой команде вести сразу несколько модулей с интерфейсом.
технологии
- backend
- Java 17, Spring Boot, Hibernate, JUnit
- frontend
- JavaScript, Angular, RxJS
- инфраструктура
- PostgreSQL, Docker, Kubernetes