buch

Almanya kitap piyasası için ISBN fiyat, Preisbindung ve satılabilirlik istihbaratı.

DurumCanlı · buch.ersah.in
Kaynak
buchhandel.de (VLB)
Kullanım
Kitap satıcıları & ikinci el kitapçılar
Arayüz
Web · Toplu CLI · E-posta
9Epic
27Story
51Birim testi
3Veri kademesi
2Digest sıklığı

Almanya'da yeni kitaplar Buchpreisbindung ile korunur: yayınevi bir perakende fiyat belirler ve hiçbir satıcı bunun altında satamaz.

Bu koruma bir kitap vergriffen (baskısı tükenmiş) ilan edildiğinde kalkar — ve o andan itibaren fiyat serbest kalır. buch, tek bir ISBN için bu durumu saniyeler içinde netleştirir: kitap hâlâ korumalı mı, yoksa serbestçe fiyatlandırılabilir mi?

Bir kitapçı için bu sadece merak değil, bir alım kararıdır: hangi kitaba ne kadar teklif verilir, hangi fiyata satılır, ne kadar marj kalır. buch bunu tek bir arama, yüzlerce kitaplık toplu bir liste veya haftalarca süren bir takip olarak yanıtlar.

buchhandel.de JSON API (VLB) · dış kaynak BuchhandelClient retry · timeout · Accept: application/json Resolver canlı → arşiv → bulunamadı Web arayüzü tekli / toplu arama, SSE Toplu CLI checkpoint/resume Takip / Cron node-cron, günlük CSV / XLSX export + özet rapor CSV / XLSX / JSON + diff (önceki tarama) SQLite subscribers · watches · snapshots E-posta digest nodemailer · buch@ersah.in

VLB'nin herkese açık JSON API'sini saran bir istemci katmanı; sonuçları tek bir şemaya indirger. Web arayüzü, toplu-işlem CLI'ı ve e-posta takibi aynı çözümleyici üzerine kurulur.

ISBN girilir 1 · Liste araması canlı katalog bulundu LIVE bulunamadı 2 · Arşiv sorgusu vergriffen kayıtları bulundu ARCHIVED bulunamadı NOT_FOUND Ağ hatası / zaman aşımı → maks. 3 deneme, üstel bekleme (300ms↑) → ERROR

Bir ISBN önce canlı katalogda aranır. Bulunamazsa arşive bakılır — vergriffen kitaplar genellikle burada çıkar. İkisinde de yoksa NOT_FOUND; ağ hatalarında ayrı olarak ERROR döner.

fixedRetailPrice (Preisbindung sinyali) Perakende fiyat + alış maliyeti + komisyon % + kargo Satılabilirlik kararı Marj hesabı SERBEST SABİT (yeni kopya) Kâr € · Kâr % örn. 16,99€ − 8,50€ → +4,44€ (26%)

Fiyat koruması bilgisini bir satış kararına çevirir: serbest mi, yoksa yeni kopya sabit fiyattan mı satılmalı? Alış maliyeti girilirse kâr ve marj yüzdesi de anında hesaplanır.

E-posta + takip edilecek ISBN'ler Onay e-postası çift opt-in Onaylandı başlangıç snapshot'ı Cron haftalık / aylık yeniden sorgula Karşılaştır diffSnapshots değişiklik yok → sıradaki periyoda kadar bekle değişiklik var Digest e-postası fiyat / durum / bulunabilirlik listesi + sıklık değiştir · abonelikten çık

Bir arama e-postayla kaydedilebilir. Onaydan sonra sistem periyodik olarak yeniden sorgular, önceki sonuçla karşılaştırır ve değişen kitapları e-postayla bildirir — her e-postada sıklık değiştirme ve abonelikten çıkma linkleriyle.

EPIC 1–2 Veri & Arama VLB JSON API istemcisi (retry, timeout, loglama) ve üç kademeli çözümleme: canlı → arşiv → bulunamadı. Canlı
EPIC 3–4 Toplu İşleme & Raporlama Eşzamanlılık + nazik gecikme, checkpoint/resume, CSV/XLSX export, özet rapor, önceki taramayla karşılaştırma. Canlı
EPIC 6–8 Satıcı Araçları Satılabilirlik kararı, marj/kâr hesabı, KDV, zengin katalog bilgisi (yazar, format, sayfa), filtre & sıralama. Canlı
EPIC 9 Takip & Bildirim E-posta ile arama takibi, çift onaylı kayıt, haftalık/aylık değişiklik özeti. Canlı
EPIC 5 Kalite & Altyapı 51 birim testi, ortam yapılandırması, GitHub Actions ile CI/CD. Canlı
git push main CI: lint·test·build Docker → GHCR SSH deploy nginx + TLS buch.ersah.in

Her push GitHub Actions'ı tetikler: test edilir, Docker imajı GHCR'a itilir, Plesk sunucusuna SSH ile dağıtılır. Prod ve önizleme (PR) ortamları ayrı konteynerlerde çalışır.