KAYIT KURALLARI — Ne Nereye Yazılır

Oluşturma: 13 Ağustos 2026 Neden var: Klasörde aynı içerik iki formatta duruyor (markdown + HTML sayfa). Kural yazılmazsa üç ay sonra hangisinin güncel olduğu bilinmez.

🔑 TEK CÜMLE

Formül Urunler/*.md'de değişir · Sayfalar/*.html'den okunur · veri Kayitlar/*.csv'ye yazılır.

ÜÇ KATMAN, ÜÇ ROL

Neden bu ayrım

• Markdown düzenlemesi kolay, sürüm farkı görünür, Claude ile çalışmaya uygun
• HTML okunması kolay, yazdırılabilir, mutfakta tablette açılabilir
• CSV toplanabilir, sıralanabilir, grafiğe dökülebilir — markdown tablosu bunların hiçbirini yapamaz

🔴 EN ÖNEMLİ KURAL: BATCH VERİSİ MARKDOWN'A YAZILMAZ

Hem Urunler/*/05_BATCH_DEFTERI.md hem Sayfalar/*.html içinde boş batch tabloları var. Bunlar şablon — doldurulmak için değil, neyin kaydedileceğini göstermek için.

Gerçek veri buraya:

Neden

Aynı veriyi 8 markdown + 8 HTML sayfaya dağıtırsan:

• Hiçbir soruya toplu cevap veremezsin ("kaç batch attık?", "pH ortalaması ne?")
• İki kopya birbirinden ayrılır
• Grafik çıkaramazsın

Bir tabloda ise: filtrele, sırala, ortalama al, grafiğe dök. Ölçüm çerçevesindeki 8 metrik (M1–M8) bu tablodan otomatik çıkar.

🚀 KURULUM — 10 dakika, bir kez

1. BATCH_KAYIT.csv, MALIYET_KAYDI.csv, SURE_KAYDI.csv dosyalarını Google Sheets'e yükle (Sheets → Dosya → İçe aktar → Yükle → CSV)
2. Üçünü tek bir çalışma kitabında ayrı sekmeler yap
3. Ekipteki herkese düzenleme yetkisi ver
4. Bağlantıyı 00_BASLA_BURADAN.md'ye yapıştır

Neden bulut, neden kâğıt defter değil: Grup çalışmasında kâğıt defter kaybolur, tek kişinin yanında kalır ve aranamaz. Telefonundan girebildiğin bir tablo, mutfakta ıslak elle bile doldurulur.

CSV kodlaması UTF-8. Google Sheets sorunsuz açar. Excel'de Türkçe karakter bozulursa: Veri → Metinden/CSV'den → Kaynak: UTF-8 seç.

📸 FOTOĞRAF ADLANDIRMA

Fotograflar/ klasörüne, şu kalıpla:

KREM02-001_gun0_dokme.jpg
KREM02-001_gun0_yuzey.jpg
KREM02-001_hafta4_koku-kontrol.jpg
LKR01-001_hafta2_renk.jpg

Kalıp: <BATCH-NO>_<zaman>_<ne>.jpg

Zaman: gun0 · gun1 · hafta2 · hafta8 Ne: dokme · yuzey · renk · kivam · kuf · ayrisma

Neden bu kadar önemli: Yavaş değişimi (renk koyulaşması, ayrışma başlangıcı) gözle hatırlamak imkânsız. 0. gün fotoğrafı olmadan 4. hafta fotoğrafı hiçbir şey söylemez.

🔄 FORMÜL DEĞİŞTİĞİNDE — sıra

Gerçek bir test sonucu geldi ve formül revize edilecek:

1. Veriyi BATCH_KAYIT.csv'ye yaz — ne oldu, ne ölçüldü
2. Urunler/<ürün>/01_FORMUL.md'de sürümü artır (v1.1 → v1.2) ve değişiklik geçmişi tablosuna gerekçe yaz
3. Etkilenen diğer dosyaları güncelle (00_KUNYE.md, 02_URETIM.md…)
4. Sayfalar/<ürün>.html'i yeniden üret — elle düzeltme, kaynaktan üret
5. Değişiklik büyükse Arsiv/'e faz notu

⚠️ Adım 2 atlanırsa formül değişir ama nedeni kaybolur. Altı ay sonra "bu oranı neden %6 yapmıştık?" sorusunun cevabı olmaz — ve projenin bütün öğrenme birikimi buharlaşır.

✋ TEK DEĞİŞKEN KURALI

Her ürün dosyasında yazılı, burada tekrar:

Bir batch'te yalnızca bir şey değişir.

Hem yağ oranını hem koruyucuyu hem hidrolatı aynı anda değiştirirsen, sonucun neden değiştiğini asla bilemezsin — ve elindeki tek veri kaynağını harcamış olursun.

BATCH_KAYIT.csv'de bunun için ayrı bir sütun var: Degisen_Tek_Sey. Boş bırakılan her satır, sonradan yorumlanamayan bir batch demektir.

🗑️ FİRE UTANÇ DEĞİL, VERİDİR

Atılan batch de kaydedilir — Fire = E, ve Fire_Nedeni doldurulur.

Ölçüm çerçevesindeki hedef: fire oranı %25 altı — sıfır değil.

📋 ÜÇ DOSYA, NE ZAMAN DOLDURULUR

Maliyet ve süre neden şimdi: İzin ve üretim hattı konuşmasının girdileri bunlar. Kullanıcı o konuşmayı sonraya bıraktı — ama verisi prototip üretilirken toplanır. Sonradan geriye dönük hesaplanamaz.