Глоссарий

Mon, 01 Jan 0001 00:00:00 +0000

Глоссарий#

Фиксированные канонические термины, используемые в спецификации.

Account — верхнеуровневый пользовательский доменный контекст в core.
Session — аутентифицированный runtime-контекст, привязанный к одному account_id.
Library — структурированный домен хранения для организованной работы.
Raw — домен неструктурированного capture уровня аккаунта.
active_library_id — выбранная библиотека для library-scoped операций.
library-scoped — операция/данные, требующие активный контекст библиотеки.
account-scoped — операция/данные, требующие только контекст аккаунта в сессии.
unlock — открытие сессии после валидации учетных данных.
sync — асинхронная синхронизация данных между локальным и удаленным runtime.
promote — явный перенос данных из Raw в Library.

Mon, 01 Jan 0001 00:00:00 +0000

Политика определяет правила версионирования для спецификации, core API и проектных репозиториев.

Spec Version - версия текущей спецификации.
Core API Version - версия runtime-контракта между клиентами и core.
Project Version - версия конкретного репозитория/пакета (core, cli, другие клиенты).

Для всех доменов версий ДОЛЖНА использоваться схема Semantic Versioning: MAJOR.MINOR.PATCH.

Клиенты ДОЛЖНЫ объявлять поддерживаемый диапазон Core API Version.
Core runtime ДОЛЖЕН отдавать текущую Core API Version.
При старте/handshake совместимость client-core ДОЛЖНА проверяться до выполнения обычных операций.
Несовместимые версии ДОЛЖНЫ завершаться явной ошибкой совместимости.

Spec Version МОЖЕТ развиваться независимо от версий проектных пакетов.
Breaking-изменения core-контракта в спецификации РЕКОМЕНДУЕТСЯ сопровождать повышением major-версии и Spec Version, и Core API Version.
Версии проектных пакетов МОГУТ следовать собственному релизному ритму, но НЕ ДОЛЖНЫ обходить проверки API-совместимости.