commit f8e13f8456b149505cdadfd14635c3ae65791028 Author: Hermes Virtual Office Bot Date: Wed Oct 21 12:48:28 2026 +0000 feat(mvp): initial build for Катюша VPN [DEV staging] diff --git a/REPO_MAP.md b/REPO_MAP.md new file mode 100644 index 0000000..9c3a0d0 --- /dev/null +++ b/REPO_MAP.md @@ -0,0 +1,12 @@ +# REPO_MAP.md (Auto-Generated Modular Index) +> Hard Rule: Max 200 lines per file. Read ONLY the contract and target feature folder. + +| Path | Lines | Layer / Responsibility | +|------|-------|------------------------| +| `contracts/DESIGN_SYSTEM.md` | 8 ✅ | contract | +| `contracts/OPENAPI.yaml` | 4 ✅ | contract | +| `contracts/PRD.md` | 9 ✅ | contract | +| `contracts/WEB_REFERENCES.md` | 20 ✅ | contract | +| `backend/app/modules/core/router.py` | 2 ✅ | backend-module | +| `frontend/src/features/PreviewApp.html` | 213 ⚠️ OVER 200L | frontend-fsd | +| `frontend/src/features/PreviewDev.html` | 213 ⚠️ OVER 200L | frontend-fsd | diff --git a/backend/app/modules/core/router.py b/backend/app/modules/core/router.py new file mode 100644 index 0000000..e6c9df9 --- /dev/null +++ b/backend/app/modules/core/router.py @@ -0,0 +1,2 @@ +from fastapi import APIRouter +router = APIRouter(prefix='/api/v1/items') diff --git a/contracts/DESIGN_SYSTEM.md b/contracts/DESIGN_SYSTEM.md new file mode 100644 index 0000000..0c0a3c3 --- /dev/null +++ b/contracts/DESIGN_SYSTEM.md @@ -0,0 +1,8 @@ +# DESIGN_SYSTEM.md (Normalized Figma Tokens) +- **Reference Source:** Autonomous UX/UI Market Standard +- **File Key / Node:** `N/A` / `Root` +- **Primary Palette:** `#0F172A, #6366F1, #10B981, #F8FAFC, #1E293B` +- **Typography:** `Inter, JetBrains Mono` +- **Border Radius & Surface:** `12px`, Glassmorphic slate cards (`backdrop-blur-md`) +- **Responsive Breakpoints:** Desktop `1440x900` (12-col grid) | Mobile `390x844` (single-col stack) +- **Mapped FSD Widgets:** `AppHeader, HeroMetricBanner, FilterBar, FeatureCardGrid, ActionModal` diff --git a/contracts/OPENAPI.yaml b/contracts/OPENAPI.yaml new file mode 100644 index 0000000..5a7d926 --- /dev/null +++ b/contracts/OPENAPI.yaml @@ -0,0 +1,4 @@ +openapi: 3.1.0 +info: + title: Катюша VPN API + version: 1.0.0 diff --git a/contracts/PRD.md b/contracts/PRD.md new file mode 100644 index 0000000..5d9bd2b --- /dev/null +++ b/contracts/PRD.md @@ -0,0 +1,9 @@ +# PRD: Катюша VPN +- Режим: `reference_url` +- Идея: Хочу точно такой же с классным дизайном, чтобы цепляло внимание. Дизайн код базируется на Катюше, сексопильной девушке, которая стреляет по РКН, как будто пробивает стены. Тарифы такие же + +## Сайты-референсы: +- 🎯 Ваш референс-образец: Gorilla (https://gorillavpn.pro/): Проанализирована структура первого экрана, навигации, карточек преимуществ и блока тарифов. +- Mullvad VPN — Эталон минимализма, прозрачности и оплаты в 1 клик (вкл. крипто) (https://mullvad.net/en): Ключевые паттерны: генерация аккаунта без email, мгновенный выбор протокола WireGuard/Shadowsocks, честная цена, нулевое логирование. +- Proton VPN — Премиальный тёмный UI с интерактивной картой серверов и сравнением скоростей (https://protonvpn.com): Ключевые паттерны: переключатель тарифов (1 мес / 1 год / 2 года со скидкой 60%), таблица скорости 10 Gbps, бейджи стриминга (Netflix/YouTube 4K). +- Amnezia / Outline VPN — Фокус на обход блокировок (VLESS / Xray Reality) и приложения под все ОС (https://amnezia.org): Ключевые паттерны: кнопки быстрого скачивания (iOS, Android, macOS, Windows, роутеры), выдача ключа для Telegram-бота в 1 клик. diff --git a/contracts/WEB_REFERENCES.md b/contracts/WEB_REFERENCES.md new file mode 100644 index 0000000..c3cc4f5 --- /dev/null +++ b/contracts/WEB_REFERENCES.md @@ -0,0 +1,20 @@ +# WEB_REFERENCES.md — Референсы и режим проектирования +- **Выбранный режим:** 🔄 Режим 2: По вашему примеру / референсу (± аналог) +- **Запрос / Задача:** `Катюша VPN Хочу точно такой же с классным дизайном, чтобы цепляло внимание. Дизайн код базируется на Катюше, сексопильной девушке, которая стреляет по РКН, как будто пробивает стены. Тарифы такие же ` + +## Источники и референсы, переданные в UX/UI и Frontend: +### 1. [🎯 Ваш референс-образец: Gorilla](https://gorillavpn.pro/) +- **URL:** https://gorillavpn.pro/ +- **Что берём в проект:** Проанализирована структура первого экрана, навигации, карточек преимуществ и блока тарифов. + +### 2. [Mullvad VPN — Эталон минимализма, прозрачности и оплаты в 1 клик (вкл. крипто)](https://mullvad.net/en) +- **URL:** https://mullvad.net/en +- **Что берём в проект:** Ключевые паттерны: генерация аккаунта без email, мгновенный выбор протокола WireGuard/Shadowsocks, честная цена, нулевое логирование. + +### 3. [Proton VPN — Премиальный тёмный UI с интерактивной картой серверов и сравнением скоростей](https://protonvpn.com) +- **URL:** https://protonvpn.com +- **Что берём в проект:** Ключевые паттерны: переключатель тарифов (1 мес / 1 год / 2 года со скидкой 60%), таблица скорости 10 Gbps, бейджи стриминга (Netflix/YouTube 4K). + +### 4. [Amnezia / Outline VPN — Фокус на обход блокировок (VLESS / Xray Reality) и приложения под все ОС](https://amnezia.org) +- **URL:** https://amnezia.org +- **Что берём в проект:** Ключевые паттерны: кнопки быстрого скачивания (iOS, Android, macOS, Windows, роутеры), выдача ключа для Telegram-бота в 1 клик. diff --git a/frontend/src/features/PreviewApp.html b/frontend/src/features/PreviewApp.html new file mode 100644 index 0000000..ec6ee48 --- /dev/null +++ b/frontend/src/features/PreviewApp.html @@ -0,0 +1,213 @@ + + + + + + Катюша VPN — Быстрый VPN нового поколения (VLESS / WireGuard) + + + + +
+
+
+
V
+
+ Катюша VPN + 10 Gbps • No-Logs +
+
+ +
+ ← В Офис + Подключить за 30 сек +
+
+
+ +
+ +
+
+
+ 🛡 Протоколы Xray VLESS Reality + WireGuard +
+

+ Свободный интернет на скорости до 10 Гбит/с без блокировок +

+

+ Хочу точно такой же с классным дизайном, чтобы цепляло внимание. Дизайн код базируется на Катюше, сексопильной девушке, которая стреляет по РКН, как будто пробивает стены. Тарифы такие же . Работает в любых сетях, поддерживает YouTube 4K без рекламы, Netflix, ChatGPT и мгновенную выдачу ключа в Telegram или приложении. +

+
+ + 🚀 Получить доступ (от 199 ₽/мес) + + +
+
+
42 страныЕвропа, США, Азия
+
5 устройствПо одной подписке
+
0 логовНезависимый аудит
+
+
+ + +
+
+ Статус туннеля + 🟢 Защищено • VLESS Reality +
+
+
+
Текущая локация
+
🇳🇱 Нидерланды, Амстердам #4
+
Пинг: 18 мс • Нагрузка: 14%
+
+ +
+
+
+ Download +
842 Мбит/с
+
+
+ Upload +
690 Мбит/с
+
+
+
+ Платформы: iOS • Android • macOS • Windows • SmartTV + AES-256-GCM +
+
+
+ + +
+
+

Прозрачные тарифы без скрытых списаний

+

Мгновенная выдача конфигурации сразу после оплаты (СБП, карты РФ/Мир, USDT/TON).

+
+
+ +
+
+
На 1 месяц
+
349 ₽ / мес
+
    +
  • ✅ До 5 устройств одновременно
    • +
  • ✅ Все 42 страны (10 Gbps)
    • +
  • ✅ Протоколы VLESS Reality + WireGuard
    • +
  • ✅ YouTube 4K без рекламы
    • +
+
+ +
+ + +
+ ХИТ • ВЫГОДА 45% +
+
На 1 год
+
199 ₽ / мес
+
2 388 ₽ при оплате за год
+
    +
  • ✅ До 10 устройств + роутер
    • +
  • ✅ Выделенные стриминг-серверы (Netflix, AI)
    • +
  • ✅ Авто-обход DPI провайдеров (Stealth)
    • +
  • ✅ Приоритетная поддержка в Telegram 24/7
    • +
+
+ +
+ + +
+
+
На 6 месяцев
+
249 ₽ / мес
+
1 494 ₽ за полгода
+
    +
  • ✅ До 5 устройств одновременно
    • +
  • ✅ Все 42 страны (10 Gbps)
    • +
  • ✅ Защита от утечек WebRTC и DNS
    • +
  • ✅ Гарантия возврата 30 дней
    • +
+
+ +
+
+
+ + +
+
+

🔍 Сайты-референсы из интернета, на базе которых PM и UX/UI собрали этот проект:

+

Автоматическое исследование конкурентов (`contracts/WEB_REFERENCES.md`)

+
+
+ + +
🎯 Ваш референс-образец: Gorilla
+
https://gorillavpn.pro/
+

Проанализирована структура первого экрана, навигации, карточек преимуществ и блока тарифов.

+ + + +
Mullvad VPN — Эталон минимализма, прозрачности и оплаты в 1 клик (вкл. крипто)
+
https://mullvad.net/en
+

Ключевые паттерны: генерация аккаунта без email, мгновенный выбор протокола WireGuard/Shadowsocks, честная цена, нулевое логирование.

+ + + +
Proton VPN — Премиальный тёмный UI с интерактивной картой серверов и сравнением скоростей
+
https://protonvpn.com
+

Ключевые паттерны: переключатель тарифов (1 мес / 1 год / 2 года со скидкой 60%), таблица скорости 10 Gbps, бейджи стриминга (Netflix/YouTube 4K).

+ + + +
Amnezia / Outline VPN — Фокус на обход блокировок (VLESS / Xray Reality) и приложения под все ОС
+
https://amnezia.org
+

Ключевые паттерны: кнопки быстрого скачивания (iOS, Android, macOS, Windows, роутеры), выдача ключа для Telegram-бота в 1 клик.

+ + +
+
+
+ + + + + + + \ No newline at end of file diff --git a/frontend/src/features/PreviewDev.html b/frontend/src/features/PreviewDev.html new file mode 100644 index 0000000..ec6ee48 --- /dev/null +++ b/frontend/src/features/PreviewDev.html @@ -0,0 +1,213 @@ + + + + + + Катюша VPN — Быстрый VPN нового поколения (VLESS / WireGuard) + + + + +
+
+
+
V
+
+ Катюша VPN + 10 Gbps • No-Logs +
+
+ +
+ ← В Офис + Подключить за 30 сек +
+
+
+ +
+ +
+
+
+ 🛡 Протоколы Xray VLESS Reality + WireGuard +
+

+ Свободный интернет на скорости до 10 Гбит/с без блокировок +

+

+ Хочу точно такой же с классным дизайном, чтобы цепляло внимание. Дизайн код базируется на Катюше, сексопильной девушке, которая стреляет по РКН, как будто пробивает стены. Тарифы такие же . Работает в любых сетях, поддерживает YouTube 4K без рекламы, Netflix, ChatGPT и мгновенную выдачу ключа в Telegram или приложении. +

+
+ + 🚀 Получить доступ (от 199 ₽/мес) + + +
+
+
42 страныЕвропа, США, Азия
+
5 устройствПо одной подписке
+
0 логовНезависимый аудит
+
+
+ + +
+
+ Статус туннеля + 🟢 Защищено • VLESS Reality +
+
+
+
Текущая локация
+
🇳🇱 Нидерланды, Амстердам #4
+
Пинг: 18 мс • Нагрузка: 14%
+
+ +
+
+
+ Download +
842 Мбит/с
+
+
+ Upload +
690 Мбит/с
+
+
+
+ Платформы: iOS • Android • macOS • Windows • SmartTV + AES-256-GCM +
+
+
+ + +
+
+

Прозрачные тарифы без скрытых списаний

+

Мгновенная выдача конфигурации сразу после оплаты (СБП, карты РФ/Мир, USDT/TON).

+
+
+ +
+
+
На 1 месяц
+
349 ₽ / мес
+
    +
  • ✅ До 5 устройств одновременно
    • +
  • ✅ Все 42 страны (10 Gbps)
    • +
  • ✅ Протоколы VLESS Reality + WireGuard
    • +
  • ✅ YouTube 4K без рекламы
    • +
+
+ +
+ + +
+ ХИТ • ВЫГОДА 45% +
+
На 1 год
+
199 ₽ / мес
+
2 388 ₽ при оплате за год
+
    +
  • ✅ До 10 устройств + роутер
    • +
  • ✅ Выделенные стриминг-серверы (Netflix, AI)
    • +
  • ✅ Авто-обход DPI провайдеров (Stealth)
    • +
  • ✅ Приоритетная поддержка в Telegram 24/7
    • +
+
+ +
+ + +
+
+
На 6 месяцев
+
249 ₽ / мес
+
1 494 ₽ за полгода
+
    +
  • ✅ До 5 устройств одновременно
    • +
  • ✅ Все 42 страны (10 Gbps)
    • +
  • ✅ Защита от утечек WebRTC и DNS
    • +
  • ✅ Гарантия возврата 30 дней
    • +
+
+ +
+
+
+ + +
+
+

🔍 Сайты-референсы из интернета, на базе которых PM и UX/UI собрали этот проект:

+

Автоматическое исследование конкурентов (`contracts/WEB_REFERENCES.md`)

+
+
+ + +
🎯 Ваш референс-образец: Gorilla
+
https://gorillavpn.pro/
+

Проанализирована структура первого экрана, навигации, карточек преимуществ и блока тарифов.

+ + + +
Mullvad VPN — Эталон минимализма, прозрачности и оплаты в 1 клик (вкл. крипто)
+
https://mullvad.net/en
+

Ключевые паттерны: генерация аккаунта без email, мгновенный выбор протокола WireGuard/Shadowsocks, честная цена, нулевое логирование.

+ + + +
Proton VPN — Премиальный тёмный UI с интерактивной картой серверов и сравнением скоростей
+
https://protonvpn.com
+

Ключевые паттерны: переключатель тарифов (1 мес / 1 год / 2 года со скидкой 60%), таблица скорости 10 Gbps, бейджи стриминга (Netflix/YouTube 4K).

+ + + +
Amnezia / Outline VPN — Фокус на обход блокировок (VLESS / Xray Reality) и приложения под все ОС
+
https://amnezia.org
+

Ключевые паттерны: кнопки быстрого скачивания (iOS, Android, macOS, Windows, роутеры), выдача ключа для Telegram-бота в 1 клик.

+ + +
+
+
+ + + + + + + \ No newline at end of file