Ürün Modülü Müşteri Yönetimi

Yönetim sekmesine tıklandı
  └─ use_module_method'suz GET isteği   ->  ClientServices::get_management_details
       ├─ sahip + tip + etkin durum denetimi
       ├─ client_module_instance()        ->  $client_area = true, $area_link atanır
       ├─ ProductModule::service_management_page()  ->  get_page('dashboard')
       └─ satır içi script etiketleri ayrılır, tema köprüsünce ayrıca değerlendirilir

Genel Bakış sekmesi
  └─ hizmetler controller'ı, special ve software hizmetler için
       ├─ client_overview_data()   ->  kullanım halkaları + hesap satırları
       └─ client_quick_actions()   ->  kısayol butonları

Bir kısayol ya da pano butonu
  └─ POST use_module_method  ->  izin listesi  ->  handle_{name}()

// ProductModule üzerinde bildirilir; ihtiyacınız olanı ezin.
public bool  $client_area            = false;   // yalnız müşteri basıcısı true yapar
public array $client_callable_methods = [];     // handle_ ön eki OLMADAN adlar
public array $client_readonly_methods = [];     // yukarıdakilerin alt kümesi, GET ile güvenli

public function has_client_management(): bool;
public function client_overview_data(): array;
public function client_quick_actions(int $limit = 8): array;

// Bildirilen bir çağrılabilir için işleyiciniz. Parametresiz; JSON yükünü döndürür.
public function handle_reset_usage(): array;

return [
    'gauges' => [
        [
            'key'   => 'storage',
            'label' => $this->lang['storage-usage'],
            'icon'  => 'bi bi-hdd',
            'used'  => 4.5,
            'total' => 20,          // 0 ya da altı sınırsız demektir; netlik için -1 geçin
            'unit'  => 'GB',
        ],
    ],
    'resources' => [
        // Oran biçimi: göstergeyle aynı anahtarlar.
        ['key' => 'seats', 'label' => 'Seats', 'icon' => 'bi bi-people', 'used' => 3, 'total' => 10, 'unit' => ''],
        // Değer biçimi: limiti olmayan tek bir okuma.
        ['key' => 'region', 'label' => 'Region', 'icon' => 'bi bi-globe', 'value' => 'eu-west'],
    ],
    'account' => [
        ['key' => 'account_id', 'label' => 'Account ID', 'type' => 'text', 'copyable' => true, 'value' => 'ac_1042'],
        ['key' => 'username',   'label' => 'Username',   'type' => 'text', 'copyable' => true, 'value' => 'acme'],
        ['key' => 'status',     'label' => 'Status',     'type' => 'badge', 'badge_color' => 'success', 'value' => 'Active'],
        ['key' => 'console',    'label' => 'Console',    'type' => 'link',  'value' => 'https://panel.example.com'],
    ],
];

public function client_quick_actions(int $limit = 8): array
{
    $actions = [
        // action => true: işleyiciyi yerinde, çağrılabilir izin listesi üzerinden koşturur.
        ['key' => 'reset_usage', 'label' => $this->lang['action-reset-usage'],
         'icon' => 'bi bi-arrow-counterclockwise', 'action' => true, 'method' => 'reset_usage'],

        // action => false: bunun yerine yönetim sekmesindeki bir sayfaya gider.
        ['key' => 'backups', 'label' => $this->lang['action-backups'],
         'icon' => 'bi bi-archive', 'action' => false, 'method' => 'backups'],
    ];

    // Limite uyun: kaç tanesinin sığacağına çağıran karar verir.
    return array_slice($actions, 0, $limit);
}

// ClientServices::use_module_method, kararlara indirgenmiş hali.
$service = $this->owned_managed_service($uid);      // sahiplik, tip, modül ve aktif durum denetimi
$method  = (string) Filter::init("REQUEST/method", "route");

$module = $this->client_module_instance($service);  // $client_area ve $area_link değerlerini ayarlar

$handleMethod = 'handle_' . str_replace('-', '_', $method);
$isTool       = in_array($method, ['tool_action', 'tool_table', 'sso_panel_login'], true);

// İKİ koşul birden: izin listesinde bildirilmiş VE işleyici gerçekten var.
$isClientCallable = !$isTool
    && in_array($method, $module->client_callable_methods ?? [], true)
    && method_exists($module, $handleMethod);

if (!$isTool && !$isClientCallable)
    throw new \Exception(Language::gc("website/services/err-invalid"));

// Salt okunur çağrılabilirler jetonu ve aktif hizmet şartını atlar.
$isReadonly = $isClientCallable && in_array($method, $module->client_readonly_methods ?? [], true);
$mutates    = ($method === 'tool_action' || $isClientCallable) && !$isReadonly;

if ($mutates && !\Validation::verify_csrf_token((string) Filter::init("POST/token", "hclear"), "services"))
    throw new \Exception(Language::g("needs/csrf-failed"));

if ($mutates && ($service['status'] ?? '') !== 'active')
    throw new \Exception(Language::gc("website/services/err-invalid"));

// handle_ ön eki olmadan bildirilir. Burada olmayan her şey reddedilir.
public array $client_callable_methods = ['reset_usage', 'download_report'];

// GET bağlantısı üzerinden sunulur, bu yüzden jeton ve POST şartından muaftır.
public array $client_readonly_methods = ['download_report'];

public function client_overview_data(): array
{
    $remote = $this->fetchRemoteStatus();
    if (!$remote) return [];                       // henüz bir şey sağlanmadı: gösterge yok

    $gauges = [];
    if (isset($remote['storage_limit']))
        $gauges[] = [
            'key'   => 'storage',
            'label' => $this->lang['storage-usage'],
            'icon'  => 'bi bi-hdd',
            'used'  => (float) ($remote['used_storage'] ?? 0),
            'total' => (float) $remote['storage_limit'] > 0 ? (float) $remote['storage_limit'] : -1,
            'unit'  => 'GB',
        ];

    $account = [];
    $username = (string) ($this->options['login']['username'] ?? '');

    // Controller parola satırını tam bunun ardına ekler.
    if ($username !== '')
        $account[] = ['key' => 'username', 'label' => $this->lang['username'], 'type' => 'text', 'copyable' => true, 'value' => $username];

    $status = (string) ($remote['status'] ?? '');
    if ($status !== '')
        $account[] = [
            'key'         => 'status',
            'label'       => $this->lang['account-status'],
            'type'        => 'badge',
            'badge_color' => $status === 'active' ? 'success' : 'secondary',
            'value'       => $this->lang['status-' . $status] ?? ucfirst($status),
        ];

    if (!$gauges && !$account) return [];

    return ['gauges' => $gauges, 'resources' => [], 'account' => $account];
}

public function handle_reset_usage(): array
{
    // Müşteri tetikler: API istemcisini sizin için hazırlayan hiçbir şey yok.
    $this->initApi();

    $accountId = $this->options['config']['id'] ?? '';
    if (!$accountId) throw new Exception($this->lang['err-not-provisioned']);

    $this->api->call('accounts/' . $accountId . '/usage/reset', [], 'POST');

    return ['status' => 'successful', 'message' => $this->lang['usage-reset-ok']];
}

<?php
/** @var ProductModule $module */

// Yöneticide Özet sekmesi yok, bu yüzden bu blokları korumak zorunda. Müşteri aynı
// sayıları orada zaten görüyor; o yüzden burada silmek yerine gizleyin.
if (!($module->client_area ?? false)):
?>
    <div class="row">
        <!-- gösterge widget'ları ve hesap kartı -->
    </div>
<?php endif; ?>

<!-- Aksiyonlar iki görünümde de kalır: burası yönetim yüzeyidir. -->
<button type="button" class="btn btn-primary" id="acmeResetUsage">Reset Usage</button>

<script>
(function () {
    // Her aramayı null'a karşı koruyun: $client_area ile gizlenen blok kimliklerini de
    // götürür ve buradaki yakalanmamış hata bu düğmeyi değil tüm paneli düşürür.
    var btn = document.getElementById('acmeResetUsage');
    if (!btn) return;

    btn.addEventListener('click', function () {
        run_module_method('reset_usage');
    });
})();
</script>