Модель данных

Зачем нужно

Документ собирает каноническую модель task-bank: задачи, версии, условия, решения, подсказки, таксономия, подборки, варианты, usage, low-level check attempts, checking и evidence.

Правила модели

• problem задаёт стабильную идентичность задачи.
• problem_version задаёт воспроизводимое содержимое, которое видел ученик.
• Published version не редактируется.
• Answer schema, key, solution и rubric версионируются вместе с problem version.
• Usage хранит snapshot правил использования, чтобы соседний домен не зависел от будущих изменений.
• Grouped export хранится в content_export_snapshot, если во внешний домен передаётся set, activity template или program template.
• Attempt и result всегда ссылаются на конкретную version.
• Raw answer не публикуется в событиях и не нужен для внешней аналитики.
• Activity/program templates не содержат roster, enrollment, schedule, attendance или business attempts.
• Public catalog работает через public-safe projection and publication profile, а не через отдельную базу задач.

Subject and publication

subject

First-class ссылка на предметную область. Канонический справочник subject принадлежит platform reference layer; task-bank хранит subject_key and local validation/projection settings, необходимые для задач, taxonomy and checking.

Поле	Назначение
key	platform subject key: mathematics, physics, informatics, etc.
title	человекочитаемое название
status	active, hidden, archived
default_locale	язык по умолчанию
metadata	subject-specific настройки

Инварианты:

• problem.subject_key обязателен и ссылается на platform reference data;
• taxonomy для тем и источников subject-aware;
• answer schema и checking rules должны поддерживать subject-specific validators.

problem_publication_profile

Профиль публичной пригодности задачи для каталога.

Поле	Назначение
problem_id	задача
public_status	draft, candidate, ready, published, hidden, embargoed
public_after_date	отложенная публикация
canonical_public_url	/tasks/<taskId>
primary_topic_id	основная тема для breadcrumbs and SEO
public_solution_policy	show, show_after_attempt, show_after_date, hide, teacher_only
license_status	allowed, restricted, unknown, forbidden
seo_title_override	необязательное переопределение
seo_description_override	необязательное переопределение
quality_score	пригодность для каталога

Инварианты:

• public task имеет ровно один primary topic;
• canonical URL задачи не зависит от topic/source path;
• public projection не раскрывает answer key без explicit policy.

Problem core

problem

Каноническая задача.

Поле	Назначение
code	стабильный человекочитаемый код
subject_key	предмет
status	draft, review, published, archived, retired
default_difficulty	базовый уровень
source_ref	источник или миграция

problem_version

Версия задачи.

Поле	Назначение
problem_id	задача
version	номер
status	draft, review, published, retired
statement	условие
answer_schema	формат ответа
metadata	сложность, время, ограничения
visibility	правила показа решения/подсказок

problem_asset

Медиа и вложения: изображение, PDF, интерактив, исходный файл, diagram.

problem_solution

Эталонное решение.

Типы:

• short_answer;
• full_solution;
• step_by_step;
• teacher_notes;
• rubric_explanation.

problem_hint

Подсказка с уровнем раскрытия и visibility rule.

Answer model

answer_schema

Формат ответа:

• exact value;
• numeric with tolerance;
• multiple choice;
• multiple select;
• text normalized;
• expression;
• unit value;
• file upload;
• proof/free text;
• composite answer.
• manual review required.

Для физики и будущих предметов numeric_with_tolerance, unit_value, composite_answer, free_text, proof и manual_review_required являются first-class cases, а не исключениями поверх математического short answer.

answer_key

Эталонный ответ или набор допустимых ответов.

checking_rule

Правило проверки: deterministic, manual, hybrid, external checker.

scoring_rule

Баллы, partial credit, penalties, hint penalty, attempt limits.

rubric

Критерии ручной проверки.

Taxonomy

taxonomy_node

Справочник темы, навыка, типа, источника, уровня или класса. Узлы могут быть subject-specific.

problem_taxonomy_link

Связь задачи с taxonomy node и весом.

Для published/public задачи нужен один primary topic. Secondary topics разрешены, но публичный UI может показывать их collapsed. Source hierarchy может храниться как taxonomy_node(type='source') с parent path или позднее выделиться в отдельный source_node.

Problem relations

problem_relation

Единая модель методических и редакторских связей между задачами.

Type	Семантика	Направленность
duplicate	фактически та же задача или дубль записи	symmetric
analog	та же задача с непринципиальными изменениями: числа, имена, декорации	symmetric
parameterized_variant	вариант из общей параметрической схемы	symmetric or generated_from
set_variant	A/B вариант в рамках набора или тура	context-bound
similar	похожая задача для рекомендаций, не editorial identity	symmetric, often generated
prerequisite	A полезно решить до B	directed
same_method	решается тем же методом	symmetric

Поле	Назначение
from_problem_id	исходная задача
to_problem_id	связанная задача
relation_type	тип связи
status	suggested, confirmed, rejected, hidden
weight	сила связи
created_by_user_id	автор
reviewed_by_user_id	модератор
metadata	обоснование, метод, источник

Инварианты:

• no self-link;
• prerequisite directed and acyclic;
• generated similar не становится analog без editorial confirmation;
• variant не используется как общий термин для duplicate/analog/similar/prerequisite.

Sets, variants, usage

problem_set

Подборка задач.

Purpose: homework, lesson, competition, diagnostic, training, manual.

problem_set является простой подборкой или collection. Он не должен подменять полноценный сценарий занятия (activity_template) или программу (program_template).

Access policy may reference identity organization context:

• identity_organization_id;
• organization_team_id;
• organization_permission_grant;
• identity_user_id для автора или персонального доступа.

Ownership rule: problem_set / collection belongs to task-bank. organization, organization_team, membership and grants belong to identity.

problem_set_item

Позиция задачи в подборке с version policy.

problem_variant

Параметризованный вариант задачи или вариант комплекта: A/B, класс, параллель, тур. Редакционные связи duplicate, analog, similar, prerequisite живут в problem_relation, а не смешиваются в problem_variant.

Activity templates

activity_template

Шаблон задачной активности.

Примеры:

• lesson;
• circle lesson;
• homework;
• trainer;
• diagnostic;
• competition round design;
• review session;
• intensive session.

Поле	Назначение
subject_key	предмет
title	название
activity_type	lesson, homework, trainer, diagnostic, competition_round, review, intensive
status	draft, review, approved, published, archived, retired
age_group	классы/возраст
difficulty_range	диапазон сложности
duration_minutes	рекомендуемая длительность
primary_topic_id	основная тема
objective	методическая цель
teacher_notes	заметки преподавателю
student_intro	вводный текст ученику
visibility	private, organization, public
owner_user_id	автор
identity_organization_id	организация-владелец, если есть
version	версия шаблона

Инварианты:

• activity template не содержит LMS group, roster, schedule, attendance или assignment;
• published template immutable или versioned;
• export во внешний домен идёт через content_export_snapshot.

activity_template_section

Блок внутри активности.

Section roles:

• warmup;
• theory_bridge;
• main;
• practice;
• homework;
• challenge;
• reserve;
• reflection;
• diagnostic.

Поле	Назначение
activity_template_id	шаблон
title	название блока
section_role	роль блока
order	порядок
duration_minutes	рекомендуемое время
teacher_notes	комментарии преподавателю
student_instructions	инструкции ученику

activity_template_item

Элемент активности, чаще всего problem version.

Поле	Назначение
activity_template_id	шаблон
section_id	блок
problem_id	задача
problem_version_id	version lock или null при version policy
problem_set_item_id	если элемент пришёл из подборки
order	порядок
role	main, warmup, reserve, homework, challenge, diagnostic, example
required	обязательный или optional
recommended_time_minutes	время
recommended_points	баллы
checking_mode	auto, manual, hybrid, none
solution_visibility_policy	когда показывать решение
hint_policy	правила подсказок
teacher_comment	комментарий преподавателю
student_comment	комментарий ученику

Program templates

program_template

Программа, трек или курсоподобная структура из активностей.

Примеры:

• “Олимпиадная математика 3–4 класс, годовая программа”;
• “Физика 7 класс, стартовый интенсив”;
• “Подготовка к турниру, 12 занятий”;
• “32 занятия первого трека и 32 занятия второго трека”.

Поле	Назначение
subject_key	предмет
title	название
program_type	circle, course_content, intensive, competition_prep, trainer_path
status	draft, review, approved, published, archived, retired
age_group	классы/возраст
duration_units	количество занятий/модулей
objective	цель
visibility	private, organization, public
owner_user_id	автор
identity_organization_id	организация-владелец
version	версия

Инвариант: program template не содержит enrollment, schedule, teacher assignment или course progress.

program_track

Траектория внутри программы: базовый, продвинутый, трек 1, трек 2.

program_activity_link

Связь program/track с activity templates.

Поле	Назначение
program_template_id	программа
program_track_id	трек
activity_template_id	активность
order	номер занятия
module_label	модуль
required	обязательное или optional
replacement_group_id	группа заменяемых активностей
prerequisite_activity_id	prerequisite activity

Export snapshots

content_export_snapshot

Зафиксированная передача problem_set, activity_template или program_template во внешний домен.

Поле	Назначение
source_type	problem_set, activity_template, program_template
source_id	id исходного объекта
source_version	версия исходного объекта
target_domain	lms, competitions, storefront, management, manual
target_type	lesson, homework, training, tour, public_catalog, diagnostic
target_id	внешний id, если уже есть
status	draft, exported, locked, active, retired, failed
exported_by_user_id	кто экспортировал
locked_at	момент фиксации
payload_hash	контроль целостности
payload	immutable content payload или secure refs
metadata	target-specific details

Snapshot фиксирует:

• problem ids and problem version ids;
• order, roles and sections;
• answer schema references;
• scoring snapshot;
• visibility policy snapshot;
• solution/hint policy snapshot;
• teacher/student comments, если разрешены;
• source lineage.

Инварианты:

• locked snapshot immutable;
• external domains не зависят от mutable draft;
• snapshot не раскрывает answer key потребителям без соответствующего scope/policy.

problem_usage

Явная связь task-bank с внешним контекстом.

Поле	Назначение
problem_version_id	какая версия используется
context_domain	lms, competitions, management, storefront, manual
context_type	lesson, homework, tour, training
context_id	внешний id
status	draft, active, locked, suspended, archived
scoring_rule_snapshot	правила на момент usage
visibility_policy	когда показывать решения и результаты

problem_usage остаётся per-problem связью. Для grouped export подборки, activity template или program template используется content_export_snapshot, который может создавать или ссылаться на набор problem_usage records.

Attempts and checking

problem_attempt

Low-level попытка проверки конкретной задачи. Она не заменяет lms_activity_attempt, learning_training_attempt, competition_submission или competition_result.

Поле	Назначение
problem_usage_id	контекст
problem_version_id	версия
identity_user_id	ученик
status	started, submitted, checking, checked, cancelled, void
answer	raw answer
submitted_at	время отправки

answer_check

Результат проверки.

Поле	Назначение
attempt_id	попытка
method	auto, manual, hybrid, external
status	pending, checked, needs_manual_review, failed, overridden
is_correct	true/false/null
score	балл
max_score	максимум
feedback	безопасный feedback
checked_by_user_id	проверяющий

manual_review

Очередь и решение ручной проверки.

Evidence

problem_evidence

Нормализованный низкоуровневый signal:

• attempted;
• solved;
• partially solved;
• failed;
• solved with hint;
• needs review;
• repeated difficulty.

Evidence содержит subject/topic/skill links, но не делает вывод mastery.

Audit

task_bank_audit_log

Аудит публикации, изменения answer key, visibility, manual override, import/export и доступа к solution.