Platform Management

Genel Bakış

Platform Management, Nuve'yi işleten ekip için organizasyonlar (tenant) arası (cross-tenant) bir yönetim panelidir. Admin Panel'in aksine tek bir organizasyonla sınırlı değildir — hangi organizasyonun hangi modülleri satın aldığını, aktif/askıya alınmış durumunu ve platform yöneticisi yetkisine kimin sahip olduğunu tüm müşteriler genelinde yönetir. Erişim, kullanıcının rolünden bağımsız ayrı bir bayrakla (is_platform_admin) korunur; sıradan bir organizasyon admin'i bu panele giremez.

Temel Kavramlar

• Organizasyon (Tenant) — her müşteri şirketi; ad, adres (slug), aktiflik durumu, satın alınan modül listesi ve kullanıcı sayısıyla temsil edilir.
• Modül Yetkilendirmesi (enabled_modules) — bir organizasyonun satın aldığı ürün kümesi (bom_master, pdm_vault, dpp, nuve_recipe vb.); bu liste dışındaki bir modüle erişim, kullanıcının rolü ne olursa olsun 403 ile reddedilir.
• Platform Yöneticisi (is_platform_admin) — organizasyon içi rolden (admin, plm_config vb.) tamamen ayrı, cross-tenant erişim ekseni; en az bir platform yöneticisi her zaman kalmalıdır — son kalanın yetkisi kaldırılamaz.
• Askıya Alma (is_active) — bir organizasyon askıya alındığında o organizasyonun tüm kullanıcıları giriş yapamaz (login 403 döner); yeniden aktifleştirildiğinde giriş anında geri gelir.
• Organizasyon Bazlı Denetim Günlüğü — her platform-paneli aksiyonu (modül değişikliği, askıya alma, yetki verme) hem genel denetim akışına hem de ilgili organizasyonun kendi denetim sekmesine tenant_id ile damgalanarak düşer.

Tipik Kullanım Akışı

1. Sol menüden Platform Management'ı açın (yalnızca platform yöneticileri görür); organizasyon tablosunda tüm müşterileri (ad, adres, durum, oluşturma tarihi, modül rozetleri, kullanıcı sayısı) görün.
2. + Yeni Organizasyon ile şirket adı, adres (slug), ilk yönetici kullanıcı bilgileri ve başlangıç modüllerini girerek yeni bir müşteri oluşturun — adres canlı müsaitlik kontrolüyle önerilir.
3. Bir organizasyon satırına tıklayıp detay paneline girin: modül checkbox'larını değiştirip Kaydet ile satın alınan modülleri güncelleyin.
4. Gerekirse organizasyonu askıya al veya aktifleştir.
5. Kullanıcı listesinden bir kullanıcıya platform yöneticisi yetkisi verin veya kaldırın (son kalan yetkiliyi kaldırma engellenir).
6. Organizasyonun kendi denetim kuyruğunu (audit log) inceleyerek o müşteride yapılan son işlemleri doğrulayın.

Özellik Referansı

• Organizasyon listesi ve oluşturma: ad, adres (slug), ilk admin kullanıcı, başlangıç modül seti
• Modül yetkilendirmesi güncelleme (PATCH /organizations/{id}/modules) — geçersiz modül adı 400 ile reddedilir
• Aktif/askıya alma (PATCH /organizations/{id}/status) — askıya alınan organizasyonun kullanıcıları anında giriş yapamaz hale gelir
• Platform yöneticisi yetkisi verme/kaldırma (PATCH /organizations/{id}/users/{user_id}/platform-admin) — son platform yöneticisi korumalıdır
• Organizasyon detayı: kullanıcı listesi + organizasyona özel denetim günlüğü (GET /organizations/{id})
• Genel veya organizasyon filtresiyle denetim günlüğü sorgulama (GET /audit?tenant_id=)
• Tüm uçlar require_platform_admin arkasında; kimliği doğrulanmamış erişim 401, yetkisiz erişim 403 döner

Kısıtlar / Bilinen Sınırlar

• Organizasyon silme veya arşivleme işlevi henüz yok — sadece aktif/askıya alma durumu değiştirilebilir.
• İlk platform yöneticisi yalnızca sistemin ilk admin kullanıcısına (bootstrap seed_admin()) otomatik atanır; sonraki platform yöneticileri panel üzerinden elle verilmelidir.
• Faturalama, kullanım ölçümü ve self-servis plan yükseltme bu panelin kapsamında değildir — modül yetkilendirmesi şu an yalnızca platform yöneticisi tarafından elle yönetilir.