емиас — angular-библиотеки мкпи
- клиент
- Правительство Москвы — ЕМИАС
- отрасль
- Здравоохранение / госсектор
- роль
- Владелец модулей — проектирование, разработка, поддержка
- сроки
- С 2022 года по настоящее время
- команда
- До 15 инженеров, тестировщиков и аналитиков
- статус
- в продакшене · в работе
ЕМИАС — Angular-библиотеки МКПИ: кейс
Набор Angular-библиотек компонентов с независимыми версиями, которые вместе закрывают типовые элементы интерфейса МКПИ ЕМИАС. Библиотеки ведём мы; другие модули ЕМИАС подключают их как опубликованные пакеты.
Коротко
Набор библиотек МКПИ избавляет платформу от дублирования работы над интерфейсами. Каждая узкая область — поиск пользователей, уведомления, редактор ОБОП, уведомления о ЗНО, онкологический модуль — получает свою небольшую Angular-библиотеку с независимой версией, опубликованную во внутреннем npm-реестре платформы. Модули-потребители (прежде всего KPI врачей) подключают их как зависимости. Тот же подход мы применяли и в других проектах: маленькие библиотеки, понятная зона ответственности, внутренняя публикация, версионируемые зависимости.
- Наша роль: владелец библиотек
- Статус: в продакшене, несколько пакетов регулярно выпускаются
Почему набор библиотек, а не одна большая
У пакетов общие соглашения, но разные предметные области. Они выходят в разном ритме (уведомления меняются гораздо чаще, чем ОБОП), у них разные потребители и разная цена ошибки. Если собрать всё в одну библиотеку, каждому потребителю пришлось бы обновлять зависимость при любом изменении любого пакета — именно от этих трений и избавляет независимое версионирование.
Плата за это — немного продублированной инфраструктуры сборки в каждом пакете. Выигрыш — каждый модуль-потребитель сам решает, когда обновлять тот или иной пакет.
Пакеты
- Пользователи — компоненты поиска пользователей: везде, где врачу или администратору нужно найти пользователя в системе.
- Уведомления — всплывающие, баннерные и встроенные уведомления в едином для платформы виде.
- ОБОП — компоненты редактора и служебные компоненты модуля ОБОП.
- Уведомления о ЗНО — компонент уведомлений для онкологических сценариев (ЗНО — злокачественные новообразования).
- Онкология — интерфейс онкологического модуля, включая экран регистра.
Общие соглашения
Все пакеты устроены одинаково: исходники библиотеки, небольшое демо-приложение для локального просмотра и быстрой проверки во время разработки и собранный артефакт, который публикуется в реестр. Версии ведутся по SemVer.
Стек
Фреймворк: Angular 15 Язык: TypeScript, RxJS Распространение: внутренний npm-реестр ЕМИАС Версионирование: SemVer, у каждого пакета своя версия
Чему научились
- Отдельные библиотеки по предметным областям лучше одной большой библиотеки компонентов, когда у платформы несколько модулей-потребителей и неровный ритм релизов.
- Демо-приложение для каждой библиотеки — дешёвая и надёжная подстраховка. Это не Storybook, но его хватает, чтобы проверять компоненты в процессе разработки без полноценного приложения.
- Строгое версионирование — основа подхода. Без него набор независимых библиотек превращается в набор независимых источников разнобоя.
технологии
- backend
- Java 17, Spring Boot, Hibernate, JUnit
- frontend
- JavaScript, Angular, RxJS
- инфраструктура
- PostgreSQL, Docker, Kubernetes