index

@mineflow/client-react

---

@mineflow/client-react / Справочники

Справочники

Справочники (refs-kit, ADR-0014): кросс-областные lookups (core/refs, hr/refs, eam/refs), читаемые широким кругом ролей. Держим единым РУКОПИСНЫМ модулем, а не codegen (gen:hooks), потому что:

1. генератор жёстко единообразный — queryKeys.<group>.list(query)/.detail(id) + вывод по area; у refs ключи bespoke (refs.positions массив, refs.productionObjects(activeOnly) функция), а useProductionObjects(activeOnly=true) — руками подобранная сигнатура+дефолт (его потребляют web/mobile); codegen дал бы (query={}) и перевернул дефолт active-only→all, сломав вызовы;
2. cohesion — раздел «Справочники» живёт одним файлом, а codegen разнёс бы reads по core/hr/eam.generated.ts;
3. большинство refs-хуков — writes (PATCH/POST), которые codegen не трогает в принципе.

Read'ы — для разрешённых GET-ролей; write'ы идемпотентны (@Idempotent, ADR-0012), на успехе инвалидируют свой справочник. writeRoles — по контракту API.

Type Aliases

Type Alias	Description
CreatePositionBody	Тело создания должности (generic record; обязателен code, валидирует createSchema).
CreateProductionObjectBody	Тело создания производственного объекта (generic record; обязателен code).
ImportFuelNormsCommitBody	Тело коммита импорта норм ГСМ.
ImportFuelNormsPreviewBody	Тело предпросмотра импорта норм ГСМ.
ImportMaintenanceNormsCommitBody	Тело коммита импорта норм ТО (batchId).
ImportMaintenanceNormsPreviewBody	Тело предпросмотра импорта норм ТО (rows + опц. mode).
ImportPositionsCommitBody	Тело коммита bulk-импорта должностей (batchId из предпросмотра).
ImportPositionsPreviewBody	Тело предпросмотра bulk-импорта должностей (rows + опц. mode).
UpdateAssetClassBody	Тело правки класса активов (generic record).
UpdateDowntimeCategoryBody	Тело правки категории простоя (generic record; name/group).
UpdateHseIncidentClassifierBody	Тело правки классификатора HSE (generic record; name/group/severity).
UpdatePositionBody	Тело правки записи справочника (generic record; поля валидирует updateSchema модуля).
UpdateProductionObjectBody	Тело правки производственного объекта (generic record; валидирует updateSchema модуля).
UpdateSystemRoleBody	Тело правки системной роли (generic record; см. R11-DTO-F2).
UpdateTmcCategoryBody	Тело правки категории ТМЦ (generic record; updateSchema = name).

Действия

Function	Description
useImportFuelNormsPreview	Предпросмотр импорта норм ГСМ (dry-run): diff + batchId. НЕ мутирует.
useImportMaintenanceNormsPreview	Предпросмотр импорта норм ТО (dry-run): возвращает diff + batchId. НЕ мутирует.
useImportPositionsPreview	Предпросмотр bulk-импорта должностей (CSV-rows): dry-run, возвращает diff + batchId для последующего коммита. НЕ мутирует — useApiMutation без инвалидации и без Idempotency-Key (на бэке намеренно не @Idempotent).

Запись

Function	Description
useCreatePosition	Создание должности (POST). На успехе инвалидирует справочник должностей. Дубликат code → 409 на бэке.
useCreateProductionObject	Создание производственного объекта (POST). На успехе инвалидирует оба кэша участков. Дубликат code → 409 на бэке.
useImportFuelNormsCommit	Коммит импорта норм ГСМ (по batchId). На успехе инвалидирует справочник.
useImportMaintenanceNormsCommit	Коммит ранее предпросмотренного импорта норм ТО (по batchId). На успехе инвалидирует справочник норм ТО.
useImportPositionsCommit	Коммит ранее предпросмотренного импорта должностей (по batchId). Применяет upsert/деактивацию. На успехе инвалидирует справочник должностей.
useUpdateAssetClass	Правка класса активов (PATCH). На успехе инвалидирует справочник классов.
useUpdateDowntimeCategory	Правка категории простоя (PATCH). На успехе инвалидирует справочник.
useUpdateHseIncidentClassifier	Правка классификатора инцидентов HSE (PATCH). На успехе инвалидирует справочник.
useUpdatePosition	Правка должности (PATCH). Поля частичные (name/active/…), валидируются updateSchema модуля на бэке. На успехе инвалидирует справочник должностей.
useUpdateProductionObject	Правка производственного объекта (PATCH). На успехе инвалидирует оба кэша участков (active+all) через стабильный префикс.
useUpdateSystemRole	Правка системной роли (PATCH; напр. name/description/permissions/ scopeByObject). На успехе инвалидирует справочник ролей.
useUpdateTmcCategory	Правка категории ТМЦ (PATCH). На успехе инвалидирует справочник категорий.

Чтение

Function	Description
useAssetClasses	Справочник классов активов EAM (для resolve label'а техники в UI). Долгоживущий lookup, читаемый всеми ролями.
useDowntimeCategories	Справочник категорий простоев (core, иерархия). Читают все 7 ролей.
useFuelConsumptionNorm	Карточка норматива расхода ГСМ EAM по id. Read-only (правка только через bulk-импорт). Роли: Engineer/Mechanic/Foreman/Admin/CEO/Supply.
useFuelConsumptionNorms	Справочник нормативов расхода ГСМ EAM (temporal). Read-only (правка через импорт). Роли: Engineer/Mechanic/Foreman/Admin/CEO/Supply.
useHseIncidentClassifiers	Классификатор инцидентов HSE (core). Читают все 7 ролей.
useMaintenanceNorm	Карточка норматива ТО EAM по id. Read-only (правка только через bulk-импорт). Роли: Engineer/Mechanic/Foreman/Admin/CEO.
useMaintenanceNorms	Справочник нормативов ТО EAM (temporal — по умолчанию активные «сейчас»). Read-only: правка только через bulk-импорт (PATCH нет). Роли: Engineer/ Mechanic/Foreman/Admin/CEO.
usePositions	Справочник должностей HR (для picker'а персонала смены). Долгоживущий lookup, читаемый всеми ролями.
useProductionObjects	Справочник участков (production objects) для picker'ов. Долгоживущий lookup, читаемый всеми ролями. activeOnly входит в ключ кэша (разные кэши).
useSystemRoles	Справочник системных ролей HR (для picker'а ролей при заведении УЗ и resolve label'ов). Долгоживущий lookup, читаемый всеми ролями.
useTmcCategories	Справочник категорий ТМЦ (core, иерархия parent-child). Читают все 7 ролей.