proje detayları

Kamanİlan - Yerel İlan ve Pazaryeri Platformu

Kaman ve Kırşehir için kategori, konum, mağaza, üyelik ve ilan yönetimini birleştiren; yerel üretici ve alıcıları buluşturan dijital pazaryeri.

Müşteri

Kaman Ilan

Başlangıç

16 Dec 2025

Bitiş

Web Sitesi

kamanilan.com
Kamanİlan yerel ilan ve pazaryeri platformu ana sayfası
Açıklama

Kaman ve Kırşehir için kategori, konum, mağaza, üyelik ve ilan yönetimini birleştiren; yerel üretici ve alıcıları buluşturan dijital pazaryeri.

Vaka çalışması

Zorluk

Kaman ve Kırşehir'de ilanlar ya ulusal sitelerde kayboluyor ya da aranamayan sosyal medya gruplarında kalıyordu. İlanların ücretsiz kalacağı bir modelde platformun yerel reklamla gelir üretebilmesi için düzenli ziyaret getiren içeriğe ihtiyaç vardı.

Yaklaşım

İlan, mağaza, haber, duyuru ve reklam tek Fastify API ve MySQL veri modelinde birleştirildi. Hedefleme, frekans sınırı ve raporlama içeren bir reklam motoru ile editoryal filtreli bir haber hattı kuruldu; SEO altyapısı baştan gömüldü.

Sonuç

Kaman İlan kamanilan.com'da yayında ve reklam alanları satışa hazır. Ücretli öne çıkan ilan ve ürün satışı sonraki aşamalar olarak planlandı; bu aşamaların altyapısının önemli kısmı kodda mevcut.

Araçlar

Next.js, React, TypeScript, Fastify, Bun, Drizzle ORM, MySQL, Cloudinary, Iyzico

Öne Çıkan Özellikler
  • Kategori, konum ve şehir bazlı sayfalarla ücretsiz ilan

  • Adım adım ilan verme, favoriler ve site içi mesajlaşma

  • Mağaza başvurusu, mağaza vitrini ve satıcı paneli

  • 14 reklam alanı; il, ilçe, kategori ve mağaza hedefleme

  • Reklam rotasyonu, frekans sınırı ve kampanya raporları

  • Editoryal filtreli, yapay zekâ destekli yerel haber hattı

  • NewsArticle şeması, haber site haritası, RSS ve IndexNow

  • Excel/CSV toplu ilan aktarımı ve zamanlı XML beslemeleri

  • E-posta veya Google hesabıyla giriş

Tasarım Öne Çıkanları
  • İlanlar ücretsiz; gelir, hedefli ve raporlanabilir yerel reklamdan

  • Haber önerileri editör onayı olmadan yayına girmez

  • Haber görselleri yapay zekâ servisi olmadan üretilir, WebP türevleri otomatik

  • Reklamlar masaüstü ve mobil için ayrı hedeflenebilir

  • Dönüşüm olayları ve sponsor atıfları aynı aksiyondan birer kez kaydedilir

Detaylar

Kaman İlan, Kaman ve Kırşehir çevresi için kurulan yerel ilan, haber ve duyuru platformudur. Bölgedeki bireysel satıcıları, esnafı ve üreticiyi alıcıyla buluştururken, yerel işletmelere de reklam verebilecekleri ölçülebilir bir mecra sunar. Bireysel ilanlar ücretsizdir; platformun gelir modeli yerel işletmelere satılan reklam alanlarına dayanır.

Proje bağlamı ve ihtiyaç

Küçük bir ilçede ilan verilecek yerler ya ulusal sitelerdir ya da sosyal medya grupları. Ulusal sitelerde yerel bir ilan kaybolur; gruplarda ise arama, kategori ve güven yoktur. Kaman cevizi gibi bölgeye özgü ürünler, emlak, araç ve iş ilanları için yerel bir vitrin gerekiyordu. İkinci sorun gelir modeliydi: ilanlar ücretsiz kalacaksa, platformun yerel işletmelere hedefli ve raporlanabilir reklam satabilmesi, bunun için de sitenin düzenli ziyaret almasını sağlayacak güncel içeriğe sahip olması gerekiyordu.

Çözüm ve kapsam

İlan keşfi

Ana sayfada emlak ve kira, araç ve motosiklet, alet ve gereç, hayvan ve tarım, iş ilanları ile usta ve hizmet gibi kategoriler öne çıkar. Ziyaretçi ilanları kategori, konum ve anahtar kelimeyle arar; kategori sayfaları şehir bazında ayrı adreslere de açılır. İlan detayında görseller, özellikler, satıcı bilgisi ve ilgili ilanlar yer alır.

İlan verme ve kullanıcı hesabı

İlan verme adım adım ilerleyen bir akıştır: kategori, bilgiler, konum ve fotoğraflar sırayla girilir. Kayıtlı kullanıcı hesabında ilanlarını, favorilerini, son görüntülediklerini, adreslerini, bildirimlerini ve destek taleplerini yönetir; alıcı ile satıcı site içi mesajlaşmayla iletişim kurar. Giriş e-posta veya Google hesabıyla yapılabilir.

Mağazalar

Düzenli satış yapan esnaf ve üreticiler mağaza başvurusu yapar. Onaylanan mağazanın kendi vitrin sayfası olur; mağaza sahibi satıcı panelinden mağaza profilini, ilanlarını ve kampanyalarını yönetir.

Haber ve duyurular

Platform yalnız ilan sitesi değildir; yerel haberler ve duyurular sitenin düzenli ziyaret almasını sağlar. Haber hattı belirlenen kaynaklardan öneri toplar, editoryal filtreden geçenleri yapay zekâ ile özgün ve yerel bağlamlı bir habere dönüştürür ve kaynak bağlantısını korur. Filtre, bölgeyle ilgisi olmayan, siyasi propaganda niteliği taşıyan ya da tanıtım dili ağır basan içeriği yayından önce ayıklar. Son karar editörde kalır: öneriler panelde onaylanmadan yayına girmez.

Reklam ver

İşletmeler reklam ver sayfasından talep oluşturur; yeni alan, uzatma ya da görsel değişikliği gibi talepler panele düşer ve yönetici tarafından incelenir.

Yönetim paneli

Panelin merkezinde ilanlar, kategoriler ve alt kategoriler, markalar, birimler, varyantlar ve özellik tanımları vardır. Bunun yanında şu bölümler yönetilir:

  • Reklam motoru: sitede 14 tanımlı reklam alanı; reklamlar sayfa türü, il, ilçe, kategori, mağaza ya da ilana göre hedeflenir, masaüstü ve mobil ayrı seçilebilir. Reklamın taslaktan yayına ve arşive kadar yaşam döngüsü, rotasyon ve frekans sınırı, kampanya raporları ve denetim kaydı paneldedir.
  • Haber masası: haber kaynakları, haber önerileri, haber görsel kuyruğu ve yazılar.
  • Toplu veri: Excel ve CSV ile toplu ilan içe aktarımı, belirli aralıklarla çekilen XML beslemeleri ve hatalı fotoğraflar için yeniden deneme kuyruğu.
  • Satıcılar ve kullanıcılar: mağaza başvuruları, kullanıcılar, roller ve yetkiler.
  • İçerik ve site: duyurular, slider ve bannerlar, ana sayfa yerleşimi, menü ve footer bölümleri, özel sayfalar, SSS, açılır pencereler, tema ve site ayarları.
  • İletişim: e-posta şablonları, bülten, bildirimler ve iletişim mesajları.

Teknik mimari

Platform üç uygulamadan oluşur: Next.js 16 ve React 19 ile yazılmış müşteri sitesi, ayrı bir Next.js yönetim paneli ve Bun üzerinde çalışan Fastify API. Veri MySQL'de tutulur, Drizzle ORM ile yönetilir ve Zod ile doğrulanır. Arayüzde Tailwind CSS, Radix UI ve Framer Motion, veri çekmede React Query kullanılır. Kimlik doğrulama JWT ile yapılır, panel uçları yetki bazlı korunur. Ortak modüller, aynı altyapıyı paylaşan diğer projelerle birlikte kullanılan paylaşımlı bir backend paketinden gelir.

SEO ve yapay zekâ aramaları baştan hesaba katıldı: haberler NewsArticle yapılandırılmış verisiyle yayınlanır, ayrı bir haber site haritası ve RSS akışı vardır, yeni içerik IndexNow ile arama motorlarına bildirilir. Yazıların Google Search Console'daki indeks durumu panelden izlenir. Pazarlama dönüşüm olayları GA4 ve Google Ads'e, sponsor reklam etkileşimleri ise ayrı bir atıf kaydına aynı kullanıcı aksiyonundan birer kez gönderilir.

Haber görselleri için yapay zekâ görsel servisi kullanılmaz: panel görsel briflerini dışa aktarır, hazırlanan görseller içe aktarılırken kapak, kare ve küçük boyutlu WebP türevleri otomatik üretilir.

Entegrasyonlar

  • Google OAuth: Google hesabıyla giriş.
  • Cloudinary: ilan ve mağaza görselleri.
  • Nodemailer: hesap, bildirim ve bülten e-postaları.
  • Yapay zekâ sağlayıcıları: haber dönüştürmede yedekli sağlayıcı zinciri.
  • IndexNow, Search Console, GA4 ve Google Ads: indeksleme ve ölçüm.
  • Iyzipay: ileride ürün satışı ve ücretli öne çıkarma için kodda hazır ödeme altyapısı.

Sonuç ve bugün

Kaman İlan, kamanilan.com adresinde yayında. İlan, mağaza, haber, duyuru ve reklam aynı veri modeli üzerinde çalışıyor; reklam alanları hedefleme ve raporlamayla satılmaya hazır. Yol haritasında sırasıyla ücretli öne çıkan ilanlar ve sepet ile ödemeye dayalı ürün satışı yer alıyor; bu iki aşama için gerekli altyapının önemli kısmı kodda mevcut.