Masaüstü istemciyi çalıştırın

Bu kılavuz PySide6 masaüstü istemcisini bir iş istasyonuna kurar ve bir Cluster ERP sunucusuna giriş yapar. desktop kurulum ekini, başlatma komutunu, giriş iletişim kutusunu ve en sık açılış hatalarını kapsar. Arka plan bilgisi masaüstü istemciye genel bakış sayfasındadır. Sunucunun kendisinin başlatılması sunucu açılışı ve uygulama fabrikası sayfasında açıklanır.

Ön koşullar¶

• Python 3.12 veya sonrası (pyproject.toml:9).
• Erişilebilir bir Cluster ERP sunucusu. İstemci adresini api_url ayarından okur ve ayar boşsa yerel bir varsayılan kullanır (src/cluster_erp/desktop/main.py:167).
• O sunucuda bir kullanıcı hesabı. İstemci bir kullanıcı adı ve parolayla giriş yapar (src/cluster_erp/desktop/core/api_client.py:134-140).

Adımlar¶

1. Paketi depo kökünden desktop ekiyle kurun. pyproject.toml:68-71 içindeki yorum bu biçimi iş istasyonu için adlandırır; ek PySide6 ekler (pyproject.toml:72-74).

powershell pip install -e .[desktop]

2. PySide6 sürümünü kendiniz seçiyorsanız 6.8.3 kullanın. pyproject.toml:70-71 içindeki yorum 6.8.3'ü Windows'ta bilinen iyi sürüm, 6.11.0'ı DLL hatasıyla başarısız olan sürüm olarak adlandırır. CI istemciyi 6.8.3'e karşı denetler (.github/workflows/ci.yml:50).

3. İstemciyi başlatın. Modül çalıştırıldığında main() çalışır (src/cluster_erp/desktop/main.py:243-244). Aynı işlev cluster-erp-desktop konsol betiği olarak kurulur (pyproject.toml:88).

powershell python -m cluster_erp.desktop.main

4. Giriş iletişim kutusunda Sunucu alanını denetleyin (src/cluster_erp/desktop/i18n/tr.json anahtarı auth.server). Bu alan, başarıyla giriş yapılan son on adresin düzenlenebilir listesidir ve istemcinin geçerli adresiyle başlar (src/cluster_erp/desktop/widgets/login_dialog.py:108-124, src/cluster_erp/desktop/widgets/login_dialog.py:274-283). Sunucunuzun API temel adresini yazın, örneğin https://erp.example.com/api/v1.

5. İsterseniz arayüz dilini seçin ve iletişim kutusunun alt satırından Erişilebilirlik (anahtar accessibility.title) açın (src/cluster_erp/desktop/widgets/login_dialog.py:214-240).

6. Kullanıcı adını ve parolayı girin, ardından Giriş Yap (anahtar auth.login_button) seçin. İstemci isteği bir çalışan iş parçacığında gönderir (src/cluster_erp/desktop/widgets/login_dialog.py:287-309). Başarı durumunda sunucu adresini server_urls ve api_url ayarlarına yazar ve iletişim kutusunu kapatır (src/cluster_erp/desktop/widgets/login_dialog.py:311-314).

7. Sonradan başka bir sunucu gerekirse Tercihler (anahtar settings.title) içinde Sunucu Adresi (anahtar settings.api_url) değerini değiştirin ve istemciyi yeniden başlatın. İletişim kutusu değeri kaydeder ve değer değiştiyse yeniden başlatma ister (src/cluster_erp/desktop/widgets/preferences_dialog.py:117-133).

Sonucu doğrulayın¶

• Ana pencere bir kenar çubuğu, bir karşılama sekmesi ve bir durum çubuğuyla açılır (src/cluster_erp/desktop/widgets/main_window.py:69-137).
• Sunucu kökündeki GET /health 200 döndüğünde durum çubuğu Bağlı (anahtar app.connected) gösterir (src/cluster_erp/desktop/widgets/status_bar.py:56-88, src/cluster_erp/desktop/core/api_client.py:326-333). Denetim her 15 saniyede bir yapılır (src/cluster_erp/desktop/widgets/status_bar.py:49-51).
• Kenar çubuğu yalnızca sunucu metadata'sının bildirdiği, kullanıcının okuyabildiği ve uygulamalarını kullanabildiği bölümleri listeler (src/cluster_erp/desktop/widgets/sidebar.py:159-240). Bkz. metadata deposu ve yabancı anahtar önbelleği.

Sorun giderme¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Masaüstü istemci
• Masaüstü istemciye genel bakış
• Diller, temalar ve erişilebilirlik
• Yerel geliştirme kurulumu

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.