Статистика: API endpoints + MCP tools (overview, active users/chats, volume)

[plagness]

Phase 4: Статистика через MCP

API endpoints и MCP tools для аналитики сообщений.

API Endpoints (новый файл: api/app/routers/stats.py)

Endpoint	Описание
GET /v1/stats/overview	Общая статистика: чаты, юзеры, сообщения
GET /v1/stats/active-users	Топ активных юзеров (по message_count)
GET /v1/stats/active-chats	Топ активных чатов
GET /v1/stats/message-volume	Объём сообщений по времени (для графиков)
GET /v1/stats/update-types	Распределение типов обновлений

MCP Tools (новый файл: mcp/src/tools/stats.ts)

Tool	Описание
stats.overview	Общая статистика
stats.active_users	Топ юзеров. Params: chat_id?, period, limit
stats.active_chats	Топ чатов. Params: period, limit
stats.message_volume	Объём по времени. Params: chat_id?, period, granularity
stats.update_types	Типы обновлений. Params: period

Данные (уже есть в БД)

• users.message_count, chat_members.message_count
• messages таблица (direction, created_at, chat_id)
• webhook_updates (update_type)

Файлы

• api/app/routers/stats.py — новый
• api/app/main.py — подключить router
• mcp/src/tools/stats.ts — новый
• mcp/src/index.ts — зарегистрировать модуль