platform → все домены
Зачем нужно
Платформенный слой публикует общие справочники и фичи всем доменам.
Стороны
- источник: platform
- потребитель: все 7 доменов
- вид: online read + event-driven
Reference-данные
См. ../platform/reference-data.md.
GET /api/v2/platform/reference/subjects
GET /api/v2/platform/reference/levels
GET /api/v2/platform/reference/formats
GET /api/v2/platform/reference/grade-ranges
Событие platform.reference_data.changed инвалидирует локальные кеши потребителей.
Feature flags
GET /api/v2/platform/feature-flags?service=lms-api
Событие platform.feature_flag.changed обновляет локальный snapshot.
i18n / переводы
GET /api/v2/platform/i18n/{locale}
События
| messageType | Когда |
|---|---|
platform.reference_data.changed | изменён subject/level/format/grade_range |
platform.feature_flag.changed | изменён feature flag |
platform.i18n.changed | обновлён пакет переводов |
Идемпотентность
- по
messageId.
Ошибки
| Сценарий | Поведение |
|---|---|
| reference key удалён, но используется доменом | API возвращает 409, ключ переводится в inactive |
consumer пропустил platform.reference_data.changed | consumer обновляет cache по TTL 60 секунд |
| feature flag неизвестен | consumer использует documented default |
Scopes
| Scope | Для чего |
|---|---|
service:platform.reference-data.read | читать справочники |
service:platform.feature-flags.read | читать flags для сервиса |
platform.reference-data.manage | административное управление справочниками |
platform.feature-flags.manage | административное управление flags |
Retention
- события 30 дней;
- локальные кеши обновляются по событию или по TTL (60 секунд).