Пять звёзд и одна единица дают среднее 3,0 — но только если обе оценки входят в один и тот же набор и имеют одинаковый вес. На реальном сайте часть отзывов скрыта модерацией, привязана к вариантам, пришла из внешнего источника или была удалена, а агрегат обновился не полностью.
Не начинайте с правки округления в интерфейсе. Сначала получите список конкретных review_id, которые должны участвовать в рейтинге, и воспроизведите результат простой формулой. Если набор отличается, проблема находится до вычисления среднего.
Опишите правило одним предложением
Например: рейтинг карточки — среднее всех опубликованных оценок 1–5 для товара и его активных вариантов, без ответов продавца и без импортов, помеченных как недоверенные.
Это лишь условный вариант. Ваше правило может учитывать подтверждённую покупку, давность или полезность, но вес должен быть прозрачен и воспроизводим. Нельзя называть число «средней оценкой», если оно рассчитано закрытой ранжирующей моделью без объяснения.
Сверьте числитель, знаменатель и фильтры
| Проверка | Типичная ошибка |
|---|---|
| COUNT отзывов | В знаменателе остались скрытые записи |
| SUM оценок | Удалённый отзыв вычтен из count, но не из sum |
| Варианты товара | Один SKU агрегируется дважды через две связи |
| Импорт | Внешний рейтинг добавлен как среднее, а не как сумма и число голосов |
| Округление | Каждая группа округлена до объединения |
Для объединения агрегатов нужны сумма оценок и количество, а не среднее каждого источника. Среднее из 100 отзывов нельзя усреднять на равных со средним из двух.
Малый пример ловит ошибку быстрее production-дампа
Отзывы: 5, 5, 4, 1 (скрыт)
Публичный набор: 5, 5, 4
Сумма: 14
Количество: 3
Среднее до отображения: 4.666...
Показ на карточке по правилу до десятых: 4.7Создайте такие данные через обычный API, затем скройте, восстановите и удалите один отзыв. После каждого шага сравните source rows, aggregate table, кеш API и HTML. Это показывает, где перестал обновляться расчёт.
Кеш должен знать версию агрегата
Даже правильная база не поможет, если карточка читает старый кеш. Инвалидацию нужно запускать при публикации, скрытии, переносе на другой товар и изменении оценки. Для очереди сохраните product_id и новую aggregate_version; повтор события не должен дважды менять сумму.
- Пересчёт из исходных отзывов служит контрольным эталоном.
- Инкрементальное обновление ускоряет работу, но проверяется периодической сверкой.
- UI показывает число отзывов из того же набора, что и рейтинг.
- Structured data использует тот же опубликованный агрегат, а не отдельную формулу.
Что делать с историческими расхождениями
Сделайте read-only сверку для всех товаров: сохранённые sum/count против пересчёта по исходным строкам. Исправляйте только несовпадающие записи и записывайте причину. Если правило рейтинга меняется, версионируйте его и пересчитайте весь каталог одинаково.
Материалы для разбора
Нужны схема статусов отзывов, формула, обезличенная выборка одного товара и значения на слоях база–API–страница. Тексты отзывов и данные покупателей для диагностики арифметики не нужны.