Devir paketi — Kırşehir Su ve Elektrik Tesisleri Envanteri

Bu paket, çalışmayı Claude Code tarafında sürdürmek için hazırlandı. Amaç: programı yeniden tasarlamak değil, çalışan bu sürümü gerçek bir kod deposunda sürdürülebilir hâle getirmek.

Çalışan sürüm: 2026.09.30-103. Sürüm damgası index.html içindeki const SURUM satırında ve programın Ayarlar > Veri > "Program sürümü" kartında görünür.

Depo düzeni bu paketten farklı: bu GitHub deposunda (abert84tv/kirsehir-envanter) yayına giden dosyalar yayin/ alt klasörü olmadan doğrudan depo kökündedir — Vercel'in cleanUrls ile kök dizini otomatik sunması buna dayanıyor. Aşağıdaki tablo ve yollar buna göre güncellenmiştir; masaüstündeki devir paketi hâlâ yayin/ alt klasörlü orijinal düzeni kullanır.

1. Program ne yapıyor

Kırşehir'deki kırsal su ve elektrik tesislerinin (kuyu, depo, AG panosu, GES) envanteri; saha arıza ve bakım takibi; ambar/zimmet, araç, personel ve nöbet kayıtları; harita üzerinde konum ve hat yönetimi. Telefon ve masaüstü aynı programdan çalışır; çevrimdışı kayıt tutar, bağlantı gelince eşitler.

Kapsamın tamamı, ekran ekran alan listeleri, veri kaynakları ve oturum oturum değişiklik kaydı DURUM.md dosyasındadır. Claude Code'da ilk okunacak dosya budur.

2. Paketin içeriği

Yol	Ne
index.html	Ana program: bütün ekranlar, iş kuralları, yetki, eşitleme
harita.html	Harita penceresi (Leaflet), ana pencereyle postMessage ile konuşur
profil.html	Hat Kesiti — çok noktalı mesafe/yükseklik profili
hat.html	Hat güzergâhı (boru) çizim aracı
harita-ortak.css, harita-ortak.js	Üç harita dosyasının (harita/profil/hat) paylaştığı koyu tema karo kısması ve uzun-basış nokta ekleme mantığı — burada tek yerden değişir
envanter.js, koyler.js, kuyular.js, kirsehir-data.js	Gömülü gerçek veri: 264 kuyu noktası, 1043 yerleşim, 260 köy-ilçe ataması, nüfus
isu-katmanlar.js	ISU kurumundan alınan referans nokta katmanları (kaynak, memba, depo) — harita.html'de seçmeli katman
supabase-baglanti.js	Sunucu katmanı: oturum, kurum_veri, denetim, numara sayacı, sunucu saati
SQL-*.sql	Veritabanı kurulum betikleri (sırası aşağıda)
_ds/	Bağlı tasarım sistemi (Modernist) — token ve bileşen kaynağı
DURUM.md	Durum raporu + bütün oturum kayıtları (ana referans)
KURULUM.md	Supabase / R2 / SMS kurulum adımları
YAYIN.md	Yayınlama (GitHub + Vercel) notları — yayin/ alt klasörünü anlatıyor, bu depoda geçerli değil
vercel.json	Yayın ayarı — kök dizin cleanUrls ile doğrudan sunulur

Depodaki HTML dosyaları maket değil, çalışan programdır. Tarayıcıda index.html açılınca çalışır; derleme adımı yoktur.

Push'tan önce: node duman-testi.js — tarayıcı açmadan, birkaç saniyede biten hafif bir kontrol: gömülü script'lerin sözdizimi, yerel dosya referanslarının (src/href) gerçekten var olması, vercel.json rewrite hedeflerinin var olması, üç harita dosyasının harita-ortak.css'i yüklemesi. Hiçbir CI/otomatik test yok — bu, en azından "site hiç açılmaz" türünden hataları push'tan önce eler (bkz. harita.html/profil.html/hat.html paylaşılan kod tekrarı ve vercel.json 404 hataları, 2026.09.14–15).

3. Teknik yapı

• Modüler kaynak (2026-10-07): uygulama src/ klasöründe modüllere ayrılmıştır (src/moduller/<ad>/ — şablon masaüstü+telefon, yöntemler, görünüm modeli, SQL, edge function). index.html ve supabase-baglanti.js üretilen dosyalardır: node build.js ile src/'den derlenir (Vercel de yayında çalıştırır; npm bağımlılığı yok, yalnız Node). Ayrıntı ve özellik ekleme/çıkarma kılavuzu: src/README.md; ilerleme kaydı: MODUL-ILERLEME.md; modül bağımlılıkları: node modul-bilgi.js --bagimlilik. index.html'i elle düzenlemeyin — değişiklik src/'de yapılır, sonra node build.js && node duman-testi.js.
• Çalışma zamanında hâlâ tek dosya: index.html içinde bir bileşen sınıfı + şablon; derleyici/paket yöneticisi yok.
• Stil satır içi; ortak değerler tasarım sisteminin var(--*) token'larından gelir. Ayrı CSS sınıf katmanı yoktur.
• Harita ayrı belge (harita.html) ve postMessage ile yönetilir: {ks:'theme'|'filter'|'setBase'|'pick'|'hatKatman'|'flyTo'} gönderilir, haritadan {ks:'route'|'base'|'hatlar'|...} döner.
• Durum: tek büyük state; kalıcılık localStorage + Supabase.
• Sunucu erişimi yalnız RPC fonksiyonlarından (veri_oku, veri_yaz, veri_hepsi, denetim_ekle, denetim_toplu, denetim_listesi, ambar_hareket, numara_al, numara_toplu, sunucu_saati). Tablolara doğrudan erişim RLS ile kapalı, denetim tablosu tetikleyiciyle değiştirilemez.

localStorage anahtarları

ks-tema (tema — cihaz düzeyi, tek doğru kaynak), ks-pref-<kullanıcı> (kullanıcı tercihleri), ks-ekipler, ks-ambar, ks-ambar-kuyruk, ks-kuyruk (eşitleme kuyruğu), oturum/token anahtarları.

Tema kuralı (son oturumda düzeltildi): tema iki yerde tutuluyordu ve çakışıyordu. Artık girişte cihazdaki ks-tema her zaman kazanır; kullanıcı tercih dosyasındaki theme yalnız cihazda kayıt yoksa devreye girer, her seçimde ikisi eşitlenir. Bu davranış korunmalı — bozulursa "aydınlığa aldım, tekrar girince koyu açılıyor" sorunu geri gelir.

Açılış kuralı

Üç giriş yolunun hepsi (normal giriş, şifre değişimi sonrası, otomatik oturum) tab: 'harita' ile başlar: ana sayfa Envanter > Harita. Bırakılan sayfa geri getirilmez; tema, harita zemini, süzgeçler, katmanlar, koordinat sistemi ve cihaz modu geri gelir.

Telefon katman kuralı

Çakışan menü sorunu sabit piksel yerine iki canlı CSS değişkeniyle çözüldü: --tel-bas (üst çubuğun gerçek alt kenarı) ve --tel-nav (alt menünün gerçek yüksekliği). Değerler açılışta, boyut ve yön değişiminde ölçülüp yazılır; açılan bütün paneller bu değişkenlere yaslanır. Yeni panel eklerken sabit top/bottom piksel yazılmamalı, bu değişkenler kullanılmalı.

4. Veritabanı kurulum sırası

Supabase SQL düzenleyicisinde bir kez, bu sırayla:

1. src/moduller/cekirdek/sql/SQL-yeni-moduller.sql
2. src/moduller/denetim/sql/SQL-cop-kutusu.sql
3. src/moduller/esitleme/sql/SQL-moduller-sunucu.sql
4. src/moduller/esitleme/sql/SQL-veri-butunlugu.sql
5. src/moduller/ambar/sql/SQL-ambar-hurda.sql — ambar hareketine "hurda" türü ekler (2026.09.15)
6. src/moduller/is-emri/sql/SQL-is-emirleri.sql — İş Emri tablosu + RPC seti (2026.09.30)
7. src/moduller/ariza/sql/SQL-kanit-saklama.sql — arıza kanıtı 2 yıl / envanter fotoğrafı ömür boyu saklama politikası, KVKK (2026.09.30)
8. src/moduller/ambar/sql/SQL-ambar-koy-raporu.sql — ambar hareketine tesis referansı ekler, köy/ilçe bazlı malzeme raporu için (2026.09.30)

Daha önce çalıştırılanlar tekrar edilmez; hepsi create or replace ile yazıldığı için tekrar çalıştırmak da zarar vermez. 4'ü daha önce çalıştırdıysanız yalnız 5-6-7'yi çalıştırmanız yeterli.

5. Yayınlama

Depo kökü doğrudan yayındır — git push origin main yeterli, Vercel bu depoya bağlı, otomatik yayına alır (1-2 dakika). Yükleme sonrası tarayıcıda bir kez sert yenileme (Ctrl+F5) gerekir — eski kopya önbellekte kalırsa sürüm damgası 2026.09.30-103 görünmez ve düzeltmeler uygulanmamış gibi durur. Program içinde Ayarlar > Veri > "Programı tazele" aynı işi yapar.

6. Claude Code'da sıradaki işler

2026.09.14 listesindeki dört madde (uzun basış, çift tık, koyu tema, yetki sadeleştirme) 2026.09.15 oturumunda bitti. 2026.09.30'da "büyük güncelleme" (38 maddelik istek listesi) başladı, fazlara bölündü — plan dosyası: C:\Users\abert\.claude\plans\glistening-sauteeing-spindle.md, ayrıntılı kayıt DURUM.md. Şu an en öncelikli, aktif bekleyenler:

1. Özet ekranı sekmelere ayrıldı, sol menü denetlendi (2026.09.30-103). Kullanıcı: "sol menüyü de düzenle baştan sona, özet bölümünün içeriği çok karmaşık." İki ayrı Explore taraması yapıldı (menü + Özet).
   • Sol menü: masaüstü kenar çubuğu (nav + kullanıcı kartı) ve üst çubuk/telefon alt çubuğu/"Tümü" ekranı incelendi — gerçek bir karmaşa ya da tekrar bulunamadı (önceki turda zaten iki zincire göre yeniden gruplanmıştı). Bulunan somut sorunlar düzeltildi: kullanılmayan iki render prop (nav, goOzet — hiçbir şablonda çağrılmıyordu) silindi; telefonda Ayarlar > Görünüm'deki "Diğer ekranlar" kısayol listesi, o an açık olan Ayarlar'a kendine dönen anlamsız bir düğme gösteriyordu, düzeltildi.
   • Özet ekranı: tek, sürekli kayan sayfada 9 ayrı tablo/liste üst üste duruyordu (istatistik kutuları, aktiflik, ilçe, köy, ekip performansı, tekrarlayan arıza, eksik bilgi, esnek tarih raporu, köy bazlı malzeme maliyeti) — hiç alt sekme/katlama yoktu, taramanın kendisi bunu "çok karmaşık" şikâyetinin doğrudan sebebi olarak işaretledi. Üç sekmeye bölündü: Envanter (dağılım/ilçe-köy/eksik bilgi/yakın tesisler), Ekip ve arıza (performans/tekrarlayan), Rapor (tarih+ilçe filtreli özet + köy bazlı malzeme maliyeti — ikisi zaten aynı filtreyi paylaşıyordu). İstatistik kutuları ve dışa aktarım düğmeleri her sekmede görünür kalıyor. Tarama ayrıca telefonda gerçek bir görüntüleme hatası buldu (Eksik bilgisi olan kayıtlar başlığı boş görünüyordu, asıl liste yanlışlıkla iki bölüm sonra, başlıksız çıkıyordu) — bu da düzeltilirken giderildi. Giriş yapılamadığı için her iki ekran da görsel olarak doğrulanamadı — ayrıntı DURUM.md'de.
2. Ayarlar ekranı yeniden düzenlendi (2026.09.30-102). Kullanıcı geri bildirimi: "sağ üstte menüleri tekrar konumlandırmışsın, Ayarlar'da bir sürü açıklama ve iç içe menü var, menüleri gerçekten düzenlememişsin." Kod incelemesiyle üç somut sorun bulundu ve düzeltildi:
   • Üst çubuktaki hap listesi (sayfaBar), Ayarlar'da sayfa içindeki listeyle aynı yerlere giden 4 tekrar eden bağlantı gösteriyordu ("iki ayrı menü gibi"). Yetki sistemine dokunmadan (SUZGEC_TANIM hâlâ aynı, izin kontrolü bozulmadı — bu noktada dikkatli davranmak gerekti, kör silme gerçek bir izin açığı yaratabilirdi) yalnızca görünen hap listesi Ayarlar'da tek girdiye (kendisi) süzüldü.
   • "Süzgeç haritası" adlı, 2026.09.15'teki menü birleşmesinden kalma, kullanıcıya hiçbir işe yaramayan teknik bir tablo tamamen silindi.
   • "Ortak veritabanı ve eşitleme" tek satırda altı ayrı konuyu (sürüm, senkronizasyon, köy adı eşleştirme, arıza bildirimi/SMS kurulumu üç seviye iç içe, yeni tesis kısayolu, dışa aktarım kısayolu) topluyordu — dört ayrı, tek konulu bölüme ayrıldı, yeni "Saha araçları" grubu altında. Ayrıntı ve kapsam kararları DURUM.md'de. Giriş yapılamadığı için Ayarlar ekranının kendisi görsel olarak doğrulanamadı — kod incelemesi ve regresyon taramasıyla güvence altına alındı, kullanıcı giriş yapıp görecek.

Yapı kararı: sayfa kimlikleri (Envanter, İşler, Kaynaklar, Özet, Hat Kesiti, Ayarlar) sabittir — yeni iş bunların üstüne oturur, kapanan modüller sayfa değil süzgeç düşürür. Sol menüdeki grup başlıkları ve etiketler (2026.09.30'da "Saha işleri" / "Envanter" olarak ikiye ayrıldı) buna dahil değil, kullanılabilirlik için değişebilir.

7. Modernist tasarım sistemi

Görsel dil yayin/_ds/ altındaki Modernist sistemine bağlıdır: tek yazı tipi Archivo, keskin köşe, güçlü ayraç, tek vurgu rengi. Program arayüzü bunun üzerine Apple benzeri sakin bir katman koyar: ana renk mavi #0071e3, zemin #f5f5f7, yazı #1d1d1f, saç teli ayraçlar, yuvarlatılmış köşeler; kırmızı yalnız acil öncelik, hata/uyarı kutuları ve çevrimdışı şeridinde. Yeni ekran eklerken bu palet ve 42px dokunma yüksekliği kuralı korunmalı.