Review linki (kurulumsuz inceleme) · Belgeler

Tek URL paylaş; reviewer'lar canlı siteni sıfır kurulumla işaretlesin. İnceleme araçları otomatik yüklenir, widget gömmek de hesap cambazlığı da gerekmez.

Geri bildirim almanın en hızlı yolu: link paylaşmak. review.pinappai.com/p/<projen>/, canlı siteni PinAppAI inceleme araçları önceden yüklenmiş halde sunar: siten hiçbir şey gömmeden ve reviewer hiçbir şey kurmadan pin bırakır, yorum yazar, karar verir.

Etkinleştir

Projenin Ayarlarında Site origin (review link) alanını doldur (ya da setup-project workflow’u sırasında AI ajanının teklifini kabul et). Hepsi bu:

https://review.pinappai.com/p/<proje-slug>/

Reviewer’lar siteni o URL üzerinden, üretimdeki haliyle gezer. Gezinme review linkinde kalır; her pin ve karar gerçek sayfa URL’lerine kaydedilir. Widget-gömülü deneyimden hiçbir şey çatallanmaz.

Review linki tanımlıysa reviewer davet e-postası bu linki tıklanmaya hazır halde içerir.

Bir sayfayı incele

Review link üzerinden sunulan her sayfa, sağ altta aynı inceleme araçlarını taşır: bir element’e pin bırak, yorum yaz ya da ekran görüntüsü al. Reviewer’lar doğrudan canlı siten üzerinde, kendi ekranlarında göründüğü haliyle çalışır: masaüstü uygulaması yok, tarayıcı eklentisi yok, senin tarafında gömülü hiçbir şey yok.

Bir değişiklik açmak için: element’i seç, istersen tam metni öner, bir not ekle ve Submit’e bas. Element locator’ı, gerçek sayfa URL’i ve kimin istediğiyle birlikte değişiklik-talebi akışına düşer.

Review link üzerinden masaüstünde açık canlı site: seçili ve pin işaretiyle vurgulanmış hero başlığı ve önerilen metin, bir yorum ve Submit düğmesi gösteren açık bir kompozitör

Preview varyantı

İnceleme turları üretime ulaşmadan önce genellikle bir branch deploy’unda yaşar. Ayarlara bir Preview origin ekle (AI ajanın her apply turundan sonra deploy URL’ini bağlamayı önerir) ve aynı link bir önizleme ikizi kazanır:

https://review.pinappai.com/p/<proje-slug>~preview/

Orada verilen kararlar da kanonik URL’lere kaydedilir. Karar karardır, hangi deploy üzerinde verildiği fark etmez.

PinAppAI reviewer’ı doğru yüzeye kendiliğinden yönlendirir:

İnceleme girişleri (chip, yeşil pinler, dashboard linkleri, /changes/ ikonları) uygulanan tur oradaysa preview’da açılır.
Bir sayfa deploy’lardan birinde var diğerinde yoksa, 404 sayfası olan deploy’a tek tıklık bir şerit taşır.

Cihaz olarak incele

Yukarıdaki masaüstü görünümü varsayılandır, ama reviewer’lar bununla sınırlı değil. Aynı review link sayfanı bir telefon olarak da, kendi gerçek mobil düzeniyle render edebilir. Hesap menüsünü aç (inceleme düğmelerinin altındaki baş harfli rozet) ve Device view’ı aç:

İnceleme widget'ının açık hesap menüsü: reviewer'ın adı ve e-postası, Device view düğmesi ve Sign out

Sayfa, seçtiğin cihaz olarak yeniden yüklenir, kendi gerçek mobil düzeniyle. Yanında ince bir kontrol şeridi belirir:

Bir cihaz seç ve dikey/yatay arasında Rotate et; Fit, çerçeveyi pencerene göre ölçekler.
Aynı inceleme aksiyonları (pin, yorum, ekran görüntüsü) orada da çalışır ve bir ekran görüntüsü tüm ekranını değil yalnızca cihaz çerçevesini yakalar.

Device view'da iPhone 15 olarak render edilmiş canlı bir site; yanında cihaz seçici, Rotate ve Fit kontrolleri, görünüm boyutu, pin/yorum/ekran görüntüsü düğmeleri ve reviewer kimliği bulunan kontrol şeridi

Her pin ve karar, yapıldığı cihazla etiketlenir; böylece “sadece mobilde bozuk” değişiklik talebine tahmin değil, gerçek olarak düşer.

Güvenlik duruşu

Proxy yalnızca projenin kayıtlı origin’lerini getirir: içeriye URL sokulamaz.
Reviewer kimliği her yerdekiyle aynı çalışır: e-posta doğrulaması, varsayılan olarak izin listesi (reviewer dokümanı).
Siten olduğu gibi sunulur; inceleme araçları CSS’inle ya da script’lerinle çakışamayan yalıtılmış bir katmanda yaşar.

Hangi yüzey ne zaman

Widget gömme, review linki ve reviewer Chrome eklentisi aynı veriyi üretir. Projene göre seç ya da karıştır. Reviewer’ların gerçek alan adında olmasını istiyorsan (örn. üretimde dogfooding) göm; sıfır-temas onboarding, ajans usulü müşteri incelemesi ya da değiştiremediğin bir site söz konusuysa linki paylaş; sayfalar login arkasında ya da sıkı güvenlik politikalarının ardındaysa eklentiye uzan.