project-favorite-service

ProjectFavoriteService

Сервіс, який перетворює платну активність конкретного проєкту у ProjectFavorite.

Задача

1. Визначити TU, RU, час і вид платної дії у даних проєкту.
2. Без дублювання створити або оновити пару TU + RU.
3. Оновити firstPaidAt, lastPaidAt, profit і gifts.
4. Оновити blockedByRU, коли проєкт повертає стан блокування у діалозі або окремому списку.
5. Після успішного запису опублікувати малу подію ProjectFavoriteChanged з project і ruId.

Джерела

Проєкт	Створення й оновлення favorite	Результат
Golden	Оперативна й денна статистика з RU та часом операції	profit, gifts, firstPaidAt, lastPaidAt
Prime	Платні вхідні повідомлення з історії діалогу та live-подій	profit, firstPaidAt, lastPaidAt
Chathouse	Оперативна й денна статистика з RU та часом операції	profit, gifts, firstPaidAt, lastPaidAt
Udate	Платні вхідні повідомлення з історії діалогу та live-подій	profit, firstPaidAt, lastPaidAt

Golden і Chathouse отримують дані після Statistics Sync Worker. Prime і Udate отримують повідомлення через Project TU API. Окремий Project Favorite API не потрібен.

Оновлення

1. Створювати favorite тільки після платної дії RU для TU.
2. Повторна вигрузка статистики замінює агрегат за період, а не додає його повторно.
3. Повторне повідомлення з тим самим partner message ID не збільшує profit.
4. firstPaidAt може тільки зменшуватися, lastPaidAt — тільки збільшуватися.

Спільні правила

1. Favorite існує для пари TU + RU після першої платної дії.
2. New RU — перша платна дія цієї пари, незалежно від інших TU.
3. Active Favorite рахується за однією platform-настройкою; default 7 днів.
4. isBlackList поточних проєктів та blockedByTU Golden зводяться до одного поля blockedByTU.
5. Freeloader визначається глобально для RU і не належить ProjectFavoriteService.

Незакриті інтеграції

• Prime і Udate не мають RU в admin statistics, тому використовують платні повідомлення з TU-логік.
• TODO: реалізувати отримання blockedByRU у Prime.
• TODO: визначити джерело gifts для Udate або не повертати його для цього проєкту.

Заповнити

• Вибрати формат зберігання нормалізованої paid activity, з якої FavoriteService рахуватиме календар без логіки, специфічної для проєкту.