Yönetici konsolu

Başlangıç seviyesinde izlenecek yol

Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun, Web yerel kurulumunu tamamlayın ve bu monorepo'yu düzenleyicinizde kökünden açın. Web ayarları apps/web/.env.local'ye aittir; Next.js, .env kökünü okumaz. Varsayılan sahte modda /dashboard, veritabanı olmayan bir demodur; /auth'nin taşınan bir veritabanına ihtiyacı var.

Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır.

1. Yerel bir test hesabı oluşturmadan önce, kendi adresinizi yalnızca sunucu ADMIN_EMAILS listesine ekleyin ve uygulamayı yeniden başlatın.

2. Taşınan test veritabanına kaydolun ve /admin'yi açın; mevcut kullanıcı ve kuruluş sayfalarını inceleyin.

3. Bu, çalışma alanı sahipliğini değil, platform yöneticisini verir. Erişim reddedilirse tam e-posta ve sunucu yapılandırmasını doğrulayın; keyfi kullanıcıları yükseltmeyin veya üretime karşı test etmeyin.

Özel kod için, sağlanan prompts/README.md ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için prompts/new-app-screen.md veya genel bir sayfa için prompts/new-landing-page.md. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan AGENTS.md, .ai/PROJECT_CONTEXT.md ve eşleşen .ai/ aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın.

• Başlamadan önce
• Terminal temelleri
• Web yerel kurulumu
• Aracı istemleri ve proje belleği

Yönetici sınırını oluşturun

ADMIN_EMAILS, yalnızca sunucuya yönelik, virgülle ayrılmış bir önyükleme listesidir. Listelenen kullanıcılar kayıt sırasında platform yöneticisi rolünü alırlar. Bu olmadan yetkili bir veritabanı/yönetici yolu üzerinden erişim izni verin; İlk rastgele ziyaretçiyi yönetici yapmayın.

Platform yöneticisi, çalışma alanı sahibinden/yöneticisinden farklıdır. /admin ve kullanıcı, organizasyon, bayrak, duyuru ve bekleme listesi sayfaları platform rolünü kontrol eder.

Uygulanan kontrolleri kullanın

Varsayılan Better Auth motoru, yönetici kullanıcı yönetimi, yasaklamalar ve kimliğe bürünme sağlar. Uygulama, denetim izleriyle birlikte platform görünümleri oluşturur. Kimliğe bürünmeyi doğrulanmış yönetici erişimiyle sınırlayın, durumunu görünür yapın ve çıkışta orijinal yönetici oturumunu geri yükleyin.

Auth.js, Better Auth yönetici eklentilerini otomatik olarak devralmaz. Motorları değiştirmeden önce admin.ts, admin-actions.ts ve kimlik doğrulama sağlayıcı davranışını gözden geçirin.

Ayrıcalıklı eylemleri doğrulayın

Yönetici olmayan reddi, yönetici erişimini, yasaklı kullanıcı oturumlarını, kimliğe bürünmeyi başlatma/durdurma ve etkinleştirdiğiniz eylemleri test edin. Tüm yönetici rotalarını genel indekslemenin dışında tutun.

• Özellik işaretleri
• Duyurular
• Bekleme listesi yönetimi

Kurulum ve yapılandırma

/admin yüzeyi, çalışma alanları, üyeler ve ürün durumu üzerinde operatörün inceleme görünümüdür. ADMIN_EMAILS (ya da tüketen üründeki admin eklenti yapılandırması) kimin ulaşacağına karar verir; her yönetici rotası yetkilendirmeyi sunucuda yeniden kontrol eder.

Özellik bayrakları (feature-flag-runtime.ts) yapılandırılmamış her şeyi varsayılan kapalı tutar — eksik bir bayrak asla sessizce bir yüzeyi etkinleştiremez — ve bayrak başına geçersiz kılmalar featureFlagOverride tablosunda yaşar.

/admin                    operator dashboard
announcement-actions.ts   broadcast in-app notices
resolveFeatureFlags(...)  bulk flag resolution for a caller context

Uygulama iş akışı

İnceleme ve destek işlemleri için yönetici eylemlerini kullanın (çalışma alanı arama, üye yönetimi, duyuru yayını). Mutasyonları denetlenmiş ve yetkilendirmeyi gezinmede değil eylem sınırında kontrol edilmiş tutun.

Özellikleri bayraklar arkasında yayınlayın: kodu karanlık gönderin, çalışma alanı başına ya da genel olarak etkinleştirin ve yüzey kalıcı olduğunda bayrağı kaldırın. Platform impersonation, ürünün PRODUCT.md'si açıkça yetkilendirmedikçe donmuş kalır.

Doğrulama ve sorun giderme

Yönetici olmayanın reddedildiğini, devre dışı bayrağın yüzeyini uçtan uca gizlediğini (nav, rota, eylem), geçersiz kılmanın yalnızca hedefi için çözüldüğünü ve duyuruların amaçlanan kitleye ulaştığını doğrulayın. Yönetici testleri önce reddedilen yolu kapsamalıdır.