Архитектурные решения (ADR)

Зачем нужно

ADR фиксируют неочевидные решения экосистемы. Без ADR будущая команда переоткроет уже закрытые вопросы. Каждое решение — самостоятельный документ.

Структура

Каждый ADR живёт в adr/NNN-<slug>.md. Шаблон — в ../templates/adr.md.

Жизненный цикл

Статус	Значение
proposed	предложен, обсуждается
accepted	принят, обязателен к соблюдению
superseded	заменён другим ADR
deprecated	устарел

Каталог

№	Заголовок	Статус	Затронутые домены
001	Эталонный слой	superseded → ADR-026	platform
002	Публичная и авторизованная проекции дорожной карты	accepted	lms, storefront
003	Тема не равна уроку	accepted	lms
004	Mini-group track как частный случай pathway	accepted	lms
005	Геймификация не равна завершению	accepted	lms
006	Цель не равна дорожной карте и продукту	superseded → ADR-027	management
007	Иерархическая структура LMS	accepted	lms
008	LMS-прогресс отделён от прогресса по теме	accepted	lms
009	Занятие не равно уроку LMS	accepted	lms
010	Посещаемость не равна освоению	accepted	lms
011	Связь занятия с темой явная	accepted	lms
012	Банк задач владеет задачами	accepted	task-bank, lms, competitions
013	Использование задачи — отдельная сущность	accepted	task-bank
014	Продукт не равен группе и программе	accepted	crm, lms
015	Витрина — это read-model	accepted	storefront
016	Пользователь не равен роли	accepted	identity
017	Контекст действия не равен подмене пользователя	accepted	identity
018	Семья не равна организации	accepted	identity
019	Источник истины назначается по доменам	accepted	все
020	Репозиторий канонический, Drive — зеркало	deprecated	platform
021	Миграция идёт по доменам	accepted	все
022	Взрослый видит детей семьи	accepted	identity, lms, crm
023	Человек и контекстные роли на витрине	accepted	storefront
024	Олимпиады — отдельный домен	accepted	competitions
025	Семидоменная декомпозиция	accepted	все
026	Reference-данные принадлежат платформе	accepted	platform
027	Цели, рекомендации, диагностика — management	accepted	management, lms
028	Геймификация — lms	accepted	lms
029	Дорожная карта — lms	accepted	lms, storefront, management
030	Граница entitlement (crm) и attendance (lms)	accepted	crm, lms
031	Участник олимпиады без identity и claim-доступ	accepted	competitions, identity
032	NATS JetStream как стартовая шина событий	accepted	platform
033	JWT access token profile	accepted	platform, identity
034	Tenant context не является отдельным tenant-id	accepted	все
035	Platform runtime capabilities заменяют ADR-020	accepted	platform
036	Student profile является учебным субъектом	accepted	identity, lms, competitions
037	Organization access layer belongs to identity	accepted	identity, competitions, task-bank, crm, management
038	Learning Workspace и преподавательский контекст	accepted	identity, lms, competitions, task-bank, crm, management
039	Миролимп владеет задачным контентом и шаблонами активностей	proposed	task-bank, lms, competitions, identity, storefront, management

Правила

• Не менять принятый ADR; вместо этого создавать новый со ссылкой supersedes.
• Один ADR — одно решение.
• ADR ссылается на затронутые домены и платформенные документы.
• ADR — текст на русском (за исключением имён сущностей, API, библиотек).
• Новые ADR с порядковым номером 031+.