Zimin A.N.
1dba9476db
operator/rbac.md — новая страница с полной матрицей RBAC: - Scope ACL (ordinis:client:public/internal/restricted) - Workflow роли (schema:reviewer, schema:publisher, record:reviewer) - Action matrix (endpoint → required scope + role) - Типичные профили (consumer, maker, reviewer, publisher, admin) - Composite role 'ordinis:admin' для one-shot assignment - Keycloak setup инструкция (Admin Console шаги) - Диагностика типичных 403 ошибок toc.yaml — link в раздел Руководство оператора. operator/index.md, reviewer/index.md — cross-references к rbac.md. Покрывает Phase 1d enforcement (MR !162) — пользователи теперь знают какие роли назначать в Keycloak realm 'nstart'.
3.7 KiB
Руководство оператора Ordinis НСИ
Это руководство — для операторов справочников: тех, кто заводит и поддерживает данные в Ordinis (космические аппараты, наземные станции, типы антенн, операторов спутниковой связи и т.д.).
Если ты разработчик-интегратор (Альтум, BI, геопортал) — смотри интеграцию по API.
Если ты ревьюер schema drafts — смотри руководство ревьюера.
Что внутри
- Создание справочника — как добавить новый справочник (например, «типы антенн») и описать его поля
- Работа с записями — как добавлять, редактировать, искать записи внутри справочника
- Закрытие записи — как корректно «удалить» запись, сохранив историю (bitemporal модель)
- Журнал аудита — как посмотреть, кто и когда что менял
- Роли доступа (RBAC) — полная матрица realm-ролей Keycloak: scope ACL + workflow roles (schema reviewer, publisher, record reviewer)
- Разбор ошибок — типичные ошибки валидации и как их понять
Базовые понятия
Справочник — таблица с однородными записями (например, «спутники», «наземные станции», «частотные диапазоны»). У каждого справочника есть схема — описание полей: какие поля, какого типа, обязательные или нет, ссылаются ли на другие справочники.
Запись — одна строка в справочнике. У каждой записи есть бизнес-ключ
(уникальный код) и данные (значения полей по схеме). Также есть
период действия — valid_from / valid_to, в течение которого
запись считается актуальной.
Scope — уровень доступа к данным:
PUBLIC— открыто всемINTERNAL— для внутренних потребителейRESTRICTED— только для администраторов
Schema draft — предложение изменить схему справочника (добавить поле, изменить тип). Не применяется автоматически — проходит ревью, затем публикуется.
Какую роль ты выполняешь
| Если ты... | Иди в раздел |
|---|---|
| Создаёшь новый справочник | Создание справочника |
| Добавляешь запись в существующий справочник | Работа с записями |
| Хочешь «удалить» устаревшую запись | Закрытие записи |
| Видишь ошибку валидации, не понимаешь | Разбор ошибок |
| Проверяешь, кто менял запись | Журнал аудита |