Отзывы и достижения на витрине

Зачем нужно

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

Этот документ описывает публичную модель отображения. Он не задает финальную систему сбора отзывов, юридических согласий или аналитики качества.

Основные сущности

Витрина должна различать:

• отзыв о человеке;
• отзыв о продукте;
• отзыв об организации;
• отзыв о событии или олимпиаде;
• личное достижение человека;
• достижение ученика;
• достижение команды;
• достижение продукта;
• организационный факт или метрику.

Одна запись может быть связана с несколькими объектами, но исходная привязка должна сохраняться.

Отзыв

Отзыв должен хранить:

• автора или публичную подпись автора;
• тип автора: ученик, родитель, выпускник, партнер, другой тип;
• текст;
• оценку, если есть;
• дату или период;
• язык;
• исходную привязку;
• разрешенные публичные места показа;
• статус модерации;
• признак верификации;
• согласие на публикацию, если требуется.

Публичная подпись автора может быть полной, сокращенной или обезличенной. Витрина не должна раскрывать персональные данные без разрешения.

Рейтинг

Рейтинг является агрегатом, а не ручным числом.

Для каждого агрегата нужно определить:

• какие отзывы входят в расчет;
• за какой период;
• какие статусы учитываются;
• учитываются ли отзывы без оценки;
• можно ли исключать отзыв вручную;
• как округляется средняя оценка;
• где показывается количество отзывов.

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

Достижение

Достижение — это публично проверяемое утверждение о результате, опыте или признании.

Типы достижений:

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

Достижение должно хранить:

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

Достижения учеников

Достижение ученика может быть показано:

• на странице преподавателя;
• на странице продукта;
• на лендинге направления;
• в блоке фактов организации;
• на публичном профиле ученика или выпускника, если такой профиль опубликован.

Связь достижения с преподавателем должна быть явной. Если ученик занимался у нескольких преподавателей, витрина должна позволять указать несколько связей или оставить достижение на уровне продукта/организации.

Модерация

Отзывы и достижения должны проходить статусы:

• черновик;
• на проверке;
• опубликовано;
• скрыто;
• отклонено;
• архивировано.

Для публичной витрины нужны причины скрытия:

• нет согласия;
• устарело;
• требует проверки;
• содержит персональные данные;
• дубль;
• не относится к странице.

Места показа

Одна запись может показываться в разных местах:

• карточка человека;
• страница человека;
• карточка продукта;
• лендинг продукта;
• лендинг направления;
• главная страница;
• блок достижений;
• публичный профиль;
• страница олимпиады.

Показ должен управляться не только связью с объектом, но и разрешенными местами отображения. Это нужно, чтобы отзыв о продукте не появлялся в неподходящем контексте автоматически.

Правила

• Отзыв о продукте не равен отзыву о преподавателе.
• Рейтинг не должен быть ручным полем без правил расчета.
• Достижение должно иметь субъект и период.
• Публичное отображение не должно раскрывать PII без согласия.
• Витрина может агрегировать отзывы и достижения, но не должна терять исходную привязку.