GET /api/site-admin/stats — Статистика платформы

Сгенерировано из матриц + кода. Правки вносить в источники (docs/matrices/, server/routes/), не здесь.

Поле	Значение
HTTP	GET /api/site-admin/stats
Auth	requireSiteAdmin — только site-admin
Scope токена	read
PG-функции	api.get_platform_stats
Таблицы	user, project, organization
SRM	SRM-070
RP (права)	RP-081
Файл роута	server/routes/site-admin.js
Статус	done

Аргументы запроса (best-effort из хендлера; путь-параметры опущены):

аргументов не обнаружено (подтвердить вручную по server/routes/site-admin.js)

Коды ответов/ошибок (из хендлера): 400 (+ 200) — уточнить причины вручную

Для человека

Как открыть: войдите в Admin Panel (пароль → код TOTP) и откройте раздел «Статистика» (как правило, он встречает на главной панели).

Показывает сводку по платформе в целом тремя числами: сколько всего пользователей, сколько проектов и сколько организаций. Это быстрый «пульс» масштаба: чтобы одним взглядом оценить, как растёт платформа. В счёт проектов попадают только живые — удалённые (лежащие в корзине) не учитываются.

Кто может. Только администратор платформы — это сводка по всей платформе, а не по одной организации.

Для агента

Это операция site-admin, и она недоступна API-токену ни на каком scope. Сводная статистика платформы — администраторская витрина под человеческой cookie-сессией.

Путь /api/site-admin/* закрыт для Bearer-токенов в agent-gate (server/auth/agentGate.js): он не в read-allowlist (закрыто по умолчанию), поэтому GET с Authorization: Bearer tak_... возвращает 403 (Forbidden for token). Markdown-зеркала нет.

Под защитой requireSiteAdmin. Браузер шлёт его с cookie-сессией; тела/параметров нет:

curl https://specbuilder.vnimanie.ai/api/site-admin/stats -b admin-cookies.txt

Ответ 200:

{ "users": 128, "projects": 540, "organizations": 12 }

projects считает только не удалённые проекты (без корзины).

Связанные

• Экраны: Admin Panel
• Конвенции · Роли · Ошибки · Глоссарий