Göktay Logo
← Referanslara Dön
Pazaryeri / İlan Platformu

Svoj.me

Karadağ pazarı için geliştirilmiş, sahibinden.com benzeri ikinci el ilan ve pazaryeri platformu. Go/Gin üzerinde 40'tan fazla domain paketine ayrılmış bir API; Astro (Cloudflare Workers), React yönetim paneli ve React Native mobil uygulamaya REST ve WebSocket ile hizmet veriyor. Canlı mesajlaşma, cüzdan ve kartla ödeme, Karadağ e-fatura (fiskalizasyon) uyumu, ilan öne çıkarma ve kurumsal mağaza abonelikleri tek sistemde. Üç dilde (Karadağ Sırpçası, Türkçe, İngilizce) URL seviyesinde çok dilli yapı. Tech Lead olarak mimari, deploy ve güvenlik sertleştirme kararlarından sorumluydum.

📈 Kart verisini API'ye hiç ulaştırmayan ödeme mimarisi, production olaylarından türetilmiş guard'lı deploy sistemi ve SQL_ASCII veritabanında çalışan çok dilli trigram arama.
GoGinPostgreSQLRedisWebSocketAstroCloudflare WorkersReactViteReact Native (Expo)DockerTraefikCloudflare TurnstilegooseBankart
Svoj.me — kavramsal illüstrasyon

Svoj.me, Karadağ pazarı için geliştirilmiş bir ikinci el ilan ve pazaryeri platformu. Türkiye'deki sahibinden.com'a benzer bir model: bireysel kullanıcılar ilan verir, kurumsal satıcılar mağaza açar, alıcılar arar, filtreler, favoriye ekler ve satıcıyla platform içinden anlık mesajlaşır. Projede Tech Lead olarak backend mimarisinin, deploy ve operasyon süreçlerinin ve güvenlik sertleştirme kararlarının sorumluluğunu üstlendim.

Bu tür bir platformun zorluğu tek bir özellikte değil, özelliklerin birbirine dokunduğu yerlerde. İlan akışı ödeme sistemine, ödeme sistemi yasal faturalandırmaya, faturalandırma da mağaza aboneliklerine bağlanıyor. Aynı ürün üç dilde, üç ayrı istemciden (web, yönetim paneli, mobil) ve hem REST hem WebSocket üzerinden çalışıyor. Aşağıda sistemin nasıl kurulduğunu ve bu süreçte verdiğimiz üç önemli mühendislik kararını anlatıyorum.

Ürün Kapsamı

Platform, bir ilan sitesinin uçtan uca ihtiyaç duyduğu her şeyi kendi bünyesinde barındırıyor:

Teknik Mimari

Sistem, tek bir Go API'si etrafında toplanan üç istemciden oluşuyor:

Domain odaklı backend

API, 40'tan fazla bağımsız domain paketine bölünmüş durumda. listing, payment, bankart, billing, fiskalmn, message, ws, quota, promotion, store, review, rbac, sms, push, googleanalytics ve indexnow bunlardan bazıları. Bu ayrımın pratik faydası şu: ödeme sağlayıcısı entegrasyonu (bankart), iş kuralları (payment, billing) ve yasal faturalandırma (fiskalmn) ayrı paketlerde yaşadığı için birindeki değişiklik diğerlerini etkilemiyor. Yetkilendirme rbac paketinde merkezi tutuluyor.

Veri ve önbellek katmanı

Altyapı ve güvenlik çevresi

Tech Lead olarak bu yapının operasyon runbook'unu ve deploy dokümantasyonunu yazdım. Güvenlik sertleştirme kararlarını da tarihli olarak kayıt altına aldım: CSP sıkılaştırması, refresh token'ın httpOnly cookie'de tutulması, edge-auth secret kurulumu ve WebSocket token güvenliği.

Mühendislik Kararı 1: PCI Kapsamını Bilinçli Olarak Daraltmak

Sorun. Ödeme sistemi, kart bilgisini kaydedip sonraki ödemelerde tekrar kullanmayı destekleyecek şekilde tasarlanmıştı. Bu, kullanıcı için daha akıcı bir deneyim demekti. Ancak kart verisinin platformun herhangi bir katmanına dokunması, sistemi PCI DSS kapsamının çok daha ağır bir seviyesine taşır. Her log satırı, her hata raporu ve her yedek potansiyel bir sızıntı noktasına dönüşür.

Karar. Kart saklama özelliğini güvenlik gerekçesiyle devre dışı bıraktık. Kod tabanında mevcut, ancak frontend bu akışı hiç çağırmıyor. Kart bilgisi yalnızca bankanın 3D Secure sayfasında giriliyor. Svoj.me API'sine hiçbir koşulda kart verisi ulaşmıyor. API yalnızca ödeme sağlayıcısından (Bankart) dönen işlem sonucunu görüyor.

Sonuç ve bedeli. Platform kart verisi taşımadığı için en kritik saldırı yüzeyi baştan ortadan kalktı. Bu kararın bilinçli olarak kabul ettiğimiz bir bedeli de var: kayıtlı kart olmadığı için aboneliklerde otomatik yenileme kapalı ve kullanıcı aboneliğini elle yeniliyor. Bu, güvenliği kullanıcı deneyimine tercih ettiğimiz açık bir ödünleşim.

Mühendislik Kararı 2: Production Olaylarından Damıtılmış, Guard'lı Deploy

Sorun. Production'da iki ayrı hata sınıfıyla karşılaştık. Her ikisi de kod doğru olduğu halde sistemi bozuyordu:

  1. Stale build: Docker BuildKit önbelleği, bazı durumlarda yeni kodu image'a almadan eski katmanları kullanabiliyor. Deploy başarılı görünüyor, ama çalışan kod eskisi.
  2. Unutulan zorunlu ortam değişkeni: Koda yeni bir zorunlu environment variable eklenip sunucuda tanımlanmadığında API açılışta çöküyor, crash-loop'a giriyor. Kullanıcı tarafında bu, Traefik'in döndürdüğü 502 hatası olarak görünüyor.

Karar. Deploy script'ini bu iki hata sınıfını yapısal olarak engelleyecek şekilde yeniden kurduk:

Sonuç. Bu iki hata sınıfı artık deploy anında, kullanıcıya ulaşmadan yakalanıyor. "Deploy başarılı ama site çöktü" ya da "deploy başarılı ama eski kod çalışıyor" gibi sessiz başarısızlıklar, gürültülü ve erken bir hataya dönüştü. Her guard, yaşanmış somut bir olaya karşılık geliyor ve runbook'ta gerekçesiyle belgelendi.

Mühendislik Kararı 3: SQL_ASCII Veritabanında Çok Dilli Arama

Sorun. Bir ilan sitesinde arama, ürünün kalbidir. Svoj.me'nin veritabanı ise tarihsel sebeplerle SQL_ASCII encoding ile çalışıyor. PostgreSQL'in standart full-text search altyapısı UTF-8 metin varsayımıyla tasarlanmıştır. SQL_ASCII'de veritabanı byte'ları yorumlamadan sakladığı için dil kuralları, büyük/küçük harf dönüşümü ve aksan eşleştirmesi güvenilir şekilde çalışmaz. Üstelik içerik Sırpça, Türkçe ve İngilizce karışık. č, ć, š, ž, ş, ğ, ı gibi karakterlerle yapılan aramaların tutarlı sonuç vermesi gerekiyor.

Karar. Production veritabanının encoding'ini değiştirmek yerine arama katmanını bu kısıta göre tasarladık. Metin, aranabilir forma byte düzeyinde normalize ediliyor ve arama, trigram (pg_trgm) tabanlı benzerlik eşleştirmesi üzerine kuruldu. Trigram yaklaşımı dil sözlüğüne ihtiyaç duymadığı için üç dilde de aynı mantıkla çalışıyor ve küçük yazım hatalarını da tolere ediyor.

Sonuç. Veritabanı encoding'ine dokunmadan çok dilli içerikte çalışan bir arama altyapısı kuruldu. Bu kararın özü, ideal koşulları beklemek yerine mevcut kısıtı mühendislik problemi olarak ele almak.

Kapanış

Svoj.me bir "CRUD + ödeme" projesi değil. Yasal faturalandırma, ödeme güvenliği, çok dilli içerik, gerçek zamanlı mesajlaşma ve gelir modelinin aynı sistemde birbirine dokunduğu bir pazaryeri. Bu projede asıl değer üretilen yerler şunlardı:

Benzer bir pazaryeri, ödeme entegrasyonu ya da Go tabanlı bir backend mimarisi üzerinde çalışıyorsanız, proje teklifleri için iletişime geçebilirsiniz.