Komi Store

Komi Store Nedir ve Ne İşe Yarar?

Komi Store, Node.js ve React tabanlı, tamamen açık kaynak bir e‑ticaret çözümüdür. Kullanıcıların ürün katalogları oluşturmasına, sipariş yönetimi yapmasına, ödeme entegrasyonları eklemesine ve çoklu dil‑para birimi desteğiyle global satış yapmasına olanak tanır. Hem tek bir satıcı için hem de çoklu satıcı (marketplace) senaryoları için uygundur.

Öne Çıkan Başlıca Özellikleri

• Modüler Eklenti Sistemi: Ürün tipleri, ödeme ağ geçitleri, kargo entegrasyonları gibi bileşenler eklenti olarak eklenebilir.
• Docker‑Ready: Tek komutla konteyner içinde çalıştırılabilir, CI/CD süreçlerine kolay entegrasyon sağlar.
• Responsive Tasarım: Mobil‑ilk (mobile‑first) temalar sayesinde mağaza her cihazda sorunsuz görüntülenir.
• Yerel ve Uluslararası Ödeme Ağ Geçitleri: Stripe, PayPal, iyzico, PayU gibi popüler hizmetlerle entegrasyon hazırdır.
• Çoklu Dil ve Para Birimi Desteği: i18n altyapısı sayesinde tek bir yönetim panelinden farklı diller ve para birimleri yönetilebilir.

Kimler İçin Uygundur?

Komi Store, aşağıdaki kullanıcı profilleri için ideal bir çözümdür:

• Girişimciler ve KOBİ’ler: Düşük maliyetle kendi online mağazasını kurmak isteyenler.
• Geliştiriciler ve Teknoprenörler: Açık kaynak kodu üzerinde özelleştirme ve yeni özellik geliştirmek isteyenler.
• Ajanslar ve Dijital Pazarlama Firmaları: Müşterileri için hızlıca beyaz‑etiket (white‑label) mağazalar oluşturmak isteyen ajanslar.
• Eğitim Kurumları: Yazılım geliştirme ve e‑ticaret derslerinde örnek proje olarak kullanılabilir.

Nasıl Kurulur ve Kullanılır?

Kurulum süreci üç ana adımdan oluşur:

1. Ön Koşullar: Docker, Docker‑Compose ve bir .env dosyası hazırlanır. Node.js 18+ ve PostgreSQL 13+ önerilir.
2. Depoyu Klonlayın ve Çalıştırın:

   git clone https://github.com/komi-store/komi-store.git
   cd komi-store
   cp .env.example .env
   docker-compose up -d

   Bu adım, tüm servisleri (api, web, db) tek bir komutla ayağa kaldırır.
3. İlk Yapılandırma: Tarayıcıda http://localhost:3000 adresine giderek yönetici hesabı oluşturun, mağaza ayarlarını (logo, tema, ödeme) yapılandırın ve ürün eklemeye başlayın.

Kurulum sonrası komi-store-cli aracını kullanarak veri migrasyonu, yedekleme ve güncelleme işlemlerini otomatikleştirebilirsiniz. Ayrıntılı adımlar ve örnek senaryolar resmi dokümantasyon sitesinde (https://www.komistore.app/docs) yer almaktadır.

Kullanım Rehberi ve Önemli İpuçları

İlk adım olarak, Docker ortamını başlatmak için docker compose up -d komutunu çalıştırın; bu, tüm bağımlılıkların otomatik olarak indirilip konteyner içinde çalışmasını sağlar. Ardından, yönetim paneline erişmek için http://localhost:3000/admin adresine gidin ve kurulum sihirbazını izleyerek mağaza adını, para birimini ve temel iletişim bilgilerini girin.

Temalar ve eklentilerle özelleştirme yaparken, src/plugins klasörüne yeni bir klasör ekleyip index.js dosyasını tanımlayın; bu sayede yeni bir ödeme yöntemi ya da kargo entegrasyonu eklemek sadece birkaç satır kodla mümkün olur. Değişiklikleri anında görmek için hot‑reload özelliğini etkinleştirin ve tarayıcı önbelleğini temizlemeyi unutmayın.

Performansı artırmak için statik varlıkları CDN üzerinden sunmayı, veri tabanı sorgularını indekslemeyi ve gereksiz API çağrılarını önlemek amacıyla GraphQL yerine REST endpointlerini tercih etmeyi düşünün. Ayrıca, üretim ortamında NODE_ENV=production ayarını etkinleştirerek JavaScript sıkıştırma ve CSS minifikasyonunu otomatikleştirebilirsiniz.

Kimler İçin Uygundur ve Hangi Senaryolarda Tercih Edilmeli?

Küçük ölçekli girişimler, tek satıcıdan oluşan butik mağazalar ve hızlı prototip geliştirmek isteyen geliştiriciler için ideal bir çözümdür; çünkü kod tabanı açık kaynak olduğu için ihtiyaç duyulan her fonksiyon kolayca genişletilebilir.

Aynı zamanda, birden fazla satıcıyı aynı platformda barındırmak isteyen marketplace projeleri, çoklu dil ve para birimi desteği sayesinde uluslararası pazarlara açılmak isteyen firmalar için de güçlü bir altyapı sunar. Eğitim kurumları ve kodlama bootcamp’leri, öğrencilerin gerçek bir e‑ticaret sistemi üzerinde pratik yapmalarını sağlamak amacıyla bu platformu müfredatlarına dahil edebilir.

Alternatif kapalı kaynak çözümlerle karşılaştırıldığında, Komi Store’un modüler eklenti mimarisi ve Docker‑ready yapısı, bakım maliyetlerini düşürürken ölçeklenebilirliği artırır; bu da hem başlangıç aşamasındaki girişimler hem de büyümekte olan orta ölçekli işletmeler için cazip bir tercih olmasını sağlar.