mdm-ordinis/docs/operator/index.md

Руководство оператора Ordinis НСИ

Это руководство — для операторов справочников: тех, кто заводит и поддерживает данные в Ordinis (космические аппараты, наземные станции, типы антенн, операторов спутниковой связи и т.д.).

Если ты разработчик-интегратор (Альтум, BI, геопортал) — смотри интеграцию по API.

Если ты ревьюер schema drafts — смотри руководство ревьюера.

Что внутри

• Создание справочника — как добавить новый справочник (например, «типы антенн») и описать его поля
• Работа с записями — как добавлять, редактировать, искать записи внутри справочника
• Закрытие записи — как корректно «удалить» запись, сохранив историю (bitemporal модель)
• Журнал аудита — как посмотреть, кто и когда что менял
• Разбор ошибок — типичные ошибки валидации и как их понять

Базовые понятия

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

Запись — одна строка в справочнике. У каждой записи есть бизнес-ключ (уникальный код) и данные (значения полей по схеме). Также есть период действия — valid_from / valid_to, в течение которого запись считается актуальной.

Scope — уровень доступа к данным:

• PUBLIC — открыто всем
• INTERNAL — для внутренних потребителей
• RESTRICTED — только для администраторов

Schema draft — предложение изменить схему справочника (добавить поле, изменить тип). Не применяется автоматически — проходит ревью, затем публикуется.

Какую роль ты выполняешь

Если ты...	Иди в раздел
Создаёшь новый справочник	Создание справочника
Добавляешь запись в существующий справочник	Работа с записями
Хочешь «удалить» устаревшую запись	Закрытие записи
Видишь ошибку валидации, не понимаешь	Разбор ошибок
Проверяешь, кто менял запись	Журнал аудита