For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/feature-flags.md (or send Accept: text/markdown).
Özellik bayrakları ve duyurular
Karanlıkta yayınlayın, workspace başına kapılayın ve üyelere yayınlayın.
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. Platform yöneticisi olarak oturum açın ve /admin/flags'yi açın; bir test bayrağı oluşturun veya seçin ve bunu açıkça etkin, ardından devre dışı olarak ayarlayın.
2. Bayrak yazan ürün yüzeyini yenileyin ve sunum değişikliklerini onaylayın.
3. Bayrak etkinleştirildiğinde roller ve yetkiler yine de sunucu eylemlerini korumalıdır. API devre dışıyken erişilebilir olmaya devam ederse, amaçlanan yere bir sunucu tarafı bayrak kontrolü ekleyin.
Ö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.
Yönetici'de bayrakları yapılandırma
/admin/flags ve feature-flags.ts, kitin işaret yönetimi/değerlendirme yolunu sağlar. Bayrak yapılandırması platform yöneticisine aittir; bir ürün kullanıcı arayüzü, bayrağı değiştirme yetkisini almadan, izin verilen bir özelliğe tepki verebilir.
Etkin ve devre dışı davranışı doğrulama
Varsayılanları, eksik bayrakları, güncellemeleri, rol reddini ve işaretli sunucu eylemlerini test edin. Kullanıma alma mantığını eklerken çalışma alanı erişim kontrollerini koruyun.
Kurulum ve yapılandırma
feature-flag-runtime, bir çağıran bağlamı için bayrakları çözer: yapılandırılmamış bayraklar varsayılan olarak kapalıdır ve bayrak başına geçersiz kılmalar belirli workspace'leri veya kullanıcıları hedefler. Eksik bir bayrak asla sessizce bir yüzeyi etkinleştiremez.
Platform duyuruları (announcement-actions), üyelerin zaten okuduğu aynı bildirim yüzeyi üzerinden uygulama içi bildirimler yayınlar — listActiveAnnouncements banner'ı besler, dismissAnnouncementAction kapatmayı kaydeder.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Uygulama iş akışı
Kodu karanlıkta gönderin: bir bayrağın arkasında birleştirin, kendi workspace'iniz için etkinleştirin, sonra genişletin. Yüzey kalıcı olduğunda bayrağı kaldırın — bayat bir bayrak ikinci bir doğruluk kaynağıdır.
Bayrağı sunucu sınırında VE navigasyonda kontrol edin: açık bir rotaya sahip gizli bir bağlantı kapılı bir özellik değildir. Duyuruları işlemsel e-posta yolundan uzak tutun — bunlar ürün haberleridir, makbuz değil.
Doğrulama ve sorun giderme
Devre dışı bir bayrağın nav, rota ve eylemi uçtan uca gizlediğini; bir geçersiz kılmanın yalnızca hedefi için çözüldüğünü; ve temizlenen bir bayrağın varsayılana döndüğünü doğrulayın. Duyuru teslimatının amaçlanan workspace'lere ulaştığını ve kapatmanın kalıcı olduğunu test edin.