← к клиентам
здравоохранение · госсектор · в работе

емиас — 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