# Ürün yerelleştirmesi — editoryal teslim notları

## Kapsam ve kaynak

- Dosya: `data/product-locales.editorial.json`.
- Yerel veritabanı yalnızca `scripts/create-database-client.mjs` üzerinden okunmuştur. Veritabanına yazılmamıştır.
- Durum filtresi uygulanmadan bütün ürünler alınmıştır: **131 ürün**. Okuma sırasında 131 yayımlanmış ürün, 0 taslak vardır.
- Seri dağılımı: Nexus 23, Swan 23, Mono 12, Elite 23, Nero 23, Nirvana 23, VTC 4.
- Her ürün için 10 açık çeviri alanı vardır: ad, açıklama, özellikler, seçenekler ve aksesuarların EN/RU karşılıkları. Toplam 1.310 alan.
- İlk çeviriler mevcut EN/RU metinlerinden veya otomatik yedek çeviri çıktısından alınmadan Türkçe kaynak üzerinden hazırlanmıştır. Başlık kısaltma revizyonunda yalnızca terminoloji kontrolü için `lib/product-i18n.ts` okunmuştur; özellikle “Sac” karşılığı bu dosyadaki açık katalog sözleşmesine dayandırılmıştır. Aynı Türkçe ifadeler için tutarlı, editoryal olarak belirlenmiş karşılıklar kullanılmıştır; teslim dosyasında şablon veya çalıştırılması gereken üretim kodu bulunmaz.
- Kaynak açıklamalar kısadır; pazarlama üslubu adına doğrulanmamış avantaj, performans, güvenlik, sertifika, güç, malzeme kalitesi veya ölçü eklenmemiştir.

## Dosya yapısı ve kaynak koruması

Kök yapı: `{schemaVersion, sourceLanguage, productCount, products}`.

`products` dizisindeki her kayıt `id`, `slug`, `source` ve `translations` içerir. Hem kimlik hem slug benzersizdir. Entegrasyon sırasında ikisi birlikte doğrulanmalıdır.

`source` alanları şu seçimlerin veritabanından dönen **aynen korunmuş** değerleridir:

- `nameTr: nameTr || name`
- `descriptionTr: descriptionTr || description`
- `featuresTr: featuresTr ?? features`
- `optionsTr: optionsTr ?? options`
- `accessoriesTr: accessoriesTr ?? accessories`

Bu veritabanında üç teknik liste alanı JSON dizisi içeren **string** değerler olarak dönmektedir. Bu nedenle `source.featuresTr`, `source.optionsTr` ve `source.accessoriesTr` string olarak korunmuştur; kaynak kontrolünde aynı seçim ve aynı ham değer kullanılmalıdır. Buna karşılık `translations` altındaki bütün teknik listeler gerçek JSON dizileridir.

Kaynak değişirse ilgili kayıt otomatik uygulanmamalı, yeniden değerlendirilmelidir. Kaynak koruması için alan adları `source.nameTr` vb.dir; `source.name` değildir.

## Terminoloji kararları

- EN için üretici kataloğuna uygun “hob”, “built-in”, “gas burner”, “front-mounted controls”, “L-shaped layout” kullanılmıştır.
- RU için “варочная панель”, “встраиваемая”, “газовая конфорка”, “фронтальное расположение органов управления”, “L-образная компоновка” kullanılmıştır.
- “Inox”, “stainless steel” / “нержавеющая сталь” olarak çevrilmiştir; çelik sınıfı veya kaplama eklenmemiştir.
- “Siyah cam”, “black glass” / “чёрное стекло” olarak korunmuştur; temperli cam iddiası eklenmemiştir.
- “2+2 Ceran” hibrit ürünler, gaz ile elektrikli Ceran pişirme alanlarını birleştiren modellerdir. Özellik listelerinde tam olarak 2 gazlı ve 2 elektrikli alan belirtilir.
- Tam elektrikli VTC ürünlerinde yalnızca elektrikli Ceran ifadesi kullanılır. **Ceran, indüksiyon olarak çevrilmemiştir.**
- SABAF/Sabaf, Ceran ve seri adları korunmuştur. Rusça teknik adlandırmada Wok Latin harfleriyle bırakılmıştır.
- “4G” / “4 Gaz”, dört gazlı pişirme gözü anlamıyla çevrilmiştir. Yanında “Wok” bulunması, ilave bir göz veya toplam beş göz şeklinde yorumlanmamıştır.
- Ölçü değerleri aynıdır. “CM” / “cm” İngilizcede “cm”, Rusçada eşdeğer “см” olarak yazılmıştır. Inox 90 başlıklarındaki birim, aynı ürünün Türkçe açıklamasında bulunan 90 cm bilgisine dayanır.
- VTC adlarındaki aynı “Ceran” kelimesinin tekrarı okunabilirlik için tekilleştirilmiştir; farklı bir konfigürasyon veya marka silinmemiştir.
- Başlık revizyonunda açıklama ve sayfa bağlamında zaten bulunan “Gas Hob”, “Combination Hob”, “Electric Hob” ve “варочная панель” tür ifadeleri çıkarılmıştır. Kaynakta açıkça belirtilen “2 Gaz”, “4 Gaz” ve “4G” ise başlıklarda “2/4 Gas Burners” / “2/4 газовые конфорки” olarak korunur. VTC başlıkları kısa “VTC 30 cm Ceran” / “VTC 30 см, Ceran” biçimindedir; tam elektrikli olma bilgisi değişmeyen açıklama ve özelliklerde bulunur.
- Başlıklarda “Front Knobs”, “Front-left Knobs”, “L-компоновка”, “ручки спереди” ve “управление спереди” kullanılarak tekrarlar azaltılmıştır. Açıklama ve teknik listelerin terminolojisi değiştirilmemiştir.

## Kaynaktaki belirsizlikler

Bu noktalar çeviriyle teknik doğrulamaya dönüştürülmemiştir. Üretici teyidi gelirse adlar daha açık biçimde düzenlenebilir.

1. **“Sac” — 35 ürün; yerel katalog sözleşmesi doğrulandı:** `lib/product-i18n.ts` içindeki `localizeProductName`, “Sac” sözcüğünü açıkça “Sac Izgara” olarak normalleştirir. Aynı dosyanın çeviri sözlüğü bunu “Steel Pan Support” / “Стальная решётка” olarak karşılar. Bu yerel dayanak üzerine başlıklarda “Steel Pan Support” / “стальная решётка” kullanılmış, önceki uzun genel malzeme ifadesi kaldırılmıştır. Bu karar mevcut uygulamanın terminoloji sözleşmesine dayanır; bağımsız fiziksel ürün doğrulaması değildir. Emaye kaplama, döküm, çelik sınıfı veya ızgara adedi eklenmemiştir.
2. **“90 1 1”, “90 4 1”, “90 4”, “90 6” — 15 ürün:** 90 cm açıklamadan doğrulanır. Sonraki “1 1”, “4 1”, “4” ve “6” etiketleri başlıkta aynen korunmuştur. Aralara “+” eklenmemiş; bu sayılar gaz/elektrik/Wok dağılımı veya kesin toplam göz sayısı olarak açılmamıştır.
3. **“4G Önden Wok Wok Sağ” — 6 ürün:** Kaynaktaki tekrar “Wok / Right-side Wok” / “Wok / Wok справа” şeklinde korunmuştur. Kaynakta iki Wok bulunduğu açıkça belirtilmediğinden “dual Wok”, “2 Wok” veya ilave göz sayısı iddiası kullanılmamıştır.
4. **“Önden Sol Orta Wok” — 6 siyah cam ürün:** “Önden kontrol düzeni” özellik listesinde doğrulanır. Ancak “Sol” sözcüğünün hangi parçaya ait olduğu ad içinde açık değildir. Bu yüzden çeviride “Front Controls, Left / Central Wok” / “управление спереди, слева / Wok по центру” biçimindeki kısa konum etiketi korunmuştur; “sol” belirli bir parçaya kesin olarak bağlanmamıştır. Bu altı başlık, doğrulanmamış bir konumu akıcı bir cümleye dönüştürmemek için diğer başlıklardan daha kısa katalog dili kullanır.
5. **“Önden Düğme Sol Wok Orta”:** Bu ayrı Inox adında düğme açıkça belirtilir; “Front-left Knobs, Central Wok” / “ручки спереди слева, Wok по центру” olarak çevrilmiştir. Bu bilgi belirsiz siyah cam adlarına taşınmamıştır.
6. **Nexus Siyah Cam 30CM:** Kaynak adında veya özellik listesinde göz sayısı bulunmaz; diğer serilerin benzer modellerinden “2 göz” bilgisi aktarılmamıştır.

### Konum etiketi için teyit gereken ürünler

- `nexus-siyah-cam-60-cm-onden-sol-orta-wok`
- `swan-siyah-cam-60-cm-onden-sol-orta-wok`
- `mono-siyah-cam-60-cm-onden-sol-orta-wok`
- `elite-siyah-cam-60-cm-onden-sol-orta-wok`
- `nero-siyah-cam-60-cm-onden-sol-orta-wok`
- `nirvana-siyah-cam-60-cm-onden-sol-orta-wok`

### Tekrarlanan Wok etiketi bulunan ürünler

- `nexus-siyah-cam-90-cm-4g-onden-wok-wok-sag`
- `swan-siyah-cam-90-cm-4g-onden-wok-wok-sag`
- `mono-siyah-cam-90-cm-4g-onden-wok-wok-sag`
- `elite-siyah-cam-90-cm-4g-onden-wok-wok-sag`
- `nero-siyah-cam-90-cm-4g-onden-wok-wok-sag`
- `nirvana-siyah-cam-90-cm-4g-onden-wok-wok-sag`

## Yapılan doğrulama

Dosya yeniden diskten okunup canlı yerel veritabanının Türkçe kaynaklarıyla karşılaştırılmıştır:

- 131/131 ürün; eksik veya yinelenen kimlik/slug yok.
- 655/655 ham kaynak alanı eşleşiyor.
- 1.310/1.310 çeviri alanı mevcut.
- Teknik listeler kaynakla bire bir, aynı uzunlukta ve aynı sırada: iki dilde toplam 346 çevrilmiş liste elemanı.
- Bütün boş teknik listeler `[]`; bütün seçenek ve aksesuar listeleri kaynakta boş olduğu için her iki dilde de boş.
- Her ürün adının sayı dizisi ve her açıklamanın ölçü sayıları kaynakla eşleşiyor.
- Kaynakta olmayan indüksiyon, sertifika, verimlilik, temperli cam, döküm veya gaz emniyeti ifadeleri için kontrol geçti.
- JSON ayrıştırma ve dosya üzerinden yapılan kapsam/kaynak kontrolleri başarılı.

## Başlık kısaltma revizyonu

Ana ajanın ilk teslimi veritabanına uygulayıp Rusça ürün sayfasını görsel olarak kontrol etmesinin ardından, yalnızca `translations.nameEn` ve `translations.nameRu` alanları yeniden düzenlenmiştir.

- 131 üründe toplam 262 başlık değişmiştir.
- Revizyon öncesi dosyayla karşılaştırmada `id`, `slug`, `source`, açıklamalar, teknik listeler, üst bilgiler ve nesne yapısı aynen korunmuştur.
- Her iki dilde her başlığın sayı sırası Türkçe kaynak adıyla aynıdır. Seri, yüzey, marka, Wok tekrarları ve konum niteleyicileri korunmuştur.
- RU başlık uzunluğu: ortalama **92 → 61**, en uzun **127 → 87** karakter. 95 karakteri aşan RU başlık yoktur.
- EN başlık uzunluğu: ortalama **61 → 54**, en uzun **91 → 79** karakter.
- Başlıklar sırf hedef uzunluğa ulaşmak için doldurulmamıştır; sade modeller doğal olarak 70 karakterden kısadır.
- “Sac” karşılığı dışında belirsiz etiketlere yeni anlam yüklenmemiştir. Yerel kodda bulunan “Wok Wok → Dual Wok” normalizasyonu bu editoryal dosyaya taşınmamıştır; mevcut muhafazakâr ayrım korunmuştur.
- Bu revizyonda veritabanına yazılmamış, kaynak koruma alanları yenilenmemiş ve uygulama kodu değiştirilmemiştir. Yeniden uygulama, snapshot ve görsel sayfa kontrolü ana ajana aittir.

## Ana uygulama kaydı — 14 Eylül 2026

İlk teslim ve başlık kısaltma revizyonu ana çalışma tarafından yerel veritabanına uygulandı; katalog snapshot'ı güncellendi. Yukarıdaki “veritabanına yazılmadı” ifadeleri yalnız çeviriyi hazırlayan alt çalışmanın sınırını açıklar. Türkçe kaynak koruması, önceki verilerle karşılaştırma ve uygulama kontrolleri [[14-ICERIK-VE-IHRACAT-PAZARLARI-GUNCELLEMESI]] içinde kayıtlıdır.