> ## 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.

# امتداد VS Code

> راقب مدفوعات Lightning الخاصة بك في الوقت الفعلي، مباشرةً داخل VS Code — شريط الحالة، والرسوم البيانية، وتصدير CSV، واشتراك Pro مدفوع بالبيتكوين.

يعرض امتداد **ShinyDapps Payments** بيانات مدفوعات l402-kit دون مغادرة المحرر. قم بالتثبيت مرة واحدة، وحدد عنوان Lightning الخاص بك، وشاهد الـ sats تصل في شريط الحالة.

<Card title="التثبيت من Marketplace" icon="download" href="https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402">
  ShinyDapps.shinydapps-l402 — يعمل مع VS Code 1.85 وما بعده
</Card>

***

## الإعداد السريع

1. ثبّت الامتداد من [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402).
2. افتح لوحة الأوامر (`Ctrl+Shift+P` / `Cmd+Shift+P`).
3. شغّل **ShinyDapps: Configure Lightning Address**.
4. أدخل عنوان Lightning الخاص بك (مثال: `you@blink.sv`).

يضيء عنصر شريط الحالة `⚡ 0 sats (0)` فوراً. يستطلع البيانات كل 30 ثانية ويتحدث تلقائياً.

بدلاً من ذلك، يمكنك تعيينه يدوياً في إعدادات VS Code:

```json theme={null}
{
  "shinydapps.lightningAddress": "you@blink.sv"
}
```

***

## ما تراه

### شريط الحالة

`⚡ 1,234 sats (42)` — إجمالي الـ sats المكتسبة وعدد المدفوعات، ظاهر دائماً.
مرّر المؤشر فوق العنصر لرؤية تلميح بالتفاصيل. إذا كنت على الخطة المجانية، يذكّرك التلميح أيضاً بأن Pro يتيح عرض السجل الكامل.

### لوحة Dashboard

انقر على عنصر شريط الحالة أو شغّل **ShinyDapps: Open Dashboard** لفتح اللوحة الكاملة. تحتوي على:

| القسم                 | الوصف                                                            |
| --------------------- | ---------------------------------------------------------------- |
| بطاقات الإحصاء        | إجمالي المدفوعات، وإجمالي الـ sats، وتقدير USD، وسعر BTC المباشر |
| الرسم البياني الشريطي | الـ sats المكتسبة عبر الزمن (انظر النطاقات أدناه)                |
| جدول المدفوعات        | آخر 50 معاملة: الطابع الزمني، ونقطة النهاية، والـ sats           |
| مؤشر BTC              | السعر المباشر من mempool.space، معروض بالـ sat لكل دولار         |

تظهر اللوحة أيضاً في الشريط الجانبي (Activity Bar → أيقونة ⚡).

### دعم اللغات

11 لغة مدمجة: English، Português، Español، 中文، 日本語، Français، Deutsch، Русский، हिन्दी، العربية، Italiano. غيّر اللغة عبر القائمة المنسدلة في أعلى لوحة Dashboard.

***

## المجاني مقابل Pro

| الميزة                          | مجاني        | Pro                      |
| ------------------------------- | ------------ | ------------------------ |
| سجل المدفوعات                   | آخر 30 يوماً | كل الأوقات               |
| نطاقات الرسم البياني            | 1D · 7D      | 1D · 7D · 30D · 1Y · ALL |
| تصدير CSV                       | —            | ✓                        |
| شريط الحالة + الاستطلاع المباشر | ✓            | ✓                        |
| مؤشر سعر BTC                    | ✓            | ✓                        |
| اللغات                          | 11           | 11                       |

### الترقية إلى Pro

تكلف Pro **9 دولارات / شهر**، مدفوعة بالبيتكوين عبر Lightning — بدون بطاقة ائتمان، بدون حساب.

انقر على **Upgrade with Bitcoin →** داخل لوحة Dashboard، أو انتقل مباشرةً إلى:

```
https://l402kit.com/api/checkout?address=YOU@DOMAIN.COM&tier=pro
```

تُنشئ صفحة الدفع فاتورة BOLT11، وتعرض رمز QR، وتستطلع الدفع. بمجرد التأكيد، يتفعّل Pro فوراً — دون الحاجة إلى إعادة تشغيل.

<Note>
  يتحقق الامتداد من حالة Pro عند بدء التشغيل. إذا كنت قد دفعت للتو، انقر على زر التحديث **↺** في لوحة Dashboard للتفعيل الفوري.
</Note>

***

## الإشعارات

يُطلق الامتداد إشعار VS Code عندما **تصل أول دفعة** أثناء فتح المحرر:

> ⚡ تم استلام أول دفعة! افتح لوحة Dashboard لمشاهدتها.

انقر على **Open Dashboard** في الإشعار للانتقال مباشرةً إلى اللوحة.

***

## الخصوصية والبيانات

* يقرأ الامتداد بيانات المدفوعات من Supabase باستخدام مفتاح **قابل للنشر (للقراءة فقط)** مقيّد بعنوان Lightning الخاص بك.
* لا يتم تخزين رموز المصادقة محلياً — فقط عنوان Lightning في إعدادات VS Code.
* يمكنك حذف جميع بياناتك في أي وقت عبر **Danger Zone → Delete all my data** داخل لوحة Dashboard. يؤدي ذلك إلى إزالة سجل المدفوعات واشتراك Pro من Supabase.

***

## منطقة الخطر

تتضمن لوحة Dashboard تدفقاً لحذف البيانات بشكل ذاتي:

1. وسّع **Danger Zone** في أسفل لوحة Dashboard.
2. اكتب عنوان Lightning الخاص بك للتأكيد.
3. انقر على **Delete my data**.

يُحذف سجل جميع المدفوعات وصلاحية Pro لذلك العنوان بشكل دائم.

***

## استكشاف الأخطاء وإصلاحها

<AccordionGroup>
  <Accordion title="يعرض شريط الحالة ⚡ — (offline)">
    تعذّر على الامتداد الوصول إلى Supabase. تحقق من اتصالك بالإنترنت وحاول النقر على **↺** للتحديث.
  </Accordion>

  <Accordion title="المدفوعات لا تظهر بعد معاملة ناجحة">
    يستطلع الامتداد البيانات كل 30 ثانية. انقر على **↺** لإجبار تحديث فوري. إذا لم تظهر المدفوعات بعد، تحقق من أن عنوان Lightning في إعدادات VS Code يطابق تماماً العنوان المسجل مع l402-kit (مع مراعاة حالة الأحرف).
  </Accordion>

  <Accordion title="تم تفعيل Pro ولكن الرسم البياني لا يزال يعرض 🔒">
    انقر على **↺** للتحديث. يتم التحقق من حالة Pro عند التحميل — يُعيد التحديث اليدوي التحقق منها فوراً.
  </Accordion>

  <Accordion title="أرى المدفوعات لكن العدد يبدو منخفضاً">
    في الخطة المجانية، يتم تحميل **آخر 30 يوماً** فقط من السجل. قم بالترقية إلى Pro لرؤية بيانات كل الأوقات. يعرض بانر Pro عدد المدفوعات المخفية إذا كانت لديك سجلات أقدم.
  </Accordion>
</AccordionGroup>