Справочники и доступ

Назначение

Группа меню Справочники — весь нормативно-справочный контур приложения: плоские списки (единицы измерения, участки, смены, виды номенклатуры, виды дефектов), сущности с собственной формой (сотрудники, операторы, оборудование, инструмент), составные структуры (шаблоны техпроцессов, правила расчёта норм) и системная механика platform-core, которой управляет приложение, но не бизнес-логика (статусы/переходы сущностей, типы связей). Сюда же вынесен журнал действий — сквозная лента событий по системе. Всё, что заведено здесь, используется как источник выбора (select, подстановка по умолчанию) в остальных разделах: BOM и техпроцесс берут единицы и участки отсюда, приём работ — сотрудников, себестоимость и MRP — коэффициенты K1/K2/K3 и нормы.

Раздел не описывает вход в систему, таблицу ролей RBAC и персональные Настройки (язык/тема/расположение навигации) — это Начало работы.

Кто использует (роли)

Весь пункт меню целиком закрыт правом admin.view — им обладает только роль Администратор (см. таблицу ролей, Начало работы). Остальные роли не видят группу Справочники вовсе (группа скрывается целиком, если после фильтрации по правам в ней не осталось ни одного пункта — тот же механизм, что и для других групп меню).

Списки, используемые другими разделами — единицы, участки, смены, виды номенклатуры и дефектов, сотрудники, оборудование, инструмент, параметры и коэффициенты — доступны для чтения авторизованным операторам. Их изменение и открытие страниц администрирования требуют admin.view. Операторы, роли, статусы и типы связей требуют административного доступа даже для чтения. Журнал действий, параметры по умолчанию, справочник операций, шаблоны и правила норм доступны для чтения по parts.view. Доступ к выпадающему списку в рабочем разделе не даёт права администрировать справочник.

Основные понятия

• Плоский справочник (Dictionary) — код и наименование. Пять справочников используют этот формат редактирования.
• Статус / переход — платформенный (platform-core) механизм жизненного цикла сущности: у каждого типа сущности (Деталь, Производственный заказ и т. д.) есть набор допустимых статусов и разрешённых переходов между ними; здесь его можно только расширять (добавить статус/переход), но не редактировать или удалять уже созданное.
• Тип связи (RelationKind) — платформенный справочник допустимых видов связи между сущностями графа (например, «состоит из», «выполняется на»); здесь только просмотр — создание нового типа связи без кода, который умеет его интерпретировать, ничего не даст.
• K1/K2/K3 — унаследованные из оригинального VOGBIT поправочные коэффициенты (Начало работы, глоссарий): K1 — коэффициент пересчёта между единицами измерения (эта страница), K2 — коэффициент операции (справочник операций/шаблоны техпроцессов), K3 — коэффициент себестоимости (Себестоимость и цены).
• Правило нормы (NormRule) — версионируемая формула или таблица для расчёта расхода материала или штучного времени; проходит статусы черновик → действует (released, содержимое замораживается) → архив.

Единицы измерения / Участки / Смены / Виды деталей / Виды брака

Пять справочников используют таблицу «код + наименование», редактирование прямо в ячейке (двойной клик), кнопка «+ Новая» открывает диалог с теми же двумя полями.

Особенности и ограничения:

• У справочника Участки — два дополнительных поля, которых нет у остальных четырёх: «Рабочие дни» (числа 1–7, пн=1…вс=7, через запятую — используется планировщиком) и «Занятость мест» (сколько заданий участок может вести параллельно, тот же смысл, что у аналогичного поля Оборудования). У остальных эти поля скрыты — компонент параметризован флагами showWorkingDays/showCapacity, включёнными только для places.
• Ни у одного из пяти справочников нет удаления из интерфейса — только создание и редактирование кода/названия.
• Строки, уже используемые где-то (например, единица, на которую ссылается деталь), можно продолжать редактировать — платформа не проверяет использование при PATCH.

Статусы

/admin/statuses. Просмотр жизненного цикла сущностей и расширение через добавление статусов и переходов.

Что видно: выпадающий список «Тип сущности» (Деталь, ПроизводственныйЗаказ и т. д. — все типы, заведённые в platform-core), под ним две таблицы — «Статусы» (код, название, флаги «начальный»/«финальный») и «Переходы» (из статуса → в статус, название), с формами добавления новой строки под каждой.

Особенности и ограничения:

• Только добавление: существующие статусы и переходы нельзя удалить или переименовать. Проверяйте, что новые статусы достижимы через предусмотренные переходы.
• «Из» в переходе можно оставить пустым — означает «из любого статуса».

Типы связей

/admin/relation-types. Только просмотр: код, название, кардинальность (один-к-одному/один-ко-многим и т. п.) для всех типов связей графа platform-core. Формы добавления нет сознательно — новый тип связи без кода на бэкенде/фронтенде, который умеет его использовать (traverse()), был бы «мёртвым» и ничего не давал.

Операторы

/admin/operators. Учётные записи для входа в систему — логин/пароль/роль, отдельно от Сотрудников (ниже). Экрана-аналога в старом VOGBIT нет — там доступ настраивался иначе (конфигурации интерфейса на пользователя, см. «Особенности» ниже); в Vyrab это отдельный, новый в вебовой версии раздел, построенный вокруг RBAC-ролей (Начало работы).

Что видно: таблица «Логин / Имя / Сотрудник / Права» (права — либо Все права, либо список permission-строк роли); кнопка «+ Новый» (видна только при admin.view, хотя сама страница и так доступна только администратору — двойная защита такая же, как везде: бэкенд отвечает 403 независимо от того, что показывает фронтенд).

Типовые сценарии:

1. Создать оператора: логин, пароль, отображаемое имя, роль (обязательно — без роли создать нельзя), опционально — сотрудник (для «своего» табеля, Работы и качество). В списке сотрудников для привязки показаны только те, кто ещё не привязан ни к одному оператору — один сотрудник = один логин, второй раз выбрать того же нельзя.

Особенности и ограничения:

• Ни редактирования, ни удаления оператора из интерфейса нет — только создание. Смена роли/пароля существующему оператору отсюда недоступна.
• Список ролей и сами права наследуются от таблицы ролей Начало работы — этот экран их не редактирует, только назначает готовую роль оператору.

Сотрудники

/admin/employees. Справочник физических работников цеха (кто фактически выполнил работу — WorkRecord.worker_ids), отдельно от Операторов: подавляющее большинство сотрудников никогда не получает логин в систему, а выбираются из списка при приёмке работ (Работы и качество) и в табеле.

Что видно: таблица «Имя / Код / Статус» (Активен/Архивный), чекбокс «Показать архивных», кнопка «+ Новый».

Типовые сценарии:

1. Завести сотрудника: имя (обязательно) и короткий код (используется для идентификации на цеховом терминале — сканирование/ввод бейджа, GET /api/employees/lookup).
2. Архивировать уволенного — кнопка «Архивировать» в строке; архивный сотрудник пропадает из выбора в новых отметках сдачи/ОТК, но вся его прошлая история остаётся как есть. «Восстановить» возвращает обратно.

Особенности и ограничения:

• Архивирование — это флаг данных, а не смена статуса сущности: у Employee нет собственного жизненного цикла статусов, в отличие от Деталей и Заказов.
• Код должен быть уникален для идентификации по бейджу — при совпадении lookup вернёт первого найденного активного сотрудника; система это не проверяет при сохранении.

Коэффициенты пересчёта (K1)

/admin/coefficients. Соответствует таблице TranslationCoefficients в оригинальном VOGBIT (support/446). Таблица «Номенклатура / Из ед. / В ед. / Коэффициент».

Что видно: строка без номенклатуры — общий коэффициент по умолчанию для пары единиц измерения; строка с конкретной номенклатурой переопределяет его только для неё. Пустой справочник — не ошибка, K1 по умолчанию считается равным 1.

Типовые сценарии:

1. Добавить коэффициент: выбрать номенклатуру (необязательно — через PartPicker), единицу-источник, единицу-цель, значение коэффициента.

Особенности и ограничения:

• Используется не только для отображения — читается MRP, себестоимостью и заданием на пилу, так что ошибка в значении здесь тихо исказит расчёты в нескольких других разделах.
• Единица-источник/цель и номенклатура — реальные связи графа (созданы одной атомарной командой), а не свободный текст.

Оборудование

/admin/equipment. Ресурс планировщика отдельно от Участков — конкретный станок/машина, а не зона цеха. Таблица «Наименование / Занятость (парал. операций)», обе ячейки редактируются на месте.

Особенности и ограничения:

• «Занятость» — сколько операций это оборудование может вести одновременно (тот же смысл, что «Занятость мест» у Участков): 1 для одиночного станка, больше — только если ресурс реально разделяемый. Используется планировщиком (CumulativeConstraint, Производство и планирование).
• Ни удаления, ни архивирования из интерфейса нет.

Инструмент

/admin/tools. Соответствует справочнику инструмента из «Технология подробно» оригинального VOGBIT (support/577) — используется переходами техпроцесса в редакторе Номенклатуры (вкладка «Операции», Номенклатура и заказы) вместо свободного текста. Плоский список «Наименование», редактирование в ячейке, удаление по кнопке в строке (в отличие от большинства других справочников этой фазы).

Параметры

/admin/parameters. Справочник уточняющих параметров операций/переходов/материалов в редакторе техпроцесса (support/577 — «клуарифицирующие параметры»). Таблица «Наименование / Тип значения» (Текст / Число / Диапазон «от–до»), удаление по кнопке. Тип значения задаётся только при создании и не меняется после.

Значения параметров по умолчанию

/admin/parameter-defaults. Три набора (Операция / Переход / Материал) — какие параметры из справочника выше автоматически подставляются кнопкой «Заполнить параметры» при редактировании техпроцесса соответствующего типа элемента.

Что видно: выбор типа элемента и параметра + кнопка «+ Добавить в набор»; три списка ниже, по одному на тип элемента, с крестиком удаления у каждой строки.

Особенности и ограничения: это не значения параметров, а сам набор — «какие параметры вообще предлагать»; конкретное значение для конкретной операции/перехода/материала задаётся уже в редакторе техпроцесса (Номенклатура, Номенклатура и заказы), не здесь.

Справочник операций

/admin/operation-types. Библиотека типовых операций с нормативными значениями по умолчанию — источник для шаблонов техпроцессов (ниже) и точки быстрого выбора при ручном редактировании техпроцесса детали.

Что видно: таблица «Наименование / Участок / Тман, ч / Ставка, ₽/ч / K2» — все пять полей редактируются в ячейке, участок выбирается из справочника Участков. Удаление по кнопке в строке.

Особенности и ограничения: это значения по умолчанию — при добавлении операции в конкретный техпроцесс или в шаблон их можно переопределить локально, не трогая запись в этом справочнике.

Шаблоны техпроцессов

/admin/routing-templates. Готовые наборы операций (например, «Типовой ТП для корпусных деталей»), которые можно одним действием применить к детали в редакторе Номенклатуры (кнопка /apply, Номенклатура и заказы), вместо того чтобы каждый раз собирать техпроцесс с нуля.

Что видно: список шаблонов слева, справа — шаги выбранного шаблона: № (порядок), Операция (из справочника операций), Тман/Участок/Ставка (если не переопределены — показывается «из типа» серым), Кол-во партии, кнопки переупорядочивания (↑/↓) и удаления.

Типовые сценарии:

1. Создать шаблон — только название.
2. Добавить шаг — выбрать операцию из справочника операций (обязательно) и порядковый номер; Тман/участок/ставка/K2 подтягиваются из справочника, их можно переопределить прямо в таблице после добавления.

Особенности и ограничения: переставить шаги местами (↑/↓) — это обмен значений sequence двух соседних строк, а не отдельное поле порядка.

Нормы расхода и времени

/admin/norm-rules. Соответствует «Таблицам нормирования» оригинального VOGBIT (support/576): версионируемые формулы или таблицы для расчёта расхода материала либо штучного времени, тем же безопасным интерпретатором выражений, что у формул Генератора (Номенклатура и заказы).

Что видно: список норм слева (Норма / Тип «Формула»/«Таблица» / Статус «Черновик»/«Действует»/«Архив» / Область применения), справа — карточка выбранной нормы: наименование, тип, выражение (для формулы) или таблица строк «Параметр / От / До / Результат» (для таблицы), единица результата, область применения, комментарий; ниже — блок «Проверить расчёт» (калькулятор: ввести значения переменных → получить результат без сохранения) и «История расчётов» (если норму уже применяли).

Типовые сценарии:

1. Создать норму: название, тип (Формула/Таблица), для формулы сразу — выражение (например, length * width * thickness * density), единица результата, область применения. Для таблицы строки добавляются отдельно после создания.
2. Опубликовать (перевести в «Действует») — после подтверждения диалога; содержимое (формула или строки таблицы) становится неизменяемым.
3. Отправить в архив — доступно из статуса «Действует».
4. Проверить расчёт до публикации — ввести пары «переменная = значение», нажать «Посчитать».

Особенности и ограничения:

• Редактировать содержимое (выражение, строки таблицы, тип формула/таблица) можно только пока норма в статусе «Черновик»; действующую норму нельзя изменить — исправление оформляется как новая норма, чтобы уже выполненные расчёты оставались воспроизводимыми. Тип (формула/таблица) вообще нельзя сменить после создания.
• Удалить из интерфейса можно только черновик.
• Применение нормы к конкретной операции/материалу детали (/apply) API поддерживает полностью, но в интерфейсе редактора техпроцесса (Номенклатура, Номенклатура и заказы) кнопки для этого сознательно не подключены — на этой странице есть только «Проверить расчёт» как отдельный калькулятор и просмотр истории уже выполненных применений.

Журнал действий

/activity. Лента событий по системе в хронологическом порядке — новый в Vyrab раздел, прямого аналога в оригинальном VOGBIT нет.

Что видно: вертикальная лента карточек — цветной значок действия, подпись действия, ссылка на объект (открывает его в инспекторе объектов, Начало работы), кто выполнил, когда (относительное время с точным временем во всплывающей подсказке), при наличии — короткий комментарий. Сверху — фильтр-чипы по типу действия и кнопка «Обновить».

Особенности и ограничения:

• На практике в журнал сейчас пишутся только три типа события, все три — по Номенклатуре: создание детали, релиз детали, создание новой ревизии. Остальные разделы (заказы, приём работ, склад и т. д.) в журнал пока не пишут — интерфейс написан как общий (произвольный entity_kind/action), но заполняется он только там, где вызван log_action.
• Право на чтение журнала — parts.view, а не admin.view: строже, чем у большинства открытых-на-чтение справочников этой фазы, но не то же самое право, что закрывает саму страницу в меню (admin.view) — на практике туда всё равно попадают только администраторы, так как пункт меню скрыт для всех остальных.

Не перенесено из оригинального VOGBIT

Два раздела администрирования старого VOGBIT в Vyrab отсутствуют как класс — не «ещё не сделаны», а замещены другим устройством системы:

• Конфигурации рабочих мест (support/474 — включение/выключение вкладок и режимов конфигурации отдельно на каждого пользователя, «Присоединённые формы»). В Vyrab доступ устроен ролями RBAC (Начало работы) — права выдаются роли целиком, а не настраиваются вручную по вкладкам на пользователя.
• Шаблоны отчётов (support/459 — загрузка своих Excel-шаблонов (*.xlsx) через Администрирование → Шаблоны отчётов для печати документов). В Vyrab такого справочника нет вовсе — экспорт в Excel, где он есть (например, кнопка экспорта в некоторых таблицах), генерируется кодом напрямую, без пользовательских шаблонов.

Связанные разделы

• Начало работы — роли и права (таблица ролей, право admin.view), персональные Настройки, инспектор объектов (открытие объекта из Журнала действий).
• Производство и планирование — Участки/Оборудование/Смены как ресурсы планировщика (Диспетчеризация, График производства).
• Номенклатура и заказы — Номенклатура использует Единицы, Виды деталей, Параметры, Инструмент, Справочник операций, Шаблоны техпроцессов и Правила норм напрямую в редакторе техпроцесса.
• Работы и качество — Сотрудники и Смены — выбор исполнителя и смены при приёмке работ; Виды дефектов — фиксация брака.
• Склад и снабжение — Коэффициенты K1 в расчёте MRP.
• Себестоимость и цены — Коэффициенты и Справочник операций (Тман, ставка, K2) в расчёте себестоимости.