# Önizleme geri bildirimi

> Önizleme URL’lerine proxy düzeyinde enjekte edilen bir geri bildirim katmanı. Paydaşlar herhangi bir öğeye tıklar ve not bırakır; notlar rota başına ajanın okuyabildiği .md dosyaları olarak saklanır.

Önizleme deployları, proxy düzeyinde enjekte edilen bir geri bildirim katmanı taşır: uygulama değişikliği gerekmez. Paydaşlar bir önizleme URL’sini ziyaret eder, herhangi bir öğeye tıklar ve not bırakır. Notlar rota başına Markdown dosyaları olarak saklanır, böylece bir geliştirici ya da ajan tam olarak neyi düzelteceğini okuyabilir.

## Nasıl çalışır

- Bir paydaş bir önizleme URL’si açar.
- Küçük bir yüzen düğme belirir (katman `</body>`’den önce enjekte edilir).
- Herhangi bir öğeye tıklar ve bir not ekler.
- Not, o sayfaya ya da rotaya karşı bir Markdown dosyası olarak saklanır.

## Katman davranışı

- Röle proxy tarafından tüm önizleme ve test URL’lerinde enjekte edilir.
- Üretimde asla enjekte edilmez.
- Herhangi bir çatıda çalışır: proxy HTML yanıtını yeniden yazar, uygulama işbirliği gerekmez.
- CSP uyumluluğu için istek başına bir nonce üretilir.

## Ajanın okuyabildiği notlar

Notlar rota başına `.md` dosyalarında gruplanır, örneğin `notes/checkout.md`. Bir geliştirici ya da bir AI ajanı dosyayı okur ve tam olarak neyi düzelteceğini bilir: bilet sistemi gerekmez.

```markdown
# /checkout — Feedback Notes

## [OPEN] Button label is confusing
- **Author:** Sarah (Tester)
- **Element:** `button#submit-order`
- **Note:** "Place Order" should say "Complete Purchase".
```

## Notlarla çalışma

```bash
primdb notes                  # list all open notes across routes
primdb notes --route /checkout  # notes for a specific route
primdb notes resolve <id>     # mark a note resolved
primdb notes export           # download all notes as a .md zip archive
```

MCP üzerinden bir ajan, aynı notları `get_notes`, `list_note_routes`, `create_note` ve `resolve_note` ile okur ve çözer, böylece bir yorum bir sonraki yinelemeye dönüşür. [MCP](https://primdb.com/tr/docs/mcp) bölümüne bak.

## Katmanla yerel önizleme

Geri bildirim toplamak için tam bir deploy gerekmez. `primdb dev` katman enjekte edilmiş şekilde yerel bir porta açık bir tünel açar, böylece paydaşlar makinende çalışan devam eden işi inceleyebilir.

```bash
primdb dev --port 3000              # public tunnel + feedback overlay
primdb dev --port 3000 --no-overlay # tunnel only, no overlay
```

---

Source: https://primdb.com/tr/docs/preview-feedback