Enhance smoke-tracker API to include statistics for active users only; update documentation to reflect changes in user activity criteria and statistics calculations.

This commit is contained in:
Primakov Alexandr Alexandrovich
2025-11-17 14:40:37 +03:00
parent f856d94596
commit 414383163e
2 changed files with 54 additions and 12 deletions

View File

@@ -508,13 +508,17 @@ curl -X GET http://localhost:8044/smoke-tracker/stats/summary \
- `total` — общее количество сигарет за период
- `daysWithData` — количество дней, в которые были записи
**`global`** — общая статистика по всем пользователям:
- `daily` — массив с суммарным количеством сигарет всех пользователей по дням
- `averagePerDay` — среднее количество сигарет в день (все пользователи)
- `weekday` — статистика по дням недели (все пользователи)
- `total` — общее количество сигарет всех пользователей за период
**`global`** — общая статистика по всем **активным** пользователям:
- `daily` — массив с суммарным количеством сигарет всех активных пользователей по дням
- `averagePerDay` — среднее количество сигарет в день (активные пользователи)
- `weekday` — статистика по дням недели (активные пользователи)
- `total` — общее количество сигарет всех активных пользователей за период
- `daysWithData` — количество дней с записями
- `activeUsers` — количество уникальных пользователей, записывавших сигареты в период
- `activeUsers` — количество активных пользователей в период
> **Примечание**: Активными считаются только пользователи, которые в среднем выкуривают **от 2 до 40 сигарет в день**. Это позволяет исключить из статистики:
> - Тестовые аккаунты и неактивных пользователей (< 2 сигарет/день)
> - Ошибочные или накликанные данные (> 40 сигарет/день)
**`period`** — информация о запрошенном периоде:
- `from` — начало периода (ISO 8601)