top-3-service

Top3Service

Спільний модуль family-application-api для Top 3 операторів Family.

Задача

1. За кожен із трьох останніх місяців підсумувати sum FamilyStatisticsRelation за operatorId.
2. Відсортувати операторів за сумою та повернути перші три місця.
3. Додати ім’я й nickname оператора зі Stack.

Frontend API

№	Операція	Endpoint
1	Top 3 операторів за поточний і два попередні місяці	GET /families/{family}/top-3

Один місяць повертає month і operators[]. Оператор містить operatorId, name, nickname та sum.

Рейтинг будується для всієї Family. Оператор, supervisor і top manager бачать той самий результат.

Поточна реалізація

Family	Top 3
Golden	✅
Prime	—
Chathouse	✅
Udate	✅

Golden, Chathouse та Udate вже використовують однаковий розрахунок зі statistics relations. У Prime гілка запиту існує, але результат не розраховується.

У Family-сервісах цю логіку повторювати не потрібно: після імпорту FamilyStatisticsRelation Top3Service працює для будь-якої Family.

Сезонний рейтинг за виконаними цілями нових пар описаний окремо в NewYearTopListService.