Lumen v1.5.0-beta.1 — Trendyol ve Hepsiburada bağlantıları

Trendyol siparişleri ve Hepsiburada'nın hazırlanmış açık paketleri, kullanıcıya ait API bilgileriyle Lumen kontrol kutusuna alınabilir. Muhasebeye aktarım kullanıcı incelemesi ve onayında kalır. LOGO ve bağımsız modda aynı akış kullanılır.

• Trendyol: test/üretim bağlantısı, tarih aralığı, otomatik sayfalama, durdurma ve kaldığı yerden sürdürme.
• Hepsiburada: Merchant ID, API kullanıcı adı, servis anahtarı ve tanımlı User-Agent ile en fazla 24 saatlik paket alımı. Eksik/tutarsız başlık, değişen toplam veya yinelenen sayfa ilerlemeyi durdurur.
• Şifreli kanal bağlantıları, kalıcı bekleme/yeniden deneme, ham yanıt ve denetim izi; kutu kaydıyla ilerleme tek transaction içinde saklanır. Eski Trendyol bağlantıları ve cursor korunur.
• E-ticaret/EVDS kabul kapsamı; eski şemadan yükseltme ve iki kanalın yedekten dönüş kontrolleri genişletildi.

Alım ekran açıkken ilerler; zamanlanmış arka plan işçisi yoktur. Hepsiburada'da paketlenmemiş siparişler ve ayrı iptal/iade servisleri bu sürümün dışındadır. Aktarımdan önce Hepsiburada panelinde paketin güncelliğini kontrol edin.

Yükseltme: uygulama/veritabanı yedeğini doğrulayın; dosyaları ve composer install --no-dev ile bağımlılıkları güncelleyin. Doğru veritabanında php scripts/sema_guncelle.php çalıştırın. Mevcut ayar/bağlantı dosyalarını koruyun. database/eticaret-master.key ve database/evds-master.key dosyaları (varsa özel yolları) SQL yedeğinden ayrı ve güvenli biçimde yedeklenmelidir. Kanal bağlantısı/alımı M33 + M16, aktarım M1, fiyat/KDV farkı SP1 ister.

Doğrulama: etiketin iki moddaki kabul çalışmasında 28 adım başarılıdır; rapor bu ön sürüme eklidir. 71 birim testi, 9 Trendyol ve 11 Hepsiburada akışı doğrulanmıştır. PR kontrollerinde 5 ağsız tarayıcı senaryosu da geçmiştir. Yalnız sentetik veri/taşıyıcı kullanıldı; gerçek pazaryeri hesabı, gerçek EVDS anahtarı veya LOGO/IIS pilotu denenmedi. Sunucu denetiminde 0 hata ve HTTP demo nedeniyle beklenen 1 HTTPS uyarısı vardır. Canlı sisteme dağıtım yapılmadı.

Kılavuzlar: Trendyol · Hepsiburada · Değişiklik günlüğü

Bu bir ön sürümdür. Kararlı Latest v1.4.0 yerinde kalır.

Lumen v1.4.0 — E-ticaret ve Ekonomik Göstergeler

Lumen v1.4.0

Bu kararlı sürüm, v1.4.0-beta.1–beta.3 içeriğini ve EVDS anahtar dosyası güvenlik düzeltmesini içerir. E-ticaret ve Ekonomik Göstergeler modülleri kendi kullanım sınırları nedeniyle uygulama içinde beta olarak işaretlidir.

Yenilikler

• E-ticaret Sipariş Kutusu: CSV/genel JSON ve Trendyol v2/Hepsiburada paket yanıtlarını dosyadan önizleme, ürün eşleme, fiyat/KDV/depo kontrolü ve kullanıcı onayıyla atomik satış siparişi aktarımı. Mükerrer paket/kalem ve eşzamanlı aktarım koruması bulunur.
• Ekonomik Göstergeler: kullanıcıya özel şifreli EVDS 3 API bağlantısı, seri grafiği, kaynak/dönem bilgisi, sayfalı tablo ve Türkçe CSV. Anahtarsız sentetik örnek de vardır.
• Kasa/banka, belge, cari, döviz kuru ve stok hareketi geçmişlerindeki sayfalama ile tutar girişi düzeltmeleri.

Güvenlik

• EVDS ana anahtar dosyasına 0600 izni ilk anahtar baytı yazılmadan önce verilir. Sunucu denetimi bu dosyanın web üzerinden indirilemediğini kontrol eder.
• Dosya içe aktarma sınırları, M33/M34 ve ek aktarım yetkileri, özel cari kısıtları, CSRF, SQL parametreleri, çıktı kaçışı, EVDS hedef/TLS ve anahtar saklama gözden geçirildi.
• Açık Dependabot uyarısı yoktu. CodeQL analizi bu depoda etkin görünmüyor.

v1.3.2’den yükseltme

1. Uygulama dosyaları ile veritabanının geri yüklenebilir yedeğini alın.
2. Bu sürümün dosyalarını kurup composer install --no-dev çalıştırın.
3. Doğru veritabanında php scripts/sema_guncelle.php çalıştırın.
4. E-ticaret için M33, ekonomik göstergeler için M34 yetkisini yalnız ilgili personele verin. Kanal yönetimi M16, satış siparişine aktarım M1, fiyat/KDV farkı SP1 gerektirir.
5. İlk EVDS anahtarı kaydında oluşan database/evds-master.key dosyasını SQL yedeğinden ayrı ve güvenli yerde yedekleyin.

Pazaryeri bağlantısı otomatik değildir; belgelenmiş JSON dosyaları alınır. Gerçek EVDS anahtarıyla canlı hizmet testi ve gerçek LOGO/IIS kurulumu bu sürümün sentetik kabul testleriyle doğrulanmadı. Ham sipariş/adres verileri kutuda saklanır; M33 yetkisini sınırlı verin. Otomatik kişisel veri silme bu sürümde yoktur. Canlı kurulum yapılmadı.

Kılavuzlar: E-ticaret · EVDS · Değişiklik günlüğü

Lumen v1.4.0-beta.3 — Ekonomik Göstergeler ve kişisel EVDS bağlantısı

Ekonomik Göstergeler — kişisel EVDS API bağlantısı

• Her kullanıcı kendi EVDS API anahtarını Ekonomik Göstergeler → Kişisel bağlantı ekranından tanımlar, değiştirir veya kaldırır.
• Anahtar kişi/firma bağlamıyla şifrelenir; forma tekrar yazılmaz ve başka kullanıcıyla paylaşılmaz. Yalnız güncel EVDS 3 HTTPS hizmetine key başlığında gönderilir.
• Hazır USD döviz satış/EUR döviz alış veya EVDS kataloğunda doğrulanan özel seri kodu tarih aralığıyla sorgulanır.
• Orijinal seri sıklığı, eksik gözlem, kaynak, veri dönemi ve alınma zamanı korunur. Grafik, sayfalı tablo ve Türkçe Excel uyumlu CSV sunulur.
• Günlük önbellek, bağlantı kesildiğinde tarihli eski veri uyarısı ve anahtarsız sentetik örnek bulunur. Muhasebe kayıtları ve tanımlı kurlar değişmez.
• LOGO ve bağımsız modda aynı ekran; M34 yetkisi gerekir. Telefon görünümünde sonuç açılınca filtre katlanır.

Bu sürüm EVDS web servisi panelidir. EVDS-MCP üzerinden sohbet, OAuth bağlantısı veya yapay zekâ model hizmeti içermez.

Kurulum ve doğrulama

Güncellemede php scripts/sema_guncelle.php çalıştırılır; personele M34 yetkisi verilir. Yönetici otomatik erişir. Kullanıcı, EVDS profilindeki kendi API anahtarını uygulama içinden girer.

İlk anahtar kaydı korumalı database/evds-master.key dosyasını oluşturur. Dosya SQL yedeğinden ayrı, güvenli bir yerde yedeklenmelidir. Kullanım, kurulum ve sınırlar: EVDS kılavuzu.

61 birim testi, iki modda 6'şar EVDS akışı ve mevcut testler GitHub'da doğrulandı. Yerel 202 sayfa/3 kullanıcı duman taraması hatasız; masaüstü ve mobil görsel kontrol tamamlandı. Testlerde yalnız sentetik anahtar/veri kullanıldı. Gerçek anahtarla canlı servis kabulü yapılmadı; kullanıcı erişimi ilk veri sorgusunda doğrulanır.

PR #49 ve #50 ayrı olarak beta dalına squash merge edildi. Bu beta ayrıca PR #48'deki e-ticaret tasarım düzenlemesini içerir. Kararlı main/v1.3.2 değiştirilmedi; canlı sisteme dağıtım yapılmadı.

Lumen v1.4.0-beta.2 — Trendyol ve Hepsiburada paketleri

Trendyol ve Hepsiburada sipariş paketleri için ortak sipariş kutusu geliştirildi.

• Kanal, sipariş, paket ve harici kalem kimlikleri korunur; aynı siparişin farklı paketleri ayrılır. Yinelenen kalem ve yenilenmiş eski paket aktarımı engellenir.
• Trendyol v2 ve Hepsiburada paket listesi JSON dosyaları önizleme ile alınır. Sentetik örnekler içe aktarma ekranından indirilebilir.
• İndirim, fiyat, KDV ve paket toplamları doğrulanır. Kaynak iptal/ödeme durumları kullanıcı onayıyla aşılamaz; eski tarihli yanıt yeni durumu geri alamaz.
• Aktarım sonrası iptaller uyarı olarak gösterilir. Lumen siparişi otomatik değiştirilmez.
• SQL Server ROWVERSION form sürümünün kararlı hex üretimi düzeltildi.

54 birim testi, LOGO ve bağımsız modda 12'şer e-ticaret akışı ve diğer mevcut akışlar geçti. İki PR (#46, #47) beta dalına squash merge edildi; tüm GitHub kontrolleri başarılı.

Bu bir ön sürümdür. Gerçek pazaryeri bağlantısı, otomatik sipariş çekme, erişim anahtarı saklama, webhook, iade ve komisyon mutabakatı içermez. TRY/ ADET, 1 MB ve 100 paket sınırları geçerlidir. Hepsiburada ayrı indirim faturası ve satıcı/müşteri tutarı farkı olan kayıtlar incelemeye bırakılır.

Güncellemede mevcut şema güncelleyicisi kullanılmalı: php scripts/sema_guncelle.php. Yeni paket/kaynak alanları için SQL değişiklikleri tekrar çalıştırılabilir.

Resmî API kaynakları, alan eşlemeleri ve destek sınırları: PAZARYERI_API.md.

Kararlı main/v1.3.2 değiştirilmedi. Canlı sisteme dağıtım yapılmadı; yalnız sentetik demo verisi kullanıldı.

Lumen v1.4.0-beta.1 — E-ticaret Sipariş Kutusu

E-ticaret Sipariş Kutusu'nun ilk beta sürümü. LOGO ve bağımsız Lumen modlarında aynı kullanıcı akışı sunulur.

• Satış kanalları ve varsayılan cari/depo/personel.
• CSV ve genel JSON önizlemesi; yalnız ara tablolara alım.
• Kanal bazında SKU/barkod eşlemesi, fiyat/KDV ve depo stok kontrolü.
• Kullanıcı onayıyla mevcut Lumen satış siparişine aktarım.
• Veritabanı benzersizliği, eşzamanlı istek kilidi ve Idempotency-Key ile mükerrer koruması.
• Ham dosya/sipariş, adresler, hatalar, yeniden denemeler ve kullanıcı denetim izi.

Yükseltme: uygulama ve veritabanı yedeğinden sonra bu sürümün kaynaklarını kurup php scripts/sema_guncelle.php çalıştırın. Personele M33; kanal yönetimi için M16, aktarım için M1, fiyat/KDV farkı için SP1 gerekir. Yönetici M33'ü otomatik alır.

Kullanım ve sentetik örnekler: Türkçe kılavuz.

İlk MVP yalnız TRY ve desteklenen basit kalemleri aktarır. Gerçek pazaryeri API bağlantıları/anahtarları, otomatik cari, döviz, iskonto/kargo/masraf dağıtımı, kargo, iade ve e-belge bu sürümde yoktur. Sipariş doğrudan fatura veya stok/cari hareketi oluşturmaz; mevcut rezervasyon ayarı uygulanır.

Doğrulama: 47 birim testi; her iki modda 7 e-ticaret akışı; LOGO'da 23 ortak akış, bağımsızda 36 belge/finans ve 22 ortak akış; iki modda 200 sayfa duman testi. Rollback, farklı kullanıcılarla paralel aktarım, fiyat yetkisi, kaynak çakışması ve stok kontrolleri sentetik demo verisiyle sınandı. 390 px mobil görünüm kontrol edildi.

Hazırlık #40 ve özellik PR'ları #41–#45, GitHub kontrollerinden sonra beta dalına squash merge edildi. Bu sürüm ön sürümdür; kararlı Latest sürümü değiştirmez.

Lumen v1.3.2 — Güvenlik ve bakım

Lumen v1.3.2 — Güvenlik ve bakım

Bu sürüm, API belirteçlerini ve siparişlerin ağ tekrarlarına karşı korunmasını güçlendirir. Sipariş, cari, rapor ve belge ekranlarındaki bakım düzeltmelerini içerir.

Öne çıkanlar

• API belirteçleri tür işaretli özetlerle saklanır; veritabanındaki özet Bearer belirteci olarak kullanılamaz.
• Sipariş API'si Idempotency-Key ile aynı veya eşzamanlı tekrarları tek siparişe indirir.
• Kısmi teslim miktarları, döviz dönüşümleri, işlem saatleri ve mükerrer vergi numarası uyarıları düzeltildi.
• PHP bağımlılıkları ve GitHub Actions bileşenleri güncellendi.

Yükseltme

Önce uygulama dosyaları ile veritabanı yedeğini doğrulayın. Dosyaları güncelleyip composer install çalıştırın. Ardından doğru veritabanına bağlı sunucuda php scripts/sema_guncelle.php komutunu çalıştırın ve sıfır çıkış kodunu doğrulayın. Betik yeni M_API_IDEMPOTENCY tablosunu oluşturur ve diğer Lumen şema betiklerini yeniden uygular; LOGO tablolarına dokunmaz. Eski biçimdeki API belirteçleri için yeniden giriş gerekebilir.

Yeni kod şema kurulmadan çalışırsa Idempotency-Key taşıyan siparişler korumasız kaydedilmek yerine 503 döner; anahtarsız eski istemciler çalışmaya devam eder.

Tam değişiklik listesi: CHANGELOG.md

Lumen v1.3.1 — Güvenlik ve bakım

Lumen v1.3.1 — Güvenlik ve bakım

Bu bakım sürümü yetki sınırlarını, hata yanıtlarını ve taşıma güvenliğini sıkılaştırır; ortak bordo arayüz iyileştirmelerini de içerir.

Öne çıkanlar

• Yetki denetimi hedefi güvenilmeyen Host başlığından ayrıldı; loopback ve TLS doğrulaması zorunlu.
• Özel cari kısıtı döviz listesi/çıktıları ile stok ekleme-düzenleme yardımcı uçlarında da uygulanıyor.
• Ham veritabanı ve istisna ayrıntıları istemciden kaldırıldı; destek için ERR-... referans kodu üretiliyor.
• SQL Server sertifika doğrulaması güvenli varsayılana alındı.
• CSP sınırları genişletildi; Dependabot, Gitleaks ve haftalık Trivy taraması eklendi.
• Trivy'nin bulduğu CVE-2026-111497 nedeniyle demo nginx imajı temiz ve digest ile sabitlenmiş nginx:1.31.8-alpine sürümüne geçti.
• Ekranlar ortak bordo tasarım diline ve daha tutarlı mobil yerleşime uyarlandı.

Yükseltme

Dosyaları güncelleyip composer install çalıştırın. Bu sürümde şema değişikliği yoktur.

Yetki denetimi farklı bir yerel adrese gidiyorsa LUMEN_DENETIM_BASE_URL değerini açıkça verin. Kendinden imzalı SQL Server sertifikası kullanan kurulumlar, riski kabul ederek AKL_DB_TRUST_CERT=1 ayarlamalıdır.

Doğrulama

PHP 8.2/8.3, birim testleri, güvenlik regresyonları, LOGO ve bağımsız mod tam demo akışları, Gitleaks ve Trivy kontrollerinin tamamı main üzerinde geçti.

Tam değişiklik listesi: CHANGELOG.md

Lumen v1.3.0 — Bağımsız Lumen

Bağımsız Lumen kararlı sürümü. Lumen LOGO Tiger olmadan, kendi veritabanıyla ön muhasebe
programı olarak çalışır; LOGO'ya bağlı kullanım aynen devam eder (.env LUMEN_VERI_KAYNAGI,
varsayılan logo).

• Bağımsız modda: cari ve ürün kartları (ekleme/düzenleme), satış ve alış siparişi,
  irsaliye ve fatura (dövizli dahil; siparişten/irsaliyeden kısmi), kasa/banka, çek, vade takibi,
  toplu fiyat, raporlar, yedekleme ve geri yükleme, Excel'den aktarma, dönem kilidi, LOGO'dan
  geçiş aracı (scripts/logo_aktar.php).
• Her iki modda: v1.2.x'e göre güvenlik ve performans düzeltmeleri (ayrıntı: aşağıdaki
  sürüm adayları ve betalar; v1.2.3 ve v1.2.4 kararlı düzeltmeleri dahil).
• Kabul: sürüm adayları, kodu GitHub'dan çeken bağımsız bir yapay zekâ ajanıyla
  docs/test/KABUL_TESTI.md'ye göre denendi (rc.1 koşullu → düzeltildi; rc.2 kabul).

Yükseltme (v1.2.x → v1.3.0, LOGO modu): dosyaları güncelleyip composer install, sonra bir
kez php scripts/sema_guncelle.php. LOGO tablolarına dokunulmaz; davranış değişmez.
Bağımsız moda geçiş: docs/mimari/bagimsiz-lumen.md → "Kurulum ve LOGO'dan geçiş".
Kullanım: docs/kullanim/KILAVUZ.md. Bilinen sınırlar: docs/mimari/bagimsiz-lumen.md.

Bilinen küçük konular (sonraki bakım sürümü): belgede para birimi gidiş-dönüşünde fiyat
kuruş kayması; Günlük İşlemler'de saat 00:00; telefonda yüzen göz düğmesi tabloların üstüne
biniyor; sipariş ekranında kısmi teslim miktarı gösterilmiyor; aynı vergi no ikinci caride uyarı vermiyor.

v1.3.0-rc.3 — Bağımsız Lumen (sürüm adayı)

⚠️ Sürüm adayıdır. Üretimde LOGO'ya bağlı kullanım için kararlı v1.2.4'ü kullanın.

rc.2'nin yeniden kabul denemesinde (yapay zekâ ajanı) karar KABUL; bildirilen küçük konular:

✨ Yeni

• Cari kartı düzenleme (bağımsız mod, cari kartında "Düzenle"): unvan, tür, vergi bilgileri,
  adres, iletişim, vade günü, risk limiti, özel kod, pazarlamacı, aktiflik. Önceden yalnız Excel'le.

🔒 Güvenlik

• Yazdırma tasarım ekranı sunucu dosya yolunu ve veritabanı hata metnini her kullanıcıya
  gösteriyordu (?debug=1 ile ayrıntı da); artık yalnız yöneticiye.

🐛 Düzeltmeler

• Sipariş ekranında koli barkodu okutulunca satır "Koli" kipinde açılır.
• Sipariş ekranında var olmayan "Resimli/Resimsiz Teklif" bağlantıları gizlendi (dosya varsa görünür).
• Ekstre ekranı ve PDF'inde Türkçe harfler ("İŞLEM TÜRÜ", "TOPLAM GİRİŞ", "Borçlu"); bazı başlıklar.
• Vade takibi telefonda daha sığar; Yeni Cari ekranı bağımsız modda doğru yönlendirir.

v1.3.0-rc.2 — Bağımsız Lumen (sürüm adayı)

⚠️ Sürüm adayıdır. Üretimde LOGO'ya bağlı kullanım için kararlı v1.2.4'ü kullanın.
v1.2.4'teki güvenlik düzeltmesini içerir.

rc.1'in bağımsız kabul testinde (yapay zekâ ajanı, kodu GitHub'dan çekerek; docs/test/KABUL_TESTI.md)
bulunanlar. Otomatik testler, GitHub iş akışı ve performans ölçümü rc.1'de de geçmişti; elle
denemede çıkan sorunlar:

🔒 Güvenlik

• Cari finans bilgisi (LOGO modunu da etkiler): bakiye/ekstre yetkisi olmayan kullanıcı
  (ör. depo personeli) adresi doğrudan yazarak cari kartını, ekstreyi ve ekstre PDF/Excel'ini
  açabiliyordu. Artık "Müşteri Bakiye" ya da "Cari Bakiye/Ekstre" yetkisi gerekir. Önceki
  dönem fatura/hizmet görünümlerinde özel cari kısıtı da uygulanır. Sipariş ekranında fiyat
  görme yetkisi olmayana özet tutarlar da gizlenir.

🐛 Düzeltmeler

• Siparişten KDV'siz fatura: stok aramadan çoklu eklenen sipariş satırları KDV %0
  yazılıyordu ve "Faturala" bunu sessizce faturaya taşıyordu. Bağımsız modda satır ürünün KDV'siyle
  yazılır; "Faturala" ekranında KDV seçilebilir, %0 kalmış satıra ürün KDV'si önerilir ve uyarılır.
• Koli barkodu: koli barkoduyla eklenen satır 1 ADET geliyordu; birim KOLİ'ye çevrilince fiyat
  değişmiyordu (bir koli bir adet fiyatına satılabiliyordu). Barkodun birimi seçili gelir, fiyat
  çarpanla hesaplanır ve birim değişince çevrilir. Yeni ürün formunda iki boş barkod satırı.
• Vergi no / TCKN: firma bilgilerinde ve Excel'den cari aktarımında kontrol basamağı denetlenir.
• Yedek ekranı: sayfa yenilenince (formu yeniden gönder) yedek alma ya da geri yükleme
  tekrarlanıyordu; artık her form bir kez işlenir.
• Fatura PDF'inde başlıklar Türkçe büyük harfle ("MİKTAR"); ekstre PDF'inde Türkçe harfler;
  Günlük İşlemler'de dövizli faturanın kuru; vade takibi telefonda sığar ve Türkçe harf duyarsız
  arar; giriş sayfasında tarayıcı konsol hatası; bazı ekran başlıklarında Türkçe harfler; ikon yolu.