<?php
// vpn_panel_interface.php
// قرارداد مشترک بین همه‌ی پنل‌ها (Marzban, X-UI, ...)

interface VpnPanelInterface
{
    public function getBaseUrl(): string;

    /** ساخت یوزر / سرویس جدید */
    public function createUser(array $payload): array;

    /** گرفتن اطلاعات یوزر (برای تمدید/نمایش) */
    public function getUser(string $username): array;

    /** تمدید / آپدیت حجم و زمان */
    public function renewUser(string $username, array $payload): array;

    /** ریست ترافیک بعد از تمدید */
    public function resetTraffic(string $username): array;
}
