Blueforce-Linux/docs/35-GUI-SURFACES.md

36 lines
2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# GUI yüzeyleri: kurulum ve uzaktan yönetim
## Karar
Python GUI tek bir "yönetim ekranı" olmaktan çıkarılır. Açılışta iki bağımsız çalışma alanı sunulur:
1. **Kurulum konsolu** — tek fiziksel/uzak cihazın tanımlanması, ön kontrolü, kurulumu ve doğrulaması.
2. **Uzaktan yönetim portalı** — envanterdeki bilgisayarların izlenmesi, seçilmesi ve kontrollü operasyonların çalıştırılması.
İki yüzey yalnızca `CatalogueBackend`/gerçek backend sözleşmesini paylaşır. Görünüm, navigation, seçili cihaz, form state'i ve çıktı state'i paylaşılmaz.
## Aktif kullanıcı ve bayi kimliği
Geçerli bayi numarası uygulamanın aktif kullanıcı kimliğidir: `bf-<bayi-no>`. İlk geçerli kurulum onayında yerel GUI tercihlerine kaydedilir ve sonraki açılışlarda otomatik yüklenir. Kurulum ekranındaki alan kayıtlı durumda kilitlidir; değişiklik yalnızca **Bayi no değiştir** onayıyla açılır. Portalın ayarlar bölümü aynı değişikliği açık onayla yapar. Bu tercih uygulama kimliğidir; işletim sistemindeki `blueforce` bakım hesabını sessizce yeniden adlandırmaz.
## Kurulum konsolu
- Tek hedef: 8 haneli bayi numarası.
- Dört adımlı zihinsel model: tanımla → ön kontrol → kur/kaydet → doğrula.
- Filo, dalga ve toplu operasyon kontrolleri gösterilmez.
- Komut backend tarafından üretilir, onaydan önce görünür; canlı çıktı ayrı paneldedir.
## Uzaktan yönetim portalı
- Ana yüzey envanter tablosudur; arama ve cihaz seçimi ilk sınıf kontrollerdir.
- Portal navigasyonu kurulum akışından ayrıdır.
- İlk sürüm salt-okunur operasyonları açık tutar; yıkıcı filo operasyonları mevcut güvenlik kapıları ve ayrıntılı operasyon ekranına taşınır.
- Portalın sonraki genişlemesi cihaz detay drawer'ı, operasyon kuyruğu ve denetim kaydıdır.
## Komut satırı
```text
python3 -m bfos.ui_gui # çalışma alanı seçimi
python3 -m bfos.ui_gui --install # kurulum konsolu
python3 -m bfos.ui_gui --portal # uzaktan yönetim portalı
```