> ## 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.
# Diagram Forge
> Живые архитектурные диаграммы, генерируемые ИИ из любого GitHub-репозитория — оплата через Lightning L402
## Что такое Diagram Forge?
[Diagram Forge](https://forge.l402kit.com) анализирует любой GitHub-репозиторий с помощью Claude AI и генерирует **интерактивную анимированную архитектурную диаграмму** — с официальными логотипами технологий, анимированными потоками частиц, инспектором узлов и экспортом в SVG/PNG/Markdown.
Оплата осуществляется через Lightning Network по протоколу L402 — без аккаунтов, банковских карт и подписок. Платите за каждый анализ отдельно.
***
## Начало работы
### Вариант 1 — Веб-приложение (быстрее всего)
1. Перейдите на **[forge.l402kit.com](https://forge.l402kit.com)**
2. Вставьте любой публичный GitHub URL (например, `https://github.com/vercel/next.js`)
3. Выберите уровень: **Basic** (100 sats), **Full** (500 sats) или **Live ✦** (1000 sats)
4. Нажмите **Analyze & Generate Diagram**
5. Оплатите Lightning-инвойс любым кошельком — или введите промокод для бесплатного доступа
6. Интерактивная диаграмма откроется автоматически
### Вариант 2 — Расширение для VS Code
Установите из Marketplace:
```bash theme={null}
code --install-extension ShinyDapps.diagram-forge
```
Или найдите **"Diagram Forge"** на панели расширений (`Ctrl+Shift+X`).
**Использование:**
1. Откройте любой проект с удалённым репозиторием GitHub
2. Нажмите на **иконку Diagram Forge** на панели активности (левая боковая панель)
3. Нажмите **Analyze Repo** — URL GitHub определяется автоматически
4. Выберите уровень + введите промокод (при наличии)
5. Оплатите через Lightning или используйте промокод
6. Диаграмма откроется в браузере
### Вариант 3 — Подключение GitHub (веб-приложение)
Нажмите **Connect GitHub** в верхней навигации веб-приложения, чтобы авторизоваться и получить выпадающий список всех ваших репозиториев — без необходимости копировать и вставлять URL.
***
## Уровни анализа
| Уровень | Цена | Что включено |
| ---------- | -------------------- | -------------------------------------------------------- |
| **Basic** | 100 sats (\~\$0.10) | Быстрое сканирование — топ 10 файлов, основные сервисы |
| **Full** | 500 sats (\~\$0.50) | Полный репозиторий — все сервисы, связи, монорепозитории |
| **Live ✦** | 1000 sats (\~\$1.00) | Полный анализ + анимированный SVG с потоками частиц |
Цены в Lightning значительно ниже, чем при оплате картой, поскольку отсутствуют комиссии за обработку платежей.
***
## Нет Lightning-кошелька?
Начните работу менее чем за 2 минуты:
Простейший мобильный кошелёк — кастодиальный, мгновенная настройка
Мобильный, самокастодиальный, без KYC
Браузерное расширение — работает напрямую в VS Code
После установки купите небольшое количество Bitcoin (даже на \$1 хватит на десятки анализов) и отсканируйте QR-код, когда Diagram Forge покажет инвойс.
***
## Промокоды
Есть промокод? Введите его в поле **«Promo code (optional)»** перед нажатием кнопки Analyze — анализ будет выполнен бесплатно, кошелёк не нужен.
Промокоды ограничены по времени и количеству использований. Проверяйте актуальные коды на [forge.l402kit.com](https://forge.l402kit.com) или следите за [@ShinyDapps](https://github.com/ShinyDapps).
***
## Что отображает диаграмма
Каждая диаграмма включает:
* **Узлы** — сервисы, базы данных, очереди, API, модели ML, CDN, обнаруженные в вашем коде
* **Рёбра** — связи между компонентами с метками протоколов (HTTP, SQL, gRPC, WebSocket, AMQP…)
* **Логотипы** — официальные иконки Simple Icons для 80+ технологий
* **Анимированные потоки** — частицы, движущиеся вдоль рёбер, окрашенные по типу протокола (жёлтый = Lightning, синий = HTTP, зелёный = SQL…)
**Возможности интерактивного просмотрщика:**
* Перемещение и масштабирование (прокрутка для зума, перетаскивание для панорамирования)
* Клик по узлу для просмотра его связей и описания
* Миникарта для больших диаграмм
* Поиск узлов по имени или типу
* Экспорт: SVG, PNG, Markdown, Draw\.io
* Ссылка для совместного доступа: `/g/:id` — постоянный URL для каждой диаграммы
***
## Импорт из изображения
Нет GitHub-репозитория? Загрузите фотографию доски, скриншот, файл Visio или PDF — Claude извлечёт архитектуру и создаст такую же интерактивную диаграмму.
Поддерживаемые форматы: JPG, PNG, WEBP, GIF, PDF
***
## Бенчмарк архитектуры
После генерации диаграммы нажмите **Benchmark** в просмотрщике, чтобы получить оценку качества по 6 параметрам:
| Параметр | Что измеряется |
| --------------------------- | -------------------------------------------------------- |
| Масштабируемость | Потенциал горизонтального масштабирования, узкие места |
| Надёжность | Единые точки отказа, резервирование |
| Безопасность | Аутентификация, шифрование, поверхность атаки |
| Наблюдаемость | Покрытие логирования, метрик и трассировки |
| Сопровождаемость | Связанность, сложность, модульность |
| Экономическая эффективность | Опционально — стоимость сервиса по сравнению с ценностью |
***
## Конфиденциальность
* Ваш код **временно клонируется** на защищённом сервере, анализируется, затем немедленно удаляется
* Только **метаданные графа** (метки узлов, связи рёбер — без исходного кода) сохраняются при использовании ссылок для совместного доступа
* Аккаунт не требуется, данные не хранятся дольше, чем существует диаграмма
***
## Как используется l402-kit
Diagram Forge построен на основе **Managed Mode** из `l402-kit` — простейшего способа принимать Lightning-платежи без запуска собственного узла:
```typescript theme={null}
import { l402, ManagedProvider } from "l402-kit";
const provider = ManagedProvider.fromAddress("pinkfalcon21@primal.net", {
registerDirectory: {
url: "https://forge.l402kit.com/analyze",
name: "Diagram Forge — Architecture Analysis",
priceSats: 500,
description: "AI-powered living architecture diagrams from any repo",
category: "ai",
},
});
// Gate the /analyze endpoint — returns 402 until paid
app.post("/analyze", l402({ priceSats: 500, lightning: provider }), handler);
```
Когда клиент вызывает `POST /analyze` без действительного preimage:
```
HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="...", invoice="lnbc..."
```
Клиент оплачивает инвойс и повторяет запрос с заголовком `Authorization: L402 :`.
Хотите создать что-то похожее? Ознакомьтесь с [руководством по быстрому старту l402-kit](/quickstart).
***
## Ссылки
Анализируйте любой публичный GitHub-репозиторий в браузере
Полноценная боковая панель внутри VS Code
Лицензия MIT — форкайте, расширяйте, стройте на его основе
Создайте собственный сервис с L402-защитой за считанные минуты