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

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

Зачем нужно​

Документ описывает каноническую модель управленческого контура: метрики, dashboards, планы, задачи, alerts, цели, рекомендации, диагностики, качество данных и управленческие действия.

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

  • Каждая сущность имеет id, created_at, updated_at, если явно не указано иначе.
  • Ссылки на соседние домены хранятся как source_domain, source_type, source_id.
  • Плановые и фактические данные хранятся отдельно.
  • Персональные данные не копируются из соседних доменов.
  • Метрики версионируются при изменении формулы.
  • Изменения прав, формул, dashboard publication и управленческих действий аудируются.

Метрики​

management_metric​

Определение метрики.

ПолеНазначение
keyстабильный машинный ключ
titleчеловекочитаемое название
descriptionчто измеряет метрика
ownerответственный владелец
source_domainосновной источник
formulaформула или ссылка на вычислитель
grainday, week, month, quarter, year
unitcount, rub, percent, minutes, score
sensitivity_levelpublic, internal, financial, personal, restricted
statusdraft, active, deprecated, archived

management_metric_version​

Версия определения метрики. Нужна, чтобы исторические значения были объяснимыми после изменения формулы.

ПолеНазначение
metric_idметрика
versionномер версии
formulaформула на момент версии
source_contractожидаемый контракт источника
valid_from, valid_toпериод действия версии

management_metric_value​

Рассчитанное значение.

ПолеНазначение
metric_idметрика
metric_version_idверсия формулы
period_start, period_endпериод расчёта
segmentJSON-сегмент: продукт, предмет, канал, организация
valueчисловое значение
quality_statuscomplete, partial, stale, failed
calculated_atвремя расчёта

Dashboards​

management_dashboard​

Панель показателей.

ПолеНазначение
slugстабильный URL-key
titleназвание
audienceexecutive, product, operations, finance, education, custom
statusdraft, review, published, archived
default_periodпериод по умолчанию
visibility_ruleправило видимости

management_dashboard_widget​

Виджет dashboard.

ПолеНазначение
dashboard_iddashboard
typekpi, line_chart, bar_chart, table, funnel, alert_list, markdown
metric_keyключ метрики
positionпорядок
configнастройки графика, осей, цветов и drill-down

management_saved_view​

Сохранённый пользовательский вид dashboard: фильтры, период, сегменты.

Goals, recommendations and diagnostics​

Management владеет целями, рекомендациями и диагностическими выводами по ADR-027. Эти сущности могут ссылаться на LMS, task-bank, CRM и competitions, но не становятся их источником истины.

goal_profile​

Профиль целей ученика, семьи, группы или организации.

ПолеНазначение
owner_type, owner_idученик, семья, группа, организация
statusdraft, active, paused, archived, cancelled
contextбезопасный контекст: возраст, направление, ограничения

goal​

Цель обучения или развития.

Поля: goal_profile_id, title, type, priority, status, target_date, source, is_system_hypothesis, activated_at.

source: family, student, teacher, advisor, manager, system_hypothesis, import.

Правило: source = system_hypothesis или is_system_hypothesis = true не может молча заменить active goal с source in (family, student, teacher, advisor). Такая запись используется как recommendation/draft до явного принятия.

goal_milestone​

Промежуточная веха цели.

Поля: goal_id, title, target_value, due_at, status.

goal_owner​

Ответственный за цель: ученик, родитель, преподаватель, менеджер или команда.

goal_subject​

Связь цели с предметом, направлением, roadmap topic или внешним контекстом.

goal_criterion​

Измеримое правило достижения цели.

Поля: goal_id, metric_key, operator, target_value, evidence_policy.

goal_evidence​

Evidence, использованный для объяснения статуса цели.

Поля: goal_id, source_domain, source_type, source_id, weight, captured_at.

goal_review​

Ручной или автоматический пересмотр цели.

Поля: goal_id, reviewer_user_id, decision, comment, reviewed_at.

recommendation​

Управленческая или учебная рекомендация.

Поля: goal_profile_id, goal_id, type, status, reason, confidence, source_model, created_at.

recommendation_action​

Действие по рекомендации: принять, отложить, отклонить, создать задачу, открыть продукт, назначить диагностику.

diagnostic_session​

Запуск диагностики.

Поля: goal_profile_id, student_profile_id, source_domain, status, scheduled_at, completed_at.

diagnostic_result​

Результат диагностики.

Поля: diagnostic_session_id, summary, scores, strengths, risks, recommended_goal_refs.

Планирование​

management_plan​

Управленческий план.

ПолеНазначение
titleназвание
typesales, learning, operations, finance, staffing, product_launch
owner_user_idвладелец
period_start, period_endпериод
statusdraft, review, approved, active, closed, archived, cancelled
scopeсегмент плана

management_plan_target​

Цель плана.

ПолеНазначение
plan_idплан
metric_idцелевая метрика
target_valueплановое значение
comparison_operatorgte, lte, eq, range
segmentсегмент цели

management_plan_fact​

Снимок фактического исполнения цели.

ПолеНазначение
target_idцель
metric_value_idфактическое значение
varianceотклонение
statuson_track, at_risk, off_track, unknown

Задачи​

management_task​

Внутренняя рабочая задача.

ПолеНазначение
titleназвание
descriptionописание
statustodo, in_progress, blocked, review, done, cancelled
prioritylow, normal, high, urgent
assignee_user_idисполнитель
reporter_user_idпостановщик
due_atдедлайн
source_domain, source_type, source_idсвязанный объект

management_task_comment​

Комментарий к задаче.

management_task_history​

История изменений задачи: статус, исполнитель, дедлайн, приоритет, связанный объект.

management_task_template​

Шаблон задачи для alerts, workflows и повторяющихся процессов.

Alerts​

management_alert_rule​

Правило предупреждения.

ПолеНазначение
metric_idметрика
conditionусловие срабатывания
severityinfo, warning, critical
deduplication_key_templateключ идемпотентности
task_template_idшаблон задачи, если нужно создать задачу
statusdraft, active, paused, archived

management_alert​

Сработавшее предупреждение.

ПолеНазначение
rule_idправило
statusopen, acknowledged, resolved, dismissed
severityитоговая серьёзность
payloadбезопасный контекст
opened_at, resolved_atвремена

Качество данных​

management_data_source​

Источник данных: домен, поток событий, snapshot API или read-model.

management_ingestion_run​

Запуск загрузки или пересчёта.

management_data_quality_issue​

Проблема качества данных: задержка, ошибка схемы, неполные данные, расхождение источников.

Управленческие действия​

management_action​

Действие, запущенное из dashboard, alert, task или plan.

Примеры:

  • создать задачу;
  • запросить пересчёт метрики;
  • отправить отчёт;
  • запустить согласование плана;
  • создать escalation.

Действие не должно менять исходный домен напрямую, если у исходного домена нет явного command API.

Audit​

management_audit_log​

Аудит действий в management: actor, action, entity, before/after, reason, request id.