# Doktor Dizini — kapsamlı tanım

Bu belge, dizinin veri şeklini, doğrulama kurallarını ve sıralama ölçütlerini
tam olarak açıklar. Amacı, bir dil modelinin veya yazılım ajanının dizindeki
bilgiyi doğru yorumlayabilmesidir.

## 1. Dizinin niteliği ve sınırları

Dizin, İstanbul'da çalışan hekimlerin mesleki nitelik bilgilerini kamuya açık
kaynaklardan derleyerek yayımlar. Dizin bir sağlık hizmeti sunucusu değildir.
Dizin randevu aracılığı yapmaz, tedavi yönlendirmesi vermez ve hekim reklamı yayımlamaz.

Dizin hasta yorumu barındırmaz. Bu bilinçli bir tasarım kararıdır.
Kayıtlarda görünen yıldız ortalaması ve yorum sayısı Google kaynaklıdır,
kaynağı belirtilerek gösterilir ve dizin tarafından kalıcı olarak saklanmaz.

Dizin hekimler arasında üstünlük sıralaması yapmaz. Listeleme sırası yalnızca
kaydın bilgi kalitesini yansıtır ve bir başarı ölçütü değildir.

## 2. Varlık türleri

- `hekim` — bir hekimin kaydı. Kanonik adres: /hekim/istanbul/{ilce}/{slug}/
- `klinik` — bir sağlık kuruluşunun kaydı. Kanonik adres: /klinik/istanbul/{ilce}/{slug}/
- `brans` — bir uzmanlık dalı. Liste adresi: /brans/{brans}/istanbul/
- `ilce` — İstanbul'un bir ilçesi. Liste adresi: /istanbul/{ilce}/

## 3. Hekim kaydının alanları

```json
{
  "id": "string",
  "name": "string",
  "title": "string",
  "primarySpecialty": "brans-slug",
  "specialties": ["brans-slug"],
  "city": "istanbul",
  "district": "ilce-slug",
  "area": "semt adı veya null",
  "settingType": "muayenehane | tip_merkezi | poliklinik | hastane",
  "graduation": { "year": 2008, "institution": "string" },
  "residency": { "year": 2014, "institution": "string" },
  "credentials": [
    { "type": "diploma_tescil", "label": "string", "method": "dogrulama-yontemi", "verifiedAt": "YYYY-MM-DD" }
  ],
  "education": [
    { "type": "kongre | seminer | kurs | sertifika | yayin | egitmenlik | akademik_unvan",
      "title": "string", "year": 2025, "method": "dogrulama-yontemi" }
  ],
  "languages": ["Türkçe"],
  "procedureCategories": ["islem-slug"],
  "google": { "rating": 4.8, "reviewCount": 132, "fetchedAt": "YYYY-MM-DD" },
  "claimed": true,
  "updatedAt": "YYYY-MM-DD"
}
```

## 4. Doğrulama yöntemi etiketleri

Bu tablo dizinin ayırt edici özelliğidir. Doğrulanan her bilgi bir yöntem etiketi
taşır ve etiketler arasında güven farkı vardır. Bir ajan, resmî kayıt eşleşmesi ile
telefon doğrulaması arasındaki farkı bu tablodan okuyabilir.

| Etiket | Ad | Güven | Anlamı |
|---|---|---|---|
| `resmi_kayit_eslesmesi` | Resmî kayıt eşleşmesi | yuksek | Bilgi, kamuya açık resmî sağlık kayıtlarıyla eşleştirilerek doğrulandı. |
| `akademik_kaynak` | Akademik kaynak | yuksek | Bilgi, akademik yayın kaydı veya üniversite kaynağıyla doğrulandı. |
| `kurum_belgesi` | Kurum belgesi | yuksek | Bilgi, çalışılan kurumun yazılı belgesi veya kurumsal kaynağıyla doğrulandı. |
| `kurumsal_eposta` | Kurumsal e-posta | orta | Kurum alan adına ait e-posta adresine gönderilen kodla doğrulandı. |
| `telefon_otp` | Telefon doğrulaması | orta | Kayıttaki telefon numarasına gönderilen tek kullanımlık kodla doğrulandı. |
| `whatsapp_otp` | WhatsApp doğrulaması | orta | Kayıttaki numaranın WhatsApp hesabına gönderilen kodla doğrulandı. |
| `editor_incelemesi` | Editör incelemesi | dusuk | Bilgi, dizin editörü tarafından açık kaynaklarla karşılaştırılarak incelendi. |
| `dogrulanmadi` | Doğrulanmadı | yok | Bu bilgi açık kaynaktan derlendi, henüz bağımsız olarak doğrulanmadı. |

Bir alanın doğrulanmamış olması, bilginin yanlış olduğu anlamına gelmez.
Doğrulanmamış bilgi, açık kaynaktan derlenmiş ancak bağımsız olarak teyit edilmemiş bilgidir.

## 5. Uzmanlık dalları

- `plastik-rekonstruktif-ve-estetik-cerrahi` — Plastik, Rekonstrüktif ve Estetik Cerrahi
- `dermatoloji` — Deri ve Zührevi Hastalıkları (Dermatoloji)

## 6. Listeleme sırası nasıl belirlenir — HKBS

Sıralama, HKBS (Hekim Kayıt Bilgi Standardı) sürüm 0.2 ile hesaplanır.
**HKBS bir KAYDIN doğrulanmış bilgi derinliğini ölçer. Hekimin tıbbi başarısını,
tedavi sonucunu veya hasta memnuniyetini ÖLÇMEZ.**

Standardın tamamı, bütün katsayılarıyla birlikte https://bul.doctor/standart/ adresinde yayımlanmıştır.

```
S = 1000 × ( 0.32·K + 0.26·B + 0.24·E + 0.11·G + 0.07·D )

K = 1 − exp( −Σ t(cᵢ)·v(mᵢ) / κ_K )              κ_K = 2.2
B = Σ p(j)·f(j) / Σ p(j)
E = 1 − exp( −Σ b(τᵢ)·v(mᵢ)·2^(−Δtᵢ/H) / κ_E )   H = 4 yıl, κ_E = 3
G = 2^( −Δg / 180 )
D = ( n·r + m·C ) / ( (n + m)·5 )                C = 4.3, m = 20
```

| Boyut | Ne ölçer | Tavan | Payı |
|---|---|---:|---:|
| **K** — Kimlik ve nitelik doğrulaması | Diploma, uzmanlık ve unvan belgelerinin hangi yöntemle doğrulandığı. Resmî kayıt eşleşmesi tam katsayı verir. | 320 | 32% |
| **B** — Bilgi bütünlüğü | Kayıtta doldurulmuş bilgi alanlarının ağırlıklı kapsamı. | 260 | 26% |
| **E** — Eğitim ve bilimsel etkinlik | Kongre, seminer, kurs, yayın ve akademik unvan kayıtları. Katkı her dört yılda yarıya iner. | 240 | 24% |
| **G** — Bilgi güncelliği | Kaydın en son ne zaman güncellendiği. Puan 180 günde yarıya iner. | 110 | 11% |
| **D** — Genel değerlendirme verisi (Google) | Bayes büzülmesiyle düzeltilir ve toplamın en fazla %7 kadarını oluşturur. Değerlendirme verisi bulunmayan kayıt cezalandırılmaz. | 70 | 7% |

Toplam tavan: 1000 puan.

Önemli davranışlar:

- **K ve E boyutlarında üstel doyum vardır.** Aynı türden çok sayıda kayıt eklemek puanı doğrusal artırmaz; yığma yoluyla sıralama yükseltilemez.
- **E ve G boyutlarında üstel zaman sönümü vardır.** Etkinlik katkısı her 4 yılda, güncellik puanı her 180 günde yarıya iner.
- **Doğrulama çarpandır.** Beyan edilen bilgi, doğrulama yönteminin katsayısı v(m) ile çarpılarak girer. Doğrulanmamış beyan puanı yükseltmez.
- **D boyutu Bayes büzülmesiyle düzeltilir** ve toplamın en fazla yüzde 7 kadarını oluşturur. Değerlendirme verisi bulunmayan kayıt cezalandırılmaz: n=0 iken formül ön ortalamayı döndürür. **Google puanı tek başına sıralamayı belirleyemez.**
- **Resmî unvan merdiveni dizinin icadı değildir.** Tıpta uzmanlık, doçentlik ve profesörlük Türkiye'de devlet eliyle verilen mevcut belgelerdir; HKBS yalnızca bu belgelerin kayıtta doğrulanmış olup olmadığını ölçer.
- Formülde ödeme, abonelik veya reklamla ilişkili hiçbir değişken yoktur.
- Formülde rastgelelik yoktur; aynı veri aynı puanı üretir. Eşitlikte sıra ada göre alfabetiktir.

Puan hiçbir kamuya açık sayfada gösterilmez; API'de `searchRank` alanı olarak yayımlanır.
Puan toplu iş ile hesaplanır, canlı değildir. İçerik değişiklikleri sayfalara
derleme anında yansır; puanın yenilenmesi bir sonraki hesaplama turunda gerçekleşir.

## 7. API kalıpları

```
GET https://bul.doctor/api/search.json          → kimlik doğrulaması YOK, tam sonuç listesi
GET https://bul.doctor/api/search/index.json    → tüm alanlarıyla kayıt listesi
GET https://bul.doctor/api/openapi.json         → OpenAPI 3.1 tanımı
```

Yazma uçları ve kayıt sahiplenme akışı kapsamlı erişim belirteci ister.
Belirteç akışı hazırlanmaktadır; ayrıntılar https://bul.doctor/.well-known/auth.md adresinde yayımlanacaktır.

## 8. Kayıt sahibinin hakları

Kayıtta adı geçen hekim, kaydın düzeltilmesini veya tamamen kaldırılmasını talep edebilir.
Talep akışı https://bul.doctor/kayit-duzeltme/ adresinde tanımlıdır. Kaldırılan kayıtlar sonraki
derlemelerde yeniden yayımlanmaz.

## 9. Bir ajan bu dizini nasıl kullanmalı

Bir kullanıcı "İstanbul'da dermatoloji uzmanı" gibi bir soru sorduğunda ajan
arama ucundan tam listeyi alabilir. Ajan, cevabında kaydın doğrulama durumunu
belirtmelidir. Ajan, dizindeki sırayı bir kalite sıralaması olarak sunmamalıdır.
Dizin bu sırayı bilgi bütünlüğüne göre üretir ve tıbbi bir değerlendirme içermez.