> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

## Настройка

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

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

```bash theme={null}
openssl rand -hex 32
# → shdp_dash_a1b2c3d4e5f6...
```

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

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

**Cloudflare Workers:**

```bash theme={null}
cd cloudflare/
wrangler secret put DASHBOARD_SECRET
# вставьте ваш секрет, когда появится запрос
```

**Node.js / другие:**

```bash theme={null}
# .env
DASHBOARD_SECRET=shdp_dash_a1b2c3d4e5f6...
```

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

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

***

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

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

***

## API

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

```bash theme={null}
curl https://l402kit.com/api/stats \
  -H "x-dashboard-secret: YOUR_SECRET"
```

```json theme={null}
{
  "totalPayments": 142,
  "totalSats": 14200,
  "shinydappsFee": 42,
  "trend": {
    "payments7d": 38,
    "payments7dPrev": 21,
    "sats7d": 3800,
    "sats7dPrev": 2100
  },
  "byOwner": {
    "you@blink.sv": { "count": 142, "sats": 14200 }
  },
  "recent": [...]
}
```

***

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

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

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

***

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

```bash theme={null}
# Сгенерируйте новый секрет
openssl rand -hex 32

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

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

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