Панель аналитики

Получите доступ к панели аналитики платежей на l402kit.com/dashboard — без регистрации, защита осуществляется с помощью секретного токена.

Панель аналитики на l402kit.com/dashboard отображает статистику в реальном времени для всех платежей, проходящих через ваш API: общее количество полученных sats, разбивку по эндпоинтам, тренд за 7 дней и последние транзакции.

Настройка

Панель защищена секретным токеном — DASHBOARD_SECRET. Вы генерируете его один раз и храните там же, где хранятся остальные секреты.

1. Сгенерируйте секрет

openssl rand -hex 32
# → shdp_dash_a1b2c3d4e5f6...

Или используйте любой менеджер паролей для генерации надёжной случайной строки.

2. Укажите его в провайдере

Cloudflare Workers:

cd cloudflare/
wrangler secret put DASHBOARD_SECRET
# вставьте ваш секрет, когда появится запрос

Node.js / другие:

# .env
DASHBOARD_SECRET=shdp_dash_a1b2c3d4e5f6...

3. Войдите в систему

Перейдите на l402kit.com/dashboard, введите ваш секрет — и вы внутри. Никакой почты, никакого OAuth, никаких cookie — секрет передаётся в заголовке x-dashboard-secret при каждом запросе статистики.

---

Что отображается

Метрика	Описание
Всего платежей	Общее количество верифицированных L402 платежей за всё время
Всего sats	Сумма всех amount_sats по всем платежам
Тренд за 7 дней	Платежи и sats в сравнении с предыдущим 7-дневным периодом
По эндпоинтам	Разбивка того, какие маршруты сколько заработали
Последние 20	Последние платежи с хешем, эндпоинтом, суммой и временной меткой

---

API

Те же данные доступны напрямую через API — удобно для создания собственной панели или интеграции с Grafana.

curl https://l402kit.com/api/stats \
  -H "x-dashboard-secret: YOUR_SECRET"

{
  "totalPayments": 142,
  "totalSats": 14200,
  "shinydappsFee": 42,
  "trend": {
    "payments7d": 38,
    "payments7dPrev": 21,
    "sats7d": 3800,
    "sats7dPrev": 2100
  },
  "byOwner": {
    "[e-mail]": { "count": 142, "sats": 14200 }
  },
  "recent": [...]
}

---

Модель безопасности

• Секрет никогда не покидает ваше окружение — он сравнивается на стороне сервера в Cloudflare Worker с использованием строгого равенства
• Сессионный токен не выдаётся — каждый запрос повторно проверяет секрет
• Секрет имеет доступ только для чтения — он может только вызывать /api/stats, но не записывать или удалять данные
• Генерируйте новый секрет в любое время, обновив DASHBOARD_SECRET с помощью wrangler secret put

Никогда не коммитьте DASHBOARD_SECRET в git. Добавьте его в .gitignore и используйте wrangler secret put или менеджер секретов вашего CI/CD.

---

Ротация секрета

# Сгенерируйте новый секрет
openssl rand -hex 32

# Обновите в Cloudflare Workers
wrangler secret put DASHBOARD_SECRET

# Готово — старый секрет немедленно становится недействительным

Никаких записей в базе данных обновлять не нужно. Worker считывает секрет из окружения при каждом запросе.