AI-diff incelemesi (/changes/ iş akışı)

Bir içerik yenilemesi, yeniden tasarım ya da büyük metin tazelemesi sonrasında reviewer’ların dev bir diff’e göz gezdirmesini değil, her değişikliğe tek tek karar vermesini istersin. PinAppAI AI-diff inceleme akışı işini madde madde bir inceleme yüzeyine çevirir: Before/After kartlı bir /changes/ sayfası, artı değişikliklerin yaşadığı sayfaların üzerinde sayfa-içi inceleme.

Parçalar nasıl birleşiyor

AI ajanın değişiklikleri uygular (apply workflow)
   │
   ├── kaynağı düzenler
   ├── /changes/ sayfasını yazar/yeniler
   └── her maddeyi PinAppAI'a kaydeder
   │
   │  Reviewer /changes/'ı YA DA herhangi bir kaynak sayfayı ziyaret eder
   ▼
   • /changes/ → madde başına Approve/Reject/Request-change kartları + özet
   • kaynak sayfa → inceleme chip'i + karar paneli + sayfalar-arası gezinme

Kayıt, apply/generate çalıştırmasının otomatik parçasıdır: ısındırılacak bir şey yoktur ve sayfanın kendisi hiçbir şey yazmaz.

1. /changes/ üret

Çoğu zaman elle üretmezsin: apply workflow’u her turdan sonra /changes/’ı otomatik yeniler. İlk sayfa için (ya da bağımsız bir yeniden-yazım incelemesi için) AI client’ında generate-changes-page workflow’unu çalıştır (nasıl), ya da hazır prompt’u dashboard’un InReview sekmesinden kopyala (Copy /changes/ prompt).

Üretilen sayfa tek başına yeten tek bir dosyadır:

• Atomik değişiklik başına bir kart: reviewer her birine bağımsız karar verir
• Her kart CR’ın #N numarasını taşır, yani dashboard’un ve sayfadaki pin’in gösterdiği kimliğin aynısını
• Kaynağına bayt-sadık BEFORE / AFTER metin satırları
• Tüm CSS gömülü; site şablonu yok: deploy edilecek tek dosya, silinecek tek dosya

AI üretici, sayfayı üretirken kaynak dosyalarını asla değiştirmez. Yazdığı tek dosya /changes/’dır.

2. Deploy et + karar ver

/changes/’ı herhangi bir sayfa gibi commit’le ve deploy et. Reviewer’lar bir özet başlık ve kart başına şunları görür:

• ✓ Approve: uygulanan metni kabul et
• ✗ Reject: sonraki Apply bu değişikliği geri alır
• ↻ Request change: asıl istediğin metni yaz; sonraki Apply onu uygular

Her kart başlığının yanındaki iki küçük ikon değişikliği bağlamında açar: biri sitenin kendisinde, biri kurulumsuz review linki üzerinden. İkincisi widget gömülü olmayan sayfalarda bile çalışır.

Kararlar PinAppAI sunucularında, reviewer’ın doğrulanmış e-postasına bağlı olarak saklanır.

3. Asıl sayfada incele (sayfa-içi mod)

Reviewer, bekleyen değişikliği olan bir kaynak sayfayı ziyaret ettiğinde sağ altta bir chip belirir:

Bu sayfada incelenecek 16 değişiklik

Tıkla → değişen metni yerinde vurgulayan sürüklenebilir bir panel açılır: BEFORE/AFTER satırları, karar butonları ve bekleyen her maddeyi (sayfalar arasında bile) gezdiren ◀ ▶ oklar. Uygulanmış-ama-kararsız değişiklikler sayfada yeşil parlar; karar verince parıltı söner.

İncelediğin tur bir preview deploy’unda yaşıyorsa (branch önizlemesi), inceleme girişleri seni otomatik oraya taşır: kararı her zaman değişikliği gerçekten içeren içeriğin üstünde verirsin.

Kendi maddesi olmayan sayfalarda chip proje genelindeki sayıyı gösterir ve sitedeki ilk bekleyen maddeye atlar.

4. Kararları uygula

apply workflow’unu tekrar çalıştır. Reddedilen maddeler orijinal metnine döner, değişiklik istenenler reviewer’ın birebir metnini alır, /changes/ eşleşecek şekilde yenilenir. Onaylananlar kapanır. Tam durum modeli iterasyon döngüsünde belgeli.

5. İterasyon sınır işareti

Her apply çalıştırması .pinappai/last-applied.json dosyasına çalıştırma zamanını yazar. Sonraki /changes/ üretimi bunu okur ve diff’i “son apply’dan bu yana değişenler”e daraltır: reviewer’lar hiçbir zaman birikmiş geçmişi değil, yalnızca yeni turu görür.

Apply sırasında /changes/ sayfası teklifini geri çevirirsen, marker o turun hala bir inceleme sayfası beklediğini kaydeder. Daha sonra generate-changes-page workflow’unu çalıştırdığında o tur otomatik olarak dahil edilir; uyguladığın hiçbir değişiklik incelemesiz kalmaz.

.pinappai/last-applied.json’ı her turun kaynak değişiklikleriyle birlikte commit’le (AI ajanın senin için stage’ler ve commit öncesi sorar). .pinappai/context.json (proje bağı) hemen yanında yaşar. İkisi de minicik, commit’le.

Prod’a hazırlık

Yayına çıkarken tüm inceleme işaretlerinin müşteri yüzünden gitmesini istediğinde AI client’ında remove workflow’unu çalıştır: widget etiketini söker, /changes/’ı siler, git grep ile doğrular, review linkini kapatmayı önerir ve commit öncesi sorar. .pinappai/ klasörü bilerek korunur: sonradan yeniden kurulum aynı zemine iner.