Yazılım ÜrünüTicari Sürüm Adayı1.0.0-rc.1

Self-hosted araç pazaryerleri için modern bir temel

Self-hosted araç pazaryeri platformu

AutoCore; public pazaryerini, bayi operasyonlarını, yönetim panelini, API'leri, aramayı, medya işlemeyi, kurulumu ve yaşam döngüsü operasyonlarını yapılandırılabilir tek bir sistemde birleştirir.

Ticari dağıtım süreci hazırlanmaktadır.

AutoCore pazaryeri ana sayfası; arama ve öne çıkan markalarla masaüstü görünümü

Özet

Kategori

Yazılım Ürünü / Otomotiv Pazaryeri

Tür

Self-hosted pazaryeri platformu

Sürüm

1.0.0-rc.1 · Sürüm Adayı

Durum

Ticari Sürüm Adayı

Yıl

2026

Rol

Ürün tasarımı, mimari, geliştirme, operasyon

Genel bakış

AutoCore nedir

AutoCore, operatörün kendi altyapısına kurup çalıştırdığı bir araç pazaryeri platformudur. Barındırılan bir servis ya da bir tema değildir: public pazaryeri, bayi ve satıcı modeli, yönetim yüzeyi, sürümlenmiş bir API, arka plan işleme ve bir kurulumu ayakta tutmak için gereken kurulum ve yaşam döngüsü araçlarını içeren eksiksiz bir sistemdir.

Ürünün çıkış noktası şu: ciddi bir araç pazaryeri kurmak, her seferinde aynı temelleri yeniden yazmak anlamına geliyor — katalog yapısı, ilan durumları, moderasyon, medya işleme, arama projeksiyonu ve gerçek bir pazaryerinin ihtiyaç duyduğu hukuki kayıtlar ile rıza kayıtları. AutoCore bu temelleri tek seferlik bir proje olarak değil, yapılandırılabilir bir çekirdek olarak paketler.

Hedef kitlesi; pazaryeri operatörleri, müşterisi için pazaryeri teslim eden ajanslar ve verisiyle dağıtımını kiralamak yerine sahiplenmek isteyen teknik ekiplerdir.

Çıkış noktası

Mühendislik hedefi

İlk kısıt, tek bir şehre veya ülkeye dair hiçbir şeyin koda gömülmemesiydi. Para birimi, locale, saat dilimi, mesafe birimi, adres ve telefon biçimlendirmesi ile konum hiyerarşisi; kodun içine yerleşmiş varsayımlar değil, yapılandırmadır.

İkinci kısıt, platformun tek bir kanonik kaynaktan markalı sürümler üretebilmesiydi. EskişehirAraba aynı çekirdekten inşa edildi; bu da markalama, yerelleştirme ve pazar sınırlarının teoride değil gerçekten ayrılabilir olmasını zorunlu kıldı.

Üçüncüsü operasyonel netlikti: her kurulum tek bir birincil pazara hizmet eder. Bu bilinçli bir sınırdır. Fiyatlandırmayı, birimleri, moderasyonu ve hukuki politikayı belirsizlikten kurtarır; her sorguyu ve her ekranı karmaşıklaştıracak yarım kalmış bir çok-pazar soyutlaması göndermeyi önler.

Mühendislik çıktıları

Sürüm adayı aşamasında doğrulandı

Her değer, önceki notlardan taşınmak yerine sürüm adayı kaynağından yeniden türetildi.

  • 4Uygulama yüzeyiWeb, Admin, API, Worker
  • 59API controller sınıfıİş alanlarına göre gruplanmış
  • 403Endpoint metodu59 controller genelinde kaynak doğrulamalı
  • 85Public OpenAPI pathSanitize edilmiş public artifact
  • 56Public OpenAPI şemasıOrtak istek ve yanıt yapıları
  • 264Dokümantasyon sayfasıYayınlanmış ürün dokümantasyonu
  • 34Veritabanı migration'ıSürümlenmiş şema geçmişi
  • 1Kurulum başına birincil pazarBilinçli bir operasyonel sınır

Yetenekler

Platformun kapsadıkları

Arama ve filtreleme

İlanlar üzerinde marka, model, fiyat, yıl, kilometre, yakıt tipi ve şanzıman filtreleriyle fasetli arama.

Araç kataloğu

Kategoriler, markalar, modeller, kuşaklar ve donanım paketleri; yapılandırılmış ekipman ve arama nitelikleriyle.

İlan yaşam döngüsü

Taslaktan moderasyona ve arşive kadar sekiz açık ilan durumu; her biri tanımlı görünürlükle.

Kullanıcılar ve satıcılar

Bireysel satıcılar ve bayi organizasyonları; roller, izinler ve kaynak sahipliğiyle.

Bayiler ve üyelikler

Bayi profilleri, üye rolleri, doğrulama durumları ve mağaza sayfaları.

Moderasyon

İlanlar ve şikâyetler için inceleme kuyrukları; kayıtlı kararlar ve denetim geçmişiyle.

Medya işleme

Arka planda görsel işleme; türetilmiş varyantlar, checksum'lar ve açık işleme durumlarıyla.

Hukuk ve rıza

Sürümlenmiş politika revizyonları, kabul kayıtları ve rıza makbuzları; birinci sınıf veri olarak tutulur.

Ödeme hazırlığı

Sağlayıcı yapılandırması, doğrulama durumu ve webhook yönetimi — açıkça etkinleştirilene kadar kapalı.

Sistem sağlığı

Kurulum durumu, arka plan işleme ve arama sağlığı için operasyonel yüzeyler.

Public pazaryeri

Alıcıya dönük deneyim

Public yüzey keşif, karşılaştırma ve iletişimi yönetir. Biçimlendirme yapılandırılmış pazarı izler; böylece fiyatlar, mesafeler ve konumlar kuruluma uygun okunur.

AutoCore arama sonuçları sayfası; filtre kenar çubuğu ve araç ilanları ızgarasıyla
Kategori, fiyat, yıl, kilometre ve yakıt tipine göre canlı sonuç sayılarıyla fasetli filtreleme.
AutoCore arama sonuçlarının mobil görünümü; alt alta dizilmiş ilan kartlarıyla
İlan kartları küçük genişliklerde de teknik özellikleri, satıcı tipini ve konumu korur.

Demo, sentetik örnek veriyle çalışır.

Satıcılar ve bayiler

İki satıcı modeli, tek ilan modeli

Bireysel satıcılar ve bayi organizasyonları aynı ilan hattını paylaşır. Farklılaşan; sahiplik, üyelik ve bayinin sahip olduğu mağaza sayfasıdır.

AutoCore bayi mağaza sayfası; kapak görseli, uzmanlık alanları ve ilan sayısıyla
Uzmanlık alanları, aktif ilan sayısı ve işletme durumuyla bir bayi profili.

Yönetim

Pazaryerini işletmek

Yönetim, pazaryerini günlük olarak işleten kişiler için kendi yüzeylerine sahip ayrı bir uygulamadır.

  • Kullanıcı ve bayi yönetimi, rol ve izin atamalarıyla.
  • Araç kataloğu yönetimi: kategoriler, markalar, modeller ve donanımlar.
  • İlan moderasyon kuyruğu ve karar geçmişi.
  • Medya incelemesi ve işleme durumu görünürlüğü.
  • Arama operasyonları ve yeniden indeksleme.
  • Legal Center, Consent Center ve Payment Center yüzeyleri.
  • Denetim geçmişi ve sistem sağlığı.

Pazar modeli

Kurulum başına tek birincil pazar

Pazar bir yapılandırmadır. Bu sınır bilinçlidir.

  • Ülke, bölge ve şehir, pazaryerinin nerede işlediğini tanımlar.
  • Locale ve para birimi, biçimlendirmeyi ve fiyat sunumunu belirler.
  • Saat dilimi ve mesafe birimi (km veya mi) kurulum başına yapılandırılır.
  • Adres ve telefon biçimlendirmesi yapılandırılabilir preset'leri izler.
  • Pazarın araç yetenekleri, hangi kategorilerin sunulacağına karar verir.
  • Austin demo preset'idir; Berlin ABD dışı bir kurulumu doğrulamak için kullanıldı; Eskişehir ise materyalize edilmiş bir sürümdür.

Katalog ve yaşam döngüsü

Taslaktan arşive

Her ilan açık durumlar arasında ilerler ve her durum arama görünürlüğünü belirler.

Şema: ilan yaşam döngüsü — taslaktan moderasyona, oradan aktif, satıldı, süresi doldu ve arşiv durumlarına
Her ilan açık durumlar arasında ilerler ve her durum arama görünürlüğünü belirler.
  • draft — oluşturuldu, henüz gönderilmedi
  • pending_review — moderasyon bekliyor
  • active — herkese açık ve aranabilir
  • reserved — bir alıcı için ayrıldı
  • sold — satıldı olarak kapatıldı
  • expired — aktif süresi doldu
  • rejected — moderasyonda reddedildi
  • archived — pazaryerinden çekildi

Medya ve arama

Yetkili durum, türetilmiş projeksiyon

Arama ve medya, hiçbirinin sessizce kayıt sistemi hâline gelemeyeceği şekilde kurgulandı.

  • PostgreSQL, her iş kaydı için yetkili işlem deposudur.
  • Meilisearch, arama için kullanılan türetilmiş ilan projeksiyonunu tutar.
  • Redis, geçici koordinasyonu ve arka plan işlemeyi destekler.
  • Medya varlıkları sahipliği, boyutları, checksum'ları ve türetilmiş varyantları kaydeder.
  • Görsel işleme, istek yolunun dışında Worker içinde çalışır.
  • Arama durumu PostgreSQL'den yeniden üretilebilir; hiçbir zaman doğruluk kaynağı değildir.

Hukuk, rıza, ödemeler

Varsayılmaz, kaydedilir

Bu yetenekler operatöre ihtiyaç duyduğu kayıtları verir. Uyumluluk değil, araçtır.

Şema: politika revizyonu yaşam döngüsü — taslaktan yayına ve kabule
Bu yetenekler operatöre ihtiyaç duyduğu kayıtları verir. Uyumluluk değil, araçtır.
  • Politikalar, açık bir yayınlama adımıyla sürümlenmiş revizyonlar olarak saklanır.
  • Kabul kayıtları, bir kullanıcıyı kabul ettiği tam politika revizyonuna bağlar.
  • Rıza makbuzları, zorunlu işlemeyi isteğe bağlı işlemeden ayırır.
  • Ödeme sağlayıcıları kurulum başına yapılandırılır ve varsayılan olarak kapalıdır.
  • Sağlayıcı yapılandırması açık bir doğrulama durumu taşır.
  • Webhook yönetimi, başarıyı varsaymak yerine işleme durumunu kaydeder.

Bu özellikler hukuki bir sertifikasyon oluşturmaz ve ödeme sağlayıcılarını otomatik olarak etkinleştirmez. Politika içeriği, mevzuat yükümlülükleri ve sağlayıcı sözleşmeleri operatörün sorumluluğundadır.

Mimari

Dört yüzey, net sınırlar

Web ve Admin birer istemcidir. API iş mantığına ve PostgreSQL durumuna sahiptir. Worker sınırlı arka plan işlerini yürütür.

Şema: public istemciler Web veya Admin'e ulaşır, bunlar sürümlenmiş API'yi çağırır; API PostgreSQL'e sahiptir ve Redis, Meilisearch ile Worker'ı koordine eder
Web ve Admin birer istemcidir. API iş mantığına ve PostgreSQL durumuna sahiptir. Worker sınırlı arka plan işlerini yürütür.

Teknoloji

Kullanılan stack

Frontend

  • Next.js
  • React
  • TypeScript
  • Tailwind CSS
  • shadcn/ui
  • TanStack Query
  • React Hook Form
  • Zod

Backend

  • NestJS
  • TypeScript
  • Prisma
  • PostgreSQL
  • Redis
  • Meilisearch

Altyapı

  • Docker
  • Nginx
  • Cloudflare
  • GitHub Actions
  • Immutable release artifacts

Kalite

  • Vitest
  • Playwright
  • Accessibility testing
  • Contract validation
  • Dependency audits

API

API-first ve sanitize edilmiş public sözleşme

İstemciler sürümlenmiş bir sözleşmenin tüketicisidir; yayınlanan artifact ise onun filtrelenmiş görünümüdür.

  • İş mantığı API'de yaşar; Web ve Admin aynı sürümlenmiş sözleşmenin istemcileridir.
  • Kimlik doğrulama ve izin kontrolleri API sınırında uygulanır.
  • Kaynak sahipliği istemciden çıkarsanmaz, her istekte doğrulanır.
  • Yanıtlar tutarlı bir hata zarfı ve istek tanımlayıcıları kullanır.
  • Liste endpoint'leri ortak bir sayfalama sözleşmesini paylaşır.
  • Yayınlanan OpenAPI artifact'i sanitize edilmiştir: operatöre özel ve yalnızca dahili route'lar hariç tutulur.
  • Denetlenen 403 handler metodu tüm görünürlük sınıflarını kapsar; sanitize edilmiş public artifact 85 path yayınlar.
85 paths56 schemasOpenAPI 3.0
API'yi İncele

Kurulum

Bir kurulumu kurmak ve işletmek

Kurulum bir README değil, bir ürün yüzeyi olarak ele alındı.

Şema: preflight'tan kuruluma ve doğrulamaya uzanan kurulum yaşam döngüsü
Kurulum bir README değil, bir ürün yüzeyi olarak ele alındı.
Şema: yükseltme ve geri alma karar akışı
Sıfat olarak değil, gerçekten uygulanan sınırlar olarak ifade edildi.
  • Hiçbir şey yazılmadan önce preflight kontrolleri yapan rehberli bir kurulum aracı.
  • İkinci bir çalıştırmanın yarım kurulumu bozmasını engelleyen kurulum kilidi.
  • Kesinti sonrası güvenle yeniden girilebilen idempotent adımlar.
  • İlk yönetici oluşturma ve birincil pazar başlatma.
  • Neyin ne zaman kurulduğunu kaydeden bir kurulum manifest'i.
  • Sürekli operasyon için doctor, status, upgrade ve yedek doğrulama komutları.

Güvenilirlik

Güvenlik ve operasyonel sınırlar

Sıfat olarak değil, gerçekten uygulanan sınırlar olarak ifade edildi.

  • API sınırında rol ve izin uygulaması.
  • Kapsamlı her işlemde kaynak sahipliği kontrolü.
  • Sırlar ortam üzerinden referanslanır, asla kaynak koda işlenmez.
  • Sürümler değişken etiketler yerine değişmez image digest'lerini referanslar.
  • Manifest'ler ve checksum'lar artifact soyağacını kurar.
  • Yedekler varsayılmaz, doğrulanır.

Dokümantasyon

Ürünün bir parçası olarak dokümantasyon

Dokümantasyon sürüm adayı kaynağına karşı yazıldı ve yayınlanan route'lara karşı doğrulandı. Kurulum, yönetim, operasyon, sorun giderme, güvenlik ve kurtarma konularını kapsar.

Dokümantasyon sitesindeki AutoCore OpenAPI yayın sayfası; sürüm adayı rozetiyle
OpenAPI yayın sayfası; public artifact için sanitizasyon sınırını da içerir.

264

public dokümantasyon sayfası

Dokümantasyonu İncele

Ürün

Kullanımdaki ürün

Sürümler

Aynı çekirdekten inşa edilen EskişehirAraba

EskişehirAraba, AutoCore çekirdeğinden üretilmiş materyalize bir pazaryeri sürümüdür. Markalamayı, yerelleştirmeyi, pazar yapılandırmasını ve operasyonel ayrımı canlı bir ortamda doğruladı. Bu, platformun tek bir şehirle veya tek bir ülkeyle sınırlı olduğu anlamına gelmez.

AutoCoreEskişehirAraba

Durum

Ürünün bulunduğu nokta

Sürüm
1.0.0-rc.1
Durum
Ticari Sürüm Adayı
Dağıtım
Self-hosted
Birincil pazar
Kurulum başına bir adet
Native mobil uygulama
Dahil değil
Ödemeler
Entegrasyona hazır, varsayılan olarak kapalı
Ticari dağıtım
Hazırlanıyor

İnceleyin

Sistemi inceleyin

Demo, dokümantasyon ve public API sözleşmesi incelemeye açıktır.

Ticari dağıtım süreci hazırlanmaktadır.