Перейти к основному содержимому

Карта доменов

Зачем нужно

Документ задаёт каноническое разбиение экосистемы на 7 доменов, фиксирует границы между ними и правила, по которым новая сущность относится к одному из доменов.

7 доменов

identity

Аккаунты, профили, контакты, преподавательские анкеты educator_profile, аутентификация, сессии, refresh token rotation, OAuth/OIDC authorization server, RBAC, семьи, детские аккаунты, делегированные сессии, организации, команды, приглашения, методы входа, устройства, безопасность, аудит входа.

storefront

Публичная витрина: каталог продуктов, лендинги направлений, форматов, продуктов, олимпиад, кампаний, публичные профили людей и команд, отзывы, факты, публичная проекция дорожной карты, формы заявок, SEO, перенаправления.

crm

Клиентская карточка, контакты клиента, лиды, сделки, заказы, счета, платежи, возвраты, баланс, entitlements (права доступа в lms/competitions/task-bank), обращения support, заметки, история взаимодействий, выплаты преподавателям.

lms

Курсы, версии курсов, дерево учебных узлов, уроки, контент-блоки, активности, домашние задания, попытки и сабмишны, обратная связь, тетради, проекты, чат с преподавателем, онбординг, Learning Workspace (learning_workspace, learning_group, learning_group_participant), дорожная карта (roadmap_program, roadmap_module, roadmap_topic, topic_pathway, mini_group_track, topic_progress, topic_completion, topic_enrichment), занятия (group, session, attendance, schedule_rule, session_topic_link, session_lesson_link, makeup_assignment), запись на занятия и календарь, инструменты внутреннего преподавателя, геймификация (xp, badge, streak).

task-bank

Задачи (problem), версии (problem_version), таксономия (taxonomy_node), связи (problem_relation), варианты, наборы (problem_set), activity templates, program templates, public eligibility/projection metadata, content export snapshots, решения и подсказки, проверка ответов (answer_check), использование (problem_usage), low-level check attempts (problem_attempt), problem-level evidence.

competitions

Олимпиады (competition_event), сезоны, туры, треки, площадки, регистрации, участники (в т.ч. без аккаунта), олимпиадные группы, доступ к работам, tour activity bindings, task structure для результата, submission refs, score snapshots, результаты, публикации, наградные документы.

management

Метрики, dashboards, ingestion, data quality, цели (goal, goal_milestone, goal_evidence, goal_criterion), диагностика (diagnostic_session, diagnostic_result), рекомендации (recommendation), план команд, задачи команд (внутренние, не учебные), управленческие действия и audit.

Reference-слой

Reference-данные subject, level, format, grade_range принадлежат platform/reference-data и доступны всем доменам через единый справочник. Это не отдельный 8-й домен.

Границы и связи

ЛинияИсточник истиныЧто передаётсяДокумент
identity → все доменыidentityпользователь, роли, actor context, OAuth tokens, family/organization scopes, educator_profileintegrations/identity--all.md
storefront → crmstorefrontлиды из формintegrations/storefront--crm.md
crm → lmscrmentitlements, активация и отзыв учебного доступаintegrations/crm--lms.md
crm → competitionscrmentitlements на участие в олимпиадеintegrations/crm--competitions.md
lms → crmlmsфакты потребления entitlement (списания)integrations/lms--crm.md
lms → storefrontlmsпубличная проекция дорожной карты, фактыintegrations/lms--storefront.md
lms → managementlmsучебные факты, прогресс, evidenceintegrations/lms--management.md
task-bank → lmstask-bankзадачи, версии, activity/program snapshots для уроков, домашек, тренажёров и программintegrations/task-bank--lms.md
task-bank → competitionstask-bankproblem set/activity snapshots and source refs для tour activity bindingintegrations/task-bank--competitions.md
task-bank → storefronttask-bankpublic-safe catalog projectionintegrations/task-bank--storefront.md
competitions → managementcompetitionsрезультаты, участиеintegrations/competitions--management.md
crm → managementcrmфинансовые и операционные агрегатыintegrations/crm--management.md
storefront → managementstorefrontпубличные метрики, формыintegrations/storefront--management.md

Полная матрица — в integrations/README.md.

Правила отнесения новой сущности

  1. Если сущность описывает учётку, доступ, профиль доверия или контекст действия — это identity.
  2. Если сущность отображается публично без авторизации — это либо storefront (только если это read-model), либо это сущность другого домена, у которого есть публичная проекция.
  3. Если сущность связана с деньгами, продажей, заказом или правом доступа — это crm.
  4. Если сущность учебная (контент, прогресс, занятие, тема, тетрадь, чат с преподавателем, геймификация) — это lms.
  5. Если сущность — это задача, её версия, методическая задачная activity/program template, relation, grouped content snapshot, usage, low-level checking artifact или problem-level evidence — это task-bank.
  6. Если сущность связана с олимпиадой как событием (тур, регистрация, награда) — это competitions.
  7. Если сущность — управленческая (метрика, dashboard, цель, рекомендация, диагностика, план, внутренняя задача команды) — это management.
  8. Если сущность не подходит ни в один домен и не является reference-данными — пересмотреть формулировку или открыть ADR.

Отдельные уточнения по ADR-038:

  • Learning Workspace, learning_group и learning_group_participant относятся к lms, даже если внутри них видны олимпиады, тренажёры или семейная коммуникация.
  • educator_profile относится к identity, но не выдаёт прав.
  • organization_student относится к identity и означает официальную или подтверждённую запись ученика в организации, а не всех рабочих учеников преподавателя.
  • Площадка относится к competitions, но в пользовательском интерфейсе открывается как подслой выбранной организации внутри Learning Workspace.

Что не является отдельным доменом

  • Reference-слой (subject, level, format, grade_range) — это platform/reference-data.
  • API-конвенции, шина событий, observability, UI-система — это platform/.
  • Архитектурные решения с обоснованиями — это decisions/.
  • Learning Workspace — это рабочий слой внутри lms, а не 8-й домен.
  • Миролимп/MeraLink — продуктовая и историческая реализация task-bank, а не отдельный technical domain.