# Письмо рассылки · НСИ Ordinis MDM доступна для интеграции

**Тема:** Ordinis MDM — централизованная НСИ ДЗЗ доступна для интеграции

**Кому:** development-leads@, integration-team@, data-owners@, product@nstart.space
**От:** zimin.an@nstart.space (Ordinis team)

---

Коллеги, добрый день.

Запустили **Ordinis MDM** — централизованный сервис нормативно-справочной информации (НСИ) для проектов ДЗЗ. Это **единый source of truth** для справочников, к которому теперь могут подключаться все потребители вместо ведения собственных копий.

## Где это живёт

| Среда | URL | Назначение |
|---|---|---|
| **Production** | https://ordinis.nstart.cloud | Боевые справочники, public LE-cert |
| **Staging** | https://ordinis.k8s.265.nstart.cloud | Тесты интеграции, Swagger UI здесь |
| Admin UI | (тот же домен) | Просмотр / редактирование (auth required) |
| OpenAPI spec | `$BASE/v3/api-docs` (staging) | Для генерации clients |
| Integrator docs | `$BASE/docs` (staging) | Полная документация |

## Что внутри

- **37 справочников** на проде (космические аппараты, наземные станции, антенны, миссии, спектральные каналы, классы разрешения, и т.д.) — все на сегодня в `PUBLIC` scope
- **REST API** с full bitemporal queries (`?at=<timestamp>`)
- **Локализация** через `Accept-Language` header (ru-RU / en-US / zh-CN)
- **Audit + history** — каждое изменение versioned (Hibernate Envers)
- **Workflow approvals** — maker-checker для чувствительных справочников
- **Kafka events** + **webhooks** — push-уведомления потребителям
- **Smart search** — full-text по всем справочникам

## С чего начать интегратору

1. **Quick Start (15 минут):** https://git.nstart.cloud/2-6/2-6-4/terravault/ordinis/-/blob/main/docs/integration/api-quickstart.md
2. **Cheat Sheet** (одностраничник): https://git.nstart.cloud/2-6/2-6-4/terravault/ordinis/-/blob/main/docs/integration/api-cheatsheet.md (он же зеркалится как **Приложение A** в Quick Start)
3. **Postman collection** (27 рабочих запросов + 10-шаговый demo flow): см. `docs/integration/postman/` в репо или попросите у Ordinis team
4. **Live presentation API Demo** (14 слайдов): попросите у меня PowerPoint, проведём walkthrough

## Smoke 60 секунд

```bash
ORDINIS=https://ordinis.nstart.cloud

curl -s $ORDINIS/api/v1/version | jq
curl -s $ORDINIS/api/v1/dictionaries | jq 'length'                       # 37
curl -s "$ORDINIS/api/v1/spacecraft/records?as_scope=PUBLIC" | jq '.[0]'
curl -sH "Accept-Language: en-US" \
  "$ORDINIS/api/v1/spacecraft/records/1999-068A?as_scope=PUBLIC" \
  | jq '.data.operator'                                                  # "NASA"
```

## Что должно лечь в Ordinis (и что не должно)

См. **регламент** `docs/integration/dictionary-criteria.md` — короткий decision framework для владельцев данных: какие данные стоит выносить в централизованную НСИ, а какие держать локально в своём сервисе. Прежде чем заводить новый справочник или мигрировать существующий — пройдитесь по чек-листу.

## Roadmap Q3

- Geo bundle (орбиты, AOI templates, terrain layers)
- AI Schema Assist v2 — per-field LLM suggest
- Multi-tenant ACL + bulk import API

## Поддержка и обратная связь

- **Slack/Mattermost:** `#ordinis` (если нет — постучитесь, добавлю)
- **Issue tracker:** GitLab project `2-6/2-6-4/terravault/ordinis`
- **Прямой контакт:** zimin.an@nstart.space

Подключайтесь — чем больше потребителей, тем быстрее НСИ закрывает реальные потребности. Готов лично провести 30-минутный demo любой команде.

С уважением,
Команда Ordinis

---

### Plain-text (для систем без markdown)

> Тема: Ordinis MDM — централизованная НСИ ДЗЗ доступна для интеграции
>
> Коллеги, добрый день.
>
> Запустили Ordinis MDM — централизованный сервис НСИ для проектов ДЗЗ.
> Это единый source of truth для справочников, к которому теперь могут
> подключаться все потребители вместо ведения собственных копий.
>
> URLs:
> - Production: https://ordinis.nstart.cloud
> - Staging (Swagger UI): https://ordinis.k8s.265.nstart.cloud
> - OpenAPI: $BASE/v3/api-docs (только staging)
> - Integrator docs: $BASE/docs (staging)
>
> Что внутри:
> - 37 справочников на проде (КА, наземные станции, миссии, антенны, ...)
> - REST API с time-travel (?at=<timestamp>)
> - Локализация через Accept-Language header
> - Audit + history (каждое изменение versioned)
> - Workflow approvals (maker-checker)
> - Kafka events + webhooks
> - Smart search
>
> С чего начать:
> 1. Quick Start: docs/integration/api-quickstart.md
> 2. Cheat Sheet: docs/integration/api-cheatsheet.md
> 3. Postman: docs/integration/postman/ (или у Ordinis team)
>
> Регламент "что заводить в НСИ" — docs/integration/dictionary-criteria.md.
> Пройдите чек-лист прежде чем создавать новый справочник.
>
> Slack: #ordinis · GitLab: 2-6/2-6-4/terravault/ordinis · zimin.an@nstart.space
>
> Готов провести 30-минутный demo для любой команды.
>
> — Ordinis team
