> ## 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) إحصائيات فورية لجميع المدفوعات التي تمر عبر واجهة برمجة التطبيقات الخاصة بك: إجمالي 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، لا كوكيز — يُرسل الرمز السري كـ `x-dashboard-secret` مع كل طلب إحصائيات.

***

## ما تراه

| المقياس          | الوصف                                                       |
| ---------------- | ----------------------------------------------------------- |
| إجمالي المدفوعات | العدد الكلي لمدفوعات L402 الموثقة منذ البداية               |
| إجمالي sats      | مجموع جميع `amount_sats` عبر المدفوعات                      |
| اتجاه 7 أيام     | المدفوعات وsats مقارنةً بنافذة الـ 7 أيام السابقة           |
| حسب نقطة الوصول  | تفصيل للمسارات التي حققت أرباحاً وبأي مقدار                 |
| آخر 20           | أحدث المدفوعات مع الهاش ونقطة الوصول والمبلغ والطابع الزمني |

***

## واجهة برمجة التطبيقات

تتوفر البيانات ذاتها مباشرةً عبر واجهة برمجة التطبيقات — مفيدة لبناء لوحة تحكم خاصة بك أو إرسال البيانات إلى 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 الرمز السري من البيئة عند كل طلب.