veilix.app/docs/decisions/D-018-analytics.md

D-018. Umami на этом сервере и баннер cookies

Статус: принято, 20.10.2026.

Решение

1. Аналитика — своя Umami без cookies, на этом сервере: Node.js и PostgreSQL здесь уже есть, а трекер проксирует этот же nginx.
2. Ставится из исходников, без Docker (официальный способ наряду с Docker-образом): pnpm install, pnpm build, pnpm start. Отдельный пользователь ОС umami, своя база umami, systemd user-юнит, порт 3300.
3. Панель — umi.veilix.cc, доступ только с разрешённых IP.
4. Скрипт и отправка событий проксируются через домены брендов под нейтральными путями (TRACKER_SCRIPT_NAME, COLLECT_API_ENDPOINT), чтобы их не резали блокировщики рекламы.
5. Баннер cookies: обязательные (сессия, язык, валюта) и функциональные (чат). Необязательные скрипты — только после согласия.

Рассмотренные варианты

1. Umami на VPS с Chatwoot и Twenty — трекеру пришлось бы ходить на другой сервер, где Docker и тяжёлые сервисы.
2. Яндекс Метрика и GA4 — передают данные третьим лицам и требуют согласия; нужны, только если будет реклама.

Последствия

У Umami свой пользователь ОС, поэтому уязвимость в ней не открывает доступ к секретам Veilix.