nomis

Kilitçim - Kuyumcu Yönetim Sistemi

Kilitçim, kuyumcu atölyeleri için tasarlanmış profesyonel bir iOS uygulamasıdır. SwiftUI ve SwiftData teknolojileri kullanılarak geliştirilmiştir.

✨ Özellikler

Ana Özellikler

• CloudKit Senkronizasyon: Manuel senkronizasyon ile çoklu cihaz desteği
• Rol Tabanlı Erişim: Admin, görüntüleyici ve silme rolleri
• Otomatik Kaydetme: 3 saniyede bir taslak kaydetme
• Güvenli Kimlik Doğrulama: Keychain tabanlı güvenli şifre saklama
• Kapsamlı Yedekleme: JSON/CSV export/import + ZIP desteği
• Gelişmiş Analiz: Tarih, ayar ve kart bazlı fire analizi
• Dark Mode: Sistem teması desteği
• Zoom ve Kaydırma: Tüm formlarda pinch-to-zoom desteği

📱 Modüller

1. Şarnel

• Ayar ve altın giriş/çıkış takibi
• Demirli değerler (3 hücre + hurda + toz)
• Otomatik altın oranı hesaplama
• Asit çıkışı tablosu (dinamik satır ekleme)
• Fire hesaplama ve özet raporlama

2. Kilit Toplama

• Model, firma, ayar, tarih takibi
• Kasa/Dil/Yay/Kilit kategorileri
• Giriş/Çıkış (Adet/Gram) tablosu
• Otomatik fire ve özet hesaplamaları
• Süre takibi ve verimlilik raporları

3. Günlük İşlemler

• 7 farklı işlem kartı:
  • Tezgah (2 kart): Giriş/Çıkış takibi
  • Cila: Cila işlemleri
  • Ocak: Ocak işlemleri
  • Patlatma: Patlatma işlemleri
  • Tambur: Tambur işlemleri
  • Makine Kesme: Makine kesme işlemleri
  • Testere Kesme: Testere kesme işlemleri
• Haftalık form yönetimi (Pazartesi-Cuma)
• Her kart için ayrı ayar ve fire takibi
• Haftalık fire özeti
• Tamamlanmış formlar düzenlenemez

4. Notlar

• Basit not alma sistemi
• Otomatik zaman damgası
• Başlık ve içerik desteği
• Düzenleme geçmişi

5. Analiz

• Kilit Toplama Analizi: Model, firma, ayar bazlı raporlar
• Şarnel Analizi: Fire ve altın oranı analizleri
• Günlük İşlemler Analizi: Kart bazlı fire takibi
• Tarih aralığı filtreleme (Haftalık/Aylık/Yıllık)
• Ayar seçimi ve filtreleme
• PDF ve CSV export
• Grafik ve özet raporlar

6. Yedekleme

• Tam veri export/import
• JSON ve CSV formatları
• ZIP arşiv desteği
• Veri kurtarma ve taşıma

7. Ayarlar

• Model Yönetimi: Model ekleme, düzenleme, silme (sadece admin)
• Firma Yönetimi: Firma ekleme, düzenleme, silme (sadece admin)
• Uygulama Bilgileri: Versiyon ve geliştirici bilgileri
• Çıkış Yapma: Güvenli oturum kapatma

🔐 Kullanıcı Rolleri

Admin Rolü

Yetkiler:

• Tüm formları oluşturma ve düzenleme
• Model ve firma yönetimi
• Kullanıcı yönetimi
• Tüm ayarlara erişim

Silme Rolü

Yetkiler:

• Sadece silme işlemleri
• Düzenleme yetkisi yok

Görüntüleyici Rolü

Yetkiler:

• Tüm verileri görüntüleme (salt-okunur)
• Form ve kayıtları inceleme
• Düzenleme ve silme yetkisi yok
• Model/firma ekleme/düzenleme yok

Not: Kullanıcı adları ve şifreler güvenlik nedeniyle README’de gösterilmemektedir. Giriş bilgileri için uygulama sahibiyle iletişime geçin.

🏗️ Teknik Detaylar

Mimari

• UI Framework: SwiftUI
• Veri Katmanı: SwiftData
• Güvenlik: Keychain Services
• Hedef Platform: iPadOS 17+, iPhone uyumlu
• Swift Versiyonu: 5.10+

Tasarım

• Tema: Lüks ve profesyonel
• Renk Paleti:
  • Derin yeşil (ana renk)
  • Altın vurgular
  • Krem/Off-white arkaplanlar
• Tipografi: System font, başlıklarda semibold
• Bileşenler: Yuvarlatılmış kartlar, hafif gölgeler

Yerelleştirme

• Dil: Türkçe (tr)
• Locale: tr_TR
• Tarih/Sayı Formatları: Türkiye standartları

📊 Veri Modelleri

Şarnel Form

- karatAyar: Int
- girisAltin/cikisAltin: Double?
- demirli_1/2/3: Double?
- demirliHurda/Toz: Double?
- asitCikislari: [AsitItem]
- altinOrani: Double? (computed)
- fire: Double? (computed)

Kilit Toplama Form

- model: String?
- firma: String?
- ayar: Int?
- startedAt/endedAt: Date?
- kasa/dil/yay/kilit: [KilitKategori]
- toplamGirisGram/toplamCikisGram: Double
- fireGram: Double (computed)

Günlük Form

- baslamaTarihi/bitisTarihi: Date
- gunlukVeriler: [GunlukGunVerisi] (5 gün)
- isWeeklyCompleted: Bool

Not

- title: String
- text: String
- createdAt: Date
- lastEditedAt: Date?
- createdByUsername: String
- lastEditedByUsername: String?

💾 Güvenlik ve Veri Yönetimi

Kimlik Doğrulama

• Keychain’de güvenli şifre saklama
• Oturum yönetimi
• Rol tabanlı erişim kontrolü

Veri Güvenliği

• Otomatik taslak kaydetme (3 saniye)
• Background/foreground geçişlerinde kaydetme
• Hata toleranslı veri işleme
• Güvenli backup/restore mekanizması

Önemli Özellikler

• Satır Sıralaması: Günlük işlemlerde satırların sırası asla değişmez
• Fire Hesaplaması: Negatif fire değerleri otomatik olarak 0’a yuvarlanır
• Haftalık Tamamlama: Tamamlanan formlar düzenlenemez
• Admin Koruması: Kritik işlemler için admin şifresi gerektirir

🚀 Kurulum ve Çalıştırma

Gereksinimler

• Xcode 15.4+
• iOS 17.0+ (iPad için optimize)
• Swift 5.10+

Adımlar

1. Projeyi Xcode’da açın
2. Bundle ID’yi kendi ID’nize değiştirin (Signing & Capabilities)
3. Team’inizi seçin
4. Simulator veya gerçek cihazda çalıştırın

İlk Çalıştırma

1. Uygulama açıldığında login ekranı görünür
2. Geçerli kullanıcı adı ve şifre ile giriş yapın
3. Ana ekranda 7 modül kartını görürsünüz
4. Tüm modüller tam fonksiyoneldir

📝 API Referansı

Formatters

• safeFormat(): Güvenli sayı formatı (nil kontrolü)
• dateTimeFormatter: Türkçe tarih/saat formatı
• turkishNumberFormatter: Ondalık sayı formatı (virgül ayracı)

Theme

• primaryGreen: Ana renk (#2D5D3F)
• accent: Vurgu rengi
• nomisCard(): Kart stil modifier’ı
• PrimaryButtonStyle: Ana buton stili

📱 Proje Durumu

✅ Tamamlanan Özellikler

• Tüm 7 modül tam fonksiyonel
• Rol tabanlı erişim kontrolü
• Otomatik kaydetme sistemi
• Gelişmiş analiz ve raporlama
• Yedekleme ve veri transfer
• Model/Firma yönetimi
• Not sistemi

🎯 Uygulama Hazır Durumda

Bu uygulama üretim için hazırdır ve App Store’a yüklenebilir.

📞 İletişim

Not: Bu uygulama profesyonel kuyumcu atölyeleri için tasarlanmış, üretim seviyesinde bir yönetim sistemidir.

---

Versiyon: 1.3.0
Son Güncelleme: Ekim 2025
Platform: iOS 17.0+

🆕 Sürüm Notları

Versiyon 1.3.0 (Güncel)

• ✅ CloudKit senkronizasyon iyileştirmeleri
• ✅ Public Database ile farklı iCloud hesapları arası veri paylaşımı
• ✅ Çoklu cihaz desteği (5+ cihaz)
• ✅ Index optimizasyonu (daha hızlı sorgulama)
• ✅ Production log temizliği
• ✅ Stabil ve güvenilir senkronizasyon

Versiyon 1.2.0

• ✅ CloudKit manuel senkronizasyon eklendi (çoklu cihaz desteği)
• ✅ Güvenli silme mekanizması (sadece yetkili kullanıcılar)
• ✅ Formlar varsayılan olarak salt-okunur açılır
• ✅ Tüm formlarda pinch-to-zoom desteği
• ✅ Performans iyileştirmeleri (LazyVStack/LazyHStack)
• ✅ TextField Enter tuşu navigasyonu
• ✅ Dark Mode desteği
• ✅ Metin sarma ve çok satırlı görüntüleme
• ✅ Tezgah kartında haftalık fire özeti güncellendi
• ✅ Swipe-to-delete kaldırıldı, güvenli silme butonu eklendi