Skip to content

Модуль ТОиР во фронтенде

Расположение

  • Приложение: apps/main-office/src/app/views/pages/plant-maintenance/.
  • Общая библиотека: libs/plant-maintenance/ (фасад, модели статусов, пайпы, store дашборда).
  • Внешний requester-flow: apps/counterparty-office/src/app/components/service-requests/.

Архитектура

  • PlantMaintenanceFacade — единая точка вызова SDK (APIClient) для экранов ТОиР; компоненты не обращаются к plantMaintenance* напрямую.
  • status-transitions.utils — допустимые переходы статусов заявок и нарядов; проверка перед transition на фасаде.
  • plant-maintenance-error.helperwithPmRetry для повторов запросов, pmHttpErrorMessage для текстов ошибок.

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

Main Office

  • dashboard ТОиР с KPI, reliability, затратами и уведомлениями;
  • заявки на ремонт с available_transitions, history и cost summary;
  • наряды на работу с обычным manager-view и technician-режимом;
  • маршрут repairs/my-work-orders для личной очереди исполнителя.

Counterparty Office

  • requester portal для внешней подачи сервисных заявок;
  • список заявок контрагента;
  • карточка поданной заявки со статусом обработки.

SDK

Сгенерированный клиент: libs/sdk — методы plantMaintenance* и plantMaintenance*Transition / InspectionplansComplete.

После изменений backend: yarn generate-api-client (из корня фронтенда).

Для requester API через c-api используется прямой HttpClient-сервис в counterparty-office, так как это отдельный внешний контур с собственной базой API.

Release readiness

Перед релизом CMMS-фич:

  • пересобрать main-office и counterparty-office;
  • проверить technician-flow (my-work-orders) и requester-flow (service-requests);
  • убедиться, что dashboard и detail-экраны отрабатывают с актуальным SDK-контрактом;
  • после изменения backend schema выполнить yarn generate-api-client.

Сборка

bash
yarn nx build main-office --configuration=production
yarn nx build counterparty-office --configuration=production

См. также