This repository implements a comprehensive Telegram bot for managing VPN subscriptions via Remnawave panel integration, featuring a web-based admin cabinet (cabinet) and public API (webapi). The system handles user subscriptions, payments (20+ gateways), referrals, promotional systems, contests, news, and support tickets. Architected with modular layers: Telegram bot handlers (aiogram), cabinet/web API routes (FastAPI), service-layer business logic, and SQLAlchemy ORM with Alembic migrations. Key entry points include main.py (application bootstrap), bot.py (Telegram setup), and unified_app.py (combined web server). Data flows involve Telegram interactions → handler processing → service execution → database CRUD operations, with webhook handlers for payment gateway callbacks and panel synchronization. External dependencies include Telegram Bot API, Remnawave API, PostgreSQL, Redis, SMTP, and numerous payment processors (Yookassa, CryptoBot, etc.). The codebase demonstrates strong engineering practices: clean separation of concerns, dependency injection, structured logging (structlog), and reusable patterns like event emitters, caching utilities, and retry queues. Payment processing abstraction shows particular skill with uniform CRUD interfaces across gateways. Active maintenance is evident through frequent releases, Dependabot integration, and responsive issue triage. While complexity arises from extensive feature set and payment integrations, the modular design contains coupling effectively. Technical drift is low due to current Python version (3.13), updated dependencies, and proactive schema migrations.
This repository contains the official documentation website for the Remnawave proxy management panel. Built with Docusaurus 3.9.x and React 19, it generates a static site that provides installation guides, configuration references, tutorials, and API documentation. The site features a landing page with custom React components (hero section, stats bar, feature highlights, project grids, client cards) and multilingual help articles covering authentication methods, editor templates, and page configurations. A Caddy server serves the built output with routing for the landing page and documentation paths. The repository also includes an awesome-remnawave page indexing community tools (backup scripts, bots, monitoring tools) and a curated list of proxy clients with data-driven card displays. While the actual Remnawave panel backend is hosted separately, this documentation site is a well-structured, actively maintained resource that follows Docusaurus best practices with custom theming, dark mode, and analytics integration.