Update aggregate API to use binary megabytes and enhance documentation

- Changed API responses and internal calculations to use binary megabytes (MiB) instead of octets for traffic metrics.
- Updated relevant endpoints in AGGREGATE.md to reflect the new metric units.
- Modified handler and merge logic to accommodate the new data structure and ensure accurate traffic reporting.
- Enhanced tests to validate the changes in traffic calculations and summary data.
- Deprecated the use of total_octets in favor of total_megabytes for consistency across the API.

docs/AGGREGATE.md

@@ -2,16 +2,18 @@
 
 Шлюз **telemt-api** опрашивает несколько upstream [Telemt Control API](API.md) (`GET /v1/stats/users` на каждом сервере из конфигурации) и отдаёт сводные JSON-ответы в формате `{"ok": true, "data": ...}`.
 
-Доступ к **одному** инстансу по-прежнему через прокси: `GET /api/{alias}/…` (например `/api/gt1/v1/stats/users`).
+**Единицы трафика в агрегатах:** поля `*_megabytes` — это **двоичные мегабайты (MiB)**, 1 MiB = 1024² октетов (как у Telemt в ответе считаются октеты, шлюз делит на MiB для удобства).
+
+Доступ к **одному** инстансу по-прежнему через прокси: `GET /api/{alias}/…` (например `/api/gt1/v1/stats/users`) — там по-прежнему `total_octets` как в [API.md](API.md).
 
 ## Маршруты
 
 | Метод | Путь | Описание |
 | --- | --- | --- |
-| GET | `/api/agg/summary` | Сводка по флоту, список опросов upstream, топ пользователей по суммарному `total_octets`. |
-| GET | `/api/agg/traffic` | Трафик по каждому пользователю в разрезе серверов (алиасов). |
+| GET | `/api/agg/summary` | Сводка по флоту, список опросов upstream, `fleet_total_megabytes` / `fleet_total_connections`. Два топа (размер задаётся `top_n`): **`top_users`** — самые «прожорливые» по суммарному трафику (MiB) по всем серверам; **`top_users_by_unique_ips`** — по максимальному `active_unique_ips` среди серверов для пользователя (как в Telemt, снимок). |
+| GET | `/api/agg/traffic` | Трафик по каждому пользователю в разрезе серверов: `servers.<alias>.total_megabytes`. |
 | GET | `/api/agg/unique-ips` | Уникальные IP по пользователю: на каких серверах IP есть в active/recent списках снимка. |
-| GET | `/api/agg/users` | Объединённый список пользователей с `by_server` и суммарным `total_octets`. |
+| GET | `/api/agg/users` | Объединённый список пользователей с `by_server` и суммарным `total_megabytes`. |
 
 Все методы — **GET**; действует тот же whitelist, что и для остального API шлюза.
 
@@ -22,7 +24,8 @@
 | `aliases` | все | Список алиасов через запятую (например `gt1,gt2`). Если не задан — см. `aggregate.include_aliases` в YAML или все серверы из `servers`. |
 | `top_n` | `summary` | Размер топа пользователей (по умолчанию `10`, максимум `1000`). |
 | `include_links` | `users` | `true` — добавить сгенерированные `tg://proxy` ссылки (берётся первая успешная запись по пользователю). |
-| `min_total_octets` | `users` | Отфильтровать пользователей с суммарным трафиком ниже порога. |
+| `min_total_megabytes` | `users` | Порог суммарного трафика пользователя в MiB (строго больше 0). |
+| `min_total_octets` | `users` | Устаревший вариант порога в октетах (если задан `min_total_megabytes`, он приоритетнее). |
 
 ## Конфигурация (опционально)
 
@@ -48,5 +51,5 @@ aggregate:
 curl -sS "http://127.0.0.1:8080/api/agg/summary"
 curl -sS "http://127.0.0.1:8080/api/agg/traffic?aliases=gt1,gt2"
 curl -sS "http://127.0.0.1:8080/api/agg/unique-ips"
-curl -sS "http://127.0.0.1:8080/api/agg/users?include_links=false&min_total_octets=1000000"
+curl -sS "http://127.0.0.1:8080/api/agg/users?include_links=false&min_total_megabytes=1"
 ```