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

Домен витрины

Зачем нужно​

Домен витрины описывает публичное отображение данных на сайте «Систематики».

Витрина является read-model и не должна становиться каноническим владельцем учебных, продуктовых, пользовательских, олимпиадных или операционных сущностей.

Для олимпиад витрина показывает только public projections после publication: сезоны, площадки, опубликованные результаты и документы. Она не получает Learning Workspace groups, списки «мои ученики», raw submissions или закрытые результаты.

Документы домена​

  • scope.md — акторы, зоны ответственности, соседние домены и запреты.
  • data-model.md — канонические сущности: pages, blocks, catalog, profiles, reviews, facts, campaigns, forms, SEO.
  • database-schema.md — PostgreSQL DDL, индексы, constraints, moderation и audit.
  • state-machines.md — lifecycle страниц, версий, каталога, профилей, отзывов, фактов, форм и redirects.
  • api-map.md — public/admin endpoints, permissions и error codes.
  • api-contracts.md — DTO, validation и response schemas.
  • permissions-matrix.md — endpoint/action → permission → scope → audit и consent gates.
  • events.md — входящие read-model updates, исходящие события, payloads, идемпотентность и retention.
  • integrations.md — связи с новым слоем integrations/*.md.
  • user-flows.md — пользовательские и административные сценарии.
  • screen-spec.md — public/admin screens, состояния, фильтры, actions и publish checklist.
  • security.md — PII, consent, SEO, forms и moderation security.
  • test-plan.md — unit, integration, e2e, security, SEO и moderation tests.
  • features/catalog.md — публичный каталог, навигация, фильтры и витринные подборки.
  • features/landing-pages.md — лендинги направлений, форматов, продуктов, олимпиад, событий и кампаний.
  • features/teachers-team.md — публичные профили людей, преподаватели, команды продуктов, отделы и комитеты олимпиад.
  • features/reviews-achievements.md — отзывы, рейтинги, достижения людей, учеников, продуктов и организации.
  • features/roadmap.md — публичная проекция дорожной карты без подмены канонического LMS roadmap.
  • features/public-profiles.md — публичные страницы людей, учеников, выпускников, команд и организаций.
  • features/facts.md — проверяемые факты, числа, бейджи, статистика и доказательная база витрины.

Реестры​

В активной 7-доменной модели источниками истины являются data-model.md, ecosystem/ownership.md и ecosystem/glossary.md.

Архитектурные решения​

  • ../../decisions/adr/015-storefront-is-read-model.md
  • ../../decisions/adr/023-person-and-contextual-storefront-roles.md

Как читать​

Для задач по витрине сначала читать:

  1. ../../workflow/ai-context.md.
  2. ../../ecosystem/ownership.md.
  3. data-model.md.
  4. Нужный документ домена.

Ближайшие зоны проектирования​

  • финальная CMS-модель витринных страниц и блоков;
  • SEO-структура публичных страниц;
  • правила агрегации рейтингов, отзывов, достижений и фактов;
  • правила public projections для олимпиадных сезонов, площадок и результатов;
  • модерация пользовательского и публичного контента;
  • правила персонализации авторизованной витрины.

Канон документов​

Каждый домен целевой модели ведётся в 15-файловом каноне: overview.md, scope.md, data-model.md, database-schema.md, state-machines.md, api-map.md, api-contracts.md, permissions-matrix.md, events.md, integrations.md, user-flows.md, screen-spec.md, security.md, test-plan.md, acceptance.md, а детальные возможности лежат в features/*.md.