# Pano Turu

> Contextator panosunda rehberli bir tur — oturum açmak, hesap menüsü, üst çubuk, proje listesi ve ayrıntısı, klavye kısayolları, footer ve Users sayfası.

- Güncelleme: 2026-11-04
- Kaynak: https://contextator.com/tr/docs/dashboard-tour/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
**http://localhost:3444/** adresindeki pano, her şeyin yönetildiği yerdir. Düz bir web sayfasıdır —
hiç build adımı yoktur, ve indekslemenin olurken izleyebilmeniz için yoklama yapar. Önce oturum açmanızı
ister, ve sonrasında ne gördüğünüz hesabınıza bağlıdır.

---

## Oturum açmak

`/`'i açmak, o tarayıcıda zaten bir oturumunuz olmadıkça sizi `/login`'e gönderir. Operatörün size
verdiği hesapla oturum açın; yepyeni bir örnekte henüz bir hesap yoktur ve bunun yerine, sunucu
logundaki kodla ilkini oluşturmak için `/setup`'a gönderilirsiniz. İkisi de
[Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/)'de anlatılır.

Parolanız geçiciyse, pano sizi `/change-password`'e gönderir ve onu değiştirene kadar başka hiçbir şey
çalışmaz.

İçeri girdiğinizde ne gördüğünüz rolünüzü izler: bir `root` ya da `admin` hesabı her projeyi ve
**Users** sayfasını görür, bir `member` hesabı yalnızca eklendiği projeleri görür, ve basamayacağı
düğmeler devre dışı gösterilir (örneğin Re-index ve Force re-index), gizlenmez.

## Hesap menüsü

Sağ üstte, adınızı ve rolünüzle bir hap göstererek:

| Öğe | Ne yapar |
|------|--------------|
| **Change password** | Mevcut parolanızı, sonra yeniyi iki kez ister. Kaydetmek diğer oturumlarınızı çıkarır |
| **API tokens** | [Admin API](/tr/docs/admin-api/#api-tokenları) için kendi token'larınız (`#/~tokens`) |
| **Users** | Hesap listesi — yalnızca `root` ve `admin`. Bkz. [Users sayfası](#users-sayfası) |
| **Audit log** | Kimin ne yaptığının örnek geneli kaydı (`#/~audit`) — yalnızca `root` ve `admin`. Bkz. [Admin API](/tr/docs/admin-api/#audit-log) |
| **Sign out** | Bu oturumu yalnızca bu tarayıcıda değil, sunucuda sonlandırır |

## Üst çubuk

Durum hapları, başka bir şeye bakmadan önce sunucunun sağlıklı olup olmadığını söyler:

| Hap | Anlamı |
|------|---------|
| **Database up / down** | Veritabanına ulaşılabiliyor — gömülü PostgreSQL ya da `DATABASE_URL`'in adlandırdığı harici olan |
| **Model ready / loading** | Gömme modeli yüklendi. İlk başlatmada, model indirilirken *loading* der — hazır olana kadar indeksleme ve arama çalışmaz |
| `local · Xenova/multilingual-e5-small · 384d` | Şu anda kullanılan gömme sağlayıcısı, modeli ve vektör boyutları |
| `n open sessions` | Şu anda bağlı MCP istemcileri |
| `v1.0.0` | Çalışan sürüm |

## Proje listesi (sol)

Canlı durumuyla birlikte her proje: `idle`, `indexing`, `queued` ya da `error`. Her satır, kaynak
sayısını, doküman ve parça sayılarını ve en son ne zaman indekslendiğini gösterir. Bir proje
indekslenirken, satır geçerli aşamayla, biten dosyalarla ve gömülen parçalarla bir ilerleme çubuğu
büyütür. Kuyrukta bekleyen bir proje, hangi projeyi beklediğini söyler.

- **Filter projects** — listeyi daraltmak için yazın.
- **New project** (ya da `n`'ye basın) — oluşturma diyaloğunu açar.

## Proje ayrıntısı (sağ)

### Header
Proje adı, durumu, ve kopyalama düğmeli **MCP URL** — bu, agent'ınızın yapılandırmasına yapıştırdığınız
dizedir. Yanında, projenin kaynaklarının adları.

Üç eylem:

| Düğme | Ne yapar |
|--------|--------------|
| **Re-index** | Artımlı bir çalışmayı kuyruğa alır: her kaynağı senkronize et, yalnızca değişeni yeniden göm |
| **Force re-index** | Projenin her parçasını düşürür ve sıfırdan yeniden kurar |
| **Delete** | Projeyi, dokümanlarını, parçalarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın (ikinci tık **Confirm delete** yazar). Yalnızca `root` ve `admin` hesapları için çizilir, ve proje indekslenirken reddedilir |

Bir çalışma sürerken, bir bilgi kutusu aşamayı, ilerleme çubuğunu, kaç dosyanın değişmediğini ve kaç
parçanın gömüldüğünü gösterir. Son çalışma başarısız olduysa, kırmızı bir bilgi kutusu hatayı olduğu
gibi gösterir.

### İstatistikler
Dokümanlar (ve kaç kaynak boyunca), parçalar, en son ne zaman indekslendiği (o çalışmanın neyi
değiştirdiğiyle birlikte), ve gömme modeli. Proje, sunucunun şu anda çalıştırdığından farklı bir modelle
indekslendiyse, burada bir uyarı görünür ve siz yeniden indeksleyene kadar arama reddedilir. Uyarı, içinde bir **Re-index now** düğmesi olan ve başlığı *Indexed with a different embedding model* olan bir bilgi kutusudur, çünkü hiçbir şey projeyi kendiliğinden yeniden indekslemez. İkinci bir bilgi kutusu, *Chunks are larger than the model reads*, `CHUNK_MAX_TOKENS` modelin temsil ettiğinin üzerindeyse görünür ve yeniden indekslemeden önce ayarlanacak değeri adlandırır. Parçalar kutucuğu *embedded, HNSW cosine index* yazar.

### Arama
İstatistiklerin altında, projeye bir agent'ın soracağı şekilde soran bir arama kutusu. İsteğe bağlı **source**, **path prefix** ve **version** filtreleri `search_docs` argümanlarını yansıtır, ve sınır 5, 10 ya da 20 isabettir. Her isabet dosyasını, başlığını, soluk renkli komşu metniyle alıntıyı, cosine skorunu ve `D` ile `L` sıralarını gösterir — vektör yarısının (`D`) ve anahtar sözcük yarısının (`L`) ona verdiği konum. En iyi skor relevance floor'un altındaysa, *Below the relevance floor* başlıklı bir bilgi kutusu `search_docs`'un "no good match" yanıtlayacağını söyler, ve floor'un doğru olup olmadığına siz karar verebilesiniz diye alıntılar yine de gösterilir.

### Agent'ların ne sorduğu
Sorgular paneli agent'ların neyi aradığını geri okur, böylece dokümantasyonun neyi yanıtsız bıraktığını görebilirsiniz. Pencereyi (24 saatten 90 güne) ve kimin aramalarının sayılacağını seçin — agent'lar (MCP), bu pano, ya da ikisi. Dört sekme: **Questions** (bir sorunun ne sıklıkla sorulduğuna ve en iyi skorunun ne kadar düşük kaldığına göre sıralı, sormanın kaç token ve güne yayıldığıyla birlikte), **Never returned** (hiçbir aramanın döndürmediği dokümanlar, indeksliyken kaç arama çalıştığıyla birlikte), **Most returned** ve **Volume** (UTC günü başına aramalar). Hiçbir şey "yanıtsız" diye etiketlenmez: dokümante etmediğiniz bir şey hakkındaki bir soru, dokümante ettiğiniz bir soru kadar iyi skor alabilir, bu yüzden sayı ve skor gösterilir ve yargı sizindir. **Export questions** onları değerlendirme harness'inin biçiminde JSONL olarak indirir.

Questions tablosunun altında **Reported by agents**, agent'ların `report_gap` ile gönderdiklerini listeler: bir agent'ın
aradığı, bulduklarını okuduğu ve dokümantasyonun cevaplamadığını söylediği sorular; soruya göre gruplanır ve
agent'ların kendi sözleriyle, düz metin olarak gösterilir. Üstlerindeki sorularla birlikte sıralanmazlar. Bkz.
[MCP Araçları](/tr/docs/mcp-tools/#report_gap).

Her rakam bir gömme modelini, bir indeks neslini ve bir relevance floor'u tanımlar; bunlar tablonun üstündeki seçicide adlandırılır. Floor, o aramalar karara bağlandıktan sonra değiştirildiyse panel bunu işaretler: rakamlar eski floor'a göre karara bağlanmıştı, bu yüzden projenin bundan sonra reddettiği şey onların gösterdiği şey değildir, ve mevcut floor altında karara bağlanan aramalar sizin seçmeniz için ayrı tutulur. Panelin altı **mevcut relevance floor**'u ve nereden geldiğini gösterir — sunucunun `SEARCH_SCORE_FLOOR`'u ya da bu projenin kendi değeri. Bir manager, 0,01'lik adımlarla on değerlik bir listeden başka bir değer seçebilir (en düşüğü 0,75, en yükseği 0,84), **Off (0)**, ya da bu projenin kendi değerini bırakmak için **Server default**; birini seçmek onu uygulamaz, önce fiyatlandırır — penceredeki reddedilen aramalardan kaçını yanıtlayacaktı ve yanıtlanan aramalardan kaçını reddedecekti, üst sınırlar olarak — ve yalnızca **Set the floor to…** onu kaydeder. Manager'lar ayrıca **Stop recording** ya da **Clear the log** yapabilir; saklama süresinden eski satırlar otomatik olarak silinir.

### Eval runs
Projenin golden question'larının (her biri bir soru ve ona cevap vermesi beklenen dosya) altında, **Eval runs**
paneli sunucunun bunlara verdiği kendi cevapları tutar. İndeks değiştikten sonra — bir yeniden kurma, chunk
yazan, dosya kaldıran ya da doküman değişikliği kaydeden artımlı bir çalışma — ya da küme düzenlendikten sonra
sunucu her golden question'ı canlı indekse sorar ve çalışmayı kaydeder. Panel, recall@5 ve MRR geçmişini bir
grafik olarak çizer, çalışmaları her birinin neyi kaybettiği ya da atladığıyla listeler ve en yeni iyi
çalışma, daha önce ilk beşte olan bir soruyu kaybettiğinde bunu sorulara adını vererek uyarır (ayrıca bir
soru, beklediği dosya artık indekste olmadığı için ilk kez atlandığında). Sunucunun kendi başlattığı bir
çalışma, açık bir sayfada yenileme gerekmeden saniyeler içinde görünür. Bir manager **Run now**'a basabilir.
Panel sunucunun kaydettiği rakamları çizer ve kendisi hiçbir şeyi puanlamaz. Aynı çalışmalar API üzerinden
okunur: bkz. [Admin API](/tr/docs/admin-api/#golden-set-eval-çalışmaları).

### Belge kaynakları
Kaynak başına bir satır: bağlama adı, nereden geldiği, içerik türü, doküman sayısı, en son ne zaman
senkronize olduğu, ve kendi durumu. Her satır şunu taşır:

| Eylem | Kimin için var | Ne yapar |
|--------|---------------|--------------|
| **Test** | git, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues | Hiçbir şeyi indekslemeden bağlantıyı denetler |
| **Sync** | tümü | Bir indeksleme çalışmasını kuyruğa alır (her kaynak bir çalışmanın başında senkronize olur) |
| **Edit** / **Files** | tümü | Kaynak diyaloğunu açar; yüklemeler için saklanan dosyaları listeler ve yönetir |
| **Delete** | tümü | Kaynağı, dokümanlarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın |

Bir viewer, eylem düğmelerinin yerine **View** görür.

**Add source**, tür başına bir sekmeyle bir diyalog açar — Local directory, Git repository, Upload
files, Obsidian vault, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues. Bkz.
[Belge Kaynakları](/tr/docs/document-sources/).

### Secret'lar ve kişisel veriler
Bir `editor` ve üstü için proje sayfasındaki bir bölüm, PII taramasının bulduklarını belge yoluna göre listeler: kural, konum ve
maskelenmiş bir önizleme, kurala göre daraltılabilir. Hiçbir zaman bir değer göstermez ve taramanın kapalı olduğunu (`PII_SCAN=0`),
bulguların gruplanmadığını (`SECRET_KEY` yok), belgelerin belge başına tavana ulaştığını ve belgelerin indekslenirken kesildiğini ayrı
ayrı söyler. Tarama yalnızca raporlar; hiçbir şey maskelenmez ya da atlanmaz. Bir viewer bölümü görmez. Bkz.
[Yapılandırma](/tr/docs/configuration/#belgeleri-secretlar-ve-kişisel-numaralar-için-taramak).

### Üyeler
Her projeye ulaşan ve bu yüzden listelenmeyen `root` ve `admin` hesaplarının ötesinde, bu projeye kim
ulaşır. Her satır, proje rolünü tutan bir açılır menüyle birlikte bir `member` hesabıdır — **viewer**
okur, **editor** kaynakları değiştirir, dosya yükler ve yeniden indeksler — ve bir **Remove** düğmesi.
**Add member**, henüz projede olmayan aktif `member` hesaplarını sunar; hiç yoksa sizi Users sayfasına
yönlendirir. Yalnızca `root` ve `admin` bunun herhangi bir şeyini değiştirebilir; başka herkes listeyi
salt okunur görür. Panelin altındaki not projenin MCP moduna göre değişir: endpoint herkese açıkken üyeliğin panoyu
yönettiğini, MCP endpoint'ini değil, söyler; bir token zorunlu olduğunda endpoint'in yalnızca projenin
token'larından birini tutan bir istemciye yanıt verdiğini söyler; hesap zorunlu modunda ise yalnızca burada listelenen hesapların ve yöneticilerin MCP endpoint'ine ulaşabildiğini söyler. Bkz. [Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/).

### MCP erişimi
Bir hap, bu projenin endpoint'inin üç moddan hangisinde olduğunu söyler — **open**, URL'ye ulaşabilen
herkes tarafından okunabilir; **token required**, yeni oluşturulan bir proje için varsayılan; ya da
**account required**, yalnızca projenin bir üyesi olan bir hesabın, OAuth 2.1 üzerinden ve her istekte
yeniden denetlenerek yanıtlandığı mod. Panel aralarında geçiş yapar; **New token** bir tane üretir ve secret'ını bir kez gösterir, ve
**Revoke** istemcisini oturum ortasında keser. Üretirken token'ı bağlayacağınız kaynakları seçebilirsiniz; kapsamı olan bir token bir rozet gösterir — kaynaklarının hiçbiri kalmadıysa kırmızı — ve `open` projelerde, kapsamın bir sınır olmadığını söyleyen bir not görünür. Her satır bir token'ın adını, önde gelen karakterlerini,
ve en son ne zaman kullanıldığını gösterir. Basmanıza izin verilmeyen düğmeler çizilmez: modu çevirmek
proje üzerinde `manager` haklarını gerektirir, üretmek ve iptal etmek bir editor'ünkini. Bkz.
[Projeler](/tr/docs/projects/).

### Bir agent bağlamak
Bu projenin gerçek URL'siyle doldurulmuş, Claude Code, Cursor, Claude Desktop ve eski SSE istemcileri
için kopyala-yapıştır parçacıkları — ve proje bir token gerektirdiğinde `Authorization` başlığı zaten
yerinde. Bkz. [Yapay Zekâ İstemcilerini Bağlamak](/tr/docs/connecting-ai-clients/).

### Agent'a açılan araçlar
Her projenin yayımladığı beş aracın bir hatırlatıcısı: `search_docs`, `list_topics`, `read_document`, `whats_new`
ve `report_gap`; sonuncusu projenin sorgu logu açıkken bulunur.
Bkz. [MCP Araçları](/tr/docs/mcp-tools/).

### İndeksleme çalışmaları
En yeniden en eskiye son çalışma geçmişi: ne zaman, artımlı mı zorlanmış mı, ne değişti
(`12 unchanged · 3 updated · 1 removed`), ve ne kadar sürdü. Başarısız çalışmalar hatalarını gösterir.
Bu, canlı ilerleme görünümünün aksine, yeniden başlatmaları atlatır.

---

## Klavye ve küçük kolaylıklar

- `n`, **New project**'i açar (hiçbir diyalog açık değilken).
- `Esc` bir diyaloğu kapatır.
- Seçili proje URL hash'indedir (`#/my-project`), bu yüzden ona bir yer imi koyabilir ya da bir bağlantı
  paylaşabilirsiniz.
- Yıkıcı düğmeler ikinci bir tıklama gerektirir, ve onayın süresi birkaç saniye sonra dolar.
- Kopyalama düğmeleri, tarayıcı düz-HTTP bir LAN adresinde panoyu engelliyorsa manuel bir seçime düşer.

## Footer

Panonun her sayfası aynı iki parçalı footer ile biter. Solda, çalışan sürümle birlikte telif hakkı
satırı: *Copyright © 2026 Contextator v1.0.0 is a Tunedness production.* Sağda, sıradan URL'ler olarak
açılan ve hesap gerektirmeyen beş sayfa:

| Sayfa | Ne olduğu |
|------|-----------|
| [`/about`](http://localhost:3444/about) | Contextator'ın ne olduğu, nasıl çalıştığı, ve kimin yaptığı |
| [`/privacy`](http://localhost:3444/privacy) | Kurulumunuzun ne sakladığı, ve yazılımın yapabileceği giden çağrılar |
| [`/cookies`](http://localhost:3444/cookies) | Var olan tek çerez — sizi oturumda tutan oturum — ve ne olmadığı |
| [`/terms`](http://localhost:3444/terms) | Garanti reddi ve bir örnek çalıştırmanın sizi nelerden sorumlu tuttuğu |
| [`/license`](http://localhost:3444/license) | Kısaca AGPL, `/license.txt`'teki tam metin, ve üçüncü taraf bileşenler |

Bilerek herkese açıktırlar: yalnızca operatörün okuyabildiği bir yasal bildirim, bir bildirim değildir.
Hiçbir proje verisi açığa çıkarmazlar ve ne veritabanına ne de API'ye ulaşırlar.

## Users sayfası

Hesap menüsü → **Users** (`#/~users`), yalnızca `root` ve `admin` hesapları için. Hesap başına bir
satır: kullanıcı adı ve görünen adı, rolü, **active**, **disabled** olup olmadığı ya da **password
change pending** durumu, kaç projeye ulaştığı, ve en son ne zaman oturum açtığı.

| Düğme | Ne yapar |
|--------|--------------|
| **New user** | Oluşturma diyaloğunu açar |
| **Edit** | Görünen ad, e-posta, rol, ve active anahtarı |
| **Reset password** | Bir kez gösterilen yeni bir geçici parola verir, ve o hesabı her yerde oturumdan çıkarır |
| **Disable** / **Enable** | Devre dışı bir hesap oturum açamaz ve açık oturumları hemen sona erer |
| **Delete** | Hesabı, oturumlarını ve üyeliklerini kaldırır. Onaylamak için iki kez tıklayın |
| **SSO group mappings** | `OIDC_GROUPS_CLAIM` kullanılıyorsa kimlik sağlayıcı gruplarını projelere ve bir role eşler. Bkz. [Tek Oturum Açma](/tr/docs/sso/#gruplar-proje-üyeliği-verir) |

**New user**, bir kullanıcı adı (küçük harf, kalıcı), opsiyonel bir görünen ad ve e-posta, bir rol —
yalnızca bir root hesabına sunulan `root` ile birlikte `member` ya da `admin` — ve bir parola ister.
Parolayı boş bırakın, ya da **Generate**'e basın, ve sunucu bir tane üretsin. Her iki durumda da bir
kez, kopyalama düğmeli bir diyalogda gösterilir, ve **Must change password at first sign-in** varsayılan
olarak işaretlidir.

Birinin oturumlarını sonlandırmak için ayrı bir düğme yoktur: **Reset password**, **Disable** ve
**Delete**'in her biri, oldukları şeyin bir parçası olarak bunu yapar.

Basmanıza izin verilmeyen bir düğme grileşir ve üzerine geldiğinizde nedenini söyler — son aktif root
hesabı, kendi satırınız, ya da siz bir admin iken bir root hesabı. Kuralların tamamı
[Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/)'dedir.
