Kuran ve işleten kişi için

Kurulum ve bakım

Uygulama müşterinin Logo veritabanına erişebilen bir Windows makinesine kurulur ve orada Windows servisi olarak çalışır. Kurulum tek betikle yapılır; ardından yönetim paneli açılır ve 6 adımlı sihirbaz tamamlanır.

1. Gereksinimler

• İşletim sistemi: Windows 10/11 veya Windows Server 2016 ve üzeri, x64, yönetici hakkı.
• .NET: kurulmasına gerek yoktur. Paket kendi çalışma zamanını taşır (self-contained, win-x64).
• SQL Server: erişilebilir bir örnek. Ayrı bir veritabanı gerekmez — uygulamanın kendi tabloları müşterinin Logo veritabanında dbo.TCMBKUR_* adıyla durur.
• Logo: Logo veritabanı ve firma numaraları; kur yazılacak firmalar bilinmeli.
• İnternet: 443 portu üzerinden https://www.tcmb.gov.tr (günlük bülten) ve https://lisans.erp.tr (ERP çevrimiçi hizmetleri: ürün etkinleştirme ve güncelleme).

2. Kurulum (tek dosya, 5 dakika)

1. 1

   İndirin

   TcmbKurKurulum.exe dosyasını ürün sayfasındaki Kurulumu indir düğmesinden alın.

2. 2

   Çift tıklayın

   SmartScreen uyarısı çıkarsa Daha fazla bilgi → Yine de çalıştır; ardından UAC → Evet.

3. 3

   Üç adımı geçin

   Kurulum biter bitmez tarayıcı açılır: Logo klasörü → Veritabanı → Kur ve başlat.

Get-FileHash .\TcmbKurKurulum.exe -Algorithm SHA256

Kurulum ne yapar

1. Dosyaları seçtiğiniz klasöre açar. Ürün bu makinede zaten kuruluysa o klasör önerilir (kurulum onu servis kaydından, kendi kurulum kaydından ya da güncelleyicinin ayarından bulur); ilk kurulumda varsayılan C:\ERP\TcmbKur'dur.
2. 5230–5299 aralığından ilk boş portu seçer ve listen-url.txt dosyasına yazar.
3. ERP TcmbKur Windows servisini kurar ve başlatır.
4. Otomatik güncelleyiciyi kurar (5. bölüm).
5. /healthz sağlık kapısından geçmesini bekler.
6. Tarayıcıda kurulum ekranını açar.

Kurulum Logo ya da SQL bilgisi sormaz: servis veritabanı bilgisi olmadan da açılır ve sizi doğrudan kurulum ekranına götürür.

Kurulum ekranı — üç adım

Ekran bulabildiklerini sizin için önceden işaretler; çoğu kurulumda yalnızca İleri → İleri → Kur ve başlat dersiniz.

1. Logo klasörü — kayıt defterindeki LOBJECTS.EXE kaydından ve olağan yollardan bulunur; tek aday varsa doldurulur. Zorunlu değildir.
2. Veritabanı — makinedeki SQL Server örnekleri taranır, Logo veritabanları firma ve kur tablosu sayılarıyla listelenir; tek aday varsa seçilir. Listede yoksa “Listede yok / başka bir sunucu” bölümünden sunucu ve veritabanı adı yazılır.
3. Kurulum — özet gösterilir; Kur ve başlat bağlantıyı sınar, SQL yetkisini verir, tabloları oluşturur, ayar dosyasını yazar ve servisi başlatır.

Logo veritabanı başka bir sunucudaysa (ör. 10.31.18.133) o sunucu Windows kimliğini kabul etmeyebilir — Login failed for user … görürsünüz. Bu durumda Kimlik doğrulama → SQL Server kullanıcısı seçip kullanıcı adı ve parola girin. Parola ayar dosyasına şifreli yazılır (makine kapsamlı DPAPI).

Kurulum ekranı sonradan da açılır: http://127.0.0.1:<port>/setup/index.html.

Kurulum sihirbazının son adımı yönetici parolasını sorar. Boş bırakırsanız ilk giriş bilgisi admin / admin olur ve ilk oturumda değiştirilmesi istenir. Kurulum biterken ekran hangi bilgiyle gireceğinizi yazar — not almanız gereken tek şey budur.

3. Kurulum sihirbazı

Panel açıldığında /kurulum (aynı ekran /ayarlar adresinden de açılır) altı adımda ayarları toplar. Adımlar arasında ileri geri gezinebilir, son adımda kaydedebilirsiniz.

3.1 Windows servisi

Servisin kurulu ve çalışır olduğu doğrulanır. Buradan durdurup başlatabilirsiniz; servis zaten kuruluysa "Kur" düğmesi kapalı gelir.

3.2 Logo bağlantısı

SQL Server sunucusu, veritabanı ve kimlik doğrulama biçimi girilir; bağlantı yerinde test edilir. Ardından kur yazılacak firmalar seçilir. Bağlantı dizesi elle yazılmaz, alanlardan oluşturulur; parola tarayıcıya geri gönderilmez.

3.3 Kur çekme

Hangi para birimlerinin çekileceği, Logo'daki hangi kur alanına yazılacağı ve çalışma saatinin ne olacağı burada belirlenir. Ayrıntılı anlatım Günlük kullanım sayfasındadır; özet olarak:

• TCMB bülteni her iş günü 15:30'da yayımlanır ve ertesi iş günü için geçerlidir.
• Bu yüzden hedef gün D için D-1 bülteni kullanılır; bülten yoksa geriye doğru varsayılan 10 gün taranır.
• Erken çekim koruması varsayılan olarak açıktır: bülten saatinden önce eksik veri yazılmasını engeller.
• Yazma biçimi yalnız-ekle veya güncelle-ekle olabilir; L_DAILYEXCHANGES yazımı ve APPROVE=1 işaretlemesi isteğe bağlıdır.
• "Birime böl" seçeneği, 100 birim üzerinden kote edilen kurları (örneğin JPY) Logo'nun beklediği biçime çevirir.

3.4 E-posta ve kontrol raporu

SMTP bilgileri girilir ve günlük kontrol raporunun kime, saat kaçta gideceği seçilir. Rapor "bugün için kur yazıldı mı, kaç satır, hata var mı" sorusunu cevaplar; kurulumdan sonra sisteme kimse bakmasa bile eksik çalışma fark edilir.

3.5 Ürün etkinleştirme

Bu adım kurulumun ERP tarafından etkinleştirilmesini sağlar; ekrandaki yönlendirmeyi izlemeniz yeterlidir, sizden bir anahtar ya da kod girmeniz istenmez. Bir sorunla karşılaşırsanız S.S.S. bölümüne bakın veya ERP destek ile iletişime geçin.

3.6 Özet ve bitir

Son adım tüm seçimleri tek ekranda gösterir. Kaydettiğinizde ayarlar Logo veritabanındaki dbo.TCMBKUR_Config tablosuna yazılır ve zamanlanmış çalışma devreye girer.

4. Servis, sağlık ve loglar

Servisi komut satırından yönetmek için:

sc.exe query "ERP TcmbKur"
sc.exe stop  "ERP TcmbKur"
sc.exe start "ERP TcmbKur"

Panelde aynı bilgiler /service ve /logs ekranlarında görünür — Günlük kullanım sayfasına bakın.

Yedekleme

Veritabanı için ayrıca bir şey yapmanız gerekmez: uygulamanın tabloları Logo veritabanının içinde olduğundan zaten aldığınız Logo yedeği onları da kapsar. keys klasörü küçüktür; dosya yedeklemesine dahil edin.

5. Güncelleme

5.1 Otomatik güncelleme (varsayılan)

Kurulum, uygulamanın dışında yaşayan bir güncelleyici bırakır: %ProgramData%\ErpUpdate\TCMBKUR klasörü ve her gün 03:20'de SYSTEM olarak çalışan ERP Update TCMBKUR zamanlanmış görevi. Güncelleyicinin uygulamanın dışında olması bilinçlidir: kendini güncellemeye çalışan bir süreç kendi dosyasını kilitler.

Akış şöyledir:

1. Güncelleyici ERP güncelleme hizmetine ürün, sürüm ve cihaz kimliğiyle sorar.
2. Cevap imzalıdır — "güncelleme yok" cevabı da imzalıdır, çıplak bir hata kodu kabul edilmez.
3. Paket indirilir; SHA-256, boyut ve sürüm eşleşmesi doğrulanır.
4. Servis durdurulur, dosyalar takas edilir; veritabanı, keys, logs, listen-url.txt ve appsettings.Production.json korunur.
5. Servis başlatılır; /healthz 200 dönmeli ve bildirdiği sürüm hedef sürüm olmalıdır.
6. Kapıdan geçilemezse önceki sürüme otomatik dönülür, bozuk paket karantinaya alınır ve merkeze bildirilir.

Güncelleme etkinleştirme durumundan bağımsızdır: her kurulum güvenlik yamasını alır.

5.2 Elle güncelleme

Otomatik güncelleme kapatılmışsa veya bir sürümü elle yükseltmek gerekiyorsa güncel TcmbKurKurulum.exe indirilip çift tıklanır — ilk kurulumdaki tek dosyanın aynısı. Mevcut kurulumu tanır, yükseltir ve ayarları korur; kurulum ekranı yeniden açılmaz.

5.3 Neyin korunduğu

-noupdate ekiyle üretilmiş paketler güncelleyici taşımaz; bu paketler güncellemenin dışarıdan yönetildiği ortamlar içindir.

6. Yönetici parolasının sıfırlanması

En kolay yol — tarayıcı: sunucunun kendisinde giriş ekranını açın ve Giriş yapamıyorum bağlantısına tıklayın (/kurtarma). Yeni parolayı iki kez yazın; hesap yoksa yönetici olarak oluşturulur, varsa parolası sıfırlanır ve kilidi açılır.

Komut satırı yolu: aynı işi yönetici komut isteminden de yapabilirsiniz. Parola verilmezse uygulama yeni bir parola üretir ve ekrana yazar.

cd C:\ERP\TcmbKur
.\TcmbKur.App.exe reset-admin admin
.\TcmbKur.App.exe reset-admin admin --password YeniParola

7. Kaldırma

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

Betik servisi ve zamanlanmış güncelleme görevini kaldırır. Etkinleştirme ve cihaz kimliği koşulsuz korunur — aynı makineye yeniden kurulduğunda kurulum kaldığı yerden devam eder. Uygulamanın dbo.TCMBKUR_* tabloları Logo veritabanında durmaya devam eder; silinmeleri gerekiyorsa SSMS'ten elle kaldırın (Logo verisine dokunmayın).