Publish veya Update düğmesinde "Your Cloud Balance is insufficient to publish" ya da "Your Cloud Balance is insufficient to update" yazıyorsa, Cloud cüzdanınızdaki bakiye tükenmiştir.

Bunu düzeltmek için:

1. Mevcut bakiyenizi kontrol etmek için Settings > Cloud & AI bölümüne gidin.

2. Top up now seçeneğini seçin ve Cloud cüzdanınıza bakiye ekleyin.

3. Publish paneline geri dönün ve tekrar deneyin.

Not: Cloud cüzdanınız, abonelik kredilerinizden ayrıdır. Cloud cüzdanı barındırma ve dağıtım hizmetlerini finanse ederken, abonelik kredileri AI agent konuşmaları için kullanılır.

1. Depolama kullanım görünümünü kontrol edin ve en büyük sohbetleri, projeleri ve dosyaları belirleyin.
2. Daha sonra ihtiyaç duyabileceğiniz her şeyi indirin veya yedekleyin.
3. Yalnızca gereksiz öğeleri silin. Sohbet silme işlemi ilişkili disk verilerini kaldırmayı öneriyorsa, bu seçeneği yalnızca verilerin güvenle atılabileceğini doğruladıktan sonra seçin.
4. Sayfayı yenileyin ve kullanılabilir depolama alanının arttığını doğrulayın.
5. Publish bölümüne dönün ve bir kez daha deneyin.

Silme işlemi kalıcı olabilir ve kaldırılan bir dosyaya başvuran bir projeyi bozabilir. Kullanım düşmezse, depolama görünümü, plan, proje bağlantısı ve başarısız yayınlama zamanı ile birlikte Support ile iletişime geçin.

Güvenlik taramasının bitmesini bekleyin, ardından yayınlamadan önce işaretlenen her öğeyi gözden geçirin.

1. Resolve All seçeneğini seçin ve etkilenen davranışı inceleyin. Üretimde kullanmadan önce açığa çıkan gizli bilgiler, kimlik doğrulama, izinler, kullanıcı verileri veya güvensiz dış erişimle ilgili sorunları düzeltin.
2. Bir gizli bilgi açığa çıkmış olabilir ise, yayınlamadan önce bunu projeden kaldırın ve ilgili sağlayıcı üzerinden yenileyin.
3. Taramayı yeniden çalıştırın ve etkilenen akışı doğrulayın.
4. Publish Anyway seçeneğini yalnızca sorumlu bir gözden geçiren kişi kalan kritik olmayan riski anlıyor ve kabul ediyorsa kullanın. Nedeni kaydedin ve üretim sitesinde çözülmemiş bir riski atlamaktan kaçının.

Bir bulgunun etkisini belirleyemiyorsanız, yayınlamayın. Bulgu metni ve temizlenmiş kanıtlarla Support veya güvenlik sorumlunuzla iletişime geçin.

1. Platformun üretim URL'sini ve özel alan adını ayrı ayrı test edin. Ayrıca kök sayfayı, başarısız olan belirli sayfa veya API yolu ile karşılaştırın.
2. Tam durum kodunu, tam URL'yi, zamanı ve saat dilimini ve hatanın sürekli mi yoksa aralıklı mı olduğunu kaydedin.
3. En son dağıtım durumunu ve yakın zamanda yapılan bir bağımlılık, ortam değişkeni, veritabanı veya dış hizmet değişikliğinin hatanın başlangıcıyla eşleşip eşleşmediğini kontrol edin.
4. İlgili Console ve Network hatalarını yakalayın.

Hata devam ederse, yeniden üretim adımları, etkilenen sürüm ve temizlenmiş tanılama bilgileriyle Support ile iletişime geçin. Bir HAR, komut çıktısı veya ekran görüntüsü göndermeden önce çerezleri, Authorization başlıklarını, jetonları, gizli sorgu parametrelerini, kişisel verileri ve ödeme bilgilerini kaldırın.

Dağıtımınız zaman aşımına uğrarsa veya canlı site geçici olarak kullanılamazsa:

1. Platformun Prod alt alan adının ve Preview'un ikisinin de mi erişilemez olduğunu, yoksa yalnızca birinin mi erişilemez olduğunu kontrol edin.

2. Mevcut hata sayfasını görünür tutun — Publish'e tekrar tekrar tıklamayın.

3. Yakın zamanda bağımlılıkları, başlangıç giriş noktalarını veya veritabanı bağlantılarını değiştirip değiştirmediğinizi kontrol edin; bu değişiklikler dağıtımı etkileyebilir.

Sorun devam ederse Support ile iletişime geçin ve şunları ekleyin:

- Proje bağlantısı ve canlı URL

- Hatanın zamanı ve saat diliminiz

- Sürüm numarası ve hata sayfası ekran görüntüsü

- Preview'un normal çalışıp çalışmadığı

- Yakın zamanda bağımlılıkları, başlangıç girdisini veya veritabanı bağlantısını değiştirip değiştirmediğiniz

Publish paneli düğme griyken "latest" gösteriyorsa veya "Building" üzerinde takılı kaldıysa:

1. Publish'e tekrar tekrar tıklamayın — bu işlemi hızlandırmaz ve yinelenen derleme görevleri oluşturabilir.

2. Birkaç dakika bekleyin ve sayfayı yenileyin.

3. Yeniledikten sonra durum değişmezse Support ile iletişime geçin.

Support ile iletişime geçerken aşağıdakileri ekleyin:

- Sohbet bağlantısı

- Publish panelinin tam ekran görüntüsü (sayfa URL'si, sürüm numarası ve düğme durumu dahil)

- Olayın zamanı ve saat diliminiz

- Şu anda görüntülenen sürüm numarası

- Hangi adımda "Building" göstermeye başladığı veya düğmenin gri hale geldiği

1. Görselin Uygulama Görüntüleyici içinde mi, yayınlanan sitede mi, yoksa her iki yerde de mi eksik olduğunu kontrol edin.
2. Bir kez Reload App Viewer seçeneğini seçin. Sorun yalnızca canlı sitedeyse, en son sürümün yayınlandığını veya güncellendiğini doğrulayın.
3. Agent'a sayfayı, görünmesi gereken görseli ve görselin başlangıçta nereden geldiğini söyleyin. Mevcut projenin hâlâ doğru görsel adını ve konumunu kullanıp kullanmadığını kontrol etmesini isteyin.
4. Orijinal görsel kaldırıldıysa veya yeniden adlandırıldıysa, amaçlanan görseli yeniden yükleyin veya seçin, ardından sayfayı tekrar test edin.
5. Görsel Uygulama Depolama veya başka bir bağlı hizmet kullanıyorsa, amaçlanan hizmetin bağlı olduğunu ve dosyanın hâlâ orada bulunduğunu doğrulayın.

Görsel hâlâ yüklenmiyorsa, Atoms Support ile Chat Link, etkilenen sayfa URL'si, görsel adı veya kaynağı ve bir ekran görüntüsü ile iletişime geçin. Özel erişim bağlantıları, parolalar, anahtarlar veya jetonlar eklemeyin.

Dışa aktarılan self-host paketi başarıyla indiriliyor ancak çalışmıyorsa:

1. Ortam gereksinimleri ve kurulum adımları için dışa aktarma paketine dahil edilen README dosyasını kontrol edin.

2. Çalışma ortamınızın gereksinimlerle eşleştiğini doğrulayın (OS sürümü, Docker sürümü, Node.js sürümü).

3. Başlatma komutunu çalıştırın ve hata mesajları için tam çıktıyı gözden geçirin.

Sorun devam ederse Support ile iletişime geçin ve şunları ekleyin:

- Dışa aktarma sürümü ve indirme zamanı

- Çalışan OS ve Docker sürümü

- Çalıştırılan tam komut ve tam çıktı

- Başarısız olan script veya API yolu

- Beklenen dağıtım yöntemi

Önemli: Temizlenmiş bir yapılandırma örneği ekleyin, ancak parolaları, gizli bilgileri veya jetonları ASLA eklemeyin.

Uygulama Görüntüleyici ve yayınlanan site projenizin farklı aşamalarını gösterir. Görsel bir değişikliği kaydetmek, canlı siteyi kendi başına güncellemez.

1. Design içinde Save seçeneğini seçin ve mevcut Agent görevinin veya derlemenin bitmesini bekleyin.
2. Publish bölümünü açın. Yayınlama en son proje sürümünü kullanır; Publish panelinde sürüm seçici yoktur.
3. İlk sürüm için Publish veya sonraki bir sürüm için Update seçeneğini seçin. Panel Up to date gösterene kadar bekleyin.
4. Canlı siteyi yeni bir sekmede açın ve bir kez yeniden yükleyin.
5. Varsayılan Atoms adresi değişikliği gösteriyor ancak özel alan adı göstermiyorsa, aynı sürümü tekrar tekrar yayınlamak yerine alan adı bağlantısını kontrol edin.

Canlı site hâlâ yanlış sürümü gösteriyorsa, Atoms Support ile Chat Link, canlı URL, yayınlamayı amaçladığınız sürüm, zaman ve saat dilimi ve Uygulama Görüntüleyici ile canlı sitenin ekran görüntüleriyle iletişime geçin.

1. Anlık riski kontrol altına alın. Sürüm hassas verileri açığa çıkarıyorsa veya güvensiz davranış oluşturuyorsa, App Status bölümünü açın ve uygun bir Atoms Bulutu uygulaması için Pause kullanın ya da herkese açık erişimi kaldırmak için Unpublish kullanın. Aktif bir risk yoksa, gereksiz kesintiye neden olmaktan kaçının.
2. Etkilenen alan adını, yayınlama zamanını, mevcut sürümü, hedeflenen sürümü ve iş etkisini kaydedin.
3. Mevcut agent görevi durduktan sonra Versions bölümünü açın, bilinen son iyi sürümü seçin ve Restore this version seçeneğini seçin.
4. Geri yüklenen sürümü Preview içinde doğrulayın; kritik oturum açma, ödeme ve veri akışları dahil, ardından bunu Publish veya Update edin.

Bir proje sürümünü geri yüklemek, üretim veritabanı değişikliklerini veya dış eylemleri geri almayabilir. Geri alma işlemini taklit etmek için üretim verilerini üzerine yazmayın veya silmeyin. Veri, kimlik bilgileri, ödemeler veya yıkıcı değişiklikler söz konusuysa hemen Support ile iletişime geçin.

1. Mevcut agent görevini durdurun veya bitmesini bekleyin; çakışan çalışma etkinken bir sürüm geri yüklenemez.
2. Versions bölümünü açın, bilinen son iyi sürümü bulun ve Restore this version seçeneğini seçin.
3. Geri yüklenen projeyi Preview içinde gözden geçirin ve değişen kritik akışları test edin.
4. Yalnızca Preview sonucu doğruysa Publish veya Update edin.

Bir proje sürümünü geri yüklemek, üretim veritabanı kayıtlarını, şema değişikliklerini, ortam değişkenlerini, ödemeleri, e-postaları veya diğer dış eylemleri mutlaka geri almaz. Sürüm üretim verilerini değiştirdiyse veya hedef sürüm kullanılamıyorsa durun ve her iki sürüm numarası, etkilenen alan adı ve gerekli veri koruma sonucu ile Support ile iletişime geçin.

Pause ve Unpublish iki farklı işlemdir:

Pause (yalnızca Atoms Bulutu projeleri):

- Uygulama ziyaretçiler için kullanılamaz hale gelir.

- Sunucu kaynakları ayrılmış olarak kalır ve faturalandırma devam eder.

- Uygulamayı istediğiniz zaman App Status üzerinden devam ettirebilirsiniz.

Unpublish (tüm projeler):

- Web sitesi tamamen çevrimdışı olur. Yayınlanan URL'yi kullanan herkes erişimi kaybeder.

- Atoms Bulutu projeleri için sunucu kaynakları serbest bırakılır.

- Projeyi daha sonra yeniden yayınlayabilirsiniz, ancak siz bunu yapana kadar ziyaretçiler erişemez.

Hızlı yeniden başlatma ile geçici olarak yayından kaldırmak için Pause kullanın. Siteyi tamamen kaldırmak için Unpublish kullanın.

Tarayıcınız "too many redirects" gösteriyorsa veya sayfa içerik göstermeden sürekli yeniden yükleniyorsa:

1. Yönlendirme döngüsünün alan adı yapılandırmasından mı yoksa uygulamanın kendisinden mi kaynaklandığını belirlemek için platformun varsayılan Prod alt alan adını deneyin (özel alan adınızı değil).
2. Varsayılan Prod alt alan adı çalışıyorsa, platformla çakışabilecek yönlendirme kuralları için özel alan adınızın DNS ayarlarını ve alan adı kayıt kuruluşunuzu kontrol edin.
3. Önbelleğe alınmış yönlendirmeleri elemek için tarayıcı önbelleğinizi temizleyin veya Gizli pencerede test edin.

Sorun devam ederse Support ile iletişime geçin ve şunları ekleyin:

- Yönlendirme döngüsünü gösteren tam URL

- Varsayılan Prod alt alan adına erişilip erişilemediği

- Alan adı ve DNS sağlayıcısı

- Tam hata ekran görüntüsü

Uygulamanız Preview içinde çalışıyor ancak eksik veya boş ortam değişkenleri nedeniyle production'da başarısız oluyorsa:

1. Ortam değişkeninin son yayınlamadan önce mi sonra mı kaydedildiğini kontrol edin. Sonra kaydedildiyse, değişikliğin etkili olması için yeniden yayınlamanız gerekir.
2. Değişkenin doğru ortam için ayarlandığını doğrulayın (Development ve Production).
3. Alt hizmet hata mesajının bir ipucu verip vermediğini kontrol edin — örneğin, "unauthorized" genellikle o ortamda bir API anahtarının boş veya yanlış olduğu anlamına gelir.

Sorun devam ederse Support ile iletişime geçin ve şunları ekleyin:

- Proje bağlantısı veya canlı URL

- Etkilenen anahtar adı ve hangi ortamda sorun olduğu

- Alt hizmetten gelen tam hata

- Yapılandırma sayfasının temizlenmiş ekran görüntüsü

- Yapılandırmanın yayınlamadan önce mi sonra mı kaydedildiği

Önemli: Yalnızca anahtar adlarını sağlayın. Gizli değerleri, parolaları veya jetonları GÖNDERMEYİN.

Bulgular, farklı konumlara işaret ederken benzer ifadeler kullanabilir. Benzer ifade kullanılması, sonuçların yinelenen olduğu anlamına gelmez.

1. Her sonuç için bulgu adını ve gösterilen konumu karşılaştırın.
2. Tekrarlanan ifadeyi göz ardı etmek yerine her benzersiz konumu gözden geçirin.
3. Birden fazla bulgunun aynı temel nedeni varsa, o nedeni düzeltin ve ardından her konumu yeniden kontrol edin.
4. Güncellenmiş sürümde güvenlik taramasını yeniden çalıştırın.

Aynı bulgu ve konum hâlâ birden fazla kez görünüyorsa, Atoms Support ile Chat Link, tarama zamanı ve saat dilimi, bulgu sayısı ve sansürlenmiş bir ekran görüntüsüyle iletişime geçin. Bir bulguda görünebilecek parolaları, anahtarları, jetonları veya diğer hassas bilgileri kaldırın.

Bildirilen bulgu olmadan tamamlanan bir tarama yararlı bir kontroldür, ancak her güvenlik veya çalışma zamanı sorununun bulunduğunu garanti edemez. Tarama seçilen proje sürümünü kontrol eder; uygulamanızın yine de gerçek kullanıcıların kullanacağı şekilde test edilmesi gerekir.

Yayınlamadan önce uygulamanızdaki önemli yolculukları test edin; buna oturum açma, kullanıcı rolleri, özel verilere erişim, ödemeler ve bağlı hizmetler dahildir. Farklı roller için ayrı test hesapları kullanın ve her hesabın yalnızca kendisi için amaçlanan bilgilere ve işlemlere erişebildiğini doğrulayın.

Hesapları, özel verileri, ödemeleri veya kimlik bilgilerini açığa çıkarabilecek bir production sorunu keşfederseniz, önce etkilenen özelliğin kullanımını durdurun veya erişimi kısıtlayın. Açığa çıkmış olabilecek tüm kimlik bilgilerini yenileyin, ardından Atoms Support ile Chat Link, etkilenen sürüm, sorunu yeniden üretme adımları, zaman ve saat dilimi ve sansürlenmiş bir ekran görüntüsüyle iletişime geçin. Açığa çıkan kimlik bilgisinin kendisini paylaşmayın.

Tarama, yalnızca yöneticiye açık bir işlemin korumasız olabileceğini bildiriyorsa, yetkisiz kullanıcıların bunu kullanamadığını doğrulayana kadar bulguyu çözülmemiş kabul edin. Yönetici düğmesini gizlemek, işlem başka bir yolla yine de istenebiliyorsa yeterli değildir.

1. Bulguyu açın ve adlandırdığı işlemi veya konumu belirleyin.
2. O işlemi hangi oturum açmış rollerin kullanmasına izin verilmesi gerektiğine karar verin.
3. Agent'tan, yalnızca düğme görüntülendiğinde değil, işlem istendiğinde de kullanıcının iznini kontrol etmesini isteyin.
4. İşlemi oturum kapalıyken, normal bir test hesabıyla ve yetkili bir yönetici test hesabıyla test edin.
5. Reddedilen denemelerin özel veri açığa çıkarmadığını ve değişiklik yapmadığını doğrulayın, ardından güvenlik taramasını yeniden çalıştırın.

Yetkisiz bir hesap işlemi hâlâ kullanabiliyorsa etkilenen özelliği yayınlamayın. Çözemiyorsanız Atoms Support ile Chat Link, bulgu metni, etkilenen sürüm ve sansürlenmiş bir ekran görüntüsüyle iletişime geçin.

HTTPS, bilgi kullanıcı ile hizmet arasında taşınırken onu korur. Tarama bir HTTPS sorunu bildiriyorsa, etkilenen adresi, kaynağı, geri çağrıyı veya alan adı yapılandırmasını belirlemek için tam bulguyu kullanın.

1. Bulguyu açın ve bildirdiği tam konumu ve adresi not edin.
2. Agent'tan bu belirli bağlantıyı sağlayıcısının desteklediği güvenli adresle değiştirmesini veya ilgili alan adı yapılandırmasını düzeltmesini isteyin.
3. Sertifika uyarılarını görmezden gelmeyin veya dış hizmet güvenli bir eşdeğer belgelemiyorsa adresi körü körüne değiştirmeyin.
4. Etkilenen kullanıcı yolculuğunu yeniden test edin ve hiçbir parola, jeton, ödeme detayı veya özel bilginin güvensiz bir bağlantı üzerinden gönderilmediğini doğrulayın.
5. Güncellenmiş sürümde güvenlik taramasını yeniden çalıştırın.

Bulgu düzeltemediğiniz özel bir alan adı veya sertifikayla ilgiliyse, Atoms Support ile Chat Link, etkilenen URL, bulgu metni, zaman ve saat dilimi ve sansürlenmiş bir ekran görüntüsüyle iletişime geçin.

Row Level Security veya RLS, her kullanıcının hangi veritabanı satırlarını okuyabileceğini veya değiştirebileceğini kontrol eden bir Supabase özelliğidir. Bu bulgu yalnızca proje Supabase kullandığında ve tarama erişim kurallarının gözden geçirilmesi gereken bir tablo belirlediğinde geçerlidir.

1. Bulguyu açın ve adlandırdığı tabloyu belirleyin.
2. Bu tablonun verilerini kimlerin görüntüleyebilmesi, ekleyebilmesi, düzenleyebilmesi veya silebilmesi gerektiğini yazın.
3. Agent'tan bu kullanıcı yolculuklarını destekleyen en az izinli Supabase ilkelerini oluşturmasını isteyin.
4. Oturum kapalıyken ve her rol için ayrı bir test hesabıyla test edin. Her hesabın yalnızca amaçlanan satırlara ve işlemlere erişebildiğini doğrulayın.
5. İlkeler uygulandıktan sonra güvenlik taramasını yeniden çalıştırın.

Uyarıyı temizlemek için RLS'yi devre dışı bırakmayın veya her kullanıcıya izin vermeyin. Mevcut verileri etkileyebilecek bir değişiklik yapmadan önce planı doğrulayın ve uygun olduğunda güvenli bir yedek veya dışa aktarma bulundurun. Supabase anahtarlarını veya veritabanı kimlik bilgilerini asla Chat içinde veya ekran görüntülerinde paylaşmayın.